runapi-core 0.1.0__py3-none-any.whl

runapi/core/__init__.py

@@ -0,0 +1,71 @@
+"""RunAPI Python SDK — shared core.
+
+Configuration, errors, models, HTTP transport, polling, and the file upload
+client shared by every per-model-line package.
+"""
+
+from . import config, errors, polling
+from .auth import resolve_api_key
+from .config import configure
+from .contract_gen import CONTRACT
+from .errors import (
+    AuthenticationError,
+    ConflictError,
+    Error,
+    InsufficientCreditsError,
+    NetworkError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    ServiceUnavailableError,
+    TaskFailedError,
+    TaskTimeoutError,
+    TimeoutError,
+    ValidationError,
+    error_from_response,
+)
+from .files import FilesClient, UploadResponse
+from .http_client import HttpClient
+from .models import BaseModel, DynamicModel, TaskResponse, optional, required
+from .multipart import MultipartBody, MultipartFile
+from .options import ClientOptions, PollingOptions, RequestOptions
+from .resource import Resource
+from .version import __version__
+
+__all__ = [
+    "__version__",
+    "config",
+    "configure",
+    "errors",
+    "polling",
+    "CONTRACT",
+    "resolve_api_key",
+    "Error",
+    "AuthenticationError",
+    "InsufficientCreditsError",
+    "NotFoundError",
+    "ConflictError",
+    "ValidationError",
+    "RateLimitError",
+    "ServiceUnavailableError",
+    "ServerError",
+    "NetworkError",
+    "TimeoutError",
+    "TaskTimeoutError",
+    "TaskFailedError",
+    "error_from_response",
+    "ClientOptions",
+    "RequestOptions",
+    "PollingOptions",
+    "BaseModel",
+    "DynamicModel",
+    "TaskResponse",
+    "required",
+    "optional",
+    "MultipartBody",
+    "MultipartFile",
+    "HttpClient",
+    "Resource",
+    "FilesClient",
+    "UploadResponse",
+]

runapi/core/auth.py

@@ -0,0 +1,36 @@
+"""API key resolution."""
+
+import os
+from typing import Optional
+
+from . import config
+from .errors import AuthenticationError
+
+ENV_VAR_NAME = "RUNAPI_API_KEY"
+
+MISSING_KEY_MESSAGE = (
+    "API key is required. Pass api_key or set the RUNAPI_API_KEY environment variable."
+)
+
+
+def resolve_api_key(explicit: Optional[str] = None) -> str:
+    """Resolve the API key, in priority order:
+
+    1. the explicit argument
+    2. the global ``runapi.core`` configuration (``config.api_key``)
+    3. the ``RUNAPI_API_KEY`` environment variable
+
+    All sources are trimmed; blank values are treated as missing. Raises
+    :class:`AuthenticationError` when no source yields a value.
+    """
+    resolved = _normalize(explicit) or _normalize(config.api_key) or _normalize(os.environ.get(ENV_VAR_NAME))
+    if not resolved:
+        raise AuthenticationError(MISSING_KEY_MESSAGE)
+    return resolved
+
+
+def _normalize(value: Optional[str]) -> Optional[str]:
+    if not isinstance(value, str):
+        return None
+    trimmed = value.strip()
+    return trimmed or None

runapi/core/config.py

@@ -0,0 +1,23 @@
+"""Module-level configuration shared across RunAPI clients.
+
+Mirrors Ruby's global ``RunApi.api_key`` / ``RunApi.base_url``. Values are read
+at request time, so ``configure()`` (or assigning these attributes directly)
+affects clients constructed afterwards.
+"""
+
+import sys
+from typing import Optional
+
+from .constants import DEFAULT_BASE_URL
+
+api_key: Optional[str] = None
+base_url: str = DEFAULT_BASE_URL
+
+
+def configure(api_key: Optional[str] = None, base_url: Optional[str] = None) -> None:
+    """Set global configuration. Only non-None arguments are applied."""
+    module = sys.modules[__name__]
+    if api_key is not None:
+        module.api_key = api_key
+    if base_url is not None:
+        module.base_url = base_url

runapi/core/constants.py

@@ -0,0 +1,17 @@
+from .version import __version__
+
+HTTP_REQUEST_TIMEOUT = 900
+POLLING_INTERVAL = 2
+POLLING_MAX_WAIT = 900
+
+MAX_RETRIES = 2
+RETRY_BASE_DELAY = 0.5
+RETRY_MAX_DELAY = 5.0
+
+DEFAULT_BASE_URL = "https://runapi.ai"
+
+SDK_USER_AGENT = f"runapi-sdk-python/{__version__}"
+
+IDEMPOTENT_METHODS = frozenset({"GET", "HEAD", "PUT", "DELETE", "OPTIONS"})
+
+RETRYABLE_STATUS_CODES = frozenset({429, 500, 502, 503, 504})