Tepilora 0.3.1__tar.gz

tepilora-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Tepilora
+
+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.

tepilora-0.3.1/MANIFEST.in

@@ -0,0 +1,13 @@
+# Include package files
+recursive-include Tepilora *.py *.pyi py.typed
+
+# Exclude dev/internal files from distribution
+exclude CLAUDE.md
+exclude RELEASING.md
+prune scripts
+prune schema
+prune tests
+prune examples
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude .git*

tepilora-0.3.1/PKG-INFO

@@ -0,0 +1,300 @@
+Metadata-Version: 2.2
+Name: Tepilora
+Version: 0.3.1
+Summary: Python SDK for Tepilora API v3
+Author-email: Tepilora <info@tepiloradata.com>
+License: MIT
+Project-URL: Homepage, https://tepiloradata.com
+Project-URL: Repository, https://github.com/Admintepilora/tepilora-python
+Project-URL: Issues, https://github.com/Admintepilora/tepilora-python/issues
+Keywords: tepilora,finance,api,sdk,portfolio,analytics
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.26.0
+Provides-Extra: arrow
+Requires-Dist: pyarrow>=12; extra == "arrow"
+Provides-Extra: polars
+Requires-Dist: polars>=0.20; extra == "polars"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: httpx>=0.26.0; extra == "dev"
+
+# Tepilora SDK (Python)
+
+SDK Python (sync + async) per Tepilora API v3.
+
+**218 operazioni** in **23 namespace** auto-generati dal registry.
+
+## Install
+
+```bash
+pip install Tepilora
+```
+
+Optional extras:
+```bash
+pip install 'Tepilora[arrow]'   # PyArrow per formati binari
+pip install 'Tepilora[polars]'  # Polars DataFrame support
+```
+
+## Quick Start
+
+```python
+import Tepilora as T
+
+client = T.TepiloraClient(api_key="YOUR_KEY")
+
+# Typed endpoints (IDE autocomplete)
+securities = client.securities.search(query="MSCI ETF", limit=10)
+print(securities["totalCount"])
+
+# Raw call
+resp = client.call("securities.search", params={"query": "MSCI", "limit": 5})
+print(resp.data)
+```
+
+## Async
+
+```python
+import asyncio
+import Tepilora as T
+
+async def main():
+    async with T.AsyncTepiloraClient(api_key="YOUR_KEY") as client:
+        data = await client.securities.search(query="MSCI", limit=10)
+        print(data)
+
+asyncio.run(main())
+```
+
+## Namespaces
+
+| Namespace | Operazioni | Descrizione |
+|-----------|------------|-------------|
+| `securities` | 12 | Search, filter, history, facets, MiFID, fees |
+| `news` | 7 | Search, latest, trending, details |
+| `publications` | 5 | Research reports and publications |
+| `portfolio` | 19 | CRUD, returns, attribution, optimization |
+| `analytics` | 68 | Rolling metrics, ratios, risk, factors |
+| `alerts` | 9 | Alert rules CRUD, evaluate, history |
+| `macro` | 6 | Economic indicators, calendar |
+| `stocks` | 9 | Technicals, screening, peers, signals |
+| `bonds` | 7 | Analyze, screen, ladder, curve, spread |
+| `options` | 6 | Pricing, Greeks, IV, strategies |
+| `esg` | 5 | ESG scores, screening, comparison |
+| `factors` | 3 | Fama-French, momentum, factor loading |
+| `fh` | 7 | Fundamentals history, financials |
+| `clients` | 8 | B2B client management |
+| `profiling` | 10 | MiFID questionnaires, suitability |
+| `billing` | 10 | Fee calculations, schedules, records |
+| `documents` | 4 | Document parsing, classification |
+| `alternatives` | 9 | Alternative investments |
+| `queries` | 8 | Saved queries CRUD, execute |
+| `search` | 1 | Global search |
+| `data` | 1 | Raw data access |
+| `exports` | 2 | Data export to file formats |
+
+## Esempi per Namespace
+
+### Securities
+
+```python
+# Search
+results = client.securities.search(query="MSCI World", limit=20)
+
+# Get details
+details = client.securities.description(identifier="IE00B4L5Y983EURXMIL")
+
+# Price history
+history = client.securities.history(
+    identifiers=["IE00B4L5Y983EURXMIL", "FR0010655712EURXPAR"],
+    start_date="2024-01-01",
+    limit=1000
+)
+
+# Filter by criteria
+filtered = client.securities.filter(filters={"Currency": "EUR", "TepiloraType": "ETF"})
+
+# Get facets for building filters
+facets = client.securities.facets(fields=["Currency", "TepiloraType", "Country"])
+```
+
+### Portfolio
+
+```python
+# Create portfolio
+portfolio = client.portfolio.create(
+    name="My Portfolio",
+    input_type="fixed_weights",
+    input_data={"IE00B4L5Y983EURXMIL": 0.6, "FR0010655712EURXPAR": 0.4}
+)
+
+# Get returns
+returns = client.portfolio.returns(
+    id=portfolio["id"],
+    start_date="2024-01-01",
+    return_method="twr"
+)
+
+# Performance attribution
+attribution = client.portfolio.attribution(id=portfolio["id"])
+
+# Optimize
+optimized = client.portfolio.optimize(
+    id=portfolio["id"],
+    objective="max_sharpe",
+    constraints={"max_weight": 0.3}
+)
+```
+
+### Analytics
+
+```python
+# List available functions
+functions = client.analytics.list()
+
+# Get function help
+help_info = client.analytics.help("rolling_volatility")
+
+# Calculate rolling volatility
+vol = client.analytics.rolling_volatility(
+    identifiers="IE00B4L5Y983EURXMIL",
+    period=252,
+    start_date="2023-01-01"
+)
+
+# Rolling Sharpe ratio
+sharpe = client.analytics.rolling_sharpe(
+    identifiers="IE00B4L5Y983EURXMIL",
+    period=252,
+    rf=0.02
+)
+
+# Factor regression
+factors = client.analytics.factor_regression(
+    identifiers="IE00B4L5Y983EURXMIL",
+    model="FF5"
+)
+```
+
+### News & Publications
+
+```python
+# Search news
+news = client.news.search(query="bitcoin", limit=20)
+
+# Latest news
+latest = client.news.latest(limit=10)
+
+# Trending topics
+trending = client.news.trending(limit=50, finance_only=True)
+
+# Search publications
+pubs = client.publications.search(query="market outlook", limit=10)
+```
+
+### Alerts
+
+```python
+# Create alert
+alert = client.alerts.create(
+    name="Price Alert",
+    condition={"type": "price_change", "threshold": 5.0},
+    action={"type": "webhook", "url": "https://..."}
+)
+
+# List alerts
+alerts = client.alerts.list(enabled=True)
+
+# Evaluate manually
+result = client.alerts.evaluate(rule_id=alert["id"])
+```
+
+### Bonds
+
+```python
+# Analyze bond
+analysis = client.bonds.analyze(
+    identifier="XS1234567890",
+    price=98.5,
+    settlement_date="2024-02-01"
+)
+
+# Screen bonds
+bonds = client.bonds.screen(
+    criteria={"min_yield": 4.0, "max_duration": 5.0},
+    limit=50
+)
+
+# Get yield curve
+curve = client.bonds.curve(currency="EUR", date="2024-01-15")
+```
+
+## Arrow/Binary Formats
+
+```python
+from Tepilora.arrow import read_ipc_stream
+
+# Request Arrow format
+resp = client.call_arrow_ipc_stream("securities.search", params={"query": "ETF", "limit": 1000})
+table = read_ipc_stream(resp.content)
+print(table.to_pandas())
+```
+
+## Module-Level API
+
+```python
+import Tepilora as T
+
+# Configure globally
+T.configure(api_key="YOUR_KEY")
+
+# Use without client instance
+T.analytics.rolling_volatility(identifiers="IE00B4L5Y983EURXMIL")
+```
+
+Or via environment variables:
+```bash
+export TEPILORA_API_KEY=your_key
+export TEPILORA_BASE_URL=https://tepiloradata.com
+```
+
+## Error Handling
+
+```python
+from Tepilora.errors import TepiloraAPIError
+
+try:
+    data = client.securities.search(query="invalid")
+except TepiloraAPIError as e:
+    print(f"Error: {e.message}")
+    print(f"Code: {e.code}")
+```
+
+## API Endpoints
+
+- `POST /T-Api/v3` - Unified action router (all operations)
+- `GET /T-Api/v3/health` - Health check
+- `GET /T-Api/v3/pricing` - Pricing info
+- `GET /T-Api/v3/logs/status` - Logs status
+
+## Version
+
+```python
+import Tepilora
+print(Tepilora.__version__)  # 0.3.0
+```

