webscout 8.3.7__py3-none-any.whl → 2025.10.11__py3-none-any.whl

webscout/Extra/YTToolkit/ytapi/extras.py

@@ -1,118 +1,118 @@
-from .https import (
-    trending_videos,
-    trending_songs,
-    trending_games,
-    trending_feeds,
-    trending_streams,
-    _get_trending_learning_videos,
-    trending_sports
-)
-from .utils import dup_filter
-from .patterns import _ExtraPatterns as Patterns
-from typing import Optional, List
-
-
-class Extras:
-
-    @staticmethod
-    def trending_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return. 
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.trending_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        data = Patterns.video_id.findall(trending_videos())
-        return dup_filter(data, limit) if data else None
-
-    @staticmethod
-    def music_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending music videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return.
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.music_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        data = Patterns.video_id.findall(trending_songs())
-        return dup_filter(data, limit) if data else None    @staticmethod
-    def gaming_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending gaming videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return.
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.gaming_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        return dup_filter(Patterns.video_id.findall(trending_games()), limit)
-        
-    @staticmethod
-    def news_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending news videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return.
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.news_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        return dup_filter(Patterns.video_id.findall(trending_feeds()), limit)    @staticmethod
-    def live_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending live videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return.
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.live_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        return dup_filter(Patterns.video_id.findall(trending_streams()), limit)
-
-    @staticmethod
-    def educational_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending educational videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return.
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.educational_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        return dup_filter(Patterns.video_id.findall(_get_trending_learning_videos()), limit)
-
-    @staticmethod
-    def sport_videos(limit: int = None) -> Optional[List[str]]:
-        """
-        Get trending sports videos from YouTube.
-        
-        Args:
-            limit (int, optional): Maximum number of videos to return.
-                                  Alternatively, manual slicing can be used: 
-                                  Extras.sport_videos()[:5]
-        
-        Returns:
-            Optional[List[str]]: List of video IDs or None if no videos found
-        """
-        return dup_filter(Patterns.video_id.findall(trending_sports()), limit)
+from .https import (
+    trending_videos,
+    trending_songs,
+    trending_games,
+    trending_feeds,
+    trending_streams,
+    _get_trending_learning_videos,
+    trending_sports
+)
+from .utils import dup_filter
+from .patterns import _ExtraPatterns as Patterns
+from typing import Optional, List
+
+
+class Extras:
+
+    @staticmethod
+    def trending_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return. 
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.trending_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        data = Patterns.video_id.findall(trending_videos())
+        return dup_filter(data, limit) if data else None
+
+    @staticmethod
+    def music_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending music videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return.
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.music_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        data = Patterns.video_id.findall(trending_songs())
+        return dup_filter(data, limit) if data else None    @staticmethod
+    def gaming_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending gaming videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return.
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.gaming_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        return dup_filter(Patterns.video_id.findall(trending_games()), limit)
+        
+    @staticmethod
+    def news_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending news videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return.
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.news_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        return dup_filter(Patterns.video_id.findall(trending_feeds()), limit)    @staticmethod
+    def live_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending live videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return.
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.live_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        return dup_filter(Patterns.video_id.findall(trending_streams()), limit)
+
+    @staticmethod
+    def educational_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending educational videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return.
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.educational_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        return dup_filter(Patterns.video_id.findall(_get_trending_learning_videos()), limit)
+
+    @staticmethod
+    def sport_videos(limit: int = None) -> Optional[List[str]]:
+        """
+        Get trending sports videos from YouTube.
+        
+        Args:
+            limit (int, optional): Maximum number of videos to return.
+                                  Alternatively, manual slicing can be used: 
+                                  Extras.sport_videos()[:5]
+        
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no videos found
+        """
+        return dup_filter(Patterns.video_id.findall(trending_sports()), limit)

webscout/Extra/YTToolkit/ytapi/https.py

