Changelog

The changes listed below are divided into four categories.

• [FEATURE] Something new has been added.
• [BUGFIX] Something was broken before, but is now fixed.
• [REDDIT] A change caused by an upstream change from reddit.
• [CHANGE] Other changes affecting user programs, such as the renaming of a function.

Read r/changelog to be notified of upstream changes.

UNRELEASED

• [FEATURE] Support building wheel binary distributions.
• [FEATURE] get_submission() and from_url() now supports url parameters. Both included within the url and explicitly via the “params” argument.
• [CHANGE] The dependency on update_checker has been increased to >= 0.8.
• [REDDIT] Add support for changes to UserLists on reddit.
• [REDDIT] Using get_flair_list now requires moderator access. See this r/redditdev thread
• [BUGFIX] Fix configuration parsing for store_json_result.
• [BUGFIX] Fix duplicate bug in BoundedSet.

PRAW 2.1.12

• [FEATURE] Add json_dict to RedditContentObject.
• [FEATURE] You can now give configuration settings directly when instantiating a BaseReddit object. See the configuration files
• [BUGFIX] Fixed a bug that caused an AttributeError to be raised when using a deprecated method.

PRAW 2.1.11

• [FEATURE] Added ignore_reports() and unignore_reports() to Comment and Submission.
• [BUGFIX] The history scope is not required for get_comments(), get_overview() and get_submitted() despite the official reddit documentation saying so. Redditors may choose to make their voting record public, in which case no authentication is required for get_disliked() or get_liked(). The history scope requirement for the above-mentioned methods has been removed.

PRAW 2.1.10

• [FEATURE] Add get_new_subreddits() to return the newest subreddits.
• [FEATURE] Add the arguments save and send_replies to submit().
• [FEATURE] Create and add history scope to get_comments(), get_disliked(), get_liked(), get_overview(), get_submitted(), get_hidden() and get_saved().

PRAW 2.1.9

• [FEATURE] mark_as_nsfw() and unmark_as_nsfw() can now be used if the currently authenticated user is the author of the Submission.
• [FEATURE] get_contributors() can now be used for accessing the contributor list of protected/private subreddits without requiring moderator access. See issue issue 246.
• [BUGFIX] Fixed Comment erroneously having the methods mark_as_nsfw and unmark_as_nsfw, despite comments not being able to be marked as NSFW.
• [REDDIT] Update get_subreddit_recommendations() to handle changed returned data format.

PRAW 2.1.8

• [FEATURE] Add get_subreddit_recommendations() to get a recommendation of subreddits based on a list of provided subreddits.
• [FEATURE] Subreddit now has an __repr__ method. So it’s now possible to identify what subreddit the object represents from the human readable representation of the object.
• [FEATURE] Add praw.__init__.UnauthenticatedReddit.get_rising() that returns the rising listing of the front page in the context of the currently logged-in user (if any).

PRAW 2.1.7

• [FEATURE] Add methods set_contest_mode() and unset_contest_mode() to Submission, for (un)setting of contest modes. See this Reddit post for information about contest mode.
• [FEATURE] Move methods get_liked() and get_liked() to Redditor from LoggedInRedditor. Redditors can make their likes and dislikes public. Having get_liked() and get_liked() on Redditor allows PRAW to access this info.
• [FEATURE] The has_fetched attribute has been added to all objects save Reddit, see the lazy loading page in PRAW’s documentation for more details.
• [BUGFIX] Fixed a bug that caused the timeout configuration setting to always be the default 45 irrespective of what it was set to in praw.ini.

PRAW 2.1.6

• [BUGFIX] PRAW automatically retries failed requests to reddit if the error is likely to be a temporary one. This resulted in spamming reddit if the error occurred after content had been saved to reddit’s database. Therefore the following methods will no longer retry failed request upload_image(), send_message(), submit(), send_feedback(), reply() and add_comment(). Additionally request_json() now has the retry_on_error argument, which if set to True will prevent retries of the request if it fails.

PRAW 2.1.5

• [FEATURE] select_flair() method added, can be used to change your flair without moderator access on subreddits that allow it.
• [FEATURE] Add sticky() and unsticky() to sticky and unsticky a submission to the top of a subreddit.
• [FEATURE] Add arguments syntax and period to search().
• [FEATURE] PRAW will now try to use the http_proxy environment variable for proxy settings, if no proxy is set in the configuration file.
• [BUGFIX] get_stylesheet() erroneously required moderator access. It now just requires that the authenticated user has access to the subreddit.
• [BUGFIX] Fix bug that prevented the usage of search() when called from Subreddit.

