The changes listed below are divided into four categories. [BUGFIX] Something was broken before, but is now fixed.

Something was broken before, but is now fixed. [CHANGE] Other changes affecting user programs, such as the renaming of a function.

Other changes affecting user programs, such as the renaming of a function. [FEATURE] Something new has been added.

Something new has been added. [REDDIT] A change caused by an upstream change from reddit.

Read /r/changelog to be notified of upstream changes.

PRAW 3.0.0¶ [CHANGE] All requests should now be through HTTPS.

All requests should now be through HTTPS. [CHANGE] All exceptions should be in the PRAW namespace. In particular, there should be no more exceptions under the requests namespace.

All exceptions should be in the PRAW namespace. In particular, there should be no more exceptions under the namespace. [CHANGE] All previously deprecated methods have been removed.

All previously deprecated methods have been removed. [CHANGE] The display_name attribute on instances of Subreddit is now lazily loaded and will match the casing on the site, not the casing used to construct the Subreddit instance. To quickly fetch the name of an unloaded Subreddit, use str(sub_instance) , or unicode(sub_instance) .

The attribute on instances of is now lazily loaded and will match the casing on the site, not the casing used to construct the Subreddit instance. To quickly fetch the name of an unloaded Subreddit, use , or . [CHANGE] Removed praw.Config instance attribute is_reddit .

Removed instance attribute . [CHANGE] evict() now returns the number of items evicted.

now returns the number of items evicted. [CHANGE] Removed praw.ini parameter decode_html_entities . Entities, e.g., & , < > , are now always decoded.

Removed parameter . Entities, e.g., , , are now always decoded. [FEATURE] Added get_message() to fetch a single Message object by its ID.

Added to fetch a single Message object by its ID. [FEATURE] Added get_sticky() to get a Subreddit’s sticky post.

Added to get a Subreddit’s sticky post. [FEATURE] Refresh tokens can be specified in praw.ini via oauth_refresh_token .

Refresh tokens can be specified in via . [FEATURE] Added create_multireddit() to create a new Multireddit.

Added to create a new Multireddit. [FEATURE] Added copy_multireddit() to copy a Multireddit.

Added to copy a Multireddit. [FEATURE] Added edit_multireddit() to edit an existing Multireddit.

Added to edit an existing Multireddit. [FEATURE] Added get_multireddits() to get a list of Multireddits belonging to the requested user.

Added to get a list of Multireddits belonging to the requested user. [FEATURE] Added rename_multireddit() to rename an existing Multireddit.

Added to rename an existing Multireddit. [FEATURE] Added set_suggested_sort() to change a submission’s sort order.

Added to change a submission’s sort order. [FEATURE] Added method as optional parameter to request_json() , so that a request method other than ‘POST’ can be specified.

Added as optional parameter to , so that a request method other than ‘POST’ can be specified. [FEATURE] Added praw.__init__.ReportMixin.hide() and praw.__init__.ReportMixin.unhide() , which accept up to 50 fullnames to be hidden at one time. The appropriate methods in objects.Hideable now point here instead.

Added and , which accept up to 50 fullnames to be hidden at one time. The appropriate methods in now point here instead. [FEATURE] Added add_editor() , remove_editor() , get_settings() and edit_settings() to WikiPage for managing editors and permission levels of individual wiki pages.

Added , , and to for managing editors and permission levels of individual wiki pages. [REDDIT] Removed send_feedback as it is no longer supported by reddit.

Removed as it is no longer supported by reddit. [REDDIT] Added DeprecationWarning to login() as reddit will stop supporting cookie-based authentication on 2015/08/03.

PRAW 2.1.21¶ [BUGFIX] Fix assertion error in replace_more_comments() with continue this thread links that have more than one child.

Fix assertion error in with continue this thread links that have more than one child. [BUGFIX] refresh() on praw.objects.Submission no longer loses comment sort order and other manually specified parameters.

on no longer loses comment sort order and other manually specified parameters. [REDDIT] Add hide_ads as a parameter to set_settings() .

Add as a parameter to . [REDDIT] create_redditor() no longer requires a captcha

no longer requires a captcha [REDDIT] create_subreddit() may require a captcha