@@ -1,88 +1,88 @@
-from urllib.parse import quote
-from .utils import request
-
-
-def channel_about(head: str) -> str:
-    return request(head + '/about')
-
-
-def video_count(channel_id: str) -> str:
-    head = 'https://www.youtube.com/results?search_query='
-    tail = '&sp=EgIQAg%253D%253D'
-    return request(head + channel_id + tail)
-
-
-def uploads_data(head: str) -> str:
-    url = head + '/videos'
-    return request(url)
-
-
-def streams_data(head: str) -> str:
-    url = head + '/streams'
-    return request(url)
-
-
-def channel_playlists(head: str) -> str:
-    url = head + '/playlists'
-    return request(url)
-
-
-def upcoming_videos(head: str) -> str:
-    url = head + '/videos?view=2&live_view=502'
-    return request(url)
-
-
-def video_data(video_id: str) -> str:
-    url = f'https://www.youtube.com/watch?v={video_id}'
-    return request(url)
-
-
-def playlist_data(playlist_id: str) -> str:
-    url = 'https://www.youtube.com/playlist?list=' + playlist_id
-    return request(url)
-
-
-def trending_videos() -> str:
-    return request('https://www.youtube.com/feed/trending')
-
-
-def trending_songs() -> str:
-    return request('https://www.youtube.com/feed/music')
-
-
-def trending_games() -> str:
-    return request('https://www.youtube.com/gaming')
-
-
-def trending_feeds() -> str:
-    return request('https://www.youtube.com/news')
-
-
-def trending_streams() -> str:
-    return request('https://www.youtube.com/live')
-
-
-def _get_trending_learning_videos() -> str:
-    return request('https://www.youtube.com/learning')
-
-
-def trending_sports() -> str:
-    return request('https://www.youtube.com/sports')
-
-
-def find_videos(query: str) -> str:
-    head = 'https://www.youtube.com/results?search_query='
-    tail = '&sp=EgIQAQ%253D%253D'
-    return request(head + quote(query) + tail)
-
-
-def find_channels(query: str) -> str:
-    head = 'https://www.youtube.com/results?search_query='
-    tail = '&sp=EgIQAg%253D%253D'
-    return request(head + quote(query) + tail)
-
-
-def find_playlists(query: str) -> str:
-    head = 'https://www.youtube.com/results?search_query='
-    tail = '&sp=EgIQAw%253D%253D'
-    return request(head + quote(query) + tail)
+from urllib.parse import quote
+from .utils import request
+
+
+def channel_about(head: str) -> str:
+    return request(head + '/about')
+
+
+def video_count(channel_id: str) -> str:
+    head = 'https://www.youtube.com/results?search_query='
+    tail = '&sp=EgIQAg%253D%253D'
+    return request(head + channel_id + tail)
+
+
+def uploads_data(head: str) -> str:
+    url = head + '/videos'
+    return request(url)
+
+
+def streams_data(head: str) -> str:
+    url = head + '/streams'
+    return request(url)
+
+
+def channel_playlists(head: str) -> str:
+    url = head + '/playlists'
+    return request(url)
+
+
+def upcoming_videos(head: str) -> str:
+    url = head + '/videos?view=2&live_view=502'
+    return request(url)
+
+
+def video_data(video_id: str) -> str:
+    url = f'https://www.youtube.com/watch?v={video_id}'
+    return request(url)
+
+
+def playlist_data(playlist_id: str) -> str:
+    url = 'https://www.youtube.com/playlist?list=' + playlist_id
+    return request(url)
+
+
+def trending_videos() -> str:
+    return request('https://www.youtube.com/feed/trending')
+
+
+def trending_songs() -> str:
+    return request('https://www.youtube.com/feed/music')
+
+
+def trending_games() -> str:
+    return request('https://www.youtube.com/gaming')
+
+
+def trending_feeds() -> str:
+    return request('https://www.youtube.com/news')
+
+
+def trending_streams() -> str:
+    return request('https://www.youtube.com/live')
+
+
+def _get_trending_learning_videos() -> str:
+    return request('https://www.youtube.com/learning')
+
+
+def trending_sports() -> str:
+    return request('https://www.youtube.com/sports')
+
+
+def find_videos(query: str) -> str:
+    head = 'https://www.youtube.com/results?search_query='
+    tail = '&sp=EgIQAQ%253D%253D'
+    return request(head + quote(query) + tail)
+
+
+def find_channels(query: str) -> str:
+    head = 'https://www.youtube.com/results?search_query='
+    tail = '&sp=EgIQAg%253D%253D'
+    return request(head + quote(query) + tail)
+
+
+def find_playlists(query: str) -> str:
+    head = 'https://www.youtube.com/results?search_query='
+    tail = '&sp=EgIQAw%253D%253D'
+    return request(head + quote(query) + tail)

