Add new tag attribute

Add tag attribute to SearchUser, ChannelInfo and Stream models

Update docstrings

Author: chillymosh

docs/changelog.rst

@@ -11,6 +11,7 @@ Master
         - Added ``speed`` install flag (``pip install twitchio[speed]``) to install all available speedups
         - Added :attr:`~twitchio.Game.igdb_id` to :class:`~twitchio.Game`
         - Added ``igdb_ids`` argument to :func:`~twitchio.Client.fetch_games`
+        - Added ``tags`` attribute to :class:`~twitchio.Stream`, :class:`~twitchio.ChannelInfo` and :class:`~twitchio.SearchUser`
 
     - Bug fixes
         - Fix :func:`~twitchio.PartialUser.fetch_bits_leaderboard` not handling ``started_at`` and :class:`~twitchio.BitsLeaderboard` not correctly parsing

twitchio/models.py

@@ -1021,8 +1021,15 @@ class Stream:
         Thumbnail URL of the stream.
     tag_ids: List[:class:`str`]
         Tag IDs that apply to the stream.
+
+        .. warning::
+
+            This field will be deprecated by twitch in 2023.
+
     is_mature: :class:`bool`
         Indicates whether the stream is intended for mature audience.
+    tags: List[:class:`str`]
+        The tags applied to the channel.
     """
 
     __slots__ = (
@@ -1038,6 +1045,7 @@ class Stream:
         "thumbnail_url",
         "tag_ids",
         "is_mature",
+        "tags",
     )
 
     def __init__(self, http: "TwitchHTTP", data: dict):
@@ -1053,6 +1061,7 @@ def __init__(self, http: "TwitchHTTP", data: dict):
         self.thumbnail_url: str = data["thumbnail_url"]
         self.tag_ids: List[str] = data["tag_ids"] or []
         self.is_mature: bool = data["is_mature"]
+        self.tags: List[str] = data["tags"]
 
     def __repr__(self):
         return f"<Stream id={self.id} user={self.user} title={self.title} started_at={self.started_at}>"
@@ -1077,9 +1086,11 @@ class ChannelInfo:
     delay: :class:`int`
         Stream delay in seconds.
         This defaults to 0 if the broadcaster_id does not match the user access token.
+    tags: List[:class:`str`]
+        The tags applied to the channel.
     """
 
-    __slots__ = ("user", "game_id", "game_name", "title", "language", "delay")
+    __slots__ = ("user", "game_id", "game_name", "title", "language", "delay", "tags")
 
     def __init__(self, http: "TwitchHTTP", data: dict):
         self.user = PartialUser(http, data["broadcaster_id"], data["broadcaster_name"])
@@ -1088,6 +1099,7 @@ def __init__(self, http: "TwitchHTTP", data: dict):
         self.title: str = data["title"]
         self.language: str = data["broadcaster_language"]
         self.delay: int = data["delay"]
+        self.tags: List[str] = data["tags"]
 
     def __repr__(self):
         return f"<ChannelInfo user={self.user} game_id={self.game_id} game_name={self.game_name} title={self.title} language={self.language} delay={self.delay}>"

twitchio/user.py

@@ -1550,8 +1550,52 @@ def __repr__(self):
 
 
 class SearchUser(PartialUser):
+    """
+    Represents a User that has been searched for.
+
+    Attributes
+    ----------
+    id: :class:`int`
+        The ID of the user.
+    name: :class:`str`
+        The name of the user.
+    display_name: :class:`str`
+        The broadcaster's display name.
+    game_id: :class:`str`
+        The ID of the game that the broadcaster is playing or last played.
+    title: :class:`str`
+        The stream's title. Is an empty string if the broadcaster didn't set it.
+    thumbnail_url :class:`str`
+        A URL to a thumbnail of the broadcaster's profile image.
+    language :class:`str`
+        The ISO 639-1 two-letter language code of the language used by the broadcaster. For example, en for English.
+    live: :class:`bool`
+        A Boolean value that determines whether the broadcaster is streaming live. Is true if the broadcaster is streaming live; otherwise, false.
+    started_at: :class:`datetime.datetime`
+        The UTC date and time of when the broadcaster started streaming.
+    tag_ids: List[:class:`str`]
+        Tag IDs that apply to the stream.
+
+        .. warning::
+
+            This field will be deprecated by twitch in 2023.
+
+    tags: List[:class:`str`]
+        The tags applied to the channel.
+    """
 
-    __slots__ = "game_id", "name", "display_name", "language", "title", "thumbnail_url", "live", "started_at", "tag_ids"
+    __slots__ = (
+        "game_id",
+        "name",
+        "display_name",
+        "language",
+        "title",
+        "thumbnail_url",
+        "live",
+        "started_at",
+        "tag_ids",
+        "tags",
+    )
 
     def __init__(self, http: "TwitchHTTP", data: dict):
         self._http = http
@@ -1565,6 +1609,7 @@ def __init__(self, http: "TwitchHTTP", data: dict):
         self.live: bool = data["is_live"]
         self.started_at = datetime.datetime.strptime(data["started_at"], "%Y-%m-%dT%H:%M:%SZ") if self.live else None
         self.tag_ids: List[str] = data["tag_ids"]
+        self.tags: List[str] = data["tags"]
 
 
 class User(PartialUser):