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

finatic_server_python-0.9.11/.github/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing (Issue Hygiene)
+
+Use GitHub Issue Forms for all new work so planning stays consistent across repositories.
+
+## Which template to use
+- **Bug**: broken behavior, regressions, production defects
+- **Task**: implementation/refactor/cleanup/operations work
+- **Feature**: net-new product capability or enhancement
+
+## Required planning fields
+Every issue should include:
+- Problem / Why
+- Scope and Out of Scope
+- Priority (`P0`-`P3`)
+- Size (`XS/S/M/L/XL`)
+- Estimate (days)
+- Acceptance Criteria (checkboxes)
+- Dependencies / Blockers
+- Verification Plan
+
+## Sizing standard
+- `XS`: < 1 day
+- `S`: 1-2 days
+- `M`: 3-4 days
+- `L`: 5-6 days
+- `XL`: 7+ days
+
+## Status flow (project board)
+`Freezer` -> `Backlog` -> `Ready` -> `In Progress` -> `In Review` -> `Complete`
+
+## Linking related work
+- Add a **Related Issues** section with direct links to dependent/coupled tasks.
+- Add a **Subtasks** checklist for child tasks when work can be split.
+- Keep relationships current as issues move across statuses.

finatic_server_python-0.9.11/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install package with dev dependencies
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -q

{finatic_server_python-0.9.9 → finatic_server_python-0.9.11}/.gitignore

@@ -29,6 +29,7 @@ Thumbs.db
 
 # Testing
 coverage/
+coverage.xml
 .nyc_output/
 junit.xml
 