PRAW 2.1.4

• [FEATURE] get_mod_mail() can now be used to get moderator mail from individual subreddits, instead of all moderated subreddits, just like get_mod_queue().
• [FEATURE] Added get_mentions() which is a get_content() generator for username mentions. Only usable if the authenticated user has gold.
• [BUGFIX] Fixed an error in get_mod_queue(), get_reports(), get_spam() and get_unmoderated() when calling them from Reddit without giving the subreddit argument explicitly.
• [REDDIT] New fields public_traffic added to set_settings() as per the upstream change.

PRAW 2.1.3

• [FEATURE] Added UnauthenticatedReddit.get_random_submission().
• [BUGFIX] Verify that sys.stdin has closed attribute before checking if the stream is closed.

PRAW 2.1.2

• [BUGFIX] Avoid occasionally processing duplicates in comment_stream().
• [CHANGE] comment_stream() yields comments in a consitent order (oldest to newest).
• [FEATURE] Support fetching submission listings for domains via get_domain_listing().

PRAW 2.1.1

• [FEATURE] Added praw.helpers.comment_stream() to provide a neverending stream of new comments.
• [BUGFIX] Don’t cache requests whose responses will result in an exception. This bug was introduced in version 2.1.0.

PRAW 2.1.0

• [FEATURE] PRAW now supports proper rate-limiting and shared caching when running multiple processes. See Concurrent PRAW Instances for usage information.
• [CHANGE] Remove explicit limit parameters from functions that utilize get_content() but don’t alter the limit. This change will result in broken code if the calling code utilizes positional instead of keyword arguments.
• [CHANGE] get_flair() returns None when the redditor does not exist.
• [CHANGE] Deprecated get_all_comments(). Use get_comments() with all as the subreddit argument.
• [CHANGE] Deprecated get_my_reddits(). Use get_my_subreddits() instead.
• [CHANGE] Deprecated get_popular_reddits(). Use get_popular_subreddits() instead.
• [BUGFIX] Allow editing non-top-level wiki pages fetched using Subreddit.get_wiki_page().
• [BUGFIX] Fix a bug in submit(). See https://github.com/praw-dev/praw/issues/213.
• [BUGFIX] Fix a python 3.3 bug in upload_image(). See https://github.com/praw-dev/praw/issues/211.

PRAW 2.0.15

• [FEATURE] PRAW can now use a proxy server, see #206. The parameter http_proxy (optional) has been added to the configuration file to define a proxy server in the form host:ip or http://login:user@host:ip.

PRAW 2.0.14

• [BUGFIX] Prevent potential invalid redirect exception when using get_wiki_page().

PRAW 2.0.13

• [FEATURE] Added get_submissions() to batch convert fullnames (t3_bas36id) into Submission objects.
• [FEATURE] Added get_wiki_banned() to get a list of wiki banned users.
• [FEATURE] Added add_wiki_ban() and remove_wiki_ban() to manage the list of wiki banned users.
• [FEATURE] Added get_wiki_contributors() to get a list of wiki contributors.
• [FEATURE] Added add_wiki_contributor() and remove_wiki_contributor() to manage the list of wiki contributors.
• [FEATURE] Added get_wiki_page() to fetch an individual WikiPage.
• [FEATURE] Added get_wiki_pages() to get a list of WikiPage objects.
• [FEATURE] Wiki pages can be edited through either the WikiPage.edit() method of an already existing WikiPage object, or through the edit_wiki_page() function. edit_wiki_page() is also used to create new wiki pages.
• [CHANGE] Deprecated ban(), unban(), make_contributor(), and make_moderator() in favor of the consistently named add_ban(), remove_ban(), add_contributor(), and add_moderator() respectively.

PRAW 2.0.12

• [FEATURE] PRAW can now decode HTML entities, see #186. The parameter decode_html_entities (default False) has been added to the configuration file to control whether this feature is activated.
• [FEATURE] Add InvalidSubreddit exception which is raised when attempting to get a listing for a nonexistent subreddit.
• [FEATURE] All functions that use the get_content() generator function now take *args, **kwargs.
• [BUGFIX] Requesting user specific data such as get_unread() while OAuthenticated as a user, then switching OAuthentication to another user and re-requesting the data within cache_timeout would return the cached results matching the previously authenticated user.
• [BUGFIX] friend() and unfriend() used to raise an AttributeError when called without user/pswd authentication. It now properly raises LoginRequired.

