roboquant 2.2.0__tar.gz → 2.3.1__tar.gz

{roboquant-2.2.0 → roboquant-2.3.1}/PKG-INFO

@@ -1,43 +1,43 @@
 Metadata-Version: 2.4
 Name: roboquant
-Version: 2.2.0
+Version: 2.3.1
 Summary: A fast algorithmic trading platform with support for AI based strategies
-Project-URL: Homepage, https://roboquant.org
-Project-URL: Repository, https://github.com/neurallayer/roboquant.py.git
-Project-URL: Issues, https://github.com/neurallayer/roboquant.py/issues
+Keywords: algorithmic,trading,machine learning,AI,investment,finance,crypto,stocks,exchange,forex
+Author: roboquant team
 Author-email: roboquant team <info@roboquant.org>
 License-Expression: Apache-2.0
 License-File: LICENSE
-Keywords: AI,algorithmic,crypto,exchange,finance,forex,investment,machine learning,stocks,trading
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Office/Business :: Financial :: Investment
-Requires-Python: <3.15,>=3.12
 Requires-Dist: numpy>2.0.0
-Requires-Dist: pyarrow>24.0.0
 Requires-Dist: requests>2.30.0
-Requires-Dist: ta-lib==0.6.5
 Requires-Dist: yfinance>1.5.0
+Requires-Dist: pyarrow>24.0.0
+Requires-Dist: ta-lib==0.6.5
+Requires-Dist: torch>=2.9.0 ; extra == 'ai'
+Requires-Dist: tensorboard>=2.21.0 ; extra == 'ai'
+Requires-Dist: stable-baselines3>=2.9.0 ; extra == 'ai'
+Requires-Dist: sb3-contrib>=2.9.0 ; extra == 'ai'
+Requires-Dist: alpaca-py>=0.43.5 ; extra == 'alpaca'
+Requires-Dist: ccxt>=4.5.65 ; extra == 'crypto'
+Requires-Dist: ibind[oauth]>=0.1.22 ; extra == 'ibkr'
+Requires-Python: >=3.12, <3.15
+Project-URL: Homepage, https://roboquant.org
+Project-URL: Repository, https://github.com/neurallayer/roboquant.py.git
+Project-URL: Issues, https://github.com/neurallayer/roboquant.py/issues
 Provides-Extra: ai
-Requires-Dist: sb3-contrib>=2.9.0; extra == 'ai'
-Requires-Dist: stable-baselines3>=2.9.0; extra == 'ai'
-Requires-Dist: tensorboard>=2.21.0; extra == 'ai'
-Requires-Dist: torch>=2.9.0; extra == 'ai'
 Provides-Extra: alpaca
-Requires-Dist: alpaca-py>=0.43.5; extra == 'alpaca'
 Provides-Extra: crypto
-Requires-Dist: ccxt>=4.5.65; extra == 'crypto'
 Provides-Extra: ibkr
-Requires-Dist: ibind[oauth]>=0.1.22; extra == 'ibkr'
 Description-Content-Type: text/markdown
 
 

{roboquant-2.2.0 → roboquant-2.3.1}/pyproject.toml

@@ -2,11 +2,8 @@
 line-length = 127
 
 [build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.version]
-path = "roboquant/__init__.py"
+requires = ["uv_build>=0.11.28,<0.12"]
+build-backend = "uv_build"
 
 [tool.ruff.lint]
 select = ["E", "F", "W"]
@@ -16,9 +13,13 @@ typeCheckingMode = "standard"
 reportPrivateImportUsage = "none" 
 # typeCheckingMode = "strict"
 
+[tool.uv.build-backend]
+module-root = ""
+module-name = "roboquant"
+
 [project]
 name = "roboquant"
-dynamic = ["version"]
+version = "2.3.1"
 authors = [{ name = "roboquant team", email = "info@roboquant.org" }]
 description = "A fast algorithmic trading platform with support for AI based strategies"
 readme = "README.md"
@@ -34,7 +35,6 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
-  "License :: OSI Approved :: Apache Software License",
   "Operating System :: OS Independent",
   "Topic :: Office/Business :: Financial",
   "Topic :: Office/Business :: Financial :: Investment",

{roboquant-2.2.0 → roboquant-2.3.1}/roboquant/__init__.py