PRAW 2.1.20¶ [BUGFIX] Attempting to lazyload an attribute of a comment that has been removed will explicitly raise a praw.errors.InvalidComment() exception, rather than an IndexError (issue #339).

Attempting to lazyload an attribute of a comment that has been removed will explicitly raise a exception, rather than an (issue #339). [BUGFIX] replace_more_comments() handles continue this thread type MoreComments objects.

handles type objects. [FEATURE] Added praw.helpers.valid_redditors() .

Added . [FEATURE] Added a nsfw parameter to get_random_subreddit() that permits fetching a random NSFW Subreddit. This change also supports fetching these subreddits via get_subreddit('randnsfw') .

Added a parameter to that permits fetching a random NSFW Subreddit. This change also supports fetching these subreddits via . [FEATURE] Added a from_sr parameter to send_message() to send the private message from a subreddit you moderate (Like the “From” dropdown box when composing a message).

Added a parameter to to send the private message from a subreddit you moderate (Like the “From” dropdown box when composing a message). [FEATURE] Added Multireddit

Added [FEATURE] Added get_multireddit() to get a single multireddit obj

Added to get a single multireddit obj [FEATURE] Added get_my_multireddits() to get all multireddits owned by the logged in user.

Added to get all multireddits owned by the logged in user. [FEATURE] Added get_multireddit() to Redditor to quickly get a multireddit belonging to that user.

Added to to quickly get a multireddit belonging to that user. [FEATURE] praw.objects.Comment , praw.objects.Redditor , and praw.objects.Submission are now gildable.

, , and are now gildable. [FEATURE] praw.objects.Comment is now saveable.

is now saveable. [REDDIT] Handle upstream change in reddit’s OAuth2 scope parsing.

PRAW 2.1.19¶ [BUGFIX] Support URLs in search() .

Support URLs in . [BUGFIX] Fix bug where json_dict was set to None when it should not have been.

Fix bug where was set to when it should not have been. [BUGFIX] Fix get_subreddit_recommendations() to work with the updated API route.

Fix to work with the updated API route. [BUGFIX] Track time between requests using timeit.default_timer .

Track time between requests using . [CHANGE] get_friends() and get_banned() once again work.

and once again work. [CHANGE] is_root() no longer requires fetching submission objects.

no longer requires fetching submission objects. [REDDIT] Support thing_id lists in get_info() .

Support lists in . [FEATURE] Support providing HTTPS proxies, that is, proxies specific to handling HTTPS requests.

Support providing HTTPS proxies, that is, proxies specific to handling HTTPS requests. [FEATURE] get_liked() and get_disliked() now accept additional arguments, e.g., limit.

and now accept additional arguments, e.g., limit. [FEATURE] Add get_messages() for specifically retreiving messages (not replies).

Add for specifically retreiving messages (not replies). [REDDIT] Add collapse_deleted_comments as a parameter to set_settings() .

Add as a parameter to . [REDDIT] get_stylesheet() now supports using the modconfg OAuth scope.

now supports using the OAuth scope. [REDDIT] get_stylesheet() no longer accepts the prevstyle argument.

PRAW 2.1.18¶ [FEATURE] Add the get_flair_choices() method to the Submission class, which returns the choices for user flair in the subreddit and the current flair of the authenticated user.

Add the method to the class, which returns the choices for user flair in the subreddit and the current flair of the authenticated user. [FEATURE] Add the get_flair_choices() method to the Submission class, which returns the choices for link flair on this submission as well as it’s current flair.

Add the method to the class, which returns the choices for link flair on this submission as well as it’s current flair. [BUGFIX] Fix python3 issue with func_defaults .

Fix python3 issue with . [REDDIT] Avoid exceptions caused by upstream changes by reddit with respect to conflicts between json attributes and RedditContentObject properties. In such cases, the attribute from reddit will be suffixed with “_reddit”.

PRAW 2.1.17¶ [BUGFIX] Remove the built-in score property from comments as reddit provides that attribute as of 2014/06/18.

Remove the built-in property from comments as reddit provides that attribute as of 2014/06/18. [FEATURE] submit() now supports a resubmit argument to allow the submission of an already submitted url.

PRAW 2.1.16¶ [BUGFIX] Fix incorrect username when building Redditor objects from wikipage submissions.

Fix incorrect username when building Redditor objects from wikipage submissions. [CHANGE] Increase the dependency of update_checker to 0.10 or later to prevent ImportWarnings (issue 291).

Increase the dependency of to 0.10 or later to prevent ImportWarnings (issue 291). [CHANGE] get_banned() now takes a user_only argument (default: True ). When the value is explicitly passed as False the return value is not a generator of Redditor objects, but a generator of dictionaries whose name key corresponds to the Redditor object and whose ban-note is at key note .

now takes a argument (default: ). When the value is explicitly passed as the return value is not a generator of objects, but a generator of dictionaries whose key corresponds to the object and whose ban-note is at key . [FEATURE] Enable gathering of duplicate submissions for a Submission object (issue 290).

Enable gathering of duplicate submissions for a Submission object (issue 290). [FEATURE] Add praw.__init__.AuthenticatedReddit.delete() .

PRAW 2.1.15¶ [FEATURE] Add save OAuth scope to save() and unsave() .

Add OAuth scope to and . [BUGFIX] Fix Google AppEngine bug with platform.platform .

Fix Google AppEngine bug with . [REDDIT] Using get_flair() now requires moderator access. See this /r/redditdev thread

Using now requires moderator access. See this /r/redditdev thread [CHANGE] Increase the dependency of update_checker to 0.9 or later.

PRAW 2.1.14¶ [CHANGE] Increase the dependency of six to 1.4 or later.

PRAW 2.1.13¶ [FEATURE] Support building wheel binary distributions.

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.

and 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.

The dependency on has been increased to >= 0.8. [REDDIT] Add support for changes to UserLists on reddit.

Add support for changes to UserLists on reddit. [REDDIT] Using get_flair_list now requires moderator access. See this /r/redditdev thread

Using get_flair_list now requires moderator access. See this /r/redditdev thread [BUGFIX] Fix configuration parsing for store_json_result .

Fix configuration parsing for . [BUGFIX] Fix duplicate bug in BoundedSet .

PRAW 2.1.12¶ [FEATURE] Add json_dict to RedditContentObject .

Add to . [FEATURE] You can now give configuration settings directly when instantiating a BaseReddit object. See the configuration files

You can now give configuration settings directly when instantiating a 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 .

Added and to and . [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.

Add to return the newest subreddits. [FEATURE] Add the arguments save and send_replies to submit() .

Add the arguments and to . [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.

and 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.

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.

Fixed erroneously having the methods and , 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.

Add 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.

now has an 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.

Add methods and to , 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.

Move methods and to from . Redditors can make their likes and dislikes public. Having and on 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.

The attribute has been added to all objects save , 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.

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.

Add and to sticky and unsticky a submission to the top of a subreddit. [FEATURE] Add arguments syntax and period to search() .

Add arguments syntax and period to . [FEATURE] PRAW will now try to use the http_proxy environment variable for proxy settings, if no proxy is set in the configuration file.

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.

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() .

can now be used to get moderator mail from individual subreddits, instead of all moderated subreddits, just like . [FEATURE] Added get_mentions() which is a get_content() generator for username mentions. Only usable if the authenticated user has gold.

Added which is a 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.

Fixed an error in , , and when calling them from 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() .

Added . [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() .

Avoid occasionally processing duplicates in . [CHANGE] comment_stream() yields comments in a consitent order (oldest to newest).

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.

Added 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.

PRAW now supports proper rate-limiting and shared caching when running multiple processes. See 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.

Remove explicit parameters from functions that utilize 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.

returns when the redditor does not exist. [CHANGE] Deprecated get_all_comments() . Use get_comments() with all as the subreddit argument.

Deprecated . Use with as the subreddit argument. [CHANGE] Deprecated get_my_reddits() . Use get_my_subreddits() instead.

Deprecated . Use instead. [CHANGE] Deprecated get_popular_reddits() . Use get_popular_subreddits() instead.

Deprecated . Use instead. [BUGFIX] Allow editing non-top-level wiki pages fetched using Subreddit.get_wiki_page() .

Allow editing non-top-level wiki pages fetched using . [BUGFIX] Fix a bug in submit() . See https://github.com/praw-dev/praw/issues/213.

Fix a bug in . 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.

Added to batch convert fullnames ( ) into objects. [FEATURE] Added get_wiki_banned() to get a list of wiki banned users.

Added 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.

Added and to manage the list of wiki banned users. [FEATURE] Added get_wiki_contributors() to get a list of wiki contributors.

Added to get a list of wiki contributors. [FEATURE] Added add_wiki_contributor() and remove_wiki_contributor() to manage the list of wiki contributors.

Added and to manage the list of wiki contributors. [FEATURE] Added get_wiki_page() to fetch an individual WikiPage.

Added to fetch an individual WikiPage. [FEATURE] Added get_wiki_pages() to get a list of WikiPage objects.

Added 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.

Wiki pages can be edited through either the method of an already existing WikiPage object, or through the function. 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.

PRAW can now decode HTML entities, see #186. The parameter (default ) 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.

Add 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 .

All functions that use the generator function now take . [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.

Requesting user specific data such as while OAuthenticated as a user, then switching OAuthentication to another user and re-requesting the data within 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.

Add the argument to decorator. When is (default ), PRAW wil not prompt for the captcha information but instead raise a 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() .

An upstream change has split new and rising into their own independent listings. Use the new method instead of the old and instead of . [CHANGE] The dependency on update_checker has been increased from >= 0.4 to >= 0.5.

The dependency on 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 its has_mail attribute set to False .

Add parameter (default False) to if it and are both True, then the object in the object will have its attribute set to . [FEATURE] Add get_friends() and get_blocked() to LoggedInRedditor .

Add and to . [FEATURE] Add the read scope to get_all_comments() in the Reddit object.

Add the read scope to in the object. [FEATURE] Add the read scope to get_comments() and the subreddit listings such as get_new() in the Reddit() and Subreddit() object.

Add the read scope to and the subreddit listings such as in the and object. [BUGFIX] Fix bug in MoreComments.comments() .

Fix bug in . [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.

A reddit update broke PRAW’s ability to use 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.

Add the parameter to and methods in and base reddit objects. If is set to , 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).

Add method to 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.

Support reddit OAuth2 scopes (passwordless authentication). See 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.

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.

Add the following API methods to objects (also callable on the base reddit object with the subreddit as the first argument): [FEATURE] Support ‘admin’ and special distinguishing of items via distinguish() .

Support ‘admin’ and distinguishing of items via . [FEATURE] Ability to specify max-character limit for object-to-string representations via output_chars_limit in praw.ini .

Ability to specify max-character limit for object-to-string representations via in . [CHANGE] Remove comments_flat property of Submission objects. The new praw.helpers.flatten_tree() can be used to flatten comment trees.

Remove property of objects. The new 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.

Remove and properties of Submission objects. The now public method must now be explicitly called to replace instances of within the comment tree. [CHANGE] The content_id attribute of RedditContentObject has been renamed to fullname .

The attribute of has been renamed to . [CHANGE] The info base Reddit instance method has been renamed to get_info() .

The base Reddit instance method has been renamed to . [CHANGE] get_saved_links has been renamed to get_saved() and moved to the LoggedInRedditor ( r.user ) namespace.

has been renamed to and moved to the ( ) 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.

The Subreddit method has been renamed to 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.

The 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.

and can no longer be used on objects. Use instead. [CHANGE] Remove depreciated method compose_message .

Remove depreciated method . [CHANGE] Refactored and add a number of exception classes (docs, source) This includes the renaming of: BadCaptcha to InvalidCaptcha . NonExistantUser to InvalidUser .

Refactored and add a number of exception classes (docs, source) This includes the renaming of: [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

Simplify content-limit handling and remove the following no-longer necessary parameters from : [CHANGE] Move the following methods from LoggedInRedditor to base reddit object. get_unread() get_inbox() get_mod_mail() get_sent()

Move the following methods from to base reddit object.

PRAW 1.0.16¶ [FEATURE] Add support for /r/random.

PRAW 1.0.15¶ [FEATURE] Added the functions Hideable() and unhide() to Submission .

Added the functions and to . [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 .

Fixed non-equality bug. Before comparing two PRAW objects with != would always return . [FEATURE] Added the function my_contributions to LoggedInRedditor . Use this to find the subreddits where the user is an approved contributor.

Added the function to . 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.

Printing a to will now limit the output length to 80 chars, just like 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 .

The maximum amount of comments that can be retrieved alongside a submission for gold and regular accounts has been exported to . [REDDIT] Checks for login/moderator in get_moderators() and get_flair() for Subreddit are no longer necessary.

Checks for login/moderator in and 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.

Added the function to , and . This will make PRAW re-query either reddit or the cache, depending on whether the last call was within , 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.

Added functions , and to to allow you to get the Things the user has upvoted, downvoted or hidden. [BUGFIX] Temporary bugfix until prevstyles become optional.

Temporary bugfix until prevstyles become optional. [FEATURE] Added prevstyle to set_stylesheet requests.

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.

Putting in or to 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 .