runapi-core 0.1.0__tar.gz

runapi_core-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: runapi-core
+Version: 0.1.0
+Summary: Core module for the RunAPI Python SDK
+Project-URL: Homepage, https://runapi.ai
+Project-URL: Documentation, https://runapi.ai/docs#sdk
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: ai,api,runapi,sdk
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# RunAPI Core Python SDK
+
+The RunAPI Core Python SDK provides shared authentication, HTTP, retry, error, and polling primitives for RunAPI model packages. Install `runapi-core` only when you are building SDK infrastructure or shared Python tooling; application code should normally install a concrete model package such as `runapi-flux-2`.
+
+## Install
+
+```bash
+pip install runapi-core
+```
+
+## Notes
+
+Use the core package for common client options, error classes, request helpers, file uploads, and task polling behavior that model SDKs share. Configure it globally or per client:
+
+```python
+import runapi.core as runapi
+
+runapi.configure(api_key="sk-...")  # or set RUNAPI_API_KEY in the environment
+```
+
+```python
+from runapi.core import FilesClient
+
+files = FilesClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."
+uploaded = files.create(file="./input.png")
+print(uploaded.url)
+```
+
+Public SDK docs live at https://runapi.ai/docs#runapi-sdks and the model catalog lives at https://runapi.ai/models.
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_core-0.1.0/README.md

@@ -0,0 +1,33 @@
+# RunAPI Core Python SDK
+
+The RunAPI Core Python SDK provides shared authentication, HTTP, retry, error, and polling primitives for RunAPI model packages. Install `runapi-core` only when you are building SDK infrastructure or shared Python tooling; application code should normally install a concrete model package such as `runapi-flux-2`.
+
+## Install
+
+```bash
+pip install runapi-core
+```
+
+## Notes
+
+Use the core package for common client options, error classes, request helpers, file uploads, and task polling behavior that model SDKs share. Configure it globally or per client:
+
+```python
+import runapi.core as runapi
+
+runapi.configure(api_key="sk-...")  # or set RUNAPI_API_KEY in the environment
+```
+
+```python
+from runapi.core import FilesClient
+
+files = FilesClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."
+uploaded = files.create(file="./input.png")
+print(uploaded.url)
+```
+
+Public SDK docs live at https://runapi.ai/docs#runapi-sdks and the model catalog lives at https://runapi.ai/models.
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_core-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runapi-core"
+dynamic = ["version"]
+description = "Core module for the RunAPI Python SDK"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
+keywords = ["runapi", "ai", "sdk", "api"]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://runapi.ai"
+Documentation = "https://runapi.ai/docs#sdk"
+
+[tool.hatch.version]
+path = "src/runapi/core/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runapi"]
+
+[tool.uv]
+package = true
+
+[dependency-groups]
+dev = ["pytest>=8", "httpx>=0.27"]

runapi_core-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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})