PRAW 2.0.11

• [FEATURE] Add the raise_captcha_exception argument to RequireCaptcha decorator. When raise_captcha_exception is True (default False), PRAW wil not prompt for the captcha information but instead raise a InvalidCaptcha exception.
• [REDDIT] An upstream change has split new and rising into their own independent listings. Use the new praw.objects.Subreddit.get_rising() method instead of the old get_new_by_rising() and get_new() instead of get_new_by_date().
• [CHANGE] The dependency on update_checker has been increased from >= 0.4 to >= 0.5.
• [BUGFIX] After inviting a moderator invite, the cached set of moderated subreddits would not be updated with the new subreddit. Causing restrict_access() to prevent performing moderater actions in the subreddit.

PRAW 2.0.10

• [FEATURE] Add delete_flair() method to Subreddit and Reddit objects.

PRAW 2.0.9

• [FEATURE] Add parameter update_user (default False) to get_unread() if it and unset_has_mail are both True, then the user object in the Reddit object will have it’s has_mail attribute set to False.
• [FEATURE] Add get_friends() and get_blocked() to LoggedInRedditor.
• [FEATURE] Add the read scope to get_all_comments() in the Reddit object.
• [FEATURE] Add the read scope to get_comments() and the subreddit listings such as get_new() in the Reddit() and Subreddit() object.
• [BUGFIX] Fix bug in MoreComments.comments().
• [CHANGE] Break get_friends() and get_banned() until there is an upstream fix to mean that does not require ssl for those endpoints.

PRAW 2.0.8

• [FEATURE] Add unset_has_mail parameter to get_unread(), if it’s set to True, then it will set has_mail for the logged-in user to False.

PRAW 2.0.7

• [REDDIT] A reddit update broke PRAW’s ability to use login() if it was authenticated as a logged-in user. This update adds the ability to re-login.
• [CHANGE] get_flair_list() can now be used when logged-in as a regular user, being logged in as a mod of the subreddit is no longer required.

PRAW 2.0.6

• [FEATURE] Add the get_unmoderated() method to Subreddit and base reddit objects. This returns a listings of submissions that haven’t been approved/removed by a moderator.

PRAW 2.0.5

• [FEATURE] Add the parameter gilded_only to get_comments() and get_all_comments() methods in Subreddit and base reddit objects. If gilded_only is set to True, then only gilded comments will be returned.
• [FEATURE] Add get_comments() method to Reddit object. It works like get_comments() in Subreddit objects except it takes the subreddit as the first argument.

PRAW 2.0.4

• [BUGFIX] Fix python 3 failure within the test suite introduced in 2.0.3.

PRAW 2.0.3

• [FEATURE] Add delete_image() method to Subreddit objects (also callable on the base reddit object with the subreddit as the first argument).
• [CHANGE] PRAW now requires version 0.4 of update_checker.

PRAW 2.0.2

• [BUGFIX] Fixed bug when comparing MoreComments classes in Python 3.x.

PRAW 2.0.1

• [BUGFIX] Fix bug with limit=None in method replace_more_comments() in Submission object.

PRAW 2.0.0

• [FEATURE] Support reddit OAuth2 scopes (passwordless authentication). See PRAW and OAuth for usage information.
• [FEATURE] Maximize the number of items fetched when explicit limits are set thus reducing the number of requests up to 4x in some cases.
• [FEATURE] Add the following API methods to Subreddit objects (also callable on the base reddit object with the subreddit as the first argument):
  • accept_moderator_invite() – accept a pending moderator invite.
  • get_mod_log() – return ModAction objects for each item (run vars(item), to see available attributes).
  • configure_flair() – interface to subreddit flair options.
  • upload_image() – upload an image for the subreddit header or use in CSS.