finatic_server_python-0.9.11/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: finatic-server-python
+Version: 0.9.11
+Summary: Python SDK for Finatic Server API
+Project-URL: Homepage, https://github.com/FinaticORG/FinaticServerSDK-Python
+Project-URL: Documentation, https://docs.finatic.com/python
+Project-URL: Repository, https://github.com/FinaticORG/FinaticServerSDK-Python
+Project-URL: Issues, https://github.com/FinaticORG/FinaticServerSDK-Python/issues
+Author-email: Finatic <support@finatic.dev>
+License: PROPRIETARY
+License-File: LICENSE
+Keywords: api,finance,finatic,sdk,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: aiohttp-retry>=2.9.1
+Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: cachetools>=6.2.2
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: python-dateutil>=2.9.0.post0
+Requires-Dist: structlog>=25.5.0
+Requires-Dist: tenacity>=9.1.2
+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: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: types-cachetools>=5.3.0; extra == 'dev'
+Requires-Dist: types-python-dateutil>=2.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Finatic Server SDK (Python)
+
+Python SDK for server-side Finatic integrations.
+
+Use this package to authenticate with Finatic from Python services, generate client tokens, and retrieve standardized broker-domain data.
+
+## Install
+
+```bash
+pip install finatic-server-python
+```
+
+## Quick Start
+
+```python
+from finatic_server_python import FinaticServer
+
+finatic = await FinaticServer.init(api_key="your-api-key")
+token = await finatic.get_token()
+positions = await finatic.get_all_positions()
+```
+
+## Common Commands
+
+| Task | Command |
+|---|---|
+| Install in editable mode | `uv pip install -e .` |
+| Run tests | `pytest` |
+| Build package | `python -m build` |
+| Lint | `ruff check .` |
+| Format | `ruff format .` |
+
+## Core Capabilities
+
+- API-key initialization and session management.
+- Portal URL generation for end-user authentication.
+- One-time token generation for client SDK sessions.
+- Typed access to orders, positions, accounts, and balances.
+- Consistent response/error structures across endpoints.
+
+## Documentation
+
+- Product docs: [https://finatic.dev/docs](https://finatic.dev/docs)
+- API reference: [https://finatic.dev/docs/api-reference](https://finatic.dev/docs/api-reference)
+- LLM context doc: [https://finatic.dev/llms.txt](https://finatic.dev/llms.txt)
+
+## Using Finatic with AI
+
+Use this SDK in Python AI/data systems to:
+
+- query balances, positions, and orders across connected brokers
+- normalize broker interactions behind one SDK surface
+- feed structured brokerage data into analytics or model workflows
+
+MCP support is coming soon.

finatic_server_python-0.9.11/README.md

@@ -0,0 +1,55 @@
+# Finatic Server SDK (Python)
+
+Python SDK for server-side Finatic integrations.
+
+Use this package to authenticate with Finatic from Python services, generate client tokens, and retrieve standardized broker-domain data.
+
+## Install
+
+```bash
+pip install finatic-server-python
+```
+
+## Quick Start
+
+```python
+from finatic_server_python import FinaticServer
+
+finatic = await FinaticServer.init(api_key="your-api-key")
+token = await finatic.get_token()
+positions = await finatic.get_all_positions()
+```
+
+## Common Commands
+
+| Task | Command |
+|---|---|
+| Install in editable mode | `uv pip install -e .` |
+| Run tests | `pytest` |
+| Build package | `python -m build` |
+| Lint | `ruff check .` |
+| Format | `ruff format .` |
+
+## Core Capabilities
+
+- API-key initialization and session management.
+- Portal URL generation for end-user authentication.
+- One-time token generation for client SDK sessions.
+- Typed access to orders, positions, accounts, and balances.
+- Consistent response/error structures across endpoints.
+
+## Documentation
+
+- Product docs: [https://finatic.dev/docs](https://finatic.dev/docs)
+- API reference: [https://finatic.dev/docs/api-reference](https://finatic.dev/docs/api-reference)
+- LLM context doc: [https://finatic.dev/llms.txt](https://finatic.dev/llms.txt)
+
+## Using Finatic with AI
+
+Use this SDK in Python AI/data systems to:
+
+- query balances, positions, and orders across connected brokers
+- normalize broker interactions behind one SDK surface
+- feed structured brokerage data into analytics or model workflows
+
+MCP support is coming soon.

finatic_server_python-0.9.11/docs/README.md

@@ -0,0 +1,23 @@
+# FinaticServerSDK-Python Docs
+
+Codebase-specific deep dives for Python server SDK behavior.
+
+## What this package owns
+
+- API-key based server initialization/session handling.
+- One-time token generation for client-side handoffs.
+- Typed Python methods for broker-domain resources.
+
+## Runtime entrypoints
+
+- Package source: `src` and `finatic_server_python`
+- Public package docs: `README.md`
+
+## Related platform docs
+
+- API docs: `/workspaces/Finatic/codebases/Backend/finaticAPI/docs/README.md`
+- SDK API inventory: `/workspaces/Finatic/docs/sdk-public-api-inventory.md`
+
+## Deep Dive
+
+- [Architecture and runtime](architecture-and-runtime.md)

finatic_server_python-0.9.11/docs/architecture-and-runtime.md

@@ -0,0 +1,25 @@
+# FinaticServerSDK-Python Architecture and Runtime
+
+## Package Role
+
+`FinaticServerSDK-Python` provides server-side Python integration with API-key/session flows and broker-domain operations.
+
+## Internal Structure
+
+- **Public entrypoints**: `src/__init__.py`, `src/FinaticServer.py`
+- **Core runtime**: `src/FinaticServerCore.py`
+- **Generated API client**: `src/openapi/generated`
+- **Domain wrappers**: `src/wrappers`
+- **Cross-cutting utilities**: `src/utils`
+
+## Runtime Flow (High Level)
+
+1. SDK initializes with API key and runtime config.
+2. Session and token methods establish API call context.
+3. Wrapper methods perform domain operations via generated clients.
+4. Utility layers handle retries, validation, and response normalization.
+
+## Operational Boundaries
+
+- Browser-focused portal UX ownership is outside this package.
+- Backend service authority remains in `finaticAPI`.

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

@@ -1,5 +1,4 @@
-"""
-Finatic Server Python SDK
+"""Finatic Server Python SDK
 
 This package re-exports everything from src to provide a clean import path:
     from finatic_server_python import FinaticServer

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "finatic-server-python"
-version = "0.9.9"
+version = "0.9.11"
 description = "Python SDK for Finatic Server API"
 authors = [{ name = "Finatic", email = "support@finatic.dev" }]
 license = { text = "PROPRIETARY" }
@@ -77,6 +77,7 @@ line_length = 88
 python_version = "3.12"
 warn_return_any = true
 warn_unused_configs = true
+exclude = "(?x)(^tests/|^demo-app/)"
 # Relaxed settings for generated code
 disallow_untyped_defs = false
 check_untyped_defs = true
@@ -88,24 +89,17 @@ disallow_untyped_decorators = false
 # Show error codes
 show_error_codes = true
 
-# Ignore expected errors in generated OpenAPI code
-# These are limitations of the OpenAPI generator and cannot be fixed
-# We ignore all errors in generated code since they come from the OpenAPI generator
-# and cannot be fixed without modifying the generator itself
+# Generated OpenAPI code and smoke tests are not held to the same mypy bar as hand-written SDK code.
 [[tool.mypy.overrides]]
-module = [
-    "src.generated.api.*",
-    "src.generated.models.*",
-    "src.generated.api_client",
-    "src.generated.wrappers.*",
-]
-# Ignore all errors in generated code - these are expected limitations
+module = ["src.openapi.generated.*"]
 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.flake8]
@@ -119,7 +113,14 @@ exclude = [
     "*.egg-info",
     ".venv",
     "venv",
-    "src/generated",
+    "src/openapi/generated",
 ]
 import-order-style = "google"
 application-import-names = ["src"]
+
+[tool.ruff]
+exclude = ["src/openapi/generated"]
+
+[tool.ruff.lint.per-file-ignores]
+# Star re-exports from optional custom/generated subpackages; names are re-exported intentionally.
+"src/__init__.py" = ["F403", "F401", "F405"]

{finatic_server_python-0.9.9 → finatic_server_python-0.9.11}/pytest.ini

@@ -2,4 +2,5 @@
 asyncio_mode = auto
 testpaths = tests
 python_files = test_*.py
+pythonpath = .
 addopts = --cov=src --cov-report=term-missing --cov-report=html

finatic_server_python-0.9.11/src/FinaticServer.py

@@ -0,0 +1,9 @@
+"""Hand-authored FinaticServer extension."""
+
+from .FinaticServerCore import FinaticServer as GeneratedFinaticServer
+
+
+class FinaticServer(GeneratedFinaticServer):
+    """Hand-authored FinaticServer class."""
+
+    __CUSTOM_CLASS__ = True