Praw

------------------

**Added**

- :meth:`.Comment.disable_inbox_replies`, :meth:`.Comment.enable_inbox_replies`
:meth:`.Submission.disable_inbox_replies`, and
:meth:`.Submission.enable_inbox_replies` to toggle inbox replies on comments and
submissions.

**Changed**

- ``cloudsearch`` is no longer the default syntax for :meth:`~.Subreddit.search`.
``lucene`` is now the default syntax so that PRAW's default is aligned with Reddit's
default.
- :meth:`.Reddit.info` will now take either a list of fullnames or a single URL string.
- :meth:`.Subreddit.submit` accepts a flair template ID and text.

**Fixed**

- Fix accessing :attr:`.LiveUpdate.contrib` raises ``AttributeError``.

**Removed**

- Iterating directly over :class:`.SubredditRelationship` (e.g., ``subreddit.banned``,
``subreddit.contributor``, ``subreddit.moderator``, etc) and :class:`.SubredditFlair`
is no longer possible. Iterate instead over their callables, e.g.
``subreddit.banned()`` and ``subreddit.flair()``.
- The following methods are removed: ``Subreddit.mod.approve``,
``Subreddit.mod.distinguish``, ``Subreddit.mod.ignore_reports``,
``Subreddit.mod.remove``, ``Subreddit.mod.undistinguish``,
``Subreddit.mod.unignore_reports``.
- Support for passing a :class:`.Submission` to :meth:`.SubredditFlair.set` is removed.
- The ``thing`` argument to :meth:`.SubredditFlair.set` is removed.
- Return values from :meth:`.Comment.block`, :meth:`.Message.block`,
:meth:`.SubredditMessage.block`, :meth:`.SubredditFlair.delete`, :meth:`.friend`,
:meth:`.Redditor.message`, :meth:`.Subreddit.message`, :meth:`.select`, and
:meth:`.unfriend` are removed as they do not provide any useful information.
- ``praw.ini`` no longer reads in ``http_proxy`` and ``https_proxy`` settings.
- ``is_link`` parameter of :meth:`.SubredditRedditorFlairTemplates.add` and
:meth:`.SubredditRedditorFlairTemplates.clear`. Use
:class:`.SubredditLinkFlairTemplates` instead.

------------------

The release's sole purpose is to announce the deprecation of the ``is_link`` parameter
as described below:

**Added**

- :attr:`.SubredditFlair.link_templates` to manage link flair templates.

**Deprecated**

- ``is_link`` parameter of :meth:`.SubredditRedditorFlairTemplates.add` and
:meth:`.SubredditRedditorFlairTemplates.clear`. Use
:class:`.SubredditLinkFlairTemplates` instead.

------------------

**Fixed**

- Calling :meth:`.parent` works on :class:`.Comment` instances obtained via
:meth:`.comment_replies`.

------------------

**Added**

- :meth:`.Modmail.unread_count` to get unread count by conversation state.
- :meth:`.Modmail.bulk_read` to mark conversations as read by conversation state.
- :meth:`.Modmail.subreddits` to fetch subreddits using new modmail.
- :meth:`.Modmail.create` to create a new modmail conversation.
- :meth:`.ModmailConversation.read` to mark modmail conversations as read.
- :meth:`.ModmailConversation.unread` to mark modmail conversations as unread.
- :meth:`.conversations` to get new modmail conversations.
- :meth:`.ModmailConversation.highlight` to highlight modmail conversations.
- :meth:`.ModmailConversation.unhighlight` to unhighlight modmail conversations.
- :meth:`.ModmailConversation.mute` to mute modmail conversations.
- :meth:`.ModmailConversation.unmute` to unmute modmail conversations.
- :meth:`.ModmailConversation.archive` to archive modmail conversations.
- :meth:`.ModmailConversation.unarchive` to unarchive modmail conversations.
- :meth:`.ModmailConversation.reply` to reply to modmail conversations.
- :meth:`.Modmail.__call__` to get a new modmail conversation.
- :meth:`.Inbox.stream` to stream new items in the inbox.
- Exponential request delay to all streams when no new items are returned in a request.
The maximum delay between requests is 66 seconds.

**Changed**

