Initial commit
This commit is contained in:
242
backend/venv/Lib/site-packages/praw-7.8.1.dist-info/METADATA
Normal file
242
backend/venv/Lib/site-packages/praw-7.8.1.dist-info/METADATA
Normal file
@@ -0,0 +1,242 @@
|
||||
Metadata-Version: 2.1
|
||||
Name: praw
|
||||
Version: 7.8.1
|
||||
Summary: Python Reddit API Wrapper.
|
||||
Keywords: reddit,api,wrapper
|
||||
Author-email: Bryce Boe <bbzbryce@gmail.com>
|
||||
Maintainer-email: Bryce Boe <bbzbryce@gmail.com>, Joe RH <jarhill0@gmail.com>, Joel Payne <lilspazjoekp@gmail.com>
|
||||
Requires-Python: ~=3.8
|
||||
Description-Content-Type: text/x-rst
|
||||
Classifier: Development Status :: 5 - Production/Stable
|
||||
Classifier: Environment :: Console
|
||||
Classifier: Intended Audience :: Developers
|
||||
Classifier: License :: OSI Approved :: BSD License
|
||||
Classifier: Natural Language :: English
|
||||
Classifier: Operating System :: OS Independent
|
||||
Classifier: Programming Language :: Python
|
||||
Classifier: Programming Language :: Python :: 3
|
||||
Classifier: Programming Language :: Python :: 3.8
|
||||
Classifier: Programming Language :: Python :: 3.9
|
||||
Classifier: Programming Language :: Python :: 3.10
|
||||
Classifier: Programming Language :: Python :: 3.11
|
||||
Classifier: Programming Language :: Python :: 3.12
|
||||
Classifier: Topic :: Utilities
|
||||
Requires-Dist: prawcore >=2.4, <3
|
||||
Requires-Dist: update_checker >=0.18
|
||||
Requires-Dist: websocket-client >=0.54.0
|
||||
Requires-Dist: coveralls ; extra == "ci"
|
||||
Requires-Dist: packaging ; extra == "dev"
|
||||
Requires-Dist: praw[lint] ; extra == "dev"
|
||||
Requires-Dist: praw[test] ; extra == "dev"
|
||||
Requires-Dist: praw[readthedocs] ; extra == "lint"
|
||||
Requires-Dist: pre-commit ; extra == "lint"
|
||||
Requires-Dist: ruff >=0.0.291 ; extra == "lint"
|
||||
Requires-Dist: furo ; extra == "readthedocs"
|
||||
Requires-Dist: sphinx ; extra == "readthedocs"
|
||||
Requires-Dist: betamax >=0.8, <0.9 ; extra == "test"
|
||||
Requires-Dist: betamax-matchers >=0.3.0, <0.5 ; extra == "test"
|
||||
Requires-Dist: pytest >=2.7.3 ; extra == "test"
|
||||
Requires-Dist: requests >=2.20.1, <3 ; extra == "test"
|
||||
Requires-Dist: urllib3 ==1.26.*, <2 ; extra == "test"
|
||||
Project-URL: Change Log, https://praw.readthedocs.io/en/latest/package_info/change_log.html
|
||||
Project-URL: Documentation, https://praw.readthedocs.io/
|
||||
Project-URL: Issue Tracker, https://github.com/praw-dev/praw/issues
|
||||
Project-URL: Source Code, https://github.com/praw-dev/praw
|
||||
Provides-Extra: ci
|
||||
Provides-Extra: dev
|
||||
Provides-Extra: lint
|
||||
Provides-Extra: readthedocs
|
||||
Provides-Extra: test
|
||||
|
||||
PRAW: The Python Reddit API Wrapper
|
||||
===================================
|
||||
|
||||
.. image:: https://img.shields.io/pypi/v/praw.svg
|
||||
:alt: Latest PRAW Version
|
||||
:target: https://pypi.python.org/pypi/praw
|
||||
|
||||
.. image:: https://img.shields.io/pypi/pyversions/praw
|
||||
:alt: Supported Python Versions
|
||||
:target: https://pypi.python.org/pypi/praw
|
||||
|
||||
.. image:: https://img.shields.io/pypi/dm/praw
|
||||
:alt: PyPI - Downloads - Monthly
|
||||
:target: https://pypi.python.org/pypi/praw
|
||||
|
||||
.. image:: https://github.com/praw-dev/praw/actions/workflows/ci.yml/badge.svg?event=push
|
||||
:alt: GitHub Actions Status
|
||||
:target: https://github.com/praw-dev/praw/actions/workflows/ci.yml
|
||||
|
||||
.. image:: https://coveralls.io/repos/github/praw-dev/praw/badge.svg
|
||||
:alt: Coveralls Coverage
|
||||
:target: https://coveralls.io/github/praw-dev/praw?branch=master
|
||||
|
||||
.. image:: https://api.securityscorecards.dev/projects/github.com/praw-dev/praw/badge
|
||||
:alt: OpenSSF Scorecard
|
||||
:target: https://api.securityscorecards.dev/projects/github.com/praw-dev/praw
|
||||
|
||||
.. image:: https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg
|
||||
:alt: Contributor Covenant
|
||||
:target: https://github.com/praw-dev/.github/blob/main/CODE_OF_CONDUCT.md
|
||||
|
||||
.. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
|
||||
:alt: pre-commit
|
||||
:target: https://github.com/pre-commit/pre-commit
|
||||
|
||||
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
|
||||
:alt: Black code style
|
||||
:target: https://github.com/psf/black
|
||||
|
||||
PRAW, an acronym for "Python Reddit API Wrapper", is a Python package that allows for
|
||||
simple access to Reddit's API. PRAW aims to be easy to use and internally follows all of
|
||||
`Reddit's API rules <https://github.com/reddit/reddit/wiki/API>`_. With PRAW there's no
|
||||
need to introduce ``sleep`` calls in your code. Give your client an appropriate user
|
||||
agent and you're set.
|
||||
|
||||
.. _installation:
|
||||
|
||||
Installation
|
||||
------------
|
||||
|
||||
PRAW is supported on Python 3.8+. The recommended way to install PRAW is via `pip
|
||||
<https://pypi.python.org/pypi/pip>`_.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
pip install praw
|
||||
|
||||
To install the latest development version of PRAW run the following instead:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
pip install --upgrade https://github.com/praw-dev/praw/archive/master.zip
|
||||
|
||||
For instructions on installing Python and pip see "The Hitchhiker's Guide to Python"
|
||||
`Installation Guides <https://docs.python-guide.org/en/latest/starting/installation/>`_.
|
||||
|
||||
Quickstart
|
||||
----------
|
||||
|
||||
Assuming you already have a credentials for a script-type OAuth application you can
|
||||
instantiate an instance of PRAW like so:
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
import praw
|
||||
|
||||
reddit = praw.Reddit(
|
||||
client_id="CLIENT_ID",
|
||||
client_secret="CLIENT_SECRET",
|
||||
password="PASSWORD",
|
||||
user_agent="USERAGENT",
|
||||
username="USERNAME",
|
||||
)
|
||||
|
||||
With the ``reddit`` instance you can then interact with Reddit:
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
# Create a submission to r/test
|
||||
reddit.subreddit("test").submit("Test Submission", url="https://reddit.com")
|
||||
|
||||
# Comment on a known submission
|
||||
submission = reddit.submission(url="https://www.reddit.com/comments/5e1az9")
|
||||
submission.reply("Super rad!")
|
||||
|
||||
# Reply to the first comment of a weekly top thread of a moderated community
|
||||
submission = next(reddit.subreddit("mod").top(time_filter="week"))
|
||||
submission.comments[0].reply("An automated reply")
|
||||
|
||||
# Output score for the first 256 items on the frontpage
|
||||
for submission in reddit.front.hot(limit=256):
|
||||
print(submission.score)
|
||||
|
||||
# Obtain the moderator listing for r/test
|
||||
for moderator in reddit.subreddit("test").moderator():
|
||||
print(moderator)
|
||||
|
||||
Please see PRAW's `documentation <https://praw.readthedocs.io/>`_ for more examples of
|
||||
what you can do with PRAW.
|
||||
|
||||
Discord Bots and Asynchronous Environments
|
||||
------------------------------------------
|
||||
|
||||
If you plan on using PRAW in an asynchronous environment, (e.g., discord.py, asyncio) it
|
||||
is strongly recommended to use `Async PRAW <https://asyncpraw.readthedocs.io/>`_. It is
|
||||
the official asynchronous version of PRAW and its usage is similar and has the same
|
||||
features as PRAW.
|
||||
|
||||
PRAW Discussion and Support
|
||||
---------------------------
|
||||
|
||||
For those new to Python, or would otherwise consider themselves a Python beginner,
|
||||
please consider asking questions on the `r/learnpython
|
||||
<https://www.reddit.com/r/learnpython>`_ subreddit. There are wonderful people there who
|
||||
can help with general Python and simple PRAW related questions.
|
||||
|
||||
Otherwise, there are a few official places to ask questions about PRAW:
|
||||
|
||||
`r/redditdev <https://www.reddit.com/r/redditdev>`_ is the best place on Reddit to ask
|
||||
PRAW related questions. This subreddit is for all Reddit API related discussion so
|
||||
please tag submissions with *[PRAW]*. Please perform a search on the subreddit first to
|
||||
see if anyone has similar questions.
|
||||
|
||||
Real-time chat can be conducted via the `PRAW Slack Organization
|
||||
<https://join.slack.com/t/praw/shared_invite/enQtOTUwMDcxOTQ0NzY5LWVkMGQ3ZDk5YmQ5MDEwYTZmMmJkMTJkNjBkNTY3OTU0Y2E2NGRlY2ZhZTAzMWZmMWRiMTMwYjdjODkxOGYyZjY>`_
|
||||
(please create an issue if that invite link has expired).
|
||||
|
||||
Please do not directly message any of the contributors via Reddit, email, or Slack
|
||||
unless they have indicated otherwise. We strongly encourage everyone to help others with
|
||||
their questions.
|
||||
|
||||
Please file bugs and feature requests as issues on `GitHub
|
||||
<https://github.com/praw-dev/praw/issues>`_ after first searching to ensure a similar
|
||||
issue was not already filed. If such an issue already exists please give it a thumbs up
|
||||
reaction. Comments to issues containing additional information are certainly welcome.
|
||||
|
||||
.. note::
|
||||
|
||||
This project is released with a `Contributor Code of Conduct
|
||||
<https://github.com/praw-dev/.github/blob/main/CODE_OF_CONDUCT.md>`_. By
|
||||
participating in this project you agree to abide by its terms.
|
||||
|
||||
Documentation
|
||||
-------------
|
||||
|
||||
PRAW's documentation is located at https://praw.readthedocs.io/.
|
||||
|
||||
History
|
||||
-------
|
||||
|
||||
`August 2010
|
||||
<https://github.com/praw-dev/praw/commit/efef08a4a713fcfd7dfddf992097cf89426586ae>`_:
|
||||
Timothy Mellor created a github project called ``reddit_api``.
|
||||
|
||||
`March 2011
|
||||
<https://github.com/praw-dev/praw/commit/ebfc9caba5b58b9e68c77af9c8e53f5562a2ee64>`_:
|
||||
The Python package ``reddit`` was registered and uploaded to pypi.
|
||||
|
||||
`December 2011
|
||||
<https://github.com/praw-dev/praw/commit/74bb962b3eefe04ce6acad88e6f53f43d10c8803>`_:
|
||||
Bryce Boe took over as maintainer of the ``reddit`` package.
|
||||
|
||||
`June 2012
|
||||
<https://github.com/praw-dev/praw/commit/adaf89fe8631f41ab9913b379de104c9ef6a1e73>`_:
|
||||
Bryce renamed the project ``PRAW`` and the repository was relocated to the newly created
|
||||
praw-dev organization on GitHub.
|
||||
|
||||
`February 2016
|
||||
<https://github.com/praw-dev/praw/commit/252083ef1dbfe6ea53c2dc99ac235b4ba330b658>`_:
|
||||
Bryce began work on PRAW4, a complete rewrite of PRAW.
|
||||
|
||||
License
|
||||
-------
|
||||
|
||||
PRAW's source (v4.0.0+) is provided under the `Simplified BSD License
|
||||
<https://github.com/praw-dev/praw/blob/0860c11a9309c80621c267af7caeb6a993933744/LICENSE.txt>`_.
|
||||
|
||||
- Copyright ©, 2016, Bryce Boe
|
||||
|
||||
Earlier versions of PRAW were released under `GPLv3
|
||||
<https://github.com/praw-dev/praw/blob/0c88697fdc26e75f87b68e2feb11e101e90ce215/COPYING>`_.
|
||||
|
||||
Reference in New Issue
Block a user