finatic-server-python 0.1.6__tar.gz → 0.9.0__tar.gz

finatic_server_python-0.9.0/.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{ts,tsx,js,jsx,json}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

finatic_server_python-0.9.0/.gitignore

@@ -0,0 +1,101 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build outputs
+dist/
+build/
+*.tsbuildinfo
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+.nyc_output/
+junit.xml
+
+# Logs
+logs/
+*.log
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# Yarn lock file
+yarn.lock
+
+# parcel-bundler cache
+.cache
+.parcel-cache
+
+# Serverless directories
+.serverless
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Python specific
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+ENV/
+env/
+.pytest_cache/
+.mypy_cache/
+.coverage
+htmlcov/

finatic_server_python-0.9.0/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial release
+
+## [0.1.0] - YYYY-MM-DD
+
+### Added
+- Initial SDK release

finatic_server_python-0.9.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: finatic-server-python
+Version: 0.9.0
+Summary: Python SDK for Finatic Server API
+Project-URL: Homepage, https://github.com/finatic/finatic-server-python
+Project-URL: Documentation, https://docs.finatic.com/python
+Project-URL: Repository, https://github.com/finatic/finatic-server-python
+Project-URL: Issues, https://github.com/finatic/finatic-server-python/issues
+Author-email: Finatic <support@finatic.dev>
+License: MIT
+Keywords: api,finance,finatic,sdk,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT 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.8.1
+Requires-Dist: aiohttp-retry>=2.8.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: cachetools>=5.3.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: structlog>=23.2.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: typing-extensions>=4.0.0
+Requires-Dist: urllib3>=1.25.0
+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
+
+# Python
+
+Python SDK for Finatic Server API
+
+## Installation
+
+```bash
+npm install @finatic/server-node
+```
+
+## Quick Start
+
+```typescript
+import { FinaticServer} from '@finatic/server-node';
+
+// TODO: Add example usage
+```
+
+## Documentation
+
+Full documentation is available at [docs.finatic.com](/server/typescript).
+
+## Development
+
+```bash
+# Install dependencies
+uv sync --dev
+
+# Build
+uv build
+
+# Run tests
+pytest
+
+# Format code
+black src tests
+isort src tests
+
+# Lint
+flake8 src tests
+```
+
+## Quality Checks
+
+Run all quality checks to ensure code quality:
+
+```bash
+# Run all quality checks (format, lint, type check, import check)
+python quality_check.py
+# or
+uv run python quality_check.py
+
+# Fix all auto-fixable issues (format, import sort)
+python quality_check.py --fix
+# or
+uv run python quality_check.py --fix
+```
+
+Individual quality checks:
+
+```bash
+# Format check (black)
+black --check src tests
+# Format fix (modifies files)
+black src tests
+
+# Import sort check
+isort --check-only src tests
+# Import sort fix (modifies files)
+isort src tests
+
+# Lint & import check (flake8)
+flake8 src tests
+
+# Type check (mypy)
+mypy src
+```
+
+## License
+
+MIT

finatic_server_python-0.9.0/README.md

@@ -0,0 +1,81 @@
+# Python
+
+Python SDK for Finatic Server API
+
+## Installation
+
+```bash
+npm install @finatic/server-node
+```
+
+## Quick Start
+
+```typescript
+import { FinaticServer} from '@finatic/server-node';
+
+// TODO: Add example usage
+```
+
+## Documentation
+
+Full documentation is available at [docs.finatic.com](/server/typescript).
+
+## Development
+
+```bash
+# Install dependencies
+uv sync --dev
+
+# Build
+uv build
+
+# Run tests
+pytest
+
+# Format code
+black src tests
+isort src tests
+
+# Lint
+flake8 src tests
+```
+
+## Quality Checks
+
+Run all quality checks to ensure code quality:
+
+```bash
+# Run all quality checks (format, lint, type check, import check)
+python quality_check.py
+# or
+uv run python quality_check.py
+
+# Fix all auto-fixable issues (format, import sort)
+python quality_check.py --fix
+# or
+uv run python quality_check.py --fix
+```
+
+Individual quality checks:
+
+```bash
+# Format check (black)
+black --check src tests
+# Format fix (modifies files)
+black src tests
+
+# Import sort check
+isort --check-only src tests
+# Import sort fix (modifies files)
+isort src tests
+
+# Lint & import check (flake8)
+flake8 src tests
+
+# Type check (mypy)
+mypy src
+```
+
+## License
+
+MIT