- :meth:`~.Subreddit.submit` accepts ``selftext=''`` to create a title-only submission.
- :class:`.Reddit` accepts ``requestor_class=cls`` for a customized requestor class and
``requestor_kwargs={"param": value}`` for passing arguments to requestor
initialization.
- :meth:`.SubredditStream.comments`, :meth:`.SubredditStream.submissions`, and
:meth:`.Subreddits.stream` accept a ``pause_after`` argument to allow pausing of the
stream. The default value of ``None`` retains the preexisting behavior.

**Deprecated**

- ``cloudsearch`` will no longer be the default syntax for :meth:`.Subreddit.search` in
PRAW 5. Instead, ``lucene`` will be the default syntax so that PRAW's default is
aligned with Reddit's default.

**Fixed**

- Fix bug where :class:`.WikiPage` revisions with deleted authors caused ``TypeError``.
- :class:`.Submission` attributes ``comment_limit`` and ``comment_sort`` maintain their
values after making instances non-lazy.

------------------

**Added**

- :meth:`.LiveThreadContribution.update` to update settings of a live thread.
- ``reset_timestamp`` to :meth:`.limits` to provide insight into when the current rate
limit window will expire.
- :meth:`.upload_mobile_header` to upload subreddit mobile header.
- :meth:`.upload_mobile_icon` to upload subreddit mobile icon.
- :meth:`.delete_mobile_header` to remove subreddit mobile header.
- :meth:`.delete_mobile_icon` to remove subreddit mobile icon.
- :meth:`.LiveUpdateContribution.strike` to strike a content of a live thread.
- :meth:`.LiveContributorRelationship.update` to update contributor permissions for a
redditor.
- :meth:`.LiveContributorRelationship.update_invite` to update contributor invite
permissions for a redditor.
- :meth:`.LiveThread.discussions` to get submissions linking to the thread.
- :meth:`.LiveThread.report` to report the thread violating the Reddit rules.
- :meth:`.LiveHelper.now` to get the currently featured live thread.
- :meth:`.LiveHelper.info` to fetch information about each live thread in live thread
IDs.

**Fixed**

- Uploading an image resulting in too large of a request (>500 KB) now raises
``prawcore.TooLarge`` instead of an :py:class:`AssertionError`.
- Uploading an invalid image raises ``APIException``.
- :class:`.Redditor` instances obtained via :attr:`~.Subreddit.moderator` (e.g.,
``reddit.subreddit("test").moderator()``) will contain attributes with the
relationship metadata (e.g., ``mod_permissions``).
- :class:`.Message` instances retrieved from the inbox now have attributes ``author``,
``dest`` ``replies`` and ``subreddit`` properly converted to their appropriate PRAW
model.

------------------

**Added**

- :meth:`.LiveContributorRelationship.leave` to abdicate the live thread contributor
position.
- :meth:`.LiveContributorRelationship.remove` to remove the redditor from the live
thread contributors.
- :meth:`.limits` to provide insight into number of requests made and remaining in the
current rate limit window.
- :attr:`.LiveThread.contrib` to obtain an instance of :class:`.LiveThreadContribution`.
- :meth:`.LiveThreadContribution.add` to add an update to the live thread.
- :meth:`.LiveThreadContribution.close` to close the live thread permanently.
- :attr:`.LiveUpdate.contrib` to obtain an instance of :class:`.LiveUpdateContribution`.
- :meth:`.LiveUpdateContribution.remove` to remove a live update.
- :meth:`.LiveContributorRelationship.accept_invite` to accept an invite to contribute
the live thread.
- :meth:`.SubredditHelper.create` and :meth:`.SubredditModeration.update` have
documented support for ``spoilers_enabled``. Note, however, that
:meth:`.SubredditModeration.update` will currently unset the ``spoilers_enabled``
value until such a time that Reddit returns the value along with the other settings.
- :meth:`.spoiler` and :meth:`.unspoiler` to change a submission's spoiler status.

**Fixed**

- :meth:`.LiveContributorRelationship.invite` and
:meth:`.LiveContributorRelationship.remove_invite` now hit endpoints, which starts
with "api/", for consistency.
- :meth:`.ModeratorRelationship.update`, and
:meth:`.ModeratorRelationship.update_invite` now always remove known unlisted
permissions.