finatic-server-python 0.9.11__tar.gz → 0.9.14__tar.gz

finatic_server_python-0.9.14/.flake8

@@ -0,0 +1,15 @@
+[flake8]
+max-line-length = 88
+extend-ignore = E203,E266,E501,W503
+exclude =
+    .git,
+    __pycache__,
+    build,
+    dist,
+    *.egg-info,
+    .venv,
+    venv,
+    src/openapi/finatic_server
+per-file-ignores =
+    finatic_server_python/__init__.py:E402,F401,F403
+    src/__init__.py:F401,F403

{finatic_server_python-0.9.11 → finatic_server_python-0.9.14}/.github/workflows/ci.yml

@@ -2,12 +2,12 @@ name: CI
 
 on:
   push:
-    branches: [main, develop]
+    branches: [main, develop, staging]
   pull_request:
-    branches: [main, develop]
+    branches: [main, develop, staging]
 
 jobs:
-  test:
+  quality:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -26,7 +26,15 @@ jobs:
           enable-cache: true
 
       - name: Install package with dev dependencies
-        run: uv pip install --system -e ".[dev]"
+        run: |
+          uv venv
+          uv pip install -e ".[dev]"
+
+      - name: Compile package
+        run: uv run python -m compileall finatic_server_python src tests
 
       - name: Run tests
-        run: pytest -q
+        run: uv run pytest -q
+
+      - name: Build package
+        run: uv run python -m build

finatic_server_python-0.9.14/.github/workflows/release.yml