finatic_server_python-0.9.0/demo-app/README.md

@@ -0,0 +1,115 @@
+# Finatic Python Server SDK Demo App
+
+This demo application showcases the Finatic Python Server SDK with both CLI and API server capabilities.
+
+## Features
+
+- **CLI Demo**: Interactive command-line demo (existing)
+- **API Server**: FastAPI server that provides endpoints matching the Client SDK interface
+
+## Setup
+
+1. **Install dependencies with uv** (recommended):
+
+   ```bash
+   uv sync
+   ```
+
+   Or with pip:
+
+   ```bash
+   pip install -e .
+   ```
+
+2. **Configure environment**:
+   ```bash
+   cp env.example .env
+   # Edit .env with your FINATIC_API_KEY
+   ```
+
+## Running the API Server
+
+The API server runs on port **8002** and provides endpoints that match the Client SDK interface.
+
+### Development Mode
+
+**Option 1: Using the convenience script (recommended)**:
+
+```bash
+uv run python run_api.py
+```
+
+**Option 2: Direct uvicorn**:
+
+```bash
+uv run uvicorn api_server:app --host 0.0.0.0 --port 8002 --reload
+```
+
+**Option 3: Direct Python**:
+
+```bash
+uv run python api_server.py
+```
+
+### Production Mode
+
+```bash
+uv run uvicorn api_server:app --host 0.0.0.0 --port 8002
+```
+
+The server will be available at `http://localhost:8002` and includes:
+
+- CORS support for `http://localhost:3000` (Client SDK demo app)
+- Health check endpoint at `/api/health`
+- All Client SDK method endpoints under `/api/`
+
+## API Endpoints
+
+### Session Management
+
+- `POST /api/session/start` - Start new session
+- `POST /api/session/authenticate` - Authenticate with user ID
+- `GET /api/session/user` - Get session user info
+- `GET /api/session/user-id` - Get current user ID
+- `GET /api/session/is-authed` - Check authentication status
+
+### Broker Data
+
+- `GET /api/broker/list` - Get available brokers
+- `GET /api/broker/connections` - Get broker connections
+- `GET /api/broker/accounts` - Get accounts (paginated)
+- `GET /api/broker/accounts/all` - Get all accounts
+- `POST /api/broker/disconnect` - Disconnect company
+
+### Trading Data
+
+- `GET /api/trading/orders` - Get orders (paginated)
+- `GET /api/trading/orders/all` - Get all orders
+- `GET /api/trading/positions` - Get positions (paginated)
+- `GET /api/trading/positions/all` - Get all positions
+- `GET /api/trading/balances` - Get balances (paginated)
+- `GET /api/trading/balances/all` - Get all balances
+
+### Trading Context
+
+- `POST /api/trading/context/broker` - Set trading broker
+- `POST /api/trading/context/account` - Set trading account
+- `GET /api/trading/context` - Get trading context
+
+### Order Management
+
+- `POST /api/trading/order` - Place new order
+- `POST /api/trading/order/cancel` - Cancel order
+- `POST /api/trading/order/modify` - Modify order
+
+## Integration with Client SDK Demo
+
+This API server is designed to work with the Client SDK demo app's SDK switcher. When you select "Python Server SDK" in the demo app settings, it will connect to this server on port 3001.
+
+## CLI Demo
+
+The original CLI demo is still available:
+
+```bash
+uv run python test_trading.py
+```