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

webscout/Extra/GitToolkit/__init__.py

@@ -1,10 +1,10 @@
-from .gitapi import *
-
-__all__ = [
-    'Repository',
-    'User',
-    'GitError',
-    'RateLimitError', 
-    'NotFoundError',
-    'RequestError'
-]
+from .gitapi import GitError, NotFoundError, RateLimitError, Repository, RequestError, User
+
+__all__ = [
+    'Repository',
+    'User',
+    'GitError',
+    'RateLimitError',
+    'NotFoundError',
+    'RequestError'
+]

webscout/Extra/GitToolkit/gitapi/__init__.py

@@ -1,12 +1,20 @@
-from .repository import Repository
-from .user import User
-from .utils import GitError, RateLimitError, NotFoundError, RequestError
-
-__all__ = [
-    'Repository',
-    'User',
-    'GitError',
-    'RateLimitError', 
-    'NotFoundError',
-    'RequestError'
-]
+from .gist import Gist
+from .organization import Organization
+from .repository import Repository
+from .search import GitSearch
+from .trending import Trending
+from .user import User
+from .utils import GitError, NotFoundError, RateLimitError, RequestError
+
+__all__ = [
+    'Repository',
+    'User',
+    'GitSearch',
+    'Gist',
+    'Organization',
+    'Trending',
+    'GitError',
+    'RateLimitError',
+    'NotFoundError',
+    'RequestError'
+]

webscout/Extra/GitToolkit/gitapi/gist.py

@@ -0,0 +1,142 @@
+from typing import Any, Dict, List, Optional, cast
+
+from .utils import request
+
+
+class Gist:
+    """Class for interacting with GitHub Gists without authentication"""
+
+    BASE_URL = "https://api.github.com/gists"
+
+    def get(self, gist_id: str) -> Dict[str, Any]:
+        """
+        Get a specific gist by ID.
+
+        Args:
+            gist_id: The gist ID
+
+        Returns:
+            Gist data including files, description, owner, etc.
+        """
+        url = f"{self.BASE_URL}/{gist_id}"
+        return cast(Dict[str, Any], request(url))
+
+    def list_public(
+        self,
+        since: Optional[str] = None,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        List public gists sorted by most recently updated.
+
+        Args:
+            since: Only gists updated after this time (ISO 8601 format)
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of public gists
+        """
+        url = f"{self.BASE_URL}/public?page={page}&per_page={per_page}"
+        if since:
+            url += f"&since={since}"
+        return cast(List[Dict[str, Any]], request(url))
+
+    def list_for_user(
+        self,
+        username: str,
+        since: Optional[str] = None,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        List public gists for a user.
+
+        Args:
+            username: GitHub username
+            since: Only gists updated after this time (ISO 8601 format)
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of user's public gists
+        """
+        url = f"https://api.github.com/users/{username}/gists?page={page}&per_page={per_page}"
+        if since:
+            url += f"&since={since}"
+        return cast(List[Dict[str, Any]], request(url))
+
+    def get_commits(
+        self,
+        gist_id: str,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        Get commit history for a gist.
+
+        Args:
+            gist_id: The gist ID
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of commits with version, user, change_status, committed_at
+        """
+        url = f"{self.BASE_URL}/{gist_id}/commits?page={page}&per_page={per_page}"
+        return cast(List[Dict[str, Any]], request(url))
+
+    def get_forks(
+        self,
+        gist_id: str,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        List forks of a gist.
+
+        Args:
+            gist_id: The gist ID
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of gist forks
+        """
+        url = f"{self.BASE_URL}/{gist_id}/forks?page={page}&per_page={per_page}"
+        return cast(List[Dict[str, Any]], request(url))
+
+    def get_revision(self, gist_id: str, sha: str) -> Dict[str, Any]:
+        """
+        Get a specific revision of a gist.
+
+        Args:
+            gist_id: The gist ID
+            sha: The revision SHA
+
+        Returns:
+            Gist data at that specific revision
+        """
+        url = f"{self.BASE_URL}/{gist_id}/{sha}"
+        return cast(Dict[str, Any], request(url))
+
+    def get_comments(
+        self,
+        gist_id: str,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        Get comments on a gist.
+
+        Args:
+            gist_id: The gist ID
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of comments
+        """
+        url = f"{self.BASE_URL}/{gist_id}/comments?page={page}&per_page={per_page}"
+        return cast(List[Dict[str, Any]], request(url))

webscout/Extra/GitToolkit/gitapi/organization.py

@@ -0,0 +1,91 @@
+from typing import Any, Dict, List, Optional
+
+from .utils import request
+
+
+class Organization:
+    """Class for interacting with GitHub organization data without authentication"""
+
+    def __init__(self, org: str):
+        """
+        Initialize organization client.
+
+        Args:
+            org: Organization login name
+        """
+        if not org:
+            raise ValueError("Organization name is required")
+        if not isinstance(org, str):
+            raise ValueError("Organization name must be a string")
+
+        self.org = org.strip()
+        self.base_url = f"https://api.github.com/orgs/{self.org}"
+
+    def get_info(self) -> Dict[str, Any]:
+        """
+        Get organization information.
+
+        Returns:
+            Organization details including name, description, location, etc.
+        """
+        return request(self.base_url)
+
+    def get_repos(
+        self,
+        repo_type: str = "all",
+        sort: str = "created",
+        direction: str = "desc",
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        List organization repositories.
+
+        Args:
+            repo_type: Type of repos (all, public, private, forks, sources, member)
+            sort: Sort by (created, updated, pushed, full_name)
+            direction: Sort direction (asc, desc)
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of organization repositories
+        """
+        url = f"{self.base_url}/repos?type={repo_type}&sort={sort}&direction={direction}&page={page}&per_page={per_page}"
+        return request(url)
+
+    def get_public_members(
+        self,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        List public members of the organization.
+
+        Args:
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of public organization members
+        """
+        url = f"{self.base_url}/public_members?page={page}&per_page={per_page}"
+        return request(url)
+
+    def get_events(
+        self,
+        page: int = 1,
+        per_page: int = 30
+    ) -> List[Dict[str, Any]]:
+        """
+        List public organization events.
+
+        Args:
+            page: Page number
+            per_page: Results per page (max 100)
+
+        Returns:
+            List of public events
+        """
+        url = f"{self.base_url}/events?page={page}&per_page={per_page}"
+        return request(url)