webscout/Extra/YTToolkit/ytapi/patterns.py

@@ -1,61 +1,61 @@
-import re
-
-
-class _ChannelPatterns:
-    name = re.compile(r'channelMetadataRenderer\":{\"title\":\"(.*?)\"')
-    id = re.compile(r'channelId\":\"(.*?)\"')
-    verified = re.compile(r'"label":"Verified"')
-    check_live = re.compile(r'{"text":"LIVE"}')
-    live = re.compile(r"thumbnailOverlays\":\[(.*?)]")
-    video_id = re.compile(r'videoId\":\"(.*?)\"')
-    uploads = re.compile(r"gridVideoRenderer\":{\"videoId\":\"(.*?)\"")
-    subscribers = re.compile(r"\"subscriberCountText\":{\"accessibility\":(.*?),")
-    views = re.compile(r"viewCountText\":{\"simpleText\":\"(.*?)\"}")
-    creation = re.compile(r"{\"text\":\"Joined \"},{\"text\":\"(.*?)\"}")
-    country = re.compile(r"country\":{\"simpleText\":\"(.*?)\"}")
-    custom_url = re.compile(r"canonicalChannelUrl\":\"(.*?)\"")
-    description = re.compile(r"{\"description\":{\"simpleText\":\"(.*?)\"}")
-    avatar = re.compile(r"height\":88},{\"url\":\"(.*?)\"")
-    banner = re.compile(r"width\":1280,\"height\":351},{\"url\":\"(.*?)\"")
-    playlists = re.compile(r"{\"url\":\"/playlist\?list=(.*?)\"")
-    video_count = re.compile(r"videoCountText\":{\"runs\":\[{\"text\":(.*?)}")
-    socials = re.compile(r"q=https%3A%2F%2F(.*?)\"")
-    upload_ids = re.compile(r"videoId\":\"(.*?)\"")
-    stream_ids = re.compile(r"videoId\":\"(.*?)\"")
-    upload_chunk = re.compile(r"gridVideoRenderer\":{(.*?)\"navigationEndpoint")
-    upload_chunk_fl_1 = re.compile(r"simpleText\":\"Streamed")
-    upload_chunk_fl_2 = re.compile(r"default_live.")
-    upcoming_check = re.compile(r"\"title\":\"Upcoming live streams\"")
-    upcoming = re.compile(r"gridVideoRenderer\":{\"videoId\":\"(.*?)\"")
-
-
-class _VideoPatterns:
-    video_id = re.compile(r'videoId\":\"(.*?)\"')
-    title = re.compile(r"title\":\"(.*?)\"")
-    duration = re.compile(r"approxDurationMs\":\"(.*?)\"")
-    upload_date = re.compile(r"uploadDate\":\"(.*?)\"")
-    author_id = re.compile(r"channelIds\":\[\"(.*?)\"")
-    description = re.compile(r"shortDescription\":\"(.*)\",\"isCrawlable")
-    tags = re.compile(r"<meta name=\"keywords\" content=\"(.*?)\">")
-    is_streamed = re.compile(r"simpleText\":\"Streamed live")
-    is_premiered = re.compile(r"dateText\":{\"simpleText\":\"Premiered")
-    views = re.compile(r"videoViewCountRenderer\":{\"viewCount\":{\"simpleText\":\"(.*?)\"")
-    likes = re.compile(r"toggledText\":{\"accessibility\":{\"accessibilityData\":{\"label\":\"(.*?) ")
-    thumbnail = re.compile(r"playerMicroformatRenderer\":{\"thumbnail\":{\"thumbnails\":\[{\"url\":\"(.*?)\"")
-
-
-class _PlaylistPatterns:
-    name = re.compile(r"{\"title\":\"(.*?)\"")
-    video_count = re.compile(r"stats\":\[{\"runs\":\[{\"text\":\"(.*?)\"")
-    video_id = re.compile(r"videoId\":\"(.*?)\"")
-    thumbnail = re.compile(r"og:image\" content=\"(.*?)\?")
-
-
-class _ExtraPatterns:
-    video_id = re.compile(r"videoId\":\"(.*?)\"")
-
-
-class _QueryPatterns:
-    channel_id = re.compile(r"channelId\":\"(.*?)\"")
-    video_id = re.compile(r"videoId\":\"(.*?)\"")
-    playlist_id = re.compile(r"playlistId\":\"(.*?)\"")
+import re
+
+
+class _ChannelPatterns:
+    name = re.compile(r'channelMetadataRenderer\":{\"title\":\"(.*?)\"')
+    id = re.compile(r'channelId\":\"(.*?)\"')
+    verified = re.compile(r'"label":"Verified"')
+    check_live = re.compile(r'{"text":"LIVE"}')
+    live = re.compile(r"thumbnailOverlays\":\[(.*?)]")
+    video_id = re.compile(r'videoId\":\"(.*?)\"')
+    uploads = re.compile(r"gridVideoRenderer\":{\"videoId\":\"(.*?)\"")
+    subscribers = re.compile(r"\"subscriberCountText\":{\"accessibility\":(.*?),")
+    views = re.compile(r"viewCountText\":{\"simpleText\":\"(.*?)\"}")
+    creation = re.compile(r"{\"text\":\"Joined \"},{\"text\":\"(.*?)\"}")
+    country = re.compile(r"country\":{\"simpleText\":\"(.*?)\"}")
+    custom_url = re.compile(r"canonicalChannelUrl\":\"(.*?)\"")
+    description = re.compile(r"{\"description\":{\"simpleText\":\"(.*?)\"}")
+    avatar = re.compile(r"height\":88},{\"url\":\"(.*?)\"")
+    banner = re.compile(r"width\":1280,\"height\":351},{\"url\":\"(.*?)\"")
+    playlists = re.compile(r"{\"url\":\"/playlist\?list=(.*?)\"")
+    video_count = re.compile(r"videoCountText\":{\"runs\":\[{\"text\":(.*?)}")
+    socials = re.compile(r"q=https%3A%2F%2F(.*?)\"")
+    upload_ids = re.compile(r"videoId\":\"(.*?)\"")
+    stream_ids = re.compile(r"videoId\":\"(.*?)\"")
+    upload_chunk = re.compile(r"gridVideoRenderer\":{(.*?)\"navigationEndpoint")
+    upload_chunk_fl_1 = re.compile(r"simpleText\":\"Streamed")
+    upload_chunk_fl_2 = re.compile(r"default_live.")
+    upcoming_check = re.compile(r"\"title\":\"Upcoming live streams\"")
+    upcoming = re.compile(r"gridVideoRenderer\":{\"videoId\":\"(.*?)\"")
+
+
+class _VideoPatterns:
+    video_id = re.compile(r'videoId\":\"(.*?)\"')
+    title = re.compile(r"title\":\"(.*?)\"")
+    duration = re.compile(r"approxDurationMs\":\"(.*?)\"")
+    upload_date = re.compile(r"uploadDate\":\"(.*?)\"")
+    author_id = re.compile(r"channelIds\":\[\"(.*?)\"")
+    description = re.compile(r"shortDescription\":\"(.*)\",\"isCrawlable")
+    tags = re.compile(r"<meta name=\"keywords\" content=\"(.*?)\">")
+    is_streamed = re.compile(r"simpleText\":\"Streamed live")
+    is_premiered = re.compile(r"dateText\":{\"simpleText\":\"Premiered")
+    views = re.compile(r"videoViewCountRenderer\":{\"viewCount\":{\"simpleText\":\"(.*?)\"")
+    likes = re.compile(r"toggledText\":{\"accessibility\":{\"accessibilityData\":{\"label\":\"(.*?) ")
+    thumbnail = re.compile(r"playerMicroformatRenderer\":{\"thumbnail\":{\"thumbnails\":\[{\"url\":\"(.*?)\"")
+
+
+class _PlaylistPatterns:
+    name = re.compile(r"{\"title\":\"(.*?)\"")
+    video_count = re.compile(r"stats\":\[{\"runs\":\[{\"text\":\"(.*?)\"")
+    video_id = re.compile(r"videoId\":\"(.*?)\"")
+    thumbnail = re.compile(r"og:image\" content=\"(.*?)\?")
+
+
+class _ExtraPatterns:
+    video_id = re.compile(r"videoId\":\"(.*?)\"")
+
+
+class _QueryPatterns:
+    channel_id = re.compile(r"channelId\":\"(.*?)\"")
+    video_id = re.compile(r"videoId\":\"(.*?)\"")
+    playlist_id = re.compile(r"playlistId\":\"(.*?)\"")

