« Changelog History


PRAW v4.0.0.rc1 Release Notes

Release Date: 2016-11-20 // over 7 years ago

  • PRAW 4 introduces significant breaking changes. The numerous changes are not listed here, only the feature removals. Please read through :doc:/getting_started/quick_start to help with updating your code to PRAW 4. If you require additional help please ask on /r/redditdev <https://www.reddit.com/r/redditdev>_ or in the praw-dev/praw <https://gitter.im/praw-dev/praw>_ channel on gitter.

    ➕ Added

    • :meth:praw.models.Comment.block, :meth:praw.models.Message.block, and :meth:praw.models.SubredditMessage.block to permit blocking unwanted user contact.
    • :meth:praw.models.LiveHelper.create to create new live threads.
    • :meth:praw.models.Redditor.unblock to undo a block.
    • :meth:praw.models.Subreddits.gold to iterate through gold subreddits.
    • :meth:praw.models.Subreddits.search to search for subreddits by name and description.
    • :meth:praw.models.Subreddits.stream to obtain newly created subreddits in near-realtime.
    • :meth:praw.models.User.karma to retrieve the current user's subreddit karma.
    • 🔒 praw.models.reddit.submission.SubmissionModeration.lock and praw.models.reddit.submission.SubmissionModeration.unlock to change a Submission's lock state.
    • :meth:praw.models.reddit.subreddit.SubredditFlairTemplates.delete to delete a single flair template.
    • :meth:praw.models.reddit.subreddit.SubredditModeration.unread to iterate over unread moderation messages.
    • :meth:praw.models.reddit.subreddit.ModeratorRelationship.invite to invite a moderator to a subreddit.
    • ⚡️ :meth:praw.models.reddit.subreddit.ModeratorRelationship.update to update a moderator's permissions.
    • ⚡️ :meth:praw.models.reddit.subreddit.ModeratorRelationship.update_invite to update an invited moderator's permissions.
    • :meth:praw.models.Front.random_rising, :meth:praw.models.Subreddit.random_rising and :meth:praw.models.Multireddit.random_rising.
    • 👍 :class:~.WikiPage supports a revision argument.
    • :meth:~.SubredditWiki.revisions to obtain a list of recent revisions to a subreddit.
    • :meth:~.WikiPage.revisions to obtain a list of revisions for a wiki page.
    • 👌 Support installed-type OAuth apps.
    • 👌 Support read-only OAuth for all application types.
    • 👌 Support script-type OAuth apps.

    🔄 Changed

    .. note:: Only prominent changes are listed here.

    • helpers.comments_stream is now :meth:praw.models.reddit.subreddit.SubredditStream.comments
    • helpers.submissions_between is now Subreddit.submissions. This new method now only iterates through newest submissions first and as a result makes approximately 33% fewer requests.
    • helpers.submission_stream is now :meth:praw.models.reddit.subreddit.SubredditStream.submissions

    ✂ Removed

    • ✂ Removed :class:.Reddit's login method. Authentication must be done through OAuth.
    • ✂ Removed praw-multiprocess as this functionality is no longer needed with PRAW 4.
    • ✂ Removed non-oauth functions Message.collapse and Message.uncollapse is_username_available.
    • ✂ Removed captcha related functions.

    👀 For changes prior to version 4.0 please see: 3.4.0 changelog <http://praw.readthedocs.io/en/v3.4.0/pages/changelog.html>_