@@ -3,10 +3,6 @@ The `roboquant` package contains the `run` method and a number of shared classes
 like `Account`, `Asset` and `Event`.
 """
 
-__version__ = "2.2.0"
-
-import logging
-
 from roboquant import brokers
 from roboquant import feeds
 from roboquant import journals
@@ -22,9 +18,6 @@ from .asset import Asset, Stock, Crypto, Forex, Option
 from .run import run
 from .timeframe import Timeframe, utcnow
 
-logger = logging.getLogger(__name__)
-logger.info("roboquant version=%s", __version__)
-
 __all__ = [
     "brokers",
     "feeds",

roboquant-2.2.0/.github/workflows/verify.yml

@@ -1,46 +0,0 @@
-# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
-
-name: Verify roboquant 
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-env:
-  PYRIGHT_PYTHON_FORCE_VERSION: latest
-
-jobs:
-  verify:
-
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-24.04, windows-latest, macos-latest]
-        python-version: ["3.12", "3.13"]
- 
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v7
-
-    - name: Install uv
-      uses: astral-sh/setup-uv@v7
-      with:
-          ignore-nothing-to-cache: true
-          python-version: ${{ matrix.python-version }}
-
-    - name: Install the project
-      run: uv sync --all-extras --no-dev
-
-    - name: Run ruff checking
-      run: uvx ruff check
-
-    - name: Run pyright
-      run: uv run pyright tests roboquant
-
-    - name: Run unit tests
-      run: uv run --no-dev python -m unittest discover -s tests/unit
-
-  

roboquant-2.2.0/.gitignore

@@ -1,15 +0,0 @@
-__pycache__
-runs/
-.idea/
-*.db
-scratch/
-dist/
-roboquant.egg-info/
-build/
-.venv/
-.ipynb_checkpoints/
-*.ipynb
-.ruff_cache/
-.pytest_cache/
-.env
-.DS_Store

roboquant-2.2.0/.vscode/settings.json

@@ -1,39 +0,0 @@
-{
-    "cSpell.words": [
-        "annualize",
-        "dataframe",
-        "dtype",
-        "hstack",
-        "ibkr",
-        "ohlcv",
-        "optim",
-        "pnlmetric",
-        "prettytable",
-        "roboquant",
-        "stooq",
-        "Tensorboard",
-        "Tiingo",
-        "timeframes"
-    ],
-    "python.testing.unittestArgs": [
-        "-v",
-        "-p",
-        "test_*.py"
-    ],
-    "__python.testing.unittestArgs": [
-        "-v",
-        "-s",
-        "./tests/unit",
-        "-p",
-        "test_*.py"
-    ],
-    "__python.testing.pytestArgs": [
-        "--ignore=tests/integration",
-        "--ignore=tests/performance"
-    ],
-    "python.testing.pytestEnabled": false,
-    "python.testing.unittestEnabled": true,
-    "[python]": {
-        "editor.defaultFormatter": "charliermarsh.ruff"
-    }
-}

roboquant-2.2.0/.zed/settings.json

@@ -1,21 +0,0 @@
-{
-  "languages": {
-    "Python": {
-      "language_servers": ["pyright"],
-      "tasks": {
-        "variables": {
-          "TEST_RUNNER": "unittest",
-        },
-      },
-    },
-  },
-  "lsp": {
-    "pyright": {
-      "settings": {
-        "python": {
-          "pythonPath": ".venv/bin/python",
-        },
-      },
-    },
-  },
-}

roboquant-2.2.0/.zed/tasks.json

@@ -1,30 +0,0 @@
-// Project tasks configuration. See https://zed.dev/docs/tasks for documentation.
-//
-// Example:
-[
-  {
-    "label": "run unit test",
-    "command": "uv run python -m unittest discover -s tests/unit",
-    "show_command": false,
-  },
-  {
-    "label": "run pyright",
-    "command": "uv run pyright tests roboquant",
-    "show_command": false,
-  },
-  {
-    "label": "uv sync",
-    "command": "uv sync --all-extras --dev",
-    "show_command": false,
-  },
-  {
-    "label": "uv ruff",
-    "command": "uvx ruff check",
-    "show_command": false,
-  },
-  {
-    "label": "run pyright",
-    "command": "uv run pyright tests roboquant",
-    "show_command": false,
-  },
-]

roboquant-2.2.0/bin/local_install.sh

@@ -1,19 +0,0 @@
-
-[[ ! -f "LICENSE" ]] && echo "run the script from the project root directory like this: ./bin/local_install.sh" && exit 1
-export PYRIGHT_PYTHON_FORCE_VERSION="latest"
-
-rm -rf ./runs
-
-uv sync --all-extras --dev
-
-# QA
-uvx ruff check || exit 1
-uv run python -m unittest discover -s tests/unit || exit 1
-
-# Build the package
-rm -rf dist
-uv build || exit 1
-
-# Install the just build package
-uv pip install dist/*.whl
-

roboquant-2.2.0/bin/publish.sh

@@ -1,24 +0,0 @@
-
-[[ ! -f "LICENSE" ]] && echo "run the script from the project root directory like this: ./bin/publish.sh" && exit 1
-export PYRIGHT_PYTHON_FORCE_VERSION="latest"
-
-rm -rf ./runs
-
-uv sync --all-extras --dev
-
-# QA
-uvx ruff check
-uv run pyright tests roboquant || exit 1
-uv run python -m unittest discover -s tests/unit || exit 1
-
-# Build
-rm -rf dist
-uv build || exit 1
-
-# Publish
-read -p "Publish (y/n)? " ANSWER
-if [ "$ANSWER" = "y" ]; then
-  uv publish; exit 0
-else
-  echo "Not published"; exit 1
-fi

roboquant-2.2.0/bin/verify.sh

@@ -1,13 +0,0 @@
-[[ ! -f "LICENSE" ]] && echo "run the script from the project root directory like this: ./bin/verify.sh" && exit 1
-export PYRIGHT_PYTHON_FORCE_VERSION="latest"
-
-uv sync --all-extras --dev
-
-# QA
-echo "Running ruff" 
-uvx ruff check || exit 1
-uv run pyright tests roboquant || exit 1
-echo "Running unittest" 
-uv run python -m unittest discover -s tests/unit || exit 1
-
-echo "All tests passed"

roboquant-2.2.0/docs/DESIGN.md

@@ -1,85 +0,0 @@
-# Design Principles
-
-## Modular Pipeline Architecture
-
-The library is built around a clean separation of five orthogonal concerns:
-
-| Component | Responsibility | Has access to Account? |
-|-----------|---------------|----------------------|
-| **Feed** | Provides market data events | No |
-| **Strategy** | Generates trading signals from events | No |
-| **Trader** | Converts signals into orders (risk/sizing) | Yes |
-| **Broker** | Executes orders, maintains account state | Yes (owns Account) |
-| **Journal** | Logs/tracks every step (read-only) | Read-only snapshot |
-
-Each component is an abstract base class with pluggable implementations, making every part of the pipeline independently swappable.
-
-## The Run Loop
-
-The core of the system is the `roboquant.run()` function, which connects all components in a streaming event loop:
-
-```
-for each event in feed.play(timeframe):
-    1. broker.sync(event)                   — update account, execute fills
-    2. strategy.create_signals(event)       — generate signals from market data
-    3. trader.create_orders(signals, ...)   — apply risk rules, produce orders
-    4. broker.place_orders(orders)          — submit orders to the broker
-    5. journal.track(event, account, ...)   — record metrics (optional)
-```
-
-### Step-by-step
-
-1. **`broker.sync(event)`** — Updates the account with the latest market data. Open orders from previous steps are tested against prices and executed if conditions are met. No look-ahead bias: orders placed at time `t` only execute at time `t+1`.
-
-2. **`strategy.create_signals(event)`** — The strategy examines the event's price data and returns a list of `Signal` objects. Each signal has an asset, a rating (typically -1.0 to 1.0), and a type (`ENTRY`, `EXIT`, or `ENTRY_EXIT`). Strategies are **pure decision-makers** — they know nothing about cash, positions, or risk.
-
-3. **`trader.create_orders(signals, event, account)`** — The trader applies risk management rules (position sizing, shorting constraints, order limits) and converts signals into concrete `Order` objects. Unlike strategies, traders **have full access to the Account** (cash, positions, buying power).
-
-4. **`broker.place_orders(orders)`** — New orders are submitted to the broker. In `SimBroker`, they are stored and evaluated for execution when the next event arrives.
-
-5. **`journal.track(...)`** — Optional logging and metrics collection. Journals are passive observers that never modify state.
-
-## Minimal Backtest
-
-```python
-import roboquant as rq
-
-feed = rq.feeds.YahooFeed("JPM", "IBM", start_date="2015-01-01")
-account = rq.run(feed, rq.strategies.EMACrossover())
-print(account)
-```
-
-This works because `run()` provides sensible defaults: `SimBroker` (USD 1M deposit, 0% slippage) and `FlexTrader` (conservative position sizing).
-
-## Custom Backtest
-
-```python
-feed = rq.feeds.YahooFeed("AAPL", "MSFT", start_date="2020-01-01")
-strategy = rq.strategies.EMACrossover()
-trader = rq.traders.FlexTrader(max_order_perc=0.1, shorting=True)
-broker = rq.brokers.SimBroker(deposit=500_000)
-journal = rq.journals.MetricsJournal()
-
-account = rq.run(feed, strategy, trader=trader, broker=broker, journal=journal)
-print(account)
-print(journal.metrics())
-```
-
-## Strategy/Trader Separation
-
-This is the most important design choice in the library:
-
-- **Strategies** produce signals from market data only. They implement `create_signals(event) -> list[Signal]` and have no access to account state. This keeps them pure, testable, and reusable across any trader configuration.
-- **Traders** implement `create_orders(signals, event, account) -> list[Order]` and are responsible for risk management, position sizing, and order construction. They know nothing about indicators or market data beyond what is in the signal.
-
-Example: The same `EMACrossover` strategy can be used with a conservative trader (2% max order) in backtesting and a different trader (20% max order, shorting enabled) in live trading — without changing a line of strategy code.
-
-## Key Principles
-
-- **Event-driven streaming** — Everything is built around `Event` objects produced lazily by feeds, supporting both backtesting and live trading with the same pipeline.
-- **Broker owns the Account** — The Account is never modified directly by user code; it is always the broker's canonical view returned by `sync()`.
-- **Default-everywhere** — `roboquant.run(feed, strategy)` works out of the box with sensible defaults, making the simplest case a one-liner.
-- **Immutable core types** — `Asset`, `Signal`, and `Event` are immutable; `Order` uses `cancel()`/`modify()` returning new objects.
-- **Strategy composition** — `MultiStrategy` combines multiple strategies with configurable conflict resolution (`first`, `last`, `mean`, `none`).
-- **Pluggable pricing** — Price type strings (`"OPEN"`, `"CLOSE"`, `"HIGH"`, `"LOW"`, `"DEFAULT"`) allow strategies and traders to choose which price to use for evaluation.
-- **Multi-currency** — Built-in support via `Amount`, `Wallet`, and pluggable `CurrencyConverter` (ECB, static, one-to-one).

roboquant-2.2.0/tests/common.py

@@ -1,84 +0,0 @@
-import math
-import pathlib
-from datetime import date, datetime, timedelta
-from typing import Iterable
-from unittest import TestCase
-
-from roboquant import PriceItem, Bar, Quote, TradePrice, Timeframe
-from roboquant.asset import Asset
-from roboquant.feeds import CSVFeed
-from roboquant.feeds.feed import Feed
-from roboquant.signal import Signal
-from roboquant.strategies.strategy import Strategy
-
-
-def get_feed() -> CSVFeed:
-    """Return a CSV feed based on some stock data in Yahoo format"""
-    root = pathlib.Path(__file__).parent.resolve().joinpath("data", "yahoo")
-    return CSVFeed.yahoo(str(root))
-
-def get_recent_start_date(days: int = 10):
-    """Get a recent (in the past) date"""
-    start = date.today() - timedelta(days=days)
-    return start.strftime("%Y-%m-%d")
-
-
-def run_price_item_feed(
-    feed: Feed, assets: Iterable[Asset], test_case: TestCase, timeframe: Timeframe | None = None, min_items: int = 1
-):
-    """Common test for all feeds that produce price-items. It validates the data and the order of the items"""
-
-    last = datetime.fromisoformat("1900-01-01T00:00:00+00:00")
-    n_items = 0
-    for event in feed.play():
-        test_case.assertIsInstance(event.time, datetime)
-        test_case.assertEqual("UTC", event.time.tzname())
-        test_case.assertGreaterEqual(event.time, last, f"{event} < {last}, items={event.items}")
-        last = event.time
-
-        n_items += len(event.items)
-
-        for item in event.items:
-            test_case.assertIsInstance(item, PriceItem)
-            test_case.assertIsInstance(item.asset, Asset)
-            test_case.assertIn(item.asset, assets)
-
-            match item:
-                case Bar():
-                    ohlcv = item.ohlcv
-                    v = ohlcv[4]
-                    test_case.assertTrue(math.isnan(v) or v >= 0.0)
-                    for i in range(0, 4):
-                        test_case.assertGreaterEqual(ohlcv[1], ohlcv[i])  # High >= OHLC
-                        test_case.assertGreaterEqual(ohlcv[i], ohlcv[2])
-                        test_case.assertGreaterEqual(ohlcv[i], 0.0)
-                case TradePrice():
-                    test_case.assertTrue(math.isfinite(item.trade_price))
-                    test_case.assertTrue(math.isfinite(item.trade_volume))
-                case Quote():
-                    for f in item.data:
-                        test_case.assertTrue(math.isfinite(f))
-                    test_case.assertGreaterEqual(item.data[0], item.data[2])  # ask >= bid
-                case _:
-                    pass
-
-    test_case.assertGreaterEqual(n_items, min_items)
-
-
-def run_strategy(strategy: Strategy, test_case: TestCase):
-    """Run and test a strategy on the default feed"""
-    feed = get_feed()
-    all_assets = feed.assets()
-    total_signals = 0
-    for event in feed.play():
-        signals = strategy.create_signals(event)
-        for signal in signals:
-            asset = signal.asset
-            test_case.assertEqual(type(signal), Signal)
-            test_case.assertEqual(asset.symbol, asset.symbol.upper())
-            test_case.assertIn(asset, all_assets)
-            test_case.assertGreaterEqual(signal.rating, -1)
-            test_case.assertLessEqual(signal.rating, 1)
-        total_signals += len(signals)
-
-    test_case.assertGreater(total_signals, 0)