[pre-commit.ci] auto fixes from pre-commit.com hooks

pre-commit-ci[bot] · pre-commit-ci[bot] · commit db4a478d8668 · 2025-08-11T20:26:48.000Z
for more information, see https://pre-commit.ci
diff --git a/steam/_const.py b/steam/_const.py
@@ -61,7 +61,7 @@ def json_dumps(
         return __decoder(__func(obj))
 
 
-JSON_LOADS: Final = cast(Callable[[str | bytes], Any], json_loads)
+JSON_LOADS: Final = cast("Callable[[str | bytes], Any]", json_loads)
 JSON_DUMPS: Final = json_dumps
 
 
@@ -109,8 +109,8 @@ def vdf_binary_loads(
     vdf_loads = orvdf.loads  # type: ignore
     vdf_binary_loads = orvdf.binary_loads  # type: ignore
 
-VDF_LOADS: Final = cast(Callable[[str], VDFDict], vdf_loads)
-VDF_BINARY_LOADS: Final = cast(Callable[[bytes], BinaryVDFDict], vdf_binary_loads)
+VDF_LOADS: Final = cast("Callable[[str], VDFDict]", vdf_loads)
+VDF_BINARY_LOADS: Final = cast("Callable[[bytes], BinaryVDFDict]", vdf_binary_loads)
 
 HTML_PARSER: Final = "lxml-xml" if importlib.util.find_spec("lxml") else "html.parser"
 
@@ -125,17 +125,17 @@ def vdf_binary_loads(
 
 
 def READ_U32(
-    s: Buffer, unpacker: Callable[[Buffer], tuple[int]] = cast(Any, struct.Struct("<I").unpack_from), /
+    s: Buffer, unpacker: Callable[[Buffer], tuple[int]] = cast("Any", struct.Struct("<I").unpack_from), /
 ) -> int:
     (u32,) = unpacker(s)
     return u32
 
 
-WRITE_U32: Final = cast(Callable[[int], bytes], struct.Struct("<I").pack)
+WRITE_U32: Final = cast("Callable[[int], bytes]", struct.Struct("<I").pack)
 
 _PROTOBUF_MASK: Final = 0x80000000
 # inlined as these are some of the most called functions in the library
-IS_PROTO: Final = cast(Callable[[int], bool], _PROTOBUF_MASK.__and__)  # this is boolean like for a bit of extra speed
+IS_PROTO: Final = cast("Callable[[int], bool]", _PROTOBUF_MASK.__and__)  # this is boolean like for a bit of extra speed
 SET_PROTO_BIT: Final = _PROTOBUF_MASK.__or__
 CLEAR_PROTO_BIT: Final = (~_PROTOBUF_MASK).__and__
 
diff --git a/steam/_gc/client.py b/steam/_gc/client.py
@@ -50,7 +50,7 @@ def __init_subclass__(cls) -> None:
         bases = [base for base in cls.__mro__ if issubclass(base, Client) and base is not Client]
         previous_state = None
         cls._GC_BASES = cast(  # type: ignore
-            tuple[type[GCState[Any]], ...],
+            "tuple[type[GCState[Any]], ...]",
             tuple(
                 dict.fromkeys(
                     previous_state := get_annotations(base, eval_str=True).get("_state", previous_state)
diff --git a/steam/_gc/state.py b/steam/_gc/state.py
@@ -98,7 +98,7 @@ def __init_subclass__(cls) -> None:
     @property
     def backpack(self) -> Inv | None:
         try:
-            return cast(Inv, self.backpacks[APP.get().id])
+            return cast("Inv", self.backpacks[APP.get().id])
         except KeyError:
             return None
 
diff --git a/steam/abc.py b/steam/abc.py
@@ -1012,9 +1012,9 @@ async def fetch_message(self, id: int, /) -> MessageT | None:
 @dataclass(slots=True)
 class Channel(Messageable[MessageT], Generic[MessageT, ClanT, GroupT]):
     _state: ConnectionState
-    clan: ClanT = cast(ClanT, None)
+    clan: ClanT = cast("ClanT", None)
     """The clan this channel belongs to."""
-    group: GroupT = cast(GroupT, None)
+    group: GroupT = cast("GroupT", None)
     """The group this channel belongs to."""
 
 
diff --git a/steam/app.py b/steam/app.py
@@ -432,12 +432,12 @@ def __init__(
         self.class_ = data["class"]
         """Extra info about the item."""
         self.prices = cast(
-            Mapping[Currency, int],
+            "Mapping[Currency, int]",
             {Currency.try_name(name): price for name, price in data["prices"].items()},
         )
         """The prices of the asset in the store."""
         self.original_prices = cast(
-            Mapping[Currency, int] | None,
+            "Mapping[Currency, int] | None",
             (
                 {
                     Currency.try_name(name): price
diff --git a/steam/chat.py b/steam/chat.py
@@ -175,8 +175,8 @@ def __init__(
         self, state: ConnectionState, chat_group: ChatGroup[Any, Any], user: User | ClientUser, member: chat.Member
     ) -> None:
         super().__init__(state, user)
-        self.clan = cast(ClanT, None)
-        self.group = cast(GroupT, None)
+        self.clan = cast("ClanT", None)
+        self.group = cast("GroupT", None)
 
         self._update(member)
 
@@ -214,7 +214,7 @@ def __init__(self, proto: chat.IncomingChatMessageNotification, channel: ChatT,
         super().__init__(channel, proto)
         self.author = author
         self.created_at = DateTime.from_timestamp(proto.timestamp)
-        self._mentions_ids = cast(tuple[ID32, ...], tuple(proto.mentions.ids))
+        self._mentions_ids = cast("tuple[ID32, ...]", tuple(proto.mentions.ids))
         self.mentions_all = proto.mentions.mention_all
         self.mentions_here = proto.mentions.mention_here
 
@@ -554,7 +554,7 @@ async def _from_proto(
         self._id = ChatGroupID(proto.chat_group_id)
         self.active_member_count = proto.active_member_count
         self._owner_id = ID32(proto.accountid_owner)
-        self._top_members = cast(list[ID32], proto.top_members)
+        self._top_members = cast("list[ID32]", proto.top_members)
         self.tagline = proto.chat_group_tagline
         self.app = PartialApp(state, id=proto.appid) if proto.appid else self.app
         self._avatar_sha = proto.chat_group_avatar_sha
@@ -632,7 +632,7 @@ def _update_header_state(self, proto: chat.GroupHeaderState, /) -> None:
 
     def _update_group_state(self, group_state: chat.GroupState):
         self._partial_members = cast(
-            dict[ID32, chat.Member], {member.accountid: member for member in group_state.members}
+            "dict[ID32, chat.Member]", {member.accountid: member for member in group_state.members}
         )
         self._roles = {
             RoleID(role.role_id): Role(self._state, self, role, permissions)
@@ -801,7 +801,7 @@ async def search(self, name: str) -> Sequence[MemberT]:
             return [self._members[ID32(user.accountid)] for user in msg.matching_members]
 
         return cast(
-            list[MemberT],
+            "list[MemberT]",
             self._maybe_members(
                 user.id for user in [self._state._store_user(user.persona) for user in msg.matching_members]
             ),
diff --git a/steam/clan.py b/steam/clan.py
@@ -273,7 +273,7 @@ async def create_event(
                 if event.name != name or event.content != content:
                     continue
                 self._state.dispatch("event_create", event)
-                return cast(Event[CreateableEvents, Self], event)
+                return cast("Event[CreateableEvents, Self]", event)
         raise ValueError
 
     async def create_announcement(
@@ -378,15 +378,15 @@ async def _load(self, *, from_proto: bool = False) -> Self:
             assert soup.title is not None
             _, _, self.name = soup.title.text.rpartition(" :: ")
             icon_url = soup.find("link", rel="image_src")
-            url = URL(cast(str, icon_url["href"])) if isinstance(icon_url, Tag) else None
+            url = URL(cast("str", icon_url["href"])) if isinstance(icon_url, Tag) else None
             if url:
                 self._avatar_sha = bytes.fromhex(url.path.removesuffix("/").removesuffix("_full.jpg"))
 
         headline = soup.find("div", class_="group_content group_summary")
         headline_h1 = headline.h1 if isinstance(headline, Tag) else None
         self.headline = headline_h1.text if headline_h1 else None
         content = soup.find("meta", property="og:description")
-        self.summary = parse_bb_code(cast(str, content["content"])) if isinstance(content, Tag) else None
+        self.summary = parse_bb_code(cast("str", content["content"])) if isinstance(content, Tag) else None
 
         if self._is_app_clan:
             for entry in soup.find_all("div", class_="actionItem"):
diff --git a/steam/client.py b/steam/client.py
@@ -475,7 +475,7 @@ async def throttle() -> None:
                 try:
                     async with timeout(60):
                         self.ws = cast(
-                            SteamWebSocket,
+                            "SteamWebSocket",
                             await login_func(
                                 self,
                                 *args,
@@ -1118,7 +1118,7 @@ async def fetch_published_files(
         language
             The language to fetch the published files in. If ``None``, the current language is used.
         """
-        return await self._state.fetch_published_files(cast(tuple[PublishedFileID, ...], ids), revision, language)
+        return await self._state.fetch_published_files(cast("tuple[PublishedFileID, ...]", ids), revision, language)
 
     async def create_post(self, content: str, /, app: App | None = None) -> Post[ClientUser]:
         """Create a post.
diff --git a/steam/enums.py b/steam/enums.py
@@ -767,10 +767,10 @@ def from_web_api_str(cls, string: str, /) -> Language:
 
 
 _REVERSE_API_LANGUAGE_MAP: Final = cast(
-    Mapping[str, Language], {value: key for key, value in Language.API_LANGUAGE_MAP.items()}
+    "Mapping[str, Language]", {value: key for key, value in Language.API_LANGUAGE_MAP.items()}
 )
 _REVERSE_WEB_API_MAP: Final = cast(
-    Mapping[str, Language], {value: key for key, value in Language.WEB_API_MAP.items()}
+    "Mapping[str, Language]", {value: key for key, value in Language.WEB_API_MAP.items()}
 )
 
 
@@ -1513,7 +1513,7 @@ class DepotFileFlag(Flags):
     """A symlink file."""
 
 
-TYPE_TRANSFORM_MAP: Final = cast(Mapping[str, str], {
+TYPE_TRANSFORM_MAP: Final = cast("Mapping[str, str]", {
     "Dlc": "DLC",
 })
 
diff --git a/steam/event.py b/steam/event.py
@@ -75,7 +75,7 @@ def __init__(self, state: ConnectionState, clan: ClanT, data: clan.Event):
         """The event's description."""
         self.app = PartialApp(state, id=data["appid"]) if data["appid"] else None
         """The app that the event is going to be played in."""
-        self.type = cast(EventTypeT, EventType.try_value(data["event_type"]))
+        self.type = cast("EventTypeT", EventType.try_value(data["event_type"]))
         """The event's type."""
         self.clan = clan
         """The event's clan."""
diff --git a/steam/ext/commands/commands.py b/steam/ext/commands/commands.py
@@ -772,7 +772,7 @@ def decorator(callback: CoroFuncT) -> G:
             attrs.setdefault("parent", self)
             result = group(name=name, cls=cls or Group, **attrs)(callback)
             self.add_command(result)
-            return cast(G, result)  # casting shouldn't really be necessary
+            return cast("G", result)  # casting shouldn't really be necessary
 
         return decorator(callback) if callback is not None else decorator
 
diff --git a/steam/ext/commands/converters.py b/steam/ext/commands/converters.py
@@ -108,7 +108,7 @@ async def source(ctx, command: commands.Command):  # this then calls command_con
 
     annotations = get_annotations(func)
     converter_for = annotations["return"]
-    func = cast(BasicConverter[T], func)
+    func = cast("BasicConverter[T]", func)
     func.converter_for = converter_for
     CONVERTERS[converter_for].append(func)
     return func
@@ -221,7 +221,7 @@ async def is_cool(ctx, user: steam.User): ...
             (
                 command.special_converters
                 if isinstance(command, Command)
-                else cast(list[Converters], command.__special_converters__)  # type: ignore
+                else cast("list[Converters]", command.__special_converters__)  # type: ignore
             ).append(cls)
         except AttributeError:
             command.__special_converters__ = [cls]  # type: ignore
@@ -531,4 +531,4 @@ def __class_getitem__(cls, converter: T | tuple[T]) -> Self:
         if (isinstance(converter, type) and issubclass(converter, str)) or converter is types.NoneType:
             raise TypeError(f"Greedy[{converter.__name__}] is invalid")  # type: ignore
 
-        return cast(Self, GreedyGenericAlias(cls, (converter,)))
+        return cast("Self", GreedyGenericAlias(cls, (converter,)))
diff --git a/steam/ext/commands/cooldown.py b/steam/ext/commands/cooldown.py
@@ -23,7 +23,7 @@
 
 class BucketTypeType:
     def __new__(cls, *values: int | None) -> Self:
-        return cast(Self, values)
+        return cast("Self", values)
 
 
 class BucketType(IntEnum):
diff --git a/steam/ext/commands/help.py b/steam/ext/commands/help.py
@@ -32,7 +32,7 @@ class HelpCommand(Command[None, ..., None]):
     """The context for the command's invocation."""
 
     def __init__(self, **kwargs: Unpack[CommandKwargs]):
-        default = cast(CommandKwargs, {"name": "help", "help": "Shows this message."} | kwargs)
+        default = cast("CommandKwargs", {"name": "help", "help": "Shows this message."} | kwargs)
         super().__init__(self.command_callback, **default)
 
     async def invoke(self, ctx: Context) -> None:
diff --git a/steam/ext/csgo/models.py b/steam/ext/csgo/models.py
@@ -87,7 +87,7 @@ def __init__(self, state: GCState, match_info: cstrike.MatchInfo, players: dict[
 
         self.rounds: list[Round] = []
         for round in match_info.roundstatsall:
-            player_ids = cast(list[ID32], round.reservation.account_ids)
+            player_ids = cast("list[ID32]", round.reservation.account_ids)
             team_size = len(player_ids) // len(round.team_scores)
             previous_scores = [0] * len(round.team_scores)
             teams: list[Team] = []
@@ -201,7 +201,7 @@ class MatchPlayer(PartialUser, user.WrapsUser):  # type: ignore
     mvp: bool
 
 
-LEVEL_MAP: Final = cast(Mapping[int, str], {
+LEVEL_MAP: Final = cast("Mapping[int, str]", {
     0: "Not Recruited",
     1: "Recruit",  # 1-3
     4: "Private",  # 4-7 etc.
diff --git a/steam/ext/csgo/protobufs/cstrike.py b/steam/ext/csgo/protobufs/cstrike.py
diff --git a/steam/ext/csgo/state.py b/steam/ext/csgo/state.py
@@ -32,7 +32,7 @@
 
 
 def READ_F32(
-    bytes: bytes, *, _unpacker: Callable[[bytes], tuple[float]] = cast(Any, struct.Struct("<f").unpack_from)
+    bytes: bytes, *, _unpacker: Callable[[bytes], tuple[float]] = cast("Any", struct.Struct("<f").unpack_from)
 ) -> float:
     (f32,) = _unpacker(bytes)
     return f32
diff --git a/steam/ext/csgo/utils.py b/steam/ext/csgo/utils.py
@@ -7,7 +7,7 @@
 from typing import Final, NamedTuple, cast
 
 CHARS = cast(
-    Mapping[str, int], dict(zip("ABCDEFGHJKLMNOPQRSTUVWXYZabcdefhijkmnopqrstuvwxyz23456789", itertools.count()))
+    "Mapping[str, int]", dict(zip("ABCDEFGHJKLMNOPQRSTUVWXYZabcdefhijkmnopqrstuvwxyz23456789", itertools.count()))
 )
 
 
diff --git a/steam/game_server.py b/steam/game_server.py
@@ -176,7 +176,7 @@ def where(cls, **kwargs: Unpack[QueryWhereKwargs]) -> str:
                 raise TypeError(f"{name!r} is an invalid keyword argument for where()") from None
             metadata: tuple[Any, ...] = annotated.__metadata__
             if name in QueryWhereBoolKwargs.__annotations__:
-                value = cast(bool, value)
+                value = cast("bool", value)
                 try:
                     filter_code = metadata[not value]
                 except IndexError:
diff --git a/steam/id.py b/steam/id.py
@@ -167,7 +167,7 @@ async def id64_from_url(url: StrOrURL, /, session: aiohttp.ClientSession | None
     return id.id64 if id is not None else None
 
 
-_ID64_TO_ID32: Final = cast(Callable[[int], ID32], 0xFFFFFFFF.__and__)
+_ID64_TO_ID32: Final = cast("Callable[[int], ID32]", 0xFFFFFFFF.__and__)
 
 
 TypeT = TypeVar("TypeT", bound=Type, default=Type, covariant=True)
@@ -281,7 +281,7 @@ def universe(self) -> Universe:
     @property
     def type(self) -> TypeT:
         """The Steam type of the ID."""
-        return cast(TypeT, Type.try_value((self.id64 >> 52) & 0xF))
+        return cast("TypeT", Type.try_value((self.id64 >> 52) & 0xF))
 
     @property
     def instance(self) -> Instance:
diff --git a/steam/leaderboard.py b/steam/leaderboard.py
@@ -86,7 +86,7 @@ class Leaderboard(Generic[AppT, DisplayNameT]):
     """The display type of the leaderboard."""
     entry_count: int
     """The number of entries in the leaderboard."""
-    display_name: DisplayNameT = cast(DisplayNameT, None)
+    display_name: DisplayNameT = cast("DisplayNameT", None)
     """The display name of the leaderboard. This is only set if the leaderboard is fetched using :meth:`PartialApp.leaderboards`."""
 
     def __repr__(self) -> str:
diff --git a/steam/protobufs/__init__.py b/steam/protobufs/__init__.py
@@ -14,7 +14,7 @@
 PROTOBUFS: Final = cast("Mapping[EMsg, type[ProtobufMessage | Message]]", {})
 RequestType: TypeAlias = "type[UnifiedMessage]"
 ResponseType: TypeAlias = "type[UnifiedMessage]"
-UMS: Final = cast(Mapping[str, tuple[RequestType, ResponseType]], {})
+UMS: Final = cast("Mapping[str, tuple[RequestType, ResponseType]]", {})
 GC_PROTOBUFS: Final = cast("Mapping[AppID, Mapping[IntEnum, type[GCProtobufMessage | GCMessage]]]", {})
 
 from .emsg import *
diff --git a/steam/reaction.py b/steam/reaction.py
@@ -56,7 +56,7 @@ class _Reaction:
 
 BASE_REACTION_URL: Final = "https://store.cloudflare.steamstatic.com/public/images/loyalty/reactions/{type}/{id}.png"
 BASE_ECONOMY_URL: Final = URL("https://community.akamai.steamstatic.com/economy")
-AWARD_ID_TO_NAME: Final = cast(Mapping[int, str], {
+AWARD_ID_TO_NAME: Final = cast("Mapping[int, str]", {
     1: "Deep Thoughts",
     2: "Heartwarming",
     3: "Hilarious",
diff --git a/steam/state.py b/steam/state.py
diff --git a/steam/utils.py b/steam/utils.py
diff --git a/tests/unit/test_commands.py b/tests/unit/test_commands.py

Original file line number	Diff line number	Diff line change
`@@ -432,12 +432,12 @@ def __init__(`
`432`	`432`	`self.class_ = data["class"]`
`433`	`433`	`"""Extra info about the item."""`
`434`	`434`	`self.prices = cast(`
`435`		`- Mapping[Currency, int],`
	`435`	`+ "Mapping[Currency, int]",`
`436`	`436`	`{Currency.try_name(name): price for name, price in data["prices"].items()},`
`437`	`437`	`)`
`438`	`438`	`"""The prices of the asset in the store."""`
`439`	`439`	`self.original_prices = cast(`
`440`		`- Mapping[Currency, int] \| None,`
	`440`	`+ "Mapping[Currency, int] \| None",`
`441`	`441`	`(`
`442`	`442`	`{`
`443`	`443`	`Currency.try_name(name): price`
Original file line number	Diff line number	Diff line change
`@@ -767,10 +767,10 @@ def from_web_api_str(cls, string: str, /) -> Language:`
`767`	`767`
`768`	`768`
`769`	`769`	`_REVERSE_API_LANGUAGE_MAP: Final = cast(`
`770`		`- Mapping[str, Language], {value: key for key, value in Language.API_LANGUAGE_MAP.items()}`
	`770`	`+ "Mapping[str, Language]", {value: key for key, value in Language.API_LANGUAGE_MAP.items()}`
`771`	`771`	`)`
`772`	`772`	`_REVERSE_WEB_API_MAP: Final = cast(`
`773`		`- Mapping[str, Language], {value: key for key, value in Language.WEB_API_MAP.items()}`
	`773`	`+ "Mapping[str, Language]", {value: key for key, value in Language.WEB_API_MAP.items()}`
`774`	`774`	`)`
`775`	`775`
`776`	`776`
`@@ -1513,7 +1513,7 @@ class DepotFileFlag(Flags):`
`1513`	`1513`	`"""A symlink file."""`
`1514`	`1514`
`1515`	`1515`
`1516`		`-TYPE_TRANSFORM_MAP: Final = cast(Mapping[str, str], {`
	`1516`	`+TYPE_TRANSFORM_MAP: Final = cast("Mapping[str, str]", {`
`1517`	`1517`	`"Dlc": "DLC",`
`1518`	`1518`	`})`
`1519`	`1519`