@@ -0,0 +1,155 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Build artifacts without publishing to PyPI"
+        required: true
+        default: "true"
+        type: choice
+        options: ["true", "false"]
+      version:
+        description: "Optional release version. Defaults to the next patch version."
+        required: false
+        type: string
+      publish_repository:
+        description: "Publish target for non-dry-run manual releases"
+        required: true
+        default: "pypi"
+        type: choice
+        options: ["pypi", "testpypi"]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    if: github.event_name != 'push' || !startsWith(github.event.head_commit.message, 'chore(release):')
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install build dependencies
+        run: |
+          uv venv
+          uv pip install -e ".[dev]"
+
+      - name: Resolve release mode
+        id: mode
+        shell: bash
+        run: |
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            echo "dry_run=${{ inputs.dry_run }}" >> "$GITHUB_OUTPUT"
+            echo "repository=${{ inputs.publish_repository }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "dry_run=false" >> "$GITHUB_OUTPUT"
+            echo "repository=pypi" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Guard publish ref
+        shell: bash
+        run: |
+          if [[ "${{ steps.mode.outputs.dry_run }}" != "true" && "$GITHUB_REF" != "refs/heads/main" ]]; then
+            echo "::error::Non-dry-run releases must run from refs/heads/main."
+            exit 1
+          fi
+
+      - name: Prepare release version
+        id: version
+        shell: python
+        env:
+          REQUESTED_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
+          DRY_RUN: ${{ steps.mode.outputs.dry_run }}
+        run: |
+          from pathlib import Path
+          import os
+          import re
+
+          pyproject = Path("pyproject.toml")
+          text = pyproject.read_text()
+          match = re.search(r'^version = "([^"]+)"$', text, flags=re.MULTILINE)
+          if not match:
+              raise SystemExit("Could not find project version in pyproject.toml")
+
+          current = match.group(1)
+          requested = os.environ["REQUESTED_VERSION"].strip()
+          if requested:
+              next_version = requested
+          else:
+              parts = current.split(".")
+              if len(parts) != 3 or not all(part.isdigit() for part in parts):
+                  raise SystemExit(f"Cannot auto-bump non-semver version: {current}")
+              major, minor, patch = map(int, parts)
+              next_version = f"{major}.{minor}.{patch + 1}"
+
+          if os.environ["DRY_RUN"] != "true":
+              pyproject.write_text(
+                  text[: match.start(1)] + next_version + text[match.end(1) :]
+              )
+              changelog = Path("CHANGELOG.md")
+              existing = changelog.read_text() if changelog.exists() else "# Changelog\n\n"
+              entry = (
+                  f"## {next_version}\n\n"
+                  f"- Release from {os.environ.get('GITHUB_SHA', 'unknown commit')}.\n\n"
+              )
+              if f"## {next_version}" not in existing:
+                  if existing.startswith("# Changelog\n\n"):
+                      existing = "# Changelog\n\n" + entry + existing[len("# Changelog\n\n") :]
+                  else:
+                      existing = "# Changelog\n\n" + entry + existing
+                  changelog.write_text(existing)
+
+          with open(os.environ["GITHUB_OUTPUT"], "a") as output:
+              output.write(f"version={next_version}\n")
+              output.write(f"tag=v{next_version}\n")
+
+      - name: Run quality gate
+        run: |
+          uv run python -m compileall finatic_server_python src tests
+          uv run pytest -q
+
+      - name: Build wheel and sdist
+        run: uv run python -m build
+
+      - name: Upload release artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: finatic-server-python-${{ steps.version.outputs.version }}
+          path: dist/*
+
+      - name: Commit version bump and tag
+        if: steps.mode.outputs.dry_run != 'true'
+        shell: bash
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml CHANGELOG.md
+          git commit -m "chore(release): v${{ steps.version.outputs.version }}"
+          git tag "${{ steps.version.outputs.tag }}"
+          git push origin HEAD:main --follow-tags
+
+      - name: Publish to TestPyPI
+        if: steps.mode.outputs.dry_run != 'true' && steps.mode.outputs.repository == 'testpypi'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+      - name: Publish to PyPI
+        if: steps.mode.outputs.dry_run != 'true' && steps.mode.outputs.repository == 'pypi'
+        uses: pypa/gh-action-pypi-publish@release/v1

finatic_server_python-0.9.14/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.9.14
+
+- Release from 7ce410c4f9bbcdc148bbec0d5eb4a307b123a719.
+
+## 0.9.13
+
+- Release from 1d035a761af0c9b05c619a1abe2760693da70b57.
+

{finatic_server_python-0.9.11 → finatic_server_python-0.9.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finatic-server-python
-Version: 0.9.11
+Version: 0.9.14
 Summary: Python SDK for Finatic Server API
 Project-URL: Homepage, https://github.com/FinaticORG/FinaticServerSDK-Python
 Project-URL: Documentation, https://docs.finatic.com/python
@@ -33,6 +33,7 @@ Requires-Dist: typing-extensions>=4.15.0
 Requires-Dist: urllib3>=2.6.1
 Provides-Extra: dev
 Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: build>=1.2.2; extra == 'dev'
 Requires-Dist: flake8>=6.0.0; extra == 'dev'
 Requires-Dist: isort>=5.12.0; extra == 'dev'
 Requires-Dist: mypy>=1.0.0; extra == 'dev'

finatic_server_python-0.9.14/finatic_server/__init__.py

@@ -0,0 +1,30 @@
+"""Compatibility package for the generated OpenAPI client.
+
+The generated client lives under ``src/openapi/finatic_server`` so the SDK can
+keep generated code separate from hand-written wrappers. This shim preserves the
+direct ``finatic_server`` import path without packaging the generated files
+twice in the wheel.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+_generated_package_directory = (
+    Path(__file__).resolve().parent.parent / "src" / "openapi" / "finatic_server"
+)
+_generated_package_path = str(_generated_package_directory)
+_package_search_path = globals().setdefault("__path__", [])
+
+if _generated_package_path not in _package_search_path:
+    _package_search_path.append(_generated_package_path)
+
+_generated_init_file = _generated_package_directory / "__init__.py"
+exec(
+    compile(
+        _generated_init_file.read_text(encoding="utf-8"),
+        str(_generated_init_file),
+        "exec",
+    ),
+    globals(),
+)

{finatic_server_python-0.9.11 → finatic_server_python-0.9.14}/finatic_server_python/__init__.py

@@ -6,7 +6,7 @@ This package re-exports everything from src to provide a clean import path:
 This matches the pattern used by:
     - Node.js: import { FinaticServer } from '@finatic/server-node'
     - TypeScript: import { FinaticConnect } from '@finatic/client'
-    
+
 Package name: finatic-server-python (pip install finatic-server-python)
 Import name: finatic_server_python (from finatic_server_python import ...)
 """

{finatic_server_python-0.9.11 → finatic_server_python-0.9.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "finatic-server-python"
-version = "0.9.11"
+version = "0.9.14"
 description = "Python SDK for Finatic Server API"
 authors = [{ name = "Finatic", email = "support@finatic.dev" }]
 license = { text = "PROPRIETARY" }
@@ -46,6 +46,7 @@ dev = [
     "flake8>=6.0.0",
     "mypy>=1.0.0",
     "pre-commit>=3.0.0",
+    "build>=1.2.2",
     "types-cachetools>=5.3.0",
     "types-python-dateutil>=2.8.0",
 ]
@@ -57,11 +58,11 @@ Repository = "https://github.com/FinaticORG/FinaticServerSDK-Python"
 Issues = "https://github.com/FinaticORG/FinaticServerSDK-Python/issues"
 
 [tool.hatch.build.targets.wheel]
-packages = ["finatic_server_python", "src"]
+packages = ["finatic_server_python", "finatic_server", "src"]
 include = ["/LICENSE", "/CHANGELOG.md"]
 
 [tool.hatch.build.targets.editable]
-packages = ["finatic_server_python", "src"]
+packages = ["finatic_server_python", "finatic_server", "src"]
 
 [tool.black]
 line-length = 88
@@ -77,7 +78,7 @@ line_length = 88
 python_version = "3.12"
 warn_return_any = true
 warn_unused_configs = true
-exclude = "(?x)(^tests/|^demo-app/)"
+exclude = "(?x)(^tests/|^demo-app/|^src/openapi/finatic_server/)"
 # Relaxed settings for generated code
 disallow_untyped_defs = false
 check_untyped_defs = true
@@ -91,16 +92,18 @@ show_error_codes = true
 
 # Generated OpenAPI code and smoke tests are not held to the same mypy bar as hand-written SDK code.
 [[tool.mypy.overrides]]
-module = ["src.openapi.generated.*"]
+module = ["finatic_server.*"]
 ignore_errors = true
 
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
-testpaths = ["tests"]
-python_files = ["test_*.py"]
-pythonpath = ["."]
-addopts = "--cov=src --cov-report=term-missing"
+[[tool.mypy.overrides]]
+module = [
+    "src.FinaticServerCore",
+    "src.wrappers.*",
+    "src.utils.enum_coercion",
+    "src.utils.logger",
+    "src.utils.pagination",
+]
+ignore_errors = true
 
 [tool.flake8]
 max-line-length = 88
@@ -113,14 +116,14 @@ exclude = [
     "*.egg-info",
     ".venv",
     "venv",
-    "src/openapi/generated",
+    "src/openapi/finatic_server",
 ]
 import-order-style = "google"
 application-import-names = ["src"]
 
 [tool.ruff]
-exclude = ["src/openapi/generated"]
+exclude = ["src/openapi/finatic_server"]
 
 [tool.ruff.lint.per-file-ignores]
-# Star re-exports from optional custom/generated subpackages; names are re-exported intentionally.
+# Star re-exports from OpenAPI client package; names are re-exported intentionally.
 "src/__init__.py" = ["F403", "F401", "F405"]

{finatic_server_python-0.9.11 → finatic_server_python-0.9.14}/quality_check.py

@@ -36,7 +36,7 @@ def run_command(cmd: list[str], description: str, fix_mode: bool = False) -> boo
             error_output = (result.stderr or result.stdout or "").lower()
             if "failed to spawn" in error_output or "no such file" in error_output:
                 print(f"⚠️  {description} skipped (tool not installed)")
-                print(f"   Install with: uv sync --extra dev")
+                print("   Install with: uv sync --extra dev")
                 return True  # Skip missing tools gracefully
             print(f"❌ {description} failed!")
             if result.stderr:
@@ -52,7 +52,9 @@ def run_command(cmd: list[str], description: str, fix_mode: bool = False) -> boo
 
 def main() -> int:
     """Run all quality checks or fixes."""
-    parser = argparse.ArgumentParser(description="Quality check script for FinaticServerSDK-Python")
+    parser = argparse.ArgumentParser(
+        description="Quality check script for FinaticServerSDK-Python"
+    )
     parser.add_argument(
         "--fix",
         action="store_true",
@@ -111,4 +113,3 @@ def main() -> int:
 
 if __name__ == "__main__":
     sys.exit(main())
-

{finatic_server_python-0.9.11 → finatic_server_python-0.9.14}/src/.openapi-generator-ignore

@@ -21,3 +21,6 @@
 #docs/*.md
 # Then explicitly reverse the ignore rule for a single file:
 #!docs/README.md
+
+# Hand-maintained path setup for ``from finatic_server…`` imports (see path_bootstrap.py).
+path_bootstrap.py