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

webscout/Extra/YTToolkit/ytapi/pool.py

@@ -1,8 +1,8 @@
-import concurrent.futures
-from typing import Callable, List, Any
-
-
-def collect(func: Callable, args: List[Any]) -> List[Any]:
-    max_workers = len(args) or 1
-    with concurrent.futures.ThreadPoolExecutor(max_workers) as exe:
+import concurrent.futures
+from typing import Callable, List, Any
+
+
+def collect(func: Callable, args: List[Any]) -> List[Any]:
+    max_workers = len(args) or 1
+    with concurrent.futures.ThreadPoolExecutor(max_workers) as exe:
         return list(exe.map(func, args))

webscout/Extra/YTToolkit/ytapi/query.py

@@ -1,40 +1,40 @@
-from .utils import dup_filter
-from .video import Video
-from .channel import Channel
-from .playlist import Playlist
-from .patterns import _QueryPatterns as Patterns
-from typing import Optional, Dict, Any, List
-from .https import find_videos, find_channels, find_playlists
-
-
-class Search:
-
-    @staticmethod
-    def video(keywords: str) -> Optional[Video]:
-        video_ids = Patterns.video_id.findall(find_videos(keywords))
-        return Video(video_ids[0]) if video_ids else None
-
-    @staticmethod
-    def channel(keywords: str) -> Optional[Channel]:
-        channel_ids = Patterns.channel_id.findall(find_channels(keywords))
-        return Channel(channel_ids[0]) if channel_ids else None
-
-    @staticmethod
-    def playlist(keywords: str) -> Optional[Playlist]:
-        playlist_ids = Patterns.playlist_id.findall(find_playlists(keywords))
-        return Playlist(playlist_ids[0]) if playlist_ids else None
-
-    @staticmethod
-    def videos(keywords: str, limit: int = 20) -> Optional[List[str]]:
-        return dup_filter(Patterns.video_id.findall(find_videos(keywords)), limit)
-
-    @staticmethod
-    def channels(keywords: str, limit: int = 20) -> Optional[List[str]]:
-        return dup_filter(Patterns.channel_id.findall(find_channels(keywords)), limit)
-
-    @staticmethod
-    def playlists(keywords: str, limit: int = 20) -> Optional[List[str]]:
-        return dup_filter(Patterns.playlist_id.findall(find_playlists(keywords)), limit)
-
-if __name__ == "__main__":
+from .utils import dup_filter
+from .video import Video
+from .channel import Channel
+from .playlist import Playlist
+from .patterns import _QueryPatterns as Patterns
+from typing import Optional, Dict, Any, List
+from .https import find_videos, find_channels, find_playlists
+
+
+class Search:
+
+    @staticmethod
+    def video(keywords: str) -> Optional[Video]:
+        video_ids = Patterns.video_id.findall(find_videos(keywords))
+        return Video(video_ids[0]) if video_ids else None
+
+    @staticmethod
+    def channel(keywords: str) -> Optional[Channel]:
+        channel_ids = Patterns.channel_id.findall(find_channels(keywords))
+        return Channel(channel_ids[0]) if channel_ids else None
+
+    @staticmethod
+    def playlist(keywords: str) -> Optional[Playlist]:
+        playlist_ids = Patterns.playlist_id.findall(find_playlists(keywords))
+        return Playlist(playlist_ids[0]) if playlist_ids else None
+
+    @staticmethod
+    def videos(keywords: str, limit: int = 20) -> Optional[List[str]]:
+        return dup_filter(Patterns.video_id.findall(find_videos(keywords)), limit)
+
+    @staticmethod
+    def channels(keywords: str, limit: int = 20) -> Optional[List[str]]:
+        return dup_filter(Patterns.channel_id.findall(find_channels(keywords)), limit)
+
+    @staticmethod
+    def playlists(keywords: str, limit: int = 20) -> Optional[List[str]]:
+        return dup_filter(Patterns.playlist_id.findall(find_playlists(keywords)), limit)
+
+if __name__ == "__main__":
     print(Search.videos("java"))

webscout/Extra/YTToolkit/ytapi/stream.py

