Skip to main content

PRAW, an acronym for `Python Reddit API Wrapper`, is a python package that allows for simple access to reddit's API.

Project description

https://travis-ci.org/praw-dev/praw.png

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 as easy to use as possible and is designed to follow all of reddit’s API rules. You have to give a useragent that follows the rules, everything else is handled by PRAW so you needn’t worry about violating them.

Here’s a quick peek, getting the first 5 submissions from the ‘hot’ section of the ‘opensource’ subreddit:

>>> import praw
>>> r = praw.Reddit(user_agent='my_cool_application')
>>> submissions = r.get_subreddit('opensource').get_hot(limit=5)
>>> [str(x) for x in submissions]

This will display something similar to the following:

['10 :: Gun.io Debuts Group Funding for Open Source Projects\n Gun.io',
 '24 :: Support the Free Software Foundation',
 '67 :: The 10 Most Important Open Source Projects of 2011',
 '85 :: Plan 9 - A distributed OS with a unified communicatioprotocol  I/O...',
  '2 :: Open-source webOS is dead on arrival ']

Installation

PRAW works with python 2.6, 2.7, 3.1, 3.2, and 3.3. The recommended way to install is via pip

$ pip install praw

If you don’t have pip installed, then the Hitchhiker’s Guide to Python has a section for setting it up on Windows, Mac and Linux. There is also a Stack overflow question on installing pip on Windows that might prove helpful.

Alternatively you can do it via easy_install

$ easy_install praw

Support

The official place to ask questions about PRAW, reddit and other API wrappers is r/redditdev. If the question is more about Python and less about PRAW, such as “what are generators”, then you’re likely to get more, faster and more in-depth answers in r/learnpython.

If you’ve uncovered a bug or have a feature request, then make an issue on our project page at github.

Documentation

PRAW’s documentation, which includes tutorials, information on configuring PRAW and other good stuff can be found at readthedocs.

License

All of the code contained here is licensed by the GNU GPLv3.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

praw-2.1.19.tar.gz (87.6 kB view details)

Uploaded Source

Built Distribution

praw-2.1.19-py2.py3-none-any.whl (71.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file praw-2.1.19.tar.gz.

File metadata

  • Download URL: praw-2.1.19.tar.gz
  • Upload date:
  • Size: 87.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for praw-2.1.19.tar.gz
Algorithm Hash digest
SHA256 f3c29cf4f2f3b98f6a7f8d5f2e8cefacb2f09d383725dfc139de0800db94bc9b
MD5 b714ba6550de294b98b5eee20e8c44c0
BLAKE2b-256 138dab0f9eddd6c2a1dc1e23329e57d1cfbc17fd15ff60f12c828828a4a5dc7a

See more details on using hashes here.

Provenance

File details

Details for the file praw-2.1.19-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for praw-2.1.19-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 7b386171b7f85c9f19713a5e0fbdcf5458a056c134562d3db7ebd80fd1b550e9
MD5 f2867cfd03df6c88bef43863d3abbbe9
BLAKE2b-256 2801540029fa0f4e48529cf0d10100d4c3005799ef9e021127ba22030d08f0d7

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page