webscout/Extra/YTToolkit/ytapi/playlist.py

@@ -1,59 +1,59 @@
-import re
-from typing import Dict, Any
-
-from .pool import collect
-from .utils import dup_filter
-from .https import playlist_data
-from .patterns import _PlaylistPatterns as Patterns
-
-
-class Playlist:
-
-    def __init__(self, playlist_id: str):
-        """
-        Represents a YouTube Playlist
-
-        Parameters
-        ----------
-        playlist_id : str
-            The id or url of the playlist
-        """
-        pattern = re.compile('=(.+?)$|^PL(.+?)$')
-        match = pattern.search(playlist_id)
-        if not match:
-            raise ValueError(f'Invalid playlist id: {playlist_id}')
-        if match.group(1):
-            self.id = match.group(1)
-        elif match.group(2):
-            self.id = 'PL' + match.group(2)
-        self._playlist_data = playlist_data(self.id)
-
-    def __repr__(self):
-        return f'<Playlist {self.id}>'
-
-    @property
-    def metadata(self) -> Dict[str, Any]:
-        """
-        Fetches playlist metadata in a dict format
-
-        Returns
-        -------
-        Dict
-            Playlist metadata in a dict format containing keys: id, url, name, video_count, thumbnail,
-        """
-        patterns = [
-            Patterns.name,
-            Patterns.video_count,
-            Patterns.thumbnail,
-            Patterns.video_id,
-        ]
-        ext = collect(lambda x: x.findall(self._playlist_data) or None, patterns)
-        data = [e[0] if e else None for e in ext]
-        return {
-            'id': self.id,
-            'url': 'https://www.youtube.com/playlist?list=' + self.id,
-            'name': data[0] if data else None,
-            'video_count': data[1] if data else None,
-            'thumbnail': data[2] if data else None,
-            'videos': dup_filter(ext[3])
+import re
+from typing import Dict, Any
+
+from .pool import collect
+from .utils import dup_filter
+from .https import playlist_data
+from .patterns import _PlaylistPatterns as Patterns
+
+
+class Playlist:
+
+    def __init__(self, playlist_id: str):
+        """
+        Represents a YouTube Playlist
+
+        Parameters
+        ----------
+        playlist_id : str
+            The id or url of the playlist
+        """
+        pattern = re.compile('=(.+?)$|^PL(.+?)$')
+        match = pattern.search(playlist_id)
+        if not match:
+            raise ValueError(f'Invalid playlist id: {playlist_id}')
+        if match.group(1):
+            self.id = match.group(1)
+        elif match.group(2):
+            self.id = 'PL' + match.group(2)
+        self._playlist_data = playlist_data(self.id)
+
+    def __repr__(self):
+        return f'<Playlist {self.id}>'
+
+    @property
+    def metadata(self) -> Dict[str, Any]:
+        """
+        Fetches playlist metadata in a dict format
+
+        Returns
+        -------
+        Dict
+            Playlist metadata in a dict format containing keys: id, url, name, video_count, thumbnail,
+        """
+        patterns = [
+            Patterns.name,
+            Patterns.video_count,
+            Patterns.thumbnail,
+            Patterns.video_id,
+        ]
+        ext = collect(lambda x: x.findall(self._playlist_data) or None, patterns)
+        data = [e[0] if e else None for e in ext]
+        return {
+            'id': self.id,
+            'url': 'https://www.youtube.com/playlist?list=' + self.id,
+            'name': data[0] if data else None,
+            'video_count': data[1] if data else None,
+            'thumbnail': data[2] if data else None,
+            'videos': dup_filter(ext[3])
         }