Async PRAW follows semantic versioning.
Added
:meth:`~.SubredditLinkFlairTemplates.reorder` to reorder a subreddit's link flair templates.
:meth:`~.SubredditRedditorFlairTemplates.reorder` to reorder a subreddit's redditor flair templates.
Experimental :meth:`~.Submission._edit_experimental` for adding new inline media or editing a submission that has inline media.
!DANGER!
This method is experimental. It is reliant on undocumented API endpoints and may result in existing inline media not displaying correctly and/or creating a malformed body. Use at your own risk. This method may be removed in the future without warning.
This method is identical to :meth:`.Submission.edit` except for the following:
- The ability to add inline media to existing posts.
- Additional
preserve_inline_media
keyword argument to allow Async PRAW to attempt to preserve the existing inline media when editing a post. This is an experimental fix for an issue that occurs when editing a post with inline media would cause the media to lose their inline appearance.
:func:`.stream_generator` now accepts the
continue_after_id
parameter, which starts the stream after a given item ID.Support for new share URL format created from Reddit's mobile apps.
:class:`.Reddit` has a new configurable parameter,
window_size
. This tells PRAW how long reddit's rate limit window is. This defaults to 600 seconds and shouldn't need to be changed unless reddit changes the size of their rate limit window.
Fixed
- An issue where submitting a post with media would fail due to an API change.
Changed
- Drop support for Python 3.7, which is end-of-life on 2023-06-27.
Fixed
- XML parsing error when media uploads fail.
Changed
- Drop
asyncio_extras
dependency, usecontextlib.asynccontextmanager
instead.
Fixed
- An issue with replying to a modmail conversation results in a error.
Added
- :meth:`.delete_mobile_banner` to delete mobile banners.
- :meth:`.upload_mobile_banner` to upload mobile banners.
Fixed
- An issue with iterating :class:`.ModNote` when a user has more than a hundred notes.
- An issue when uploading media during the submission of a new media post.
- Removal reasons are now returned in the same order as they appear on Reddit.
Changed
- Revert :meth:`~.Comment.edit` positional argument deprecation.
- Revert :meth:`~.Submission.edit` positional argument deprecation.
Fixed
- An issue where :class:`.ModmailConversation`'s
messages
attribute would only contain the latest message.
Added
- :meth:`.pin` to manage pinned submissions on the authenticated user's profile.
- :meth:`.update_display_layout` to update the display layout of posts in a :class:`.Collection`.
- :meth:`.SubredditCollectionsModeration.create` keyword argument
display_layout
for specifying a display layout when creating a :class:`.Collection`. - :attr:`~.Message.parent` to get the parent of a :class:`.Message`.
- :class:`.ModNote` to represent a moderator note.
- :meth:`.ModNote.delete` to delete a single moderator note.
- :class:`.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.
- :class:`.RedditorModNotes` to interact with moderator notes from a :class:`.Redditor` instance.
- :meth:`.RedditorModNotes.subreddits` to obtain moderator notes from multiple subreddits for a single redditor.
- :class:`.SubredditModNotes` to interact with moderator notes from a :class:`.Subreddit` instance.
- :meth:`.SubredditModNotes.redditors` to obtain moderator notes for multiple redditors from a single subreddit.
- :meth:`~.BaseModNotes.create` to create a moderator note.
- :attr:`.Redditor.notes` to interact with :class:`.RedditorModNotes`.
- :attr:`.SubredditModeration.notes` to interact with :class:`.SubredditModNotes`.
- :meth:`~.ModNoteMixin.create_note` create a moderator note from a :class:`.Comment` or :class:`.Submission`.
- :meth:`~.ModNoteMixin.author_notes` to view the moderator notes for the author of a :class:`.Comment` or :class:`.Submission`.
Changed
- Drop support for Python 3.6, which is end-of-life on 2021-12-23.
- :meth:`.conversations` now returns a :class:`.ListingGenerator` allowing you to page through more than 100 conversations.
Deprecated
- The
after
argument for :meth:`.conversations` will now have to be included inparams
keyword argument. - Positional keyword arguments for applicable functions and methods. Starting with Async PRAW 8, most functions and methods will no longer support positional arguments. It will encourage more explicit argument passing, enable arguments to be sorted alphabetically, and prevent breaking changes when adding new arguments to existing methods.
Added
- Log a warning if a submission's
comment_sort
attribute is updated after the submission has already been fetched and awarn_comment_sort
config setting to turn off the warning. - :meth:`.user_selectable` to get available subreddit link flairs.
- Automatic RateLimit handling will support errors with millisecond resolution.
- :class:`.Draft` to represent a submission draft.
- :meth:`.Draft.delete` to delete drafts.
- :meth:`.Draft.submit` to submit drafts.
- :meth:`.Draft.update` to modify drafts.
- :class:`.DraftHelper` to fetch or create drafts on new Reddit.
- :class:`.DraftList` to represent a list of :class:`.Draft` objects.
Deprecated
- Ability to use :class:`.CommentForest` as an asynchronous iterator.
- :meth:`.CommentForest.list` no longer needs to be awaited.
- :attr:`.Submission.comments` no longer needs to be awaited and is now a property.
- The keyword argument
lazy
has been replace byfetch
to consolidate the keyword argument used to explicitly perform a fetch when initializing an object.
Fixed
- Fixed return value type of methods returning a listing in :class:`.Subreddit` and its helper classes.
- An import error when using Async PRAW in environments where
libsqlite3-dev
is needed to utilizeaiosqlite
package which depends on thesqlite3
builtin.
Added
- :meth:`~.WikiPage.discussions` to obtain site-wide link submissions that link to the WikiPage.
- :meth:`.revert` to revert a WikiPage to a specified revision.
- :meth:`.Inbox.mark_all_read` to mark all messages as read with one API call.
- :meth:`~.InboxableMixin.unblock_subreddit` to unblock a subreddit.
- :meth:`.update_crowd_control_level` to update the crowd control level of a post.
- :meth:`.moderator_subreddits`, which returns information about the subreddits that the authenticated user moderates, has been restored.
- The configuration setting
refresh_token
has been added back. See https://www.reddit.com/r/redditdev/comments/olk5e6/followup_oauth2_api_changes_regarding_refresh/ for more info.
Changed
- :meth:`.Reddit.delete` now accepts the
params
parameter.
Deprecated
- :class:`.Reddit` keyword argument
token_manager
.
Changed
- :class:`.Reddit` will now be shallow copied when a deepcopy is preformed on it as
asyncprawcore.Session
(more specifically, :py:class:`asyncio.AbstractEventLoop`) does not support being deepcopied.
Fixed
- Fixed an issue where some :class:`.RedditBase` objects would be sent in a request as
"None"
.
Added
- :class:`.UserSubreddit` for the
subreddit
attribute of :class:`.Redditor`. - :meth:`.username_available` checks if a username is available.
- :meth:`.trusted` to retrieve a :class:`.RedditorList` of trusted users.
- :meth:`.trust` to add a user to the trusted list.
- :meth:`.distrust` to remove a user from the trusted list.
- :class:`.SQLiteTokenManager` (may not work on Windows).
Changed
- :meth:`.moderated` will now objectify all data returned from the API.
- The
wiki_edit
endpoint has been changed fromr/{subreddit}/api/wiki/edit/
tor/{subreddit}/api/wiki/edit
. - :meth:`.Redditor.block` no longer needs to retrieve a user's fullname.
Deprecated
- The
subreddit
attribute of :class:`.Redditor` is no longer a dict. - Legacy modmail is slated for deprecation by Reddit in June 2021. See https://www.reddit.com/r/modnews/comments/mar9ha/even_more_modmail_improvements/ for more info.
Fixed
- Fixed bug where :meth:`.WikiPage.edit` and :meth:`.SubredditWiki.create` would fail if
passed
content
andreason
parameters that produced a request with a body greater than 500 KiB, even when the parameters did not exceed their respective permitted maximum lengths. - Fixed bug where :meth:`.request` could not handle instances of
BadRequest
s when the JSON data contained only the keys "reason" and "message". - Fixed bug where :meth:`.request` could not handle instances of
BadRequest
s when the response did not contain valid JSON data. - Fixed bug where :meth:`~.FullnameMixin.fullname` sometimes returned the wrong fullname.
Added
- :class:`.Reddit` keyword argument
token_manager
. - :class:`.FileTokenManager` and its parent abstract class :class:`.BaseTokenManager`.
Deprecated
- The configuration setting
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., viapraw.ini
, as a keyword argument when initializing an instance of :class:`.Reddit`, and via thePRAW_REFRESH_TOKEN
environment variable. To be prepared for Async PRAW 8, use the new :class:`.Reddit` keyword argumenttoken_manager
. See :ref:`refresh_token` in Async PRAW's documentation for an example. - :meth:`.me` will no longer return
None
when called in :attr:`.read_only` mode starting in Async PRAW 8. A :py:class:`DeprecationWarning` will be issued. To switch forward to the Async PRAW 8 behavior setpraw8_raise_exception_on_me=True
in yourasyncpraw.Reddit(...)
call.
Added
- Add method :meth:`.Subreddits.premium` to reflect the naming change in Reddit's API.
- Ability to submit image galleries with :meth:`~.Subreddit.submit_gallery`.
- Ability to pass a gallery url to :meth:`.Reddit.submission`.
- Ability to specify modmail mute duration.
- Add method :meth:`.invited` to get invited moderators of a subreddit.
- Ability to submit text/self posts with inline media.
- Add method :meth:`.Submission.award` and :meth:`.Comment.award` with the ability to specify type of award, anonymity, and message when awarding a submission or comment.
- Ability to specify subreddits by name using the subreddits parameter in :meth:`.Reddit.info`.
- Added :meth:`.Reddit.close` to close the requestor session.
- Ability to use :class:`.Reddit` as an asynchronous context manager that automatically closes the requestor session on exit.
Changed
- :class:`.BoundedSet` will now utilize a Last-Recently-Used (LRU) storing mechanism, which will change the order in which elements are removed from the set.
- Improved :meth:`~.Subreddit.submit_image` and :meth:`~.Subreddit.submit_video` performance in slow network environments by removing a race condition when establishing a websocket connection.
Deprecated
- :meth:`.Subreddits.gold` is superseded by :meth:`.Subreddits.premium`.
- :meth:`.Submission.gild` is superseded by :meth:`.Submission.award`.
- :meth:`.Comment.gild` is superseded by :meth:`.Comment.award`.
PRAWException
is superseded by :class:`.AsyncPRAWException`.
Fixed
- An issue where leaving as a moderator fails if you are using token auth.
- An issue where an incorrect error was being raised due to invalid submission urls.
- A bug where if you call .parent() on a comment it clears its replies.
- An issue where performing a deepcopy on an :class:`.RedditBase` object will fail.
- Some cases where streams yield the same item multiple times. This cannot be prevented in every case.
- An issue where streams could get stuck on a deleted item and never pull new items.
- Fix subreddit style asset uploading.
- First official Async PRAW release!
- Initial Async PRAW pre-release.
For changes in PRAW please see: PRAW Changelog