tepilora-0.3.1/README.md

@@ -0,0 +1,265 @@
+# Tepilora SDK (Python)
+
+SDK Python (sync + async) per Tepilora API v3.
+
+**218 operazioni** in **23 namespace** auto-generati dal registry.
+
+## Install
+
+```bash
+pip install Tepilora
+```
+
+Optional extras:
+```bash
+pip install 'Tepilora[arrow]'   # PyArrow per formati binari
+pip install 'Tepilora[polars]'  # Polars DataFrame support
+```
+
+## Quick Start
+
+```python
+import Tepilora as T
+
+client = T.TepiloraClient(api_key="YOUR_KEY")
+
+# Typed endpoints (IDE autocomplete)
+securities = client.securities.search(query="MSCI ETF", limit=10)
+print(securities["totalCount"])
+
+# Raw call
+resp = client.call("securities.search", params={"query": "MSCI", "limit": 5})
+print(resp.data)
+```
+
+## Async
+
+```python
+import asyncio
+import Tepilora as T
+
+async def main():
+    async with T.AsyncTepiloraClient(api_key="YOUR_KEY") as client:
+        data = await client.securities.search(query="MSCI", limit=10)
+        print(data)
+
+asyncio.run(main())
+```
+
+## Namespaces
+
+| Namespace | Operazioni | Descrizione |
+|-----------|------------|-------------|
+| `securities` | 12 | Search, filter, history, facets, MiFID, fees |
+| `news` | 7 | Search, latest, trending, details |
+| `publications` | 5 | Research reports and publications |
+| `portfolio` | 19 | CRUD, returns, attribution, optimization |
+| `analytics` | 68 | Rolling metrics, ratios, risk, factors |
+| `alerts` | 9 | Alert rules CRUD, evaluate, history |
+| `macro` | 6 | Economic indicators, calendar |
+| `stocks` | 9 | Technicals, screening, peers, signals |
+| `bonds` | 7 | Analyze, screen, ladder, curve, spread |
+| `options` | 6 | Pricing, Greeks, IV, strategies |
+| `esg` | 5 | ESG scores, screening, comparison |
+| `factors` | 3 | Fama-French, momentum, factor loading |
+| `fh` | 7 | Fundamentals history, financials |
+| `clients` | 8 | B2B client management |
+| `profiling` | 10 | MiFID questionnaires, suitability |
+| `billing` | 10 | Fee calculations, schedules, records |
+| `documents` | 4 | Document parsing, classification |
+| `alternatives` | 9 | Alternative investments |
+| `queries` | 8 | Saved queries CRUD, execute |
+| `search` | 1 | Global search |
+| `data` | 1 | Raw data access |
+| `exports` | 2 | Data export to file formats |
+
+## Esempi per Namespace
+
+### Securities
+
+```python
+# Search
+results = client.securities.search(query="MSCI World", limit=20)
+
+# Get details
+details = client.securities.description(identifier="IE00B4L5Y983EURXMIL")
+
+# Price history
+history = client.securities.history(
+    identifiers=["IE00B4L5Y983EURXMIL", "FR0010655712EURXPAR"],
+    start_date="2024-01-01",
+    limit=1000
+)
+
+# Filter by criteria
+filtered = client.securities.filter(filters={"Currency": "EUR", "TepiloraType": "ETF"})
+
+# Get facets for building filters
+facets = client.securities.facets(fields=["Currency", "TepiloraType", "Country"])
+```
+
+### Portfolio
+
+```python
+# Create portfolio
+portfolio = client.portfolio.create(
+    name="My Portfolio",
+    input_type="fixed_weights",
+    input_data={"IE00B4L5Y983EURXMIL": 0.6, "FR0010655712EURXPAR": 0.4}
+)
+
+# Get returns
+returns = client.portfolio.returns(
+    id=portfolio["id"],
+    start_date="2024-01-01",
+    return_method="twr"
+)
+
+# Performance attribution
+attribution = client.portfolio.attribution(id=portfolio["id"])
+
+# Optimize
+optimized = client.portfolio.optimize(
+    id=portfolio["id"],
+    objective="max_sharpe",
+    constraints={"max_weight": 0.3}
+)
+```
+
+### Analytics
+
+```python
+# List available functions
+functions = client.analytics.list()
+
+# Get function help
+help_info = client.analytics.help("rolling_volatility")
+
+# Calculate rolling volatility
+vol = client.analytics.rolling_volatility(
+    identifiers="IE00B4L5Y983EURXMIL",
+    period=252,
+    start_date="2023-01-01"
+)
+
+# Rolling Sharpe ratio
+sharpe = client.analytics.rolling_sharpe(
+    identifiers="IE00B4L5Y983EURXMIL",
+    period=252,
+    rf=0.02
+)
+
+# Factor regression
+factors = client.analytics.factor_regression(
+    identifiers="IE00B4L5Y983EURXMIL",
+    model="FF5"
+)
+```
+
+### News & Publications
+
+```python
+# Search news
+news = client.news.search(query="bitcoin", limit=20)
+
+# Latest news
+latest = client.news.latest(limit=10)
+
+# Trending topics
+trending = client.news.trending(limit=50, finance_only=True)
+
+# Search publications
+pubs = client.publications.search(query="market outlook", limit=10)
+```
+
+### Alerts
+
+```python
+# Create alert
+alert = client.alerts.create(
+    name="Price Alert",
+    condition={"type": "price_change", "threshold": 5.0},
+    action={"type": "webhook", "url": "https://..."}
+)
+
+# List alerts
+alerts = client.alerts.list(enabled=True)
+
+# Evaluate manually
+result = client.alerts.evaluate(rule_id=alert["id"])
+```
+
+### Bonds
+
+```python
+# Analyze bond
+analysis = client.bonds.analyze(
+    identifier="XS1234567890",
+    price=98.5,
+    settlement_date="2024-02-01"
+)
+
+# Screen bonds
+bonds = client.bonds.screen(
+    criteria={"min_yield": 4.0, "max_duration": 5.0},
+    limit=50
+)
+
+# Get yield curve
+curve = client.bonds.curve(currency="EUR", date="2024-01-15")
+```
+
+## Arrow/Binary Formats
+
+```python
+from Tepilora.arrow import read_ipc_stream
+
+# Request Arrow format
+resp = client.call_arrow_ipc_stream("securities.search", params={"query": "ETF", "limit": 1000})
+table = read_ipc_stream(resp.content)
+print(table.to_pandas())
+```
+
+## Module-Level API
+
+```python
+import Tepilora as T
+
+# Configure globally
+T.configure(api_key="YOUR_KEY")
+
+# Use without client instance
+T.analytics.rolling_volatility(identifiers="IE00B4L5Y983EURXMIL")
+```
+
+Or via environment variables:
+```bash
+export TEPILORA_API_KEY=your_key
+export TEPILORA_BASE_URL=https://tepiloradata.com
+```
+
+## Error Handling
+
+```python
+from Tepilora.errors import TepiloraAPIError
+
+try:
+    data = client.securities.search(query="invalid")
+except TepiloraAPIError as e:
+    print(f"Error: {e.message}")
+    print(f"Code: {e.code}")
+```
+
+## API Endpoints
+
+- `POST /T-Api/v3` - Unified action router (all operations)
+- `GET /T-Api/v3/health` - Health check
+- `GET /T-Api/v3/pricing` - Pricing info
+- `GET /T-Api/v3/logs/status` - Logs status
+
+## Version
+
+```python
+import Tepilora
+print(Tepilora.__version__)  # 0.3.0
+```

