tracktolib 0.67.0__py3-none-any.whl → 0.69.0__py3-none-any.whl

tracktolib/gh/types.py

@@ -0,0 +1,203 @@
+# generated by datamodel-codegen:
+#   timestamp: 2026-02-02T13:26:29+00:00
+
+from typing import Any, Literal, NotRequired, TypedDict
+
+
+class SimpleUser(TypedDict):
+    """
+    A GitHub user.
+    """
+
+    name: NotRequired[str]
+    email: NotRequired[str]
+    login: str
+    id: int
+    node_id: str
+    avatar_url: str
+    gravatar_id: str
+    url: str
+    html_url: str
+    followers_url: str
+    following_url: str
+    gists_url: str
+    starred_url: str
+    subscriptions_url: str
+    organizations_url: str
+    repos_url: str
+    events_url: str
+    received_events_url: str
+    type: str
+    site_admin: bool
+    starred_at: NotRequired[str]
+    user_view_type: NotRequired[str]
+
+
+class NullableSimpleUser(TypedDict):
+    """
+    A GitHub user.
+    """
+
+    name: NotRequired[str]
+    email: NotRequired[str]
+    login: str
+    id: int
+    node_id: str
+    avatar_url: str
+    gravatar_id: str
+    url: str
+    html_url: str
+    followers_url: str
+    following_url: str
+    gists_url: str
+    starred_url: str
+    subscriptions_url: str
+    organizations_url: str
+    repos_url: str
+    events_url: str
+    received_events_url: str
+    type: str
+    site_admin: bool
+    starred_at: NotRequired[str]
+    user_view_type: NotRequired[str]
+
+
+class Label(TypedDict):
+    """
+    Color-coded labels help you categorize and filter your issues (just like labels in Gmail).
+    """
+
+    id: int
+    node_id: str
+    url: str
+    name: str
+    description: str
+    color: str
+    default: bool
+
+
+class Permissions(TypedDict, total=False):
+    """
+    The set of permissions for the GitHub app.
+
+    Note: GitHub returns many dynamic permission fields; only common ones are typed.
+    """
+
+    issues: str
+    checks: str
+    metadata: str
+    contents: str
+    deployments: str
+    pull_requests: str
+    statuses: str
+    actions: str
+    administration: str
+    pages: str
+    packages: str
+    security_events: str
+
+
+ReactionRollup = TypedDict(
+    "ReactionRollup",
+    {
+        "url": str,
+        "total_count": int,
+        "+1": int,
+        "-1": int,
+        "laugh": int,
+        "confused": int,
+        "heart": int,
+        "hooray": int,
+        "eyes": int,
+        "rocket": int,
+    },
+)
+
+
+class NullableIntegration(TypedDict):
+    """
+    GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.
+    """
+
+    id: int
+    slug: NotRequired[str]
+    node_id: str
+    client_id: NotRequired[str]
+    owner: SimpleUser | Any
+    name: str
+    description: str
+    external_url: str
+    html_url: str
+    created_at: str
+    updated_at: str
+    permissions: Permissions
+    events: list[str]
+    installations_count: NotRequired[int]
+
+
+class IssueComment(TypedDict):
+    """
+    Comments provide a way for people to collaborate on an issue.
+    """
+
+    id: int
+    node_id: str
+    url: str
+    body: NotRequired[str]
+    body_text: NotRequired[str]
+    body_html: NotRequired[str]
+    html_url: str
+    user: NullableSimpleUser
+    created_at: str
+    updated_at: str
+    issue_url: str
+    author_association: NotRequired[Any]
+    performed_via_github_app: NotRequired[NullableIntegration]
+    reactions: NotRequired[ReactionRollup]
+
+
+class Deployment(TypedDict):
+    """
+    A request for a specific ref(branch,sha,tag) to be deployed
+    """
+
+    url: str
+    id: int
+    node_id: str
+    sha: str
+    ref: str
+    task: str
+    payload: dict[str, Any] | str
+    original_environment: NotRequired[str]
+    environment: str
+    description: str
+    creator: NullableSimpleUser
+    created_at: str
+    updated_at: str
+    statuses_url: str
+    repository_url: str
+    transient_environment: NotRequired[bool]
+    production_environment: NotRequired[bool]
+    performed_via_github_app: NotRequired[NullableIntegration]
+
+
+class DeploymentStatus(TypedDict):
+    """
+    The status of a deployment.
+    """
+
+    url: str
+    id: int
+    node_id: str
+    state: Literal["error", "failure", "inactive", "pending", "success", "queued", "in_progress"]
+    creator: NullableSimpleUser
+    description: str
+    environment: NotRequired[str]
+    target_url: str
+    created_at: str
+    updated_at: str
+    deployment_url: str
+    repository_url: str
+    environment_url: NotRequired[str]
+    log_url: NotRequired[str]
+    performed_via_github_app: NotRequired[NullableIntegration]

tracktolib/http_utils.py

@@ -1,6 +1,6 @@
 import typing
 import warnings
-from io import TextIOWrapper, BufferedWriter
+from io import BufferedWriter, TextIOWrapper
 from typing import BinaryIO, Callable, TextIO
 
 warnings.warn(

tracktolib/logs.py

@@ -1,6 +1,6 @@
 import logging
 from dataclasses import dataclass
-from typing import Literal, overload, Any, TypeGuard
+from typing import Any, Literal, TypeGuard, overload
 
 try:
     from pythonjsonlogger.json import JsonFormatter

tracktolib/notion/__init__.py

@@ -0,0 +1,44 @@
+from .blocks import (
+    ExportResult,
+    make_bulleted_list_block,
+    make_code_block,
+    make_divider_block,
+    make_heading_block,
+    make_numbered_list_block,
+    make_paragraph_block,
+    make_todo_block,
+    parse_rich_text,
+)
+from .cache import CachedDatabase, NotionCache
+from .utils import (
+    PageComment,
+    ProgressCallback,
+    clear_page_blocks,
+    download_page_to_markdown,
+    export_markdown_to_page,
+    fetch_all_page_comments,
+    update_page_content,
+)
+
+__all__ = [
+    "CachedDatabase",
+    "NotionCache",
+    # Block utilities
+    "parse_rich_text",
+    "make_paragraph_block",
+    "make_heading_block",
+    "make_code_block",
+    "make_bulleted_list_block",
+    "make_numbered_list_block",
+    "make_todo_block",
+    "make_divider_block",
+    # Export/Import
+    "export_markdown_to_page",
+    "download_page_to_markdown",
+    "clear_page_blocks",
+    "update_page_content",
+    "fetch_all_page_comments",
+    "ProgressCallback",
+    "ExportResult",
+    "PageComment",
+]