oceanum-prax-sdk 0.3.2__tar.gz

oceanum_prax_sdk-0.3.2/.github/scripts/check_pypi_release.py

@@ -0,0 +1,198 @@
+#!/usr/bin/env python3
+"""Validate exported release provenance and plan an immutable PyPI upload."""
+
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import os
+import re
+import shutil
+import sys
+import time
+import tomllib
+import urllib.error
+import urllib.request
+from pathlib import Path, PurePosixPath
+
+PYPI_JSON = "https://pypi.org/pypi/{package}/{version}/json"
+PACKAGE_NAMES = {"sdk": "oceanum-prax-sdk", "cli": "oceanum-prax-cli"}
+
+
+def validate_snapshot(
+    snapshot_path: Path, expected_package: str
+) -> tuple[bool, str | None]:
+    root = snapshot_path.resolve().parent
+    snapshot = json.loads(snapshot_path.read_text(encoding="utf-8"))
+    package = snapshot.get("package")
+    if package not in PACKAGE_NAMES or PACKAGE_NAMES[package] != expected_package:
+        raise ValueError("Snapshot package does not match the expected distribution")
+    if not re.fullmatch(r"[0-9a-f]{40}", snapshot.get("source_commit", "")):
+        raise ValueError("Snapshot source_commit must be a full Git SHA")
+    tooling_commit = snapshot.get("tooling_commit", snapshot["source_commit"])
+    if not isinstance(tooling_commit, str) or not re.fullmatch(
+        r"[0-9a-f]{40}", tooling_commit
+    ):
+        raise ValueError("Snapshot tooling_commit must be a full Git SHA")
+    files = snapshot.get("files")
+    if not isinstance(files, dict) or not files:
+        raise ValueError("Snapshot must include its exported file hashes")
+    for relative, expected_hash in files.items():
+        path = PurePosixPath(relative)
+        if path.is_absolute() or ".." in path.parts:
+            raise ValueError(f"Unsafe exported path in snapshot: {relative}")
+        file_path = root.joinpath(*path.parts)
+        if file_path.is_symlink() or not file_path.is_file():
+            raise ValueError(f"Snapshot file is missing: {relative}")
+        actual_hash = hashlib.sha256(file_path.read_bytes()).hexdigest()
+        if actual_hash != expected_hash:
+            raise ValueError(f"Snapshot file hash mismatch: {relative}")
+    tooling_files = snapshot.get("tooling_files", {})
+    if not isinstance(tooling_files, dict) or any(
+        files.get(relative) != expected_hash
+        for relative, expected_hash in tooling_files.items()
+    ):
+        raise ValueError("Snapshot tooling file hashes do not match exported files")
+    expected_files = set(files) | {"SOURCE_SNAPSHOT.json"}
+    actual_files = {
+        path.relative_to(root).as_posix()
+        for path in root.rglob("*")
+        if path.is_file()
+        and ".git" not in path.relative_to(root).parts
+        and ".venv" not in path.relative_to(root).parts
+        and "__pycache__" not in path.relative_to(root).parts
+    }
+    if actual_files != expected_files:
+        raise ValueError("Mirror contains files outside the validated snapshot")
+    project = tomllib.loads((root / "pyproject.toml").read_text(encoding="utf-8"))[
+        "project"
+    ]
+    if project.get("name") != expected_package:
+        raise ValueError("pyproject distribution name does not match snapshot")
+
+    release_tag = snapshot.get("release_tag")
+    release_version = snapshot.get("release_version")
+    if release_tag is None and release_version is None:
+        if project.get("version") != "0.0.0":
+            raise ValueError("Non-release snapshot must retain the development version")
+        return False, None
+    if (
+        not isinstance(release_tag, str)
+        or not re.fullmatch(r"v[0-9]+\.[0-9]+\.[0-9]+", release_tag)
+        or release_version != release_tag[1:]
+        or project.get("version") != release_version
+    ):
+        raise ValueError("Snapshot release tag, version, and package metadata disagree")
+    return True, release_version
+
+
+def artifact_hashes(directory: Path) -> dict[str, str]:
+    artifacts = sorted(
+        path
+        for path in directory.iterdir()
+        if path.name.endswith(".whl") or path.name.endswith(".tar.gz")
+    )
+    if len(artifacts) != 2 or {path.suffix for path in artifacts} != {".whl", ".gz"}:
+        raise ValueError(f"Expected exactly one wheel and one sdist in {directory}")
+    return {
+        path.name: hashlib.sha256(path.read_bytes()).hexdigest() for path in artifacts
+    }
+
+
+def release_json(package: str, version: str) -> dict | None:
+    request = urllib.request.Request(
+        PYPI_JSON.format(package=package, version=version),
+        headers={"Accept": "application/json"},
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=20) as response:
+            return json.load(response)
+    except urllib.error.HTTPError as error:
+        if error.code == 404:
+            return None
+        raise
+
+
+def files_to_publish(package: str, version: str, directory: Path) -> list[str]:
+    local = artifact_hashes(directory)
+    published = release_json(package, version)
+    if published is None:
+        return sorted(local)
+    remote = {
+        file["filename"]: file["digests"]["sha256"]
+        for file in published.get("urls", [])
+    }
+    if not set(remote).issubset(local) or any(
+        local[filename] != digest for filename, digest in remote.items()
+    ):
+        raise ValueError(
+            f"PyPI already has conflicting files for {package} {version}; "
+            "refusing to overwrite"
+        )
+    return sorted(set(local) - set(remote))
+
+
+def should_publish(package: str, version: str, directory: Path) -> bool:
+    return bool(files_to_publish(package, version, directory))
+
+
+def wait_for_sdk(version: str, *, attempts: int = 30, delay: float = 10) -> None:
+    for attempt in range(attempts):
+        release = release_json(PACKAGE_NAMES["sdk"], version)
+        urls = release.get("urls", []) if release else []
+        has_wheel = any(item.get("packagetype") == "bdist_wheel" for item in urls)
+        has_sdist = any(item.get("packagetype") == "sdist" for item in urls)
+        if has_wheel and has_sdist:
+            return
+        if attempt + 1 < attempts:
+            time.sleep(delay)
+    raise ValueError(f"Matching SDK {version} is not fully available on PyPI")
+
+
+def write_output(name: str, value: str) -> None:
+    output = os.environ.get("GITHUB_OUTPUT")
+    if output:
+        with open(output, "a", encoding="utf-8") as stream:
+            stream.write(f"{name}={value}\n")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--snapshot", type=Path, required=True)
+    parser.add_argument("--expected-package", required=True)
+    parser.add_argument("--validate-only", action="store_true")
+    parser.add_argument("--distribution-dir", type=Path)
+    parser.add_argument("--publish-dir", type=Path)
+    parser.add_argument("--require-sdk", action="store_true")
+    args = parser.parse_args()
+    try:
+        is_release, version = validate_snapshot(args.snapshot, args.expected_package)
+        write_output("is_release", str(is_release).lower())
+        if args.validate_only or not is_release:
+            print(f"is_release={str(is_release).lower()}")
+            return 0
+        if args.distribution_dir is None:
+            raise ValueError("--distribution-dir is required for publishing preflight")
+        if args.require_sdk:
+            assert version is not None
+            wait_for_sdk(version)
+        assert version is not None
+        files = files_to_publish(args.expected_package, version, args.distribution_dir)
+        publish = bool(files)
+        if args.publish_dir:
+            args.publish_dir.mkdir(parents=True, exist_ok=True)
+            for filename in files:
+                shutil.copy2(
+                    args.distribution_dir / filename, args.publish_dir / filename
+                )
+        write_output("should_publish", str(publish).lower())
+        print(f"should_publish={str(publish).lower()}")
+        return 0
+    except (OSError, ValueError, json.JSONDecodeError, KeyError) as error:
+        print(f"PyPI release preflight failed: {error}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

oceanum_prax_sdk-0.3.2/.github/workflows/publish.yml

@@ -0,0 +1,62 @@
+name: Publish SDK to PyPI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "SOURCE_SNAPSHOT.json"
+      - "LICENSE"
+      - "pyproject.toml"
+      - "src/**"
+      - ".github/workflows/publish.yml"
+      - ".github/scripts/check_pypi_release.py"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pypi-${{ github.repository }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/oceanum-prax-sdk/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+          enable-cache: false
+
+      - id: release
+        name: Validate release snapshot provenance
+        run: python .github/scripts/check_pypi_release.py --snapshot SOURCE_SNAPSHOT.json --expected-package oceanum-prax-sdk --validate-only
+
+      - name: Build and validate distributions
+        if: steps.release.outputs.is_release == 'true'
+        run: |
+          mkdir -p "$RUNNER_TEMP/package-source"
+          git archive HEAD | tar -x -C "$RUNNER_TEMP/package-source"
+          uv build --no-sources "$RUNNER_TEMP/package-source" --out-dir "$RUNNER_TEMP/dist"
+          uvx --from twine twine check "$RUNNER_TEMP"/dist/*
+
+      - id: preflight
+        name: Prepare only missing immutable PyPI files
+        if: steps.release.outputs.is_release == 'true'
+        run: python .github/scripts/check_pypi_release.py --snapshot SOURCE_SNAPSHOT.json --expected-package oceanum-prax-sdk --distribution-dir "$RUNNER_TEMP/dist" --publish-dir "$RUNNER_TEMP/dist-to-upload"
+
+      - name: Publish to PyPI
+        if: steps.preflight.outputs.should_publish == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: ${{ runner.temp }}/dist-to-upload

oceanum_prax_sdk-0.3.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022, Oceanum Developers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

oceanum_prax_sdk-0.3.2/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.5
+Name: oceanum-prax-sdk
+Version: 0.3.2
+Summary: Typed clients and data models for PRAX platform
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,client,prax,pydantic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: datamodel-code-generator>=0.25.0; extra == 'dev'
+Requires-Dist: mypy>=1.11.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-timeout>=2.3.1; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# prax (PRAX SDK)
+
+Typed HTTP clients, API models, and authored input helpers for PRAX applications.
+The Python distribution and import name are **`prax`**.
+
+## Working with PRAX
+
+Use the SDK to:
+
+- Read exact service-instance health, metrics and usage, and stream logs with
+  `PraxAPIClient`.
+- Read and compare authored ProjectSpec revisions with bounded history operations.
+- Validate and manipulate pipeline/stage inputs with `prax.spec` and
+  `prax.project_spec_workflow`.
+- Work with typed request/response data through `prax.models`.
+
+The asynchronous client supports context-manager cleanup, request timeouts, and
+bounded pagination. Authorize requests with an API token for your environment;
+resource access follows your account's permissions.
+
+## Example
+
+Set `PRAX_API_URL` to your PRAX endpoint and `PRAX_API_TOKEN` to your API token.
+Substitute a project name and revision number accessible to your account.
+
+<!-- sdk-http-example:start -->
+```python
+import asyncio
+import os
+
+from prax import PraxAPIClient
+
+
+async def main():
+    async with PraxAPIClient(
+        os.environ["PRAX_API_URL"], token=os.environ["PRAX_API_TOKEN"]
+    ) as client:
+        revision = await client.get_project_spec_revision("forecast-project", 1)
+        print(revision.model_dump_json())
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+<!-- sdk-http-example:end -->
+
+## Following service-instance logs
+
+Use the complete project, stage, service and stage-incarnation identity returned
+by the API. Open logs with `async with`, not `await`: the context owns the response
+and closes it on completion, an early exit, error or cancellation.
+
+```python
+async with client.stream_service_instance_logs(
+    project_ref="forecast-project",
+    stage_ref="production",
+    service_name="api",
+    stage_incarnation=stage_incarnation,
+    org="oceanum",
+    follow=True,
+    tail=100,
+) as response:
+    async for line in response.aiter_lines():
+        print(line)
+```
+
+Read the response only inside this context. Follow has no idle read deadline;
+connection, write and pool timeouts remain those of the client. Snapshot requests
+retain the normal read timeout. Injected/shared HTTP clients remain caller-owned.
+No status lookup or repeated reconnection is needed to receive a live line.
+
+## Errors
+
+Client operations raise `PraxAPIError`. Use its `.status`, `.code`, and `.reason`
+attributes to handle errors programmatically.
+
+Catch this exception around awaited client operations to distinguish API responses
+from transport failures and decide whether to retry.
+
+## Requirements
+
+Python **3.11+** is required. Runtime dependencies are Pydantic, Pydantic Settings,
+HTTPX, and PyYAML; version bounds are declared in `pyproject.toml`.
+
+## Versions
+
+The SDK and CLI share the same release version. Each CLI release depends on the
+matching `prax` SDK release. To inspect your installed SDK version:
+
+```python
+from importlib.metadata import version
+
+print(version("oceanum-prax-sdk"))
+```
+
+## See also
+
+- [PRAX command-line interface](https://github.com/oceanum/prax-cli)

oceanum_prax_sdk-0.3.2/README.md

@@ -0,0 +1,98 @@
+# prax (PRAX SDK)
+
+Typed HTTP clients, API models, and authored input helpers for PRAX applications.
+The Python distribution and import name are **`prax`**.
+
+## Working with PRAX
+
+Use the SDK to:
+
+- Read exact service-instance health, metrics and usage, and stream logs with
+  `PraxAPIClient`.
+- Read and compare authored ProjectSpec revisions with bounded history operations.
+- Validate and manipulate pipeline/stage inputs with `prax.spec` and
+  `prax.project_spec_workflow`.
+- Work with typed request/response data through `prax.models`.
+
+The asynchronous client supports context-manager cleanup, request timeouts, and
+bounded pagination. Authorize requests with an API token for your environment;
+resource access follows your account's permissions.
+
+## Example
+
+Set `PRAX_API_URL` to your PRAX endpoint and `PRAX_API_TOKEN` to your API token.
+Substitute a project name and revision number accessible to your account.
+
+<!-- sdk-http-example:start -->
+```python
+import asyncio
+import os
+
+from prax import PraxAPIClient
+
+
+async def main():
+    async with PraxAPIClient(
+        os.environ["PRAX_API_URL"], token=os.environ["PRAX_API_TOKEN"]
+    ) as client:
+        revision = await client.get_project_spec_revision("forecast-project", 1)
+        print(revision.model_dump_json())
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+<!-- sdk-http-example:end -->
+
+## Following service-instance logs
+
+Use the complete project, stage, service and stage-incarnation identity returned
+by the API. Open logs with `async with`, not `await`: the context owns the response
+and closes it on completion, an early exit, error or cancellation.
+
+```python
+async with client.stream_service_instance_logs(
+    project_ref="forecast-project",
+    stage_ref="production",
+    service_name="api",
+    stage_incarnation=stage_incarnation,
+    org="oceanum",
+    follow=True,
+    tail=100,
+) as response:
+    async for line in response.aiter_lines():
+        print(line)
+```
+
+Read the response only inside this context. Follow has no idle read deadline;
+connection, write and pool timeouts remain those of the client. Snapshot requests
+retain the normal read timeout. Injected/shared HTTP clients remain caller-owned.
+No status lookup or repeated reconnection is needed to receive a live line.
+
+## Errors
+
+Client operations raise `PraxAPIError`. Use its `.status`, `.code`, and `.reason`
+attributes to handle errors programmatically.
+
+Catch this exception around awaited client operations to distinguish API responses
+from transport failures and decide whether to retry.
+
+## Requirements
+
+Python **3.11+** is required. Runtime dependencies are Pydantic, Pydantic Settings,
+HTTPX, and PyYAML; version bounds are declared in `pyproject.toml`.
+
+## Versions
+
+The SDK and CLI share the same release version. Each CLI release depends on the
+matching `prax` SDK release. To inspect your installed SDK version:
+
+```python
+from importlib.metadata import version
+
+print(version("oceanum-prax-sdk"))
+```
+
+## See also
+
+- [PRAX command-line interface](https://github.com/oceanum/prax-cli)

oceanum_prax_sdk-0.3.2/SOURCE_SNAPSHOT.json

@@ -0,0 +1,60 @@
+{
+  "files": {
+    ".github/scripts/check_pypi_release.py": "87c9e2d2834541e9fbf631d2b281514952fcd96abf9a2937eb6d007a93c063aa",
+    ".github/workflows/publish.yml": "236641898fe29afb92a512999b1881a986d060f10f4d85ebf59d344e51f4d3bb",
+    "LICENSE": "cc79a4f8cc49e9db712786cf7df8a962f1da42ea390be5fecededd9eafaaf3bb",
+    "README.md": "25e9f0767400767cb6b0bccc44011cae03d3abd78c3769ec4a887faced5eed55",
+    "pyproject.toml": "d8ef2786a4d8d37372fd1ce940437b79ba04507cc0c87f83aec35ae2a2c81d52",
+    "src/prax/__init__.py": "cd41a84b73cc1cf0e65dc7904fde540e443d22502d3a34675170bfeded4e081e",
+    "src/prax/_version.py": "8f5323cc90d87b05740ede2dea97a2e4f8d09c9a956aae3d945e182b8c79e327",
+    "src/prax/api.py": "c2d51329286e5aa66dbe06e2f06dcf6665da4f48220b0c211c85b10ebc96603a",
+    "src/prax/files/__init__.py": "3333a4e8da259746c5ee671d066156296165d40c0c601f32a7ae8f3004271d01",
+    "src/prax/files/base.py": "4fcce9d2c44babfacbdd338a30210b8181fe7e6f8d0aa8bd561f90f13bb47469",
+    "src/prax/models/__init__.py": "2836f33525efeeca58839e3de431c4eb4ee3d2f76f6e284c7f5b3c0548007283",
+    "src/prax/project_spec_workflow.py": "9b3d4218f2e7c34c5573e4f27497ff6a4b41e5ea168fd823e8a9d9780be11f22",
+    "src/prax/py.typed": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    "src/prax/settings.py": "8051b865132b9bd63ed2fed1956cc21a06ace4e49526c5d06acd32ce7f31cdbf",
+    "src/prax/spec/__init__.py": "8e4809da07c289b64c19fa712ac278d5b3a912ea2729ba4b324e1ec2b942071e",
+    "src/prax/spec/_base_types.py": "98f4151503e40c3f8e1cdf9a546c728ebf527db0f1438cb5874972f259d0a617",
+    "src/prax/spec/_workflow.py": "42a4861ac84a293417f4111ab0d188e40f50a959dc1bae33662be2b02dc52f58",
+    "src/prax/spec/pipeline.py": "4dc8d660d8e695906897973c9bb5ab3a9e1a81899db104f74eceb2a4eec7ea15",
+    "src/prax/spec/resources.py": "e659a7c2f9d443eb330a9537dd2ec7455fa479f863c1b69af2c590548db44c11",
+    "src/prax/spec/secret_refs.py": "00e0b8f9f9a4da4d8d4405bc9b94eddaf287883d4b103381145a927b9ff0c3ee",
+    "src/prax/spec/source_refs.py": "1fe0dcd6c60cfc618bdb86fa5241ea67849813d808462dac4ede1bed6ed1e185",
+    "src/prax/spec/stage.py": "8f77d8fe58a0f2b98336efd9826920e9ad59ded76bd9baf88a5d59eead3a2532",
+    "src/prax/utils.py": "81185a7529283b19999da234e8246f761fceaf027e46f9a139f7d638b5e14494"
+  },
+  "package": "sdk",
+  "release_tag": "v0.3.2",
+  "release_version": "0.3.2",
+  "source_commit": "b40191a0a15e5459c7e5b672a41cb80326e33c1b",
+  "source_files": {
+    ".github/scripts/check_pypi_release.py": "49454c3b95615cba02c209d6ed63e2f27bb5507553f987b0bffcd095a7ad7f76",
+    ".github/workflows/publish.yml": "236641898fe29afb92a512999b1881a986d060f10f4d85ebf59d344e51f4d3bb",
+    "LICENSE": "cc79a4f8cc49e9db712786cf7df8a962f1da42ea390be5fecededd9eafaaf3bb",
+    "README.md": "25e9f0767400767cb6b0bccc44011cae03d3abd78c3769ec4a887faced5eed55",
+    "pyproject.toml": "cce473f073295243a84873b14a09a8bf477d5d3b5a462b27d6f80ff64c186740",
+    "src/prax/__init__.py": "cd41a84b73cc1cf0e65dc7904fde540e443d22502d3a34675170bfeded4e081e",
+    "src/prax/_version.py": "8f5323cc90d87b05740ede2dea97a2e4f8d09c9a956aae3d945e182b8c79e327",
+    "src/prax/api.py": "c2d51329286e5aa66dbe06e2f06dcf6665da4f48220b0c211c85b10ebc96603a",
+    "src/prax/files/__init__.py": "3333a4e8da259746c5ee671d066156296165d40c0c601f32a7ae8f3004271d01",
+    "src/prax/files/base.py": "4fcce9d2c44babfacbdd338a30210b8181fe7e6f8d0aa8bd561f90f13bb47469",
+    "src/prax/models/__init__.py": "2836f33525efeeca58839e3de431c4eb4ee3d2f76f6e284c7f5b3c0548007283",
+    "src/prax/project_spec_workflow.py": "9b3d4218f2e7c34c5573e4f27497ff6a4b41e5ea168fd823e8a9d9780be11f22",
+    "src/prax/py.typed": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    "src/prax/settings.py": "8051b865132b9bd63ed2fed1956cc21a06ace4e49526c5d06acd32ce7f31cdbf",
+    "src/prax/spec/__init__.py": "8e4809da07c289b64c19fa712ac278d5b3a912ea2729ba4b324e1ec2b942071e",
+    "src/prax/spec/_base_types.py": "98f4151503e40c3f8e1cdf9a546c728ebf527db0f1438cb5874972f259d0a617",
+    "src/prax/spec/_workflow.py": "42a4861ac84a293417f4111ab0d188e40f50a959dc1bae33662be2b02dc52f58",
+    "src/prax/spec/pipeline.py": "4dc8d660d8e695906897973c9bb5ab3a9e1a81899db104f74eceb2a4eec7ea15",
+    "src/prax/spec/resources.py": "e659a7c2f9d443eb330a9537dd2ec7455fa479f863c1b69af2c590548db44c11",
+    "src/prax/spec/secret_refs.py": "00e0b8f9f9a4da4d8d4405bc9b94eddaf287883d4b103381145a927b9ff0c3ee",
+    "src/prax/spec/source_refs.py": "1fe0dcd6c60cfc618bdb86fa5241ea67849813d808462dac4ede1bed6ed1e185",
+    "src/prax/spec/stage.py": "8f77d8fe58a0f2b98336efd9826920e9ad59ded76bd9baf88a5d59eead3a2532",
+    "src/prax/utils.py": "81185a7529283b19999da234e8246f761fceaf027e46f9a139f7d638b5e14494"
+  },
+  "tooling_commit": "4277b49c22b7d99b6ce4b8ec7afb253a7e843c50",
+  "tooling_files": {
+    ".github/scripts/check_pypi_release.py": "87c9e2d2834541e9fbf631d2b281514952fcd96abf9a2937eb6d007a93c063aa"
+  }
+}

oceanum_prax_sdk-0.3.2/pyproject.toml

@@ -0,0 +1,120 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "oceanum-prax-sdk"
+# Development placeholder; release exports are stamped from the monorepo tag.
+version = "0.3.2"
+description = "Typed clients and data models for PRAX platform"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+keywords = ["prax", "pydantic", "client", "api"]
+classifiers = [
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Development Status :: 3 - Alpha",
+]
+
+dependencies = [
+    "pydantic>=2.0,<3.0",
+    "pydantic-settings>=2.0",
+    "httpx>=0.27.0",
+    "PyYAML>=6.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-timeout>=2.3.1",
+]
+dev = [
+    "ruff>=0.6.0",
+    "mypy>=1.11.0",
+    "pre-commit>=3.5.0",
+    "types-PyYAML>=6.0.12",
+    "datamodel-code-generator>=0.25.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/prax"]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = [
+    "-ra",
+    "-q",
+    "--strict-markers",
+    "--strict-config",
+    "--tb=short",
+]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+exclude = [
+    ".git",
+    "build",
+    "dist",
+    ".venv",
+    "__pycache__",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "N",      # pep8-naming
+    "UP",     # pyupgrade
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "SIM",    # flake8-simplify
+    "RET",    # flake8-return
+    "ARG",    # flake8-unused-arguments
+    "PTH",    # flake8-use-pathlib
+    "PL",     # pylint
+    "RUF",    # Ruff-specific
+]
+ignore = [
+    "E501",    # Line too long (handled by formatter)
+    "B008",    # Function call in defaults (Pydantic pattern)
+    "PLR0913", # Too many arguments
+    "ARG001",  # Unused function argument
+    "ARG002",  # Unused method argument
+    "PLW1641", # Object does not implement __hash__ (Pydantic models)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["F401", "F403"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["prax"]
+section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
+
+[tool.mypy]
+python_version = "3.12"
+exclude = ["src/prax/models/"]
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+check_untyped_defs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+strict_optional = true
+pretty = true