Praw

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

**Added**

- :attr:`.Multireddit.stream`, to stream submissions and comments from a multireddit.
- :meth:`.Redditor.block`

**Fixed**

- Now raises ``prawcore.UnavailableForLegalReasons`` instead of an
:py:class:`AssertionError` when encountering a HTTP 451 response.

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

**Changed**

- An attribute on :class:`.LiveUpdate` now works as lazy attribute (i.e., populate an
attribute when the attribute is first accessed).

**Deprecated**

- ``subreddit.comments.gilded`` because there isn't actually an endpoint that returns
only gilded comments. Use ``subreddit.gilded`` instead.

**Fixed**

- Removed ``comment.permalink()`` because ``comment.permalink`` is now an attribute
returned by Reddit.

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

**Added**

- :attr:`.Redditor.stream`, with methods :meth:`.RedditorStream.submissions` and
:meth:`.RedditorStream.comments` to stream a Redditor's comments or submissions
- :class:`.RedditorStream` has been added to facilitate :attr:`.Redditor.stream`
- :meth:`.Inbox.collapse` to mark messages as collapsed.
- :meth:`.Inbox.uncollapse` to mark messages as uncollapsed.
- Raise :class:`.ClientException` when calling :meth:`.Comment.refresh` when the comment
does not appear in the resulting comment tree.
- :meth:`.Submission.crosspost` to crosspost to a subreddit.

**Fixed**

- Calling :meth:`.Comment.refresh` on a directly fetched, deeply nested
:class:`.Comment` will additionally pull in as many parent comments as possible
(currently 8) enabling significantly quicker traversal to the top-most
:class:`.Comment` via successive :meth:`.parent` calls.
- Calling :meth:`~.Comment.refresh` previously could have resulted in a
``AttributeError: "MoreComments" object has no attribute "_replies"`` exception. This
situation will now result in a :class:`.ClientException`.
- Properly handle ``BAD_CSS_NAME`` errors when uploading stylesheet images with invalid
filenames. Previously an :py:class:`AssertionError` was raised.
- :class:`.Submission`'s ``gilded`` attribute properly returns the expected value from
reddit.

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

**Fixed**

- Calls to :meth:`.hide` and :meth:`.unhide` properly batch into requests of 50
submissions at a time.
- Lowered the average maximum delay between inactive stream checks by 4x to 16 seconds.
It was previously 64 seconds, which was too long.

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

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