Guidelines for Contributing
Code of Conduct
This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Creating an Issue
Please do not create issues for questions you have. The appropriate location for such questions is /r/redditdev or via Slack.
Please check the Unreleased section of the latest changelog before filing an issue as it is possible the issue has already been resolved.
Please use GitHub's issue search feature to look for already reported issues before reporting your own.
Responding to Issues
One of the simplest ways to help with PRAW is by answering others' questions. When responding, always be positive. While something may be obvious to you, it likely is not to the person asking the question.
Pull Request Creation
If you are fixing an already filed issue, please indicate your intentions by commenting on the issue. This act will hopefully minimize any duplicate work.
Prior to creating a pull request run the
pre_push.pyscript. This script depends on the tools
sphinx_rtd_theme. They can be installed via
pip install black flake8 pydocstyle pylint sphinx sphinx_rtd_themeor via
pip install praw[lint].
Add yourself as a contributor to the
Once pushed, ensure that your Github Actions build succeeds. Actions will error before running any tests if there are any
pydocstyleissues. Resolve any issues by updating your pull request.
Ensure that your change has complete test coverage. Tests on methods that do not require fetching data from Reddit, e.g., method argument validation, should be saved as a unit test. Tests that hit Reddit's servers should be an integration test and all network activity should be recorded via Betamax. The required packages can be installed with
pip install praw[test].
Feel free to check on the status of your pull request periodically by adding a comment.
Becoming a Team Member
The PRAW team is always interested in expanding PRAW's active team member base with proven contributors. If you are interested, please let us know. In general, we would like to see you push a number of contributions before we add you on.
To keep PRAW's source consistent, all contribution code must pass the
pre_push.py script. Github Actions will enforce the passing of the automated
tests, as well as style checking done via the
pre_push.py script. While this
script helps ensure consistency with much of PEP8 and PEP257 there are a few
things that it does not enforce. Please look over the following list:
Import Statement Order
List only a single import per line, and group imports by standard library imports, third party imports and application imports.
from package ... import ...imports prior to entire package
import ...type statements.
Lexicographically sort imports. This process has the intended side effect that top-level relative packages will be imported prior to lower-level packages.
from os.path import abspath, join import sys import traceback from prawcore import NotFound import requests from ...const import API_PATH from ..listing.mixins import SubmissionListingMixin from .base import RedditBase from .mixins import UserContentMixin
Method Order within a Class
Group method names by type and order the groups like so:
Within each grouping method names should be sorted lexicographically.
class Example(object): @staticmethod def a_static_method(): pass @staticmethod def another_static_method(): pass @classmethod def some_class_method(cls): pass @property def name(self): pass def __init__(self): pass def instance_method(self): pass