webscout 8.2.9__py3-none-any.whl → 2026.1.19__py3-none-any.whl

webscout/Extra/YTToolkit/ytapi/extras.py

@@ -1,118 +1,178 @@
-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 typing import List, Optional
+
+from .https import (
+    _get_trending_learning_videos,
+    trending_feeds,
+    trending_games,
+    trending_songs,
+    trending_sports,
+    trending_streams,
+    trending_videos,
+)
+from .patterns import _ExtraPatterns as Patterns
+from .utils import dup_filter, request
+
+
+class Extras:
+
+    @staticmethod
+    def trending_videos(limit: Optional[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: Optional[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: Optional[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: Optional[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: Optional[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: Optional[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: Optional[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)
+
+    @staticmethod
+    def shorts_videos(limit: Optional[int] = None) -> Optional[List[str]]:
+        """
+        Get trending YouTube Shorts.
+
+        Args:
+            limit (int, optional): Maximum number of Shorts to return.
+
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no Shorts found
+        """
+        try:
+            html = request("https://www.youtube.com/shorts")
+            video_ids = Patterns.video_id.findall(html)
+            return dup_filter(video_ids, limit) if video_ids else None
+        except Exception:
+            return None
+
+    @staticmethod
+    def movies(limit: Optional[int] = None) -> Optional[List[str]]:
+        """
+        Get featured movies from YouTube.
+
+        Args:
+            limit (int, optional): Maximum number of movies to return.
+
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no movies found
+        """
+        try:
+            html = request("https://www.youtube.com/feed/storefront")
+            video_ids = Patterns.video_id.findall(html)
+            return dup_filter(video_ids, limit) if video_ids else None
+        except Exception:
+            return None
+
+    @staticmethod
+    def podcasts(limit: Optional[int] = None) -> Optional[List[str]]:
+        """
+        Get trending podcasts from YouTube.
+
+        Args:
+            limit (int, optional): Maximum number of podcasts to return.
+
+        Returns:
+            Optional[List[str]]: List of video IDs or None if no podcasts found
+        """
+        try:
+            html = request("https://www.youtube.com/podcasts")
+            video_ids = Patterns.video_id.findall(html)
+            return dup_filter(video_ids, limit) if video_ids else None
+        except Exception:
+            return None
+

webscout/Extra/YTToolkit/ytapi/hashtag.py

@@ -0,0 +1,120 @@
+"""YouTube Hashtag functionality."""
+import re
+from typing import Any, Dict, List, Optional
+from urllib.parse import quote
+
+from .patterns import _ExtraPatterns as Patterns
+from .utils import dup_filter, request
+
+
+class Hashtag:
+    """Class for YouTube hashtag operations."""
+
+    BASE_URL = "https://www.youtube.com/hashtag"
+
+    @staticmethod
+    def get_videos(tag: str, limit: int = 20) -> List[str]:
+        """
+        Get videos associated with a hashtag.
+
+        Args:
+            tag: Hashtag (with or without #)
+            limit: Maximum number of videos to return
+
+        Returns:
+            List of video IDs
+        """
+        if not tag:
+            return []
+
+        # Remove # if present and clean the tag
+        tag = tag.lstrip('#').strip().lower()
+        tag = re.sub(r'[^a-zA-Z0-9]', '', tag)
+
+        if not tag:
+            return []
+
+        url = f"{Hashtag.BASE_URL}/{quote(tag)}"
+
+        try:
+            html = request(url)
+            video_ids = Patterns.video_id.findall(html)
+            return dup_filter(video_ids, limit)
+        except Exception:
+            return []
+
+    @staticmethod
+    def get_metadata(tag: str) -> Dict[str, Any]:
+        """
+        Get metadata about a hashtag.
+
+        Args:
+            tag: Hashtag (with or without #)
+
+        Returns:
+            Dictionary with hashtag info (name, video_count if available)
+        """
+        if not tag:
+            return {}
+
+        tag = tag.lstrip('#').strip().lower()
+        tag = re.sub(r'[^a-zA-Z0-9]', '', tag)
+
+        if not tag:
+            return {}
+
+        url = f"{Hashtag.BASE_URL}/{quote(tag)}"
+
+        try:
+            html = request(url)
+
+            # Try to extract video count if available
+            video_count_match = re.search(r'"videoCountText":\s*\{\s*"runs":\s*\[\s*\{\s*"text":\s*"([^"]+)"', html)
+            video_count = video_count_match.group(1) if video_count_match else None
+
+            # Get sample of videos
+            video_ids = Patterns.video_id.findall(html)
+
+            return {
+                'tag': tag,
+                'url': url,
+                'video_count': video_count,
+                'sample_videos': dup_filter(video_ids, 10)
+            }
+        except Exception:
+            return {'tag': tag, 'url': url}
+
+    @staticmethod
+    def extract_from_text(text: str) -> List[str]:
+        """
+        Extract hashtags from text.
+
+        Args:
+            text: Text containing hashtags
+
+        Returns:
+            List of hashtags found
+        """
+        if not text:
+            return []
+
+        pattern = r'#([a-zA-Z0-9_]+)'
+        matches = re.findall(pattern, text)
+        return list(dict.fromkeys(matches))  # Remove duplicates, preserve order
+
+
+if __name__ == "__main__":
+    print("Testing Hashtag.get_videos:")
+    videos = Hashtag.get_videos("python", 5)
+    for vid in videos:
+        print(f"  - {vid}")
+
+    print("\nHashtag metadata:")
+    meta = Hashtag.get_metadata("coding")
+    print(f"  Tag: {meta.get('tag')}")
+    print(f"  Videos: {len(meta.get('sample_videos', []))}")
+
+    print("\nExtract hashtags:")
+    text = "Check out my new #python #tutorial for #beginners!"
+    tags = Hashtag.extract_from_text(text)
+    print(f"  Found: {tags}")

webscout/Extra/YTToolkit/ytapi/https.py

@@ -1,88 +1,89 @@
-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)