β Added
.pin to manage pinned submissions on the authenticated user's profile..update_display_layout to update the display layout of posts in a
:class:.Collection..SubredditCollectionsModeration.create keyword argument display_layout for
specifying a display layout when creating a :class:.Collection.~.Message.parent to get the parent of a :class:.Message..ModNote to represent a moderator note..ModNote.delete to delete a single moderator note..RedditModNotes to interact with moderator notes from a :class:.Reddit
instance. This provides the ability to create and fetch notes for one or more
redditors from one or more subreddits..RedditorModNotes to interact with moderator notes from a :class:.Redditor
instance..RedditorModNotes.subreddits to obtain moderator notes from multiple
subreddits for a single redditor..SubredditModNotes to interact with moderator notes from a
:class:.Subreddit instance..SubredditModNotes.redditors to obtain moderator notes for multiple redditors
from a single subreddit.~.BaseModNotes.create to create a moderator note..Redditor.notes to interact with :class:.RedditorModNotes..SubredditModeration.notes to interact with :class:.SubredditModNotes.~.ModNoteMixin.create_note create a moderator note from a :class:.Comment or
:class:.Submission.~.ModNoteMixin.author_notes to view the moderator notes for the author of a
:class:.Comment or :class:.Submission.π Changed
.conversations now returns a :class:.ListingGenerator allowing you to page
through more than 100 conversations.π Deprecated
after argument for :meth:.conversations will now have to be included in
params keyword argument.β Added
comment_sort attribute is updated after the
submission has already been fetched and a warn_comment_sort config setting to turn
off the warning..user_selectable to get available subreddit link flairs.π Fixed
libsqlite3-dev is needed to
utilize the sqlite3 builtin..Draft.submit would
not have an effect.β Added
~.WikiPage.discussions to obtain site-wide link submissions that link to the
WikiPage..revert to revert a WikiPage to a specified revision..Inbox.mark_all_read to mark all messages as read with one API call.~.InboxableMixin.unblock_subreddit to unblock a subreddit..update_crowd_control_level to update the crowd control level of a post..moderator_subreddits, which returns information about the subreddits that the
authenticated user moderates, has been restored.refresh_token has been added back. See
https://www.reddit.com/r/redditdev/comments/olk5e6/followup_oauth2_api_changes_regarding_refresh/
for more info..Draft to represent a submission draft..Draft.delete to delete drafts..Draft.submit to submit drafts..Draft.update to modify drafts..DraftHelper to fetch or create drafts on new Reddit..DraftList to represent a list of :class:.Draft objects.π Changed
.Reddit.delete now accepts the params parameter.π Deprecated
.Reddit keyword argument token_manager.β Added
.UserSubreddit for the subreddit attribute of :class:.Redditor..Reddit.username_available checks if a username is available..trusted to retrieve a :class:.RedditorList of trusted users..trust to add a user to the trusted list..distrust to remove a user from the trusted list..SQLiteTokenManager (may not work on Windows)π Changed
.Redditor.moderated will now objectify all data returned from the API.wiki_edit endpoint has been changed from r/{subreddit}/api/wiki/edit/ to
r/{subreddit}/api/wiki/edit..Redditor.block no longer needs to retrieve a user's fullname.π Deprecated
subreddit attribute of :class:.Redditor is no longer a dict.π Fixed
.WikiPage.edit and :meth:.SubredditWiki.create would fail if
passed content and reason parameters that produced a request with a body
greater than 500 KiB, even when the parameters did not exceed their respective
permitted maximum lengths..Reddit.request could not handle instances of BadRequest\s
when the JSON data contained only the keys "reason" and "message"..Reddit.request could not handle instances of BadRequest\s
when the response did not contain valid JSON data..FullnameMixin.fullname sometimes returned the wrong fullname.β Added
.Reddit keyword argument token_manager..FileTokenManager and its parent abstract class :class:.BaseTokenManager.π Deprecated
refresh_token is deprecated and its use will result in a
:py:class:DeprecationWarning. This deprecation applies in all ways of setting
configuration values, i.e., via praw.ini, as a keyword argument when initializing
an instance of :class:.Reddit, and via the PRAW_REFRESH_TOKEN environment
variable. To be prepared for PRAW 8, use the new :class:.Reddit keyword argument
token_manager. See :ref:refresh_token in PRAW's documentation for an example..me will no longer return None when called in :attr:.read_only mode
starting in PRAW 8. A :py:class:DeprecationWarning will be issued. To switch forward
to the PRAW 8 behavior set praw8_raise_exception_on_me=True in your
:class:.Reddit call.π Fixed
π Changed
π Fixed
~asyncio.get_running_loop only exists on Python 3.7+.β Added
~.Subreddits.premium to reflect the naming change in Reddit's API.~.Subreddit.submit_gallery..Reddit.submission..invited to get invited moderators of a subreddit.~.Submission.award and :meth:~.Comment.award with the ability to
specify type of award, anonymity, and message when awarding a submission or comment.subreddits parameter in
:meth:.Reddit.info.Async PRAW <https://asyncpraw.readthedocs.io>_. This also adds a
configuration option to disable the check.π Changed
~.BoundedSet will now utilize a Last-Recently-Used (LRU) storing mechanism,
which will change the order in which elements are removed from the set.~.Subreddit.submit_image and :meth:~.Subreddit.submit_video
performance in slow network environments by removing a race condition when
establishing a websocket connection.π Deprecated
~.Subreddits.gold is superseded by :meth:~.Subreddits.premium.~.Submission.gild is superseded by :meth:~.Submission.award.~.Comment.gild is superseded by :meth:~.Comment.award.π Fixed
β Added
.Rule to represent one rule of a subreddit..SubredditRules to get and add rules.~.Subreddit.submit_poll..PollData and :class:.PollOption..poll_data attribute on poll
submissions.~.Reddit.delete to :class:.Reddit class to support HTTP DELETE
requests..CalendarConfiguration to represent the configuration of a
:class:.Calendar widget..Hover to represent the hover state of a :class:.Button..Styles to represent widget styling information..LiveThreadStream with
method :meth:~.LiveThreadStream.updates.π Changed
.RemovalReason.update's parameters are now optional..SubredditRemovalReasons.__getitem__ now takes integers and slices to get
removal reasons from the list of reasons as returned by Reddit.π Deprecated
.WebSocketException.original_exception is deprecated and slated for removal in
PRAW 8.0.π Fixed
.SubredditModeration.update, such as welcome_message_enabled and
welcome_message_text. This change also removes the need for PRAW to track current
subreddit settings and send unmodified ones in the update request.BadRequest\ s captured by PRAW that do not contain any detailed JSON
data are re-raised as the original BadRequest.~.Subreddit.submit_image and :meth:~.Subreddit.submit_video will throw
:class:.MediaPostFailed when Reddit fails to post an image or video post.