@@ -1,63 +1,63 @@
-import re
-from typing import Dict, Any
-
-from .pool import collect
-from .https import video_data
-from .patterns import _VideoPatterns as Patterns
-
-
-class Video:
-
-    _HEAD = 'https://www.youtube.com/watch?v='
-
-    def __init__(self, video_id: str):
-        pattern = re.compile(r'.be/(.*?)$|=(.*?)$|^(\w{11})$')  # noqa
-        self._matched_id = (
-                pattern.search(video_id).group(1)
-                or pattern.search(video_id).group(2)
-                or pattern.search(video_id).group(3)
-        )
-        if self._matched_id:
-            self._url = self._HEAD + self._matched_id
-            self._video_data = video_data(self._matched_id)
-        else:
-            raise ValueError('invalid video id or url')
-
-    def __repr__(self):
-        return f'<Video {self._url}>'
-
-    @property
-    def metadata(self) -> Dict[str, Any]:
-        patterns = [
-            Patterns.title,
-            Patterns.views,
-            Patterns.likes,
-            Patterns.duration,
-            Patterns.author_id,
-            Patterns.upload_date,
-            Patterns.thumbnail,
-            Patterns.tags,
-            Patterns.description,
-            Patterns.is_streamed,
-            Patterns.is_premiered
-        ]
-        ext = collect(lambda x: x.findall(self._video_data) or None, patterns)
-        data = [i[0] if i else i for i in ext]
-        return {
-            'title': data[0],
-            'id': self._matched_id,
-            'views': data[1][:-6] if data[1] else None,
-            'likes': data[2],
-            'streamed': data[9] is not None,
-            'premiered': data[10],
-            'duration': int(data[3]) / 1000 if data[3] else None,
-            'author': data[4],
-            'upload_date': data[5],
-            'url': self._url,
-            'thumbnail': data[6],
-            'tags': data[7].split(',') if data[7] else None,
-            'description': data[8].replace('\\n', '\n') if data[8] else None
-        }
-
-if __name__ == '__main__':
+import re
+from typing import Dict, Any
+
+from .pool import collect
+from .https import video_data
+from .patterns import _VideoPatterns as Patterns
+
+
+class Video:
+
+    _HEAD = 'https://www.youtube.com/watch?v='
+
+    def __init__(self, video_id: str):
+        pattern = re.compile(r'.be/(.*?)$|=(.*?)$|^(\w{11})$')  # noqa
+        self._matched_id = (
+                pattern.search(video_id).group(1)
+                or pattern.search(video_id).group(2)
+                or pattern.search(video_id).group(3)
+        )
+        if self._matched_id:
+            self._url = self._HEAD + self._matched_id
+            self._video_data = video_data(self._matched_id)
+        else:
+            raise ValueError('invalid video id or url')
+
+    def __repr__(self):
+        return f'<Video {self._url}>'
+
+    @property
+    def metadata(self) -> Dict[str, Any]:
+        patterns = [
+            Patterns.title,
+            Patterns.views,
+            Patterns.likes,
+            Patterns.duration,
+            Patterns.author_id,
+            Patterns.upload_date,
+            Patterns.thumbnail,
+            Patterns.tags,
+            Patterns.description,
+            Patterns.is_streamed,
+            Patterns.is_premiered
+        ]
+        ext = collect(lambda x: x.findall(self._video_data) or None, patterns)
+        data = [i[0] if i else i for i in ext]
+        return {
+            'title': data[0],
+            'id': self._matched_id,
+            'views': data[1][:-6] if data[1] else None,
+            'likes': data[2],
+            'streamed': data[9] is not None,
+            'premiered': data[10],
+            'duration': int(data[3]) / 1000 if data[3] else None,
+            'author': data[4],
+            'upload_date': data[5],
+            'url': self._url,
+            'thumbnail': data[6],
+            'tags': data[7].split(',') if data[7] else None,
+            'description': data[8].replace('\\n', '\n') if data[8] else None
+        }
+
+if __name__ == '__main__':
     print(Video('https://www.youtube.com/watch?v=9bZkp7q19f0').metadata)