• [FEATURE] Support ‘admin’ and special distinguishing of items via distinguish().
• [FEATURE] Ability to specify max-character limit for object-to-string representations via output_chars_limit in praw.ini.
• [CHANGE] Remove comments_flat property of Submission objects. The new praw.helpers.flatten_tree() can be used to flatten comment trees.
• [CHANGE] Remove all_comments and all_comments_flat properties of Submission objects. The now public method replace_more_comments() must now be explicitly called to replace instances of MoreComments within the comment tree.
• [CHANGE] The content_id attribute of RedditContentObject has been renamed to fullname.
• [CHANGE] The info base Reddit instance method has been renamed to get_info().
• [CHANGE] get_saved_links has been renamed to get_saved() and moved to the LoggedInRedditor (r.user) namespace.
• [CHANGE] The Subreddit get_info method has been renamed to from_url() and supports parameters for changing the number of comments to fetch and by what sort method.
• [CHANGE] The get_submission() method also now supports parameters for changing the number of comments to fetch and by what sort method.
• [CHANGE] mark_as_nsfw() and unmark_as_nsfw() can no longer be used on Subreddit objects. Use update_settings(nsfw=True) instead.
• [CHANGE] Remove depreciated method compose_message.
• [CHANGE] Refactored and add a number of exception classes (docs, source) This includes the renaming of:
  • BadCaptcha to InvalidCaptcha.
  • NonExistantUser to InvalidUser.
• [CHANGE] Simplify content-limit handling and remove the following no-longer necessary parameters from praw.ini:
  • comment_limit
  • comment_sort
  • default_content_limit
  • gold_comments_max
  • more_comments_max
  • regular_comments_max
• [CHANGE] Move the following methods from LoggedInRedditor to base reddit object.
  • get_unread()
  • get_inbox()
  • get_mod_mail()
  • get_sent()

PRAW 1.0.16

• [FEATURE] Add support for r/random.

PRAW 1.0.15

• [FEATURE] Added the functions hide() and unhide() to Submission.
• [FEATURE] Added function is_username_available() to Reddit.

PRAW 1.0.14

• [FEATURE] Extended functionality to Python 3.3.

PRAW 1.0.13

• [BUGFIX] Fixed non-equality bug. Before comparing two PRAW objects with != would always return True.
• [FEATURE] Added the function my_contributions to LoggedInRedditor. Use this to find the subreddits where the user is an approved contributor.
• [CHANGE] Voting on something will now force the next call to get_liked() or get_disliked() to re-query from the reddit rather than use the cache.

PRAW 1.0.12

• [FEATURE] Support for optional ‘prev’ values added.

PRAW 1.0.11

• [FEATURE] Added get_top() to Reddit.

PRAW 1.0.10

• [FEATURE] Allow for the OS to not be identified when searching for praw.ini.

PRAW 1.0.9

• [FEATURE] Added the functions mark_as_nsfw() and unmark_as_nsfw() to Submission and Subreddit.

PRAW 1.0.8

• [CHANGE] Printing a Submission to sys.stdout will now limit the output length to 80 chars, just like Comment does.
• [FEATURE] The maximum amount of comments that can be retrieved alongside a submission for gold and regular accounts has been exported to praw.ini.
• [REDDIT] Checks for login/moderator in get_moderators() and get_flair() for Subreddit are no longer necessary.
• [FEATURE] Added the function refresh() to Submission, Subreddit and Redditor. This will make PRAW re-query either reddit or the cache, depending on whether the last call was within cache_timeout, for the latest values and update the objects values.
• [FEATURE] Added functions get_liked(), get_disliked() and get_hidden() to LoggedInRedditor to allow you to get the Things the user has upvoted, downvoted or hidden.
• [BUGFIX] Temporary bugfix until prevstyles become optional.
• [FEATURE] Added prevstyle to set_stylesheet requests.
• [BUGFIX] Putting in user or pswd to praw.ini without values will no longer make it impossible to login.
• [FEATURE] You can now have just user filled out in praw.ini to ease login while remaining safe.

PRAW 1.0.7

• [REDDIT] New fields prev_description_id and prev_public_description_id added to set_settings() as per the upstream change.

PRAW 1.0.6

• [CHANGE] compose_message has been renamed to send_message() in Reddit and LoggedInRedditor. compose_message is now depreciated and will be removed around the end of 2012.

PRAW 1.0.5

• [FEATURE] get_popular_reddits() added to Reddit.

PRAW 1.0.4

• [FEATURE] Added get_new() and get_controversial() to Reddit.

PRAW 1.0.3

• [REDDIT] The logged in / moderator checks for flair_list in Reddit are no longer needed and have been removed.

PRAW 1.0.2

• [FEATURE] score property wrapped function have been added to Comment.

PRAW 1.0.1

• [FEATURE] require_moderator decorator now supports multi-reddits.
• [FEATURE] Rudimentary logging of the http requests have been implemented.

PRAW 1.0.0