tepilora-0.3.1/Tepilora/__init__.py

@@ -0,0 +1,45 @@
+from .client import AsyncTepiloraClient, TepiloraClient
+from ._default_client import close_default_client, configure_default_client
+from .errors import TepiloraAPIError, TepiloraError
+from .models import V3BinaryMeta, V3BinaryResponse, V3Meta, V3Request, V3Response
+from .version import __version__
+
+from .analytics import AnalyticsAPI, AnalyticsFunction, analytics
+from .capabilities import (
+    capabilities,
+    list_namespaces,
+    list_operations,
+    get_operation_info,
+)
+
+
+def configure(**kwargs) -> TepiloraClient:
+    """
+    Configure the module-level default client used by `Tepilora.analytics.*`.
+
+    Args are passed to `TepiloraClient(...)` (e.g. api_key, base_url, timeout).
+    """
+    return configure_default_client(**kwargs)
+
+
+__all__ = [
+    "AsyncTepiloraClient",
+    "AnalyticsAPI",
+    "AnalyticsFunction",
+    "TepiloraAPIError",
+    "TepiloraClient",
+    "TepiloraError",
+    "V3BinaryMeta",
+    "V3BinaryResponse",
+    "V3Meta",
+    "V3Request",
+    "V3Response",
+    "__version__",
+    "analytics",
+    "capabilities",
+    "configure",
+    "close_default_client",
+    "get_operation_info",
+    "list_namespaces",
+    "list_operations",
+]

