Update pre-commit hooks

.pre-commit-config.yaml

@@ -42,7 +42,7 @@ repos:
         files: ^(.*\.toml)$
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.11
+    rev: v0.1.14
     hooks:
       - id: ruff
         args: [ --exit-non-zero-on-fix, --fix ]
@@ -51,7 +51,7 @@ repos:
   - repo: https://github.com/psf/black
     hooks:
       - id: black
-    rev: 23.12.1
+    rev: 24.1.1
 
   - repo: https://github.com/LilSpazJoekp/docstrfmt
     hooks:

praw/__init__.py

@@ -8,5 +8,6 @@
 More information about PRAW can be found at https://github.com/praw-dev/praw.
 
 """
+
 from .const import __version__
 from .reddit import Reddit

praw/config.py

@@ -1,4 +1,5 @@
 """Provides the code to load PRAW's configuration file ``praw.ini``."""
+
 from __future__ import annotations
 
 import configparser

praw/const.py

@@ -1,4 +1,5 @@
 """PRAW constants."""
+
 from .endpoints import API_PATH  # noqa: F401
 
 __version__ = "7.7.2.dev0"

praw/endpoints.py

@@ -1,4 +1,5 @@
 """List of API endpoints PRAW knows about."""
+
 # fmt: off
 API_PATH = {
     "about_edited":            "r/{subreddit}/about/edited/",

praw/exceptions.py

@@ -7,6 +7,7 @@
 All other exceptions are subclassed from :class:`.ClientException`.
 
 """
+
 from __future__ import annotations
 
 from typing import Any
@@ -216,12 +217,14 @@ def parse_exception_list(
     ) -> list[RedditErrorItem]:
         """Covert an exception list into a :class:`.RedditErrorItem` list."""
         return [
-            exception
-            if isinstance(exception, RedditErrorItem)
-            else RedditErrorItem(
-                error_type=exception[0],
-                field=exception[2] if bool(exception[2]) else "",
-                message=exception[1] if bool(exception[1]) else "",
+            (
+                exception
+                if isinstance(exception, RedditErrorItem)
+                else RedditErrorItem(
+                    error_type=exception[0],
+                    field=exception[2] if bool(exception[2]) else "",
+                    message=exception[1] if bool(exception[1]) else "",
+                )
             )
             for exception in exceptions
         ]

praw/models/__init__.py

@@ -1,4 +1,5 @@
 """Provide the PRAW models."""
+
 from .auth import Auth
 from .front import Front
 from .helpers import DraftHelper, LiveHelper, MultiredditHelper, SubredditHelper

praw/models/auth.py

@@ -1,4 +1,5 @@
 """Provide the Auth class."""
+
 from __future__ import annotations
 
 from prawcore import Authorizer, ImplicitAuthorizer, UntrustedAuthenticator, session

praw/models/base.py

@@ -1,4 +1,5 @@
 """Provide the PRAWBase superclass."""
+
 from __future__ import annotations
 
 from copy import deepcopy

praw/models/comment_forest.py

@@ -1,4 +1,5 @@
 """Provide CommentForest for submission comments."""
+
 from __future__ import annotations
 
 from heapq import heappop, heappush

praw/models/front.py

@@ -1,4 +1,5 @@
 """Provide the Front class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Iterator

praw/models/helpers.py

@@ -1,4 +1,5 @@
 """Provide the helper classes."""
+
 from __future__ import annotations
 
 from json import dumps
@@ -73,10 +74,9 @@ def create(
         selftext: str | None = None,
         send_replies: bool = True,
         spoiler: bool = False,
-        subreddit: str
-        | praw.models.Subreddit
-        | praw.models.UserSubreddit
-        | None = None,
+        subreddit: (
+            str | praw.models.Subreddit | praw.models.UserSubreddit | None
+        ) = None,
         title: str | None = None,
         url: str | None = None,
         **draft_kwargs: Any,

praw/models/inbox.py

@@ -1,4 +1,5 @@
 """Provide the Front class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Iterator

praw/models/list/base.py

@@ -1,4 +1,5 @@
 """Provide the BaseList class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Iterator

praw/models/list/draft.py

@@ -1,4 +1,5 @@
 """Provide the DraftList class."""
+
 from .base import BaseList
 
 

praw/models/list/moderated.py

@@ -1,4 +1,5 @@
 """Provide the ModeratedList class."""
+
 from .base import BaseList
 
 

praw/models/list/redditor.py

@@ -1,4 +1,5 @@
 """Provide the RedditorList class."""
+
 from .base import BaseList
 
 

praw/models/list/trophy.py

@@ -1,4 +1,5 @@
 """Provide the TrophyList class."""
+
 from .base import BaseList
 
 

praw/models/listing/domain.py

@@ -1,4 +1,5 @@
 """Provide the DomainListing class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

praw/models/listing/generator.py

@@ -1,4 +1,5 @@
 """Provide the ListingGenerator class."""
+
 from __future__ import annotations
 
 from copy import deepcopy

praw/models/listing/listing.py

@@ -1,4 +1,5 @@
 """Provide the Listing class."""
+
 from __future__ import annotations
 
 from typing import Any

praw/models/listing/mixins/__init__.py

@@ -1,4 +1,5 @@
 """Package providing models that pertain to listing mixins."""
+
 from .base import BaseListingMixin
 from .redditor import RedditorListingMixin
 from .rising import RisingListingMixin

praw/models/listing/mixins/base.py

@@ -1,4 +1,5 @@
 """Provide the BaseListingMixin class."""
+
 from __future__ import annotations
 
 from typing import Any, Iterator

praw/models/listing/mixins/gilded.py

@@ -1,4 +1,5 @@
 """Provide the GildedListingMixin class."""
+
 from __future__ import annotations
 
 from typing import Any, Iterator

praw/models/listing/mixins/redditor.py

@@ -1,4 +1,5 @@
 """Provide the RedditorListingMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Iterator

praw/models/listing/mixins/rising.py

@@ -1,4 +1,5 @@
 """Provide the RisingListingMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Iterator

praw/models/listing/mixins/submission.py

@@ -1,4 +1,5 @@
 """Provide the SubmissionListingMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Iterator

praw/models/listing/mixins/subreddit.py

@@ -1,4 +1,5 @@
 """Provide the SubredditListingMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Iterator

praw/models/mod_action.py

@@ -1,4 +1,5 @@
 """Provide the ModAction class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

praw/models/mod_note.py

@@ -1,4 +1,5 @@
 """Provide the ModNote class."""
+
 from __future__ import annotations
 
 from ..endpoints import API_PATH

praw/models/mod_notes.py

@@ -1,4 +1,5 @@
 """Provides classes for interacting with moderator notes."""
+
 from itertools import islice
 from typing import TYPE_CHECKING, Any, Generator, List, Optional, Tuple, Union
 

praw/models/preferences.py

@@ -1,4 +1,5 @@
 """Provide the Preferences class."""
+
 from __future__ import annotations
 
 from json import dumps

praw/models/reddit/base.py

@@ -1,4 +1,5 @@
 """Provide the RedditBase class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any

praw/models/reddit/collections.py

@@ -1,4 +1,5 @@
 """Provide Collections functionality."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Generator

praw/models/reddit/comment.py

@@ -1,4 +1,5 @@
 """Provide the Comment class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any

praw/models/reddit/draft.py

@@ -1,4 +1,5 @@
 """Provide the draft class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
@@ -76,9 +77,11 @@ def _prepare_data(
             data.update(
                 {
                     "subreddit": subreddit.fullname,
-                    "target": "profile"
-                    if subreddit.display_name.startswith("u_")
-                    else "subreddit",
+                    "target": (
+                        "profile"
+                        if subreddit.display_name.startswith("u_")
+                        else "subreddit"
+                    ),
                 }
             )
         data.update(draft_kwargs)
@@ -144,10 +147,9 @@ def submit(
         nsfw: bool | None = None,
         selftext: str | None = None,
         spoiler: bool | None = None,
-        subreddit: str
-        | praw.models.Subreddit
-        | praw.models.UserSubreddit
-        | None = None,
+        subreddit: (
+            str | praw.models.Subreddit | praw.models.UserSubreddit | None
+        ) = None,
         title: str | None = None,
         url: str | None = None,
         **submit_kwargs: Any,
@@ -238,10 +240,9 @@ def update(
         selftext: str | None = None,
         send_replies: bool | None = None,
         spoiler: bool | None = None,
-        subreddit: str
-        | praw.models.Subreddit
-        | praw.models.UserSubreddit
-        | None = None,
+        subreddit: (
+            str | praw.models.Subreddit | praw.models.UserSubreddit | None
+        ) = None,
         title: str | None = None,
         url: str | None = None,
         **draft_kwargs: Any,

praw/models/reddit/emoji.py

@@ -1,4 +1,5 @@
 """Provide the Emoji class."""
+
 from __future__ import annotations
 
 from pathlib import Path

praw/models/reddit/inline_media.py

@@ -1,4 +1,5 @@
 """Provide classes related to inline media."""
+
 from __future__ import annotations
 
 from ..util import _deprecate_args

praw/models/reddit/live.py

@@ -1,4 +1,5 @@
 """Provide the LiveThread class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Iterable, Iterator

praw/models/reddit/message.py

@@ -1,4 +1,5 @@
 """Provide the Message class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any

praw/models/reddit/mixins/__init__.py

@@ -1,4 +1,5 @@
 """Package providing reddit class mixins."""
+
 from __future__ import annotations
 
 from json import dumps

praw/models/reddit/mixins/editable.py

@@ -1,4 +1,5 @@
 """Provide the EditableMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

praw/models/reddit/mixins/gildable.py

@@ -1,4 +1,5 @@
 """Provide the GildableMixin class."""
+
 from warnings import warn
 
 from ....const import API_PATH

praw/models/reddit/mixins/inboxable.py

@@ -1,4 +1,5 @@
 """Provide the InboxableMixin class."""
+
 from ....const import API_PATH
 
 

praw/models/reddit/mixins/inboxtoggleable.py

@@ -1,4 +1,5 @@
 """Provide the InboxToggleableMixin class."""
+
 from ....const import API_PATH
 
 

praw/models/reddit/mixins/messageable.py

@@ -1,4 +1,5 @@
 """Provide the MessageableMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

praw/models/reddit/mixins/modnote.py

@@ -1,4 +1,5 @@
 """Provide the ModNoteMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Generator

praw/models/reddit/mixins/replyable.py

@@ -1,4 +1,5 @@
 """Provide the ReplyableMixin class."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

praw/models/reddit/mixins/reportable.py

@@ -1,4 +1,5 @@
 """Provide the ReportableMixin class."""
+
 from ....const import API_PATH
 
 

praw/models/reddit/mixins/savable.py

@@ -1,4 +1,5 @@
 """Provide the SavableMixin class."""
+
 from __future__ import annotations
 
 from ....const import API_PATH

praw/models/reddit/mixins/votable.py

@@ -1,4 +1,5 @@
 """Provide the VotableMixin class."""
+
 from __future__ import annotations
 
 from ....const import API_PATH