webscout/Extra/YTToolkit/ytapi/utils.py

@@ -1,62 +1,62 @@
-from urllib.request import Request, urlopen
-from collections import OrderedDict
-from urllib.error import HTTPError
-from .errors import TooManyRequests, InvalidURL, RequestError
-from webscout.litagent import LitAgent
-
-
-__all__ = ['dup_filter', 'request']
-
-
-_USER_AGENT_GENERATOR = LitAgent()
-
-
-def request(url: str, retry_attempts: int = 3) -> str:
-    """
-    Send a request with a random user agent and built-in retry mechanism.
-    
-    Args:
-        url (str): The URL to request
-        retry_attempts (int, optional): Number of retry attempts. Defaults to 3.
-    
-    Raises:
-        InvalidURL: If the URL cannot be found
-        TooManyRequests: If rate-limited
-        RequestError: For other request-related errors
-    
-    Returns:
-        str: Decoded response content
-    """
-    for attempt in range(retry_attempts):
-        try:
-            headers = {
-                "User-Agent": _USER_AGENT_GENERATOR.random()
-            }
-            
-            req = Request(url, headers=headers)
-            response = urlopen(req)
-            return response.read().decode('utf-8')
-        
-        except HTTPError as e:
-            if e.code == 404:
-                raise InvalidURL(f'Cannot find anything with the requested URL: {url}')
-            if e.code == 429:
-                raise TooManyRequests(f'Rate-limited on attempt {attempt + 1}')
-            
-            if attempt == retry_attempts - 1:
-                raise RequestError(f'HTTP Error {e.code}: {e.reason}') from e
-        
-        except Exception as e:
-            if attempt == retry_attempts - 1:
-                raise RequestError(f'Request failed: {e!r}') from None
-
-
-def dup_filter(iterable: list, limit: int = None) -> list:
-    if not iterable:
-        return []
-    lim = limit if limit else len(iterable)
-    converted = list(OrderedDict.fromkeys(iterable))
-    if len(converted) - lim > 0:
-        return converted[:-len(converted) + lim]
-    else:
-        return converted
+from urllib.request import Request, urlopen
+from collections import OrderedDict
+from urllib.error import HTTPError
+from .errors import TooManyRequests, InvalidURL, RequestError
+from webscout.litagent import LitAgent
+
+
+__all__ = ['dup_filter', 'request']
+
+
+_USER_AGENT_GENERATOR = LitAgent()
+
+
+def request(url: str, retry_attempts: int = 3) -> str:
+    """
+    Send a request with a random user agent and built-in retry mechanism.
+    
+    Args:
+        url (str): The URL to request
+        retry_attempts (int, optional): Number of retry attempts. Defaults to 3.
+    
+    Raises:
+        InvalidURL: If the URL cannot be found
+        TooManyRequests: If rate-limited
+        RequestError: For other request-related errors
+    
+    Returns:
+        str: Decoded response content
+    """
+    for attempt in range(retry_attempts):
+        try:
+            headers = {
+                "User-Agent": _USER_AGENT_GENERATOR.random()
+            }
+            
+            req = Request(url, headers=headers)
+            response = urlopen(req)
+            return response.read().decode('utf-8')
+        
+        except HTTPError as e:
+            if e.code == 404:
+                raise InvalidURL(f'Cannot find anything with the requested URL: {url}')
+            if e.code == 429:
+                raise TooManyRequests(f'Rate-limited on attempt {attempt + 1}')
+            
+            if attempt == retry_attempts - 1:
+                raise RequestError(f'HTTP Error {e.code}: {e.reason}') from e
+        
+        except Exception as e:
+            if attempt == retry_attempts - 1:
+                raise RequestError(f'Request failed: {e!r}') from None
+
+
+def dup_filter(iterable: list, limit: int = None) -> list:
+    if not iterable:
+        return []
+    lim = limit if limit else len(iterable)
+    converted = list(OrderedDict.fromkeys(iterable))
+    if len(converted) - lim > 0:
+        return converted[:-len(converted) + lim]
+    else:
+        return converted