tepilora-0.3.1/Tepilora/_default_client.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+import threading
+from typing import Optional
+
+from .client import TepiloraClient
+
+_lock = threading.RLock()
+_default_client: Optional[TepiloraClient] = None
+
+
+def get_default_client() -> TepiloraClient:
+    """
+    Get or create the default global client (thread-safe).
+
+    Uses double-check locking pattern with RLock for thread safety.
+    """
+    global _default_client
+    if _default_client is None:
+        with _lock:
+            if _default_client is None:  # Double-check
+                _default_client = TepiloraClient()
+    return _default_client
+
+
+def configure_default_client(**kwargs) -> TepiloraClient:
+    """
+    Configure the module-level default client used by `Tepilora.analytics.*`.
+
+    Thread-safe: uses swap-close pattern to avoid closing while other threads use it.
+
+    Example:
+        import Tepilora as T
+        T.configure(api_key="...", base_url="https://api.tepiloradata.com")
+        T.analytics.rolling_volatility(...)
+    """
+    global _default_client
+    new_client = TepiloraClient(**kwargs)
+    with _lock:
+        old = _default_client
+        _default_client = new_client
+    # Close old client OUTSIDE the lock to avoid holding lock during I/O
+    if old is not None:
+        old.close()
+    return new_client
+
+
+def close_default_client() -> None:
+    """
+    Close and clear the default client (thread-safe).
+
+    Uses swap-close pattern: swaps to None under lock, then closes outside lock.
+    """
+    global _default_client
+    with _lock:
+        old = _default_client
+        _default_client = None
+    # Close OUTSIDE the lock
+    if old is not None:
+        old.close()