diff --git a/CHANGELOG.md b/CHANGELOG.md index d13d36e..e69de29 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,76 +0,0 @@ -# Changelog - -## [4.0.14](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.13) - 2025-03-24 - -### Added - -- Add visualization for `Candles` object. -- Update `Config` class - -## [4.0.13](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.13) - 2025-03-24 - -### Fixed - -- Fixed Candles inplace addition and addition to be only between candles objects -- Index of Candles object dataframe is now a timezone-aware DateTimeIndex -- Add method can accept addition of either a Series, DataFrame, or Candle, object - -### Added - -- A to_series method to both Tick and Candle Classes -- Index attribute is now strictly for integer-based indexing -- index attribute maps to the underlying label-based indexing of the dataframe - -## [4.0.12](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.12) - 2025-03-24 - -### Fixed - -- Use correct error handling decorator for modify_stops in backtester - -## [4.0.10](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.10) - 2025-01-24 - -### Changed - -- Removed backoff decorator from send method of `Order` class - -## [4.0.9](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.9) - 2025-01-23 - -### Fixed - -- Fixed `__add__` to return a new Candles object - -### Changed - -- Removed tasks attribute from executor class - -### Added - -- Added `initialize_sync` method for synchronous initialization of a symbol - - -## [4.0.8](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.8) - 2025-01-21 - -### Fixed - -- Fixed `__add__` to return a new Candles object - -### Changed - -- Index attribute of a Candle now based on iloc of the Candles DataFrame - -## [4.0.7](https://github.com/Ichinga-Samuel/aiomql/releases/tag/v4.0.7) - 2025-01-16 - -### Changed -- -- Candles underlying DataFrame is now indexed by datetime. -- Executor runs a strategy via the `run_strategy` method directly with `asyncio.run` without creating as a task. -- `Strategy` class now has a initialize method that is called before the strategy is run. - -### Added -- -- `__add__` and `__iadd__` dunder methods for addition and inplace addition of dataframes or series objects to the Candles object. -- `add` method for adding dataframes or series objects to the Candles object. - -### Fixed - -- Candles timeframe attribute returns the correct TimeFrame object. diff --git a/README.md b/README.md index d4811ff..476da88 100644 --- a/README.md +++ b/README.md @@ -1,185 +1,166 @@ -# Aiomql - Bot Building Framework and Asynchronous MetaTrader5 Library -![GitHub](https://img.shields.io/github/license/ichinga-samuel/aiomql?style=plastic) -![GitHub issues](https://img.shields.io/github/issues/ichinga-samuel/aiomql?style=plastic) -![PyPI](https://img.shields.io/pypi/v/aiomql) +# aiomql +**Asynchronous MetaTrader 5 Library & Algorithmic Trading Framework** + +![PyPI Version](https://img.shields.io/pypi/v/aiomql) +![Python](https://img.shields.io/pypi/pyversions/aiomql) +![License](https://img.shields.io/github/license/ichinga-samuel/aiomql?style=plastic) +![GitHub Issues](https://img.shields.io/github/issues/ichinga-samuel/aiomql?style=plastic) + +--- + +## Overview + +**aiomql** is a Python framework for building algorithmic trading bots on top of MetaTrader 5. +It wraps every MT5 API call in an async-friendly interface and provides high-level abstractions +for strategies, risk management, trade execution, session management, and position tracking — +so you can focus on your trading logic instead of boilerplate. + +--- + +## Key Features + +- **Async-first MT5 interface** — every MT5 function wrapped with `asyncio.to_thread` and automatic reconnection +- **Full synchronous API** — every async class has a sync counterpart for scripts and notebooks +- **Bot orchestrator** — run multiple strategies on multiple instruments concurrently via thread-pool executors +- **Strategy base class** — define `trade()`, set parameters, and let the framework handle the execution loop +- **Session management** — restrict trading to specific time windows (London, New York, Tokyo, etc.) +- **Risk & money management** — built-in `RAM` (Risk Assessment & Money) manager +- **Trade recording** — persist results to CSV, JSON, or SQLite +- **Position tracking** — monitor open positions with trailing stops, extending take-profits, and custom tracking functions +- **Technical analysis** — built-in pandas-ta integration plus optional TA-Lib support +- **Multi-process execution** — run independent bots in parallel with `Bot.process_pool()` +- **JSON configuration** — centralise credentials and settings in `aiomql.json` +- **Contributed extensions** — pre-built traders (`SimpleTrader`, `ScalpTrader`), strategies (`Chaos`), and specialised symbols (`ForexSymbol`) + +--- + +## Requirements + +- **Python ≥ 3.13** +- **Windows** (MetaTrader 5 terminal requirement) +- A MetaTrader 5 trading account + +--- + +## Installation -### Installation ```bash pip install aiomql ``` -### Key Features -- Asynchronous Python Library For MetaTrader5 -- Asynchronous Bot Building Framework -- Build bots for trading in different financial markets. -- Use threadpool executors to run multiple strategies on multiple instruments concurrently -- Records and keep track of trades and strategies in csv files. -- Helper classes for Bot Building. Easy to use and extend. -- Compatible with pandas-ta. -- Sample Pre-Built strategies -- Specify and Manage Trading Sessions -- Risk Management -- Backtesting Engine -- Run multiple bots concurrently with different accounts from the same broker or different brokers -- Easy to use and very accurate backtesting engine +**Optional extras:** + +```bash +# TA-Lib technical indicators +pip install aiomql[talib] + +# Performance (Cython, Numba, tqdm) +pip install aiomql[performance] + +# Both +pip install aiomql[talib,performance] +``` + +--- + +## Quick Start + +### Configuration + +Create an `aiomql.json` file in your project root: + +```json +{ + "login": 12345678, + "password": "your_password", + "server": "YourBroker-Demo" +} +``` + +All settings can also be set programmatically via the singleton `Config` class: + +```python +from aiomql import Config + +config = Config(login=12345678, password="your_password", server="YourBroker-Demo") +``` + +### Using the MetaTrader Interface -### As an asynchronous MetaTrader5 Libray ```python import asyncio - from aiomql import MetaTrader async def main(): - mt5 = MetaTrader() - res = await mt5.initialize(login=31288540, password='nwa0#anaEze', server='Deriv-Demo') - if not res: - print('Unable to login and initialize') - return - # get account information - acc = await mt5.account_info() - print(acc) - # get symbols - symbols = await mt5.symbols_get() - print(symbols) - + async with MetaTrader() as mt5: + # Account information + account = await mt5.account_info() + print(account) + + # Available symbols + symbols = await mt5.symbols_get() + print(f"{len(symbols)} symbols available") + + asyncio.run(main()) ``` -### As a Bot Building FrameWork using a Sample Strategy -Aiomql allows you to focus on building trading strategies and not worry about the underlying infrastructure. -It provides a simple and easy to use framework for building bots with rich features and functionalities. +--- +## Building a Trading Bot + +### 1. Define a Strategy + +Subclass `Strategy` and implement the `trade()` method. Parameters declared in the +`parameters` dict become instance attributes and can be overridden at construction time. ```python -from datetime import time -import logging - -from aiomql import Bot, ForexSymbol, FingerTrap, Session, Sessions, RAM, SimpleTrader, TimeFrame, Chaos - -logging.basicConfig(level=logging.INFO) - - -def build_bot(): - bot = Bot() - # configure the parameters and the trader for a strategy - params = {'fast_period': 8, 'slow_period': 34, 'etf': TimeFrame.M5} - symbols = ['GBPUSD', 'AUDUSD', 'USDCAD', 'EURGBP', 'EURUSD'] - symbols = [ForexSymbol(name=sym) for sym in symbols] - strategies = [FingerTrap(symbol=sym, params=params)for sym in symbols] - bot.add_strategies(strategies) - - # create a strategy that uses sessions - # sessions are used to specify the trading hours for a particular market - # the strategy will only trade during the specified sessions - london = Session(name='London', start=time(8, 0), end=time(16, 0)) - new_york = Session(name='New York', start=time(13, 0), end=time(21, 0)) - tokyo = Session(name='Tokyo', start=time(0, 0), end=time(8, 0)) - - sessions = Sessions(sessions=[london, new_york, tokyo]) - jpy_strategy = Chaos(symbol=ForexSymbol(name='USDJPY'), sessions=sessions) - bot.add_strategy(strategy=jpy_strategy) - bot.execute() - -# run the bot -build_bot() -``` - -### Backtesting -Aiomql provides a very accurate backtesting engine that allows you to test your trading strategies before deploying -them in the market. The backtest engine prioritizes accuracy over speed, but allows you to increase the speed -as desired. It is very easy to use and provides a lot of flexibility. The backtester is designed to run strategies -seamlessly without need for modification of the strategy code. When running in backtest mode all the classes that -needs to know if they are running in backtest mode will be able to do so and adjust their behavior accordingly. - -```python -from aiomql import MetaBackTester, BackTestEngine, MetaTrader -import logging -from datetime import datetime, UTC - -from aiomql.lib.backtester import BackTester -from aiomql.core import Config -from aiomql.contrib.strategies import FingerTrap -from aiomql.contrib.symbols import ForexSymbol -from aiomql.core.backtesting import BackTestEngine - - -def back_tester(): - config = Config(mode="backtest") - logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s") - syms = ["Volatility 75 Index", "Volatility 100 Index", "Volatility 25 Index", "Volatility 10 Index"] - symbols = [ForexSymbol(name=sym) for sym in syms] - strategies = [FingerTrap(symbol=symbol) for symbol in symbols] - - # create start time and end time for the backtest - start = datetime(2024, 5, 1, tzinfo=UTC) - stop_time = datetime(2024, 5, 2, tzinfo=UTC) - end = datetime(2024, 5, 7, tzinfo=UTC) - - # create a backtest engine - back_test_engine = BackTestEngine(start=start, end=end, speed=3600, stop_time=stop_time, - close_open_positions_on_exit=True, assign_to_config=True, preload=True, - account_info={"balance": 350}) - # add it to the backtester - backtester = BackTester(backtest_engine=back_test_engine) - # add strategies to the backtester - backtester.add_strategies(strategies=strategies) - backtester.execute() - - -back_tester() -``` - -### Writing a Custom Strategy -Aiomql provides a simple and easy to use framework for building trading strategies. You can easily extend the -framework to build your own custom strategies. Below is an example of a simple strategy that buys when the fast -moving average crosses above the slow moving average and sells when the fast moving average crosses below the slow -moving average. - -```python -# emaxover.py +# strategies/ema_crossover.py from aiomql import Strategy, ForexSymbol, TimeFrame, Tracker, OrderType, Sessions, Trader, ScalpTrader class EMAXOver(Strategy): - ttf: TimeFrame # time frame for the strategy - tcc: int # how many candles to consider - fast_ema: int # fast moving average period - slow_ema: int # slow moving average period - tracker: Tracker # tracker to keep track of strategy state - interval: TimeFrame # intervals to check for entry and exit signals - timeout: int # timeout after placing an order in seconds + ttf: TimeFrame + tcc: int + fast_ema: int + slow_ema: int + tracker: Tracker + interval: TimeFrame + timeout: int - # default parameters for the strategy - # they are set as attributes. You can override them in the constructor via the params argument. - parameters = {'ttf': TimeFrame.H1, 'tcc': 3000, 'fast_ema': 34, 'slow_ema': 55, 'interval': TimeFrame.M15, - 'timeout': 3 * 60 * 60} + parameters = { + "ttf": TimeFrame.H1, + "tcc": 3000, + "fast_ema": 34, + "slow_ema": 55, + "interval": TimeFrame.M15, + "timeout": 3 * 60 * 60, + } - def __init__(self, *, symbol: ForexSymbol, params: dict | None = None, trader: Trader = None, - sessions: Sessions = None, name: str = "EMAXOver"): + def __init__(self, *, symbol: ForexSymbol, params: dict | None = None, + trader: Trader = None, sessions: Sessions = None, + name: str = "EMAXOver"): super().__init__(symbol=symbol, params=params, sessions=sessions, name=name) self.tracker = Tracker(snooze=self.interval.seconds) self.trader = trader or ScalpTrader(symbol=self.symbol) async def find_entry(self): - # get the candles - candles = await self.symbol.copy_rates_from_pos(timeframe=self.ttf, start_position=0, count=self.tcc) - - # get the fast moving average + candles = await self.symbol.copy_rates_from_pos( + timeframe=self.ttf, count=self.tcc + ) candles.ta.ema(length=self.fast_ema, append=True) - # get the slow moving average candles.ta.ema(length=self.slow_ema, append=True) - # rename the columns - candles.rename(**{f"EMA_{self.fast_ema}": "fast_ema", f"EMA_{self.slow_ema}": "slow_ema"}, inplace=True) + candles.rename( + **{f"EMA_{self.fast_ema}": "fast_ema", + f"EMA_{self.slow_ema}": "slow_ema"}, + inplace=True, + ) - # check for crossovers - # fast above slow - fas = candles.ta_lib.cross(candles.fast_ema, candles.slow_ema, above=True) - # fast below slow - fbs = candles.ta_lib.cross(candles.fast_ema, candles.slow_ema, above=False) + fas = candles.ta_lib.above(candles.fast_ema, candles.slow_ema) + fbs = candles.ta_lib.below(candles.fast_ema, candles.slow_ema) - ## check for entry signals in the current candle if fas.iloc[-1]: self.tracker.update(order_type=OrderType.BUY, snooze=self.timeout) elif fbs.iloc[-1]: @@ -192,32 +173,137 @@ class EMAXOver(Strategy): if self.tracker.order_type is None: await self.sleep(secs=self.tracker.snooze) else: - await self.trader.place_trade(order_type=self.tracker.order_type, parameters=self.parameters) + await self.trader.place_trade( + order_type=self.tracker.order_type, parameters=self.parameters + ) await self.delay(secs=self.tracker.snooze) ``` -### Testing +### 2. Wire It Up with a Bot -Run the tests with pytest +```python +import logging +from aiomql import Bot, ForexSymbol, OpenPositionsTracker +from strategies.ema_crossover import EMAXOver + +logging.basicConfig(level=logging.INFO) + + +def main(): + symbols = [ForexSymbol(name=s) for s in ["EURUSD", "GBPUSD", "USDJPY"]] + strategies = [EMAXOver(symbol=sym) for sym in symbols] + + bot = Bot() + bot.add_strategies(strategies) + + # Optionally track open positions on a separate thread + bot.add_coroutine( + coroutine=OpenPositionsTracker(autocommit=True).track, + on_separate_thread=True, + ) + + bot.execute() # synchronous entry point (blocks until shutdown) + + +if __name__ == "__main__": + main() +``` + +> **Tip:** Use `await bot.start()` instead of `bot.execute()` if you're already inside an async context. + +### 3. Trading Sessions + +Restrict when a strategy trades by passing `Sessions`: + +```python +from datetime import time +from aiomql import Session, Sessions, ForexSymbol, Chaos + +london = Session(name="London", start=time(8, 0), end=time(16, 0)) +new_york = Session(name="New York", start=time(13, 0), end=time(21, 0)) + +sessions = Sessions(sessions=[london, new_york]) +strategy = Chaos(symbol=ForexSymbol(name="USDJPY"), sessions=sessions) +``` + +### 4. Multi-Process Execution + +Run completely independent bots in separate processes: + +```python +from aiomql import Bot + + +def run_forex(): + bot = Bot() + # ... add forex strategies ... + bot.execute() + + +def run_crypto(): + bot = Bot() + # ... add crypto strategies ... + bot.execute() + + +Bot.process_pool(processes={run_forex: {}, run_crypto: {}}, num_workers=2) +``` + +--- + +## Project Structure + +``` +src/aiomql/ +├── core/ # MetaTrader interface, Config, constants, models, DB, State, errors +│ └── sync/ # Synchronous MetaTrader wrapper +├── lib/ # High-level components (Bot, Strategy, Order, Symbol, Candle, …) +│ └── sync/ # Synchronous mirrors (Strategy, Symbol, Trader, …) +├── contrib/ # Community extensions +│ ├── strategies/ # Chaos (random buy/sell demo) +│ ├── symbols/ # ForexSymbol (pip calculations) +│ ├── trackers/ # Position & open-positions trackers +│ ├── traders/ # SimpleTrader, ScalpTrader +│ └── utils/ # StrategyTracker (Tracker) +├── ta_libs/ # Technical analysis (pandas-ta classic) +└── utils/ # Decorators, price helpers, process pool +``` + +--- + +## API Documentation + +See the full [API Reference](docs/toc.md) for detailed documentation of every module. + +--- + +## Testing ```bash +# Install dev dependencies +pip install -e ".[dev]" + +# Run the test suite pytest tests ``` -### API Documentation -see [API Documentation](docs) for more details +--- -### Contributing -Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. +## Contributing +Pull requests are welcome. For major changes, please open an [issue](https://github.com/Ichinga-Samuel/aiomql/issues) first +to discuss what you would like to change. -### Changelog +--- -See [CHANGELOG](CHANGELOG.md) for more details +## License -### Support -Feeling generous, like the package or want to see it become a more mature package? +[MIT](LICENSE) -Consider supporting the project by buying me a coffee. +--- -[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/ichingasamuel) +## Support + +If you find this project useful, consider supporting its development: + +[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/ichingasamuel) diff --git a/docs/TOC.md b/docs/TOC.md deleted file mode 100644 index e38a52d..0000000 --- a/docs/TOC.md +++ /dev/null @@ -1,55 +0,0 @@ -# Table of Contents - -- [Core](core) - - [MetaTrader](core/meta_trader.md) - - [Config](core/config.md) - - [Base](core/base.md) - - [Constants](core/constants.md) - - [TaskQueue](core/task_queue.md) - - [Models](core/models.md) - - [Errors](core/errors.md) - - [Exceptions](core/exceptions.md) - - [MetaBackTester](core/meta_backtester.md) - - - [BackTesting](core/backtesting) - - [BackTestAccount](core/backtesting/backtest_account.md) - - [BackTestEngine](core/backtesting/backtest_engine.md) - - [GetData](core/backtesting/get_data.md) - - [TradesManager](core/backtesting/trades_manager.md) - - [BackTestController](core/backtesting/backtest_controller.md) - -- [Lib](lib) - - [Account](lib/account.md) - - [Bot](lib/bot.md) - - [Candle](lib/candle.md) - - [Candles](lib/candle.md) - - [History](lib/history.md) - - [Order](lib/order.md) - - [Positions](lib/positions.md) - - [RAM](lib/ram.md) - - [TradeRecords](lib/trade_records.md) - - [Result](lib/result.md) - - [Session](lib/sessions.md) - - [Sessions](lib/sessions.md) - - [Symbol](lib/symbol.md) - - [Strategy](lib/strategy.md) - - [Terminal](lib/terminal.md) - - [Tick](lib/ticks.md) - - [Ticks](lib/ticks.md) - - [Trader](lib/trader.md) - -- [Contrib](contrib) - - [CandlePatterns](contrib/candle_patterns) - - [Fractals](contrib/candle_patterns/fractals.md) - - - [Symbols](contrib/symbols) - - [ForexSymbol](contrib/symbols/forex_symbol.md) - - - [Utils](contrib/utils) - - [Tracker](contrib/utils/tracker.md) - - - [Traders](contrib/traders) - - [ScalpTrader](contrib/traders/scalp_trader.md) - - [SimpleTrader](contrib/traders/simple_trader.md) - -- [Utils](_utils.md) diff --git a/docs/_utils.md b/docs/_utils.md deleted file mode 100644 index 566e4ed..0000000 --- a/docs/_utils.md +++ /dev/null @@ -1,141 +0,0 @@ -# Utils -Utils is a collection of utility functions that are used throughout the codebase. It is a collection of functions. - -## Table of Contents -- [backtest_sleep](#_utils.backtest_sleep) -- [round_off](#_utiils.round_off) -- [dict_to_string](#_utils.dict_to_string) -- [round_down](#_utils.round_down) -- [round_up](#_utils.round_up) -- [async_cache](#_utils.async_cache) -- [backoff_decorator](#_utils.backoff_decorator) -- [error_handler](#_utils.error_handler) -- [error_handler_sync](#_utils.error_handler_sync) - - - -### round_off -```python -def round_off(value: float, step: float, round_down: bool = True) -> float: -``` -Rounds off a value to the nearest step. If round_down is True, it will round down, otherwise it will round up. - -#### Parameters: -| Name | Type | Description | Default | -|------------|-------|--------------------------------------------|---------| -| value | float | The value to round off. | | -| step | float | The step to round off to. | | -| round_down | bool | Whether to round down. If False, round up. | True | - -#### Returns: -| Type | Description | -|-------|------------------------| -| float | The rounded off value. | - - - -### dict_to_string -```python -def dict_to_string(data: dict, multi=True) -> str: -``` -Converts a dictionary to a string. If multi is True, it will return a multi-line string. - -#### Parameters: -| Name | Type | Description | Default | -|-------|------|----------------------------------------|---------| -| data | dict | The dictionary to convert to a string. | | -| multi | bool | Whether to return a multi-line string. | True | - -#### Returns: -| Type | Description | -|------|-----------------------------| -| str | The dictionary as a string. | - - - -### round_down -```python -def round_down(value: float, base: int) -> int: -``` -Rounds down a value to the nearest base. - -#### Parameters: -| Name | Type | Description | -|-------|-------|------------------------------------| -| value | float | The value to round down. | -| base | int | The base to round down to. | - - - -### round_up -```python -def round_up(value: float, base: int) -> int: -``` -Rounds up a value to the nearest base. - -#### Parameters: -| Name | Type | Description | -|-------|-------|----------------------------------| -| value | float | The value to round up. | -| base | int | The base to round up to. | - - - -### async_cache -```python -def async_cache(func: Callable) -> Callable: -``` -A decorator to cache the result of an async function. - - - -### backoff_decorator -```python -def backoff_decorator(func=None, *, max_retries: int = 2, retries: int = 0, error="") -> Callable: -``` -A decorator to retry a function with exponential backoff. - -#### Parameters: -| Name | Type | Description | Default | -|-------------|------|--------------------------------------------|---------| -| func | | The function to decorate. | | -| max_retries | int | The maximum number of retries. | 2 | -| retries | int | The current number of retries. | 0 | -| error | str | The error message to display on exception. | | - - - -### error_handler -```python -async def error_handler(func=None, *, msg="", exe=Exception, response=None, log_error_msg=True) -> Callable: -``` -A decorator to handle exceptions in an async function. - -#### Parameters: -| Name | Type | Description | Default | -|---------------|------|--------------------------------------------|---------| -| func | | The function to decorate. | | -| msg | str | The error message to display on exception. | | -| exe | | The exception to catch. | | -| response | | The response to return on exception. | | -| log_error_msg | bool | Whether to log the error message. | True | - - - -### error_handler_sync -```python -def error_handler_sync(func=None, *, msg="", exe=Exception, response=None, log_error_msg=True) -> Callable: -``` -A decorator to handle exceptions in a sync function. - - -### backtest_sleep -```python -def backtest_sleep(seconds: float) -> None: -``` -Sleeps for a given number of seconds in backtest mode. - -#### Parameters: -| Name | Type | Description | -|---------|-------|----------------------------------| -| seconds | float | The number of seconds to sleep. | diff --git a/docs/contrib/candle_patterns/fractals.md b/docs/contrib/candle_patterns/fractals.md deleted file mode 100644 index 4c52e92..0000000 --- a/docs/contrib/candle_patterns/fractals.md +++ /dev/null @@ -1,22 +0,0 @@ -# Fractals - -## Table of Contents -- [fractals](#fractals) -- [find_bearish_fractal](#fractals.find_bearish_fractal) -- [find_bullish_fractal](#fractals.find_bullish_fractal) - - - -### find_bearish_fractal -```python -def find_bearish_fractal(candles: Candles) -> Candle | None -``` -Given a candles object, find the most recent bearish fractal. - - - -### find_bullish_fractal -```python -def find_bullish_fractal(candles: Candles) -> Candle | None -``` -Given a candles object, find the most recent bullish fractal. diff --git a/docs/contrib/strategies/chaos.md b/docs/contrib/strategies/chaos.md new file mode 100644 index 0000000..e3825f1 --- /dev/null +++ b/docs/contrib/strategies/chaos.md @@ -0,0 +1,21 @@ +# chaos + +`aiomql.contrib.strategies.chaos` — Random buy/sell demo strategy. + +## Overview + +The `Chaos` strategy randomly buys or sells on every tick, serving as a minimal +working example of a `Strategy` subclass. Useful for testing the trading pipeline. + +## Classes + +### `Chaos` + +> Demo strategy that trades randomly. + +Inherits from [`Strategy`](../../lib/strategy.md). + +#### `trade()` + +Generates a random `OrderType` (BUY or SELL) and places a market order via the +configured trader. diff --git a/docs/contrib/symbols/forex_symbol.md b/docs/contrib/symbols/forex_symbol.md index b753146..8378993 100644 --- a/docs/contrib/symbols/forex_symbol.md +++ b/docs/contrib/symbols/forex_symbol.md @@ -1,90 +1,29 @@ -# ForexSymbol +# forex_symbol -## Table of Contents -- [ForexSymbol](#forex_symbol.forex_symbol) -- [pip](#forex_symbol.pip) -- [compute_points](#forex_symbol.compute_points) -- [compute_volume_points](#forex_symbol.compute_volume_points) -- [compute_volume_sl](#forex_symbol.compute_volume_sl) +`aiomql.contrib.symbols.forex_symbol` — Forex-specific symbol with pip calculations. +## Overview - -### ForexSymbol -```python -class ForexSymbol(Symbol) -``` -Subclass of Symbol for Forex Symbols. Handles the computation of stop loss, take profit and volume. +Extends [`Symbol`](../../lib/symbol.md) with forex-specific logic for pip size, +pip value, and volume calculations based on currency pairs. - -### pip -```python -@property -def pip() -``` -Returns the pip value of the symbol. This is ten times the point value for forex symbols. +## Classes -#### Returns: -|Type|Description| -|----|-----------| -|float|The pip value of the symbol.| +### `ForexSymbol` - -### compute_points -```python -def compute_points(*, amount: float, volume: float) -> float -``` -Compute the number of points required for a trade. Given the amount and the volume of the trade. +> Symbol subclass tailored for forex instruments. -#### Parameters: -|Name|Type|Description| -|----|----|-----------| -|amount|float|Amount to trade| -|volume|float|Volume to trade| +Inherits from [`Symbol`](../../lib/symbol.md). -#### Returns: -|Type|Description| -|----|-----------| -|float|The number of points required for the trade.| +| Attribute | Type | Description | +|-----------|------|-------------| +| `pip` | `float` | Pip size for the pair | - -### compute_volume_points -```python -async def compute_volume_points(*, - amount: float, - points: float, - round_down: bool = False) -> float -``` -Compute the volume required for a trade. Given the amount and the number of points. +#### Methods -#### Parameters: -|Name|Type|Description| -|----|----|-----------| -|amount|float|Amount to trade| -|points|float|Number of points| -|round_down|bool|round down the computed volume to the nearest step default True| - -#### Returns: -|Type|Description| -|----|-----------| -|float|The volume required for the trade. - - - -### compute_volume_sl -```python -async def compute_volume_sl(*, amount: float, price: float, sl: float, round_down: bool = False) -> float -``` -Compute the volume required for a trade. Given the amount, the price and the stop loss. - -#### Parameters: -|Name|Type|Description| -|----|----|-----------| -|amount|float|Amount to trade| -|price|float|Price of the trade| -|sl|float|Stop loss| -|round_down|bool|round down the computed volume to the nearest step default True| - -#### Returns: -|Type|Description| -|----|-----------| -|float|The volume required for the trade. \ No newline at end of file +| Method | Returns | Description | +|--------|---------|-------------| +| `pip_value(volume)` | `float` | Value of one pip for a given lot size | +| `pips_to_price(pips)` | `float` | Converts a pip count to a price delta | +| `price_to_pips(price_delta)` | `float` | Converts a price delta to pips | +| `calc_volume(amount, pips)` | `float` | Calculates lot size from risk amount and pip distance | diff --git a/docs/contrib/trackers/open_position.md b/docs/contrib/trackers/open_position.md new file mode 100644 index 0000000..01b7a2c --- /dev/null +++ b/docs/contrib/trackers/open_position.md @@ -0,0 +1,28 @@ +# open_position + +`aiomql.contrib.trackers.open_position` — Open position data container. + +## Overview + +Defines the `OpenPosition` dataclass that holds the essential details of an open +MetaTrader 5 position for use by the tracking system. + +## Classes + +### `OpenPosition` + +> Lightweight container for an open position's key fields. + +| Field | Type | Description | +|-------|------|-------------| +| `ticket` | `int` | Position ticket number | +| `symbol` | `str` | Trading instrument | +| `volume` | `float` | Position volume | +| `type` | `PositionType` | BUY or SELL | +| `price_open` | `float` | Entry price | +| `sl` | `float` | Stop loss level | +| `tp` | `float` | Take profit level | +| `profit` | `float` | Current profit | +| `swap` | `float` | Accumulated swap | +| `magic` | `int` | EA magic number | +| `comment` | `str` | Position comment | diff --git a/docs/contrib/trackers/position_trackers.md b/docs/contrib/trackers/position_trackers.md new file mode 100644 index 0000000..330ffe1 --- /dev/null +++ b/docs/contrib/trackers/position_trackers.md @@ -0,0 +1,46 @@ +# position_trackers + +`aiomql.contrib.trackers.position_trackers` — Position and open-positions tracker classes. + +## Overview + +Provides `PositionTracker` (tracks a single position) and `OpenPositionsTracker` +(tracks all open positions). Used for executing automated tracking functions +such as trailing stops and take-profit extensions. + +## Classes + +### `PositionTracker` + +> Tracks a single open position and runs tracking functions. + +| Attribute | Type | Description | +|-----------|------|-------------| +| `position` | `OpenPosition` | The tracked position | +| `tracker` | `Callable` | The tracking function to execute | + +#### Methods + +| Method | Description | +|--------|-------------| +| `track()` | Executes the tracking function for the position | +| `update()` | Refreshes position data from the terminal | + +--- + +### `OpenPositionsTracker` + +> Monitors all open positions and runs trackers on each. + +| Attribute | Type | Description | +|-----------|------|-------------| +| `trackers` | `dict[int, PositionTracker]` | Active trackers keyed by ticket | +| `tracking_functions` | `dict[str, Callable]` | Registered tracking functions | + +#### Methods + +| Method | Description | +|--------|-------------| +| `add_tracking_function(name, func)` | Registers a named tracking function | +| `track_positions()` | Updates all trackers and runs their tracking functions | +| `run()` | Main loop — continuously tracks positions | diff --git a/docs/contrib/trackers/position_tracking_functions.md b/docs/contrib/trackers/position_tracking_functions.md new file mode 100644 index 0000000..1efa41f --- /dev/null +++ b/docs/contrib/trackers/position_tracking_functions.md @@ -0,0 +1,25 @@ +# position_tracking_functions + +`aiomql.contrib.trackers.position_tracking_functions` — Pre-built tracking functions. + +## Overview + +Provides ready-to-use tracking functions for the [`PositionTracker`](position_trackers.md). +These functions automate common position-management actions like trailing stops and +take-profit extensions. + +## Functions + +### `trailing_stop(position, *, pips, …)` + +> Implements a trailing stop loss. + +Adjusts the stop loss to trail behind the current price by a specified pip distance. +Only modifies the stop if the new level is more favourable than the existing one. + +### `trailing_take_profit(position, *, pips, …)` + +> Extends the take profit as price moves favourably. + +Adjusts the take-profit level when the position's profit exceeds a threshold, +locking in additional gains. diff --git a/docs/contrib/traders/scalp_trader.md b/docs/contrib/traders/scalp_trader.md index 3a4c3fb..a3ece73 100644 Binary files a/docs/contrib/traders/scalp_trader.md and b/docs/contrib/traders/scalp_trader.md differ diff --git a/docs/contrib/traders/simple_trader.md b/docs/contrib/traders/simple_trader.md index c0686fa..8601a69 100644 Binary files a/docs/contrib/traders/simple_trader.md and b/docs/contrib/traders/simple_trader.md differ diff --git a/docs/contrib/utils/strategy_tracker.md b/docs/contrib/utils/strategy_tracker.md new file mode 100644 index 0000000..cd878fa --- /dev/null +++ b/docs/contrib/utils/strategy_tracker.md @@ -0,0 +1,27 @@ +# strategy_tracker + +`aiomql.contrib.utils.strategy_tracker` — Strategy state tracking dataclass. + +## Overview + +The `StrategyTracker` dataclass keeps track of a strategy's runtime state, including +trend information, entry prices, and flags. + +## Classes + +### `StrategyTracker` + +> Tracks strategy data and state. + +| Field | Type | Default | Description | +|-------|------|---------|-------------| +| `trend` | `str` | `""` | Current detected trend | +| `new_trend` | `str` | `""` | Newly detected trend (before confirmation) | +| `order_type` | `OrderType \| None` | `None` | Current order type | +| `snooze` | `bool` | `False` | Whether the strategy is in a cool-down period | +| `entry_price` | `float` | `0.0` | Entry price of the last trade | +| `exit_price` | `float` | `0.0` | Exit price of the last trade | +| `sl` | `float` | `0.0` | Current stop loss | +| `tp` | `float` | `0.0` | Current take profit | +| `profit` | `float` | `0.0` | Current profit/loss | +| `*` | … | … | — Additional custom fields — | diff --git a/docs/contrib/utils/tracker.md b/docs/contrib/utils/tracker.md deleted file mode 100644 index 5d024bf..0000000 Binary files a/docs/contrib/utils/tracker.md and /dev/null differ diff --git a/docs/core/_core.md b/docs/core/_core.md new file mode 100644 index 0000000..20d50b3 --- /dev/null +++ b/docs/core/_core.md @@ -0,0 +1,45 @@ +# _core + +`aiomql.core._core` — Low-level interface that dynamically binds MetaTrader 5 constants, functions, and types. + +## Overview + +This module provides the metaclass machinery that introspects the `MetaTrader5` Python package and copies its +attributes into the class hierarchy. It is **not** intended for direct use — the higher-level +[`MetaTrader`](meta_trader.md) class should be used instead. + +## Module-Level Attributes + +| Name | Type | Description | +|------|------|-------------| +| `constants` | `tuple[str, ...]` | Names of MT5 integer constants to bind (e.g. `TIMEFRAME_M1`) | +| `core_mt5_functions` | `tuple[str, ...]` | Names of MT5 API functions to bind (prefixed with `_` on `MetaCore`) | +| `types` | `tuple[str, ...]` | Names of MT5 named-tuple types to bind | + +## Classes + +### `MetaBase` + +> Metaclass that dynamically binds MetaTrader 5 attributes to classes. + +On class creation, `MetaBase.__new__` introspects the `MetaTrader5` module and copies constants, +API functions (prefixed with `_`), and named-tuple types into the new class's namespace. + +### `MetaCore` + +> Base class exposing all MetaTrader 5 constants, functions, and types. + +Created by `MetaBase`, this class holds every MT5 constant, every API function, and every +named-tuple type as class attributes. + +**Key attribute groups:** + +| Group | Examples | +|-------|---------| +| Timeframes | `TIMEFRAME_M1`, `TIMEFRAME_H1`, `TIMEFRAME_D1`, … | +| Order types | `ORDER_TYPE_BUY`, `ORDER_TYPE_SELL`, `ORDER_FILLING_FOK`, … | +| Trade actions | `TRADE_ACTION_DEAL`, `TRADE_ACTION_PENDING`, … | +| Return codes | `TRADE_RETCODE_DONE`, `TRADE_RETCODE_ERROR`, … | +| API functions | `_initialize`, `_login`, `_order_send`, `_positions_get`, … | +| Named-tuple types | `TradePosition`, `TradeOrder`, `TradeDeal`, `SymbolInfo`, … | +| Config | `config` — the global `Config` instance | diff --git a/docs/core/backtesting/backtest_account.md b/docs/core/backtesting/backtest_account.md deleted file mode 100644 index 4365711..0000000 --- a/docs/core/backtesting/backtest_account.md +++ /dev/null @@ -1,55 +0,0 @@ -# BackTestAccount - -## Table of Contents -- [BackTestAccount](#back_test_account.back_test_account) -- [get_dict](#back_test_account.back_test_account.get_dict) -- [asdict](#back_test_account.asdict) -- [set_attrs](#back_test_account.set_attrs) - - -### BackTestAccount - -```python -@dataclass -class BackTestAccount: -``` -The `BackTestAccount` class provides data structure for managing account data specifically for backtesting purposes. - -#### Attributes: -| Name | Type | Description | -|-------------|---------------|-----------------------------------------------------------| -| `balance` | `float` | The account balance for the backtest | -| `equity` | `float` | The equity value of the account during the backtest | -| `currency` | `str` | The currency type used in the backtesting account | -| `leverage` | `float` | Leverage ratio applied to the backtest account | -| `spread` | `int` | Spread value applied to simulated trades | - - - -### get_dict -```python -def get_dict(exclude: set = None, include: set = None) -> dict -``` -Returns a dictionary representation of the account data. The `exclude` and `include` parameters allow filtering of data keys. - -#### Arguments: -| Name | Type | Description | -|-----------|-------|----------------------------------------------------------| -| `exclude` | `set` | A set of attribute names to exclude from the dictionary. | -| `include` | `set` | A set of attribute names to include in the dictionary. | - - - -### asdict -```python -def asdict() -> dict -``` -Returns a dictionary of all attributes in the account data without filtering. - - -### set_attrs - -```python -def set_attrs(**kwargs) -``` -Sets multiple attributes at once by passing key-value pairs as keyword arguments. diff --git a/docs/core/backtesting/backtest_controller.md b/docs/core/backtesting/backtest_controller.md deleted file mode 100644 index ba981be..0000000 --- a/docs/core/backtesting/backtest_controller.md +++ /dev/null @@ -1,104 +0,0 @@ -# BackTestController - -## Table of Contents -- [BackTestController](#backtest_controller.back_test_controller) -- [backtest_engine](#backtest_controller.backtest_engine) -- [add_tasks](#backtest_controller.add_tasks) -- [set_parties](#backtest_controller.set_parties) -- [parties](#backtest_controller.parties) -- [control](#backtest_controller.control) -- [stop_backtesting](#backtest_controller.stop_backtesting) -- [wait](#backtest_controller.wait) -- [abort](#backtest_controller.abort) - - - -### BackTestController -```python -class BackTestController -``` -The controller for the backtesting engine. -It also acts as a synchronizer for running multiple strategies (tasks) using a threading.Barrier primitive. -It handles the updating of open positions and close them when necessary. -It handles the iterator for the backtesting engine and handles it movement in time by moving it to the next time step. - -#### Attributes: -| Name | Type | Description | -|-------------|----------------------|----------------------------------------------| -| `_instance` | `BackTestController` | The instance of the controller | -| `config` | `Config` | The configuration for the backtesting engine | -| `tasks` | `list[Task]` | The tasks that are being run | -| `barrier` | `Barrier` | The barrier for synchronizing the tasks | - - - -#### backtest_engine -```python -@property -def backtest_engine() -``` -Returns the backtest engine - - - -#### add_tasks -```python -def add_tasks(*tasks: Task) -``` -Adds a task to the tasks list - - - -#### set_parties -```python -def set_parties(*, parties: int) -``` -Sets the number of parties for the barrier. The barrier will wait for the number of parties to reach the barrier. -This has to be done here as it can be impossible to know the eventual number of parties to set the barrier to during initialization. - -#### Parameters: -| Name | Type | Description | -|-----------|-------|---------------------------------------------| -| `parties` | `int` | The number of parties to set the barrier to | - - - -#### parties -```python -@property -def parties() -``` -Returns the number of parties for the barrier - - - -#### control -```python -async def control() -``` -The backtest controller. It controls the backtesting engine and the tasks that are being run. -It acts as a synchronizer for the tasks and the backtesting engine. - - - -#### stop_backtesting -```python -def stop_backtesting() -``` -Stop the backtester, and shutdown the executor - - - -#### wait -```python -def wait() -``` -Called by individual tasks to indicate completion of their cycle - - - -#### abort -```python -def abort() -``` -Aborts the barrier diff --git a/docs/core/backtesting/backtest_engine.md b/docs/core/backtesting/backtest_engine.md deleted file mode 100644 index 408fc22..0000000 --- a/docs/core/backtesting/backtest_engine.md +++ /dev/null @@ -1,957 +0,0 @@ -# BackTestEngine - -## Table of Contents - -- [BackTestEngine](#backtest_engine.back_test_engine) -- [\__init\__](#backtest_engine.__init__) -- [setup_test_range](#backtest_engine.setup_test_range) -- [setup_data](#backtest_engine.setup_data) -- [next](#backtest_engine.next) -- [data](#backtest_engine.data) -- [reset](#backtest_engine.reset) -- [go_to](#backtest_engine.go_to) -- [fast_forward](#backtest_engine.fast_forward) -- [tracker](#backtest_engine.tracker) -- [save_result_to_json](#backtest_engine.save_result_to_json) -- [close_all_open](#backtest_engine.close_all_open) -- [wrap_up](#backtest_engine.wrap_up) -- [preload_ticks](#backtest_engine.preload_ticks) -- [get_price_tick](#backtest_engine.get_price_tick) -- [check_order](#backtest_engine.check_order) -- [check_account](#backtest_engine.check_account) -- [check_position](#backtest_engine.check_position) -- [close_position_manually](#backtest_engine.close_position_manually) -- [close_position](#backtest_engine.close_position) -- [modify_stops](#backtest_engine.modify_stops) -- [update_account](#backtest_engine.update_account) -- [deposit](#backtest_engine.deposit) -- [withdraw](#backtest_engine.withdraw) -- [setup_account](#backtest_engine.setup_account) -- [setup_account_sync](#backtest_engine.setup_account_sync) -- [prices](#backtest_engine.prices) -- [ticks](#backtest_engine.ticks) -- [rates](#backtest_engine.rates) -- [symbols](#backtest_engine.symbols) -- [order_send](#backtest_engine.order_send) -- [order_check](#backtest_engine.order_check) -- [get_terminal_info](#backtest_engine.get_terminal_info) -- [get_version](#backtest_engine.get_version) -- [get_symbols_total](#backtest_engine.get_symbols_total) -- [get_symbols](#backtest_engine.get_symbols) -- [get_account_info](#backtest_engine.get_account_info) -- [get_symbol_info_tick](#backtest_engine.get_symbol_info_tick) -- [get_symbol_info](#backtest_engine.get_symbol_info) -- [get_rates_from](#backtest_engine.get_rates_from) -- [get_rates_from_pos](#backtest_engine.get_rates_from_pos) -- [get_rates_range](#backtest_engine.get_rates_range) -- [get_ticks_from](#backtest_engine.get_ticks_from) -- [get_ticks_range](#backtest_engine.get_ticks_range) -- [order_calc_margin](#backtest_engine.order_calc_margin) -- [order_calc_profit](#backtest_engine.order_calc_profit) -- [get_orders_total](#backtest_engine.get_orders_total) -- [get_orders](#backtest_engine.get_orders) -- [get_positions_total](#backtest_engine.get_positions_total) -- [get_positions](#backtest_engine.get_positions) -- [get_history_orders_total](#backtest_engine.get_history_orders_total) -- [get_history_orders](#backtest_engine.get_history_orders) -- [get_history_deals_total](#backtest_engine.get_history_deals_total) -- [get_history_deals](#backtest_engine.get_history_deals) - - - -#### BackTestEngine -```python -class BackTestEngine -``` -The BackTestEngine class is used to simulate trading strategies on historical data that is either preloaded or provided -at runtime during the test. - -#### Attributes: -| Name | Type | Description | -|--------------------------------|----------------|-----------------------------------------------------------------------------------------------------| -| `_data` | `BackTestData` | The data used for backtesting. This is the data that is saved to disk when the backtest is stopped. | -| `mt5` | `MetaTrader` | The MetaTrader instance for the backtest engine. | -| `config` | `Config` | The global configuration instance. | -| `name` | `str` | The name of the backtest. | -| `stop_testing` | `bool` | Whether to stop the backtest. | -| `use_terminal` | `bool` | Whether to use the terminal for backtesting. | -| `close_open_positions_on_exit` | `bool` | Whether to close all open positions when the backtest is stopped. | -| `stop_time` | `int` | The time to stop the backtest. | -| `preload` | `bool` | Whether to preload the ticks for the backtest. | -| `preloaded_ticks` | `dict` | A dictionary of preloaded ticks for the backtest. | -| `account_lock` | `RLock` | A reentrant lock for the account data. | -| `account_info` | `dict` | A dictionary of account information for the backtest. | - - - -#### \__init\__ -```python -def __init__(*, - data: BackTestData = None, - speed: int = 60, - start: float | datetime = 0, - end: float | datetime = 0, - restart: bool = True, - use_terminal: bool = None, - name: str = "", - stop_time: float | datetime = None, - close_open_positions_on_exit: bool = True, - preload=True, - assign_to_config: bool = True, - account_info: dict = None) -``` -The BackTestEngine class is used to simulate trading strategies on historical data. -It can accept already saved data or create new data for backtesting on the fly. Ideally only one instance of -this class should be created per session. By default it is automatically assigned to the global config instance -during instantiation, replacing any existing backtest engine instance. But this is a configurable behaviour. -The start and end time can still be specified even when test data is provided. In that case it will be used -to set the range of the backtest. - - -#### Parameters: -| Name | Type | Description | -|--------------------------------|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `data` | `BackTestData` | The data to use for backtesting. Defaults to None. | -| `speed` | `int` | The speed of the backtest. Defaults to 60 seconds. | -| `start` | `float \| datetime` | The start time of the backtest. Defaults to 0. If a float is passed, it is assumed to be a timestamp. | -| `end` | `float \| datetime` | The end time of the backtest. Defaults to 0. If a float is passed, it is assumed to be a timestamp. | -| `restart` | `bool` | Whether to restart the backtest from the beginning. Defaults to True. This is useful when resuming a backtest using a saved BackTestData instance. | -| `use_terminal` | `bool` | Whether to use the terminal for backtesting. Defaults to None. If None, it uses the global config setting. If use terminal is true, the backtest engine will use the terminal to get price data, compute margins, profit and check order viability. If false, it will use the data provided in the BackTestData instance and default algorithm for the calculations | -| `name` | `str` | The name of the backtest. Defaults to "". If not provided, it is generated from the start and end times. | -| `stop_time` | `float \| datetime` | The time to stop the backtest. Defaults to None. If a float is passed, it is assumed to be a timestamp. If not given it is assumed to be the end of the backtest range. | -| `close_open_positions_on_exit` | `bool` | Whether to close all open positions when the backtest is stopped. Defaults to True. | -| `preload` | `bool` | Whether to preload the ticks for the backtest. Defaults to True. | -| `assign_to_config` | `bool` | Whether to assign the backtest engine to the global config instance. Defaults to True. | -| `account_info` | `dict` | A dictionary of account information to use for the backtest. Defaults to None. Use this to set the account information for the backtest. | - - - -#### setup_test_range -```python -def setup_test_range(*, - start: float | datetime = None, - end: float | datetime = None, - speed: int = 60, - restart: bool = True) -``` -Setup the test range for the backtest engine. This is used to set the range of the backtest and the speed -at which it runs. - -#### Parameters: -| Name | Type | Description | -|-----------|---------------------|------------------------------------------------------------------------------------------------------------------------| -| `start` | `float \| datetime` | The start time of the backtest. Defaults to None. If a float is passed, it is assumed to be a timestamp. | -| `end` | `float \| datetime` | The end time of the backtest. Defaults to None. If a float is passed, it is assumed to be a timestamp. | -| `speed` | `int` | The speed of the backtest. Defaults to 60 seconds. | -| `restart` | `bool` | Whether to restart the backtest. Defaults to True. This is useful when resuming a backtest using a saved BackTestData. | - - - -#### setup_data -```python -def setup_data(*, restart: bool = True) -``` -Sets up the data for the backtest engine. This includes the orders, positions, deals and account -information. This data is handled by specialized classes such as the BackTestAccount and the TradeManager -classes. - -#### Parameters: -| Name | Type | Description | -|-----------|--------|------------------------------------------------| -| `restart` | `bool` | Whether to restart the data. Defaults to True. | - - - -#### next -```python -def next() -> Cursor -``` -Move the cursor to the next time step in the backtest range. - - - -#### data -```python -@property -def data() -``` -The BackTestData instance used for the backtest. If not provided, a new instance is created, -and the data is made persistent when the backtest is stopped. - - - -#### reset -```python -def reset(clear_data: bool = False) -``` -Reset the backtest engine. This is useful when restarting the backtest from the beginning. Clear trade data if any -when the `clear_data` parameter is true - - - -#### go_to -```python -def go_to(*, time: datetime | float) -``` -Move the cursor to a specific time in the backtest range. You can pass a datetime object or a timestamp. -You can't go back in time or beyond the limits of the range. - - - -#### fast_forward -```python -def fast_forward(*, steps: int) -``` -Fast-forward the backtester by the given steps. - - - -#### tracker -```python -async def tracker() -``` -The tracker monitors and updates open positions on every iteration. It is called by the controller. - - - -#### save_result_to_json -```python -@error_handler_sync -def save_result_to_json() -``` -Saves the result to a json file at the end of testing. - - - -#### close_all_open -```python -async def close_all_open() -``` -Closes all open position at the end of testing - - -#### wrap_up -```python -@error_handler -async def wrap_up() -``` -Wraps up the backtest. This is called at the end of testing to save the results and close all open positions. - - - -#### preload_ticks -```python -async def preload_ticks(*, symbol: str) -``` -Pull a month data on ticks from the terminal. Starting from the current time. - -#### Parameters: -| Name | Type | Description | -|----------|-------|----------------------------------| -| `symbol` | `str` | The symbol to preload ticks for. | - - - -#### get_price_tick -```python -@async_cache -async def get_price_tick(*, symbol: str, time: int) -> Tick | None -``` -Get the price tick for a symbol at a given time. If the preload option is set to True, -it will use the preloaded ticks when available. - -#### Parameters: -| Name | Type | Description | -|----------|-------|---------------------------------------| -| `symbol` | `str` | The symbol to get the price tick for. | -| `time` | `int` | The time to get the price tick. | - - - -#### check_order -```python -@error_handler -async def check_order(*, ticket: int) -``` -Check if the order has reached its take profit or stop loss levels and close the order if it has. -Checks only `OrderType.BUY` and `OrderType.SELL` orders that have reached their take profit or stop loss levels. - -#### Parameters: -| Name | Type | Description | -|----------|-------|--------------| -| `ticket` | `int` | Order ticket | - - - -#### check_account -```python -def check_account() -``` -Checks an account status. This method is called at each iteration to check if the account has burned out. - - - -#### check_position -```python -async def check_position(*, ticket: int) -``` -Update the profit of an open position based on the current price of the symbol. It is called by the -tracker to update the profit of open positions. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `ticket` | `int` | Position ticket | - - - -#### close_position_manually -```python -@error_handler_sync -async def close_position_manually(*, ticket: int) -``` -Close a position manually without. Usually at the end of testing. - - - -#### close_position -```python -async def close_position(*, ticket: int) -> bool -``` -Close an open position for the trading account using the position ticket. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `ticket` | `int` | Position ticket | - -#### Returns: -| Type | Description | -|--------|--------------------------------------------------------------| -| `bool` | True if the position is closed successfully, False otherwise | - - - -#### modify_stops -```python -@error_handler(response=False) -def modify_stops(*, ticket: int, sl: int, tp: int) -> bool -``` -Modify the stop loss and take profit levels of an open position. -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `ticket` | `int` | Position ticket | -| `sl` | `int` | stop loss level | - -#### Returns: -| Type | Description | -|--------|--------------------------------------------------------------| -| `bool` | True if the stops are modified successfully, False otherwise | - - - -#### update_account -```python -def update_account(*, - profit: float = None, - margin: float = 0, - gain: float = 0) -``` -Update the account. This method is protected by thread lock. - -#### Parameters: -| Name | Type | Description | -|----------|---------|--------------------------------------------------------------------------------| -| `profit` | `float` | The current profit of one or more open positions. Can be positive or negative. | -| `margin` | `float` | The margin set aside for a trade. It is released when the trade is closed. | -| `gain` | `gain` | The gain realized when the trade is closed. | - - - -#### deposit -```python -def deposit(*, amount: float) -``` -Make deposit to the trading account - - - -#### withdraw -```python -def withdraw(*, amount: float) -``` -Make a withdrawal from the trading account. You can not withdraw more than what you have - - - -#### setup_account -```python -@error_handler -async def setup_account(**kwargs) -``` -Set up the trading account before the beginning of a backtesting session. - -#### Parameters: -| Name | Type | Description | -|----------|------|-------------------------------------------------------------| -| `kwargs` | dict | Attributes for the backtest account object can be set here. | - - - -#### setup_account_sync -```python -@error_handler_sync -def setup_account_sync(**kwargs) -``` -Set up the backtesting account in sync mode - - - -#### prices -```python -@cached_property -def prices() -> dict[str, DataFrame] -``` -Get the prices for instruments used in the backtesting. This class is called when the use_terminal option -is set to False and trading data is provided in the data attribute. It makes sure that there is a price for each -symbol for every second covered in the backtesting range, by reindexing the price ticks using the backtesting -time span and filling up missing data using the nearest method. -This method returns a dictionaries of dataframe containing the prices for each symbol. -It's cached and there computed only once per backtesting session. - -#### Returns: -| Type | Description | -|--------|--------------------------------------------------------------| -| `dict` | A dictionary mapping dataframe of prices to symbols. | - - - -#### ticks -```python -@cached_property -def ticks() -> dict[str, DataFrame] -``` -Similar to prices above, but returns prices exactly as they are without reindexing and filling up. - -#### Returns: -| Type | Description | -|--------|--------------------------------------------------------------| -| `dict` | A dictionary mapping dataframe of prices to symbols. | - - - -#### rates -```python -@cached_property -def rates() -> dict[str, dict[int, DataFrame]] -``` -This property is useful when backtesting with the use_terminal option set to false. It returns a nested dict -that maps symbols to a dict mapping timeframes to rates. The timeframes are mapped using their integer values. - -#### Returns: -| Type | Description | -|-----------------------------------|-------------------------------------------| -| `dict[str, dict[int, DataFrame]]` | A dictionary containing the symbol rates. | - - - -#### symbols -```python -@cached_property -def symbols() -> dict[str, SymbolInfo] -``` -A dictionary of symbols and SymbolInfo object. Used when use_terminal is set to false. -#### Returns: -| Type | Description | -|-------------------------|------------------------------------------------| -| `dict[str, SymbolInfo]` | A dictionary of symbols and SymbolInfo object. | - - - -#### order_send -```python -@error_handler -async def order_send(*, request: dict, use_terminal=False) -> OrderSendResult -``` -Simulates the sending of an order to the broker. An OrderSendResult is object is created at the end of this -operation as would be created if it was done in live trading. When an order is successful a positions object is -created, an order and deal object is created as well. The margin and profit are calculated by sending to the broker -if `use_terminal` is true. This increases accuracy but slows down the backtester. The `check_order` method is -called to make sure the order is valid and would go through if it was a live trade. - -#### Parameters: - -| Name | Type | Description | -|----------------|------|-------------------------------------------------------------------------------------------------------------------------------| -| `request` | dict | The order request as a dict. | -| `use_terminal` | bool | A flag to override the use_terminal attribute. If true, the terminal will be used even if the use_terminal attribute is True. | - - -#### Returns: -| Type | Description | -|-------------------|--------------------------------------------------------------| -| `OrderSendResult` | An object containing the result of the order send operation. | - - - -#### order_check -```python -@error_handler -async def order_check(*, request: dict, use_terminal: bool = False) -> OrderCheckResult -``` -Checks the order before placing it. If `use_terminal` is true, the order is checked with the broker, -but the entire result is not used. Details such as balance, profit, equity, margin, and margin level are calculated -by the backtester. - -#### Parameters: -| Name | Type | Description | -|----------------|------|---------------------------------------------------------------------------------| -| `request` | dict | The order request as a dict. | -| `use_terminal` | bool | A flag to override the use_terminal attribute. If true, the terminal will used. | - - -#### Returns: -| Type | Description | -|--------------------|--------------------------------| -| `OrderCheckResult` | The result of the order check. | - - - -#### get_terminal_info -```python -@error_handler -async def get_terminal_info() -> TerminalInfo -``` -Get the terminal information - -#### Returns: -| Type | Description | -|----------------|--------------------------| -| `TerminalInfo` | The terminal information | - - - -#### get_version -```python -@error_handler -async def get_version() -> tuple[int, int, str] -``` -Get the version of the terminal. - -#### Returns: -| Type | Description | -|------------------------|-----------------------------| -| `tuple[int, int, str]` | The version of the terminal | - - - -#### get_symbols_total -```python -@error_handler -async def get_symbols_total() -> int -``` -Get the total number of symbols available in the terminal. - -#### Returns: -| Type | Description | -|------|------------------------------------------------| -| `int` | The total number of symbols available. | - - - -#### get_symbols -```python -@error_handler -async def get_symbols(*, group: str = "") -> tuple[SymbolInfo, ...] -``` -Get the symbols available in the terminal. Filter by group if provided. - -#### Parameters: -| Name | Type | Description | -|----------|------|------------------------------------------------| -| `group` | str | The group to filter by (default is "") | - - -#### Returns: -| Type | Description | -|--------------------------|-------------------------------| -| `tuple[SymbolInfo, ...]` | A tuple of symbol information | - - - -#### get_account_info -```python -@error_handler_sync -def get_account_info() -> AccountInfo -``` -Get the account information - -#### Returns: -| Type | Description | -|---------------|-------------------------| -| `AccountInfo` | The account information | - - - -#### get_symbol_info_tick -```python -@error_handler -async def get_symbol_info_tick(*, symbol: str) -> Tick -``` -Get the price tick for a symbol at the current time - -#### Parameters: -| Name | Type | Description | -|----------|------|---------------------------------------| -| `symbol` | str | The symbol to get the price tick for. | - - -#### Returns: -| Type | Description | -|--------|----------------| -| `Tick` | The price tick | - - - -#### get_symbol_info -```python -@error_handler -async def get_symbol_info(*, symbol: str) -> SymbolInfo -``` -Get the symbol information - -#### Parameters: -| Name | Type | Description | -|----------|------|---------------------------------------| -| `symbol` | str | The symbol to get information for | - - -#### Returns: -| Type | Description | -|--------------|------------------------| -| `SymbolInfo` | The symbol information | - - - -#### get_rates_from -```python -@error_handler -async def get_rates_from(*, symbol: str, timeframe: TimeFrame, date_from: datetime | float, count: int) -> np.ndarray -``` -Get rates from a specific date to the current date. Used by the backtester to get rates for a symbol - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------------| -| `symbol` | `str` | The symbol to get rates for | -| `timeframe` | `TimeFrame` | The timeframe of the rates | -| `date_from` | `datetime \| float` | The date from which to get the rates | -| `count` | `int` | The number of rates to get | - - -#### Returns: -| Type | Description | -|--------------|------------------------| -| `np.ndarray` | An array of rates | - - - -#### get_rates_from_pos -```python -@error_handler -async def get_rates_from_pos(*, symbol: str, timeframe: TimeFrame, start_pos: int, count: int) -> np.ndarray -``` -Get a number of rates counting from a specific position. With position zero being the current time. -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------------| -| `symbol` | `str` | The symbol to get rates for | -| `timeframe` | `TimeFrame` | The timeframe of the rates | -| `start_pos` | `int` | The position to start from | -| `count` | `int` | The number of rates to get | - -#### Returns: -| Type | Description | -|--------------|------------------------| -| `np.ndarray` | An array of rates | - - - -#### get_rates_range -```python -@error_handler -async def get_rates_range(*, symbol: str, timeframe: TimeFrame, date_from: datetime | float, - date_to: datetime | float) -> np.ndarray -``` -Get rates within a specific date range. Used by the backtester to get rates for a symbol - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------------| -| `symbol` | `str` | The symbol to get rates for | -| `timeframe` | `TimeFrame` | The timeframe of the rates | -| `date_from` | `datetime \| float` | The date from which to get the rates | -| `date_to` | `datetime \| float` | The date to which to get the rates | - - -#### Returns: -| Type | Description | -|--------------|------------------------| -| `np.ndarray` | An array of rates | - - - -#### get_ticks_from -```python -@error_handler -async def get_ticks_from(*, symbol: str, date_from: datetime | float, count: int, - flags: CopyTicks = CopyTicks.ALL) -> np.ndarray -``` -Get a specified number of ticks counting from a specific date. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------------| -| `symbol` | `str` | The symbol to get ticks for | -| `date_from` | `datetime \| float` | The date from which to get the ticks | -| `count` | `int` | The number of ticks to get | -| `flags` | `CopyTicks` | The flags to use when getting ticks | - -#### Returns: -| Type | Description | -|--------------|------------------------| -| `np.ndarray` | An array of ticks | - - - -#### get_ticks_range -```python -@error_handler -async def get_ticks_range(*, symbol: str, date_from: datetime | float, date_to: datetime | float, - flags: CopyTicks = CopyTicks.ALL) -> np.ndarray -``` -Get ticks within a specific date range. -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------------| -| `symbol` | `str` | The symbol to get ticks for | -| `date_from` | `datetime \| float` | The date from which to get the ticks | -| `date_to` | `datetime \| float` | The date to which to get the ticks | -| `flags` | `CopyTicks` | The flags to use when getting ticks | - - -#### Returns: -| Type | Description | -|--------------|------------------------| -| `np.ndarray` | An array of ticks | - - - -#### order_calc_margin -```python -@error_handler -async def order_calc_margin(*, action: Literal[OrderType.BUY, OrderType.SELL], symbol: str, volume: float, - price: float, use_terminal: bool = None) -``` -Calculate the margin required for a trade. - -#### Parameters: -| Name | Type | Description | -|----------------|------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------| -| `action` | `Literal[OrderType.BUY, OrderType.SELL]` | Type of order | -| `symbol` | `str` | Symbol name | -| `volume` | `float` | Volume of the trade | -| `price` | `float` | The price at which the trade is opened | -| `use_terminal` | `bool` | A flag to override the use_terminal attribute. If true, the terminal will be used even if the use_terminal attribute is True. | - - -#### Returns: -| Type | Description | -|--------|------------------------------------| -| `float` | The margin required for the trade | - - - -#### order_calc_profit -```python -@error_handler -async def order_calc_profit(*, action: Literal[OrderType.BUY, OrderType.SELL], symbol: str, volume: float, - price_open: float, price_close: float, use_terminal=None) -``` -Calculate the profit for a trade. -#### Parameters: -| Name | Type | Description | -|----------------|------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------| -| `action` | `Literal[OrderType.BUY, OrderType.SELL]` | Type of order | -| `symbol` | `str` | Symbol name | -| `volume` | `float` | Volume of the trade | -| `price_open` | `float` | The price at which the trade is opened | -| `price_close` | `float` | The price at which the trade is closed | -| `use_terminal` | `bool` | A flag to override the use_terminal attribute. If true, the terminal will be used even if the `use_terminal` attribute is True. | - -#### Returns: -| Type | Description | -|---------|-------------------------| -| `float` | The profit of the trade | - - - -#### get_orders_total -```python -@error_handler_sync -def get_orders_total() -> int -``` -Get the total number of pending orders. - -#### Returns: -| Type | Description | -|-------|--------------------------------| -| `int` | Total number of pending orders | - - - -#### get_orders -```python -@error_handler_sync -def get_orders(*, symbol: str = "", group: str = "", ticket: int = None) -> tuple[TradeOrder, ...] -``` -Get pending orders from the terminal history. This has to do with pending orders, which this backtester -doesn't support yet. - -#### Parameters: -| Name | Type | Description | -|----------|-------|--------------| -| `symbol` | `str` | Symbol name | -| `group` | `str` | Group name | -| `ticket` | `int` | Order ticket | - -#### Returns: -| Type | Description | -|--------------------------|----------------| -| `tuple[TradeOrder, ...]` | Pending orders | - - - -#### get_positions_total -```python -@error_handler_sync -def get_positions_total() -> int -``` -Get the total number of open positions. - -#### Returns: -| Type | Description | -|-------|--------------------------------| -| `int` | Total number of open positions | - - - -#### get_positions -```python -@error_handler_sync -def get_positions(*, symbol: str = None, group: str = None, ticket: int = None) -> tuple[TradePosition, ...] -``` -Get open positions from the terminal history. - -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------| -| `symbol` | `str` | Symbol name | -| `group` | `str` | Group name | -| `ticket` | `int` | Position ticket | - -#### Returns: -| Type | Description | -|--------------------------|----------------| -| `tuple[TradePosition, ...]` | Open positions | - - - -#### get_history_orders_total -```python -@error_handler_sync -def get_history_orders_total(*, date_from: datetime | float, date_to: datetime | float) -> int -``` -Get the total number of orders in the terminal history. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|---------------------------------------| -| `date_from` | `datetime \| float` | The start date of the history | -| `date_to` | `datetime \| float` | The end date of the history | - -#### Returns: -| Type | Description | -|-------|--------------------------------| -| `int` | Total number of orders in the history | - - - -#### get_history_orders -```python -@error_handler_sync -def get_history_orders(*, date_from: datetime | float = None, date_to: datetime | float = None, group: str = "", - ticket: int = None, position: int = None) -> tuple[TradeOrder, ...] -``` -Get orders from the terminal history. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|---------------------------------------| -| `date_from` | `datetime \| float` | Date from which to start the history | -| `date_to` | `datetime \| float` | Date to which to end the history | -| `group` | `str` | group keyword to filter by | -| `ticket` | `int` | ticket id to filter by | -| `position` | `int` | position id to filter by | - - -#### Returns: -| Type | Description | -|--------------------------|-----------------------| -| `tuple[TradeOrder, ...]` | Orders in the history | - - - -#### get_history_deals_total -```python -@error_handler_sync -def get_history_deals_total(*, date_from: datetime | float, date_to: datetime | float) -> int -``` -Get the total number of deals in the terminal history. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------------| -| `date_from` | `datetime \| float` | Date from which to start the history | -| `date_to` | `datetime \| float` | Date to which to end the history | - - -#### Returns: -| Type | Description | -|-------|--------------------------------------| -| `int` | Total number of deals in the history | - - - -#### get_history_deals -```python -@error_handler_sync -def get_history_deals(*, date_from: datetime | float = None, date_to: datetime | float = None, group: str = None, - position: int = None, ticket: int = None) -> tuple[TradeDeal, ...] -``` -Get deals from the terminal history. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|---------------------------------------| -| `date_from` | `datetime \| float` | Date from which to start the history | -| `date_to` | `datetime \| float` | Date to which to end the history | -| `group` | `str` | group keyword to filter by | -| `position` | `int` | position id to filter by | -| `ticket` | `int` | ticket id to filter by | - -#### Returns: -| Type | Description | -|-------------------------|----------------------| -| `tuple[TradeDeal, ...]` | Deals in the history | diff --git a/docs/core/backtesting/get_data.md b/docs/core/backtesting/get_data.md deleted file mode 100644 index 89a2748..0000000 --- a/docs/core/backtesting/get_data.md +++ /dev/null @@ -1,162 +0,0 @@ -# Get Data - -## Table of Contents - -- [Cursor](#get_data.cursor) -- [BackTestData](#get_data.back_test_data) - - [set_attrs](#get_data.back_test_data.set_attrs) - - [fields](#get_data.back_test_data.fields) -- [GetData](#get_data.getdata) - - [\__init\__](#get_data.get_data.__init__) - - [pickle_data](#get_data.pickle_data) - - [load_data](#get_data.load_data) - - [save_data](#get_data.save_data) - - [get_data](#get_data.get_data) - - - -### Cursor -```python -class Cursor(NamedTuple) -``` -A cursor to iterate over the data. Marks the current position in time. - - - -### BackTestData -```python -@dataclass -class BackTestData -``` -The data class to store the backtesting data. - -#### Attributes: -| Name | Type | Description | -|------------------|----------|------------------------------------------------| -| `name` | `str` | The name of the backtest data | -| `terminal` | `dict` | The terminal information | -| `version` | `tuple` | The version of the terminal | -| `account` | `dict` | The account information | -| `symbols` | `dict` | The symbols information | -| `ticks` | `dict` | The ticks data | -| `rates` | `dict` | The rates data | -| `span` | `range` | The range of the data | -| `range` | `range` | The range of the data | -| `orders` | `dict` | The orders data | -| `deals` | `dict` | The deals data | -| `positions` | `dict` | The positions data | -| `open_positions` | `set` | The open positions | -| `cursor` | `Cursor` | The cursor to iterate over the data | -| `margins` | `dict` | The margins data | -| `fully_loaded` | `bool` | A flag to indicate if the data is fully loaded | - - - -#### set_attrs -```python -def set_attrs(**kwargs) -``` -Set the attributes of the class on the instance. - - - -#### fields -```python -@property -def fields() -``` -A list of the fields of the class. - - - -### GetData -```python -class GetData -``` -A class to get the backtesting data from the MetaTrader5 terminal. - -#### Attributes: -| Name | Type | Description | -|--------------|-----------------------|---------------------------------------| -| `start` | `datetime` | The start date of the data | -| `end` | `datetime` | The end date of the data | -| `symbols` | `Iterable[str]` | The symbols to get the data for | -| `timeframes` | `Iterable[TimeFrame]` | The timeframes to get the data for | -| `name` | `str` | The name of the backtest data | -| `range` | `range` | The range of the data | -| `span` | `range` | The span of the data | -| `data` | `BackTestData` | The backtesting data | -| `mt5` | `MetaTrader` | The MetaTrader5 instance | -| `task_queue` | `TaskQueue` | The task queue to handle the requests | - - - -#### \__init\__ -```python -def __init__(*, start: datetime, end: datetime, symbols: Sequence[str], - timeframes: Sequence[TimeFrame], name: str = "") -``` -Get the backtesting data from the MetaTrader5 terminal. - -#### Parameters: -| Name | Type | Description | -|--------------|-----------------------|------------------------------------------------| -| `start` | `datetime` | The start date of the data | -| `end` | `datetime` | The end date of the data | -| `symbols` | `Sequence[str]` | The symbols to get the data for | -| `timeframes` | `Sequence[TimeFrame]` | The timeframes to get the data for | -| `name` | `str` | The name of the backtest data | - - - -#### pickle_data -```python -@classmethod -def pickle_data(cls, *, data: BackTestData, name: str | Path) -``` -Pickle the data to a file. - -#### Parameters: -| Name | Type | Description | -|--------|-------------------------|----------------------| -| `data` | `BackTestData` | The data to pickle | -| `name` | `str \| Path` | The name of the file | - - - -#### load_data -```python -@classmethod -def load_data(cls, *, name: str | Path) -> BackTestData -``` -Load the data from a file. - -#### Parameters: -| Name | Type | Description | -|--------|-------------------------|----------------------| -| `name` | `str \| Path` | The name of the file | - - - -#### save_data -```python -def save_data(*, name: str | Path = "") -``` -Save the data to a file. - -#### Parameters: -| Name | Type | Description | -|--------|-------------------------|----------------------| -| `name` | `str \| Path` | The name of the file | - - - -#### get_data -```python -async def get_data(workers: int = None) -``` -Use the task queue to get the data from the MetaTrader5 terminal. -#### Parameters: -| Name | Type | Description | -|-----------|-------|------------------------------------------------| -| `workers` | `int` | The number of workers to use in the task queue | diff --git a/docs/core/backtesting/trades_manager.md b/docs/core/backtesting/trades_manager.md deleted file mode 100644 index a0b903f..0000000 --- a/docs/core/backtesting/trades_manager.md +++ /dev/null @@ -1,409 +0,0 @@ -# TradesManager - -## Table of Contents -- [trades_manager](#trades_manager.trades_manager) - - [TradesManager](#trades_manager.trades_manager) - - [update](#trades_manager.trade_manager.update) - - [values](#trades_manager.trade_manager.values) - - [keys](#trades_manager.trade_manager.keys) - - [items](#trades_manager.trade_manager.items) - - [to_dict](#trades_manager.trade_manager.to_dict) - - [PositionsManager](#trades_manager.positions_manager) - - [\__init\__](#positions_manager.__init__) - - [margin](#positions_manager.margin) - - [close](#positions_manager.close) - - [get_margin](#positions_manager.get_margin) - - [delete_margin](#positions_manager.delete_margin) - - [set_margin](#positions_manager.set_margin) - - [positions_get](#positions_manager.positions_get) - - [positions_total](#positions_manager.positions_total) - - [open_positions](#positions_manager.open_positions) - - [OrdersManager](#trades_manager.orders_manager) - - [get_orders_range](#orders_manager.get_orders_range) - - [history_orders_get](#orders_manager.history_orders_get) - - [history_orders_total](#orders_manager.history_orders_total) - - [DealsManager](#trades_manager.deals_manager) - - [get_deals_range](#deals_manager.get_deals_range) - - [history_deals_get](#deals_manager.history_deals_get) - - [history_deals_total](#deals_manager.history_deals_total) - - - -### TradesManager -```python -class TradeManager(Generic[TradeData]) -``` -A generic class to manage trades data during a backtest. It is the parent class of the -PositionsManager, OrdersManager, and DealsManager. It implements some dict-like methods to manage the data. -It has a private attribute _data to store the data. It exposes the data through the values, keys, and items methods. -It also has a `to_dict` method to convert the data to a dictionary. - -#### Parameters: -| Name | Type | Description | -|---------|------------------------|------------------------------| -| `_data` | `dict[int, TradeData]` | The data to store the trades | - - -#### Examples: -```python ->>> manager = TradeManager() ->>> manager[123456] = TradePosition(ticket=123456, symbol="EURUSD", volume=0.1) ->>> manager.update(ticket=123456, symbol="EURUSD", volume=0.1) ->>> manager[123456] -TradePosition(ticket=123456, symbol='EURUSD', volume=0.1) ->>> manager.values() -(TradePosition(ticket=123456, symbol='EURUSD', volume=0.1),) ->>> manager.keys() -(123456,) ->>> manager.items() -((123456, TradePosition(ticket=123456, symbol='EURUSD', volume=0.1)),) ->>> manager.to_dict() -{'123456' - {'ticket': 123456, 'symbol': 'EURUSD', 'volume': 0.1}} ->>> pos = manager.get(123456) ->>> pos -TradePosition(ticket=123456, symbol='EURUSD', volume=0.1) ->>> pos in manager -True ->>> len(manager) -1 ->>> pos in manager -False -``` - - -#### update -```python -def update(*, ticket: int, **kwargs) -``` -Update the data of a trade. Given the ticket of the trade and the new data to update. - -#### Parameters: -| Name | Type | Description | -|------------|-------|------------------------------------| -| `ticket` | `int` | The ticket of the trade to update. | -| `**kwargs` | | The new data to update. | - - - -### values -```python -def values() -> tuple[TradeData, ...] -``` -Returns the values of the data. - - - -### keys -```python -def keys() -> tuple[int, ...] -``` -Returns the keys of the data. - - - -### items -```python -def items() -> tuple[tuple[int, TradeData], ...] -``` -Returns the items of the data. - - - -### to_dict -```python -def to_dict() -``` -Convert the data to a dictionary. - - - -```python -class PositionsManager(TradeManager) -``` -A class to manage the open positions during a backtest. It is a subclass of It has an additional -attribute _open_positions to store the open positions. It also has a margins attribute to store the margins of the -open positions. It overrides some methods of the TradeManager class to manage the open positions. - -#### Attributes: -| Name | Type | Description | -|------------------|--------------------|--------------------------------------------------------------------------------------------------------------------------| -| `data` | `dict` | The data to store the trades. This used for continuation of the backtesting, if it was stopped with some open positions. | -| `open_positions` | `set[int]` | The open positions. | -| `margins` | `dict[int, float]` | The margins of the open positions. | - - - -#### \__init\__ -```python -def __init__(*, data: dict = None, open_positions: set[int] = None, margins: dict = None) -``` -Positions manager manages the open positions during a backtest. It is a subclass of It has an -additional attribute _open_positions to store the open positions. It also has a margins attribute to store the -margins of the open positions. It overrides some methods of the TradeManager class to manage the open positions. - -#### Parameters: -| Name | Type | Description | -|------------------|--------------------|--------------------------------------------------------------------------------------------------------------------------| -| `data` | `dict` | The data to store the trades. This used for continuation of the backtesting, if it was stopped with some open positions. | -| `open_positions` | `set[int]` | The open positions. | -| `margins` | `dict[int, float]` | The margins of the open positions. | - - - -### margin -```python -@property -def margin() -``` -Returns the total margin of all open positions - - - -### close -```python -def close(*, ticket: int) -> bool -``` -Close a position. Given the ticket of the position to close. - -#### Parameters: -| Name | Type | Description | -|----------|-------|--------------------------------------| -| `ticket` | `int` | The ticket of the position to close. | - - - -#### get_margin -```python -def get_margin(*, ticket: int) -> float -``` -Get the margin of a position. Given the ticket of the position. - -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------------------| -| `ticket` | `int` | The ticket of the position. | - - -#### Returns: -| Type | Description | -|---------|-----------------------------| -| `float` | The margin of the position. | - - - -### delete_margin -```python -def delete_margin(*, ticket: int) -``` -Delete the margin of a position. Given the ticket of the position. - -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------------------| -| `ticket` | `int` | The ticket of the position. | - - - -### set_margin -```python -def set_margin(*, ticket: int, margin: float) -``` -Set the margin of a position. Given the ticket of the position and the margin. - -#### Parameters: -| Name | Type | Description | -|----------|---------|-----------------------------| -| `ticket` | `int` | The ticket of the position. | -| `margin` | `float` | The margin of the position. | - - - -### positions_get -```python -def positions_get(*, ticket: int = None, symbol: str = None, group: None = None) -> tuple[TradePosition, ...] -``` -Get positions. Given the ticket, symbol, or group of the positions. - -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------------------| -| `ticket` | `int` | The ticket of the position. | -| `symbol` | `str` | The symbol of the position. | -| `group` | `str` | The group of the position. | - -#### Returns: -| Type | Description | -|------------------------|-----------------------------| -| `tuple[TradePosition]` | The positions. | - -#### Returns: -| Type | Description | -|-----------------------------|-----------------------------| -| `tuple[TradePosition, ...]` | The positions. | - - - -### positions_total -```python -def positions_total() -> int -``` -Get the total number of open positions. - -#### Returns: -| Type | Description | -|-------|-------------------------------------| -| `int` | The total number of open positions. | - - - -#### open_positions -```python -@property -def open_positions() -> tuple[TradePosition, ...] -``` -Returns the open positions. - -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------------------| -| `ticket` | `int` | The ticket of the position. | - - - -### OrdersManager -```python -class OrdersManager(TradeManager) -``` -Managers orders data during a backtest. It is a subclass of It manages access to the historical -orders data - - - -#### get_orders_range -```python -def get_orders_range(*, date_from: float, date_to: float) -> tuple[TradeData, ...] -``` -Get orders within a date range. Given the start and end date of the range. - -#### Parameters: -| Name | Type | Description | -|-------------|---------|------------------------------| -| `date_from` | `float` | The start date of the range. | -| `date_to` | `float` | The end date of the range. | - -#### Returns: -| Type | Description | -|--------------------|-----------------------------------| -| `tuple[TradeData]` | The orders within the date range. | - - -#### Returns: -| Type | Description | -|--------------------|-----------------------------------| -| `tuple[TradeData]` | The orders within the date range. | - - - -#### history_orders_get -```python -def history_orders_get(*, date_from: float | datetime = None, date_to: float | datetime = None, - group: str = "", ticket: int = None, position: int = None) -> tuple[TradeOrder, ...] -``` -Get historical orders. Given the start and end date of the range, the group, ticket, or position of the -orders. - -#### Parameters: -| Name | Type | Description | -|-------------|---------|------------------------------| -| `date_from` | `float` | The start date of the range. | -| `date_to` | `float` | The end date of the range. | -| `group` | `str` | The group of the orders. | -| `ticket` | `int` | The ticket of the order. | -| `position` | `int` | The position of the order. | - -#### Returns: -| Type | Description | -|---------------------|------------------------| -| `tuple[TradeOrder]` | The historical orders. | - - - -### history_orders_total -```python -def history_orders_total(*, date_from: datetime | float, - date_to: datetime | float) -> int -``` -Get the total number of historical orders. Given the start and end date of the range. - -#### Parameters: -| Name | Type | Description | -|-------------|---------|------------------------------| -| `date_from` | `float` | The start date of the range. | -| `date_to` | `float` | The end date of the range. | - - - -### DealsManager -```python -class DealsManager(TradeManager) -``` - - -#### get_deals_range -```python -def get_deals_range(*, date_from: float, date_to: float) -> tuple[TradeData, ...] -``` -Get deals within a date range. Given the start and end date of the range. - -#### Parameters: -| Name | Type | Description | -|-------------|---------|------------------------------| -| `date_from` | `float` | The start date of the range. | -| `date_to` | `float` | The end date of the range. | - -#### Returns: -| Type | Description | -|--------------------|-----------------------------------| -| `tuple[TradeData]` | The deals within the date range. | - - - -### history_deals_get -```python -def history_deals_get(*, - date_from: float | datetime = None, - date_to: float | datetime = None, - group: str = "", - ticket: int = None, - position: int = None) -> tuple[TradeDeal, ...] -``` -History deals get. Given the start and end date of the range, the group, ticket, or position of the deals. - -#### Parameters: -| Name | Type | Description | -|-------------|---------|------------------------------| -| `date_from` | `float` | The start date of the range. | -| `date_to` | `float` | The end date of the range. | -| `group` | `str` | The group of the deals. | -| `ticket` | `int` | The ticket of the deal. | -| `position` | `int` | The position of the deal. | - - - -#### history_deals_total -```python -def history_deals_total(*, date_from: datetime | float, - date_to: datetime | float) -> int -``` -Get the total number of historical deals. Given the start and end date of the range - -#### Parameters: -| Name | Type | Description | -|-------------|---------|------------------------------| -| `date_from` | `float` | The start date of the range. | -| `date_to` | `float` | The end date of the range. | - -#### Returns: -| Type | Description | -|-------|---------------------------------------| -| `int` | The total number of historical deals. | diff --git a/docs/core/base.md b/docs/core/base.md index afca628..eed6961 100644 --- a/docs/core/base.md +++ b/docs/core/base.md @@ -1,135 +1,77 @@ -# Base +# base -## Table of Contents -- [Base](#base.base) - - [set_attributes](#base.set_attributes) - - [annotations](#base.annotations) - - [get_dict](#base.get_dict) - - [class_vars](#base.class_vars) - - [dict](#base.dict) +`aiomql.core.base` — Foundational base classes for data structure handling. -- [_Base](#_base._base) +## Overview +Provides the `Base` and `_Base` classes that all data-model and trading classes inherit from. +`Base` offers attribute management, dictionary conversion, and filtering. +`_Base` extends it with automatic access to the MetaTrader terminal and configuration. - -### Base -```python -class Base -``` -A base class for all data model classes in the aiomql package. This class provides a set of common methods -and attributes for all data model classes. +## Classes -#### Attributes: -| Name | Type | Description | -|-----------|-------|------------------------------------------------------------------------------------------------------| -| `exclude` | `set` | A set of attributes to be excluded when retrieving attributes using the *get_dict* and *dict* method | -| `include` | `set` | A set of attributes to be included when retrieving attributes using the *get_dict* and *dict* method | +### `BaseMeta` +> Metaclass that lazily initialises `config` and `mt5` on first access. - -### __init__ -```python -def __init__(**kwargs) -``` -#### Parameters: -| Name | Type | Description | -|----------|-------|---------------------------------------------------| -| `kwargs` | `Any` | Object attributes and values as keyword arguments | +#### `_setup()` +Attaches `Config()` and `MetaTrader()` (or sync variant) to the class if not already present. - -### set_attributes -```python -def set_attributes(**kwargs) -``` -Set keyword arguments as object attributes. Only sets attributes that have been annotated on the class body. +--- -#### Parameters: -| Name | Type | Description | -|----------|-------|---------------------------------------------------| -| `kwargs` | `Any` | Object attributes and values as keyword arguments | +### `Base` -#### Raises: -| Exception | Description | -|------------------|-----------------------------------------------------------------------------------| -| `AttributeError` | When assigning an attribute that does not belong to the class or any parent class | +> Common base class for all data structures in aiomql. -#### Notes: -Only sets attributes that have been annotated on the class body. +| Attribute | Type | Description | +|-----------|------|-------------| +| `exclude` | `set[str]` | Attributes excluded from dict conversion (default: `mt5`, `config`, …) | +| `include` | `set[str]` | Attributes always included (overrides `exclude`) | +#### `__init__(**kwargs)` - -### annotations -```python -@property -@cache -def annotations() -> dict -``` -Class annotations from all ancestor classes and the current class. -#### Returns: -| Type | Description | -|------------------|-----------------------------------| -| `dict[str, Any]` | A dictionary of class annotations | +Sets keyword arguments as instance attributes via `set_attributes`. +#### `set_attributes(**kwargs)` - -#### get_dict -```python -def get_dict(exclude: set = None, include: set = None) -> dict -``` -Returns class attributes as a dict, with the ability to filter +Sets only attributes that are annotated on the class body. Logs a debug message for unknown or +non-convertible attributes. -#### Parameters: -| Name | Type | Description | -|-----------|-------|------------------------------------| -| `exclude` | `set` | A set of attributes to be excluded | -| `include` | `set` | Specific attributes to be returned | +#### `annotations` *(property)* -#### Returns: -| Type | Description | -|--------|--------------------------------------------| -| `dict` | A dictionary of specified class attributes | +Merged `__annotations__` from all ancestor classes. -#### Notes: -You can only set either of include or exclude. If you set both, include will take precedence +#### `class_vars` *(property)* +Annotated class-level attributes from the full MRO. - -### class_vars -```python -@property -@cache -def class_vars() -``` -Annotated class attributes +#### `dict` *(property)* -#### Returns: -| Type | Description | -|--------|-------------------------------------------------------------------------------------------| -| `dict` | A dictionary of available class attributes in all ancestor classes and the current class. | +All instance and class attributes as a dictionary, excluding those in `exclude`. +#### `get_dict(exclude=None, include=None)` - -### dict -```python -@property -def dict() -> dict -``` -All instance and class attributes as a dictionary, except those excluded in the Meta class. +Returns a filtered dictionary. If both `include` and `exclude` are provided, `include` takes precedence. -#### Returns: -| Type | Description | -|--------|-----------------------------------------------| -| `dict` | A dictionary of instance and class attributes | +#### `__repr__()` +Shows up to 3 key attributes; appends `...` with the last attribute if there are more. - -```python -class Config -``` -The global config object. It is a singleton class for handling configuration settings for the aiomql package. -A single instance of this class is created and used per bot instance. +## Overview -#### Attributes: -| Name | Type | Description | -|--------------------------------|-------------------------------|-------------------------------------------------------------------------| -| `login` | `int` | The account login number | -| `trade_record_mode` | `Literal["csv", "json"]` | The mode for recording trades | -| `password` | `str` | The account password | -| `server` | `str` | The account server | -| `path` | `str \| Path` | The path to the terminal | -| `timeout` | `int` | The timeout argument for the terminal | -| `filename` | `str` | The filename of the config file | -| `state` | `dict` | The state of the configuration | -| `root` | `Path` | The root directory of the project | -| `record_trades` | `bool` | To record trades or not. Default is True | -| `records_dir` | `Path` | The directory to store trade records, relative to the root directory | -| `plots_dir` | `Path` | Save chart plots as images | -| `backtest_dir` | `Path` | The directory to store backtest results, relative to the root directory | -| `task_queue` | `TaskQueue` | The TaskQueue object for handling background tasks | -| `_backtest_engine` | `BackTestEngine` | The backtest engine object | -| `bot` | `Bot` | The bot object | -| `_instance` | `Self` | The instance of the Config class | -| `mode` | `Literal["backtest", "live"]` | The trading mode, either backtest or live, default is live | -| `use_terminal_for_backtesting` | `bool` | Use the terminal for backtesting, default is True | -| `shutdown` | `bool` | A signal to shut down the terminal, default is False | -| `force_shutdown` | `bool` | A signal to force shut down the terminal, default is False | +The `Config` class manages all runtime settings — login credentials, paths, database names, +trade-recording preferences, and shutdown signals. It implements the singleton pattern and can +load values from a JSON file (default `aiomql.json`) or be configured programmatically. -#### Notes: -By default, the config class looks for a file named aiomql.json. This can be changed by setting the filename -attribute to the desired file name. The root directory of the project can be set by passing the root argument -to the load_config method or during object instantiation. If not provided it is assumed to be the current working -directory. All directories and files are assumed to be relative to the root directory except when an absolute path -is provided, this includes the config file, the records_dir and the backtest_dir attributes. -The root directory is used to locate the config file and to set the records_dir and backtest_dir attributes. +## Classes +### `Config` - -### account_info -```python -def account_info() -> dict['login', 'password', 'server'] -``` -Returns Account login details as found in the config object if available +> Singleton configuration class. -#### Returns: -| Type | Description | -|---------------------------------------|-------------------------------------------------------| -| `dict['login', 'password', 'server']` | A dictionary with login, password, and server details | +#### Key Attributes - -### backtest_engine -```python -@property -def backtest_engine(self) -``` -Returns the backtest engine object. +| Attribute | Type | Default | Description | +|-----------|------|---------|-------------| +| `login` | `int` | `None` | MetaTrader account number | +| `password` | `str` | `""` | Account password | +| `server` | `str` | `""` | Account server name | +| `path` | `str \| Path` | `""` | Path to the MT5 terminal executable | +| `timeout` | `int` | `60000` | Connection timeout (ms) | +| `filename` | `str` | `"aiomql.json"` | Config file name to search for | +| `root` | `Path` | CWD | Project root directory | +| `trade_record_mode` | `Literal["csv","json","sql"]` | `"sql"` | Trade recording format | +| `record_trades` | `bool` | `True` | Enable/disable trade recording | +| `records_dir_name` | `str` | `"trade_records"` | Trade records directory name | +| `db_dir_name` | `str` | `"db"` | Database directory name | +| `db_name` | `str \| Path` | `""` | SQLite database file name | +| `shutdown` | `bool` | `False` | Graceful shutdown signal | +| `force_shutdown` | `bool` | `False` | Forced shutdown signal | +| `stop_trading` | `bool` | `False` | Stop opening new trades | +| `db_commit_interval` | `float` | `30` | Database commit interval (seconds) | +| `auto_commit` | `bool` | `False` | Auto-commit database changes | +| `flush_state` | `bool` | `False` | Flush state on init | +| `state` | `State` | — | Persistent key-value store | +| `store` | `Store` | — | Key-value database store | +| `task_queue` | `TaskQueue` | — | Background task queue | +| `bot` | `Bot` | `None` | Associated bot instance | -#### Returns: -| Type | Description | -|------------------|----------------------------| -| `BackTestEngine` | The backtest engine object | +#### `__init__(**kwargs)` +Loads the config file and sets attributes. If already initialised and no `root` or +`config_file` is provided, only the extra `kwargs` are applied. - -```python -@backtest_engine.setter -def backtest_engine(self, value: BackTestEngine) -``` -Sets the backtest engine object. +#### `load_config(*, config_file=None, filename=None, root=None, **kwargs)` -#### Parameters: -| Name | Type | Description | -|---------|------------------|----------------------------| -| `value` | `BackTestEngine` | The backtest engine object | +Sets the project root, locates/loads the JSON config file, initialises the database, +and applies all settings. Returns `self` for chaining. - -### set_attributes -```python -def set_attributes(self, **kwargs) -``` -Set attributes on the config object. The root folder attribute can't be set here. +#### `set_root(root=None)` - -### load_config -```python -def load_config(*, config_file: str | Path = None, filename: str = None, root: str | Path = None, **kwargs) -> Config -``` -Load configuration settings from a file and reset the config object. +Resolves and creates the project root directory. Falls back to CWD. -#### Parameters: -| Name | Type | Description | -|---------------|---------------|----------------------------------------------------------------------------------------------------| -| `config_file` | `str \| Path` | The absolute path to the config file. | -| `filename` | `str` | The name of the file to load if file path is not specified. If not provided `aiomql.json` is used. | -| `root` | `str` | The root directory of the project. | -| `**kwargs` | `dict` | Additional keyword arguments to be set on the config object. | +#### `find_config_file()` + +Searches up from CWD through parent directories for the config filename. + +**Returns:** `Path | None` + +#### `set_attributes(**kwargs)` + +Sets attributes, but prevents `root` and `config_file` from being changed here +(use `load_config` instead). + +#### `state` *(property)* + +Lazily initialised `State` instance. + +#### `store` *(property)* + +Lazily initialised `Store` instance. + +#### `records_dir` *(cached property)* + +Path to the trade records directory. Created on first access. + +#### `plots_dir` *(cached property)* + +Path to the plots directory. Created on first access. + +#### `account_info` *(property)* + +Returns `{"login": …, "password": …, "server": …}`. diff --git a/docs/core/constants.md b/docs/core/constants.md index 6155c93..ee3c084 100644 --- a/docs/core/constants.md +++ b/docs/core/constants.md @@ -1,582 +1,154 @@ -# Constants -MetaTrader 5 constants defined as Enums. +# constants -## Table of Contents -- [TradeAction](#TradeAction) -- [OrderFilling](#OrderFilling) -- [OrderTime](#OrderTime) -- [OrderType](#OrderType) - - [opposite](#ordertype.opposite) -- [BookType](#BookType) -- [TimeFrame](#TimeFrame) - - [get_timeframe](#timeframe.get_timeframe) - - [seconds](#timeframe.seconds) - - [all](#timeframe.all) -- [CopyTicks](#CopyTicks) -- [PositionType](#PositionType) -- [PositionReason](#PositionReason) -- [DealType](#DealType) -- [DealEntry](#DealEntry) -- [DealReason](#DealReason) -- [OrderReason](#OrderReason) -- [SymbolChartMode](#SymbolChartMode) -- [SymbolCalcMode](#SymbolCalcMode) -- [SymbolTradeMode](#SymbolTradeMode) -- [SymbolTradeExecution](#SymbolTradeExecution) -- [SymbolSwapMode](#SymbolSwapMode) -- [DayOfWeek](#DayOfWeek) -- [SymbolOrderGTCMode](#SymbolOrderGTCMode) -- [SymbolOptionRight](#SymbolOptionRight) -- [SymbolOptionMode](#SymbolOptionMode) -- [AccountTradeMode](#AccountTradeMode) -- [TickFlag](#TickFlag) -- [TradeRetcode](#TradeRetcode) -- [AccountStopOutMode](#AccountStopOutMode) -- [AccountMarginMode](#AccountMarginMode) +`aiomql.core.constants` — MetaTrader 5 constants as Pythonic `IntEnum` types. - -## TradeAction -```python -class TradeAction(Repr, IntEnum) -``` -The TRADE_REQUEST_ACTION Enum. -### Members -| Name | Value | Description | -|------------|-------|----------------------------------------------------------------------------------------------| -| `DEAL` | 0 | Place a trade order for an immediate execution with the specified parameters (market order). | -| `PENDING` | 1 | Place a pending order with the specified parameters. | -| `SLTP` | 2 | Modify Stop Loss and Take Profit values of an opened position. | -| `MODIFY` | 3 | Modify the parameters of the order placed previously. | -| `REMOVE` | 4 | Delete the pending order placed previously. | -| `CLOSE_BY` | 5 | Close a position by an opposite one. | +## Overview - -## OrderFilling -```python -class OrderFilling(Repr, IntEnum) -``` -ORDER_TYPE_FILLING Enum. -### Members -| Name | Value | Description | -|----------|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `FILL` | 0 | This execution policy means that an order can be executed only in the specified volume. If the necessary amount of a financial instrument is currently unavailable in the market, the order will not be executed. The desired volume can be made up of several available offers. | -| `FOK` | 1 | This execution policy means that an order can be executed only in the specified volume. If the necessary amount of a financial instrument is currently unavailable in the market, the order will not be executed. The desired volume can be made up of several available offers. | -| `IOC` | 2 | An agreement to execute a deal at the maximum volume available in the market within the volume specified in the order. If the request cannot be filled completely, an order with the available volume will be executed, and the remaining volume will be canceled. | -| `RETURN` | 3 | This policy is used only for market (ORDER_TYPE_BUY and ORDER_TYPE_SELL), limit and stop limit orders (ORDER_TYPE_BUY_LIMIT, ORDER_TYPE_SELL_LIMIT,ORDER_TYPE_BUY_STOP_LIMIT and ORDER_TYPE_SELL_STOP_LIMIT) and only for the symbols with Market or Exchange execution modes. If filled partially, a market or limit order with the remaining volume is not canceled, and is processed further. During activation of the ORDER_TYPE_BUY_STOP_LIMIT and ORDER_TYPE_SELL_STOP_LIMIT orders, an appropriate limit order ORDER_TYPE_BUY_LIMIT/ORDER_TYPE_SELL_LIMIT with the ORDER_FILLING_RETURN type is created. | +Wraps every MT5 constant group into a typed Python enum. Each enum inherits from `Repr` +(which provides MT5-style `__str__`) and `IntEnum`, giving both type safety and integer +interoperability with the MT5 API. - -## OrderTime -```python -class OrderTime(Repr, IntEnum) -``` -ORDER_TIME Enum. -### Members -| Name | Value | Description | -|-----------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `GTC` | 0 | Good till cancel order | -| `DAY` | 1 | Good till current trade day order | -| `SPECIFIED` | 2 | The order is active until the specified date | -| `SPECIFIED_DAY` | 3 | The order is active until 23:59:59 of the specified day. If this time appears to be out of a trading session, the expiration is processed at the nearest trading time. | +## Classes - -## OrderType -```python -class OrderType(Repr, IntEnum) -``` -ORDER_TYPE Enum. -### Members -| Name | Value | Description | -|-------------------|-------|--------------------------------------------------------------------------------------| -| `BUY` | 0 | Market buy order | -| `SELL` | 1 | Market sell order | -| `BUY_LIMIT` | 2 | Buy Limit pending order | -| `SELL_LIMIT` | 3 | Sell Limit pending order | -| `BUY_STOP` | 4 | Buy Stop pending order | -| `SELL_STOP` | 5 | Sell Stop pending order | -| `BUY_STOP_LIMIT` | 6 | Upon reaching the order price, Buy Limit pending order is placed at StopLimit price | -| `SELL_STOP_LIMIT` | 7 | Upon reaching the order price, Sell Limit pending order is placed at StopLimit price | -| `CLOSE_BY` | 8 | Order for closing a position by an opposite one | +### `Repr` -### Properties -| Name | Description | -|------------|------------------------------------| -| `opposite` | Gets the opposite of an order type | +> Mixin that formats enum values as `{__enum_name__}_{name}`. - -#### opposite -```python -@property -def opposite() -``` -Gets the opposite of an order type for closing an open position -#### Returns -| Type | Description | -|------|--------------------------------------| -| int | integer value of opposite order type | +--- - -## BookType -```python -class BookType(Repr, IntEnum) -``` -BOOK_TYPE Enum. -### Members -| Name | Value | Description | -|---------------|-------|----------------------| -| `SELL` | 0 | Sell order (Offer) | -| `BUY` | 1 | Buy order (Bid) | -| `SELL_MARKET` | 2 | Sell order by Market | -| `BUY_MARKET` | 3 | Buy order by Market | +### `TradeAction` - -## TimeFrame -```python -class TimeFrame(Repr, IntEnum) -``` -TIMEFRAME Enum. -### Members -| Name | Value | Description | -|-------|---------|-----------------| -| `M1` | 60 | One Minute | -| `M2` | 120 | Two Minutes | -| `M3` | 180 | Three Minutes | -| `M4` | 240 | Four Minutes | -| `M5` | 300 | Five Minutes | -| `M6` | 360 | Six Minutes | -| `M10` | 600 | Ten Minutes | -| `M15` | 900 | Fifteen Minutes | -| `M20` | 1200 | Twenty Minutes | -| `M30` | 1800 | Thirty Minutes | -| `H1` | 3600 | One Hour | -| `H2` | 7200 | Two Hours | -| `H3` | 10800 | Three Hours | -| `H4` | 14400 | Four Hours | -| `H6` | 21600 | Six Hours | -| `H8` | 28800 | Eight Hours | -| `D1` | 86400 | One Day | -| `W1` | 604800 | One Week | -| `MN1` | 2592000 | One Month | +> Trade request actions (`TRADE_ACTION_*`). +| Member | Description | +|--------|-------------| +| `DEAL` | Immediate market order | +| `PENDING` | Conditional pending order | +| `SLTP` | Modify SL/TP of an open position | +| `MODIFY` | Modify a pending order | +| `REMOVE` | Delete a pending order | +| `CLOSE_BY` | Close by an opposite position | - -### seconds -```python -@property -def seconds() -> int -``` -The number of seconds in a TIMEFRAME +--- +### `OrderFilling` - -#### get_timeframe -```python -@property -def get_timeframe() -``` -Get a timeframe object from a time value in seconds +> Order filling policies (`ORDER_FILLING_*`). -#### Returns: -| Type | Description | -|-----------|-----------------------------| -| TimeFrame | The corresponding timeframe | +`FOK` · `IOC` · `RETURN` +--- - -#### all -```python -@classmethod -def all() -``` -Get all the timeframes +### `OrderTime` -#### Returns: -| Type | Description | -|-----------------------|-----------------------------| -| tuple[TimeFrame, ...] | All the timeframes | +> Time-in-force policies (`ORDER_TIME_*`). +`GTC` · `DAY` · `SPECIFIED` · `SPECIFIED_DAY` - -## CopyTicks -```python -class CopyTicks(Repr, IntEnum) -``` -COPY_TICKS Enum. This defines the types of ticks that can be requested using the copy_ticks_from() and -copy_ticks_range() functions. +--- -### Members -| Name | Value | Description | -|---------|-------|---------------------------------------------------| -| `ALL` | 0 | All ticks | -| `INFO` | 1 | Ticks containing Bid and/or Ask price changes | -| `TRADE` | 2 | Ticks containing Last and/or Volume price changes | +### `OrderType` - -## PositionType -```python -class PositionType(Repr, IntEnum) -``` -POSITION_TYPE Enum. Direction of an open position (buy or sell) -### Members -| Name | Value | Description | -|--------|-------|-------------| -| `BUY` | 0 | Buy | -| `SELL` | 1 | Sell | +> Order types (`ORDER_TYPE_*`). - -## PositionReason -```python -class PositionReason(Repr, IntEnum) -``` -POSITION_REASON Enum. The reason for opening a position is contained in the POSITION_REASON Enum -### Members -| Name | Value | Description | -|----------|-------|------------------------------------------------------------------------------------------------| -| `CLIENT` | 0 | The position was opened as a result of activation of an order placed from a desktop terminal | -| `MOBILE` | 1 | The position was opened as a result of activation of an order placed from a mobile application | -| `WEB` | 2 | The position was opened as a result of activation of an order placed from the web platform | -| `EXPERT` | 3 | The position was opened as a result of activation of an order placed from an MQL5 program | +`BUY` · `SELL` · `BUY_LIMIT` · `SELL_LIMIT` · `BUY_STOP` · `SELL_STOP` · `BUY_STOP_LIMIT` · `SELL_STOP_LIMIT` · `CLOSE_BY` - -## DealType -```python -class DealType(Repr, IntEnum) -``` -DEAL_TYPE enum. Each deal is characterized by a type, allowed values are enumerated in this enum -### Members -| Name | Value | Description | -|----------------------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `BUY` | 0 | Buy | -| `SELL` | 1 | Sell | -| `BALANCE` | 2 | Balance | -| `CREDIT` | 3 | Credit | -| `CHARGE` | 4 | Additional Charge | -| `CORRECTION` | 5 | Correction | -| `BONUS` | 6 | Bonus | -| `COMMISSION` | 7 | Additional Commission | -| `COMMISSION_DAILY` | 8 | Daily Commission | -| `COMMISSION_MONTHLY` | 9 | Monthly Commission | -| `COMMISSION_AGENT_DAILY` | 10 | Daily Agent Commission | -| `COMMISSION_AGENT_MONTHLY` | 11 | Monthly Agent Commission | -| `INTEREST` | 12 | Interest Rate | -| `DEAL_DIVIDEND` | 13 | Dividend Operations | -| `DEAL_DIVIDEND_FRANKED` | 14 | Franked (non-taxable) dividend operations | -| `DEAL_TAX` | 15 | Tax Charges | -| `BUY_CANCELED` | 16 | Canceled buy deal. There can be a situation when a previously executed buy deal is canceled. In this case, the type of the previously executed deal (DEAL_TYPE_BUY) is changed to DEAL_TYPE_BUY_CANCELED, and its profit/loss is zeroized. Previously obtained profit/loss is charged/withdrawn using a separated balance operation | -| `SELL_CANCELED` | 17 | Canceled sell deal. There can be a situation when a previously executed sell deal is canceled. In this case, the type of the previously executed deal (DEAL_TYPE_SELL) is changed to DEAL_TYPE_SELL_CANCELED, and its profit/loss is zeroized. Previously obtained profit/loss is charged/withdrawn using a separated balance operation. | +**Properties:** - -## DealEntry -```python -class DealEntry(Repr, IntEnum) -``` -DEAL_ENTRY Enum. Deals differ not only in their types set in DEAL_TYPE enum, but also in the way they change -positions. This can be a simple position opening, or accumulation of a previously opened position (market entering), -position closing by an opposite deal of a corresponding volume (market exiting), or position reversing, if the -opposite-direction deal covers the volume of the previously opened position. -### Members -| Name | Value | Description | -|----------|-------|-------------------------------------| -| `IN` | 0 | Entry In | -| `OUT` | 1 | Entry Out | -| `INOUT` | 2 | Reverse | -| `OUT_BY` | 3 | Close a position by an opposite one | +| Property | Returns | +|----------|---------| +| `opposite` | The opposite order type | +| `is_long` | `True` for buy-side types | +| `is_short` | `True` for sell-side types | - -## DealReason -```python -class DealReason(Repr, IntEnum) -``` -DEAL_REASON Enum. The reason for deal execution is contained in the DEAL_REASON property. A deal can be executed -as a result of triggering of an order placed from a mobile application or an MQL5 program, as well as as a result -of the StopOut event, variation margin calculation, etc. -### Members -| Name | Value | Description | -|------------|-------|--------------------------------------------------------------------------------------------------------------------------------| -| `CLIENT` | 0 | The deal was executed as a result of activation of an order placed from a desktop terminal | -| `MOBILE` | 1 | The deal was executed as a result of activation of an order placed from a desktop terminal | -| `WEB` | 2 | The deal was executed as a result of activation of an order placed from the web platform | -| `EXPERT` | 3 | The deal was executed as a result of activation of an order placed from an MQL5 program, i.e. an Expert Advisor or a script | -| `SL` | 4 | The deal was executed as a result of Stop Loss activation | -| `TP` | 5 | The deal was executed as a result of Take Profit activation | -| `SO` | 6 | The deal was executed as a result of the Stop Out event | -| `ROLLOVER` | 7 | The deal was executed due to a rollover | -| `VMARGIN` | 8 | The deal was executed after charging the variation margin | -| `SPLIT` | 9 | The deal was executed after the split (price reduction) of an instrument, which had an open position during split announcement | +--- - -## OrderReason -```python -class OrderReason(Repr, IntEnum) -``` -ORDER_REASON Enum. -### Members -| Name | Value | Description | -|----------|-------|----------------------------------------------------------------------------------| -| `CLIENT` | 0 | The order was placed from a desktop terminal | -| `MOBILE` | 1 | The order was placed from a mobile application | -| `WEB` | 2 | The order was placed from a web platform | -| `EXPERT` | 3 | The order was placed from an MQL5-program, i.e. by an Expert Advisor or a script | -| `SL` | 4 | The order was placed as a result of Stop Loss activation | -| `TP` | 5 | The order was placed as a result of Take Profit activation | -| `SO` | 6 | The order was placed as a result of the Stop Out event | +### `TimeFrame` - -## SymbolChartMode -```python -class SymbolChartMode(Repr, IntEnum) -``` -SYMBOL_CHART_MODE Enum. A symbol price chart can be based on Bid or Last prices. The price selected for symbol -charts also affects the generation and display of bars in the terminal. -Possible values of the SYMBOL_CHART_MODE property are described in this enum +> Chart timeframes (`TIMEFRAME_*`). -### Members -| Name | Value | Description | -|--------|-------|-------------------------------| -| `BID` | 0 | Bars are based on Bid prices | -| `LAST` | 1 | Bars are based on last prices | +`M1` · `M2` · `M3` · `M4` · `M5` · `M6` · `M10` · `M15` · `M20` · `M30` · `H1` · `H2` · `H3` · `H4` · `H6` · `H8` · `H12` · `D1` · `W1` · `MN1` - -## SymbolCalcMode -```python -class SymbolCalcMode(Repr, IntEnum) -``` -SYMBOL_CALC_MODE Enum. The SYMBOL_CALC_MODE enumeration is used for obtaining information about how the margin -requirements for a symbol are calculated. -### Members -| Name | Value | Description | -|-----------------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `FOREX` | 0 | Forex mode - calculation of profit and margin for Forex | -| `FOREX_NO_LEVERAGE` | 1 | Forex No Leverage mode – calculation of profit and margin for Forex symbols without taking into account the leverage | -| `FUTURES` | 2 | Futures mode - calculation of margin and profit for futures | -| `CFD` | 3 | CFD mode - calculation of margin and profit for CFD | -| `CFDINDEX` | 4 | CFD index mode - calculation of margin and profit for CFD by indexes | -| `CFDLEVERAGE` | 5 | CFD Leverage mode - calculation of margin and profit for CFD at leverage trading | -| `EXCH_STOCKS` | 6 | Calculation of margin and profit for trading securities on a stock exchange | -| `EXCH_FUTURES` | 7 | Calculation of margin and profit for trading futures contracts on a stock exchange | -| `EXCH_OPTIONS` | 8 | value is 34 | -| `EXCH_OPTIONS_MARGIN` | 9 | value is 36 | -| `EXCH_BONDS` | 10 | Exchange Bonds mode – calculation of margin and profit for trading bonds on a stock exchange | -| `EXCH_STOCKS_MOEX` | 11 | Exchange MOEX Stocks mode –calculation of margin and profit for trading securities on MOEX | -| `EXCH_BONDS_MOEX` | 12 | Exchange MOEX Bonds mode – calculation of margin and profit for trading bonds on MOEX | -| `SERV_COLLATERAL` | 13 | Collateral mode - a symbol is used as a non-tradable asset on a trading account. The market value of an open position is calculated based on the volume, current market price, contract size and liquidity ratio. The value is included into Assets, which are added to Equity. Open positions of such symbols increase the Free Margin amount and are used as additional margin (collateral) for open positions | +| Member / Method | Description | +|-----------------|-------------| +| `seconds` *(property)* | Duration in seconds (e.g. `H1.seconds` → `3600`) | +| `get_timeframe(time)` | Look up a `TimeFrame` from a duration in seconds | +| `all` | Tuple of all timeframes | +--- - -## SymbolTradeMode -```python -class SymbolTradeMode(Repr, IntEnum) -``` -SYMBOL_TRADE_MODE Enum. There are several symbol trading modes. Information about trading modes of a certain -symbol is reflected in the values this enumeration -### Members -| Name | Value | Description | -|-------------|-------|----------------------------------------| -| `DISABLED` | 0 | Trade is disabled for the symbol | -| `LONGONLY` | 1 | Allowed only long positions | -| `SHORTONLY` | 2 | Allowed only short positions | -| `CLOSEONLY` | 3 | Allowed only position close operations | -| `FULL` | 4 | No trade restrictions | +### `CopyTicks` - -## SymbolTradeExecution -```python -class SymbolTradeExecution(Repr, IntEnum) -``` -SYMBOL_TRADE_EXECUTION Enum. The modes, or execution policies, define the rules for cases when the price has -changed or the requested volume cannot be completely fulfilled at the moment. -### Members -| Name | Value | Description | -|------------|-------|---------------------------------------------------------------------------------------------| -| `REQUEST` | 0 | Executing a market order at the price previously received from the broker | -| `INSTANT` | 1 | Executing a market order at the specified price immediately | -| `MARKET` | 2 | A broker makes a decision about the order execution price without any additional discussion | -| `EXCHANGE` | 3 | Trade operations are executed at the prices of the current market offers | +> Tick copy modes (`COPY_TICKS_*`). - -## SymbolSwapMode -```python -class SymbolSwapMode(Repr, IntEnum) -``` -SYMBOL_SWAP_MODE Enum. Methods of swap calculation at position transfer are specified in enumeration -ENUM_SYMBOL_SWAP_MODE. The method of swap calculation determines the units of measure of the SYMBOL_SWAP_LONG and -SYMBOL_SWAP_SHORT parameters. For example, if swaps are charged in the client deposit currency, then the values of -those parameters are specified as an amount of money in the client deposit currency. -### Members -| Name | Value | Description | -|--------------------|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `DISABLED` | 0 | Swaps disabled (no swaps) | -| `POINTS` | 1 | Swaps are charged in points | -| `CURRENCY_SYMBOL` | 2 | Swaps are charged in money in base currency of the symbol | -| `CURRENCY_MARGIN` | 3 | Swaps are charged in money in margin currency of the symbol | -| `CURRENCY_DEPOSIT` | 4 | Swaps are charged in money, in client deposit currency | -| `INTEREST_CURRENT` | 5 | Swaps are charged as the specified annual interest from the instrument price at calculation of swap (standard bank year is 360 days) | -| `INTEREST_OPEN` | 6 | Swaps are charged as the specified annual interest from the open price of position (standard bank year is 360 days) | -| `REOPEN_CURRENT` | 7 | Swaps are charged by reopening positions. At the end of a trading day the position is closed. Next day it is reopened by the close price +/- specified number of points (parameters SYMBOL_SWAP_LONG and SYMBOL_SWAP_SHORT) | -| `REOPEN_BID` | 8 | Swaps are charged by reopening positions. At the end of a trading day the position is closed. Next day it is reopened by the current Bid price +/- specified number of points (parameters SYMBOL_SWAP_LONG and SYMBOL_SWAP_SHORT) | +`ALL` · `INFO` · `TRADE` - -## DayOfWeek -```python -class DayOfWeek(Repr, IntEnum) -``` -DAY_OF_WEEK Enum. -### Members -| Name | Value | Description | -|-------------|-------|-------------| -| `SUNDAY` | 0 | Sunday | -| `MONDAY` | 1 | Monday | -| `TUESDAY` | 2 | Tuesday | -| `WEDNESDAY` | 3 | Wednesday | -| `THURSDAY` | 4 | Thursday | -| `FRIDAY` | 5 | Friday | -| `SATURDAY` | 6 | Saturday | +--- +### `PositionType` - -## SymbolOrderGTCMode -```python -class SymbolOrderGTCMode(Repr, IntEnum) -``` -SYMBOL_ORDER_GTC_MODE Enum. If the SYMBOL_EXPIRATION_MODE property is set to SYMBOL_EXPIRATION_GTC -(good till canceled), the expiration of pending orders, as well as of -Stop Loss/Take Profit orders should be additionally set using the ENUM_SYMBOL_ORDER_GTC_MODE enumeration. -### Members -| Name | Value | Description | -|------------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------| -| `GTC` | 0 | Pending orders and Stop Loss/Take Profit levels are valid for an unlimited period | -| `DAILY` | 1 | Orders are valid during one trading day. At the end of the day, all Stop Loss and Take Profit levels, as well as pending orders are deleted. | -| `DAILY_NO_STOPS` | 2 | When a trade day changes, only pending orders are deleted, while Stop Loss and Take Profit levels are preserved | +> Position direction (`POSITION_TYPE_*`). - -## SymbolOptionRight -```python -class SymbolOptionRight(Repr, IntEnum) -``` -SYMBOL_OPTION_RIGHT Enum. An option is a contract, which gives the right, but not the obligation, -to buy or sell an underlying asset (goods, stocks, futures, etc.) at a specified price on or before a specific date. -The following enumerations describe option properties, including the option type and the right arising from it. -### Members -| Name | Value | Description | -|--------|-------|-----------------------------------------------------------------------------------------------| -| `CALL` | 0 | A call option gives you the right to buy an asset at a specified price. | -| `PUT` | 1 | A put option gives you the right to sell an asset at a specified price. | +`BUY` · `SELL` - -## SymbolOptionMode -```python -class SymbolOptionMode(Repr, IntEnum) -``` -SYMBOL_OPTION_MODE Enum. -### Members -| Name | Value | Description | -|------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------| -| `EUROPEAN` | 0 | European option may only be exercised on a specified date (expiration, execution date, delivery date) | -| `AMERICAN` | 1 | American option may be exercised on any trading day or before expiry. The period within which a buyer can exercise the option is specified for it. | +--- - -## AccountTradeMode -```python -class AccountTradeMode(Repr, IntEnum) -``` -ACCOUNT_TRADE_MODE Enum. There are several types of accounts that can be opened on a trade server. -The type of account on which an MQL5 program is running can be found out using -the ENUM_ACCOUNT_TRADE_MODE enumeration. -### Members -| Name | Value | Description | -|-----------|-------|-----------------| -| `DEMO` | 0 | Demo account | -| `CONTEST` | 1 | Contest account | -| `REAL` | 2 | Real Account | +### `PositionReason` - -## TickFlag -```python -class TickFlag(Repr, IntFlag) -``` -TICK_FLAG Enum. TICK_FLAG defines possible flags for ticks. These flags are used to describe ticks obtained by the -copy_ticks_from() and copy_ticks_range() functions. -### Members -| Name | Value | Description | -|----------|-------|-------------------------| -| `BID` | 2 | Bid price changed | -| `ASK` | 4 | Ask price changed | -| `LAST` | 8 | Last price changed | -| `VOLUME` | 16 | Volume changed | -| `BUY` | 32 | last Buy price changed | -| `SELL` | 64 | last Sell price changed | +> Reason for opening a position (`POSITION_REASON_*`). - -## TradeRetcode -```python -class TradeRetcode(Repr, IntEnum) -``` -TRADE_RETCODE Enum. Return codes for order send/check operations -### Members -| Name | Value | Description | -|------------------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------| -| `OK` | 10009 | OK | -| `REQUOTE` | 10004 | Requote | -| `REJECT` | 10006 | Reject | -| `CANCEL` | 10007 | Cancel | -| `PLACED` | 10008 | Placed | -| `DONE` | 10009 | Done | -| `DONE_PARTIAL` | 10010 | Done Partial | -| `ERROR` | 10011 | Error | -| `TIMEOUT` | 10012 | Timeout | -| `INVALID` | 10013 | Invalid | -| `INVALID_VOLUME` | 10014 | Invalid Volume | -| `INVALID_PRICE` | 10015 | Invalid Price | -| `INVALID_STOPS` | 10016 | Invalid Stops | -| `TRADE_DISABLED` | 10017 | Trade is disabled | -| `MARKET_CLOSED` | 10018 | Market is closed | -| `NO_MONEY` | 10019 | No money | -| `PRICE_CHANGED` | 10020 | Price changed | -| `PRICE_OFF` | 10021 | Price off | -| `INVALID_EXPIRATION` | 10022 | Invalid expiration | -| `ORDER_CHANGED` | 10023 | Order state changed | -| `TOO_MANY_REQUESTS` | 10024 | Too frequent requests | -| `NO_CHANGES` | 10025 | No changes in request | -| `SERVER_DISABLES_AT` | 10026 | Autotrading disabled by server | -| `CLIENT_DISABLES_AT` | 10027 | Autotrading disabled by client terminal | -| `LOCKED` | 10028 | Request locked for processing | -| `FROZEN` | 10029 | Order or position frozen | -| `INVALID_FILL` | 10030 | Invalid order filling type | -| `CONNECTION` | 10031 | No connection with the trade server | -| `ONLY_REAL` | 10032 | Operation is allowed only for live accounts | -| `LIMIT_ORDERS` | 10033 | The number of pending orders has reached the limit | -| `LIMIT_VOLUME` | 10034 | The volume of orders and positions for the symbol has reached the limit | -| `INVALID_ORDER` | 10035 | Incorrect or prohibited order type | -| `POSITION_CLOSED` | 10036 | Position with the specified POSITION_IDENTIFIER has already been closed | -| `INVALID_CLOSE_VOLUME` | 10037 | A close volume exceeds the current position volume | -| `CLOSE_ORDER_EXIST` | 10038 | A close order already exists for a specified position. This may happen when working in the hedging system | -| `LIMIT_POSITIONS` | 10039 | The number of open positions simultaneously present on an account can be limited by the server settings | -| `REJECT_CANCEL` | 10040 | The pending order activation request is rejected, the order is canceled | -| `LONG_ONLY` | 10041 | The request is rejected, because the "Only long positions are allowed" rule is set for the symbol (POSITION_TYPE_BUY) | -| `SHORT_ONLY` | 10042 | The request is rejected, because the "Only short positions are allowed" rule is set for the symbol (POSITION_TYPE_SELL) | -| `CLOSE_ONLY` | 10043 | The request is rejected, because the "Only position closing is allowed" rule is set for the symbol | -| `FIFO_CLOSE` | 10044 | The request is rejected, because "Position closing is allowed only by FIFO rule" flag is set for the trading account (ACCOUNT_FIFO_CLOSE=true) | +`CLIENT` · `MOBILE` · `WEB` · `EXPERT` - -## AccountStopOutMode -```python -class AccountStopOutMode(Repr, IntEnum) -``` -ACCOUNT_STOPOUT_MODE Enum. -### Members -| Name | Value | Description | -|-----------|-------|-----------------------------------| -| `PERCENT` | 0 | Account stop out mode in percents | -| `MONEY` | 1 | Account stop out mode in money | +--- - -## AccountMarginMode -```python -class AccountMarginMode(Repr, IntEnum) -``` -ACCOUNT_MARGIN_MODE Enum. -### Members -| Name | Value | Description | -|------------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `RETAIL_NETTING` | 0 | Used for the OTC markets to interpret positions in the "netting" mode (only one position can exist for one symbol). The margin is calculated based on the symbol type (SYMBOL_TRADE_CALC_MODE). | -| `EXCHANGE` | 1 | Used for the exchange markets. Margin is calculated based on the discounts specified in symbol settings. Discounts are set by the broker, but not less than the values set by the exchange. | -| `RETAIL_HEDGING` | 2 | Used for the exchange markets where individual positions are possible (hedging, multiple positions can exist for one symbol). The margin is calculated based on the symbol type (SYMBOL_TRADE_CALC_MODE) taking into account the hedged margin (SYMBOL_MARGIN_HEDGED). | +### `DealType` + +> Deal types (`DEAL_TYPE_*`). + +`BUY` · `SELL` · `BALANCE` · `CREDIT` · `CHARGE` · `CORRECTION` · `BONUS` · `COMMISSION` · `COMMISSION_DAILY` · `COMMISSION_MONTHLY` · `COMMISSION_AGENT_DAILY` · `COMMISSION_AGENT_MONTHLY` · `INTEREST` · `BUY_CANCELED` · `SELL_CANCELED` · `DEAL_DIVIDEND` · `DEAL_DIVIDEND_FRANKED` · `DEAL_TAX` + +--- + +### `DealEntry` + +> Deal entry direction (`DEAL_ENTRY_*`). + +`IN` · `OUT` · `INOUT` · `OUT_BY` + +--- + +### `DealReason` + +> Reason for deal execution (`DEAL_REASON_*`). + +`CLIENT` · `MOBILE` · `WEB` · `EXPERT` · `SL` · `TP` · `SO` · `ROLLOVER` · `VMARGIN` · `SPLIT` + +--- + +### `OrderReason` + +> Reason for placing an order (`ORDER_REASON_*`). + +`CLIENT` · `MOBILE` · `WEB` · `EXPERT` · `SL` · `TP` · `SO` + +--- + +### Other Enums + +| Enum | Members | +|------|---------| +| `BookType` | `SELL`, `BUY`, `SELL_MARKET`, `BUY_MARKET` | +| `SymbolChartMode` | `BID`, `LAST` | +| `SymbolCalcMode` | `FOREX`, `FUTURES`, `CFD`, `CFDINDEX`, `CFDLEVERAGE`, … | +| `SymbolTradeMode` | `DISABLED`, `LONGONLY`, `SHORTONLY`, `CLOSEONLY`, `FULL` | +| `SymbolTradeExecution` | `REQUEST`, `INSTANT`, `MARKET`, `EXCHANGE` | +| `SymbolSwapMode` | `DISABLED`, `POINTS`, `CURRENCY_SYMBOL`, … | +| `DayOfWeek` | `SUNDAY` through `SATURDAY` | +| `SymbolOrderGTCMode` | `GTC`, `DAILY`, `DAILY_NO_STOPS` | +| `SymbolOptionRight` | `CALL`, `PUT` | +| `SymbolOptionMode` | `EUROPEAN`, `AMERICAN` | +| `AccountTradeMode` | `DEMO`, `CONTEST`, `REAL` | +| `AccountStopOutMode` | `PERCENT`, `MONEY` | +| `AccountMarginMode` | `RETAIL_NETTING`, `EXCHANGE`, `RETAIL_HEDGING` | +| `TickFlag` | `BID`, `ASK`, `LAST`, `VOLUME`, `BUY`, `SELL` | +| `TradeRetcode` | `REQUOTE`, `DONE`, `ERROR`, `TIMEOUT`, `INVALID`, … | diff --git a/docs/core/db.md b/docs/core/db.md new file mode 100644 index 0000000..9be2a1f --- /dev/null +++ b/docs/core/db.md @@ -0,0 +1,51 @@ +# db + +`aiomql.core.db` — SQLite ORM base class with dataclass support. + +## Overview + +The `DB` class provides ORM-style CRUD operations backed by SQLite. Classes that inherit +from `DB` and are decorated with `@dataclass` automatically get a database table whose +columns mirror the dataclass fields. Column types, defaults, and constraints (e.g. +`PRIMARY KEY`) are derived from field metadata. + +## Classes + +### `DB` + +> Base class for ORM-style database operations. + +| Class Attribute | Type | Description | +|-----------------|------|-------------| +| `table_name` | `ClassVar[str]` | Table name (defaults to class name) | + +#### Schema Helpers + +| Method | Description | +|--------|-------------| +| `pk` *(property)* | Returns `(field_name, value)` for the PRIMARY KEY field | +| `init_db()` | Initialises the connection and creates the table | +| `get_connection()` | Returns a new `sqlite3.Connection` with a custom row factory | +| `create_table(conn)` | Creates the table if it doesn't exist | +| `get_columns()` | Generates column definitions from dataclass fields | +| `types(key)` | Maps a Python type to its SQLite equivalent | +| `get_default(col)` | Returns the `DEFAULT` SQL clause for a field | +| `get_metadata(col)` | Extracts SQL constraints (e.g. `PRIMARY KEY`) from field metadata | +| `dict_factory()` | Returns a row factory that converts rows into class instances | +| `sanitize(identifier)` | Sanitises a SQL identifier to prevent injection | + +#### CRUD Operations + +| Method | Description | +|--------|-------------| +| `save(commit=True, update=False, data=None, conn=None)` | Inserts or updates a record | +| `get(**kwargs)` | Returns the first matching record, or `None` | +| `filter(**kwargs)` | Returns all matching records (or all if no criteria) | +| `clear()` | Deletes all records from the table | + +#### Serialisation + +| Method | Description | +|--------|-------------| +| `asdict()` | Converts the instance to a dictionary | +| `get_data()` | Returns instance data for saving | diff --git a/docs/core/errors.md b/docs/core/errors.md index ec4f9e3..652b680 100644 --- a/docs/core/errors.md +++ b/docs/core/errors.md @@ -1,34 +1,34 @@ -# Errors +# errors -## Tabel of contents -- [Error](#errors.error) -- [is_connection_error](#errors.is_connection_error) +`aiomql.core.errors` — MetaTrader 5 error wrapper. +## Overview - -## Error -```python -class Error -``` -Error class for handling errors. +Provides the `Error` class for representing and inspecting errors returned by the MetaTrader 5 +terminal. Wraps numeric error codes with human-readable descriptions. -#### Attributes: -| Name | Type | Description | -|----------------|--------------|----------------------------------------------| -| `code` | `int` | Error code | -| `description` | `str` | Error description | -| `descriptions` | `dict` | A dictionary of error codes and descriptions | -| `conn_errors` | `tuple[int]` | A tuple of connection errors | +## Classes +### `Error` - -## is_connection_error -```python -def is_connection_error(self) -> bool -``` -Check if an error is a connection error. +> Wraps an MT5 error code with a description and category helpers. -#### Returns: -| Type | Description | -|--------|------------------------------------------------------| -| `bool` | True if error is a connection error, False otherwise | +| Attribute | Type | Description | +|-----------|------|-------------| +| `code` | `int` | Numeric error code | +| `description` | `str` | Human-readable description | +| `descriptions` | `dict[int, str]` | Class-level mapping of known error codes → descriptions | +| `conn_errors` | `tuple[int, ...]` | Codes that indicate connection-level failures | + +#### `__init__(code=1, description="")` + +Creates an `Error`. If `description` is empty, the description is looked up from +`descriptions`. Defaults to `"unknown error"` for unrecognised codes. + +#### `is_connection_error()` + +Returns `True` if `code` is in `conn_errors`. + +#### `__repr__()` + +Returns `"code: description"`. diff --git a/docs/core/exceptions.md b/docs/core/exceptions.md index f3d6ea1..90a01f8 100644 --- a/docs/core/exceptions.md +++ b/docs/core/exceptions.md @@ -1,49 +1,19 @@ -# Exceptions -Exceptions for the aiomql package. +# exceptions -## Table of Contents -- [LoginError](#exceptions.login_error) -- [VolumeError](#exceptions.volume_error) -- [SymbolError](#exceptions.symbol_error) -- [OrderError](#exceptions.order_error) -- [StopTradingError](#exceptions.stop_trading_error) +`aiomql.core.exceptions` — Custom exception hierarchy for the aiomql package. - - -### LoginError -```python -class LoginError(Exception) -``` -Raised when an error occurs when logging in. +## Overview +Defines domain-specific exceptions used throughout the library to signal +trading and connection errors. - -### VolumeError -```python -class VolumeError(Exception) -``` -Raised when a volume is not valid or out of range for a symbol. +## Exceptions - - -### SymbolError -```python -class SymbolError(Exception) -``` -Raised when a symbol is not provided where required or not available in the Market Watch. - - - -### OrderError -```python -class OrderError(Exception) -``` -Raised when an error occurs when working with the order class. - - - -### StopTradingError -```python -class StopTradingError(Exception) -``` -Raised when an error occurs when trying to stop trading. +| Exception | Base | Description | +|-----------|------|-------------| +| `LoginError` | `Exception` | Raised when a login attempt fails | +| `VolumeError` | `Exception` | Raised when a volume is invalid or out of range for a symbol | +| `SymbolError` | `Exception` | Raised when a required symbol is missing or not in Market Watch | +| `OrderError` | `Exception` | Raised when an error occurs while working with the `Order` class | +| `StopTrading` | `Exception` | Raised to signal that trading should stop | +| `InvalidRequest` | `Exception` | Raised when a market query fails | diff --git a/docs/core/meta_backtester.md b/docs/core/meta_backtester.md deleted file mode 100644 index 7a009e1..0000000 --- a/docs/core/meta_backtester.md +++ /dev/null @@ -1,47 +0,0 @@ -# MetaBackTester - -## Table of Contents -- [MetaBackTester](#metabacktester) -- [\__init\__](#metabacktester.__init__) -- [backtest_engine](#metabacktester.backtest_engine) -- [backtest_engine.setter](#metabacktester.backtest_engine.setter) - - - -### MetaBackTester -```python -class MetaBackTester(MetaTrader) -``` -A class for testing trading strategies in the MetaTrader 5 terminal. A subclass of MetaTrader. - -#### Attributes: -| Name | Type | Description | -|-------------------|------------------|---------------------------------------------------------------| -| `backtest_engine` | `BackTestEngine` | The backtesting engine to use for testing trading strategies. | - - - -### \__init\__ -```python -def __init__(self, *, backtest_engine: BackTestEngine = None) -``` - -#### Parameters: -| Name | Type | Description | -|-------------------|------------------|--------------------------------------------------| -| `backtest_engine` | `BackTestEngine` | The backtesting engine to use for testing trades | - - -```python -@property -def backtest_engine(self) -> BackTestEngine -``` -Returns the backtest engine object. - - - -```python -@backtest_engine.setter -def backtest_engine(self, value: BackTestEngine): -``` -Sets the backtest engine object. diff --git a/docs/core/meta_trader.md b/docs/core/meta_trader.md index 9b86186..cb6d12c 100644 --- a/docs/core/meta_trader.md +++ b/docs/core/meta_trader.md @@ -1,712 +1,98 @@ -# MetaTrader -The MetaTrader Class provides an asynchronous wrapper around the MetaTrader5 API. +# meta_trader -## Table of Contents -- [MetaTrader](#meta_trader.meta_trader) -- [\__aenter\__](#meta_trader.__aenter__) -- [\__aexit\__](#meta_trader.__aexit__) -- [login](#meta_trader.login) -- [initialize](#meta_trader.initialize) -- [login_sync](#meta_trader.login_sync) -- [initialize_sync](#meta_trader.initialize_sync) -- [shutdown](#meta_trader.shutdown) -- [version](#meta_trader.version) -- [account_info](#meta_trader.account_info) -- [terminal_info](#meta_trader.terminal_info) -- [last_error](#meta_trader.last_error) -- [symbols_total](#meta_trader.symbols_total) -- [symbols_get](#meta_trader.symbols_get) -- [symbol_info](#meta_trader.symbol_info) -- [symbol_info_tick](#meta_trader.symbol_info_tick) -- [symbol_select](#meta_trader.symbol_select) -- [market_book_add](#meta_trader.market_book_add) -- [market_book_get](#meta_trader.market_book_get) -- [market_book_release](#meta_trader.market_book_release) -- [copy_rates_from](#meta_trader.copy_rates_from) -- [copy_rates_from_pos](#meta_trader.copy_rates_from_pos) -- [copy_rates_range](#meta_trader.copy_rates_range) -- [copy_ticks_from](#meta_trader.copy_ticks_from) -- [copy_ticks_range](#meta_trader.copy_ticks_range) -- [orders_total](#meta_trader.orders_total) -- [orders_get](#meta_trader.orders_get) -- [order_calc_margin](#meta_trader.order_calc_margin) -- [order_calc_profit](#meta_trader.order_calc_profit) -- [order_check](#meta_trader.order_check) -- [order_send](#meta_trader.order_send) -- [positions_total](#meta_trader.positions_total) -- [positions_get](#meta_trader.positions_get) -- [history_orders_total](#meta_trader.history_orders_total) -- [history_orders_get](#meta_trader.history_orders_get) -- [history_deals_total](#meta_trader.history_deals_total) -- [history_deals_get](#meta_trader.history_deals_get) +`aiomql.core.meta_trader` — Async/sync singleton interface to the MetaTrader 5 terminal. - -### MetaTrader -```python -class MetaTrader(MetaCore) -``` -The MetaTrader class is a wrapper around the MetaTrader terminal. -It provides methods for connecting to the MetaTrader terminal and retrieving data from it. +## Overview -#### Attributes: -| Name | Type | Description | Default | -|-------|-------|--------------------------------------------------------|------------------------| -| error | Error | The last error encountered by the MetaTrader terminal. | Error(1, 'Successful') | +The `MetaTrader` class wraps every MT5 API call with async execution via +`asyncio.to_thread` and automatic retry logic for transient connection errors. +It is a **singleton** — only one instance exists per process. -#### Notes: -All the attributes, enums and constants of the MetaTrader5 class are also available here. Although, they are more easily -accessible and used via the various enums and models defined in the module. +A synchronous counterpart lives in `aiomql.core.sync.meta_trader`. +## Classes - -### \__aenter\__ -```python -async def __aenter__() -> 'MetaTrader' -``` -Async context manager entry point. -Initializes the connection to the MetaTrader terminal. +### `MetaTrader` -#### Returns: -| Type | Description | -|--------------|-------------------------------------| -| `MetaTrader` | An instance of the MetaTrader class | +> Asynchronous interface to the MetaTrader 5 terminal. +| Attribute | Type | Description | +|-----------|------|-------------| +| `error` | `Error` | The last error from the terminal | +| `config` | `Config` | The global configuration instance | - -### \__aexit\__ -```python -async def __aexit__(exc_type, exc_val, exc_tb) -``` -Async context manager exit point. Closes the connection to the MetaTrader terminal. +#### Connection +| Method | Description | +|--------|-------------| +| `initialize(path, login, password, server, timeout, portable)` | Initialises the terminal connection | +| `initialize_sync(…)` | Synchronous variant of `initialize` | +| `login(*, login, password, server, timeout)` | Logs into a trading account | +| `login_sync(…)` | Synchronous variant of `login` | +| `shutdown()` | Closes the terminal connection | +| `__aenter__` / `__aexit__` | Async context manager for connect/disconnect | - -### login -```python -async def login(*, login: int, password: str, server: str, timeout: int = 60000) -> bool -``` -Connects to the MetaTrader terminal using the specified login, password and server. +#### Account & Terminal -#### Parameters: -| Name | Type | Description | -|------------|-------|--------------------------------------------| -| `login` | `int` | The trading account number. | -| `password` | `str` | The trading account password. | -| `server` | `str` | The trading server name. | -| `timeout` | `int` | The timeout for the connection in seconds. | +| Method | Returns | Description | +|--------|---------|-------------| +| `account_info()` | `AccountInfo \| None` | Current account details | +| `terminal_info()` | `TerminalInfo \| None` | Terminal information | +| `version()` | `tuple[int,int,str] \| None` | Terminal version | +| `last_error()` | `tuple[int,str]` | Last error code and description | -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | +#### Symbols +| Method | Returns | +|--------|---------| +| `symbols_total()` | `int` | +| `symbols_get(group)` | `tuple[SymbolInfo, …] \| None` | +| `symbol_info(symbol)` | `SymbolInfo \| None` | +| `symbol_info_tick(symbol)` | `Tick \| None` | +| `symbol_select(symbol, enable)` | `bool` | - -#### login_sync -```python -async def login_sync(*, login: int, password: str, server: str, timeout: int = 60000) -> bool -``` -A synchronous version of the login method. -Connects to the MetaTrader terminal using the specified login, password and server. +#### Market Data -#### Parameters: -| Name | Type | Description | -|------------|-------|--------------------------------------------| -| `login` | `int` | The trading account number. | -| `password` | `str` | The trading account password. | -| `server` | `str` | The trading server name. | -| `timeout` | `int` | The timeout for the connection in seconds. | +| Method | Returns | +|--------|---------| +| `copy_rates_from(symbol, timeframe, date_from, count)` | `ndarray \| None` | +| `copy_rates_from_pos(symbol, timeframe, start_pos, count)` | `ndarray \| None` | +| `copy_rates_range(symbol, timeframe, date_from, date_to)` | `ndarray \| None` | +| `copy_ticks_from(symbol, date_from, count, flags)` | `ndarray \| None` | +| `copy_ticks_range(symbol, date_from, date_to, flags)` | `ndarray \| None` | -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | +#### Orders & Positions +| Method | Returns | +|--------|---------| +| `positions_total()` | `int` | +| `positions_get(group, symbol, ticket)` | `tuple[TradePosition, …] \| None` | +| `orders_total()` | `int` | +| `orders_get(group, symbol, ticket)` | `tuple[TradeOrder, …] \| None` | +| `history_orders_total(date_from, date_to)` | `int` | +| `history_orders_get(date_from, date_to, group, ticket, position)` | `tuple[TradeOrder, …] \| None` | +| `history_deals_total(date_from, date_to)` | `int` | +| `history_deals_get(date_from, date_to, group, ticket, position)` | `tuple[TradeDeal, …] \| None` | - -### initialize -```python -async def initialize(path: str = "", login: int = 0, password: str = "", server: str = "", - timeout: int | None = None, portable=False) -> bool -``` -Initializes the connection to the MetaTrader terminal. All parameters are optional. +#### Trade Execution -#### Parameters: -| Name | Type | Description | -|------------|---------------|----------------------------------------------------------| -| `path` | `str` | The path to the MetaTrader terminal executable. | -| `login` | `int` | The trading account number. | -| `password` | `str` | The trading account password. | -| `server` | `str` | The trading server name. | -| `timeout` | `int \| None` | The timeout for the connection in seconds. | -| `portable` | `bool` | If True, the terminal will be launched in portable mode. | +| Method | Returns | Description | +|--------|---------|-------------| +| `order_check(request)` | `OrderCheckResult \| None` | Validates a trade request | +| `order_send(request)` | `OrderSendResult \| None` | Sends a trade request | +| `order_calc_margin(action, symbol, volume, price)` | `float \| None` | Calculates required margin | +| `order_calc_profit(action, symbol, volume, price_open, price_close)` | `float \| None` | Calculates expected profit | -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | +#### Market Book +| Method | Description | +|--------|-------------| +| `market_book_add(symbol)` | Subscribes to market depth | +| `market_book_get(symbol)` | Gets current market depth | +| `market_book_release(symbol)` | Unsubscribes from market depth | - -### initialize_sync -```python -async def initialize_sync(path: str = "", login: int = 0, password: str = "", server: str = "", - timeout: int | None = None, portable=False) -> bool -``` -Initializes the connection to the MetaTrader terminal. All parameters are optional. +#### Internal -#### Parameters: -| Name | Type | Description | -|------------|---------------|----------------------------------------------------------| -| `path` | `str` | The path to the MetaTrader terminal executable. | -| `login` | `int` | The trading account number. | -| `password` | `str` | The trading account password. | -| `server` | `str` | The trading server name. | -| `timeout` | `int \| None` | The timeout for the connection in seconds. | -| `portable` | `bool` | If True, the terminal will be launched in portable mode. | - -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | - - - -### shutdown -```python -async def shutdown() -> None -``` -Closes the connection to the MetaTrader terminal. - - - -### version -```python -async def version() -> tuple[int, int, str] | None -``` -Returns the version of the MetaTrader terminal. - -#### Returns: -| Type | Description | -|------------------------|-----------------------------------------------------------------------------------------------| -| `tuple[int, int, str]` | A tuple of the MetaTrader terminal version. `Terminal Version`, `Build`, `Build Release Date` | - - - -### account_info -```python -async def account_info() -> AccountInfo | None -``` -Returns the account information for the connected account. - -#### Returns: -| Type | Description | -|---------------|--------------------------------------| -| `AccountInfo` | An instance of the AccountInfo class | - - - -### terminal_info -```python -async def terminal_info() -> TerminalInfo | None -``` - -Returns the terminal information for the connected terminal. -### Returns -| Type | Description | -|----------------|------------------------------------------------| -| `TerminalInfo` | An instance of the TerminalInfo class. A tuple | - - - -### last_error -```python -async def last_error() -> tuple[int, str] -``` -Returns the last error code and description. - -#### Returns: -| Type | Description | -|-------------------|-------------------------------------------------| -| `tuple[int, str]` | A tuple of the last error code and description. | - - - -### symbols_total -```python -async def symbols_total() -> int -``` -Returns the total number of symbols. - -#### Returns: -| Type | Description | -|-------|------------------------------| -| `int` | The total number of symbols. | - - - -### symbols_get -```python -async def symbols_get(group: str = "") -> tuple[SymbolInfo] | None -``` -Returns the symbol information for all symbols or for a specified group. - -#### Parameters: -| Name | Type | Description | -|---------|-------|--------------------------------------------------------------------------------------------------------------------------------------------------------| -| `group` | `str` | The group name. Optional named parameter. If the group is specified, the function returns only symbols meeting a specified criteria for a symbol name. | - -#### Returns: -| Type | Description | -|---------------------|--------------------------------| -| `tuple[SymbolInfo]` | A tuple of SymbolInfo objects. | - - - -### symbol_info -```python -async def symbol_info(symbol: str) -> SymbolInfo | None -``` -Returns the symbol information for the specified symbol. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `symbol` | `str` | The symbol name. | - -#### Returns: -| Type | Description | -|--------------|--------------------------------------| -| `SymbolInfo` | An instance of the SymbolInfo class. | - - - -### symbol_info_tick -```python -async def symbol_info_tick(symbol: str) -> Tick | None -``` -Returns the latest tick for the specified symbol. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `symbol` | `str` | The symbol name. | - -#### Returns: -| Type | Description | -|--------|--------------------------------| -| `Tick` | An instance of the Tick class. | - - - -### symbol_select -```python -async def symbol_select(symbol: str, enable: bool) -> bool -``` -Selects or unselects the specified symbol in the Market Watch window. - -#### Parameters: -| Name | Type | Description | -|----------|--------|--------------------------------------------------------------------------------| -| `symbol` | `str` | The symbol name. | -| `enable` | `bool` | If True, the symbol will be selected. If False, the symbol will be unselected. | - -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | - - - -### market_book_add -```python -async def market_book_add(symbol: str) -> bool -``` -Adds the specified symbol to the market book. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `symbol` | `str` | The symbol name. | - -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | - - - -### market_book_get -```python -async def market_book_get(symbol: str) -> tuple[BookInfo] | None -``` -Returns the market depth for the specified symbol. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `symbol` | `str` | The symbol name. | - -#### Returns: -| Type | Description | -|-------------------|------------------------------| -| `tuple[BookInfo]` | A tuple of BookInfo objects. | - - - -### market_book_release -```python -async def market_book_release(symbol: str) -> bool -``` -Removes the specified symbol from the market book. - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------| -| `symbol` | `str` | The symbol name. | - -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, False otherwise. | - - - -### copy_rates_from -```python -async def copy_rates_from(symbol: str, timeframe: TimeFrame, date_from: datetime | int, - count: int) -> numpy.ndarray | None -``` -Returns the OHLCV rates for the specified symbol and timeframe starting from the specified date. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------| -| `symbol` | `str` | The symbol name. | -| `timeframe` | `TimeFrame` | The timeframe. | -| `date_from` | `datetime` or `int` | The date to start from. | -| `count` | `int` | The number of rates to return. | - -#### Returns: -| Type | Description | -|-----------------|-------------------------------| -| `numpy.ndarray` | A numpy array of OHLCV rates. | - - - -### copy_rates_from_pos -```python -async def copy_rates_from_pos(symbol: str, timeframe: TimeFrame, start_pos: int, count: int) -> numpy.ndarray | None -``` -Returns the OHLCV rates for the specified symbol and timeframe starting from the specified position. - -#### Parameters: -| Name | Type | Description | -|-------------|-------------|--------------------------------| -| `symbol` | `str` | The symbol name. | -| `timeframe` | `TimeFrame` | The timeframe. | -| `start_pos` | `int` | The position to start from. | -| `count` | `int` | The number of rates to return. | - -#### Returns: -| Type | Description | -|-----------------|-------------------------------| -| `numpy.ndarray` | A numpy array of OHLCV rates. | - - - -### copy_rates_range -```python -async def copy_rates_range(symbol: str, timeframe: TimeFrame, date_from: datetime | int, - date_to: datetime | int) -> numpy.ndarray | None -``` -Returns the OHLCV rates for the specified symbol and timeframe between the specified dates. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|------------------| -| `symbol` | `str` | The symbol name. | -| `timeframe` | `TimeFrame` | The timeframe. | -| `date_from` | `datetime` or `int` | The start date. | -| `date_to` | `datetime` or `int` | The end date. | - -#### Returns: -| Type | Description | -|-----------------|-------------------------------| -| `numpy.ndarray` | A numpy array of OHLCV rates. | - - - -### copy_ticks_from -```python -async def copy_ticks_from(symbol: str, date_from: datetime | int, count: int, flags: CopyTicks) -> tuple[Tick] | None -``` -Returns the ticks for the specified symbol starting from the specified date. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|--------------------------------| -| `symbol` | `str` | The symbol name. | -| `date_from` | `datetime` or `int` | The date to start from. | -| `count` | `int` | The number of ticks to return. | -| `flags` | `CopyTicks` | The CopyTicks flags. | - -#### Returns: -| Type | Description | -|---------------|--------------------------| -| `tuple[Tick]` | A tuple of Tick objects. | - - - -### copy_ticks_range -```python -async def copy_ticks_range(symbol: str, date_from: datetime | int, date_to: datetime | int, - flags: CopyTicks) -> tuple[Tick] | None -``` -Returns the ticks for the specified symbol between the specified dates. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|----------------------| -| `symbol` | `str` | The symbol name. | -| `date_from` | `datetime` or `int` | The start date. | -| `date_to` | `datetime` or `int` | The end date. | -| `flags` | `CopyTicks` | The CopyTicks flags. | - -#### Returns: -| Type | Description | -|---------------|--------------------------| -| `tuple[Tick]` | A tuple of Tick objects. | - - - -### orders_total -```python -async def orders_total() -> int -``` -Returns the total number of active orders. - -#### Returns: -| Type | Description | -|-------|------------------------------------| -| `int` | The total number of active orders. | - - - -### orders_get -```python -async def orders_get(group: str = "", ticket: int = 0, symbol: str = "") -> tuple[TradeOrder, ...] | None -``` -Get active orders with the ability to filter by symbol or ticket. There are three call options. -Call without parameters. Return active orders on all symbols - -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `group` | `str` | The filter for arranging a group of necessary symbols. Optional named parameter. If the group is specified, the function returns only active orders meeting a specified criteria for a symbol name. | -| `ticket` | `int` | Order ticket (ORDER_TICKET). Optional named parameter. | -| `symbol` | `str` | Symbol name. Optional named parameter. If a symbol is specified, the ticket parameter is ignored. | - -#### Returns: -| Type | Description | -|--------------------------|------------------------------------------------------| -| `tuple[TradeOrder, ...]` | A tuple of active trade orders as TradeOrder objects | - - - -### order_calc_margin -```python -async def order_calc_margin(action: OrderType, symbol: str, volume: float, price: float) -> float | None -``` -Calculates the margin required to open a trade. - -#### Parameters: -| Name | Type | Description | -|----------|-------------|-------------------| -| `action` | `OrderType` | The order type. | -| `symbol` | `str` | The symbol name. | -| `volume` | `float` | The order volume. | -| `price` | `float` | The order price. | - -#### Returns: -| Type | Description | -|---------|--------------------------------------| -| `float` | The margin required to open a trade. | - - - -### order_calc_profit -```python -async def order_calc_profit(action: OrderType, symbol: str, volume: float, price_open: float, - price_close: float) -> float | None -``` -Calculates the profit for a closed trade. - -#### Parameters: -| Name | Type | Description | -|---------------|-------------|------------------------| -| `action` | `OrderType` | The order type. | -| `symbol` | `str` | The symbol name. | -| `volume` | `float` | The order volume. | -| `price_open` | `float` | The order open price. | -| `price_close` | `float` | The order close price. | - -#### Returns: -| Type | Description | -|---------|--------------------------------| -| `float` | The profit for a closed trade. | - - - -### order_check -```python -async def order_check(request: dict) -> OrderCheckResult -``` -Checks the specified order for validity. - -#### Parameters: -| Name | Type | Description | -|-----------|--------|--------------------| -| `request` | `dict` | The order request. | - -#### Returns: -| Type | Description | -|--------------------|--------------------------------------------| -| `OrderCheckResult` | An instance of the OrderCheckResult class. | - - - -### order_send -```python -async def order_send(request: dict) -> OrderSendResult -``` -Sends the specified order request to the MetaTrader terminal. - -#### Parameters: -| Name | Type | Description | -|-----------|--------|--------------------| -| `request` | `dict` | The order request. | - -#### Returns: -| Type | Description | -|-------------------|-------------------------------------------| -| `OrderSendResult` | An instance of the OrderSendResult class. | - - - -### positions_total -```python -async def positions_total() -> int -``` -Returns the total number of open positions. - -#### Returns: -| Type | Description | -|-------|-------------------------------------| -| `int` | The total number of open positions. | - - - -### positions_get -```python -async def positions_get(group: str = "", ticket: int = 0, symbol: str = "") -> tuple[TradePosition, ...] | None -``` -Returns the open positions with the ability to filter by symbol or ticket. There are three call options. -Call without parameters. Return open positions on all symbols - -#### Parameters: -| Name | Type | Description | -|----------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `group` | `str` | The filter for arranging a group of necessary symbols. Optional named parameter. If the group is specified, the function returns only open positions meeting a specified criteria for a symbol name. | -| `ticket` | `int` | Position ticket (POSITION_TICKET). Optional named parameter. | -| `symbol` | `str` | Symbol name. Optional named parameter. If a symbol is specified, the ticket parameter is ignored. | - -#### Returns: -| Type | Description | -|-----------------------------|----------------------------------------------------------| -| `tuple[TradePosition, ...]` | A tuple of open trade positions as TradePosition objects | - - - -### history_orders_total -```python -async def history_orders_total(date_from: datetime | int, date_to: datetime | int) -> int -``` -Returns the total number of closed orders for the specified period. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|-----------------| -| `date_from` | `datetime` or `int` | The start date. | -| `date_to` | `datetime` or `int` | The end date. | - -#### Returns: -| Type | Description | -|-------|-------------------------------------------------------------| -| `int` | The total number of closed orders for the specified period. | - - - -### history_orders_get -```python -async def history_orders_get(date_from: datetime | int = None, date_to: datetime | int = None, group: str = "", - ticket: int = 0, position: int = 0) -> tuple[TradeOrder, ...] | None -``` -Returns the closed orders for the specified period with the ability to filter by symbol or ticket. There are three call options. -Call without parameters. Return closed orders on all symbols - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `date_from` | `datetime` or `int` | The start date. Optional named parameter. | -| `date_to` | `datetime` or `int` | The end date. Optional named parameter. | -| `group` | `str` | The filter for arranging a group of necessary symbols. Optional named parameter. If the group is specified, the function returns only closed orders meeting a specified criteria for a symbol name. | -| `ticket` | `int` | Order ticket (ORDER_TICKET). Optional named parameter. | -| `position` | `int` | Position ticket (POSITION_TICKET). Optional named parameter. | - -#### Returns: -| Type | Description | -|--------------------------|------------------------------------------------------| -| `tuple[TradeOrder, ...]` | A tuple of closed trade orders as TradeOrder objects | - - - -### history_deals_total -```python -async def history_deals_total(date_from: datetime | int, date_to: datetime | int) -> int -``` -Returns the total number of closed deals for the specified period. - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|-----------------| -| `date_from` | `datetime` or `int` | The start date. | -| `date_to` | `datetime` or `int` | The end date. | - -#### Returns: -| Type | Description | -|-------|------------------------------------------------------------| -| `int` | The total number of closed deals for the specified period. | - - -### history_deals_get -```python -async def history_deals_get(date_from: datetime | int = None, date_to: datetime | int = None, group: str = "", - ticket: int = 0,position: int = 0) -> tuple[TradeDeal, ...] | None -``` -Returns the closed deals for the specified period with the ability to filter by symbol or ticket. There are three call options. -Call without parameters. Return closed deals on all symbols - -#### Parameters: -| Name | Type | Description | -|-------------|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `date_from` | `datetime` or `int` | The start date. Optional named parameter. | -| `date_to` | `datetime` or `int` | The end date. Optional named parameter. | -| `group` | `str` | The filter for arranging a group of necessary symbols. Optional named parameter. If the group is specified, the function returns only closed deals meeting a specified criteria for a symbol name. | -| `ticket` | `int` | Order ticket (ORDER_TICKET). Optional named parameter. | -| `position` | `int` | Position ticket (POSITION_TICKET). Optional named parameter. | - -#### Returns: -| Type | Description | -|-------------------------|----------------------------------------------------| -| `tuple[TradeDeal, ...]` | A tuple of closed trade deals as TradeDeal objects | +| Method | Description | +|--------|-------------| +| `_handler(api, retries=3)` | Executes API calls with connection-error retry | diff --git a/docs/core/models.md b/docs/core/models.md index 64fbd94..0ca2495 100644 --- a/docs/core/models.md +++ b/docs/core/models.md @@ -1,386 +1,111 @@ -# Models +# models -This module contains the models used in the aiomql package. These models are used to represent the data returned from -the MetaTrader 5 terminal. They are all subclasses of the `Base` class. +`aiomql.core.models` — Data models mirroring MetaTrader 5 structures. -## Table of Contents -- [AccountInfo](#models.account_info) -- [TerminalInfo](#models.terminal_info) -- [SymbolInfo](#models.symbol.info) -- [BookInfo](#models.book_info) -- [TradeOrder](#models.trade_order) -- [TradeRequest](#models_trade_request) -- [OrderCheckResult](#models.order_check_result) -- [OrderSendResult](#models.order_send_result) -- [TradePosition](#models.trade_position) -- [TradeDeal](#models.trade_deal) +## Overview +Defines data-model classes that correspond to the named-tuple structures returned by the +MetaTrader 5 terminal. All models inherit from [`Base`](base.md) and provide typed attributes, +dictionary conversion, and string representations. - -### AccountInfo -```python -class AccountInfo(Base) -``` -Account Information Class. -#### Attributes: -| Name | Type | Description | Default | -|----------------------|----------------------|------------------------------------------|---------| -| `login` | `int` | Account number | | -| `password` | `str` | Account password | | -| `server` | `str` | Trade server name | | -| `trade_mode` | AccountTradeMode | Trade mode | | -| `balance` | `float` | Account balance | | -| `leverage` | `float` | Account leverage | | -| `profit` | `float` | Account profit | | -| `point` | `float` | Point size | | -| `amount` | `float` | Account amount | 0 | -| `equity` | `float` | Account equity | | -| `credit` | `float` | Account credit | | -| `margin` | `float` | Account margin | | -| `margin_level` | `float` | Margin level | | -| `margin_free` | `float` | Free margin | | -| `margin_mode` | `AccountMarginMode` | Margin calculation mode | | -| `margin_so_mode` | `AccountStopoutMode` | Stop out mode | | -| `margin_so_call` | `float` | Margin call level | | -| `margin_so_so` | `float` | Stop out level | | -| `margin_initial` | `float` | Initial margin | | -| `margin_maintenance` | `float` | Maintenance margin | | -| `fifo_close` | `bool` | FIFO close flag | | -| `limit_orders` | `float` | Limit orders | | -| `currency` | `str` | Account currency | "USD" | -| `trade_allowed` | `bool` | Trade allowed flag | True | -| `trade_expert` | `bool` | Trade expert flag | True | -| `currency_digits` | `int` | Number of digits after the decimal point | | -| `assets` | `float` | Assets | | -| `liabilities` | `float` | Liabilities | | -| `commission_blocked` | `float` | Blocked commission | | -| `name` | `str` | Account name | | -| `company` | `str` | Company name | | +## Classes +### `AccountInfo` - -### TerminalInfo -```python -class TerminalInfo(Base) -``` -Terminal information class. Holds information about the terminal. +> Trading account information. -#### Attributes: -| Name | Type | Description | Default | -|-------------------------|---------|----------------------------|---------| -| `community_account` | `bool` | Community account flag | | -| `community_connection` | `bool` | Community connection flag | | -| `connected` | `bool` | Connection flag | | -| `dlls_allowed` | `bool` | DLLs allowed flag | | -| `trade_allowed` | `bool` | Trade allowed flag | | -| `tradeapi_disabled` | `bool` | Trade API disabled flag | | -| `email_enabled` | `bool` | Email enabled flag | | -| `ftp_enabled` | `bool` | FTP enabled flag | | -| `notifications_enabled` | `bool` | Notifications enabled flag | | -| `mqid` | `bool` | MQID | | -| `build` | `int` | Build number | | -| `maxbars` | `int` | Maximum number of bars | | -| `codepage` | `int` | Code page | | -| `ping_last` | `int` | Last ping | | -| `community_balance` | `float` | Community balance | | -| `retransmission` | `float` | Retransmission | | -| `company` | `str` | Company name | | -| `name` | `str` | Terminal name | | -| `language` | `str` | Language | | -| `path` | `str` | Terminal path | | -| `data_path` | `str` | Data path | | -| `commondata_path` | `str` | Common data path | | +Key fields: `login`, `server`, `trade_mode`, `balance`, `leverage`, `profit`, `equity`, +`margin`, `margin_free`, `margin_level`, `currency`. +--- - -### SymbolInfo -```python -class SymbolInfo(Base) -``` -Symbol Information Class. Symbols are financial instruments available for trading in the MetaTrader 5 terminal. -#### Attributes: -| Name | Type | Description | Default | -|------------------------------|------------------------|----------------------------|---------| -| `name` | `str` | Symbol name | | -| `custom` | `bool` | Custom symbol flag | | -| `chart_mode` | `SymbolChartMode` | Chart mode | | -| `select` | `bool` | Symbol selection flag | | -| `visible` | `bool` | Symbol visibility flag | | -| `session_deals` | `int` | Session deals | | -| `session_buy_orders` | `int` | Session buy orders | | -| `session_sell_orders` | `int` | Session sell orders | | -| `volume` | `float` | Volume | | -| `volumehigh` | `float` | Volume high | | -| `volumelow` | `float` | Volume low | | -| `time` | `int` | Time | | -| `digits` | `int` | Digits | | -| `spread` | `float` | Spread | | -| `spread_float` | `bool` | Spread float flag | | -| `ticks_bookdepth` | `int` | Ticks book depth | | -| `trade_calc_mode` | `SymbolCalcMode` | Trade calculation mode | | -| `trade_mode` | `SymbolTradeMode` | Trade mode | | -| `start_time` | `int` | Start time | | -| `expiration_time` | `int` | Expiration time | | -| `trade_stops_level` | `int` | Trade stops level | | -| `trade_freeze_level` | `int` | Trade freeze level | | -| `trade_exemode` | `SymbolTradeExecution` | Trade execution mode | | -| `swap_mode` | `SymbolSwapMode` | Swap mode | | -| `swap_rollover3days` | `DayOfWeek` | Swap rollover 3 days | | -| `margin_hedged_use_leg` | `bool` | Margin hedged use leg flag | | -| `expiration_mode` | `int` | Expiration mode | | -| `filling_mode` | `int` | Filling mode | | -| `order_mode` | `int` | Order mode | | -| `order_gtc_mode` | `SymbolOrderGTCMode` | Order GTC mode | | -| `option_mode` | `SymbolOptionMode` | Option mode | | -| `option_right` | `SymbolOptionRight` | Option right | | -| `bid` | `float` | Bid | | -| `bidhigh` | `float` | Bid high | | -| `bidlow` | `float` | Bid low | | -| `ask` | `float` | Ask | | -| `askhigh` | `float` | Ask high | | -| `asklow` | `float` | Ask low | | -| `last` | `float` | Last | | -| `lasthigh` | `float` | Last high | | -| `lastlow` | `float` | Last low | | -| `volume_real` | `float` | Volume real | | -| `volumehigh_real` | `float` | Volume high real | | -| `volumelow_real` | `float` | Volume low real | | -| `option_strike` | `float` | Option strike | | -| `point` | `float` | Point | | -| `trade_tick_value` | `float` | Trade tick value | | -| `trade_tick_value_profit` | `float` | Trade tick value profit | | -| `trade_tick_value_loss` | `float` | Trade tick value loss | | -| `trade_tick_size` | `float` | Trade tick size | | -| `trade_contract_size` | `float` | Trade contract size | | -| `trade_accrued_interest` | `float` | Trade accrued interest | | -| `trade_face_value` | `float` | Trade face value | | -| `trade_liquidity_rate` | `float` | Trade liquidity rate | | -| `volume_min` | `float` | Volume min | | -| `volume_max` | `float` | Volume max | | -| `volume_step` | `float` | Volume step | | -| `volume_limit` | `float` | Volume limit | | -| `swap_long` | `float` | Swap long | | -| `swap_short` | `float` | Swap short | | -| `margin_initial` | `float` | Initial margin | | -| `margin_maintenance` | `float` | Maintenance margin | | -| `session_volume` | `float` | Session volume | | -| `session_turnover` | `float` | Session turnover | | -| `session_interest` | `float` | Session interest | | -| `session_buy_orders_volume` | `float` | Session buy orders volume | | -| `session_sell_orders_volume` | `float` | Session sell orders volume | | -| `session_open` | `float` | Session open | | -| `session_close` | `float` | Session close | | -| `session_aw` | `float` | Session AW | | -| `session_price_settlement` | `float` | Session price settlement | | -| `session_price_limit_min` | `float` | Session price limit min | | -| `session_price_limit_max` | `float` | Session price limit max | | -| `margin_hedged` | `float` | Margin hedged | | -| `price_change` | `float` | Price change | | -| `price_volatility` | `float` | Price volatility | | -| `price_theoretical` | `float` | Price theoretical | | -| `price_greeks_delta` | `float` | Price greeks delta | | -| `price_greeks_theta` | `float` | Price greeks theta | | -| `price_greeks_gamma` | `float` | Price greeks gamma | | -| `price_greeks_vega` | `float` | Price greeks vega | | -| `price_greeks_rho` | `float` | Price greeks rho | | -| `price_greeks_omega` | `float` | Price greeks omega | | -| `price_sensitivity` | `float` | Price sensitivity | | -| `basis` | `str` | Basis | | -| `category` | `str` | Category | | -| `currency_base` | `str` | Base currency | | -| `currency_profit` | `str` | Profit currency | | -| `currency_margin` | `Any` | Margin currency | | -| `bank` | `str` | Bank | | -| `description` | `str` | Description | | -| `exchange` | `str` | Exchange | | -| `formula` | `Any` | Formula | | -| `isin` | `Any` | ISIN | | -| `name` | `str` | Name | | -| `page` | `str` | Page | | -| `path` | `str` | Path | | +### `TerminalInfo` +> MetaTrader 5 terminal details. - -### BookInfo -```python -class BookInfo(Base) -``` -Book Information Class. -#### Attributes: -| Name | Type | Description | Default | -|--------------|------------|-------------|---------| -| `symbol` | `str` | Symbol | | -| `type` | `BookType` | Type | | -| `price` | `float` | Price | | -| `volume` | `float` | Volume | | -| `volume_dbl` | `float` | Volume dbl | | +Key fields: `connected`, `trade_allowed`, `tradeapi_disabled`, `build`, `company`, +`name`, `path`, `data_path`. +--- - -#### TradeOrder -```python -class TradeOrder(Base) -``` -Trade Order Class. +### `SymbolInfo` -#### Attributes: -| Name | Type | Description | Default | -|-------------------|----------------|-----------------|---------| -| `ticket` | `int` | Ticket | | -| `time_setup` | `int` | Time setup | | -| `time_setup_msc` | `int` | Time setup msc | | -| `time_expiration` | `int` | Time expiration | | -| `time_done` | `int` | Time done | | -| `time_done_msc` | `int` | Time done msc | | -| `type` | `OrderType` | Type | | -| `type_time` | `OrderTime` | Type time | | -| `type_filling` | `OrderFilling` | Type filling | | -| `state` | `int` | State | | -| `magic` | `int` | Magic | | -| `position_id` | `int` | Position id | | -| `position_by_id` | `int` | Position by id | | -| `reason` | `OrderReason` | Reason | | -| `volume_current` | `float` | Volume current | | -| `volume_initial` | `float` | Volume initial | | -| `price_open` | `float` | Price open | | -| `sl` | `float` | SL | | -| `tp` | `float` | TP | | -| `price_current` | `float` | Price current | | -| `price_stoplimit` | `float` | Price stoplimit | | -| `symbol` | `str` | Symbol | | -| `comment` | `str` | Comment | | -| `external_id` | `str` | External id | | +> Trading instrument (symbol) properties. +Extensive attributes covering pricing, volume limits, spread, margin parameters, swap +settings, option properties, and session schedules. - -## TradeRequest -```python -class TradeRequest(Base) -``` -Trade Request Class. -#### Attributes: -| Name | Type | Description | Default | -|----------------|--------------|--------------|---------| -| `action` | TradeAction | Action | | -| `type` | OrderType | Type | | -| `order` | `int` | Order | | -| `symbol` | `str` | Symbol | | -| `volume` | `float` | Volume | | -| `sl` | `float` | SL | | -| `tp` | `float` | TP | | -| `price` | `float` | Price | | -| `deviation` | `float` | Deviation | | -| `stop_limit` | `float` | Stop limit | | -| `type_time` | OrderTime | Type time | | -| `type_filling` | OrderFilling | Type filling | | -| `expiration` | `int` | Expiration | | -| `position` | `int` | Position | | -| `position_by` | `int` | Position by | | -| `comment` | `str` | Comment | | -| `magic` | `int` | Magic | | -| `deviation` | `int` | Deviation | | +| Method / Property | Description | +|-------------------|-------------| +| `__repr__()` | `"SymbolInfo(name=)"` | +| `__str__()` | The symbol name | +| `__eq__(other)` | Equality by symbol name | +| `__hash__()` | Hash of the symbol name | +--- - -### OrderCheckResult -```python -class OrderCheckResult(Base) -``` -Order Check Result -#### Attributes: -| Name | Type | Description | Default | -|----------------|----------------|--------------|---------| -| `retcode` | `int` | Retcode | | -| `balance` | `float` | Balance | | -| `equity` | `float` | Equity | | -| `profit` | `float` | Profit | | -| `margin` | `float` | Margin | | -| `margin_free` | `float` | Margin free | | -| `margin_level` | `float` | Margin level | | -| `comment` | `str` | Comment | | -| `request` | `TradeRequest` | Request | | +### `BookInfo` +> Market depth entry. - -### OrderSendResult -```python -class OrderSendResult(Base) -``` -Order Send Result +Fields: `type` (`BookType`), `price`, `volume`, `volume_dbl`. -#### Attributes: -| Name | Type | Description | Default | -|--------------------|----------------|------------------|---------| -| `retcode` | `int` | Retcode | | -| `deal` | `int` | Deal | | -| `order` | `int` | Order | | -| `volume` | `float` | Volume | | -| `price` | `float` | Price | | -| `bid` | `float` | Bid | | -| `ask` | `float` | Ask | | -| `comment` | `str` | Comment | | -| `request` | `TradeRequest` | Request | | -| `request_id` | `int` | Request id | | -| `retcode_external` | `int` | Retcode external | | -| `profit` | `float` | Profit | | +--- +### `TradeOrder` - -### TradePosition -```python -class TradePosition(Base) -``` -Trade Position -#### Attributes: -| Name | Type | Description | Default | -|-------------------|------------------|-----------------|---------| -| `ticket` | `int` | Ticket | | -| `time` | `int` | Time | | -| `time_msc` | `int` | Time msc | | -| `time_update` | `int` | Time update | | -| `time_update_msc` | `int` | Time update msc | | -| `type` | `OrderType` | Type | | -| `magic` | `float` | Magic | | -| `identifier` | `int` | Identifier | | -| `reason` | `PositionReason` | Reason | | -| `volume` | `float` | Volume | | -| `price_open` | `float` | Price open | | -| `sl` | `float` | SL | | -| `tp` | `float` | TP | | -| `price_current` | `float` | Price current | | -| `swap` | `float` | Swap | | -| `profit` | `float` | Profit | | -| `symbol` | `str` | Symbol | | -| `comment` | `str` | Comment | | -| `external_id` | `str` | External id | | +> Pending or historical order. +Key fields: `ticket`, `type` (`OrderType`), `state`, `time_setup`, `volume_current`, +`volume_initial`, `price_open`, `sl`, `tp`, `symbol`, `comment`. - -### TradeDeal -```python -class TradeDeal(Base) -``` -Trade Deal -#### Attributes: -| Name | Type | Description | Default | -|---------------|--------------|-------------|---------| -| `ticket` | `int` | Ticket | | -| `order` | `int` | Order | | -| `time` | `int` | Time | | -| `time_msc` | `int` | Time msc | | -| `type` | `DealType` | Type | | -| `entry` | `DealEntry` | Entry | | -| `magic` | `int` | Magic | | -| `position_id` | `int` | Position id | | -| `reason` | `DealReason` | Reason | | -| `volume` | `float` | Volume | | -| `price` | `float` | Price | | -| `commission` | `float` | Commission | | -| `swap` | `float` | Swap | | -| `profit` | `float` | Profit | | -| `fee` | `float` | Fee | | -| `sl` | `float` | SL | | -| `tp` | `float` | TP | | -| `symbol` | `str` | Symbol | | -| `comment` | `str` | Comment | | -| `external_id` | `str` | External id | | +--- + +### `TradeRequest` + +> Trade request structure sent to `order_send` / `order_check`. + +Key fields: `action` (`TradeAction`), `type` (`OrderType`), `symbol`, `volume`, +`price`, `sl`, `tp`, `deviation`, `magic`, `comment`, `type_filling`, `type_time`. + +--- + +### `OrderCheckResult` + +> Result of `order_check`. + +Key fields: `retcode`, `balance`, `equity`, `profit`, `margin`, `margin_free`, +`margin_level`, `request` (`TradeRequest`), `comment`. + +| Method | Description | +|--------|-------------| +| `__init__(**kwargs)` | Converts `request` dict to `TradeRequest` | +| `__getstate__()` | Serialises `request` as a plain dict | +| `__setstate__(state)` | Restores `request` from dict | + +--- + +### `OrderSendResult` + +> Result of `order_send`. + +Key fields: `retcode`, `deal`, `order`, `volume`, `price`, `bid`, `ask`, +`request` (`TradeRequest`), `comment`, `request_id`. + +--- + +### `TradePosition` + +> Open position information. + +Key fields: `ticket`, `type` (`PositionType`), `symbol`, `volume`, `price_open`, +`price_current`, `sl`, `tp`, `profit`, `swap`, `magic`, `comment`. + +--- + +### `TradeDeal` + +> Completed deal record. + +Key fields: `ticket`, `type` (`DealType`), `entry` (`DealEntry`), `symbol`, `volume`, +`price`, `profit`, `swap`, `commission`, `magic`, `comment`, `position_id`, `order`. diff --git a/docs/core/state.md b/docs/core/state.md new file mode 100644 index 0000000..68302b5 --- /dev/null +++ b/docs/core/state.md @@ -0,0 +1,49 @@ +# state + +`aiomql.core.state` — Singleton persistent key-value store backed by SQLite. + +## Overview + +The `State` class implements `MutableMapping`, providing dict-like access to data that is +automatically persisted to a SQLite database. The entire state is stored as a single pickled +row — ideal for small, frequently-accessed configuration data. It uses the singleton pattern +so all parts of the application share the same state. + +## Classes + +### `State` + +> Singleton persistent key-value store. + +| Attribute | Type | Description | +|-----------|------|-------------| +| `db_name` | `str \| Path` | Path to the SQLite database | +| `autocommit` | `bool` | If `True`, commits after every modification | + +#### `__init__(db_name="", data=None, flush=False, autocommit=True)` + +Initialises the state. If `flush` is `True`, all existing data is cleared. + +#### Dict-like Interface + +| Method | Description | +|--------|-------------| +| `__getitem__(key)` | Get a value by key | +| `__setitem__(key, value)` | Set a value | +| `__delitem__(key)` | Delete a key-value pair | +| `__contains__(key)` | Check if a key exists | +| `__len__()` | Number of items | +| `__iter__()` | Iterate over keys | +| `get(key, default=None)` | Get with default | +| `pop(key, default=SENTINEL)` | Remove and return | +| `update(data, **kwargs)` | Bulk update | +| `setdefault(key, default=None)` | Get or set default | +| `keys()` / `values()` / `items()` | Standard views | + +#### Persistence + +| Method | Description | +|--------|-------------| +| `commit()` | Writes current state to the database | +| `load()` | Loads state from the database | +| `flush()` | Clears all data (in-memory and on disk) | diff --git a/docs/core/store.md b/docs/core/store.md new file mode 100644 index 0000000..dadbb6b --- /dev/null +++ b/docs/core/store.md @@ -0,0 +1,51 @@ +# store + +`aiomql.core.store` — Per-key persistent key-value store backed by SQLite. + +## Overview + +The `Store` class provides a persistent dict-like interface backed by SQLite. Unlike +[`State`](state.md) (which stores all data as a single pickled row), `Store` keeps each +key-value pair as a separate database row. This makes it more suitable for large or +independently-accessed data sets. + +## Classes + +### `Store` + +> Persistent key-value store with per-row storage. + +| Attribute | Type | Description | +|-----------|------|-------------| +| `db_name` | `str \| Path` | Path to the SQLite database | +| `table_name` | `str` | Table name (default: `"store"`) | +| `autocommit` | `bool` | If `True`, commits after every modification | + +#### `__init__(db_name="", table_name="store", data=None, flush=False, autocommit=True)` + +Initialises the store, optionally flushing existing data. + +#### Dict-like Interface + +| Method | Description | +|--------|-------------| +| `__getitem__(key)` | Get a value by key | +| `__setitem__(key, value)` | Set or replace a value | +| `__delitem__(key)` | Delete a key-value pair | +| `__contains__(key)` | Check if a key exists | +| `__len__()` | Number of items | +| `__iter__()` | Iterate over keys | +| `get(key, default=None)` | Get with default | +| `pop(key, default=SENTINEL)` | Remove and return | +| `update(data, **kwargs)` | Bulk update | +| `setdefault(key, default=None)` | Get or set default | +| `keys()` / `values()` / `items()` | Standard list accessors | +| `iterkeys()` / `itervalues()` / `iteritems()` | Generator-based accessors | +| `clear()` | Remove all entries | + +#### Persistence + +| Property | Description | +|----------|-------------| +| `data` | Returns all key-value pairs as a dict | +| `commit()` | Commits pending changes | diff --git a/docs/core/task_queue.md b/docs/core/task_queue.md index 9240be6..6bb793d 100644 --- a/docs/core/task_queue.md +++ b/docs/core/task_queue.md @@ -1,181 +1,67 @@ -# TaskQueue and QueueItem +# task_queue -## Table of Contents -- [QueueItem](#queue_item.queue_item) - - [\__init\__](#queue_item.__init__) - - [run](#queue_item.run) +`aiomql.core.task_queue` — Async priority task queue for managing concurrent execution. -- [TaskQueue](#task_queue.task_queue) - - [\__init\__](#task_queue.__init__) - - [add](#task_queue.add) - - [add_task](#task_queue.add_task) - - [worker](#task_queue.worker) - - [run](#task_queue.run) - - [stop_queue](#task_queue.stop_queue) - - [clean_up](#task_queue.clean_up) - - [cancel](#task_queue.cancel) +## Overview +Provides `QueueItem` (a callable wrapper) and `TaskQueue` (an `asyncio.PriorityQueue`-based +executor). Supports priority-based scheduling, dynamic worker scaling, timeout handling, and +both **finite** (run until empty) and **infinite** (run until stopped) modes. - -### QueueItem -```python -class QueueItem -``` -A task to be executed by the `TaskQueue`. The task can be any coroutine callable. The task is wrapped as a -`QueueItem` object, which is then added to the `TaskQueue` for execution. The arguments and keyword arguments are -passed to the task when it is executed. +## Classes -#### Attributes: -| Name | Type | Description | -|-----------------|---------------------------|-----------------------------------------------------------------------| -| `task_item` | `Callable` \| `Coroutine` | A coroutine function to be executed by the `TaskQueue` | -| `args` | `tuple[Any, ...]` | Positional arguments to be passed to the task_item | -| `kwargs` | `dict[str, Any]` | Keyword arguments to be passed to the task_item | -| `must_complete` | `bool` | If True, the item must be completed even if the queue is stopped. | -| `time` | `float` | The time the item was added to the queue. For sorting priority queues | +### `QueueItem` +> Wraps a callable or coroutine for deferred, priority-aware execution. - -### \__init\__ -```python -def __init__(self, task: Callable | Coroutine, *args, **kwargs): -``` +| Attribute | Type | Description | +|-----------|------|-------------| +| `task` | `Callable \| Coroutine` | The wrapped callable | +| `args` | `tuple` | Positional arguments | +| `kwargs` | `dict` | Keyword arguments | +| `time` | `float` | Creation timestamp (used for ordering) | -#### Parameters: -| Name | Type | Description | -|----------|---------------------------|-------------------------------------------------------------------| -| `task` | `Callable` \| `Coroutine` | A coroutine to be executed by the `TaskQueue` | -| `args` | `Any` | Positional arguments to be passed to the task when it is executed | -| `kwargs` | `Any` | Keyword arguments to be passed to the task when it is executed | +#### `__call__()` +Executes the task. Coroutine functions are awaited directly; regular callables are run +in a thread executor. Handles `asyncio.CancelledError`. - -### run -```python -def run(self) -``` -Run the task. If the task is a coroutine, it is awaited. If the task is a callable, it is called. +Comparison operators (`<`, `<=`, `==`) are based on creation time. +--- - -### TaskQueue -```python -class TaskQueue -``` -A perpetual task queue that processes `QueueItem` objects. The `TaskQueue` runs indefinitely, processing `QueueItem` -objects as they are added to the queue. The `TaskQueue` is a wrapper around an `asyncio.Queue` that can be passed in as -an argument or defaults to an `asyncio.PriorityQueue`. It is added to the bot executor of the `Bot` class on a -separate thread. +### `TaskQueue` -#### Attributes: -| Name | Type | Description | -|------------------|------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `queue` | `asyncio.Queue` | An `asyncio.Queue` queue of `QueueItem` objects to be executed by the `TaskQueue`. If not provided during instantiation, an `asyncio.PriorityQueue` is used | -| `stop` | `bool` | A flag to stop the task_queue instance. | -| `workers` | `int` | The number of workers to process the queue items. Defaults to 10. | -| `timeout` | `int` | The maximum time to wait for the queue to complete. Default is None. If timeout is provided the queue is joined using `asyncio.wait_for` with the timeout | -| `on_exit` | `Literal["cancel", "complete_priority"]` | The action to take when the queue is stopped. If "cancel" the queue is cancelled and the remaining items are not processed. If "complete_priority" the queue is completed with the priority items. Default is "cancel" | -| `mode` | `Literal["finite", "infinite"]` | The mode of the queue. If `finite` the queue will stop when all tasks are completed. If `infinite` the queue will continue to run until stopped. | -| `worker_timeout` | `int` | The time to wait for a task to be added to the queue before stopping the worker or adding a dummy sleep task to the queue. | -| `tasks` | `List[Task]` | A list of the worker tasks running concurrently, including the main task that joins the queue. | -| `priority_tasks` | `set[QueueItem]` | A set to store the `QueueItems` that must complete before the queue stops | +> Priority-based async task queue with worker management. +| Parameter | Type | Default | Description | +|-----------|------|---------|-------------| +| `size` | `int` | `0` | Max queue size (0 = unlimited) | +| `max_workers` | `int \| None` | `None` | Max concurrent workers | +| `queue_timeout` | `int \| None` | `None` | Overall timeout in seconds | +| `on_exit` | `Literal["cancel","complete_priority"]` | `"complete_priority"` | Shutdown behaviour | +| `mode` | `Literal["finite","infinite"]` | `"finite"` | Queue mode | - -### \__init\__ -```python -def __init__(self, queue: asyncio.Queue = None, workers: int = 10, timeout: int = None, size: int = None, - on_exit: Literal["cancel", "complete_priority"] = "cancel", - mode: Literal["finite", "infinite"] = "infinite", worker_timeout: int = 60) -``` -Create a new `TaskQueue` instance. +#### Task Management -#### Parameters: -| Name | Type | Description | Default | -|------------------|------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|---------------------| -| `queue` | `asyncio.Queue` | An `asyncio.Queue` queue instance | None | -| `workers` | `int` | The number of workers to process the queue items. | 10 | -| `timeout` | `int` | The maximum time to wait for the queue to complete. | None | -| `size` | `int` | The maximum size of the queue. | None | -| `on_exit` | `Literal["cancel", "complete_priority"]` | The action to take when the queue is stopped. | "complete_priority" | -| `mode` | `Literal["finite", "infinite"]` | The mode of the queue. | "infinite" | -| `worker_timeout` | `int` | The time to wait for a task to be added to the queue before stopping the worker or adding a dummy sleep task to the queue. | 60 | +| Method | Description | +|--------|-------------| +| `add_task(task, *args, must_complete=False, priority=3, **kwargs)` | Wraps and enqueues a task | +| `add(*, item, priority=3, must_complete=False, with_new_workers=True)` | Enqueues a `QueueItem` | +#### Worker Management - -### add -```python -def add(*, item: QueueItem, priority: int = 3, must_complete_false: bool = False) -> None -``` -Add a `QueueItem` to the `TaskQueue` queue. +| Method | Description | +|--------|-------------| +| `add_workers(no_of_workers=None)` | Creates worker coroutines | +| `remove_worker(wid)` | Removes a specific worker | +| `cancel_all_workers()` | Cancels all workers | +| `cancel()` | Cancels workers and stops the queue | -#### Parameters: -| Name | Type | Description | -|-----------------------|-------------|----------------------------------------------------------------------------------------| -| `item` | `QueueItem` | A `QueueItem` to be added to the queue | -| `priority` | `int` | The priority of the item. The lower the number, the higher the priority. Default is 3. | -| `must_complete_false` | `bool` | If True, the item must be completed even if the queue is stopped. Default is False. | +#### Execution - - -### add_task -```python -def add_task(self, task: Callable | Awaitable, *args, **kwargs) -``` -Create a QueueItem from the task and add it to the `TaskQueue` queue. The task can be a callable or an awaitable. -The arguments and keyword arguments are passed to the QueueItem. - -#### Parameters: -| Name | Type | Description | -|----------|---------------------------|-------------------------------------------------------------------| -| `task` | `Callable` \| `Awaitable` | A callable or awaitable task to be executed by the `TaskQueue` | -| `args` | `Any` | Positional arguments to be passed to the task when it is executed | -| `kwargs` | `Any` | Keyword arguments to be passed to the task when it is executed | - - -### worker -```python -async def worker() -``` -A worker that processes the `QueueItem` objects in the `TaskQueue` queue. - - - -### run -```python -async def run(timeout: int = None) -``` -Start the `TaskQueue` instance. If a timeout is provided, the queue is joined using `asyncio.wait_for` with the timeout. -This is the main entry point for the `TaskQueue` instance. It is added to the bot executor of the `Bot` class on a -separate thread. - -#### Parameters: -| Name | Type | Description | -|-----------|-------|----------------------------------------------------------------------| -| `timeout` | `int` | The maximum time to wait for the queue to complete. Default is None. | - - - -### stop_queue -```python -def stop_queue() -``` -Stop the `TaskQueue` instance. This sets the `stop` attribute to True, changes the `on_exit` attribute to "cancel", -and cancels the queue. - - - -### clean_up -```python -async def clean_up() -``` -Clean up the `TaskQueue` instance. This is called when the queue is stopped. It cancels the queue and processes the -remaining priority items based on the `on_exit` attribute. - - - -### cancel -```python -def cancel() -``` -Cancel all remaining tasks. +| Method | Description | +|--------|-------------| +| `run(queue_timeout=None)` | Starts workers and processes the queue | +| `worker(wid=None)` | Internal worker coroutine | +| `check_timeout()` | Checks and enforces queue timeout | diff --git a/docs/lib/account.md b/docs/lib/account.md index 9ba4c5f..c28c5ae 100644 --- a/docs/lib/account.md +++ b/docs/lib/account.md @@ -1,27 +1,43 @@ -# Account +# account -## Table of Contents -- [Account](#account.account) -- [refresh](#account.refresh) +`aiomql.lib.account` — Trading account connection manager. +## Overview - -### Account -```python -class Account(_Base, AccountInfo) -``` -A singleton class for managing a trading account. A subclass of _Base and AccountInfo. It supports asynchronous context -management protocol. +The `Account` class is a singleton that manages the connection to a MetaTrader 5 trading +account. It supports both async and sync context managers for connecting and disconnecting, +and provides access to account properties such as balance, equity, and margin. -#### Attributes: -| Name | Type | Description | Default | -|-------------|-------------------|------------------------------------------------------|---------| -| `connected` | `bool` | Status of connection to MetaTrader 5 Terminal | False | +Inherits from [`_Base`](../core/base.md). +## Classes - -### refresh -```python -async def refresh() -``` -Refreshes the account instance with the latest data from the MetaTrader 5 terminal +### `Account` + +> Singleton for managing the MT5 account connection. + +| Attribute | Type | Description | +|-----------|------|-------------| +| `connected` | `bool` | Whether the account is currently connected | + +All `AccountInfo` fields (e.g. `login`, `balance`, `equity`, `margin`, `leverage`, `currency`) +are available as instance attributes after a successful connection. + +#### `__aenter__()` / `__aexit__(…)` + +Async context manager — initializes the terminal, logs in, and populates account info. + +#### `__enter__()` / `__exit__(…)` + +Sync context manager — same as above using synchronous calls. + +#### `refresh()` + +Re-fetches account info from the terminal and updates instance attributes. + +**Returns:** `bool` — `True` if the account info was successfully refreshed. + +## Synchronous API + +The sync context manager (`with Account() as acc:`) uses `initialize_sync` and `login_sync` +internally. See [`sync/account.py`] for the full synchronous wrapper. diff --git a/docs/lib/backtester.md b/docs/lib/backtester.md deleted file mode 100644 index 1206d1a..0000000 --- a/docs/lib/backtester.md +++ /dev/null @@ -1,185 +0,0 @@ - - -# backtester - - - -## BackTester Objects - -```python -class BackTester() -``` - -The bot class. Create a bot instance to run your strategies. - -**Attributes**: - -- `executor` - The default thread executor. -- `config` _Config_ - Config instance -- `mt` _MetaBackTester_ - MetaTrader instance - - - -#### initialize\_sync - -```python -def initialize_sync() -``` - -Prepares the bot by signing in to the trading account and initializing the symbols for the trading session. -Starts the global task queue. - -**Raises**: - - SystemExit if sign in was not successful - - - -#### initialize - -```python -async def initialize() -``` - -Prepares the bot by signing in to the trading account and initializing the symbols for the trading session. -Starts the global task queue. - -**Raises**: - - SystemExit if sign in was not successful - - - -#### add\_coroutine - -```python -def add_coroutine(*, - coroutine: Callable[..., ...] | Coroutine, - on_separate_thread=False, - **kwargs) -``` - -Add a coroutine to the executor. - -**Arguments**: - -- `coroutine` _Coroutine_ - A coroutine to be executed -- `on_separate_thread` _bool_ - Run the coroutine -- `**kwargs` _dict_ - keyword arguments for the coroutine - - - - -#### execute - -```python -def execute() -``` - -Execute the bot. - - - -#### start - -```python -async def start() -``` - -Initialize the bot and execute it. Similar to calling `execute` method but is a coroutine. - - - -#### add\_strategy - -```python -def add_strategy(*, strategy: Strategy) -``` - -Add a strategy to the list of strategies. -An added strategy will only run if it's symbol was successfully initialized and it is added to the executor. - -**Arguments**: - -- `strategy` _Strategy_ - A Strategy instance to run on bot - - -**Notes**: - - Make sure the symbol has been added to the market - - - -#### add\_strategies - -```python -def add_strategies(*, strategies: Iterable[Strategy]) -``` - -Add multiple strategies at the same time - -**Arguments**: - -- `strategies` - A list of strategies - - - -#### add\_strategy\_all - -```python -def add_strategy_all(*, - strategy: Type[Strategy], - params: dict | None = None, - symbols: list[Symbol] = None, - **kwargs) -``` - -Use this to run a single strategy on multiple symbols with the same parameters and keyword arguments. - -**Arguments**: - -- `strategy` _Strategy_ - Strategy class -- `params` _dict_ - A dictionary of parameters for the strategy -- `symbols` _list_ - A list of symbols to run the strategy on -- `**kwargs` - Additional keyword arguments for the strategy - - - -#### init\_strategy - -```python -async def init_strategy(*, strategy: Strategy) -> bool -``` - -Initialize a single strategy. This method is called internally by the bot. - - - -#### init\_strategy\_sync - -```python -def init_strategy_sync(*, strategy: Strategy) -> bool -``` - -Initialize a single strategy. This method is called internally by the bot. - - - -#### init\_strategies - -```python -async def init_strategies() -``` - -Initialize the symbols for the current trading session. This method is called internally by the bot. - - - -#### init\_strategies\_sync - -```python -def init_strategies_sync() -``` - -Initialize the symbols for the current trading session. This method is called internally by the bot. - diff --git a/docs/lib/bot.md b/docs/lib/bot.md index 02e0ea6..0387cae 100644 --- a/docs/lib/bot.md +++ b/docs/lib/bot.md @@ -1,161 +1,49 @@ -# Bot +# bot -## Table of Contents -- [Bot](#bot.bot) -- [\_\_init\_\_](#bot.init) -- [initialize](#bot.initialize) -- [execute](#bot.execute) -- [start](#bot.start) -- [add_coroutine](#bot.add_coroutine) -- [add_function](#bot.add_function) -- [add_strategy](#bot.add_strategy) -- [add_strategies](#bot.add_strategies) -- [add_strategy_all](#bot.add_strategy_all) -- [process_pool](#bot.run_bots) +`aiomql.lib.bot` — Bot orchestrator for running trading strategies. - -### Bot -```python -class Bot -``` -"""The bot class. Create a bot instance to run strategies. +## Overview -#### Attributes: -| Name | Type | Description | Default | -|--------------|--------------------|--------------------------------------------|--------------| -| `account` | `Account` | Account Object. | None | -| `executor` | `Executor` | The executor. | None | -| `strategies` | `List[Strategies]` | A list of strategies to initialize and run | list() | -| `mt5` | `MetaTrader` | `A MetaTrader Instance` | MetaTrader() | -| `config` | `Config` | A Config instance | Config() | +The `Bot` class is the main entry point for running one or more trading strategies against +the MetaTrader 5 terminal. It manages the account connection lifecycle, strategy +initialisation, task queuing, and graceful shutdown via signal handlers. - -### \__init\__ -```python -def __init__() -``` -Initializes the Bot class. +Inherits from [`_Base`](../core/base.md). +## Classes - -### initialize -```python -async def initialize(self) -``` -Prepares the bot by signing in to the trading account and initializing the symbols for each strategy. -Only strategies with successfully initialized symbols will be added to the executor. Starts the global task queue. +### `Bot` -Note: *initialize_sync* is a synchronous version of this method. +> Orchestrates strategy execution and terminal connection. -#### Raises: -| Exception | Description | -|--------------|-------------------------------| -| `SystemExit` | If sign in was not successful | +| Attribute | Type | Description | +|-----------|------|-------------| +| `account` | `Account` | The trading account instance | +| `executor` | `Executor` | Strategy and task executor | +| `mt5` | `MetaTrader` | MetaTrader terminal interface | +#### Lifecycle - -### execute -```python -def execute() -``` -Executes the bot. Use this method to run the bot in a synchronous manner. -This method is blocking and will not return until the bot is done running. +| Method | Description | +|--------|-------------| +| `initialize()` | Connects to MT5 and logs in, sets up the executor | +| `start()` | Starts the bot: initialises, adds strategies, and runs the executor | +| `stop()` | Gracefully stops the bot and shuts down the terminal | +| `execute()` | Main execution loop | +#### Strategy Management - -### start -```python -async def start() -``` -Initialize the bot and execute it. Similar to calling **execute** method but is asynchronous. +| Method | Description | +|--------|-------------| +| `add_strategy(strategy)` | Registers a `Strategy` subclass for execution | +| `add_strategies(*strategies)` | Registers multiple strategies at once | +#### Signal Handling - -### add_coroutine -```python -def add_coroutine(self, coroutine: Coroutine, on_separate_thread=False, **kwargs) -``` -Add a coroutine to the executor. By default, all coroutines added to the executor run on this same thread, -using `asyncio.gather`, but if `on_separate_thread` is true then the coroutine is given it's own thread. +| Method | Description | +|--------|-------------| +| `sigint_handler(sig, frame)` | Handles SIGINT for graceful shutdown | -#### Parameters: -| Name | Type | Description | -|----------------------|-------------|----------------------------------------------------| -| `coroutine` | `Coroutine` | A coroutine to run in the executor | -| `on_separate_thread` | `bool` | Run coroutine on a separate thread in the executor | -| `kwargs` | `Any` | Keyword arguments to pass to the coroutine | +## Synchronous API - - -### add_function -```python -def add_function(self, function: Callable, **kwargs) -``` -Add a function to the executor. -#### Parameters: -| Name | Type | Description | -|------------|------------|-------------------------------------------| -| `function` | `Callable` | A function to run in the executor | -| `kwargs` | `Any` | Keyword arguments to pass to the function | - - - -### add_strategy -```python -def add_strategy(self, strategy: Strategy) -``` -Add a strategy to the list of strategies. - -#### Parameters: -| Name | Type | Description | -|------------|------------|-----------------------------------| -| `strategy` | `Strategy` | A Strategy instance to run on bot | - - - -### add_strategies -```python -def add_strategies(strategies: Iterable[Strategy]) -``` -Add multiple strategies at the same time - -#### Parameters: -| Name | Type | Description | -|--------------|----------------------|-----------------------------------| -| `strategies` | `Iterable[Strategy]` | An iterable of Strategy instances | - - - -### add_strategy_all -```python -def add_strategy_all(*, strategy: Type[Strategy], params: dict | None = None, symbols: list[Symbol] = None, **kwargs) -``` -Use this to run a single strategy on multiple symbols with the same parameters and keyword arguments. - -#### Parameters: -| Name | Type | Description | -|------------|------------------|---------------------------------------------| -| `strategy` | `Type[Strategy]` | A Strategy class | -| `params` | `dict` or `None` | A dictionary of parameters for the strategy | -| `symbols` | `list[Symbol]` | A list of symbols to run the strategy on | -| `**kwargs` | `Any` | Keyword arguments | - - - -```python -@classmethod -def process_pool(cls, processes: dict[Callable: dict] = None, num_workers: int = None): -``` -Run multiple processes (scripts, bots) at the same time in parallel with different accounts. -Running multiple functions is useful when you want to run different strategies on different accounts. -The callable can for example be a bot instance that defines its own Config instance within the function scope. -The dictionary should contain the callable as the key and the dictionary of keyword arguments to pass to the callable as -the value. Use the path attribute of the config instance to specify the terminal path of each account. -The num_workers parameter specifies the number of workers to use. If not specified, the number of workers will be the -number of bots. - -#### Parameters -| Name | Type | Description | -|---------------|------------------------|---------------------------------------------------------------------------------| -| `processes` | `dict[Callable: dict]` | A dictionary of callables and their keyword arguments to run as processes | -| `num_workers` | `int` | The number of workers to use. If not specified, the number of bots will be used | +A synchronous variant is available in `aiomql.lib.sync.bot`. diff --git a/docs/lib/candle.md b/docs/lib/candle.md index bca6ed9..257dacb 100644 --- a/docs/lib/candle.md +++ b/docs/lib/candle.md @@ -1,242 +1,65 @@ -# Candle and Candles -Candle and Candles classes for handling bars from the MetaTrader 5 terminal. +# candle -## Table of Contents -- [Candle](#candle.candle) - - [\_\_init\_\_](#candle.__init__) - - [set_attributes](#candle.set_attributes) - - [is_bullish](#candle.is_bullish) - - [is_bearish](#candle.is_bearish) - - [dict](#candle.dict) -- [Candles](#candles.candles) - - [\_\_init\_\_](#candles.__init__) - - [ta](#candles.ta) - - [ta_lib](#candles.ta_lib) - - [data](#candles.data) - - [rename](#candles.rename) - - [plot](#candles.plot) - - [make_subplot](#candles.make_subplot) +`aiomql.lib.candle` — Candlestick / bar data and technical analysis. - -### Candle -```python -class Candle -``` -A class representing bars from the MetaTrader 5 terminal as a customized class analogous to Japanese Candlesticks. -You can subclass this class for added customization. +## Overview -### Attributes +Provides `Candle` (a single OHLCV bar) and `Candles` (an ordered collection). The `Candles` +class wraps a `pandas.DataFrame` and integrates with `pandas_ta` for technical analysis. -| Name | Type | Description | -|---------------|-------------|-------------------------------------------------------------------------| -| `time` | `int` | Period start time | -| `open` | `int` | Open price | -| `high` | `float` | The highest price of the period | -| `low` | `float` | The lowest price of the period | -| `close` | `float` | Close price | -| `tick_volume` | `float` | Tick volume | -| `real_volume` | `float` | Trade volume | -| `spread` | `float` | Spread | -| `Index` | `int` | Custom attribute representing the position of the candle in a sequence. | -| `index` | `Timestamp` | Index of the object in the DataFrame, as a timestamp. | +## Classes - -### \_\_init\_\_ -```python -def __init__(**kwargs) -``` -Create a Candle object from keyword arguments. Kwargs are set as instance attributes. Open, high, low, close must be -provided during each instantiation. -#### Parameters: -| Name | Type | Description | -|----------|-------|----------------------------------------------------| -| `kwargs` | `Any` | Candle attributes and values as keyword arguments. | +### `Candle` -#### Raises: -| Exception | Description | -|--------------|-----------------------------------------------| -| `ValueError` | If open, high, low, or close is not provided. | +> A single candlestick bar. - -### set\_attributes -```python -def set_attributes(**kwargs) -``` -Set keyword arguments as instance attributes -#### Parameters: -| Name | Type | Description | -|----------|-------|----------------------------------------------------| -| `kwargs` | `Any` | Candle attributes and values as keyword arguments. | +| Attribute | Type | Description | +|-----------|------|-------------| +| `time` | `int` | Bar open time (unix timestamp) | +| `open` | `float` | Open price | +| `high` | `float` | High price | +| `low` | `float` | Low price | +| `close` | `float` | Close price | +| `tick_volume` | `float` | Tick volume | +| `real_volume` | `float` | Real volume | +| `spread` | `float` | Spread | +| `Index` | `int` | Position index within a `Candles` collection | - -### is_bullish -```python -def is_bullish() -> bool -``` -A simple check to see if the candle is bullish. -#### Returns: -| Type | Description | -|--------|---------------| -| `bool` | True or False | +#### Properties - -### is_bearish -```python -def is_bearish() -> bool -``` -A simple check to see if the candle is bearish. -#### Returns: -| Type | Description | -|------|---------------| -| bool | True or False | +| Property | Description | +|----------|-------------| +| `mid` | Midpoint `(high + low) / 2` | +| `is_bullish` | `True` if `close >= open` | +| `is_bearish` | `True` if `close < open` | +| `dict` | Attribute dictionary | - -### dict -```python -def dict(self, exclude: set = None, include: set = None) -> Dict[str, Any] -``` -Return a dictionary representation of the Candle object. -#### Parameters: -| Name | Type | Description | -|-----------|------------|-----------------------------------------------------| -| `exclude` | `set[str]` | A set of attributes to exclude from the dictionary. | -| `include` | `set[str]` | A set of attributes to include in the dictionary. | +--- -#### Returns: -| Type | Description | -|------------------|---------------------------------------------------| -| `Dict[str, Any]` | A dictionary representation of the Candle object. | +### `Candles` +> Ordered collection of candlestick bars backed by a DataFrame. -### Candles -```python -class Candles(Generic[_Candle]) -``` -An iterable container class of Candle objects in chronological order. It is in a way a wrapper around a Pandas DataFrame -object. All the data pulled from the chart is stored as a pandas DataFrame object. In an attribute called **data**. -This class can be sliced, iterated over, and indexed like a sequence. It also has access to the pandas_ta library. -Indexing it returns a Candle object. It can be sliced to return a new instance of the class with the sliced candles. -This slices and resets the index of the underlying dataframe object. Key based indexing is also supported on the candles -object for accessing the columns of the underlying data attribute. +| Attribute | Type | Description | +|-----------|------|-------------| +| `data` | `DataFrame` | The underlying OHLCV data | +| `Index` | `Series` | Positional index column | +| `timeframe` | `TimeFrame` | The chart timeframe | -### Attributes: -The attributes of this class vary depending on the columns of underlying **data** attribute. i.e. each column of the **data** -attribute is an attribute of the class. +#### Data Access -| Name | Type | Description | -|---------------|-----------------------|-------------------------------------------------------------------| -| `data` | `DataFrame` | The pandas DataFrame containing the data. | -| `Index` | `Series['int']` | A pandas Series of the indexes of all candles in the object | -| `index` | `Series['Timestamp']` | DatetimeIndex of the underlying DataFrame object. | -| `time` | `Series['int']` | A pandas Series of the time of all candles in the object | -| `open` | `Series[float]` | A pandas Series of the opening price of all candles in the object | -| `high` | `Series[float]` | A pandas Series of the high price of all candles in the object | -| `low` | `Series[float]` | A pandas Series of the low price of all candles in the object | -| `close` | `Series[float]` | A pandas Series of the closing price of all candles in the object | -| `tick_volume` | `Series[float]` | A pandas Series of the tick volume of all candles in the object | -| `real_volume` | `Series[float]` | A pandas Series of the real volume of all candles in the object | -| `spread` | `Series[float]` | A pandas Series of the spread of all candles in the object | -| `timeframe` | `TimeFrame` | The timeframe of the candles in the object | -| `Candle` | `Type[Candle]` | The Candle class for representing the candles in the object. | -| `data` | `DataFrame` | A pandas DataFrame of all candles in the object. | +| Method / Property | Description | +|-------------------|-------------| +| `__getitem__(index)` | Get a `Candle` by position or slice | +| `__len__()` | Number of bars | +| `__iter__()` | Iterate over `Candle` objects | +| `columns` | DataFrame column names | +| `ta` | Access to `pandas_ta` indicators | +| `rename(inplace=True, **kwargs)` | Rename columns | -#### Notes -When subclassing this class, make sure the Candle attribute is set to your desired candle class. +#### Technical Analysis - -### \_\_init\_\_ -```python -def __init__(*, - data: DataFrame | _Candles | Iterable, - flip=False, - candle_class: Type[_Candle] = None) -``` -A container class of Candle objects in chronological order. -#### Parameters: -| Name | Type | Description | Default | -|----------------|----------------------------------------|---------------------------------------------------------------------|---------| -| `data` | `DataFrame` or `Candles` or `Iterable` | A pandas dataframe, a Candles object or any suitable iterable | -| `flip` | `bool` | Reverse the chronological order of the candles to the oldest first. | False | -| `candle_class` | `Type[Candle]` | A subclass of Candle to use as the candle class. | Candle | - - -### ta -```python -@property -def ta() -``` -Access to the pandas_ta library for performing technical analysis on the underlying data attribute. Use this as you -would use the pandas_ta library on a pandas DataFrame. For inplace operations. The underlying data attribute is modified. -#### Returns: -| Type | Description | -|-------------|-----------------------| -| `pandas_ta` | The pandas_ta library | - - -### ta\_lib -```python -@property -def ta_lib() -``` -Access to the ta library for performing technical analysis. Not dependent on the underlying data attribute. Use this for -functions that require pandas Series as input. -#### Returns: -| Type | Description | -|------|----------------| -| ta | The ta library | - - -### data -```python -@property -def data() -> DataFrame -``` -A pandas DataFrame of all candles in the object. - - -### rename -```python -def rename(inplace=True, **kwargs) -> _Candles | None -``` -Rename columns of the data object. -#### Parameters: -| Name | Type | Description | Default | -|-----------|--------|-------------------------------------------------------------------------------------------|---------| -| `inplace` | `bool` | Rename the columns inplace or return a new instance of the class with the renamed columns | True | -| `kwargs` | `str` | The new names of the columns | | - -#### Returns: -| Type | Description | -|-----------|---------------------------------------------------------------------------| -| `Candles` | A new instance of the class with the renamed columns if inplace is False. | - - - -### plot -```python -def plot(subplots=None, span: int = None, filename="", **kwargs): -``` -Create a plot with mplfinance, can be saved as png. - -#### Parameters: -| Name | Type | Description | Default | -|------------|--------|-------------------------|---------| -| `subplots` | `dict` | Add subplots | None | -| `span` | `int` | Take the last n candles | None | -| `filename` | `str` | A name to save plot | "" | -| `**kwargs` | `Any` | Kwargs to plot function | | - - - -### make_subplot -```python -def make_subplot(column: str | list[str], span: int = None, **kwargs): -``` -Create a plot with mplfinance, can be saved as png. - -#### Parameters: -| Name | Type | Description | Default | -|------------|-------------------|--------------------------------------------------|---------| -| `column` | `list[str]\| str` | An iterable of column names as a list or strings | None | -| `span` | `int` | Take the last n candles | None | -| `**kwargs` | `Any` | Kwargs to plot function | | +| Method | Description | +|--------|-------------| +| `ta_lib(func, *args, **kwargs)` | Run any `pandas_ta` indicator | +| `ta.sma(length)`, `ta.ema(length)`, etc. | Standard TA indicators via `pandas_ta` | diff --git a/docs/lib/executor.md b/docs/lib/executor.md index dcd3cd2..008398a 100644 --- a/docs/lib/executor.md +++ b/docs/lib/executor.md @@ -1,94 +1,41 @@ -# Executor +# executor -## Table of Contents -- [Executor](#executor.Executor) -- [__init__](#executor.__init__) -- [add_function](#executor.add_function) -- [add_coroutine](#executor.add_coroutine) -- [run_function](#executor.run_function) -- [execute](#executor.execute) +`aiomql.lib.executor` — Strategy and task executor. - -### Executor -```python -class Executor -``` -Executor class for running multiple strategies on multiple symbols concurrently. -#### Attributes: -| Name | Type | Description | Default | -|--------------------|----------------------|------------------------------------------------|---------| -| `executor` | `ThreadPoolExecutor` | The default thread executor. | None | -| `strategy_runners` | `list[Strategy]` | List of strategies. | [] | -| `coroutines` | `dict` | Dictionary of coroutines and keyword arguments | {} | -| `functions` | `dict` | Dictionary of functions and keyword arguments | {} | +## Overview - -#### \_\_init\_\_ -```python -def __init__(self): -``` -Initialize the executor class. +The `Executor` manages the lifecycle of trading strategies and background tasks. It collects +functions, coroutines, and `Strategy` instances, then runs them via a `TaskQueue`. - -### add_coroutine -```python -def add_coroutine(self,*,coroutine: Callable | Coroutine,kwargs: dict = None,on_separate_thread=False): -``` -Submit a coroutine to the executor. The coroutines are run in parallel using *asyncio.gather* except when the -on_spate_thread flag is set to True. In that case, the coroutine is run in a separate thread. +## Classes -#### Arguments: -| Name | Type | Description | -|----------------------|------------|-------------------------------------------------| -| `coroutine` | `Callable` | The coroutine | -| `kwargs` | `Dict` | The keyword arguments to pass to the coroutine. | -| `on_separate_thread` | `bool` | If True run the coroutine on a separate thread | +### `Executor` - -### add_function -```python -def add_function(self, *, function: Callable, kwargs: dict = None) -``` -Submit a function to the executor. Each functions runs on a separate thread. +> Executes strategies and tasks using a `TaskQueue`. -#### Arguments: -| Name | Type | Description | -|------------|------------|--------------------------------------------| -| `function` | `Callable` | The function to run in the executor | -| `kwargs` | `Dict` | Keyword arguments to pass to the function. | +| Attribute | Type | Description | +|-----------|------|-------------| +| `config` | `Config` | Global configuration | +| `task_queue` | `TaskQueue` | The underlying task queue | - -### run_function -```python -@staticmethod -def run_function(function: Callable, kwargs: dict) -``` -Wrap the input coroutine function with 'asyncio.run' so that it can be executed in a threadpool executor. -#### Arguments: -| Name | Type | Description | -|------------|------------|--------------------------------------------| -| `function` | `Callable` | Run a function in the executor | -| `kwargs` | `Dict` | Keyword arguments to pass to the function. | +#### Adding Tasks - -### exit -```python -async def exit() -``` -Shutdowns the executor. Due to the nature of threadpool executors, shutdown is not usually an immediate process. -This exit function is added as a coroutine function to the bot or backtester during initialization. +| Method | Description | +|--------|-------------| +| `add_function(func, *args, **kwargs)` | Registers a regular callable | +| `add_coroutine(coro, *args, **kwargs)` | Registers an async coroutine | +| `add_strategy(strategy)` | Registers a `Strategy` instance | - -### execute -```python -def execute(workers: int = 5) -``` -Run the strategies with a threadpool executor. -#### Arguments: -| Name | Type | Description | -|-----------|-------|-----------------------------------------------------------| -| `workers` | `int` | Number of workers to use in executor pool. Defaults to 5. | +#### Execution -#### Notes: -No matter the number specified, the number of workers will always be greater than equal to the minimum number of -workers required to run all functions, coroutines and strategies added to the executor. +| Method | Description | +|--------|-------------| +| `execute()` | Starts all registered tasks and strategies via the queue | +| `run_coroutine_task(coro, *args, **kwargs)` | Runs a single coroutine task | + +#### Shutdown + +| Method | Description | +|--------|-------------| +| `sigint_handle(sig, frame)` | Handles SIGINT for graceful shutdown | +| `exit()` | Sets the shutdown flag and stops the queue | diff --git a/docs/lib/history.md b/docs/lib/history.md index ff9bf18..5b7acee 100644 --- a/docs/lib/history.md +++ b/docs/lib/history.md @@ -1,135 +1,53 @@ -# History +# history -## Table of contents -- [History](#history.history) -- [\_\_init\_\_](#history.__init__) -- [initialize](#history.initialize) -- [get_deals](#history.get_deals) -- [get_deals_by_ticket](#history.get_deals_by_ticket) -- [get_deals_by_position](#history.get_deals_by_position) -- [get_orders](#history.get_orders) -- [get_orders_by_position](#history.get_orders_by_position) -- [get_orders_by_ticket](#history.get_orders_by_ticket) +`aiomql.lib.history` — Historical deals and orders retrieval. - -### History -```python -class History -``` -The history class handles completed trade deals and trade orders in the trading history of an account. -#### Attributes -| Name | Type | Description | Default | -|----------------|--------------------|------------------------------------------------------------------------|---------| -| `deals` | `list[TradeDeal]` | Iterable of trade deals | [] | -| `orders` | `list[TradeOrder]` | Iterable of trade orders | [] | -| `total_deals` | `int` | Total number of deals | 0 | -| `total_orders` | `int` | Total number orders | 0 | -| `group` | `str` | Filter for selecting history by symbols. | "" | -| `mt5` | `MetaTrader` | MetaTrader instance | None | -| `config` | `Config` | Config instance | None | +## Overview +The `History` class retrieves completed trade deals and orders from the MetaTrader 5 terminal +for a specified date range. Results are cached for efficient filtering and querying. - -### \_\_init\_\_ -```python -def __init__(*, date_from: datetime | float, date_to: datetime | float, group: str = "") -``` +Inherits from [`_Base`](../core/base.md). -#### Parameters: -| Name | Type | Description | Default | -|-------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------| -| `date_from` | `datetime\|float` | Date the deals are requested from. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. Defaults to twenty-four hours from the current time in 'utc' | 0 | -| `date_to` | `datetime\|float` | Date up to which the deals are requested. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. Defaults to the current time in "utc" | 0 | -| `group` | `str` | Filter for selecting history by symbols. | "" | +## Classes - -### initialize -```python -async def initialize() -> bool -``` -Get deals and orders within the timeframe specified in the constructor. +### `History` - -### get_deals -```python -async def get_deals(self) -> tuple[TradeDeal, ...] -``` -Get deals from trading history using the parameters set in the constructor. +> Retrieves and caches historical deals and orders. -#### Returns -| Name | Type | Description | -|---------|-------------------------|-----------------------| -| `deals` | `tuple[TradeDeal, ...]` | A list of trade deals | +| Attribute | Type | Description | +|-----------|------|-------------| +| `deals` | `tuple[TradeDeal, ...]` | Cached deals | +| `orders` | `tuple[TradeOrder, ...]` | Cached orders | +| `total_deals` | `int` | Total deal count in range | +| `total_orders` | `int` | Total order count in range | - -### get_deals_by_ticket -```python -def get_deals_by_ticket(self, *, ticket: int) -> tuple[TradeDeal, ...] -``` -Get deals by ticket number. This filters deals by ticket based on the deals already fetched in initialize. +#### Initialization -#### Parameters -| Name | Type | Description | -|----------|-------|----------------------| -| `ticket` | `int` | Ticket number to get | +| Method | Description | +|--------|-------------| +| `init(date_from, date_to)` | Fetches deals and orders for the date range | +| `get_deals(date_from, date_to)` | Fetches deals only | +| `get_orders(date_from, date_to)` | Fetches orders only | -#### Returns: -| Name | Type | Description | -|---------|-------------------------|------------------------| -| `deals` | `tuple[TradeDeal, ...]` | A tuple of trade deals | +#### Filtering Deals - -### get_deals_by_position -```python -async def get_deals_by_position(self, *, position: int) -> tuple[TradeDeal, ...] -``` -Get deals by position -#### Parameters -| Name | Type | Description | -|------------|-------|------------------------| -| `position` | `int` | Position number to get | +| Method | Description | +|--------|-------------| +| `filter_deals_by_symbol(symbol)` | Filter deals by symbol name | +| `filter_deals_by_ticket(ticket)` | Filter deals by ticket number | +| `filter_deals_by_position(position)` | Filter deals by position ID | +| `get_deals_by_position(position)` | Get all deals for a position | -#### Returns -| Name | Type | Description | -|---------|-------------------------|------------------------| -| `deals` | `tuple[TradeDeal, ...]` | A tuple of trade deals | +#### Filtering Orders - -### get_orders -```python -async def get_orders(self) -> tuple[TradeOrder, ...] -``` -Get orders from trading history using the parameters set in the constructor. +| Method | Description | +|--------|-------------| +| `filter_orders_by_symbol(symbol)` | Filter orders by symbol name | +| `filter_orders_by_ticket(ticket)` | Filter orders by ticket number | +| `filter_orders_by_position(position)` | Filter orders by position ID | +| `get_orders_by_position(position)` | Get all orders for a position | - -### get_orders_by_position -```python -def get_orders_by_position(self, *, position: int) -> tuple[TradeOrder, ...] -``` -Get orders by position. -#### Parameters -| Name | Type | Description | -|------------|-------|------------------------| -| `position` | `int` | Position number to get | +## Synchronous API -#### Returns -| Name | Type | Description | -|----------|--------------------------|-------------------------| -| `orders` | `tuple[TradeOrder, ...]` | A tuple of trade orders | - - -### get_orders_by_ticket -```python -def get_orders_by_ticket(self, *, position: int) -> tuple[TradeOrder, ...] -``` - -Get orders by ticket number. This filters orders by ticket based on the orders already fetched in initialize. -#### Parameters -| Name | Type | Description | -|----------|-------|----------------------| -| `ticket` | `int` | ticket number to get | - -#### Returns -| Name | Type | Description | -|----------|--------------------------|-------------------------| -| `orders` | `tuple[TradeOrder, ...]` | A tuple of trade orders | +A synchronous variant is available in `aiomql.lib.sync.history`. diff --git a/docs/lib/order.md b/docs/lib/order.md index 72f8af1..c7e5f47 100644 --- a/docs/lib/order.md +++ b/docs/lib/order.md @@ -1,171 +1,61 @@ -# Order +# order -## Table of contents -- [Order](#order.order) -- [\_\_init\_\_](#order.__init__) -- [orders_total](#order.orders_total) -- [get_order](#order.get_pending_order) -- [get_orders](#order.get_pending_orders) -- [check](#order.check) -- [send](#order.send) -- [calc_margin](#order.calc_margin) -- [calc_profit](#order.calc_profit) -- [calc_loss](#order.calc_loss) -- [request](#order.request) -- [modify](#order.modify) +`aiomql.lib.order` — Trade order creation, checking, and sending. - -### Order -```python -class Order(_Base, TradeRequest) -``` -Trade order related functions and attributes. Subclass of TradeRequest. +## Overview - -### \_\_init\_\_ -```python -def __init__(**kwargs) -``` -Initialize the order object with keyword arguments, symbol must be provided. -Provides default values for action, type_time and type_filling if not provided. -#### Arguments -| Name | Type | Description | Default | -|----------------|---------------------|----------------------------------------|------------------| -| `action` | `TradeAction` | Trade action | TradeAction.DEAL | -| `type_time` | `OrderTime` | Order time | OrderTime.DAY | -| `type_filling` | `OrderFilling` | Order filling | OrderFilling.FOK | +The `Order` class creates and manages trade orders for the MetaTrader 5 terminal. It handles +margin calculations, profit projections, order validation, modification, and cancellation. - -```python -async def orders_total() -``` -Get the total number of active pending orders. -#### Returns -| Type | Description | -|-------|-------------------------------| -| `int` | total number of active orders | +Inherits from [`_Base`](../core/base.md). - -### get_pending order -```python -async def get_pending_order(self, ticket: int) -> TradeOrder -``` -Get an active pending trade order by ticket. +## Classes - -### get_pending_orders -```python -async def get_pending_orders(self, *, ticket: int = 0, symbol: str = '', group: str = '') -> tuple[TradeOrder, ...]: -``` -Get active trade orders. If ticket is provided, it will return the order with the specified ticket. -If symbol is provided, it will return all orders for the specified symbol. -If group is provided, it will return all orders for the specified group. +### `Order` -#### Parameters: -| Name | Type | Description | Default | -|----------|--------|--------------------------------------|---------| -| `ticket` | `int` | Order ticket | 0 | -| `symbol` | `str` | Symbol name | '' | -| `group` | `str` | Group name | '' | +> Creates, validates, and sends trade orders. -#### Returns: -| Type | Description | -|--------------------------|------------------------------------------------------| -| `tuple[TradeOrder, ...]` | A Tuple of active trade orders as TradeOrder objects | +| Attribute | Type | Description | +|-----------|------|-------------| +| `action` | `TradeAction` | Trade action type | +| `type` | `OrderType` | Order type (BUY, SELL, etc.) | +| `symbol` | `str` | Trading instrument | +| `volume` | `float` | Trade volume in lots | +| `price` | `float` | Order price | +| `sl` | `float` | Stop loss level | +| `tp` | `float` | Take profit level | +| `deviation` | `int` | Maximum price deviation | +| `magic` | `int` | Expert Advisor magic number | +| `comment` | `str` | Order comment | +| `type_filling` | `OrderFilling` | Filling policy | +| `type_time` | `OrderTime` | Time-in-force policy | - -### check -```python -async def check(**kwargs) -> OrderCheckResult -``` -#### Parameters: -| Type | Description | -|--------|----------------------------------------------| -| kwargs | Update the request dict with extra arguments | +#### `request` *(property)* -Check if an order is okay. +Returns the trade request as a dict, filtering out `None` values. -#### Returns: -| Type | Description | -|--------------------|----------------------------| -| `OrderCheckResult` | An OrderCheckResult object | +#### Validation -#### Raises: -| Exception | Description | -|--------------|-------------------| -| `OrderError` | If not successful | +| Method | Returns | Description | +|--------|---------|-------------| +| `check()` | `OrderCheckResult` | Validates the order, raises `OrderError` on failure | - -### send -```python -async def send() -> OrderSendResult -``` -Send a request to perform a trading operation from the terminal to the trade server. +#### Execution -#### Returns: -| Type | Description | -|-------------------|---------------------------| -| `OrderSendResult` | An OrderSendResult object | +| Method | Returns | Description | +|--------|---------|-------------| +| `send()` | `OrderSendResult` | Sends the order; retries on requote/timeout | -#### Raises: -| Exception | Description | -|--------------|-------------------| -| `OrderError` | If not successful | +#### Calculations - -### calc_margin: -```python -async def calc_margin() -> float -``` -Return the required margin in the account currency to perform a specified trading operation. +| Method | Returns | Description | +|--------|---------|-------------| +| `calc_margin()` | `float \| None` | Required margin for the order | +| `calc_profit(close_price)` | `float \| None` | Projected profit at a given close price | -#### Returns: -| Type | Description | -|---------|-----------------------------------| -| `float` | Returns float value if successful | +#### Modification - -### calc_profit -```python -async def calc_profit() -> float -``` -Return profit in the account currency for a specified trading operation. - -#### Returns: -| Type | Description | -|---------|-----------------------------------| -| `float` | Returns float value if successful | -| `None` | If not successful | - - -### calc_profit -```python -async def calc_loss() -> float -``` -Return loss in the account currency for a specified trading operation. -#### Returns -| Type | Description | -|---------|-----------------------------------| -| `float` | Returns float value if successful | -| `None` | If not successful | - - -### request -```python -@property -async def request() -> dict -``` -Return the trade request object as a dict - -#### Returns -| Type | Description | -|--------|----------------------------------| -| `dict` | Returns the trade request object | - - - -### modify -```python -def modify(**kwargs) -``` -Modify the order object with keyword arguments. +| Method | Description | +|--------|-------------| +| `modify(**kwargs)` | Modifies a pending order's parameters | +| `cancel()` | Cancels a pending order | diff --git a/docs/lib/positions.md b/docs/lib/positions.md index d3da353..3092ee9 100644 --- a/docs/lib/positions.md +++ b/docs/lib/positions.md @@ -1,175 +1,38 @@ -# Positions +# positions -## Table of contents -- [Positions](#positions.positions) -- [\_\_init\_\_](#positions.__init__) -- [get_positions](#positions.get_positions) -- [get_position_by_ticket](#positions.get_position_by_ticket) -- [get_positions_by_symbol](#positions.get_positions_by_symbol) -- [close](#positions.close) -- [close_position_by_ticket](#positions.close_position_by_ticket) -- [close_position](#positions.close_position) -- [close_all](#positions.close_all) -- [get_total_positions](#positions.get_total_positions) +`aiomql.lib.positions` — Open position management. - -### Positions -```python -class Positions -``` -Get and handle Open positions. +## Overview -#### Attributes -| Name | Type | Description | -|-------------|-----------------------------|-------------------------------------------------------------------------------------| -| `positions` | `tuple[TradePosition, ...]` | Financial instrument name. | -| `mt5` | `MetaTrader` | MetaTrader instance. | -|`total_positions`| `int` | Total number of open positions. Can be set in `get_positions` or `get_total_positions`. | +The `Positions` class provides methods for retrieving, counting, and closing open positions +in the MetaTrader 5 terminal. - -### \_\_init\_\_ -```python -def __init__() -``` -Initialize a position instance +Inherits from [`_Base`](../core/base.md). +## Classes - -### get_positions -```python -async def get_positions(*, symbol: str = None, ticket: int = None, group: str = None) -> tuple[TradePosition, ...]: -``` -Get open positions, with the ability to filter by symbol, ticket, or group. +### `Positions` -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------| -| `symbol` | `str` | Symbol | -| `ticket` | `int` | Position ticket | -| `group` | `str` | Group name | +> Manages open positions in MetaTrader 5. +#### Retrieval -#### Returns: -| Type | Description | -|-----------------------------|--------------------------------| -| `tuple[TradePosition, ...]` | A list of open trade positions | +| Method | Returns | Description | +|--------|---------|-------------| +| `positions_get(symbol, group, ticket)` | `tuple[TradePosition, …] \| None` | Get positions matching criteria | +| `positions_total()` | `int` | Total number of open positions | +| `get_by_ticket(ticket)` | `TradePosition \| None` | Get a position by ticket | +| `get_by_symbol(symbol)` | `tuple[TradePosition, …] \| None` | Get positions for a symbol | +#### Closing - -### get_position_by_ticket -```python -async def get_position_by_ticket(self, *, ticket: int) -> TradePosition -``` -Get a position by ticket id. +| Method | Returns | Description | +|--------|---------|-------------| +| `close(*, ticket, symbol, volume, price, order_type)` | `OrderSendResult` | Close a position | +| `close_all()` | `None` | Close all open positions | -#### Parameters: -| Name | Type | Description | -|----------|-------|-----------------| -| `ticket` | `int` | Position ticket | +#### Counting -#### Returns: -| Type | Description | -|-----------------|----------------| -| `TradePosition` | Trade position | - - - -### get_positions_by_symbol -```python -async def get_positions_by_symbol(self, *, symbol: str) -> tuple[TradePosition, ...] -``` -Filter positions by symbols - -#### Parameters: -| Name | Type | Description | -|----------|-------|-------------| -| `symbol` | `str` | Symbol | - -#### Returns: -| Type | Description | -|-----------------------------|----------------| -| `tuple[TradePosition, ...]` | Trade position | - - - -### close -```python -async def close(self, *, ticket: int, symbol: str, price: float, volume: float, order_type: OrderType) -> OrderSendResult: -``` -Close a position using its details. - -#### Parameters: -| Name | Type | Description | -|--------------|-------------|----------------------------| -| `ticket` | `int` | Position ticket. | -| `symbol` | `str` | Financial instrument name. | -| `price` | `float` | Closing price. | -| `volume` | `float` | Volume to close. | -| `order_type` | `OrderType` | Order type. | - -#### Returns: -| Type | Description | -|--------------------|----------------------------------------------------| -| `OrderSendResult ` | The result of the order sent to close the position | - - - -### close_position -```python -async def close_position(self, *, position: TradePosition) -> OrderSendResult: -``` -Close a position by position object. - -#### Parameters: -| Name | Type | Description | -|------------|-----------------|-----------------| -| `position` | `TradePosition` | Position object | - -#### Returns: -| Type | Description | -|-------------------|----------------------------------------------------| -| `OrderSendResult` | The result of the order sent to close the position | - - - -### close_position_by_ticket -```python -async def close_position_by_ticket(self, *, position: TradePosition) -> OrderSendResult: -``` -Close a position by position object. - -#### Parameters: -| Name | Type | Description | -|------------|-----------------|-----------------| -| `position` | `TradePosition` | Position object | - -#### Returns: -| Type | Description | -|-------------------|----------------------------------------------------| -| `OrderSendResult` | The result of the order sent to close the position | - - - -### close_all -```python -async def close_all() -> int -``` -Close all open positions for the trading account. - -#### Returns: -| Type | Description | -|-------|--------------------------------------| -| `int` | Return total number of closed trades | - - - -### get_total_positions -```python -async def get_total_positions() -> int -``` -Get the total number of open positions and set the `total_positions` attribute. - -#### Returns: -| Type | Description | -|-------|--------------------------------------| -| `int` | Return total number of open trades | +| Method | Returns | Description | +|--------|---------|-------------| +| `get_total_positions()` | `int` | Number of open positions | diff --git a/docs/lib/ram.md b/docs/lib/ram.md index 34fe951..c80c7ef 100644 --- a/docs/lib/ram.md +++ b/docs/lib/ram.md @@ -1,86 +1,37 @@ -# Risk Assessment and Management +# ram -## Table of Contents -- [RAM](#ram.ram) -- [\__init\__](#ram.__init__) -- [get_amount](#ram.get_amount) -- [check_losing_positions](#ram.check_losing_positions) -- [check_open_positions](#ram.check_open_positions) -- [modify_ram](#ram.modify_ram) +`aiomql.lib.ram` — Risk Assessment and Money management. - -### RAM -```python -class RAM -``` -Risk Assessment and Management. You can customize this class based on how you want to manage risk. +## Overview -#### Attributes: -| Name | Type | Description | Default | -|------------------|-----------|---------------------------------------------------|-----------| -| `account` | `Account` | The account object | Account() | -| `risk_to_reward` | `float` | Risk to reward ratio | 2 | -| `risk` | `float` | Percentage of account balance to risk per trade | 1% | -| `fixed_amount` | `float` | A fixed amount to risk per trade | | -| `min_amount` | `float` | Minimum amount to risk per trade | | -| `max_amount` | `float` | Maximum amount to risk per trade | | -| `loss_limit` | `int` | Number of open losing trades to allow at any time | 3 | -| `open_limit` | `int` | Number of open trades to allow at any time | 3 | +The `RAM` class calculates position sizes based on risk parameters and account balance. +It checks open positions against configured limits and determines the volume for new trades. +Inherits from [`_Base`](../core/base.md). - -### \_\_init\_\_ -```python -def __init__(self, **kwargs): -``` -Risk Assessment and Management. All provided keyword arguments are set as attributes. -#### Parameters -| Name | Type | Description | Default | -|------------------|--------|----------------------------------------------------|-----------| -| `kwargs` | `dict` | Keyword arguments to be set as instance attributes | {} | +## Classes +### `RAM` - -### ram.get_amount -```python -async def get_amount() -> float -``` -Calculate the amount to risk per trade as a percentage of balance. +> Calculates trade volumes using risk-based sizing. -#### Returns: -| Type | Description | -|---------|-------------------------------------------------------| -| `float` | Amount to risk per trade in terms of account currency | +| Attribute | Type | Default | Description | +|-----------|------|---------|-------------| +| `risk_to_reward` | `float` | `2` | Risk-to-reward ratio | +| `risk` | `float` | `0.01` | Risk per trade as a fraction of balance | +| `min_amount` | `float` | `0` | Minimum trade amount in account currency | +| `max_amount` | `float` | `0` | Maximum trade amount (0 = unlimited) | +| `max_open_positions` | `int` | `0` | Maximum concurrent positions (0 = unlimited) | +| `fixed_amount` | `float` | `0` | Fixed trade amount (overrides risk calculation) | - -### check_losing_positions -```python -async def check_losing_positions(self) -> bool: -``` -Check if the number of open losing trades is greater than or equal to the loss limit. +#### Methods -#### Returns: -| Type | Description | -|--------|---------------------------------------------------------------------------------------| -| `bool` | True if the number of open losing trades is more than the loss limit, False otherwise | +| Method | Returns | Description | +|--------|---------|-------------| +| `check_open_positions()` | `bool` | `True` if under the open-position limit | +| `get_amount()` | `float` | Calculates the trade amount based on risk parameters | +| `calc_volume(symbol, amount, pips, …)` | `float` | Calculates lot size from amount and stop distance | +## Synchronous API - -### check_open_positions -```python -async def check_open_positions(self) -> bool: -``` -Check if the number of open positions is less than or equal the loss limit. - -#### Returns: -| Type | Description | -|--------|---------------------------------------------------------------------------------------| -| `bool` | True if the number of open losing trades is more than the loss limit, False otherwise | - - - -### modify_ram -```python -def modify_ram(**kwargs): -``` -Modify the RAM attributes. All provided keyword arguments are set as attributes. +Available in `aiomql.lib.sync.ram`. diff --git a/docs/lib/result.md b/docs/lib/result.md index 04de226..acca62e 100644 --- a/docs/lib/result.md +++ b/docs/lib/result.md @@ -1,80 +1,35 @@ -# Result +# result -## Table of Contents -- [Result](#result.result) -- [__init__](#result.__init__) -- [save](#result.save) -- [get_data](#result.get_data) -- [to_csv](#result.to_csv) -- [to_json](#result.to_json) +`aiomql.lib.result` — Trade result recording (CSV / JSON / SQL). +## Overview - -```python -class Result -``` -A base class for handling trade results and strategy parameters for record keeping and analysis. -#### Attributes: -| Name | Type | Description | -|--------------|-------------------|-----------------------------------| -| `result` | `OrderSendResult` | The result of the trade | -| `parameters` | `dict` | The parameters used for the trade | -| `name` | `str` | The name of the result object | +The `Result` class records trade outcomes and strategy parameters to files in CSV, JSON, +or SQL format. It integrates with the `Config` to determine the recording directory and +format. +Inherits from [`_Base`](../core/base.md). - -### \__init\__ -```python -def __init__(*, result: OrderSendResult, parameters: dict = None, name: str = '') -``` -Prepare result data for record keeping and analysis. +## Classes -#### Parameters: -| Name | Type | Description | -|--------------|-------------------|-----------------------------------| -| `result` | `OrderSendResult` | The result of the trade | -| `parameters` | `dict` | The parameters used for the trade | -| `name` | `str` | The name of the result object | +### `Result` +> Saves trade results to persistent storage. - -### get_data -```python -def get_data(self) -> dict -``` -Get the result data as a dictionary +| Attribute | Type | Description | +|-----------|------|-------------| +| `config` | `Config` | Global configuration | -#### Returns: -| Type | Description | -|--------|-----------------| -| `dict` | The result data | +#### Methods +| Method | Description | +|--------|-------------| +| `save(result, parameters, name)` | Dispatches to the configured format (CSV/JSON/SQL) | +| `save_csv(result, parameters, name)` | Appends a result row to a CSV file | +| `save_json(result, parameters, name)` | Appends a result object to a JSON file | +| `save_sql(result, parameters, name)` | Saves the result to the SQLite database | +| `get_data(result, parameters)` | Prepares a unified dict from result and parameters | - -### to_save -```python -async def to_save(*, trade_record_mode: Literal["csv", "json"] = None) -``` -Save to json or csv depending on the trade record mode. +## Synchronous API -#### Returns: -| Name | Type | Description | Default | -|---------------------|--------------------------|-----------------------|---------| -| `trade_record_mode` | `Literal["csv", "json"]` | The trade record mode | None | - - - -### to_csv -```python -async def to_csv() -``` -Record trade results and associated parameters as a csv file - - - -### to_json -```python -async def to_json() -``` -Record trade results and associated parameters as a json file -``` +Available in `aiomql.lib.sync.result`. diff --git a/docs/lib/result_db.md b/docs/lib/result_db.md new file mode 100644 index 0000000..6bef9ad --- /dev/null +++ b/docs/lib/result_db.md @@ -0,0 +1,37 @@ +# result_db + +`aiomql.lib.result_db` — SQLite-backed trade result storage. + +## Overview + +The `ResultDB` dataclass stores trade results in a SQLite database via the [`DB`](../core/db.md) +ORM base class. Each instance represents a single trade record with fields for order details, +strategy parameters, and profit/loss. + +## Classes + +### `ResultDB` + +> Dataclass for persisting trade results to SQLite. + +Inherits from `DB`. Decorated with `@dataclass`. + +| Field | Type | Description | +|-------|------|-------------| +| `id` | `int` | Primary key (auto-incremented) | +| `symbol` | `str` | Trading instrument | +| `order_type` | `str` | Order type string | +| `strategy` | `str` | Strategy name | +| `volume` | `float` | Trade volume | +| `points` | `float` | Profit in points | +| `profit` | `float` | Profit in account currency | +| `actual_profit` | `float` | Actual profit after close | +| `*` | … | Additional strategy-specific fields | + +#### Methods + +| Method | Description | +|--------|-------------| +| `save(commit, update, data, conn)` | Inserts or updates the record | +| `get(**kwargs)` | Retrieves a single matching record | +| `filter(**kwargs)` | Retrieves all matching records | diff --git a/docs/lib/sessions.md b/docs/lib/sessions.md index f3595a8..477f524 100644 --- a/docs/lib/sessions.md +++ b/docs/lib/sessions.md @@ -1,259 +1,53 @@ -from aiomql import TradePositionfrom aiomql.lib.sessions import Duration +# sessions -# Session and Sessions -Sessions allow you to run a strategy at specific times of the day. +`aiomql.lib.sessions` — Trading session time windows. -## Table of Contents -- [Session](#session) - - [\__init\__](#session.__init__) - - [begin](#session.begin) - - [close](#session.close) - - [action](#session.action) - - [in_session](#session.in_session) - - [duration](#session.duration) - - [close_positions](#session.close_positions) - - [close_all](#session.close_all) - - [close_win](#session.close_win) - - [close_loss](#session.close_loss) - - [close_until](#session.until) -- [Sessions](#sessions.sessions) - - [\__init\__](#sessions.__init__) - - [find](#sessions.find) - - [find_next](#sessions.find_next) - - [check](#sessions.check) -- [delta](#sessions_mod.delta) -- [backtest_sleep](#sessions_mod.backtest_sleep) - +## Overview - -## Session -```python -class Session -``` -A session is a time period between two `datetime.time` objects specified in utc. +Provides `Session` (a single trading window) and `Sessions` (a collection of windows) +for restricting trading to specific hours of the day. Sessions can automatically trigger +actions at their boundaries — e.g. closing all positions when a session ends. -#### Attributes: -| Name | Type | Description | Default | -|----------------|-------------------------------------------------------------------|------------------------------------------------------------------------|---------| -| `start` | `datetime.time` | The start time of the session. | None | -| `end` | `datetime.time` | The end time of the session. | None | -| `on_start` | `Literal['close_all', 'close_win', 'close_loss', 'custom_start']` | The action to take when the session starts. Default is None. | None | -| `on_end` | `Literal['close_all', 'close_win', 'close_loss', 'custom_end']` | The action to take when the session ends. Default is None. | None | -| `custom_start` | `Callable` | A custom function to call when the session starts. Default is None. | None | -| `custom_end` | `Callable` | A custom function to call when the session ends. Default is None. | None | -| `name` | `str` | The name of the session. Default is a combination of start and finish. | | +## Classes -#### Notes: -The `[close_all, close_win, close_loss]` will affect or open positions in the account irrespective of whether they were -opened during the session or not or even by a strategy using the session. This is because the session is not aware of the -positions opened by the strategy. This will be handled in a future release. +### `Session` - -### \__init\__ -```python -def __init__(*, - start: int | time, - end: int | time, - on_start: Literal['close_all', 'close_win', 'close_loss', - 'custom_start'] = None, - on_end: Literal['close_all', 'close_win', 'close_loss', - 'custom_end'] = None, - custom_start: Callable = None, - custom_end: Callable = None) -``` -Create a session -#### Parameters: -| Name | Type | Description | Default | -|----------------|-------------------------------------------------------------------|---------------------------------------------------------------------|---------| -| `start` | `int` \| `datetime.time` | The start time of the session in UTC. | None | -| `end` | `int` \| `datetime.time` | The end time of the session in UTC. | None | -| `on_start` | `Literal['close_all', 'close_win', 'close_loss', 'custom_start']` | The action to take when the session starts. Default is None. | None | -| `on_end` | `Literal['close_all', 'close_win', 'close_loss', 'custom_end']` | The action to take when the session ends. Default is None. | None | -| `custom_start` | `Callable` | A custom function to call when the session starts. Default is None. | None | -| `custom_end` | `Callable` | A custom function to call when the session ends. Default is None. | None | -| `name` | `str` | The name of the session. Default is None. | None | +> Defines a single trading time window. +| Attribute | Type | Description | +|-----------|------|-------------| +| `name` | `str` | Session name | +| `start` | `time` | Session start time | +| `end` | `time` | Session end time | +| `on_start` | `Callable \| None` | Hook called when the session opens | +| `on_end` | `Callable \| None` | Hook called when the session closes | +| `close_all` | `bool` | If `True`, close all positions on session end | - -### begin -```python -async def begin() -``` -Call the action specified in on_start or custom_start. +#### Properties +| Property | Returns | Description | +|----------|---------|-------------| +| `duration` | `timedelta` | Length of the session | +| `in_session` | `bool` | `True` if current time is within the window | - -### close -```python -async def close() -``` -Call the action specified in on_end or custom_end. +--- +### `Sessions` - -### in_session -```python -def in_session() -> bool -``` -Check if the current time is within the current session. +> Manages multiple `Session` objects. +| Attribute | Type | Description | +|-----------|------|-------------| +| `sessions` | `list[Session]` | Registered sessions | - -### duration -```python -def duration() -> Duration -``` -Get the duration of the session in hours, minutes, and seconds. +#### Methods +| Method | Description | +|--------|-------------| +| `add(session)` | Adds a session | +| `find(name)` | Finds a session by name | +| `check()` | Checks which sessions are active and triggers hooks | - -### close_positions -```python -async def close_positions(*, positions: tuple[TradePosition, ...]) -``` -Close positions in the sessions. This is used by the `close_all` action. +## Synchronous API -#### Parameters: -| Name | Type | Description | -|-------------|-----------------------------|---------------------------------------| -| `positions` | `tuple[TradePosition, ...]` | A tuple of TradePosition objects. | - - - -### close_all -```python -async def close_all() -``` -Close all open positions - - - -### close_win -```python -async def close_win() -``` -Close only winning positions - - - -### close_loss -```python -async def close_loss() -``` -Close only losing positions - - - -### action -```python -async def action(*, action: Literal["close_all", "close_win", "close_loss", "custom_start", "custom_end"]): pass -``` -Used by begin and close to call the action specified. - -#### Parameters: -| Name | Type | Description | -|----------|---------------------------------------------------------------------------------|---------------------| -| `action` | `Literal['close_all', 'close_win', 'close_loss', 'custom_start', 'custom_end']` | The action to take. | - - - -### until -```python -def until() -> int -``` -Get the seconds until the session starts from the current time. - - - -## Sessions -```python -class Sessions() -``` -Sessions allow you to run code at specific times of the day. It is a collection of Session objects. -Sessions are sorted by start time. The sessions object is an asynchronous context manager. - -### Attributes: -| Name | Type | Description | Default | -|-------------------|-----------------|----------------------------|---------| -| `sessions` | `list[Session]` | A list of Session objects. | [] | -| `current_session` | `Session` | The current session. | None | - - - -#### \__init\__ -```python -def __init__(*sessions: Iterable[Session]) -``` -Create a Sessions object. -#### Parameters: -| Name | Type | Description | -|------------|---------------------|--------------------------------| -| `sessions` | `Iterable[Session]` | A iterable of Session objects. | - - - -### find -```python -def find(*, moment: time = None) -> Session | None -``` -Find a session that contains a datetime.time object. - -#### Parameters: -| Name | Type | Description | Default | -|----------|--------|-------------------------|---------| -| `moment` | `time` | A datetime.time object. | None | - -#### Returns: -| Type | Description | -|-----------|----------------------------------------| -| `Session` | A Session object or None if not found. | - - - -### find_next -```python -def find_next(*, moment: time = None) -> Session -``` -Find the next session that contains a datetime.time object. -#### Parameters: -| Name | Type | Description | Default | -|----------|--------|-------------------------|---------| -| `moment` | `time` | A datetime.time object. | | - -#### Returns: -| Type | Description | -|-----------|-------------------| -| `Session` | A Session object. | - - - -### check -```python -async def check(): pass -``` -Check if the current session has started and if not, wait until it starts. - - - -### delta -```python -def delta(obj: time) -> timedelta: pass -``` -Get the timedelta of a datetime.time object. - -#### Parameters: -| Name | Type | Description | Default | -|-------|-----------------|-------------------------|---------| -| `obj` | `datetime.time` | A datetime.time object. | None | -#### Returns -| Type | Description | -|-------------|---------------------| -| `timedelta` | A timedelta object. | - - - -### backtest_sleep -```python -async def backtest_sleep(secs) -``` -Sleep method for backtesting. +Available in `aiomql.lib.sync.sessions`. diff --git a/docs/lib/strategy.md b/docs/lib/strategy.md index 3f43242..ee10042 100644 --- a/docs/lib/strategy.md +++ b/docs/lib/strategy.md @@ -1,144 +1,39 @@ -# Strategy -The base class for creating strategies. +# strategy -## Table of Contents -- [Strategy](#strategy.strategy) -- [\__init\__](#strategy.__init__) -- [sleep](#strategy.sleep) -- [delay](#strategy.delay) -- [live_sleep](#strategy.live_sleep) -- [backtest_sleep](#strategy.backtest_sleep) -- [run_strategy](#strategy.run_strategy) -- [live_strategy](#strategy.live_strategy) -- [backtest_strategy](#strategy.backtest_strategy) -- [trade](#strategy.trade) -- [test](#strategy.test) -- [initialize](#strategy.initialize) +`aiomql.lib.strategy` — Strategy base class. +## Overview - -### Strategy -```python -class Strategy(ABC) -``` -The base class for creating strategies. +The `Strategy` class is the abstract base for all trading strategies. Subclasses implement +`trade()` to define entry/exit logic. The strategy lifecycle is managed by the +[`Bot`](bot.md) / [`Executor`](executor.md). -#### Attributes: -| Name | Type | Description | Default | -|-----------------------|--------------------------------|------------------------------------------------|---------| -| `name` | `str` | A name for the strategy. | None | -| `symbol` | `Symbol` | The Financial Instrument as a Symbol Object | None | -| `sessions` | `Sessions` | Trading sessions. | None | -| `mt5` | `MetaTrader \| MetaBackTester` | MetaTrader instance. | None | -| `config` | `Config` | Config instance. | None | -| `parameters` | `dict` | A dictionary of parameters for the strategy. | None | -| `backtest_controller` | `BackTesterController` | A controller for the backtester. | -| `current_session` | `Session` | The current trading session | -| `running` | `bool` | A flag to indicate if the strategy is running. | True | +Inherits from [`_Base`](../core/base.md). +## Classes - -### \__init\__ -```python -def __init__(*, symbol: Symbol, params: dict = None, sessions: Sessions, name: str = "") -``` -Initiate the parameters dict and add name and symbol fields. Use class name as strategy name if name is not provided. +### `Strategy` -#### Parameters: -| Name | Type | Description | Default | -|------------|------------|-----------------------------|---------| -| `symbol` | `Symbol` | The Financial instrument | | -| `params` | `Dict` | Trading strategy parameters | None | -| `sessions` | `Sessions` | Trading sessions | None | -| `name` | `str` | The name of the strategy | "" | +> Abstract base class for trading strategies. +| Attribute | Type | Description | +|-----------|------|-------------| +| `name` | `str` | Strategy name (defaults to class name) | +| `symbol` | `Symbol` | The trading instrument | +| `sessions` | `Sessions \| None` | Optional session restrictions | +| `params` | `dict` | Strategy parameters | - -### sleep -```python -async def sleep(*, secs: float) -``` -Sleep for the needed amount of seconds in between requests to the terminal. -computes the accurate amount of time needed to sleep ensuring that the next request is made at the start of -a new bar and making cooperative multitasking possible. -This method calls the `live_sleep` method during live trading or `backtest_sleep`. +#### Lifecycle -#### Parameters: -| Name | Type | Description | Default | -|--------|---------|----------------------------------------------------------------|---------| -| `secs` | `float` | The time in seconds. Usually the timeframe you are trading on. | None | +| Method | Description | +|--------|-------------| +| `__init__(symbol, params, sessions, …)` | Initialises the strategy with a symbol and parameters | +| `init()` | Async setup hook (called once before trading begins) | +| `run()` | Main loop — calls `trade()` repeatedly | +| `sleep(secs)` | Suspends the strategy for a duration | +#### Trading Logic - -### delay -```python -async def delay(*, secs: float) -``` -Sleep for the needed amount of seconds specified in the parameter. - - - -### live_sleep -```python -async def live_sleep(*, secs: float) -``` -Sleep method for live trading - - - -### backtest_sleep -```python -async def backtest_sleep(*, secs: float) -``` -Sleep method for backtesting - - - -### trade -```python -@abstractmethod -async def trade() -``` -Place trades using this method. -Implement this method in your own strategy as you wish. - - - -### test -```python -@abstractmethod -async def test() -``` -Use for backtesting. If not implemented use the trade method. - - - -### run_strategy -```python -async def run_strategy() -``` -Run the strategy by calling the trade or test method repeatedly in a while loop. -This method actually calls the `live_strategy` or `backtest_strategy` depending on the mode. - - - -### live_strategy -```python -async def live_strategy() -``` -Runs the strategy in live mode. - - - -### backtest_strategy -```python -async def live_strategy() -``` -Runs the strategy in backtest mode. - - -### initialize -```python -async def initialize() -``` -Initialize a strategy +| Method | Description | +|--------|-------------| +| `trade()` | **Abstract** — implement entry/exit logic here | diff --git a/docs/lib/symbol.md b/docs/lib/symbol.md index d981b89..7e4a8dc 100644 --- a/docs/lib/symbol.md +++ b/docs/lib/symbol.md @@ -1,363 +1,51 @@ -# Symbol -Symbol class for handling a financial instrument. +# symbol -## Table of Contents -- [Symbol](#symbol.symbol) -- [info_tick](#symbol.info_tick) -- [symbol_select](#symbol.symbol_select) -- [info](#symbol.info) -- [initialize](#symbol.initialize) -- [initialize_sync](#symbol.initialize_sync) -- [book_add](#symbol.book_add) -- [book_get](#symbol.book_get) -- [book_release](#symbol.book_release) -- [compute_volume](#symbol.compute_volume) -- [convert_currency](#symbol.convert_currency) -- [copy_rates_from](#symbol.copy_rates_from) -- [copy_rates_from_pos](#symbol.copy_rates_from_pos) -- [copy_rates_range](#symbol.copy_rates_range) -- [copy_ticks_from](#symbol.copy_ticks_from) -- [copy_ticks_range](#symbol.copy_ticks_range) -- [check_volume](#symbol.check_volume) -- [round_off_volume](#symbol.round_off_volume) +`aiomql.lib.symbol` — Trading instrument interface. +## Overview - -### Symbol -```python -class Symbol(_Base, SymbolInfo) -``` -Main class for handling a financial instrument. A subclass of `SymbolInfo` where most of the attributes are defined. -for working with a financial instrument. +The `Symbol` class represents a financial instrument (forex pair, stock, etc.) and provides +methods for querying market data, selecting symbols, and retrieving rates and ticks. -#### Attributes: -| Name | Type | Description | Default | -|-----------|--------------|---------------------------------------|---------| -| `account` | `Account` | Account instance. | None | -| `tick` | `Tick` | The current price tick of the symbol. | None | +Inherits from [`_Base`](../core/base.md). -#### Notes: -Make sure Symbol is always initialized with a name argument. +## Classes - -### info_tick -```python -async def info_tick(*, name: str = "") -> Tick -``` -Get the current price tick of a financial instrument. +### `Symbol` -#### Parameters: -| Name | Type | Description | Default | -|--------|-------|-------------------------|---------| -| `name` | `str` | The name of the symbol. | '' | +> Interface for a MetaTrader 5 trading instrument. -#### Returns: -| Type | Description | -|--------|----------------------| -| `Tick` | Return a Tick Object | +| Attribute | Type | Description | +|-----------|------|-------------| +| `name` | `str` | Symbol name (e.g. `"EURUSD"`) | +| `select` | `bool` | Whether the symbol is selected in Market Watch | +All `SymbolInfo` fields are available as instance attributes after initialisation. - -### symbol_select -```python -async def symbol_select(*, enable: bool = True) -> bool -``` -Select a symbol in the MarketWatch window or remove a symbol from the window. -Update the select property +#### Initialisation -#### Parameters: -| Name | Type | Description | Default | -|----------|--------|---------------------------------------------------------------------------------------------------------|---------| -| `enable` | `bool` | Switch. Optional unnamed parameter. If 'false', a symbol should be removed from the MarketWatch window. | None | +| Method | Description | +|--------|-------------| +| `init()` | Fetches symbol info from the terminal and sets all attributes | -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, otherwise False. | +#### Market Data +| Method | Returns | Description | +|--------|---------|-------------| +| `info_tick()` | `Tick` | Current tick for the symbol | +| `copy_rates_from(timeframe, date_from, count)` | `Candles` | Historical bars from a date | +| `copy_rates_from_pos(timeframe, start_pos, count)` | `Candles` | Historical bars from a position | +| `copy_rates_range(timeframe, date_from, date_to)` | `Candles` | Historical bars in a range | +| `copy_ticks_from(date_from, count, flags)` | `Ticks` | Historical ticks from a date | +| `copy_ticks_range(date_from, date_to, flags)` | `Ticks` | Historical ticks in a range | - -### info -```python -async def info() -> SymbolInfo -``` -Get data on the specified financial instrument and update the symbol object properties +#### Helpers -#### Returns: -| Type | Description | -|--------------|--------------------------| -| `SymbolInfo` | SymbolInfo if successful | +| Property | Returns | Description | +|----------|---------|-------------| +| `pip` | `float` | The pip size for the symbol | +| `spread` | `float` | Current bid-ask spread | -#### Raises: -| Exception | Description | -|--------------|---------------------------------------------------| -| `ValueError` | If request was unsuccessful and None was returned | +## Synchronous API - - -### initialize -```python -async def initialize() -> bool -``` - -Initialized the symbol by pulling properties from the terminal -#### Returns: -| Type | Description | -|--------|--------------------------------------------------------| -| `bool` | Returns True if symbol info was successful initialized | - - -### initialize_sync -```python -def initialize_sync() -> bool -``` -Initialized the symbol by pulling properties from the terminal -#### Returns: -| Type | Description | -|--------|--------------------------------------------------------| -| `bool` | Returns True if symbol info was successful initialized | - - - -### book_add -```python -async def book_add() -> bool -``` -Subscribes the MetaTrader 5 terminal to the Market Depth change events for a specified symbol. -If the symbol is not in the list of instruments for the market, This method will return False. - -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, otherwise False. | - - - -### book_get -```python -async def book_get() -> tuple[BookInfo, ...] -``` -Returns a tuple of BookInfo featuring Market Depth entries for the specified symbol. -#### Returns: -| Type | Description | -|------------------------|-------------------------------------------------------------------| -| `tuple[BookInfo, ...]` | Returns the Market Depth contents as a tuples of BookInfo Objects | - - - -### book_release -```python -async def book_release() -> bool -``` -Cancels subscription of the MetaTrader 5 terminal to the Market Depth change events for a specified symbol. - -#### Returns: -| Type | Description | -|--------|--------------------------------------| -| `bool` | True if successful, otherwise False. | - - - -### compute_volume -```python -async def compute_volume(self) -> float -``` -Computes the volume of a trade based on the amount or any other parameter. -This default implementation returns the minimum volume of the symbol. It is meant to be overridden by a subclass. - -#### Returns -| Type | Description | -|---------|---------------------------------| -| `float` | Returns the volume of the trade | - - - -### check_volume -```python -async def check_volume(*, volume: float) -> tuple[bool, float] -``` -Check if the volume is within the limits of permitted volume for -the symbol. If not, return the nearest limit. - -#### Returns: -| Type | Description | -|----------------------|-------------------------------------------------------------------------------| -| `tuple[bool, float]` | True and the input volume if within bounds, else False and the nearest limit. | - - - -### round_off_volume -```python -async def round_off_volume(*, volume: float, round_down: bool = False) -> float -``` -Round off the volume to the nearest volume step. - -#### Parameters: -| Name | Type | Description | Default | -|--------------|---------|---------------------------------------------------|---------| -| `volume` | `float` | The volume | | -| `round_down` | `float` | Round up or round down to the nearest volume step | False | - -#### Returns: -| Type | Description | -|---------|---------------------------------| -| `float` | Returns the volume of the trade | - - - -### amount_in_quote_currency -```python -async def amount_quote_currency(*, amount: float) -> float -``` -Convert an amount in the account_currency to the quote currency of the symbol. - -#### Parameters: -| Name | Type | Description | -|----------|---------|-----------------------| -| `amount` | `float` | The amount to convert | - - - -### convert_currency -```python -async def convert_currency(*, amount: float, from_currency: str, to_currency: str) -> float -``` -Convert from one currency to the other. - -#### Parameters: -| Name | Type | Description | -|-----------------|---------|--------------------------------------------------------| -| `amount` | `float` | Amount to convert given in terms of the quote currency | -| `from_currency` | `str` | The currency to convert from | -| `to_currency` | `str` | The currency to convert to | - -#### Returns: -| Type | Description | -|---------|--------------------------------------| -| `float` | Amount in terms of the base currency | - - - -### copy_rates_from -```python -async def copy_rates_from(*, timeframe: TimeFrame, date_from: datetime | int, count: int = 500) -> Candles -``` -Get bars from the MetaTrader 5 terminal starting from the specified date. - -#### Parameters: -| Name | Type | Description | Default | -|-------------|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------|----------------------------| -| `timeframe` | `TimeFrame` | Timeframe the bars are requested for. Set by a value from the TimeFrame enumeration. | Required unnamed parameter | -| `date_from` | `datetime, int` | Date of opening of the first bar from the requested sample. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. | Required unnamed parameter | -| `count` | `int` | Number of bars to receive. | Required unnamed parameter | - -#### Returns: -| Type | Description | -|-----------|---------------------------------------------------------------------------| -| `Candles` | Returns a Candles object as a collection of rates ordered chronologically | - -#### Raises: -| Exception | Description | -|--------------|---------------------------------------------------| -| `ValueError` | If request was unsuccessful and None was returned | - - - -### copy_rates_from_pos -```python -async def copy_rates_from_pos(*,timeframe: TimeFrame, count: int = 500, start_position: int = 0) -> Candles -``` -Get bars from the MetaTrader 5 terminal starting from the specified index. - -#### Parameters: -| Name | Type | Description | Default | -|------------------|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------| -| `timeframe` | `TimeFrame` | TimeFrame value from TimeFrame Enum. Required keyword only parameter | Required keyword only parameter | -| `count` | `int` | Number of bars to return. Keyword argument defaults to 500 | 500 | -| `start_position` | `int` | Initial index of the bar the data are requested from. The numbering of bars goes from present to past. Thus, the zero bar means the current one. Keyword argument defaults to 0. | 0 | - -#### Returns: -| Type | Description | -|-----------|----------------------------------------------------------------------------| -| `Candles` | Returns a Candles object as a collection of rates ordered chronologically. | - -#### Raises: -| Exception | Description | -|--------------|---------------------------------------------------| -| `ValueError` | If request was unsuccessful and None was returned | - - -### copy_rates_range -```python -async def copy_rates_range(*, timeframe: TimeFrame, date_from: datetime | int, - date_to: datetime | int) -> Candles -``` -Get bars in the specified date range from the MetaTrader 5 terminal. - -#### Parameters: -| Name | Type | Description | Default | -|-------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------| -| `timeframe` | `TimeFrame` | Timeframe for the bars using the TimeFrame enumeration. Required unnamed parameter. | Required unnamed parameter | -| date_from | datetime, int | Date the bars are requested from. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. Bars with the open time >= date_from are returned. Required unnamed parameter. | Required unnamed parameter | -| date_to | datetime, int | Date, up to which the bars are requested. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. Bars with the open time <= date_to are returned. Required unnamed parameter. | Required unnamed parameter | - -#### Returns: -| Type | Description | -|-----------|----------------------------------------------------------------------------| -| `Candles` | Returns a Candles object as a collection of rates ordered chronologically. | - -#### Raises: -| Exception | Description | -|--------------|---------------------------------------------------| -| `ValueError` | If request was unsuccessful and None was returned | - - - -### copy_ticks_from -```python -async def copy_ticks_from(*, date_from: datetime | int, count: int = 100, flags: CopyTicks = CopyTicks.ALL) -> Ticks -``` - -Get ticks from the MetaTrader 5 terminal starting from the specified date. - -#### Parameters: -| Name | Type | Description | Default | -|-------------|-----------------|---------------------------------------------------------------------------------------------------------------------|----------------------------| -| `date_from` | `datetime, int` | Date the ticks are requested from. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. | Required unnamed parameter | -| `count` | `int` | Number of requested ticks. Defaults to 100 | Required unnamed parameter | -| `flags` | `CopyTicks` | A flag to define the type of the requested ticks from CopyTicks enum. INFO is the default | Required unnamed parameter | - -#### Returns: -| Type | Description | -|---------|--------------------------------------------------------------------------| -| `Ticks` | Returns a Ticks object as a collection of ticks ordered chronologically. | - -#### Raises: -| Exception | Description | -|--------------|---------------------------------------------------| -| `ValueError` | If request was unsuccessful and None was returned | - - - -### copy_ticks_range -```python -async def copy_ticks_range(*, date_from: datetime | int, date_to: datetime | int, flags: CopyTicks = CopyTicks.ALL) -> Ticks -``` -Get ticks for the specified date range from the MetaTrader 5 terminal. - -#### Parameters: -| Name | Type | Description | Default | -|-------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------|----------------------------| -| `date_from` | `datetime, int` | Date the ticks are requested from. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. | Required unnamed parameter | -| `date_to` | `datetime, int` | Date, up to which the ticks are requested. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. | Required unnamed parameter | -| `flags` | `CopyTicks` | A flag to define the type of the requested ticks from CopyTicks enum. INFO is the default | Required unnamed parameter | - -#### Returns: -| Type | Description | -|---------|--------------------------------------------------------------------------| -| `Ticks` | Returns a Ticks object as a collection of ticks ordered chronologically. | - -#### Raises: -| Exception | Description | -|--------------|---------------------------------------------------| -| `ValueError` | If request was unsuccessful and None was returned | +Available in `aiomql.lib.sync.symbol`. diff --git a/docs/lib/terminal.md b/docs/lib/terminal.md index ffa649a..1d86c44 100644 --- a/docs/lib/terminal.md +++ b/docs/lib/terminal.md @@ -1,84 +1,30 @@ -# Terminal +# terminal -## Table of Contents -- [Terminal](#terminal.terminal) -- [initialize](#terminal.initialize) -- [version](#terminal.version) -- [info](#terminal.info) -- [symbols_total](#terminal.symbols_total) +`aiomql.lib.terminal` — Terminal information retrieval. - -### Terminal -```python -class Terminal(_Base, TerminalInfo) -``` -Terminal Class. Get information about the MetaTrader 5 terminal. The class is a subclass of the TerminalInfo -class. It inherits all the attributes and methods of the TerminalInfo class and adds some useful methods. +## Overview -#### Attributes: -| Name | Type | Description | Default | -|-----------|--------------|-------------------------------|---------| -| `version` | `Version` | MetaTrader5 Terminal Version. | None | +The `Terminal` class retrieves information about the MetaTrader 5 terminal, such as its +version, connection status, and data paths. +Inherits from [`_Base`](../core/base.md). - -### initialize -```python -async def initialize() -> bool -``` -Establish a connection with the MetaTrader 5 terminal. There are three call options. Call without parameters. -The terminal for connection is found automatically. Call specifying the path to the MetaTrader 5 terminal we -want to connect to. word path as a keyword argument Call specifying the trading account path and parameters -i.e. login, password, server, as keyword arguments, path can be omitted. +## Classes -#### Returns: -| Type | Description | -|--------|-------------------------------| -| `bool` | True if successful else False | +### `Terminal` +> Retrieves MetaTrader 5 terminal details. - -### version -```python -async def version() -``` -Get the MetaTrader 5 terminal version. This method returns the terminal version, build and release date as -a tuple of three values +All `TerminalInfo` fields (e.g. `connected`, `trade_allowed`, `name`, `path`, `build`) +are available as instance attributes after initialisation. -#### Returns: -| Type | Description | -|-----------|------------------------------------| -| `Version` | version of tuple as Version object | +#### Methods -#### Raises: -| Exception | Description | -|--------------|--------------------------------------------| -| `ValueError` | If the terminal version cannot be obtained | +| Method | Returns | Description | +|--------|---------|-------------| +| `info()` | `TerminalInfo \| None` | Fetches and caches terminal info | +| `version()` | `tuple[int, int, str] \| None` | Terminal version | +## Synchronous API - -### info -```python -async def info() -``` -Get the connected MetaTrader 5 client terminal status and settings. gets terminal info in the form of a -named tuple structure (namedtuple). Return None in case of an error. The info on the error can be -obtained using last_error(). - -#### Returns: -| Type | Description | -|----------------|----------------------------------------------------| -| `TerminalInfo` | Terminal status and settings as a terminal object. | - - - -### symbols_total -```python -async def symbols_total() -> int -``` -Get the number of all financial instruments in the MetaTrader 5 terminal. - -#### Returns: -| Type | Description | -|-------|-----------------------------------| -| `int` | Total number of available symbols | +Available in `aiomql.lib.sync.terminal`. diff --git a/docs/lib/ticks.md b/docs/lib/ticks.md index b5fcb56..0e76988 100644 --- a/docs/lib/ticks.md +++ b/docs/lib/ticks.md @@ -1,161 +1,60 @@ -# Tick and Ticks -Module for working with price ticks. +# ticks -## Table of Contents -- [Tick](#tick.tick) - - [\_\_init\_\_](#tick.__init__) - - [set_attributes](#tick.set_attributes) +`aiomql.lib.ticks` — Tick-level price data and technical analysis. -- [Ticks](#ticks.ticks) - - [\__init\__](#ticks.__init__) - - [ta](#ticks.ta) - - [ta_lib](#ticks.ta_lib) - - [data](#ticks.data) - - [rename](#ticks.rename) +## Overview +Provides `Tick` (a single tick) and `Ticks` (an ordered collection). Like `Candles`, the +`Ticks` class wraps a `pandas.DataFrame` and integrates with `pandas_ta`. - -## Tick -```python -class Tick() -``` -Price Tick of a Financial Instrument. -#### Attributes: -| Name | Type | Description | Default | -|---------------|------------|-----------------------------------------------------------------------|---------| -| `symbol` | `Symbol` | The Financial Instrument as a Symbol Object | None | -| `time` | `datetime` | Time of the last prices update for the symbol | None | -| `bid` | `float` | Current Bid price | None | -| `ask` | `float` | Current Ask price | None | -| `last` | `float` | Price of the last deal (Last) | None | -| `volume` | `float` | Volume for the current Last price | None | -| `time_msc` | `int` | Time of the last prices update for the symbol in milliseconds | None | -| `flags` | `TickFlag` | Tick flags | None | -| `volume_real` | `float` | Volume for the current Last price | None | -| `Index` | `int` | Custom attribute representing the position of the tick in a sequence. | None | -| `index` | `int` | Index of the tick in the input dataframe object. | None | +## Classes +### `Tick` - -### \__init\__ -```python -def __init__(self, **kwargs): -``` -Initialize the Tick class. Set attributes from keyword arguments.The `bid`, `ask`, `last`, `time` and `volume` must be present +> A single tick (price update). +| Attribute | Type | Description | +|-----------|------|-------------| +| `time` | `int` | Tick time (unix timestamp) | +| `bid` | `float` | Bid price | +| `ask` | `float` | Ask price | +| `last` | `float` | Last price | +| `volume` | `float` | Volume | +| `flags` | `int` | Tick flags | +| `volume_real` | `float` | Real volume | +| `time_msc` | `int` | Tick time in milliseconds | +| `Index` | `int` | Position index within a `Ticks` collection | - -### set_attributes -```python -def set_attributes(**kwargs) -``` -Set attributes from keyword arguments +#### Properties +| Property | Description | +|----------|-------------| +| `dict` | Attribute dictionary | - -### dict -```python -def dict(exclude: set = None, include: set = None) -> dict -``` -Return a dictionary of the tick attributes. +--- -#### Parameters: -| Name | Type | Description | Default | -|-----------|-------|-----------------------------------------------------|---------| -| `exclude` | `set` | A set of attributes to exclude from the dictionary. | None | -| `include` | `set` | A set of attributes to include in the dictionary. | None | +### `Ticks` +> Ordered collection of ticks backed by a DataFrame. - -## Ticks -```python -class Ticks -``` -Container data class for price ticks. Arrange in chronological order. Saves data with a pandas DataFrame. -Supports iteration, slicing and assignment. Similar to `Candles` class but for price ticks. - -#### Attributes: -| Name | Type | Description | Default | -|---------------|-------------|----------------------------------------------------------------------|---------| -| `data` | `DataFrame` | DataFrame of price ticks arranged in chronological order. | None | -| `time` | `Series` | Time of the last prices update for the symbol | None | -| `bid` | `Series` | Current Bid price | None | -| `ask` | `Series` | Current Ask price | None | -| `last` | `Series` | Price of the last deal (Last) | None | -| `volume` | `Series` | Volume for the current Last price | None | -| `time_msc` | `Series` | Time of the last prices update for the symbol in milliseconds | None | -| `flags` | `Series` | Tick flags | None | -| `volume_real` | `Series` | Volume for the current Last price | None | -| `Index` | `Series` | Custom attribute representing the position of the tick in a sequence | None | -| `index` | `Series` | Custom attribute representing the index of the tick in the DataFrame | None | +| Attribute | Type | Description | +|-----------|------|-------------| +| `data` | `DataFrame` | The underlying tick data | +| `Index` | `Series` | Positional index column | +#### Data Access - -### \__init\__ -```python -def __init__(*, data: DataFrame | Iterable, flip=False): -``` -Initialize the Ticks class. Creates a DataFrame of price ticks from the data argument. -#### Arguments: -| Name | Type | Description | Default | -|--------|---------------------------|---------------------------------------------------------------------------------------------|---------| -| `data` | `DataFrame` \| `Iterable` | Dataframe of price ticks or any iterable object that can be converted to a pandas DataFrame | None | -| `flip` | `bool` | If flip is True reverse data chronological order. | False | +| Method / Property | Description | +|-------------------|-------------| +| `__getitem__(index)` | Get a `Tick` by position or slice | +| `__len__()` | Number of ticks | +| `__iter__()` | Iterate over `Tick` objects | +| `columns` | DataFrame column names | +| `ta` | Access to `pandas_ta` indicators | +| `rename(inplace=True, **kwargs)` | Rename columns | +#### Technical Analysis - -### ta -```python -@property -def ta() -``` -Access to the pandas_ta library for performing technical analysis on the underlying data attribute. -#### Returns: -| Name | Type | Description | -|-------------|-------------|-----------------------| -| `pandas_ta` | `pandas_ta` | The pandas_ta library | - - - -### ta_lib -```python -@property -def ta_lib() -``` -Access to the ta library for performing technical analysis. Not dependent on the underlying data attribute. -#### Returns: -| Name | Type | Description | -|------|------|----------------| -| `ta` | `ta` | The ta library | - - - -### data -```python -@property -def data() -> DataFrame -``` -DataFrame of price ticks arranged in chronological order. -#### Returns: -| Name | Type | Description | -|--------|-------------|-----------------------------------------------------------| -| `data` | `DataFrame` | DataFrame of price ticks arranged in chronological order. | - - - -### rename -```python -def rename(inplace=True, **kwargs) -> _Ticks | None -``` -Rename columns of the candle class. -#### Arguments: -| Name | Type | Description | Default | -|-----------|--------|-------------------------------------------------------------------------------------------|---------| -| `inplace` | `bool` | Rename the columns inplace or return a new instance of the class with the renamed columns | True | -| `kwargs` | | The new names of the columns | | - -#### Returns: -| Type | Description | -|---------|---------------------------------------------------------------------------| -| `Ticks` | A new instance of the class with the renamed columns if inplace is False. | -| `None` | If inplace is True | +| Method | Description | +|--------|-------------| +| `ta_lib(func, *args, **kwargs)` | Run any `pandas_ta` indicator | diff --git a/docs/lib/trade_records.md b/docs/lib/trade_records.md index 07ec1b1..d32d91a 100644 --- a/docs/lib/trade_records.md +++ b/docs/lib/trade_records.md @@ -1,171 +1,38 @@ -# Trade Records +# trade_records -## Table of contents -- [Trade Records](#trade_records) -- [\_\_init\_\_](#trade_records.__init__) -- [get_csv_records](#trade_records.get_csv_records) -- [get_json_records](#trade_records.get_json_records) -- [read_update_csv](#trade_records.read_update_csv) -- [read_update_json](#trade_records.read_update_json) -- [update_rows](#trade_records.update_rows) -- [update_row](#trade_records.update_row) -- [update_csv_records](#trade_records.update_csv_records) -- [update_json_records](#trade_records.update_json_records) -- [update_csv_record](#trade_records.update_csv_record) -- [update_json_record](#trade_records.update_json_record) +`aiomql.lib.trade_records` — Trade record file management. - -### Trade Records -```python -class TradeRecords() -``` -This utility class read trade records from csv and json files, and update them based on their closing positions. -Once a trade have been closed, the actual profit and win status will be updated in the file. +## Overview -#### Attributes: -| name | type | description | -|---------------|----------|-------------------------------------------| -| `config` | `Config` | Config object | -| `records_dir` | `Path` | A directory for finding the trade records | +The `TradeRecords` class manages trade record files in CSV, JSON, and SQL formats. It +provides methods for updating stored records with actual profit/loss data from completed +trades. - -### \__init\__ -```python -def __init__(*, records_dir: Path | str = '') -``` -Initialize an instance of the class. +Inherits from [`_Base`](../core/base.md). -#### Parameters: -| name | type | description | -|---------------|--------|----------------------------------------------------------------| -| `records_dir` | `Path` | Absolute path to directory containing record of placed trades. | +## Classes +### `TradeRecords` - -### get_csv_records -```python -async def get_csv_records() -``` -Get trade records from records_dir folder. +> Updates and manages trade record files. -#### Yields: -| type | description | -|------|--------------------| -| Path | Trade record files | +| Attribute | Type | Description | +|-----------|------|-------------| +| `config` | `Config` | Global configuration | +#### Methods - -### get_json_records -```python -async def get_json_records() -``` -Get trade records from records_dir folder. +| Method | Description | +|--------|-------------| +| `update_rows(records_dir)` | Updates all record files in a directory | +| `update_row(file, row)` | Updates a single record row with actual P/L | +| `update_csv(file)` | Updates records in a CSV file | +| `update_json(file)` | Updates records in a JSON file | +| `update_sql()` | Updates records in the SQLite database | +| `get_actual_profit(order, symbol)` | Calculates actual P/L for a trade | -#### Yields -| type | description | -|------|--------------------| -| Path | Trade record files | +#### Static Methods - - -### read_update_csv -```python -async def read_update_csv(*, file: Path) -``` -Read and update trade records from a csv file. - -#### Parameters: -| name | type | description | -|--------|--------|-------------------| -| `file` | `Path` | Trade record file | - - - -### read_update_json -```python -async def read_update_json(*, file: Path) -``` -Read and update trade records from a json file. - -#### Parameters: -| name | type | description | -|--------|--------|-------------------| -| `file` | `Path` | Trade record file | - - - -### update_rows -```python -async def update_rows(*, rows: list[dict]) -> list[dict] -``` -Update the rows of entered trades with the actual profit. - -#### Parameters: -| name | type | description | -|--------|--------------|---------------------------------------------------------------------------| -| `rows` | `list[dict]` | A list of dictionaries from the dictionary writer object of the csv file. | - -#### Returns: -| Type | Description | -|--------------|---------------------------------------------------------------| -| `list[dict]` | A list of dictionaries with the actual profit and win status. | - - - -### update_row -```python -async def update_row(row: dict) -> dict -``` -Update the row of an entered trade with the actual profit. - -#### Parameters: -| Name | Type | Description | -|-------|--------|-------------------------------------------| -| `row` | `dict` | A dictionary from the csv file row object | - -#### Returns: -| Type | Description | -|------|-------------------------------------| -| dict | A dictionary with the actual profit | - - - -### update_csv_record -```python -async def update_csv_record(*, file: Path | str) -``` -Update a single trade record csv file - -#### Parameters: -| Name | Type | Description | -|--------|--------|-------------------------| -| `file` | `Path` | A trade record csv file | - - - -### update_csv_records -```python -def update_csv_records() -``` -Update csv trade records in the records_dir folder. - - - -### update_csv_record -```python -async def update_json_record(*, file: Path | str) -``` -Update a single trade record json file - -#### Parameters: -| Name | Type | Description | -|--------|--------|--------------------------| -| `file` | `Path` | A trade record json file | - - - -### update_json_records -```python -def update_json_records() -``` -Update json trade records in the records_dir folder. +| Method | Description | +|--------|-------------| +| `str_to_bool(val)` | Converts `"true"` / `"false"` strings to `bool` | diff --git a/docs/lib/trader.md b/docs/lib/trader.md index 53ccd2a..ca93e30 100644 --- a/docs/lib/trader.md +++ b/docs/lib/trader.md @@ -1,182 +1,43 @@ -# Trader -Trader class module. Handles the creation of an order and the placing of trades +# trader -## Table of Contents -- [Trader](#trader) -- [\_\_init\_\_](#trader.__init__) -- [set_trade_stop_levels_points](#trader.set_trade_stop_levels_points) -- [set_trade_stop_levels_pips](#trader.set_trade_stop_levels_pips) -- [create_order_with_points](#trade.create_order_with_points) -- [create_order_with_sl](#trade.create_order_with_sl) -- [create_order_with_stops](#trade.create_order_with_stops) -- [create_order_no_stops](#trade.create_order_no_stops) -- [send_order](#trader.send_order) -- [check_order](#trader.check_order) -- [record_trade](#trader.record_trade) -- [place_trade](#trader.place_trade) +`aiomql.lib.trader` — Trader base class for order management. - -### Trader -```python -class Trader() -``` -Base class for creating a Trader object. Handles the creation of an order and the placing of trades +## Overview -#### Attributes: -| Name | Type | Description | Default | -|--------------|----------|-------------------------------------------------------|---------| -| `ram` | `RAM` | Risk Assessment Management System. | None | -| `config` | `Config` | Config instance. | None | -| `order` | `Order` | Order instance. | None | -| `symbol` | `Symbol` | The Financial Instrument | None | -| `parameters` | `dict` | A dictionary of parameters associated with the trade. | None | +The `Trader` class is the base for creating and managing trade orders. It brings together +`Symbol`, `RAM`, `Order`, and `Result` to provide a complete workflow for placing trades +with risk management and result recording. - -### \_\_init\_\_ -```python -def __init__(*, symbol: Symbol, ram: RAM = None) -``` -#### Parameters: -| Name | Type | Description | Default | -|----------|----------|-----------------------------------------|---------| -| `symbol` | `Symbol` | The Financial instrument | | -| `ram` | `RAM` | Risk Assessment and Management instance | None | +Inherits from [`_Base`](../core/base.md). +## Classes - -### set_trade_stop_levels_pips -```python -async def set_trade_stop_levels_pips(*, pips: float, risk_to_reward: float = None): -``` -Sets the stop loss and take profit for the order. This method uses pips as defined for forex instruments. +### `Trader` -#### Parameters: -| Name | Type | Description | Default | -|------------------|---------|-------------------------------|---------| -| `pips` | `float` | Target pips | | -| `risk_to_reward` | `float` | Optional risk to reward ratio | None | +> Base class for placing risk-managed trades. +| Attribute | Type | Description | +|-----------|------|-------------| +| `symbol` | `Symbol` | The trading instrument | +| `ram` | `RAM` | Risk Assessment and Money manager | +| `order` | `Order` | The current trade order | +| `result` | `Result` | Trade result recorder | +| `parameters` | `dict` | Strategy parameters to record | - -### set_trade_stop_levels_points -```python -async def set_trade_stop_levels_points(*, points: float, risk_to_reward: float = None): -``` -Sets the stop loss and take profit for the order. This method uses points as defined for forex instruments. +#### Lifecycle -#### Parameters: -| Name | Type | Description | Default | -|------------------|---------|-------------------------------|---------| -| `points` | `float` | Target points | | -| `risk_to_reward` | `float` | Optional risk to reward ratio | None | +| Method | Description | +|--------|-------------| +| `__init__(symbol, ram, params, …)` | Initialises with a symbol and risk parameters | +| `create_order(order_type, …)` | Creates an `Order` with calculated volume and stops | +| `set_stop_levels(order_type, sl, tp)` | Sets stop loss and take profit prices | +#### Trade Placement - -### create_order_no_stops -```python -async def create_order_no_stops(*, order_type: OrderType, volume: float = None) -``` -Create an order without setting stop loss and take profit. Using minimum lot size. +| Method | Description | +|--------|-------------| +| `place_trade(*, order_type, sl, tp, …)` | **Abstract** — subclasses implement to place trades | -#### Parameters: -| Name | Type | Description | Default | -|--------------|-------------|---------------------|---------| -| `order_type` | `OrderType` | The order type | | -| `volume` | `float` | The volume to trade | None | +## Synchronous API - - -### create_order_with_stops -```python -async def create_order_with_stops(*, order_type: OrderType, sl: float, tp: float, amount_to_risk: float = None) -``` -Create an order with stop loss and take profit levels. Use the amount to risk per trade to -calculate the volume. - -#### Parameters: -| Name | Type | Description | Default | -|------------------|-------------|--------------------|---------| -| `order_type` | `OrderType` | The order type | | -| `sl` | `float` | The stop loss` | | -| `tp` | `float` | The take profit` | | -| `amount_to_risk` | `float` | The amount to risk | None | - - - -### create_order_with_sl -```python -async def create_order_with_sl(*, order_type: OrderType, sl: float, amount_to_risk: float = None, risk_to_reward: float = None) -``` -Create an order with a given stop_loss level. Use the amount to risk per trade to calculate the volume. - -#### Parameters: -| Name | Type | Description | Default | -|------------------|-------------|------------------------------------------|---------| -| `order_type` | `OrderType` | The order type | | -| `sl` | `float` | The stop loss` | | -| `risk_to_reward` | `float` | Risk to reward ratio. Optional parameter | None | -| `amount_to_risk` | `float` | The amount to risk | None | - - - -### create_order_with_points -```python -async def create_order_with_points(*, order_type: OrderType, points: float, amount_to_risk: float = None, risk_to_reward: float = None) -``` -Create an order with specific points to risk. Use the amount to risk per trade to calculate the volume. - -#### Parameters: -| Name | Type | Description | Default | -|------------------|-------------|------------------------------------------|---------| -| `order_type` | `OrderType` | The order type | | -| `points` | `float` | Points to risk | | -| `risk_to_reward` | `float` | Risk to reward ratio. Optional parameter | None | -| `amount_to_risk` | `float` | The amount to risk | None | - - - -### send_order -```python -async def send_order() -> OrderSendResult -``` -Sends the order to the broker for execution. - -#### Returns: -| Type | Description | -|-------------------|----------------------------| -| `OrderSendResult` | The OrderSendResult object | - - - -### check_order -```python -async def check_order() -> OrderCheckResult -``` -Checks the status of the order before placing the trade. - -#### Returns: -| Type | Description | -|--------------------|-----------------------------| -| `OrderCheckResult` | The OrderCheckResult object | - - -### record_trade -```python -async def record_trade(*, result: OrderSendResult, parameters: dict = None, name: str = '') -``` -Records the trade and the order details if `Config.record_trades` is true. Trades are recorded as either json or csv. - -#### Parameters: -| Name | Type | Description | Default | -|--------------|-------------------|--------------------------------------------------------------|---------| -| `result` | `OrderSendResult` | The result of the placed order | | -| `parameters` | `dict` | parameters to saved instead of the ones in `self.parameters` | None | -| `name` | `str` | Name for the csv or json file | '' | - - -### place_trade -```python -@abstractmethod -async def place_trade(self, *args, **kwargs) -``` -Places a trade. All traders must implement this method. +Available in `aiomql.lib.sync.trader`. diff --git a/docs/toc.md b/docs/toc.md new file mode 100644 index 0000000..b81dded --- /dev/null +++ b/docs/toc.md @@ -0,0 +1,79 @@ +# aiomql Documentation + +API reference for the **aiomql** asynchronous MetaTrader 5 trading library. + +--- + +## Core + +Low-level infrastructure: configuration, database, MT5 interface, data models, and shared state. + +| Module | Description | +|--------|-------------| +| [_core](core/_core.md) | Metaclass that dynamically binds MT5 constants and functions | +| [base](core/base.md) | Base classes for attribute management and MT5 integration | +| [config](core/config.md) | Singleton configuration manager (`Config`) | +| [constants](core/constants.md) | MT5 enumerations (`TimeFrame`, `OrderType`, `TradeAction`, …) | +| [db](core/db.md) | SQLite ORM base class (`DB`) for dataclass-backed tables | +| [errors](core/errors.md) | MT5 error wrapper (`Error`) | +| [exceptions](core/exceptions.md) | Custom exception hierarchy | +| [meta_trader](core/meta_trader.md) | Async/sync singleton interface to the MT5 terminal | +| [models](core/models.md) | Data models (`AccountInfo`, `SymbolInfo`, `TradeRequest`, …) | +| [state](core/state.md) | Singleton persistent key-value store (`State`) | +| [store](core/store.md) | Per-key persistent store (`Store`) | +| [task_queue](core/task_queue.md) | Async priority task queue (`TaskQueue`, `QueueItem`) | + +--- + +## Lib + +High-level trading components: account, orders, positions, strategies, and the bot orchestrator. + +| Module | Description | +|--------|-------------| +| [account](lib/account.md) | Trading account connection manager | +| [bot](lib/bot.md) | Bot orchestrator for running strategies | +| [candle](lib/candle.md) | Candlestick/bar data and technical analysis | +| [executor](lib/executor.md) | Strategy and task executor | +| [history](lib/history.md) | Historical deals and orders retrieval | +| [order](lib/order.md) | Trade order creation, checking, and sending | +| [positions](lib/positions.md) | Open position management | +| [ram](lib/ram.md) | Risk Assessment and Money management | +| [result](lib/result.md) | Trade result recording (CSV / JSON / SQL) | +| [result_db](lib/result_db.md) | SQLite-backed trade result storage | +| [sessions](lib/sessions.md) | Trading session time windows | +| [strategy](lib/strategy.md) | Strategy base class | +| [symbol](lib/symbol.md) | Trading instrument interface | +| [terminal](lib/terminal.md) | Terminal information retrieval | +| [ticks](lib/ticks.md) | Tick-level price data and analysis | +| [trader](lib/trader.md) | Trader base class for order management | +| [trade_records](lib/trade_records.md) | Trade record file management | + +--- + +## Contrib + +Community-contributed extensions: strategies, specialised symbols, position trackers, and traders. + +| Module | Description | +|--------|-------------| +| [chaos](contrib/strategies/chaos.md) | Random buy/sell demo strategy | +| [forex_symbol](contrib/symbols/forex_symbol.md) | Forex-specific symbol with pip calculations | +| [open_position](contrib/trackers/open_position.md) | Open position data container | +| [position_trackers](contrib/trackers/position_trackers.md) | Position and open-positions tracker classes | +| [position_tracking_functions](contrib/trackers/position_tracking_functions.md) | Pre-built tracking functions (trailing stop, etc.) | +| [scalp_trader](contrib/traders/scalp_trader.md) | Scalp trader (no stop levels) | +| [simple_trader](contrib/traders/simple_trader.md) | Simple trader (with stop loss) | +| [strategy_tracker](contrib/utils/strategy_tracker.md) | Strategy state tracking dataclass | + +--- + +## Utils + +General-purpose utilities: math helpers, price calculations, and parallel processing. + +| Module | Description | +|--------|-------------| +| [utils](utils/utils.md) | Decorators, rounding, and async caching | +| [price_utils](utils/price_utils.md) | Percentage-based price calculations | +| [process_pool](utils/process_pool.md) | Multi-process parallel execution | diff --git a/docs/utils/price_utils.md b/docs/utils/price_utils.md new file mode 100644 index 0000000..c9f6237 --- /dev/null +++ b/docs/utils/price_utils.md @@ -0,0 +1,64 @@ +# price_utils + +`aiomql.utils.price_utils` — Percentage-based price calculations. + +## Overview + +Utility functions for common percentage and price-range calculations used in +trading logic. + +## Functions + +### `price_diff(price1, price2)` + +> Calculates the absolute difference between two prices. + +**Returns:** `float` + +--- + +### `price_diff_pct(price1, price2)` + +> Percentage difference between two prices relative to `price1`. + +**Returns:** `float` — percentage + +--- + +### `position_in_range(value, low, high)` + +> Calculates where a value falls within a range as a percentage. + +**Returns:** `float` — `0.0` at `low`, `100.0` at `high`. + +--- + +### `pct_increase(value, pct)` + +> Increases a value by a percentage. + +**Returns:** `float` + +--- + +### `pct_decrease(value, pct)` + +> Decreases a value by a percentage. + +**Returns:** `float` + +--- + +### `pct_of(value, pct)` + +> Returns a percentage of a value. + +**Returns:** `float` + +--- + +### `price_pct_change(open_price, close_price)` + +> Percentage change from `open_price` to `close_price`. + +**Returns:** `float` diff --git a/docs/utils/process_pool.md b/docs/utils/process_pool.md new file mode 100644 index 0000000..216b436 --- /dev/null +++ b/docs/utils/process_pool.md @@ -0,0 +1,33 @@ +# process_pool + +`aiomql.utils.process_pool` — Multi-process parallel execution. + +## Overview + +Provides a simple wrapper around `ProcessPoolExecutor` for running CPU-bound +functions in parallel across multiple processes. + +## Functions + +### `process_pool(*functions)` + +> Runs multiple callables in parallel using a process pool. + +Accepts one or more callables (no arguments) and submits them to a +`ProcessPoolExecutor`. Returns when all processes complete. + +**Args:** +- `*functions` (`Callable`) — Callables to execute in parallel. + +**Example:** +```python +from aiomql.utils import process_pool + +def run_strategy_a(): + ... + +def run_strategy_b(): + ... + +process_pool(run_strategy_a, run_strategy_b) +``` diff --git a/docs/utils/utils.md b/docs/utils/utils.md new file mode 100644 index 0000000..24f0241 --- /dev/null +++ b/docs/utils/utils.md @@ -0,0 +1,55 @@ +# utils + +`aiomql.utils.utils` — Decorators, rounding, and async caching. + +## Overview + +General-purpose utility functions used throughout the library: error-handling +decorators, a ceiling-rounding helper, and an async-friendly cache decorator. + +## Functions + +### `round_up(value, decimals=0)` + +> Rounds a number **up** to the specified decimal places. + +Uses `decimal.ROUND_UP` for precise ceiling rounding. + +**Args:** +- `value` (`float`) — The value to round. +- `decimals` (`int`) — Decimal places. Defaults to `0`. + +**Returns:** `float` + +--- + +### `async_cache(fn)` + +> Decorator that caches the result of an async function. + +Wraps an `async def` function so that subsequent calls with the same arguments +return the cached result without re-executing the coroutine. + +--- + +### `error_handler(func=None, *, msg="", tb=False, …)` + +> Decorator for uniform exception handling. + +Catches exceptions, logs them (optionally with traceback), and returns a +fallback value instead of re-raising. + +--- + +### `backoff_retry(func=None, *, retries=3, error=Exception, …)` + +> Decorator that retries a function with exponential back-off. + +Retries the decorated function `retries` times on failure, with increasing +delays between attempts. + +--- + +### `dict_to_string(data)` + +> Converts a dictionary to a formatted key=value string. diff --git a/examples/sample_app/emaxover.py b/examples/sample_app/emaxover.py index 7270c19..2efba4f 100644 --- a/examples/sample_app/emaxover.py +++ b/examples/sample_app/emaxover.py @@ -1,4 +1,4 @@ -from aiomql import Strategy, ForexSymbol, TimeFrame, Tracker, OrderType, Sessions, Trader, ScalpTrader +from aiomql import Strategy, ForexSymbol, TimeFrame, Tracker, OrderType, Sessions, Trader from .traders import TestTrader diff --git a/examples/sample_app/traders/test_trader.py b/examples/sample_app/traders/test_trader.py index 9e42699..136c662 100644 --- a/examples/sample_app/traders/test_trader.py +++ b/examples/sample_app/traders/test_trader.py @@ -40,13 +40,6 @@ class TestTrader(Trader): PositionTracker(open_position, track_hedges) PositionTracker(open_position, close_after, function_params=kwargs) PositionTracker(open_position, exit_at_profit, function_params={"tp": 10, "sl": -12}) - price_to_hedge = await open_position.profit_to_price(profit=-10) - price_to_stack = await open_position.profit_to_price(profit=5) - price_to_stack = round_off(price_to_stack, self.symbol.digits) - price_to_hedge = round_off(price_to_hedge, self.symbol.digits) - # await open_position.stack_order(price=price_to_stack, open_pos_params={"close_stacks_on_close": True}) - # await open_position.hedge_order(price=price_to_hedge, - # open_pos_params={"close_hedges_on_close": True}) price_to_hedge2 = await open_position.profit_to_price(profit=-8) price_to_hedge2 = round_off(price_to_hedge2, self.symbol.digits) price_to_stack2 = await open_position.profit_to_price(profit=7) diff --git a/pyproject.toml b/pyproject.toml index 8dc702d..1064919 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "aiomql" -version = "4.0.16" +version = "4.0.17" readme = "README.md" requires-python = ">=3.13" classifiers = [ @@ -16,8 +16,6 @@ dependencies = [ "MetaTrader5>=5.0.5200", "pandas>=2.0.0", "mplfinance>=0.12.10b0", - "numba>=0.61.2", - "tqdm>=4.67.1", ] authors = [{name = "Ichinga Samuel", email = "ichingasamuel@gmail.com"}] @@ -28,11 +26,19 @@ description = "Asynchronous MetaTrader5 library and Algorithmic Trading Framewor "Homepage" = "https://github.com/Ichinga-Samuel/aiomql" "Bug Tracker" = "https://github.com/Ichinga-Samuel/aiomql/issues" +[project.optional-dependencies] + +all = [ + "cython>=3.2.4", + "numba>=0.64.0", + "ta-lib>=0.6.8", + "tqdm>=4.67.3", +] + [dependency-groups] dev = [ "jupyter>=1.1.1", "pandas-stubs>=3.0.0.260204", "pytest>=8.4.1", "pytest-asyncio>=1.3.0", - "ta-lib>=0.6.8", ] diff --git a/src/aiomql/contrib/traders/scalp_trader.py b/src/aiomql/contrib/traders/scalp_trader.py index 32f70df..dc99c64 100644 --- a/src/aiomql/contrib/traders/scalp_trader.py +++ b/src/aiomql/contrib/traders/scalp_trader.py @@ -1,3 +1,10 @@ +"""Scalp trader for placing trades without stop levels. + +This module provides the ``ScalpTrader`` class, a concrete implementation +of the ``Trader`` base class that places trades using the minimum lot size +and no stop loss or take profit levels. +""" + from logging import getLogger from ...core.models import OrderType @@ -7,6 +14,12 @@ logger = getLogger(__name__) class ScalpTrader(Trader): + """Trader that places scalping trades without stop/take-profit levels. + + Extends the ``Trader`` base class to implement a simple scalping + strategy that uses the minimum volume by default and records the + trade result. + """ async def place_trade(self, *, order_type: OrderType, volume: float = None, parameters: dict = None): """Places a trade based on the order_type and volume. The volume is optional. If not provided, the minimum volume for the symbol will be used. This trade is placed without a stop_loss or take_profit. The trade is recorded in the diff --git a/src/aiomql/contrib/traders/simple_trader.py b/src/aiomql/contrib/traders/simple_trader.py index 0b7a22e..a514533 100644 --- a/src/aiomql/contrib/traders/simple_trader.py +++ b/src/aiomql/contrib/traders/simple_trader.py @@ -1,3 +1,10 @@ +"""Simple trader for placing trades with a stop loss level. + +This module provides the ``SimpleTrader`` class, a concrete implementation +of the ``Trader`` base class that places trades using a specified stop loss +and volume calculated from the risk amount via the RAM instance. +""" + from logging import getLogger from ...core.models import OrderType @@ -7,6 +14,12 @@ logger = getLogger(__name__) class SimpleTrader(Trader): + """Trader that places trades with a given stop loss. + + Extends the ``Trader`` base class to implement a straightforward + strategy where the trade volume is calculated based on the risk + amount and the distance to the stop loss. + """ async def place_trade(self, *, order_type: OrderType, sl: float, parameters: dict = None): """Places a trade based on the order_type and a given stop_loss. The volume is based on the amount to risk which is calculated using the Risk Assessment Management instance. diff --git a/src/aiomql/core/__init__.py b/src/aiomql/core/__init__.py index 49cc292..7b67d55 100644 --- a/src/aiomql/core/__init__.py +++ b/src/aiomql/core/__init__.py @@ -1,13 +1,11 @@ from .meta_trader import MetaTrader from .config import Config -from .meta_backtester import MetaBackTester from .models import * from .constants import * from .base import Base, _Base from .errors import Error from .exceptions import * from .task_queue import TaskQueue -from .backtesting import * from .utils import * from .db import DB from .state import State diff --git a/src/aiomql/core/_core.py b/src/aiomql/core/_core.py index d0c0aa3..85e69f7 100644 --- a/src/aiomql/core/_core.py +++ b/src/aiomql/core/_core.py @@ -1,3 +1,24 @@ +"""Core MetaTrader5 interface module for the aiomql package. + +This module provides the low-level interface to the MetaTrader5 Python package +by dynamically binding MT5 constants, functions, and types onto the MetaCore +class using the MetaBase metaclass. + +Classes: + MetaBase: Metaclass that dynamically binds MetaTrader5 attributes. + MetaCore: Base class exposing all MT5 constants, functions, and types. + +Note: + This module is not intended for direct use. Use the higher-level + ``MetaTrader`` class from ``aiomql.core.meta_trader`` instead. + +Module-Level Attributes: + constants (tuple[str, ...]): Names of MT5 integer constants to bind. + core_mt5_functions (tuple[str, ...]): Names of MT5 API functions to bind + (prefixed with ``_`` on MetaCore). + types (tuple[str, ...]): Names of MT5 named-tuple types to bind. +""" + from typing import Callable import MetaTrader5 @@ -292,6 +313,14 @@ types = ( class MetaBase(type): + """Metaclass that dynamically binds MetaTrader5 attributes to classes. + + On class creation, this metaclass introspects the ``MetaTrader5`` module + and copies constants, API functions, and named-tuple types into the + new class's namespace. API functions are prefixed with ``_`` to + distinguish them from the higher-level wrappers. + """ + def __new__(mcs, cls_name, bases, cls_dict): defaults: dict = getattr(MetaTrader5, "__dict__", {}) callables = {f"_{key}": value for key in core_mt5_functions if (value := defaults.get(key, None)) is not None} @@ -304,6 +333,35 @@ class MetaBase(type): class MetaCore(metaclass=MetaBase): + """Base class exposing all MetaTrader5 constants, functions, and types. + + Created by ``MetaBase``, this class holds every MT5 constant (e.g. + ``TIMEFRAME_M1``), every API function (e.g. ``_initialize``), and every + named-tuple type (e.g. ``TradePosition``) as class attributes. + + Attributes: + TIMEFRAME_* (int): Timeframe constants. + COPY_TICKS_* (int): Tick copy-mode constants. + TICK_FLAG_* (int): Tick flag constants. + POSITION_TYPE_* (int): Position type constants. + ORDER_TYPE_* (int): Order type constants. + ORDER_STATE_* (int): Order state constants. + ORDER_FILLING_* (int): Order filling mode constants. + ORDER_TIME_* (int): Order time-in-force constants. + DEAL_TYPE_* (int): Deal type constants. + DEAL_ENTRY_* (int): Deal entry constants. + TRADE_ACTION_* (int): Trade action constants. + SYMBOL_* (int): Symbol property constants. + ACCOUNT_* (int): Account property constants. + BOOK_TYPE_* (int): Book type constants. + TRADE_RETCODE_* (int): Trade return code constants. + RES_* (int): Result code constants. + _initialize (Callable): Bound ``MetaTrader5.initialize``. + _shutdown (Callable): Bound ``MetaTrader5.shutdown``. + _login (Callable): Bound ``MetaTrader5.login``. + config (Config): The global configuration instance. + """ + TIMEFRAME_M1: int TIMEFRAME_M2: int TIMEFRAME_M3: int diff --git a/src/aiomql/core/backtesting/__init__.py b/src/aiomql/core/backtesting/__init__.py deleted file mode 100644 index ad63b04..0000000 --- a/src/aiomql/core/backtesting/__init__.py +++ /dev/null @@ -1,5 +0,0 @@ -from .get_data import GetData, BackTestData -from .backtest_engine import BackTestEngine -from .backtest_account import BackTestAccount -from .trades_manager import PositionsManager, OrdersManager, DealsManager -from .backtest_controller import BackTestController diff --git a/src/aiomql/core/backtesting/backtest_account.py b/src/aiomql/core/backtesting/backtest_account.py deleted file mode 100644 index 86c9e06..0000000 --- a/src/aiomql/core/backtesting/backtest_account.py +++ /dev/null @@ -1,60 +0,0 @@ -from dataclasses import dataclass -from typing import ClassVar - -from ..constants import AccountTradeMode, AccountMarginMode, AccountStopOutMode - - -@dataclass -class BackTestAccount: - """Account data for backtesting""" - - login: int = 0 - trade_mode: AccountTradeMode = AccountTradeMode.DEMO - leverage: float = 1 - limit_orders: float = 0 - margin_so_mode: AccountStopOutMode = AccountStopOutMode.PERCENT - trade_allowed: bool = True - trade_expert: bool = True - margin_mode: AccountMarginMode = AccountMarginMode.EXCHANGE - currency_digits: int = 2 - fifo_close: bool = False - balance: float = 0 - credit: float = 0 - profit: float = 0 - equity: float = 0 - margin: float = 0 - margin_free: float = 0 - margin_level: float = 0 - margin_so_call: float = 0 - margin_so_so: float = 0 - margin_initial: float = 0 - margin_maintenance: float = 0 - assets: float = 0 - liabilities: float = 0 - commission_blocked: float = 0 - name: str = "" - server: str = "" - currency: str = "USD" - company: str = "" - - __match_args__: ClassVar[tuple] - - def get_dict(self, exclude: set = None, include: set = None): - """Returns a dictionary of the account data. Using the exclude and include arguments, you can filter the data - - Args: - exclude (set): A set of keys to exclude - include (set): A set of keys to include - """ - exclude, include = exclude or set(), include or set() - filter_ = include or set(self.__match_args__).difference(exclude) - return {key: value for key, value in self.asdict().items() if key in filter_} - - def asdict(self): - """Returns a dictionary of the account data""" - res = {key: getattr(self, key) for key in self.__match_args__} - return res - - def set_attrs(self, **kwargs): - """Se the attributes of the account data to the instance""" - [setattr(self, k, v) for k, v in kwargs.items() if k in self.__match_args__] diff --git a/src/aiomql/core/backtesting/backtest_controller.py b/src/aiomql/core/backtesting/backtest_controller.py deleted file mode 100644 index 632d1fe..0000000 --- a/src/aiomql/core/backtesting/backtest_controller.py +++ /dev/null @@ -1,119 +0,0 @@ -from logging import getLogger -from asyncio import Task -from signal import signal, SIGINT -from threading import Barrier, BrokenBarrierError -from typing import Self -from datetime import datetime - -from ..config import Config -from ..exceptions import StopTrading - -logger = getLogger(__name__) - - -class BackTestController: - """The controller for the backtesting engine. - It also acts as a synchronizer for running multiple strategies (tasks) using a threading.Barrier primitive. - It handles the updating of open positions and close them when necessary. - It handles the iterator for the backtesting engine and handles it movement in time by moving it to the next time step. - - Attributes: - _instance (Self): The instance of the controller - config (Config): The configuration for the backtesting engine - tasks (list[Task]): The tasks that are being run - barrier (Barrier): The barrier for synchronizing the tasks - """ - - _instance: Self - config: Config - tasks: list[Task] - barrier: Barrier - - def __new__(cls, *args, **kwargs): - if not hasattr(cls, "_instance"): - cls._instance = super().__new__(cls) - cls._instance.config = Config() - cls._instance.config.backtest_controller = cls._instance - cls._instance.barrier = Barrier(1) - cls._instance.tasks = [] - return cls._instance - - @property - def backtest_engine(self): - """Returns the backtest engine""" - return self.config.backtest_engine - - def add_tasks(self, *tasks: Task): - """Adds tasks to the tasks list""" - self.tasks.extend(tasks) - - def set_parties(self, *, parties: int): - """Sets the number of parties for the barrier. The barrier will wait for the number of parties to reach the barrier. - This has to be done here as it can be impossible to know the eventual number of parties to set the barrier to during initialization. - - Args: - parties (int): The number of parties to set the barrier to - """ - self.barrier._parties = parties - - @property - def parties(self): - """Returns the number of parties for the barrier""" - return self.barrier.parties - - async def control(self): - """The backtest controller. It controls the backtesting engine and the tasks that are being run. - It acts as a synchronizer for the tasks and the backtesting engine. - """ - try: - self.backtest_engine.next() - while True: - pending = self.wait() - # all main tasks have been completed in the current cycle - if pending == 0: - await self.backtest_engine.tracker() - self.backtest_engine.next() - if self.backtest_engine.cursor.time % (3600 * 12) == 0: - logger.info( - datetime.strftime( - datetime.fromtimestamp(self.backtest_engine.cursor.time), "%Y-%m-%d %H:%M:%S" - ) - ) - if self.backtest_engine.stop_testing: - logger.info( - "Stop trading called in control at %s", - datetime.fromtimestamp(self.backtest_engine.cursor.time).strftime("%Y-%m-%d %H:%M:%S"), - ) - break - await self.backtest_engine.wrap_up() - self.stop_backtesting() - except BrokenBarrierError: - await self.backtest_engine.wrap_up() - self.stop_backtesting() - return - - except Exception as err: - logger.error("Error: %s in controller", err) - await self.backtest_engine.wrap_up() - self.stop_backtesting() - return - - def stop_backtesting(self): - """Stop the backtester, and shutdown the executor""" - self.abort() - self.config.shutdown = True - - # should this be async? - def wait(self): - """Called by individual tasks to indicate completion of their cycle""" - try: - pending = self.barrier.wait() - return pending - except BrokenBarrierError: - raise StopTrading - except Exception as err: - logger.error("Error: %s in wait", err) - - def abort(self): - """Aborts the barrier""" - self.barrier.abort() diff --git a/src/aiomql/core/backtesting/backtest_engine.py b/src/aiomql/core/backtesting/backtest_engine.py deleted file mode 100644 index bdbce08..0000000 --- a/src/aiomql/core/backtesting/backtest_engine.py +++ /dev/null @@ -1,1580 +0,0 @@ -from threading import RLock -import asyncio -import json -from datetime import datetime, UTC -from typing import Literal -import random -from functools import cached_property -from logging import getLogger -from pathlib import Path - -import pandas as pd -import numpy as np -from pandas import DataFrame -from MetaTrader5 import ( - Tick, - SymbolInfo, - AccountInfo, - TradeOrder, - TradePosition, - TradeDeal, - TradeRequest, - OrderCheckResult, - OrderSendResult, - TerminalInfo, -) - -from ..meta_trader import MetaTrader -from ..constants import ( - TimeFrame, - OrderType, - TradeAction, - AccountStopOutMode, - PositionReason, - DealType, - DealReason, - DealEntry, - OrderReason, - CopyTicks, -) - -from ...utils import round_down, round_up, error_handler, error_handler_sync, async_cache - -from .get_data import BackTestData, GetData, Cursor -from .backtest_account import BackTestAccount -from .trades_manager import PositionsManager, OrdersManager, DealsManager - -logger = getLogger(__name__) - - -# noinspection PyUnresolvedReferences -class BackTestEngine: - mt5: MetaTrader - span: range - range: range - speed: int - cursor: Cursor - iter: zip - rates: dict[str, dict[int, DataFrame]] - ticks: dict[str, DataFrame] - prices: dict[str, DataFrame] - orders: OrdersManager - deals: DealsManager - positions: PositionsManager - _account: BackTestAccount - stop_testing: bool - use_terminal: bool - restart: bool - stop_time: int | None - close_open_positions_on_exit: bool - preloaded_ticks: dict[str, DataFrame] - preload: bool - account_lock: RLock - account_info: dict - checkpoint: float - - def __init__( - self, - *, - data: BackTestData = None, - speed: int = 60, - start: float | datetime = 0, - end: float | datetime = 0, - restart: bool = True, - use_terminal: bool = None, - name: str = "", - stop_time: float | datetime = None, - close_open_positions_on_exit: bool = True, - preload=True, - assign_to_config: bool = True, - account_info: dict = None, - checkpoint: float = 0.02 - ): - self._data = data or BackTestData() - self.mt5 = MetaTrader() - self.config = self.mt5.config - if assign_to_config: - self.config.backtest_engine = self - self.setup_test_range(start=start, end=end, speed=speed, restart=restart) - self.setup_data(restart=restart) - start, end = ( - (self.span[0], self.span[-1]) if len(self.span) >= 2 else ((now := datetime.now(UTC).timestamp()), now) - ) - start, end = datetime.fromtimestamp(start, tz=UTC), datetime.fromtimestamp(end, tz=UTC) - self.name = name or self._data.name or f"backtest_data_{start:%d_%m_%y}_{end:%d_%m_%y}" - self.stop_testing = False - self.use_terminal = self.config.use_terminal_for_backtesting if use_terminal is None else use_terminal - self.close_open_positions_on_exit = close_open_positions_on_exit - if stop_time is not None: - val = ( - stop_time.astimezone(tz=UTC) - if isinstance(stop_time, datetime) - else datetime.fromtimestamp(stop_time, tz=UTC) - ) - stop_time = int(val.timestamp()) - self.stop_time = stop_time - self.preload = preload - self.preloaded_ticks = {} - self.account_lock = RLock() - self.account_info = account_info or {} - self.checkpoint = checkpoint - - def __next__(self) -> Cursor: - try: - index, time = next(self.iter) - if self.stop_time and time >= self.stop_time: - raise StopIteration - self.cursor = Cursor(index=index, time=time) - return self.cursor - except StopIteration: - logger.critical("End of the test range") - self.stop_testing = True - - def __repr__(self): - return f"{self.__class__.__name__}()" - - def setup_test_range( - self, *, start: float | datetime = None, end: float | datetime = None, speed: int = 60, restart: bool = True - ): - """Setup the test range for the backtest engine. This is used to set the range of the backtest and the speed - at which it runs. - - Args: - start (float | datetime, optional): The start time of the backtest. Defaults to None. If a float is passed, - it is assumed to be a timestamp. - - end (float | datetime, optional): The end time of the backtest. Defaults to None. If a float is passed, - it is assumed to be a timestamp. - - speed (int, optional): The speed of the backtest. Defaults to 60. - - restart (bool, optional): Whether to restart the backtest. Defaults to True. - This is useful when resuming a backtest using a saved BackTestData. - """ - if self._data.span and self._data.range: - start = start or self._data.span[0] - end = end or self._data.span[-1] + speed - start = start.astimezone(tz=UTC) if isinstance(start, datetime) else datetime.fromtimestamp(start, tz=UTC) - end = end.astimezone(tz=UTC) if isinstance(end, datetime) else datetime.fromtimestamp(end, tz=UTC) - span_start = int(start.timestamp()) - span_end = int(end.timestamp()) - self.speed = speed - self.span = range(span_start, span_end, speed) - self.range = range(0, span_end - span_start, speed) - self.iter = zip(self.range, self.span) - - if restart is False and self._data.cursor is not None: - self.cursor = self._data.cursor - index = self.cursor.index // speed - new_range = range(self.range[index], self.range.stop, speed) - new_span = range(self.span[index], self.span.stop, speed) - self.iter = zip(new_range, new_span) - # self.go_to(time=self.cursor.time) - else: - self.cursor = Cursor(index=self.range.start, time=self.span.start) - - def setup_data(self, *, restart: bool = True): - """Sets up the data for the backtest engine. This includes the orders, positions, deals and account - information. This data is handled by specialized classes such as the BackTestAccount and the TradeManager - classes. - - Args: - restart (bool, optional): Whether to restart the data. Defaults to True. - """ - if restart is True: - self.orders = OrdersManager() - self.positions = PositionsManager() - self.deals = DealsManager() - self._account = BackTestAccount() - return - - orders = {} - for ticket, order in self._data.orders.items(): - orders[ticket] = TradeOrder((order.get(k) for k in TradeOrder.__match_args__)) - self.orders = OrdersManager(data=orders) - - positions = {} - for ticket, position in self._data.positions.items(): - positions[ticket] = TradePosition((position.get(k) for k in TradePosition.__match_args__)) - self.positions = PositionsManager( - data=positions, open_positions=self._data.open_positions, margins=self._data.margins - ) - - deals = {} - for ticket, deal in self._data.deals.items(): - deals[ticket] = TradeDeal((deal.get(k) for k in TradeDeal.__match_args__)) - self.deals = DealsManager(data=deals) - - self._account = BackTestAccount(**self._data.account) - - def next(self) -> Cursor: - """Move the cursor to the next time step in the backtest range.""" - return next(self) - - @property - def data(self): - """The BackTestData instance used for the backtest. If not provided, a new instance is created, - and the data is made persistent when the backtest is stopped.""" - return self._data - - def reset(self, clear_data: bool = False): - """Reset the backtest engine. This is useful when restarting the backtest from the beginning.""" - self.iter = zip(self.range, self.span) - self.cursor = Cursor(index=self.range.start, time=self.span.start) - if clear_data: - self.setup_data(restart=True) - - def go_to(self, *, time: datetime | float): - """Move the cursor to a specific time in the backtest range. You can pass a datetime object or a timestamp. - You can't go back in time or beyond the limits of the range. - """ - time = time.astimezone(tz=UTC) if isinstance(time, datetime) else datetime.fromtimestamp(time, tz=UTC) - time = int(time.timestamp()) - steps = time - self.cursor.time - steps = steps // self.speed - steps = max(steps, 1) - if 0 <= steps < (len(self.range) - 1): - self.fast_forward(steps=steps) - return - raise ValueError("Can't go back in time or beyond the limits of the range") - - def fast_forward(self, *, steps: int): - """Fast-forward the backtester by the given steps.""" - for _ in range(steps): - self.next() - - @staticmethod - def get_dtype(*, df: DataFrame) -> list[tuple[str, str]]: - return [(c, t) for c, t in zip(df.columns, df.dtypes)] - - async def tracker(self): - """The tracker monitors and updates open positions on every iteration. It is called by the controller.""" - try: - pos_tasks = [self.check_position(ticket=ticket) for ticket in self.positions._open_positions] - await asyncio.gather(*pos_tasks) - profit = sum(pos.profit for pos in self.positions.open_positions) - self.update_account(profit=profit) - self.check_account() - if int(self.cursor.index % (self.range.stop * self.checkpoint)) == 0: - await asyncio.to_thread(self.save_result_to_json) - except Exception as exe: - logger.critical("Error in tracker: %s at %d", exe, self.cursor.time) - - @error_handler_sync - def save_result_to_json(self): - """Saves the result to a json file at the end of testing.""" - data = self._account.get_dict(include={"balance", "profit", "equity", "margin", "margin_free", "margin_level"}) - wins = [position for ticket in self.positions if (position := self.positions.get(ticket)).profit > 0] - losses = [position for ticket in self.positions if (position := self.positions.get(ticket)).profit <= 0] - win = round(sum(position.profit for position in wins), self._account.currency_digits) - loss = round(sum(position.profit for position in losses), self._account.currency_digits) - profit_factor = round(abs(win / loss), 2) if loss != 0 else 0 - wins, losses, total = len(wins), len(losses), len(self.positions._data) - win_percentage = round(wins / total * 100, 2) if total > 0 else 0 - net_profit = round(win - abs(loss), self._account.currency_digits) - profitability = net_profit / (self._account.balance - net_profit) * 100 if net_profit != 0 else 0 - profitability = round(profitability, 2) - data.update( - { - "wins": wins, - "losses": losses, - "total": total, - "win_percentage": win_percentage, - "win": win, - "loss": loss, - "net_profit": net_profit, - "profit_factor": profit_factor, - "profitability": profitability, - } - ) - path = Path(self.config.backtest_dir / f"{self.name}.json") - with path.open("w") as file: - json.dump(data, file, indent=4) - - async def close_all_open(self): - """Closes all open position at the end of testing""" - tasks = [self.check_position(ticket=position.ticket) for position in self.positions.open_positions] - await asyncio.gather(*tasks) - for position in self.positions.open_positions: - await self.close_position_manually(ticket=position.ticket) - - @error_handler - async def wrap_up(self): - """Wraps up the backtest. This is called at the end of testing to save the results and close all open - positions.""" - if self.close_open_positions_on_exit: - await self.close_all_open() - self.save_result_to_json() - self._data.deals = self.deals.to_dict() - self._data.orders = self.orders.to_dict() - self._data.positions = self.positions.to_dict() - self._data.open_positions = self.positions._open_positions - self._data.margins = self.positions.margins - self._data.account = self._account.asdict() - self._data.cursor = self.cursor - self._data.span = self.span - self._data.range = self.range - self._data.account = self._account.asdict() - name = self._data.name or self.name - self._data.name = name - path = self.config.backtest_dir / f"{name}.pkl" - GetData.pickle_data(data=self._data, name=path) - - async def preload_ticks(self, *, symbol: str): - """Pull a month data on ticks from the terminal. Starting from the current time. - - Args: - symbol (str): The symbol to preload ticks for. - """ - try: - start = self.cursor.time - end = start + (30 * 24 * 60 * 60) - end = end if end < self.span.stop else self.span.stop - span = range(start, end) - start = datetime.fromtimestamp(start, tz=UTC) - end = datetime.fromtimestamp(end, tz=UTC) - ticks = await self.mt5.copy_ticks_range(symbol, start, end, CopyTicks.ALL) - ticks = pd.DataFrame(ticks) - ticks.drop_duplicates(subset=["time"], keep="last", inplace=True) - ticks.set_index("time", inplace=True, drop=False) - ticks = ticks.reindex(span, method="nearest", copy=True) - self.preloaded_ticks[symbol] = ticks - except Exception as exe: - logger.error(f"Error Preloading Ticks: {exe}") - - @async_cache - async def get_price_tick(self, *, symbol: str, time: int) -> Tick | None: - """Get the price tick for a symbol at a given time. If the preload option is set to True, - it will use the preloaded ticks when available. - - Args: - symbol (str): The symbol to get the price tick for. - time (int): The time to get the price tick. - """ - try: - if self.use_terminal and self.preload: - if (ticks := self.preloaded_ticks.get(symbol)) is not None and time in ticks.index: - return Tick(ticks.loc[time]) - await self.preload_ticks(symbol=symbol) - tick = self.preloaded_ticks[symbol].loc[time] - return Tick(tick) - - elif self.use_terminal and self.preload is False: - time = datetime.fromtimestamp(time, tz=UTC) - tick = await self.mt5.copy_ticks_from(symbol, time, 1, CopyTicks.ALL) - return Tick(tick[-1]) if tick is not None else None - else: - tick = self.prices[symbol].loc[time] - return Tick(tick) - except Exception as exe: - logger.error("Error Getting Price Tick: %s", exe) - - @error_handler - async def check_order(self, *, ticket: int): - """ " - Check if the order has reached its take profit or stop loss levels and close the order if it has. - Checks only **OrderType.BUY** and **OrderType.SELL** orders that have reached their take profit or stop loss levels. - - Args: - ticket (int): Order ticket - """ - order = self.orders[ticket] - order_type, symbol = order.type, order.symbol - tick = await self.get_price_tick(symbol=symbol, time=self.cursor.time) - tp, sl = order.tp, order.sl - - if not (tp and sl): - return - - deal = { - "ticket": random.randint(100_000_000, 199_999_999), - "order": ticket, - "symbol": symbol, - "commission": 0, - "swap": 0, - "position_id": ticket, - "fee": 0, - "time": self.cursor.time, - "time_msc": self.cursor.time * 1000, - "price": tick.bid, - "type": DealType(order_type), - "reason": DealReason.EXPERT, - "entry": DealEntry.OUT, - "profit": 0, - } - - match order_type: - case OrderType.BUY: - if tick.bid >= tp or tick.bid <= sl: - res = await self.close_position(ticket=ticket) - if res: - pos = self.positions.get(ticket) - deal.update({"profit": pos.profit, "volume": pos.volume}) - self.deals[deal["ticket"]] = TradeDeal((deal.get(k, 0) for k in TradeDeal.__match_args__)) - - case OrderType.SELL: - if tick.ask <= tp or tick.ask >= sl: - res = await self.close_position(ticket=ticket) - if res: - pos = self.positions.get(ticket) - deal.update({"profit": pos.profit, "volume": pos.volume}) - self.deals[deal["ticket"]] = TradeDeal((deal.get(k, 0) for k in TradeDeal.__match_args__)) - case _: - ... - - def check_account(self): - """Checks an account status. This method is called at each iteration to check if the account has burned out.""" - account = self._account - level = account.margin_level if account.margin_so_mode == AccountStopOutMode.PERCENT else account.margin_so_call - if level < account.margin_so_call and level != 0 and account.equity < 0: - logger.critical("Account has burned out!!! Please top up to continue trading") - self.stop_testing = True - - async def check_position(self, *, ticket: int): - """ - Update the profit of an open position based on the current price of the symbol. It is called by the - tracker to update the profit of open positions. - - Args: - ticket (int): Position ticket - """ - pos = self.positions[ticket] - order_type, symbol, volume, price_open, prev_profit = ( - pos.type, - pos.symbol, - pos.volume, - pos.price_open, - pos.profit, - ) - tick = await self.get_price_tick(symbol=symbol, time=self.cursor.time) - price_current = tick.bid if order_type == OrderType.BUY else tick.ask - profit = await self.order_calc_profit( - action=order_type, symbol=symbol, volume=volume, price_open=price_open, price_close=price_current - ) - kwargs = dict(price_current=price_current, time_update=self.cursor.time) - kwargs.update(profit=profit) if profit is not None else ... - self.positions.update(ticket=pos.ticket, **kwargs) - await self.check_order(ticket=ticket) - - @error_handler - async def close_position_manually(self, *, ticket: int): - """Close a position manually without. Usually at the end of testing.""" - res = await self.close_position(ticket=ticket) - if not res: - return - position = self.positions.get(ticket) - order_ticket = random.randint(800_000_000, 899_999_999) - deal_ticket = random.randint(100_000_000, 199_999_999) - time = position.time_update - time_msc = position.time_update_msc - order_type = OrderType.BUY if position.type == OrderType.SELL else OrderType.SELL - order = { - "position_id": position.ticket, - "ticket": order_ticket, - "comment": "", - "external_id": "", - "time_setup": time, - "time_setup_msc": time_msc, - "time_done": time, - "time_done_msc": time_msc, - "type": order_type, - "symbol": position.symbol, - "sl": position.sl, - "tp": position.tp, - "price_current": position.price_current, - "reason": OrderReason.EXPERT, - "volume_initial": position.volume, - } - - # TODO: calculate commission and swap if possible or necessary - deal = { - "ticket": deal_ticket, - "position_id": position.ticket, - "order": order_ticket, - "symbol": position.symbol, - "time": time, - "profit": position.profit, - "time_msc": time_msc, - "volume": position.volume, - "price": position.price_current, - "type": DealType(order_type), - "reason": DealReason.EXPERT, - "entry": DealEntry.OUT, - "comment": "", - "external_id": "", - } - order = TradeOrder((order.get(k, 0) for k in TradeOrder.__match_args__)) - deal = TradeDeal((deal.get(k, 0) for k in TradeDeal.__match_args__)) - self.orders[order.ticket] = order - self.deals[deal.ticket] = deal - - async def close_position(self, *, ticket: int) -> bool: - """ - Close an open position for the trading account using the position ticket. - - Args: - ticket: Position ticket - - Returns: - bool: True if the position is closed successfully, False otherwise - """ - try: - position = self.positions[ticket] - margin = self.positions.get_margin(ticket=ticket) - self.positions.delete_margin(ticket=ticket) - self.positions.close(ticket=ticket) - self.orders.update(ticket=ticket, time_done=self.cursor.time, time_done_msc=self.cursor.time * 1000) - profit = sum([position.profit for position in self.positions.open_positions]) - profit = round(profit, self._account.currency_digits) - self.update_account(gain=position.profit, profit=profit, margin=-margin) - return True - except Exception as exe: - logger.error("Error Closing Position %d: %s", ticket, exe) - return False - - @error_handler_sync(response=False) - def modify_stops(self, *, ticket: int, sl: int, tp: int) -> bool: - """ - Modify the stop loss and take profit levels of an open position. - - Args: - ticket (int): Position ticket - sl (int): stop loss level - tp (int): Take profit level - - Returns: - bool: True if the stops are modified successfully, False otherwise - """ - self.positions.update( - ticket=ticket, sl=sl, tp=tp, time_update=self.cursor.time, time_update_msc=self.cursor.time * 1000 - ) - return True - - def update_account(self, *, profit: float = None, margin: float = 0, gain: float = 0): - """ - Update the account. This method is protected by thread lock. - - Args: - profit (float): The current profit of one or more open positions. Can be positive or negative. - margin (float): The margin set aside for a trade. It is released when the trade is closed. - gain (gain): The gain realized when the trade is closed. - """ - self.account_lock.acquire() - try: - self._account.balance += round(gain, self._account.currency_digits) - self._account.profit = ( - round(profit, self._account.currency_digits) if profit is not None else self._account.profit - ) - self._account.equity = self._account.balance + self._account.profit - self._account.margin += round(margin, self._account.currency_digits) - self._account.margin_free = round( - self._account.equity - self._account.margin, self._account.currency_digits - ) - self._account.balance = round(self._account.balance, self._account.currency_digits) - self._account.equity = round(self._account.equity, self._account.currency_digits) - self._account.margin = round(self._account.margin, self._account.currency_digits) - self._account.margin_free = round(self._account.margin_free, self._account.currency_digits) - self._account.profit = round(self._account.profit, self._account.currency_digits) - - if self._account.margin == 0: - self._account.margin_level = 0 - else: - mode = self._account.margin_so_mode - level = self._account.equity / self._account.margin * 100 - self._account.margin_level = level if mode == AccountStopOutMode.PERCENT else self._account.margin_free - except Exception as exe: - logger.critical("Error Updating Account: %s", exe) - - finally: - self.account_lock.release() - - def deposit(self, *, amount: float): - """Make deposit to the trading account""" - self.update_account(gain=amount) - - def withdraw(self, *, amount: float): - """Make a withdrawal from the trading account. You can not withdraw more than what you have""" - assert amount <= self._account.balance, "Insufficient funds" - self.update_account(gain=-amount) - - @error_handler - async def setup_account(self, **kwargs): - """Setup the trading account before the begining of a backtesting session. - - Args: - (**kwargs, Any): Attributes for the backetest account object can be set here. - """ - kwargs = {**self.account_info, **kwargs} - default = { - "profit": self._account.profit, - "margin": self._account.margin, - "equity": self._account.equity, - "margin_free": self._account.margin_free, - "margin_level": self._account.margin_level, - "balance": self._account.balance, - **{k: v for k, v in kwargs.items() if k in self._account.__match_args__}, - } - - if self.use_terminal: - acc_info = await self.mt5.account_info() - default = {**acc_info._asdict(), **default} - - self._account.set_attrs(**default) - self.update_account() - - @error_handler_sync - def setup_account_sync(self, **kwargs): - """Set up the backtesting account in sync mode""" - kwargs = {**self.account_info, **kwargs} - default = { - "profit": self._account.profit, - "margin": self._account.margin, - "equity": self._account.equity, - "margin_free": self._account.margin_free, - "margin_level": self._account.margin_level, - "balance": self._account.balance, - **{k: v for k, v in kwargs.items() if k in self._account.__match_args__}, - } - - if self.use_terminal: - acc_info = self.mt5._account_info() - default = {**acc_info._asdict(), **default} - - self._account.set_attrs(**default) - self.update_account() - - @cached_property - def prices(self) -> dict[str, DataFrame]: - """Get the prices for instruments used in the backtesting. This class is called when the use_terminal option - is set to False and trading data is provided in the data attribute. It makes sure that there is a price for each - symbol for every second covered in the backtesting range, by reindexing the price ticks using the backtesting - time span and filling up missing data using the nearest method. - This method returns a dictionaries of dataframe containing the prices for each symbol. - It's cached and there computed only once per backtesting session. - - Returns: - dict[str, DataFrame]: A dictionary mapping dataframe of prices to symbols. - """ - prices = {} - for symbol in self._data.ticks.keys(): - res = self._data.ticks[symbol] - res = pd.DataFrame(res) - res.drop_duplicates(subset=["time"], keep="last", inplace=True) - res.set_index("time", inplace=True, drop=False) - res = res.reindex(self.span, copy=True, method="nearest") # fill in missing values with NaN - prices[symbol] = res - return prices - - @cached_property - def ticks(self) -> dict[str, DataFrame]: - """Similar to prices above, but returns prices exactly as they are without reindexing and filling up. - - Returns: - dict[str, DataFrame]: A dictionary mapping symbols to dataframes of ticks. - """ - ticks = {} - for symbol in self._data.ticks.keys(): - res = self._data.ticks[symbol] - res = pd.DataFrame(res) - ticks[symbol] = res - return ticks - - @cached_property - def rates(self) -> dict[str, dict[int, DataFrame]]: - """This property is useful when backtesting with the use_terminal option set to false. It returns a nested dict - that maps symbols to a dict mapping timeframes to rates. The timeframes are mapped using their integer values. - - Returns: - dict[str, dict[int, DataFrame]]: A dictionary containing the symbol rates. - """ - rates = {} - for symbol in self._data.rates.keys(): - for timeframe in self._data.rates[symbol].keys(): - res = self._data.rates[symbol][timeframe] - res = pd.DataFrame(res) - rates.setdefault(symbol, {})[timeframe] = res - return rates - - @cached_property - def symbols(self) -> dict[str, SymbolInfo]: - """A dictionary of symbols and SymbolInfo object. Used when use_terminal is set to false. - - Returns: - dict[str, SymbolInfo] - """ - symbols = {} - for symbol, info in self._data.symbols.items(): - symbols[symbol] = SymbolInfo((info.get(key) for key in SymbolInfo.__match_args__)) - return symbols - - @error_handler - async def order_send(self, *, request: dict, use_terminal=False) -> OrderSendResult: - """Simulates the sending of an order to the broker. An OrderSendResult is object is created at the end of this - operation as would be created if it was done in live trading. When an order is successful a positions object is - created, an order and deal object is created as well. When use_terminal is set to true the margin and profit - are calculated by sending to the broker. This increases accuracy but slows down the backtester. Check order is - called to make sure the order is valid and would go through if it was a live trade. - - Args: - request (dict): The order request as a dict. - use_terminal (bool): A flag to override the use_terminal attribute. If true, the terminal will - be used even if the use_terminal attribute is True. - - Returns: - OrderSendResult: An object containing the result of the order send operation. - """ - use_terminal = self.use_terminal or use_terminal - osr = { - "retcode": 10013, - "comment": "Invalid request", - "request": TradeRequest(request.get(k, (0 if k != "comment" else "")) for k in TradeRequest.__match_args__), - } - current_tick = await self.get_price_tick(symbol=request.get("symbol"), time=self.cursor.time) - if current_tick is None: - osr["comment"] = "Market is closed" - osr["retcode"] = 10018 - return OrderSendResult((osr.get(k, 0) for k in OrderSendResult.__match_args__)) - - trade_order = { - "external_id": "", - "comment": "", - **{k: v for k, v in request.items() if k in TradeOrder.__match_args__}, - } - order_type, symbol = request.get("type"), request.get("symbol", "") - action, position_id = request.get("action"), request.get("position") - sl, tp, volume, symbol = (request.get("sl"), request.get("tp"), request.get("volume"), request.get("symbol")) - order_type = OrderType(order_type) - current_position = self.positions.get(position_id) - order_ticket = random.randint(800_000_000, 899_999_999) - deal_ticket = random.randint(100_000_000, 199_999_999) - - # closing an order by an opposite order using a position ticket and Deal action - if action == TradeAction.DEAL and current_position and order_type.opposite == current_position.type: - res = await self.close_position(ticket=current_position.ticket) - if res: - price_current = current_tick.ask if order_type == OrderType.BUY else current_tick.bid - trade_order.update( - { - "position_id": current_position.ticket, - "ticket": order_ticket, - "time_setup": current_tick.time, - "time_setup_msc": current_tick.time_msc, - "time_done": current_tick.time, - "time_done_msc": current_tick.time_msc, - "type": order_type, - "symbol": symbol, - "sl": current_position.sl, - "tp": current_position.tp, - "price_current": price_current, - "reason": OrderReason.EXPERT, - "volume_initial": current_position.volume, - } - ) - - # TODO: calculate commission and swap if possible or necessary - deal = { - "ticket": deal_ticket, - "position_id": current_position.ticket, - "order": order_ticket, - "symbol": symbol, - "time": current_tick.time, - "profit": current_position.profit, - "time_msc": current_tick.time_msc, - "volume": current_position.volume, - "price": price_current, - "type": DealType(order_type), - "reason": DealReason.EXPERT, - "entry": DealEntry.OUT, - "comment": "", - "external_id": "", - } - - order = TradeOrder((trade_order.get(k, 0) for k in TradeOrder.__match_args__)) - self.orders[order.ticket] = order - deal = TradeDeal((deal.get(k, 0) for k in TradeDeal.__match_args__)) - self.deals[deal.ticket] = deal - osr.update( - {"comment": "Request completed", "retcode": 10009, "order": order_ticket, "deal": deal_ticket} - ) - return OrderSendResult((osr.get(k, 0) for k in OrderSendResult.__match_args__)) - - if action == TradeAction.SLTP and current_position: - check = await self.order_check(request=request, use_terminal=use_terminal) - if check.retcode != 0: - osr = {"retcode": check.retcode, "comment": check.comment, "request": check.request} - return OrderSendResult((osr.get(k, 0) for k in OrderSendResult.__match_args__)) - res = self.modify_stops(ticket=position_id, sl=sl, tp=tp) - if res: - osr.update( - {"comment": "Request completed", "retcode": 10009, "order": order_ticket, "deal": deal_ticket} - ) - return OrderSendResult((osr.get(k, 0) for k in OrderSendResult.__match_args__)) - - if action == TradeAction.DEAL and order_type in (OrderType.BUY, OrderType.SELL): - check = await self.order_check(request=request, use_terminal=use_terminal) - if check.retcode != 0: - osr = {"retcode": check.retcode, "comment": check.comment, "request": check.request} - return OrderSendResult((osr.get(k, 0) for k in OrderSendResult.__match_args__)) - - price = current_tick.ask if order_type == OrderType.BUY else current_tick.bid - position = { - "ticket": order_ticket, - "symbol": symbol, - "volume": volume, - "price_open": price, - "price_current": price, - "type": order_type, - "profit": 0, - "reason": PositionReason.EXPERT, - "identifier": order_ticket, - "sl": sl, - "tp": tp, - "time": current_tick.time, - "time_msc": current_tick.time_msc, - "time_update": current_tick.time, - "time_update_msc": current_tick.time_msc, - } - - deal = { - "ticket": deal_ticket, - "order": order_ticket, - "symbol": symbol, - "commission": 0, - "swap": 0, - "position_id": order_ticket, - "fee": 0, - "time": current_tick.time, - "time_msc": current_tick.time_msc, - "volume": volume, - "price": price, - "type": DealType(order_type), - "reason": DealReason.EXPERT, - "entry": DealEntry.IN, - "profit": 0, - } - - # ToDo: set time_expiration based on order_type_time - trade_order.update( - { - "ticket": order_ticket, - "symbol": symbol, - "volume": volume, - "price": price, - "price_current": price, - "sl": sl, - "time_setup_msc": current_tick.time_msc, - "tp": tp, - "price_open": price, - "type": order_type, - "time_setup": current_tick.time, - "volume_current": volume, - "volume_initial": volume, - "position_id": order_ticket, - } - ) - - pos = TradePosition((position.get(k, 0) for k in TradePosition.__match_args__)) - order = TradeOrder((trade_order.get(k, 0) for k in TradeOrder.__match_args__)) - deal = TradeDeal((deal.get(k, 0) for k in TradeDeal.__match_args__)) - self.deals[deal_ticket] = deal - self.positions[order.ticket] = pos - self.orders[order.ticket] = order - osr.update( - { - "comment": "Request completed", - "retcode": 10009, - "order": order_ticket, - "price": price, - "volume": volume, - "bid": current_tick.bid, - "ask": current_tick.ask, - "deal": deal_ticket, - } - ) - margin = await self.order_calc_margin( - action=action, symbol=symbol, volume=volume, price=price, use_terminal=use_terminal - ) - self.positions.set_margin(ticket=order_ticket, margin=margin) - self.update_account(margin=margin) - return OrderSendResult((osr.get(k, 0) for k in OrderSendResult.__match_args__)) - - @error_handler - async def order_check(self, *, request: dict, use_terminal: bool = False) -> OrderCheckResult: - """Checks the order before placing it. If use_terminal, the order is checked with the broker, but the entire result - is not used. Details such as balance, profit, equity, margin, and margin level are calculated by the backtester. - - Args: - request (dict): The order request as a dict. - use_terminal (bool): A flag to override the use_terminal attribute. If true, the terminal will used. - - Returns: - OrderCheckResult: The result of the order check. - """ - use_terminal = self.use_terminal or use_terminal - ocr = { - "retcode": 10013, - "balance": 0, - "profit": 0, - "margin": 0, - "equity": 0, - "margin_free": 0, - "margin_level": 0, - "comment": "Invalid request", - "request": TradeRequest(request.get(k, (0 if k != "comment" else "")) for k in TradeRequest.__match_args__), - } - - action, symbol, volume = (request.get("action"), request.get("symbol"), request.get("volume")) - price, order_type, position_id = (request.get("price"), request.get("type"), request.get("position")) - - # check margin and confirm order can go through for a deal action and buy or sell order type - if action == TradeAction.DEAL and order_type in (OrderType.BUY, OrderType.SELL) and position_id is None: - margin = await self.order_calc_margin( - action=action, symbol=symbol, volume=volume, price=price, use_terminal=use_terminal - ) - if margin is None: - return OrderCheckResult((ocr.get(k, 0) for k in OrderCheckResult.__match_args__)) - - used_margin = self._account.margin + margin - free_margin = self._account.margin_free - margin - - level = self._account.equity / used_margin * 100 if used_margin else float("inf") - margin_level = level if self._account.margin_so_mode == AccountStopOutMode.PERCENT else free_margin - ocr.update({"margin_level": margin_level, "margin": margin, "margin_free": free_margin}) - - # check if the account has enough money - if margin_level < self._account.margin_so_call: - ocr["retcode"] = 10019 - ocr["comment"] = "No money" - return OrderCheckResult((ocr.get(k, 0) for k in OrderCheckResult.__match_args__)) - - # check if the stops level is valid - sym = await self.get_symbol_info(symbol=symbol) - sl, tp = request.get("sl"), request.get("tp") - current_price = price - if tp and sl: - if action == TradeAction.SLTP: - pos = self.positions.get(request.get("position")) - sym = await self.get_symbol_info(symbol=pos.symbol) - current_tick = sym or await self.get_price_tick(pos.symbol, self.cursor.time) - current_price = current_tick.bid if pos.type == OrderType.BUY else current_tick.ask - - min_sl = min(sl, tp) - dsl = abs(current_price - min_sl) / sym.point - tsl = sym.trade_stops_level + sym.spread - if dsl < tsl: - ocr["retcode"] = 10016 - ocr["comment"] = "Invalid stops" - return OrderCheckResult((ocr.get(k, 0) for k in OrderCheckResult.__match_args__)) - - elif action == TradeAction.SLTP: - ocr["comment"] = "Done" - ocr["retcode"] = 0 - return OrderCheckResult((ocr.get(k, 0) for k in OrderCheckResult.__match_args__)) - - if use_terminal or self.use_terminal: - ocr_t = await self.mt5.order_check(request) - if ocr_t.retcode in (10013, 10014): - return ocr_t - elif action == TradeAction.DEAL and order_type in (OrderType.BUY, OrderType.SELL): - # check volume - if volume < sym.volume_min or volume > sym.volume_max: - ocr["retcode"] = 10014 - ocr["comment"] = "Invalid volume" - return OrderCheckResult((ocr.get(k, 0) for k in OrderCheckResult.__match_args__)) - - ocr.update( - { - "balance": self._account.balance, - "profit": self._account.profit, - "equity": self._account.equity, - "comment": "Done", - "retcode": 0, - } - ) - - return OrderCheckResult((ocr.get(k, 0) for k in OrderCheckResult.__match_args__)) - - @error_handler - async def get_terminal_info(self) -> TerminalInfo: - """Get the terminal information - - Returns: - TerminalInfo: The terminal information - """ - if self.use_terminal: - res = await self.mt5.terminal_info() - return res - return TerminalInfo(self._data.terminal) - - @error_handler - async def get_version(self) -> tuple[int, int, str]: - """Get the version of the terminal. - - Returns: - tuple[int, int, str]: The version of the terminal - """ - if self.use_terminal: - res = await self.mt5.version() - return res - return self._data.version - - @error_handler - async def get_symbols_total(self) -> int: - """Get the total number of symbols available in the terminal. - - Returns: - int: The total number of symbols available. - """ - if self.use_terminal: - syms = await self.mt5.symbols_total() - return syms - return len(self.symbols) - - @error_handler - async def get_symbols(self, *, group: str = "") -> tuple[SymbolInfo, ...]: - """Get the symbols available in the terminal. Filter by group if provided. - - Args: - group (str): The group to filter by (default is "") - - Returns: - tuple[SymbolInfo, ...]: A tuple of symbol information - """ - if self.use_terminal: - syms = await self.mt5.symbols_get(group=group) - return syms - return tuple(list(self.symbols.values())) - - @error_handler_sync - def get_account_info(self) -> AccountInfo: - """Get the account information - - Returns: - AccountInfo: The account information - """ - return AccountInfo(self._account.asdict().values()) - - @error_handler - async def get_symbol_info_tick(self, *, symbol: str) -> Tick: - """Get the price tick for a symbol at the current time - - Args: - symbol (str): The symbol - - Returns: - Tick: The price tick - """ - tick = await self.get_price_tick(symbol=symbol, time=self.cursor.time) - return tick - - async def symbol_select(self, *, symbol: str, enable: bool) -> bool: - if self.use_terminal: - info = await self.mt5.symbol_select(symbol, enable) - return info - else: - return symbol in self._data.symbols.keys() - - def symbol_select_sync(self, *, symbol: str, enable: bool = True) -> bool: - if self.use_terminal: - info = self.mt5._symbol_select(symbol, enable) - return info - else: - return symbol in self._data.symbols.keys() - - def symbol_info_tick_sync(self, *, symbol) -> Tick | None: - if self.use_terminal: - time = datetime.fromtimestamp(self.cursor.time, tz=UTC) - tick = self.mt5._copy_ticks_from(symbol, time, 1, CopyTicks.ALL) - tick = Tick(tick[-1]) if tick is not None else None - else: - tick = self.prices[symbol].loc[self.cursor.time] - tick = Tick(tick) if tick is not None else None - return tick - - def symbol_info_sync(self, *, symbol) -> SymbolInfo | None: - if self.use_terminal: - info = self.mt5._symbol_info(symbol) - time = datetime.fromtimestamp(self.cursor.time, tz=UTC) - tick = self.mt5._copy_ticks_from(symbol, time, 1, CopyTicks.ALL) - tick = Tick(tick[-1]) if tick is not None else None - else: - info = self.symbols[symbol] - tick = self.prices[symbol].loc[self.cursor.time] - tick = Tick(tick) if tick is not None else None - - if info and tick: - info = info._asdict() | { - "bid": tick.bid, - "bidhigh": tick.bid, - "bidlow": tick.bid, - "ask": tick.ask, - "askhigh": tick.ask, - "asklow": tick.bid, - "last": tick.last, - "volume_real": tick.volume_real, - } - return SymbolInfo((info.get(key) for key in SymbolInfo.__match_args__)) - - @async_cache - async def _symbol_info(self, *, symbol: str) -> SymbolInfo: - if self.use_terminal: - info = await self.mt5.symbol_info(symbol) - else: - info = self.symbols[symbol] - return info - - @error_handler - async def get_symbol_info(self, *, symbol: str) -> SymbolInfo: - """Get the symbol information - - Args: - symbol (str): The symbol to get information for - - Returns: - SymbolInfo: The symbol information - """ - if self.use_terminal: - info = await self._symbol_info(symbol=symbol) - else: - info = self.symbols[symbol] - tick = await self.get_symbol_info_tick(symbol=symbol) - - info = info._asdict() | { - "bid": tick.bid, - "bidhigh": tick.bid, - "bidlow": tick.bid, - "ask": tick.ask, - "askhigh": tick.ask, - "asklow": tick.bid, - "last": tick.last, - "volume_real": tick.volume_real, - } - return SymbolInfo((info.get(key) for key in SymbolInfo.__match_args__)) - - @error_handler - async def get_rates_from( - self, *, symbol: str, timeframe: TimeFrame, date_from: datetime | float, count: int - ) -> np.ndarray: - """Get rates from a specific date to the current date. Used by the backtester to get rates for a symbol - - Args: - symbol (str): The symbol to get rates for - timeframe (TimeFrame): The timeframe of the rates - date_from (datetime | float): The date from which to get the rates - count (int): The number of rates to get - - Returns: - np.ndarray: An array of rates - """ - date_from = ( - date_from.astimezone(tz=UTC) - if isinstance(date_from, datetime) - else datetime.fromtimestamp(date_from, tz=UTC) - ) - if self.use_terminal: - rates = await self.mt5.copy_rates_from(symbol, timeframe, date_from, count) - return rates - - rates = self.rates[symbol][timeframe] - start = int(date_from.timestamp()) - start = round_down(start, timeframe.seconds) - rates = rates[rates.time <= start].iloc[-count:] - return np.fromiter((tuple(i) for i in rates.iloc), dtype=self.get_dtype(df=rates)) - - @error_handler - async def get_rates_from_pos(self, *, symbol: str, timeframe: TimeFrame, start_pos: int, count: int) -> np.ndarray: - """Get a number of rates counting from a specific position. With position zero being the current time. - - Args: - symbol (str): The symbol to get rates for - timeframe (TimeFrame): The timeframe of the rates - start_pos (int): The position to start from - count (int): The number of rates to get - - Returns: - np.ndarray: An array of rates - """ - if self.use_terminal: - current_time = self.cursor.time if start_pos == 0 else self.cursor.time - start_pos * timeframe.seconds - current_time = round_up(current_time, timeframe.seconds) - start = datetime.fromtimestamp(current_time, tz=UTC) - rates = await self.mt5.copy_rates_from(symbol, timeframe, start, count) - return rates - - rates = self.rates[symbol][timeframe] - - # the current time rounded up to a multiple of the timeframe in seconds and then subtracted by the start_pos - # multiplied by the timeframe in seconds gives the time of the last candlestick in the range when using - # copy_rates_from_pos - end = int(round_down(self.cursor.time, timeframe.seconds)) - start_pos * timeframe.seconds - start = end - count * timeframe.seconds - rates = rates[(rates.time > start) & (rates.time <= end)] - return np.fromiter((tuple(i) for i in rates.iloc), dtype=self.get_dtype(df=rates)) - - @error_handler - async def get_rates_range( - self, *, symbol: str, timeframe: TimeFrame, date_from: datetime | float, date_to: datetime | float - ) -> np.ndarray: - """Get rates within a specific date range. Used by the backtester to get rates for a symbol - - Args: - symbol (str): The symbol to get rates for - timeframe (TimeFrame): The timeframe of the rates - date_from (datetime | float): The date from which to get the rates - date_to (datetime | float): The date to which to get the rates - - Returns: - np.ndarray: An array of rates - """ - date_from = ( - date_from.astimezone(tz=UTC) - if isinstance(date_from, datetime) - else datetime.fromtimestamp(date_from, tz=UTC) - ) - date_to = ( - date_to.astimezone(tz=UTC) if isinstance(date_to, datetime) else datetime.fromtimestamp(date_to, tz=UTC) - ) - if self.use_terminal: - rates = await self.mt5.copy_rates_range(symbol, timeframe, date_from, date_to) - return rates - - rates = self.rates[symbol][timeframe] - start = round_up(int(date_from.timestamp()), timeframe.seconds) - end = round_up(int(date_to.timestamp()), timeframe.seconds) - rates = rates[(rates.time >= start) & (rates.time <= end)] - return np.fromiter((tuple(i) for i in rates.iloc), dtype=self.get_dtype(df=rates)) - - @error_handler - async def get_ticks_from( - self, *, symbol: str, date_from: datetime | float, count: int, flags: CopyTicks = CopyTicks.ALL - ) -> np.ndarray: - """Get a specified number of ticks counting from a specific date. - Args: - symbol (str): The symbol to get ticks for - date_from (datetime | float): The date from which to get the ticks - count (int): The number of ticks to get - flags (CopyTicks): The flags to use when getting the ticks - - Returns: - np.ndarray: An array of ticks - """ - date_from = ( - date_from.astimezone(tz=UTC) - if isinstance(date_from, datetime) - else datetime.fromtimestamp(date_from, tz=UTC) - ) - if self.use_terminal: - ticks = await self.mt5.copy_ticks_from(symbol, date_from, count, flags) - return ticks - - ticks = self.ticks[symbol] - start = int(date_from.timestamp()) - rates = ticks[ticks.time <= start].iloc[-count:] - return np.fromiter((tuple(i) for i in rates.iloc), dtype=self.get_dtype(df=rates)) - - @error_handler - async def get_ticks_range( - self, *, symbol: str, date_from: datetime | float, date_to: datetime | float, flags: CopyTicks = CopyTicks.ALL - ) -> np.ndarray: - """Get ticks within a specific date range. - - Args: - symbol (str): The symbol to get ticks for - date_from (datetime | float): The date from which to get the ticks - date_to (datetime | float): The date to which to get the ticks - flags (CopyTicks): The flags to use when getting the ticks - - Returns: - np.ndarray: An array of ticks - """ - date_from = ( - date_from.astimezone(tz=UTC) - if isinstance(date_from, datetime) - else datetime.fromtimestamp(date_from, tz=UTC) - ) - date_to = ( - date_to.astimezone(tz=UTC) if isinstance(date_to, datetime) else datetime.fromtimestamp(date_to, tz=UTC) - ) - if self.use_terminal: - ticks = await self.mt5.copy_ticks_range(symbol, date_from, date_to, flags) - return ticks - - ticks = self.ticks[symbol] - start = int(date_from.timestamp()) - end = int(date_to.timestamp()) - rates = ticks[(ticks.time >= start) & (ticks.time <= end)] - return np.fromiter((tuple(i) for i in rates.iloc), dtype=self.get_dtype(df=ticks)) - - @error_handler - async def order_calc_margin( - self, - *, - action: Literal[OrderType.BUY, OrderType.SELL], - symbol: str, - volume: float, - price: float, - use_terminal: bool = None, - ): - """Calculate the margin required for a trade. - - Args: - action (Literal[OrderType.BUY, OrderType.SELL]): Type of order - symbol (str): Symbol name - volume (float): Volume of the trade - price (float): The price at which the trade is opened - use_terminal (bool): A flag to override the use_terminal attribute. If true, the terminal will be used - even if the use_terminal attribute is True. - - Returns: - float: The margin required for the trade - """ - use_terminal = use_terminal if use_terminal is not None else self.use_terminal - if use_terminal: - return await self.mt5.order_calc_margin(action, symbol, volume, price) - - sym = self.symbols.get(symbol) - if sym is None and self.use_terminal: - sym = await self._symbol_info(symbol=symbol) - margin = (volume * sym.trade_contract_size * price) / (self._account.leverage / (sym.margin_initial or 1)) - return round(margin, self._account.currency_digits) - - @error_handler - async def order_calc_profit( - self, - *, - action: Literal[OrderType.BUY, OrderType.SELL], - symbol: str, - volume: float, - price_open: float, - price_close: float, - use_terminal=None, - ): - """ - Calculate the profit for a trade. - - Args: - action (Literal[OrderType.BUY, OrderType.SELL]): Type of order - symbol (str): Symbol name - volume (float): Volume of the trade - price_open (float): The price at which the trade is opened - price_close (float): The price at which the trade is closed - use_terminal (bool): A flag to override the use_terminal attribute. If true, the terminal will be used - even if the use_terminal attribute is True. - - Returns: - float: The profit of the trade - """ - use_terminal = use_terminal if use_terminal is not None else self.use_terminal - - if use_terminal: - return await self.mt5.order_calc_profit(action, symbol, volume, price_open, price_close) - - sym = self.symbols.get(symbol) - if sym is None and self.use_terminal: - sym = await self._symbol_info(symbol=symbol) - profit = ( - volume - * sym.trade_contract_size - * ((price_close - price_open) if action == OrderType.BUY else (price_open - price_close)) - ) - return round(profit, self._account.currency_digits) - - @error_handler_sync - def get_orders_total(self) -> int: - """Get the total number of pending orders. - - Returns: - int: Total number of pending orders - """ - return 0 - - @error_handler_sync - def get_orders(self, *, symbol: str = "", group: str = "", ticket: int = None) -> tuple[TradeOrder, ...]: - """Get pending orders from the terminal history. This has to do with pending orders, which this backtester - doesn't support yet. - - Args: - symbol: Symbol name - group: Group name - ticket: Order ticket - - Returns: - tuple[TradeOrder, ...]: Pending orders - """ - if symbol and group and ticket: - return tuple() - return () - - @error_handler_sync - def get_positions_total(self) -> int: - """Get the total number of open positions. - - Returns: - int: Total number of open positions - """ - return self.positions.positions_total() - - @error_handler_sync - def get_positions(self, *, symbol: str = None, group: str = None, ticket: int = None) -> tuple[TradePosition, ...]: - """Get open positions from the terminal history. - - Args: - symbol: The symbol name - group: Group argument to filter by - ticket: Position ticket - - Returns: - tuple[TradePosition, ...]: Open positions - """ - return self.positions.positions_get(ticket=ticket, symbol=symbol, group=group) - - @error_handler_sync - def get_history_orders_total(self, *, date_from: datetime | float, date_to: datetime | float) -> int: - """Get the total number of orders in the terminal history. - - Args: - date_from: The start date of the history - - date_to: The end date of the history - - Returns: - int: Total number of orders in the history - """ - return self.orders.history_orders_total(date_from=date_from, date_to=date_to) - - @error_handler_sync - def get_history_orders( - self, - *, - date_from: datetime | float = None, - date_to: datetime | float = None, - group: str = "", - ticket: int = None, - position: int = None, - ) -> tuple[TradeOrder, ...]: - """Get orders from the terminal history. - - Args: - date_from: Date from which to start the history - date_to: Date to which to end the history - group: group keyword to filter by - ticket: ticket id to filter by - position: position id to filter by - - Returns: - tuple[TradeOrder, ...]: Orders in the history - """ - return self.orders.history_orders_get( - date_from=date_from, date_to=date_to, group=group, ticket=ticket, position=position - ) - - @error_handler_sync - def get_history_deals_total(self, *, date_from: datetime | float, date_to: datetime | float) -> int: - """Get the total number of deals in the terminal history. - - Args: - date_from: Date from which to start the history - date_to: Date to which to end the history - - Returns: - int: Total number of deals in the history - """ - return self.deals.history_deals_total(date_from=date_from, date_to=date_to) - - @error_handler_sync - def get_history_deals( - self, - *, - date_from: datetime | float = None, - date_to: datetime | float = None, - group: str = None, - position: int = None, - ticket: int = None, - ) -> tuple[TradeDeal, ...]: - """Get deals from the terminal history. - - Args: - date_from: Date from which to start the history - date_to: Date to which to end the history - group: group keyword to filter by - position: position id to filter by - ticket: ticket id to filter by - - Returns: - tuple[TradeDeal, ...]: Deals in the history - """ - return self.deals.history_deals_get( - date_from=date_from, date_to=date_to, group=group, position=position, ticket=ticket - ) - - -BackTestEngine.__doc__ = """The BackTestEngine class is used to simulate trading strategies on historical data. - It can accept already saved data or create new data for backtesting on the fly. Ideally only one instance of - this class should be created per session. By default it is automatically assigned to the global config instance - during instantiation, replacing any existing backtest engine instance. But this is a configurable behaviour. - The start and end time can still be specified even when test data is provided. In that case it will be used - to set the range of the backtest. - - Args: - data (BackTestData, optional): The data to use for backtesting. Defaults to None. - - speed (int, optional): The speed of the backtest. Defaults to 60 seconds. - - start (float | datetime, optional): The start time of the backtest. Defaults to 0. If a float is passed, - it is assumed to be a timestamp. - - end (float | datetime, optional): The end time of the backtest. Defaults to 0. If a float is passed, - it is assumed to be a timestamp. - - restart (bool, optional): Whether to restart the backtest from the beginning. Defaults to True. - This is useful when resuming a backtest using a saved BackTestData instance. - - use_terminal (bool, optional): Whether to use the terminal for backtesting. Defaults to None. If None, - it uses the global config setting. If use terminal is true, the backtest engine will use the terminal to - get price data, compute margins, profit and check order viability. If false, it will use the data - provided in the BackTestData instance and default algorithm for the calculations - - name (str, optional): The name of the backtest. Defaults to "". If not provided, - it is generated from the start and end times. - - stop_time (float | datetime, optional): The time to stop the backtest. Defaults to None. - If a float is passed, it is assumed to be a timestamp. If not given it is assumed to be the end of the backtest range. - - close_open_positions_on_exit (bool, optional): Whether to close all open positions when the backtest - is stopped. Defaults to True. - - preload (bool, optional): Whether to preload the ticks for the backtest. Defaults to True. - - assign_to_config (bool, optional): Whether to assign the backtest engine to the global config instance. - Defaults to True. - - account_info (dict, optional): A dictionary of account information to use for the backtest. Defaults to None. Use this to set - the account information for the backtest. - - Attributes: - _data (BackTestData): The data used for backtesting. This is the data that is saved to disk when the - backtest is stopped. - - mt5 (MetaTrader): The MetaTrader instance for the backtest engine. - - config (Config): The global configuration instance. - - name (str): The name of the backtest. - - stop_testing (bool): Whether to stop the backtest. - - use_terminal (bool): Whether to use the terminal for backtesting. - - close_open_positions_on_exit (bool): Whether to close all open positions when the backtest is stopped. - - stop_time (int): The time to stop the backtest. - - preload (bool): Whether to preload the ticks for the backtest. - - preloaded_ticks (dict): A dictionary of preloaded ticks for the backtest. - - account_lock (RLock): A reentrant lock for the account data. - - account_info (dict): A dictionary of account information for the backtest. - - """ diff --git a/src/aiomql/core/backtesting/get_data.py b/src/aiomql/core/backtesting/get_data.py deleted file mode 100644 index d961d6e..0000000 --- a/src/aiomql/core/backtesting/get_data.py +++ /dev/null @@ -1,267 +0,0 @@ -from dataclasses import dataclass, field, fields -import pickle -from pathlib import Path -from datetime import datetime, UTC -from logging import getLogger -from typing import NamedTuple, Iterable - -import MetaTrader5 -from numpy import ndarray - -from ..meta_trader import MetaTrader -from ..config import Config -from ..constants import TimeFrame -from ..task_queue import TaskQueue, QueueItem -from ...utils import backoff_decorator - -logger = getLogger(__name__) - - -class Cursor(NamedTuple): - """A cursor to iterate over the data. Marks the current position.""" - index: int - time: int - - -@dataclass -class BackTestData: - """The data class to store the backtesting data. - - Attributes: - name (str): The name of the backtest data. - terminal (dict): The terminal information. - version (tuple): The version of the terminal. - account (dict): The account information. - symbols (dict): The symbols information. - ticks (dict): The ticks data. - rates (dict): The rates data. - span (range): The range of the data. - range (range): The range of the data. - orders (dict): The orders data. - deals (dict): The deals data. - positions (dict): The positions data. - open_positions (set): The open positions. - cursor (Cursor): The cursor to iterate over the data. - margins (dict): The margins data. - fully_loaded (bool): A flag to indicate if the data is fully loaded - """ - - name: str = "" - terminal: dict[str, [str | int | bool | float]] = field(default_factory=dict) - version: tuple[int, int, str] = (0, 0, "") - account: dict = field(default_factory=dict) - symbols: dict[str, dict] = field(default_factory=dict) - ticks: dict[str, ndarray] = field(default_factory=dict) - rates: dict[str, dict[int, ndarray]] = field(default_factory=dict) - span: range = range(0) - range: range = range(0) - orders: dict[int, dict] = field(default_factory=lambda: {}) - deals: dict[int, dict] = field(default_factory=lambda: {}) - positions: dict[int, dict] = field(default_factory=lambda: {}) - open_positions: set[int, ...] = field(default_factory=lambda: set()) - cursor: Cursor = None - margins: dict[int, float] = field(default_factory=lambda: {}) - fully_loaded: bool = True - - def __str__(self): - return f"{self.name}" - - def __repr__(self): - return f"{self.__class__.__name__}({self.name})" - - def set_attrs(self, **kwargs): - """Set the attributes of the class on the instance.""" - [setattr(self, k, v) for k, v in kwargs.items() if k in self.fields] - - @property - def fields(self): - """A list of the fields of the class.""" - return [f.name for f in fields(self)] - - -class GetData: - """A class to get the backtesting data from the MetaTrader5 terminal. - - Attributes: - start (datetime): The start date of the data. - end (datetime): The end date of the data. - symbols (Sequence[str]): The symbols to get the data for. - timeframes (Sequence[TimeFrame]): The timeframes to get the data for. - name (str): The name of the backtest data. - range (range): The range of the data. - span (range): The span of the data. - data (BackTestData): The backtesting data. - mt5 (MetaTrader): The MetaTrader5 instance. - task_queue (TaskQueue): The task queue to handle the requests. - """ - - data: BackTestData - - def __init__( - self, *, start: datetime, end: datetime, symbols: Iterable[str], timeframes: Iterable[TimeFrame], name: str = "" - ): - """ - Get the backtesting data from the MetaTrader5 terminal. - - Args: - start (datetime): The start date of the data. - end (datetime): The end date of the data. - symbols (Sequence[str]): The symbols to get the data for. - timeframes (Sequence[TimeFrame]): The timeframes to get the data for. - name (str): The name of the backtest data. - """ - self.config = Config() - self.start = start.astimezone(tz=UTC) - self.end = end.astimezone(tz=UTC) - self.symbols = set(symbols) - self.timeframes = set(timeframes) - self.name = name or f"{start:%d-%m-%y}_{end:%d-%m-%y}" - span_start = int(self.start.timestamp()) - span_end = int(self.end.timestamp()) - self.range = range(0, span_end - span_start) - self.span = range(span_start, span_end) - self.data = BackTestData(name=self.name, span=self.span, range=self.range) - self.mt5 = MetaTrader() - self.task_queue = TaskQueue(workers=500, mode="finite", on_exit="cancel") - - @classmethod - def pickle_data(cls, *, data: BackTestData, name: str | Path): - """Pickle the data to a file. - - Args: - data (BackTestData): The data to pickle. - name (str | Path): The name of the file to pickle the data to. - """ - try: - with open(name, "wb") as fo: - pickle.dump(data, fo, protocol=pickle.HIGHEST_PROTOCOL) - except Exception as err: - logger.error(f"Error in dump_data: {err}") - - @classmethod - def load_data(cls, *, name: str | Path) -> BackTestData: - """Load the data from a file. - - Args: - name (str | Path): The name of the file to load the data from. - """ - try: - with open(name, "rb") as fo: - data = pickle.load(fo) - return data - except Exception as err: - logger.error(f"Error: {err}") - - def save_data(self, *, name: str | Path = ""): - """Save the data to a file. - - Args: - name (str | Path): The name of the file to save the data to. If not provided, the name of the data is used. - """ - name = name or (self.name + ".pkl" if not self.name.endswith(".pkl") else self.name) - name = Path(self.config.backtest_dir) / name if not isinstance(name, Path) else name - with open(name, "wb") as fo: - pickle.dump(self.data, fo, protocol=pickle.HIGHEST_PROTOCOL) - - async def get_data(self, workers: int = None): - """Use the task queue to get the data from the MetaTrader5 terminal. - - Args: - workers (int): The number of workers to use in the task queue. If not provided, the default number of workers - is used. - """ - if workers: - self.task_queue.workers = workers - - q_items = [ - QueueItem(self.get_symbols_rates), - QueueItem(self.get_symbols_ticks), - QueueItem(self.get_symbols_info), - ] - - [self.task_queue.add(item=item, priority=0, must_complete=True) for item in q_items] - - if not self.data.account: - self.task_queue.add(item=QueueItem(self.get_account_info), must_complete=True) - - if not self.data.terminal: - self.task_queue.add(item=QueueItem(self.get_terminal_info), must_complete=True) - - if not self.data.version: - self.task_queue.add(item=QueueItem(self.get_version), must_complete=True) - - await self.task_queue.run() - - if self.data.fully_loaded is False: - logger.warning("Data not fully loaded") - self.data = BackTestData(name=self.name, span=self.span, range=self.range, fully_loaded=False) - - async def get_terminal_info(self): - terminal = await self.mt5.terminal_info() - if terminal is None: - self.data.fully_loaded = False - self.task_queue.stop = True - terminal = terminal._asdict() - self.data.set_attrs(terminal=terminal) - - async def get_version(self): - version = await self.mt5.version() - if version is None: - self.data.fully_loaded = False - self.task_queue.stop = True - self.data.set_attrs(version=version) - - @backoff_decorator - async def get_account_info(self): - res = await self.mt5.account_info() - if res is None: - self.data.fully_loaded = False - self.task_queue.stop = True - res = res._asdict() - self.data.set_attrs(account=res) - - async def get_symbols_info(self): - [ - self.task_queue.add(item=QueueItem(self.get_symbol_info, symbol=symbol)) - for symbol in self.symbols - if self.data.symbols.get(symbol) is None - ] - - async def get_symbols_ticks(self): - [ - self.task_queue.add(item=QueueItem(self.get_symbol_ticks, symbol=symbol)) - for symbol in self.symbols - if self.data.ticks.get(symbol) is None - ] - - async def get_symbols_rates(self): - [ - self.task_queue.add(item=QueueItem(self.get_symbol_rates, symbol=symbol, timeframe=timeframe), priority=4) - for symbol in self.symbols - for timeframe in self.timeframes - if self.data.rates.get(symbol, {}).get(timeframe) is None - ] - - @backoff_decorator - async def get_symbol_info(self, *, symbol: str): - res = await self.mt5.symbol_info(symbol) - if res is None: - self.data.fully_loaded = False - self.task_queue.stop = True - self.data.symbols[symbol] = res._asdict() - - @backoff_decorator - async def get_symbol_ticks(self, *, symbol: str): - res = await self.mt5.copy_ticks_range(symbol, self.start, self.end, MetaTrader5.COPY_TICKS_ALL) - if res is None: - self.data.fully_loaded = False - self.task_queue.stop = True - self.data.ticks[symbol] = res - - @backoff_decorator - async def get_symbol_rates(self, *, symbol: str, timeframe: TimeFrame): - res = await self.mt5.copy_rates_range(symbol, timeframe, self.start, self.end) - if res is None: - self.data.fully_loaded = False - self.task_queue.stop = True - self.data.rates.setdefault(symbol, {})[int(timeframe)] = res diff --git a/src/aiomql/core/backtesting/trades_manager.py b/src/aiomql/core/backtesting/trades_manager.py deleted file mode 100644 index 2f5f2da..0000000 --- a/src/aiomql/core/backtesting/trades_manager.py +++ /dev/null @@ -1,369 +0,0 @@ -from datetime import datetime -from typing import TypeVar, Generic -from logging import getLogger - -from MetaTrader5 import TradePosition, TradeOrder, TradeDeal - -logger = getLogger(__name__) - -TradeData = TypeVar("TradeData", bound=TradePosition | TradeOrder | TradeDeal) - - -class TradeManager(Generic[TradeData]): - """A generic class to manage trades data during a backtest. It is the parent class of the - PositionsManager, OrdersManager, and DealsManager. It implements some dict-like methods to manage the data. - It has a private attribute _data to store the data. It exposes the data through the values, keys, and items methods. - It also has a to_dict method to convert the data to a dictionary. - - Attributes: - _data (dict[int, TradeData]): The data to store the trades. - - Examples: - >>> manager = TradeManager() - >>> manager[123456] = TradePosition(ticket=123456, symbol="EURUSD", volume=0.1) - >>> manager.update(ticket=123456, symbol="EURUSD", volume=0.1) - >>> manager[123456] - TradePosition(ticket=123456, symbol='EURUSD', volume=0.1) - >>> manager.values() - (TradePosition(ticket=123456, symbol='EURUSD', volume=0.1),) - >>> manager.keys() - (123456,) - >>> manager.items() - ((123456, TradePosition(ticket=123456, symbol='EURUSD', volume=0.1)),) - >>> manager.to_dict() - {123456: {'ticket': 123456, 'symbol': 'EURUSD', 'volume': 0.1}} - >>> pos = manager.get(123456) - >>> pos - TradePosition(ticket=123456, symbol='EURUSD', volume=0.1) - >>> pos in manager - True - >>> len(manager) - 1 - >>> pos in manager - False - """ - - _data: dict[int, TradeData] - - def __init__(self, *, data: dict = None): - self._data = data or {} - - def __iter__(self): - return iter(self._data) - - def __len__(self): - return len(self._data) - - def __contains__(self, item: TradeData): - return item.ticket in self._data - - def __getitem__(self, item): - return self._data[item] - - def __setitem__(self, key, value: TradeData): - self._data[key] = value - - def __delitem__(self, key): - del self._data[key] - - def get(self, key, default=None) -> TradeData | None: - return self._data.get(key, default) - - def update(self, *, ticket: int, **kwargs): - """Update the data of a trade. Given the ticket of the trade and the new data to update. - - Args: - ticket (int): The ticket of the trade to update. - **kwargs: The new data to update. - """ - try: - res = self[ticket] - klass = type(res) - res = res._asdict() - res.update(**kwargs) - res = klass(res.get(v) for v in klass.__match_args__) - self[res.ticket] = res - return res - except KeyError: - logger.error(f"Update Operation Failed: Could Not Find Ticket") - - def values(self) -> tuple[TradeData, ...]: - """Returns the values of the data.""" - return tuple(value for value in self._data.values()) - - def keys(self) -> tuple[int, ...]: - """Returns the keys of the data.""" - return tuple(key for key in self._data.keys()) - - def items(self) -> tuple[tuple[int, TradeData], ...]: - """Returns the items of the data.""" - return tuple((key, value) for key, value in self._data.items()) - - def to_dict(self): - """Convert the data to a dictionary.""" - return {key: value._asdict() for key, value in self._data.items()} - - -class PositionsManager(TradeManager): - """A class to manage the open positions during a backtest. It is a subclass of TradeManager. It has an additional - attribute _open_positions to store the open positions. It also has a margins attribute to store the margins of the - open positions. It overrides some methods of the TradeManager class to manage the open positions. - - Attributes: - _open_positions (set[int]): The open positions. - margins (dict[int, float]): The margins of the open positions. - """ - - _data: dict[int, TradePosition] - _open_positions: set[int] - margins: dict[int, float] - - def __init__(self, *, data: dict = None, open_positions: set[int] = None, margins: dict = None): - """Positions manager manages the open positions during a backtest. It is a subclass of TradeManager. It has an - additional attribute _open_positions to store the open positions. It also has a margins attribute to store the - margins of the open positions. It overrides some methods of the TradeManager class to manage the open positions. - - Args: - data (dict, optional): The data to store the trades. This used for continuation of the backtesting, if it - was stopped with some open positions. - - open_positions (set, optional): The open positions. Defaults to None. - - margins (dict, optional): The margins of the open positions. Defaults to None. - """ - super().__init__(data=data) - self._open_positions = open_positions or {trade.ticket for trade in self._data.values()} - self.margins: dict[int, float] = margins or dict() - - def __len__(self): - return len(self._open_positions) - - def __contains__(self, item: TradePosition): - return item.ticket in self._open_positions - - def __getitem__(self, item): - if item in self._open_positions: - return super().__getitem__(item) - raise KeyError("Position not found") - - def __setitem__(self, key, value: TradeData): - self._open_positions.add(value.ticket) - self._data[key] = value - - def __delitem__(self, key): - self._open_positions.discard(key) - del self._data[key] - - @property - def margin(self): - """Returns the total margin of all open positions""" - return sum(self.margins.values()) - - def close(self, *, ticket: int) -> bool: - """Close a position. Given the ticket of the position to close. - - Args: - ticket (int): The ticket of the position to close. - """ - is_open = ticket in self._open_positions - self._open_positions.discard(ticket) - return is_open - - def get_margin(self, *, ticket: int) -> float: - """Get the margin of a position. Given the ticket of the position. - - Args: - ticket (int): The ticket of the position. - - Returns: - float: The margin of the position. - """ - return self.margins.get(ticket, 0.0) - - def delete_margin(self, *, ticket: int): - """Delete the margin of a position. Given the ticket of the position. - - Args: - ticket (int): The ticket of the position. - """ - return self.margins.pop(ticket, 0) - - def set_margin(self, *, ticket: int, margin: float): - """Set the margin of a position. Given the ticket of the position and the margin. - - Args: - ticket (int): The ticket of the position. - margin (float): The margin of the position - """ - self.margins[ticket] = margin - - def positions_get(self, *, ticket: int = None, symbol: str = None, group: None = None) -> tuple[TradePosition, ...]: - """Get positions. Given the ticket, symbol, or group of the positions. - - Args: - ticket (int): The ticket of the position. - symbol (str): The symbol of the position. - group (str): The group - - Returns: - tuple[TradePosition, ...]: The positions - """ - if ticket: - return tuple(position for position in self.open_positions if position.ticket == ticket) - - if symbol: - return tuple(position for position in self.open_positions if position.symbol == symbol) - - if group: - return self.open_positions - - if ticket == group == symbol is None: - return self.open_positions - - return tuple() - - def positions_total(self) -> int: - """Get the total number of open positions. - - Returns: - int: The total number of open positions. - """ - return len(self._open_positions) - - @property - def open_positions(self) -> tuple[TradePosition, ...]: - """Returns the open positions. - - Args: - tuple[TradePosition, ...]: The open positions. - """ - return tuple(position for position in self.values() if position.ticket in self._open_positions) - - -class OrdersManager(TradeManager): - """Managers orders data during a backtest. It is a subclass of TradeManager. It manages access to the historical - orders data - """ - - _data = dict[int, TradeOrder] - - def get_orders_range(self, *, date_from: float, date_to: float) -> tuple[TradeData, ...]: - """Get orders within a date range. Given the start and end date of the range. - - Args: - date_from (float): The start date of the range. - date_to (float): The end date of the range. - - Returns: - tuple[TradeData, ...]: The orders within the date range. - """ - start = date_from.timestamp() if isinstance(date_from, datetime) else date_from - end = date_to.timestamp() if isinstance(date_to, datetime) else date_to - return tuple(order for order in self.values() if start <= order.time_setup <= end) - - def history_orders_get( - self, - *, - date_from: float | datetime = None, - date_to: float | datetime = None, - group: str = "", - ticket: int = None, - position: int = None, - ) -> tuple[TradeOrder, ...]: - """Get historical orders. Given the start and end date of the range, the group, ticket, or position of the - orders. - - Args: - date_from (float, datetime): The start date of the range. - date_to (float, datetime): The end date of the range. - group (str): The group of the orders. - ticket (int): The ticket of the order. - position (int): The position of the order. - - Returns: - tuple[TradeOrder, ...]: The historical orders. - """ - if date_from and date_to: - orders = self.get_orders_range(date_from=date_from, date_to=date_to) - if group: - orders = orders - return orders - - if ticket: - return tuple(order for order in self.values() if order.ticket == ticket) - - if position: - return tuple(order for order in self.values() if order.position_id == position) - - return () - - def history_orders_total(self, *, date_from: datetime | float, date_to: datetime | float) -> int: - """Get the total number of historical orders. Given the start and end date of the range. - - Args: - date_from (datetime, float): The start date of the range. - date_to (datetime, float): The end date of the range. - """ - return len(self.get_orders_range(date_from=date_from, date_to=date_to)) - - -class DealsManager(TradeManager): - _data = dict[int, TradeDeal] - - def get_deals_range(self, *, date_from: float, date_to: float) -> tuple[TradeData, ...]: - """Get deals within a date range. Given the start and end date of the range. - - Args: - date_from (float): The start date of the range. - date_to (float): The end date of the range. - - Returns: - tuple[TradeData, ...]: The deals within the date range. - """ - start = date_from.timestamp() if isinstance(date_from, datetime) else date_from - end = date_to.timestamp() if isinstance(date_to, datetime) else date_to - return tuple(deal for deal in self.values() if start <= deal.time <= end) - - def history_deals_get( - self, - *, - date_from: float | datetime = None, - date_to: float | datetime = None, - group: str = "", - ticket: int = None, - position: int = None, - ) -> tuple[TradeDeal, ...]: - """History deals get. Given the start and end date of the range, the group, ticket, or position of the deals. - - Args: - date_from (float, datetime): The start date of the range. - date_to (float, datetime): The end date of the range. - group (str): The group of the deals. - ticket (int): The ticket of the deal. - position (int): The position of the deal. - """ - if date_from and date_to: - deals = self.get_deals_range(date_from=date_from, date_to=date_to) - if group: - deals = deals - return deals - - if ticket: - return tuple(deal for deal in self.values() if deal.ticket == ticket) - - if position and (ticket is None): - return tuple(deal for deal in self.values() if deal.position_id == position) - - return () - - def history_deals_total(self, *, date_from: datetime | float, date_to: datetime | float) -> int: - """Get the total number of historical deals. Given the start and end date of the range - - Args: - date_from (datetime, float): The start date of the range. - date_to (datetime, float): The end date of the range. - - Returns: - int: The total number of historical deals. - """ - return len(self.get_deals_range(date_from=date_from, date_to=date_to)) diff --git a/src/aiomql/core/base.py b/src/aiomql/core/base.py index 994080d..d45a9c2 100644 --- a/src/aiomql/core/base.py +++ b/src/aiomql/core/base.py @@ -29,7 +29,6 @@ from functools import cache from .config import Config from .meta_trader import MetaTrader from .sync.meta_trader import MetaTrader as MetaTraderSync -from .meta_backtester import MetaBackTester logger = getLogger(__name__) @@ -48,7 +47,7 @@ class BaseMeta(type): if 'config' not in cls.__dict__: cls.config = Config() if 'mt5' not in cls.__dict__: - cls.mt5 = (MetaTrader() if cls.__dict__.get("mode", "") != "sync" else MetaTraderSync()) if cls.config.mode != "backtest" else MetaBackTester() + cls.mt5 = MetaTrader() if cls.__dict__.get("mode", "") != "sync" else MetaTraderSync() class Base: @@ -194,19 +193,17 @@ class _Base(Base, metaclass=BaseMeta): """Extended base class with MetaTrader and Config integration. Provides automatic access to the MetaTrader terminal and configuration - settings. Automatically switches between MetaTrader and MetaBackTester - based on the configured mode. + settings. Attributes: - mt5 (MetaTrader | MetaBackTester): The MetaTrader interface. Uses - MetaBackTester when in backtest mode. + mt5 (MetaTrader): The MetaTrader interface. config (Config): The global configuration instance. Note: The mt5 attribute is excluded from serialization via __getstate__ to prevent issues when pickling instances. """ - mt5: MetaTrader | MetaBackTester | MetaTraderSync + mt5: MetaTrader | MetaTraderSync config: Config mode: Literal["async", "sync"] = "async" diff --git a/src/aiomql/core/config.py b/src/aiomql/core/config.py index c02873a..3f4ea4e 100644 --- a/src/aiomql/core/config.py +++ b/src/aiomql/core/config.py @@ -26,7 +26,6 @@ Example: print(config.login) print(config.server) """ - import os import json from pathlib import Path @@ -41,9 +40,6 @@ from .store import Store logger = getLogger(__name__) Bot = TypeVar("Bot") -BackTestEngine = TypeVar("BackTestEngine") -BackTestController = TypeVar("BackTestController") - class Config: """A singleton class for handling configuration settings for the aiomql package. @@ -71,9 +67,6 @@ class Config: records_dir (Path): The directory to store trade records. records_dir_name (str): The name of the trade records directory. Defaults to 'trade_records'. - backtest_dir (Path): The directory to store backtest results. - backtest_dir_name (str): The name of the backtest directory. - Defaults to 'backtesting'. plots_dir (Path): The directory to store plot files. plots_dir_name (str): The name of the plots directory. Defaults to 'plots'. @@ -84,10 +77,6 @@ class Config: store (Store): A key-value database store for general data persistence. task_queue (TaskQueue): The TaskQueue object for handling background tasks. bot (Bot): The bot instance associated with this configuration. - backtest_controller (BackTestController): The backtest controller instance. - mode (Literal["backtest", "live"]): The trading mode. Defaults to 'live'. - use_terminal_for_backtesting (bool): Whether to use the terminal for - backtesting. Defaults to True. shutdown (bool): A signal to gracefully shut down the bot. Defaults to False. force_shutdown (bool): A signal to forcefully shut down the bot. @@ -102,7 +91,6 @@ class Config: Defaults to False. lock (Lock): A threading lock for thread-safe operations. """ - login: int trade_record_mode: Literal["csv", "json", "sql"] password: str @@ -117,19 +105,14 @@ class Config: record_trades: bool records_dir: Path plots_dir: Path - backtest_dir: Path records_dir_name: str plots_dir_name: str - backtest_dir_name: str db_dir_name: str db_name: str | Path task_queue: TaskQueue - _backtest_engine: BackTestEngine bot: Bot - backtest_controller: BackTestController _instance: Self - mode: Literal["backtest", "live"] - use_terminal_for_backtesting: bool + mode: Literal["live"] shutdown: bool force_shutdown: bool db_commit_interval: float @@ -142,13 +125,11 @@ class Config: "timeout": 60000, "record_trades": True, "records_dir_name": "trade_records", - "backtest_dir_name": "backtesting", "db_dir_name": "db", "config_file": None, "trade_record_mode": "sql", "mode": "live", "filename": "aiomql.json", - "use_terminal_for_backtesting": True, "db_name": "", "path": "", "login": None, @@ -172,9 +153,7 @@ class Config: cls._instance = super().__new__(cls) cls._instance.task_queue = TaskQueue(mode='infinite') cls._instance.set_attributes(**cls._defaults) - cls._instance._backtest_engine = None cls._instance.bot = None - cls._instance.backtest_controller = None return cls._instance def __init__(self, **kwargs): @@ -204,16 +183,6 @@ class Config: super().__setattr__(name, value) setattr(self.__class__, name, value) - @property - def backtest_engine(self): - """Returns the backtest engine object""" - return self._backtest_engine - - @backtest_engine.setter - def backtest_engine(self, value: BackTestEngine): - """Set the backtest engine object""" - self._backtest_engine = value - def set_attributes(self, **kwargs): """Set keyword arguments as object attributes. The root folder attribute can't be set here. @@ -406,19 +375,6 @@ class Config: rec_dir.mkdir(parents=True, exist_ok=True) if rec_dir.exists() is False else ... return rec_dir - @cached_property - def backtest_dir(self) -> Path: - """Returns the directory path for storing backtest results. - - Creates the directory if it doesn't exist. - - Returns: - Path: The path to the backtest results directory. - """ - b_dir = self.root / self.backtest_dir_name - b_dir.mkdir(parents=True, exist_ok=True) if b_dir.exists() is False else ... - return b_dir - @cached_property def plots_dir(self): """Returns the directory path for storing plot files. diff --git a/src/aiomql/core/constants.py b/src/aiomql/core/constants.py index 7221c69..9fe8ba2 100644 --- a/src/aiomql/core/constants.py +++ b/src/aiomql/core/constants.py @@ -49,7 +49,7 @@ class Repr: MY_ENUM_VALUE """ - __enum_name__ = "" + __enum_name__: str = "" name: str def __str__(self): diff --git a/src/aiomql/core/errors.py b/src/aiomql/core/errors.py index c34b3ee..d960fb3 100644 --- a/src/aiomql/core/errors.py +++ b/src/aiomql/core/errors.py @@ -1,5 +1,27 @@ +"""MetaTrader5 error handling for the aiomql package. + +This module provides the Error class for representing and inspecting +errors returned by the MetaTrader5 terminal. + +Classes: + Error: Wraps an MT5 error code with a human-readable description. +""" + + class Error: - """Error class for handling errors""" + """Represents an error returned by the MetaTrader5 terminal. + + Wraps a numeric error code with a human-readable description and + provides helper methods for inspecting the error category. + + Attributes: + code (int): The numeric error code. + description (str): Human-readable description of the error. + descriptions (dict[int, str]): Mapping of known error codes to + their descriptions. + conn_errors (tuple[int, ...]): Error codes that indicate a + connection-level failure. + """ descriptions = { # common errors @@ -24,11 +46,29 @@ class Error: conn_errors = (-10000, -10001, -10002, -10003, -10004, -10005, -6) def __init__(self, code: int = 1, description: str = ""): + """Initializes an Error instance. + + Args: + code: The numeric error code. Defaults to 1 (successful). + description: Optional override description. If empty, the + description is looked up from ``descriptions``. + """ self.code = code self.description = self.descriptions.get(code, description or "unknown error") def is_connection_error(self): + """Checks whether this error indicates a connection failure. + + Returns: + bool: True if the error code is in ``conn_errors``. + """ return self.code in self.conn_errors def __repr__(self): + """Returns a string representation of the error. + + Returns: + str: Formatted as ``"code: description"``. + """ return f"{self.code}: {self.description}" + diff --git a/src/aiomql/core/meta_backtester.py b/src/aiomql/core/meta_backtester.py deleted file mode 100644 index 827fd27..0000000 --- a/src/aiomql/core/meta_backtester.py +++ /dev/null @@ -1,274 +0,0 @@ -from datetime import datetime -from logging import getLogger -from typing import Literal, TypeVar - -from numpy import ndarray -from MetaTrader5 import ( - Tick, - SymbolInfo, - AccountInfo, - TerminalInfo, - TradeOrder, - TradePosition, - TradeDeal, - OrderCheckResult, - OrderSendResult, -) - -from .meta_trader import MetaTrader -from .constants import TimeFrame, CopyTicks, OrderType -from ..utils import error_handler - -logger = getLogger(__name__) - -BackTestEngine = TypeVar("BackTestEngine") - - -class MetaBackTester(MetaTrader): - """A class for testing trading strategies in the MetaTrader 5 terminal. A subclass of MetaTrader. - - Attributes: - backtest_engine (BackTestEngine): The backtesting engine to use for testing trading strategies. - """ - - backtest_engine: BackTestEngine - - def __init__(self, *, backtest_engine: BackTestEngine = None): - super().__init__() - self.backtest_engine = backtest_engine - - @property - def backtest_engine(self) -> BackTestEngine: - return self.config.backtest_engine - - @backtest_engine.setter - def backtest_engine(self, value: BackTestEngine): - if value is not None: - self.config.backtest_engine = value - - async def last_error(self) -> tuple[int, str]: - if self.config.use_terminal_for_backtesting is False: - return -1, "" - else: - return await super().last_error() - - async def initialize( - self, - *, - path: str = "", - login: int = 0, - password: str = "", - server: str = "", - timeout: int | None = None, - portable=False, - ) -> bool: - if self.config.use_terminal_for_backtesting: - return await super().initialize(path=path, login=login, password=password, server=server, timeout=timeout) - - return True - - def initialize_sync( - self, - *, - path: str = "", - login: int = 0, - password: str = "", - server: str = "", - timeout: int | None = None, - portable=False, - ) -> bool: - if self.config.use_terminal_for_backtesting: - return super().initialize_sync(path=path, login=login, password=password, server=server, timeout=timeout) - - return True - - def login_sync(self, *, login: int = 0, password: str = "", server: str = "", timeout: int = 60000) -> bool: - if self.config.use_terminal_for_backtesting: - return super().login_sync(login=login, password=password, server=server, timeout=timeout) - return True - - def _symbol_select(self, symbol: str, enable: bool) -> bool: - return self.backtest_engine.symbol_select_sync(symbol=symbol, enable=enable) - - def _market_book_add(self, symbol: str) -> bool: - return True - - async def market_book_add(self, symbol: str) -> bool: - return True - - async def login(self, *, login: int = 0, password: str = "", server: str = "", timeout: int = 60000) -> bool: - if self.config.use_terminal_for_backtesting: - return await super().login(login=login, password=password, server=server, timeout=timeout) - return True - - async def shutdown(self) -> None: - await super().shutdown() if self.config.use_terminal_for_backtesting else ... - - @error_handler(msg="test data not available", exe=AttributeError) - async def terminal_info(self) -> TerminalInfo: - res = await self.backtest_engine.get_terminal_info() - return res - - @error_handler(msg="test data not available", exe=AttributeError) - async def account_info(self) -> AccountInfo: - """""" - return self.backtest_engine.get_account_info() - - @error_handler(msg="test data not available", exe=AttributeError) - async def symbols_total(self) -> int: - tot = await self.backtest_engine.get_symbols_total() - return tot - - @error_handler(msg="test data not available", exe=AttributeError) - async def symbols_get(self, group: str = "") -> tuple[SymbolInfo, ...] | None: - """""" - syms = await self.backtest_engine.get_symbols(group=group) - return syms - - @error_handler(msg="test data not available") - async def symbol_info(self, symbol: str) -> SymbolInfo | None: - sym = await self.backtest_engine.get_symbol_info(symbol=symbol) - return sym - - def _symbol_info(self, symbol) -> SymbolInfo | None: - return self.backtest_engine.symbol_info_sync(symbol=symbol) - - def _symbol_info_tick(self, symbol) -> Tick | None: - return self.backtest_engine.symbol_info_tick_sync(symbol=symbol) - - @error_handler(msg="test data not available") - async def symbol_info_tick(self, symbol: str) -> Tick | None: - tick = await self.backtest_engine.get_symbol_info_tick(symbol=symbol) - return tick - - @error_handler(msg="test data not available", exe=AttributeError) - async def copy_rates_from( - self, symbol: str, timeframe: TimeFrame, date_from: datetime | float, count: int - ) -> ndarray | None: - rates = await self.backtest_engine.get_rates_from( - symbol=symbol, timeframe=timeframe, date_from=date_from, count=count - ) - return rates - - @error_handler(msg="test data not available", exe=AttributeError) - async def copy_rates_from_pos( - self, symbol: str, timeframe: TimeFrame, start_pos: int, count: int - ) -> ndarray | None: - rates = await self.backtest_engine.get_rates_from_pos( - symbol=symbol, timeframe=timeframe, start_pos=start_pos, count=count - ) - return rates - - @error_handler(msg="test data not available", exe=AttributeError) - async def copy_rates_range( - self, symbol: str, timeframe: TimeFrame, date_from: datetime | float, date_to: datetime | float - ) -> ndarray | None: - rates = await self.backtest_engine.get_rates_range( - symbol=symbol, timeframe=timeframe, date_from=date_from, date_to=date_to - ) - return rates - - @error_handler(msg="test data not available", exe=AttributeError) - async def copy_ticks_from( - self, symbol: str, date_from: datetime | float, count: int, flags: CopyTicks - ) -> ndarray | None: - ticks = await self.backtest_engine.get_ticks_from(symbol=symbol, date_from=date_from, count=count, flags=flags) - return ticks - - @error_handler(msg="test data not available", exe=AttributeError) - async def copy_ticks_range( - self, symbol: str, date_from: datetime | float, date_to: datetime | float, flags: CopyTicks - ) -> ndarray | None: - ticks = await self.backtest_engine.get_ticks_range( - symbol=symbol, date_from=date_from, date_to=date_to, flags=flags - ) - return ticks - - @error_handler(msg="test data not available", exe=AttributeError) - async def orders_total(self) -> int: - return self.backtest_engine.get_orders_total() - - @error_handler(msg="test data not available", exe=AttributeError) - async def orders_get(self, group: str = "", ticket: int = 0, symbol: str = "") -> tuple[TradeOrder, ...] | None: - kwargs = {key: value for key, value in (("group", group), ("ticket", ticket), ("symbol", symbol)) if value} - return self.backtest_engine.get_orders(**kwargs) - - @error_handler(msg="test data not available", exe=AttributeError) - async def order_calc_margin(self, action: OrderType, symbol: str, volume: float, price: float) -> float | None: - res = await self.backtest_engine.order_calc_margin(action=action, symbol=symbol, volume=volume, price=price) - return res - - @error_handler(msg="test data not available", exe=AttributeError) - async def order_calc_profit( - self, action: Literal[0, 1], symbol: str, volume: float, price_open: float, price_close: float - ) -> float | None: - profit = await self.backtest_engine.order_calc_profit( - action=action, symbol=symbol, volume=volume, price_open=price_open, price_close=price_close - ) - return profit - - @error_handler(msg="test data not available", exe=AttributeError) - async def order_check(self, request: dict) -> OrderCheckResult: - ocr = await self.backtest_engine.order_check(request=request) - return ocr - - async def order_send(self, request: dict) -> OrderSendResult: - osr = await self.backtest_engine.order_send(request=request) - return osr - - @error_handler(msg="test data not available", exe=AttributeError) - async def positions_total(self) -> int: - return self.backtest_engine.get_positions_total() - - @error_handler(msg="test data not available", exe=AttributeError) - async def positions_get( - self, group: str = "", ticket: int = None, symbol: str = "" - ) -> tuple[TradePosition, ...] | None: - kwargs = {key: value for key, value in (("group", group), ("ticket", ticket), ("symbol", symbol)) if value} - return self.backtest_engine.get_positions(**kwargs) - - @error_handler(msg="test data not available", exe=AttributeError) - async def history_orders_total(self, date_from: datetime | float, date_to: datetime | float) -> int | None: - return self.backtest_engine.get_history_orders_total(date_from=date_from, date_to=date_to) - - @error_handler(msg="test data not available", exe=AttributeError) - async def history_orders_get( - self, - date_from: datetime | float = None, - date_to: datetime | float = None, - group: str = "", - ticket: int = None, - position: int = None, - ) -> tuple[TradeOrder, ...] | None: - args = ( - ("date_from", date_from), - ("date_to", date_to), - ("group", group), - ("ticket", ticket), - ("position", position), - ) - kwargs = {key: value for key, value in args if value} - return self.backtest_engine.get_history_orders(**kwargs) - - @error_handler(msg="test data not available", exe=AttributeError) - async def history_deals_total(self, date_from: datetime | float, date_to: datetime | float) -> int | None: - return self.backtest_engine.get_history_deals_total(date_from=date_from, date_to=date_to) - - @error_handler(msg="test data not available", exe=AttributeError) - async def history_deals_get( - self, - date_from: datetime | float = None, - date_to: datetime | float = None, - group: str = "", - ticket: int = None, - position: int = None, - ) -> tuple[TradeDeal, ...] | None: - args = ( - ("date_from", date_from), - ("date_to", date_to), - ("group", group), - ("ticket", ticket), - ("position", position), - ) - kwargs = {key: value for key, value in args if value} - return self.backtest_engine.get_history_deals(**kwargs) diff --git a/src/aiomql/core/meta_trader.py b/src/aiomql/core/meta_trader.py index f275a30..a3f7eac 100644 --- a/src/aiomql/core/meta_trader.py +++ b/src/aiomql/core/meta_trader.py @@ -1,3 +1,14 @@ +"""Asynchronous MetaTrader5 interface for the aiomql package. + +This module provides the ``MetaTrader`` class, which wraps every +MetaTrader5 API call in an async-friendly interface using +``asyncio.to_thread``. It adds automatic retry logic for connection +errors and integrates with the global ``Config`` singleton. + +Classes: + MetaTrader: Async wrapper around the MetaTrader5 terminal API. +""" + import asyncio from datetime import datetime from logging import getLogger @@ -27,15 +38,29 @@ from .config import Config logger = getLogger() class MetaTrader(MetaCore): + """Asynchronous interface to the MetaTrader5 terminal. + + Wraps every MetaTrader5 API function with async execution via + ``asyncio.to_thread`` and provides automatic reconnection on + transient connection errors. + + Attributes: + error (Error): The most recent error from an API call. + config (Config): The global configuration singleton. + """ + def __new__(cls, *args, **kwargs): + """Creates a new MetaTrader instance, initializing Config if needed.""" if not hasattr(cls, "config"): cls.config = Config() return super().__new__(cls) def __init__(self): + """Initializes the MetaTrader instance with a default success error and an async lock.""" self.error: Error = Error(code=1) self._lock = asyncio.Lock() + async def __aenter__(self) -> Self: """ Async context manager entry point. diff --git a/src/aiomql/core/models.py b/src/aiomql/core/models.py index 55cb558..67adf94 100644 --- a/src/aiomql/core/models.py +++ b/src/aiomql/core/models.py @@ -1,3 +1,22 @@ +"""Data models for MetaTrader5 objects used throughout the aiomql library. + +This module defines data-model classes that mirror the structures returned +by the MetaTrader5 terminal. They serve as base classes for higher-level +wrappers that add trading logic. + +Classes: + AccountInfo: Trading account details. + TerminalInfo: Terminal configuration and state. + SymbolInfo: Financial instrument properties. + BookInfo: Market-depth entry. + TradeOrder: Active pending order. + TradeRequest: Parameters for a trade operation. + OrderCheckResult: Result of an order validation check. + OrderSendResult: Result of a sent trade request. + TradePosition: Open position details. + TradeDeal: Historical deal record. +""" + import MetaTrader5 as mt5 from .constants import ( @@ -27,11 +46,6 @@ from .constants import ( from .base import Base -""" -This module contains data models used in this library. -They are used as base classes to other classes having the same properties but with more methods. -""" - class AccountInfo(Base): """Account Information Class. @@ -354,17 +368,39 @@ class SymbolInfo(Base): name: str = "" def __repr__(self): + """Returns a concise string representation showing the symbol name. + + Returns: + str: Formatted as ``"SymbolInfo(name=)"``. + """ return "%(class)s(name=%(name)s)" % {"class": self.__class__.__name__, "name": self.name} def __str__(self): + """Returns the symbol name as a string. + + Returns: + str: The symbol name. + """ return self.name def __eq__(self, other: "SymbolInfo"): + """Checks equality based on symbol name. + + Args: + other: Another SymbolInfo instance to compare against. + + Returns: + bool: True if both symbols have the same name. + """ return self.name == other.name def __hash__(self): + """Returns a hash based on the symbol name. + + Returns: + int: Hash of the symbol name string. + """ return hash(self.name) - # return hash(id(self)) class BookInfo(Base): @@ -523,11 +559,27 @@ class OrderCheckResult(Base): self.request = TradeRequest(**req) def __getstate__(self): + """Prepares instance state for pickling. + + Converts the ``request`` attribute from a TradeRequest object + to a plain dictionary so it can be serialized. + + Returns: + dict: The instance state with ``request`` as a dict. + """ state = self.__dict__.copy() state["request"] = state.pop('request').dict return state def __setstate__(self, state): + """Restores instance state from a pickled dictionary. + + Converts the ``request`` dictionary back into a TradeRequest + object. + + Args: + state: The pickled state dictionary. + """ state['request'] = TradeRequest(**state['request']) self.__dict__.update(state) @@ -578,11 +630,27 @@ class OrderSendResult(Base): self.request = TradeRequest(**req) def __getstate__(self): + """Prepares instance state for pickling. + + Converts the ``request`` attribute from a TradeRequest object + to a plain dictionary so it can be serialized. + + Returns: + dict: The instance state with ``request`` as a dict. + """ state = self.__dict__.copy() state["request"] = state.pop('request').dict return state def __setstate__(self, state): + """Restores instance state from a pickled dictionary. + + Converts the ``request`` dictionary back into a TradeRequest + object. + + Args: + state: The pickled state dictionary. + """ state['request'] = TradeRequest(**state['request']) self.__dict__.update(state) diff --git a/src/aiomql/core/utils.py b/src/aiomql/core/utils.py index 7771e50..0deb783 100644 --- a/src/aiomql/core/utils.py +++ b/src/aiomql/core/utils.py @@ -1,15 +1,13 @@ """Utility functions for the aiomql trading library. This module provides utility functions for common operations such as sleeping -(with backtest support), automatic database commits, and other helper functions +automatic database commits, and other helper functions used throughout the library. Functions: auto_commit: Automatically commits state changes to the database. - sleep: Async sleep that works in both live and backtest modes. - sleep_sync: Synchronous sleep that works in both live and backtest modes. - backtest_sleep: Async sleep for backtest mode using simulated time. - backtest_sleep_sync: Sync sleep for backtest mode using simulated time. + sleep: Async sleep that works in both live. + sleep_sync: Synchronous sleep that works in both live. Example: Using sleep in a trading bot:: @@ -17,7 +15,6 @@ Example: from aiomql.core.utils import sleep async def my_strategy(): - # This works in both live and backtest modes await sleep(60) # Wait 60 seconds """ @@ -51,68 +48,25 @@ async def auto_commit(): logger.error("%s: Error occurred in auto_commit", err) -async def backtest_sleep(secs): - """Async sleep function for use during backtesting. - - Uses the backtest engine's simulated time cursor instead of real time, - allowing backtests to run faster than real-time. - - Args: - secs: Number of simulated seconds to sleep. - """ - config = Config() - secs = config.backtest_engine.cursor.time + secs - while secs > config.backtest_engine.cursor.time: - await asyncio.sleep(0) - - async def sleep(secs): - """Async sleep that works in both live and backtest modes. - - Automatically uses the appropriate sleep mechanism based on the - current trading mode (live or backtest). - + """Async sleep that works in live mode. Args: secs: Number of seconds to sleep. Example: >>> await sleep(5) # Sleeps 5 seconds (real or simulated) """ - if Config.mode == "backtest": - await backtest_sleep(secs) - else: - await asyncio.sleep(secs) + await asyncio.sleep(secs) def sleep_sync(secs): - """Synchronous sleep that works in both live and backtest modes. + """Synchronous sleep that works in live mode. Automatically uses the appropriate sleep mechanism based on the - current trading mode (live or backtest). - Args: secs: Number of seconds to sleep. Example: >>> sleep_sync(5) # Sleeps 5 seconds (real or simulated) """ - if Config.mode == "backtest": - backtest_sleep_sync(secs) - else: - time.sleep(secs) - - -def backtest_sleep_sync(secs): - """Synchronous sleep function for use during backtesting. - - Uses the backtest engine's simulated time cursor instead of real time, - allowing backtests to run faster than real-time. - - Args: - secs: Number of simulated seconds to sleep. - """ - config = Config() - secs = config.backtest_engine.cursor.time + secs - while secs > config.backtest_engine.cursor.time: - time.sleep(0) - + time.sleep(secs) diff --git a/src/aiomql/lib/__init__.py b/src/aiomql/lib/__init__.py index fab940d..e0d9c70 100644 --- a/src/aiomql/lib/__init__.py +++ b/src/aiomql/lib/__init__.py @@ -14,5 +14,4 @@ from .strategy import Strategy from .sessions import Sessions, Session from .trade_records import TradeRecords from .terminal import Terminal -from .backtester import BackTester from .result_db import ResultDB diff --git a/src/aiomql/lib/backtester.py b/src/aiomql/lib/backtester.py deleted file mode 100644 index 023a62e..0000000 --- a/src/aiomql/lib/backtester.py +++ /dev/null @@ -1,200 +0,0 @@ -"""BackTester module for strategy backtesting. - -This module provides the BackTester class for running trading strategies -against historical data using the backtest engine. It coordinates -strategy execution, account simulation, and result collection. - -Example: - Running a backtest:: - - from aiomql import BackTester, BackTestEngine - engine = BackTestEngine(...) - backtester = BackTester(backtest_engine=engine) - backtester.add_strategy(strategy=my_strategy) - backtester.execute() -""" - -import asyncio -import logging -import time -from typing import Type, Iterable, Callable, Coroutine - -from .executor import Executor -from ..core.config import Config -from ..core.backtesting.backtest_controller import BackTestController -from ..core.meta_backtester import MetaBackTester -from ..core.backtesting.backtest_engine import BackTestEngine -from .symbol import Symbol as Symbol -from .strategy import Strategy as Strategy - -logger = logging.getLogger(__name__) - - -class BackTester: - """The bot class. Create a bot instance to run your strategies. - - Attributes: - executor: The default thread executor. - config (Config): Config instance - mt (MetaBackTester): MetaTrader instance - """ - - config: Config - executor: Executor - mt: MetaBackTester - backtest_engine: BackTestEngine - backtest_controller: BackTestController - strategies: list[Strategy] - - def __init__(self, *, backtest_engine: BackTestEngine): - self.config = Config() - self.executor = Executor() - self.mt = MetaBackTester() - self.backtest_engine = backtest_engine - self.backtest_controller = BackTestController() - self.strategies = [] - - def initialize_sync(self): - """Prepares the bot by signing in to the trading account and initializing the symbols for the trading session. - Starts the global task queue. - - Raises: - SystemExit if sign in was not successful - """ - try: - self.mt.initialize_sync() - login = self.mt.login_sync() - if not login: - logger.critical(f"Unable to sign in to MetaTrder 5 Terminal") - raise Exception("Unable to sign in to MetaTrader 5 Terminal") - logger.info("Login Successful") - self.backtest_engine.setup_account_sync() - self.init_strategies_sync() - if (strategies := len(self.executor.strategy_runners)) == 0: - self.config.shutdown = True - logger.warning("No strategies were added to the backtester. Exiting in one second") - time.sleep(1) - return - self.config.task_queue.worker_timeout = 5 - self.add_coroutine(coroutine=self.config.task_queue.run, on_separate_thread=True) - self.add_coroutine(coroutine=self.executor.exit) - self.add_coroutine(coroutine=self.backtest_controller.control, on_separate_thread=True) - parties = strategies + 1 - self.backtest_controller.set_parties(parties=parties) - except Exception as err: - logger.error(f"{err}. Backtester initialization failed") - raise SystemExit - - async def initialize(self): - """Prepares the bot by signing in to the trading account and initializing the symbols for the trading session. - Starts the global task queue. - - Raises: - SystemExit if sign in was not successful - """ - try: - await self.mt.initialize() - login = await self.mt.login() - if not login: - logger.critical(f"Unable to sign in to MetaTrder 5 Terminal") - raise Exception("Unable to sign in to MetaTrader 5 Terminal") - logger.info("Login Successful") - await self.backtest_engine.setup_account() - await self.init_strategies() - if (strategies := len(self.executor.strategy_runners)) == 0: - self.config.shutdown = True - logger.warning("No strategies were added to the backtester. Exiting in one second") - await asyncio.sleep(1) - return - self.config.task_queue.worker_timeout = 5 - self.add_coroutine(coroutine=self.config.task_queue.run, on_separate_thread=True) - self.add_coroutine(coroutine=self.executor.exit) - self.add_coroutine(coroutine=self.backtest_controller.control, on_separate_thread=True) - parties = strategies + 1 - self.backtest_controller.set_parties(parties=parties) - except Exception as err: - logger.error(f"{err}. Backtester initialization failed") - raise SystemExit - - def add_coroutine(self, *, coroutine: Callable[..., ...] | Coroutine, on_separate_thread=False, **kwargs): - """Add a coroutine to the executor. - - Args: - coroutine (Coroutine): A coroutine to be executed - on_separate_thread (bool): Run the coroutine - Returns: - - """ - self.executor.add_coroutine(coroutine=coroutine, kwargs=kwargs, on_separate_thread=on_separate_thread) - - def execute(self): - """Execute the bot.""" - self.initialize_sync() - if self.config.shutdown is False: - self.executor.execute() - - async def start(self): - """Initialize the bot and execute it. Similar to calling `execute` method but is a coroutine.""" - await self.initialize() - if self.config.shutdown is False: - self.executor.execute() - self.executor.execute() - - def add_strategy(self, *, strategy: Strategy): - """Add a strategy to the list of strategies. - An added strategy will only run if it's symbol was successfully initialized, and it is added to the executor. - - Args: - strategy (Strategy): A Strategy instance to run on bot - - Notes: - Make sure the symbol has been added to the market - """ - self.strategies.append(strategy) - - def add_strategies(self, *, strategies: Iterable[Strategy]): - """Add multiple strategies at the same time - - Args: - strategies: A list of strategies - """ - [self.add_strategy(strategy=strategy) for strategy in strategies] - - def add_strategy_all( - self, *, strategy: Type[Strategy], params: dict | None = None, symbols: list[Symbol] = None, **kwargs - ): - """Use this to run a single strategy on multiple symbols with the same parameters and keyword arguments. - - Keyword Args: - strategy (Strategy): Strategy class - params (dict): A dictionary of parameters for the strategy - symbols (list): A list of symbols to run the strategy on - """ - [self.add_strategy(strategy=strategy(symbol=symbol, params=params, **kwargs)) for symbol in symbols] - - async def init_strategy(self, *, strategy: Strategy) -> bool: - """Initialize a single strategy. This method is called internally by the bot.""" - res = await strategy.symbol.initialize() - if res: - self.executor.add_strategy(strategy=strategy) - return res - - def init_strategy_sync(self, *, strategy: Strategy) -> bool: - """Initialize a single strategy. This method is called internally by the bot.""" - try: - res = strategy.symbol.initialize_sync() - if res: - self.executor.add_strategy(strategy=strategy) - return res - except Exception as err: - logger.error("%s: Unable to initialize strategy", err) - return False - - async def init_strategies(self): - """Initialize the symbols for the current trading session. This method is called internally by the bot.""" - tasks = [self.init_strategy(strategy=strategy) for strategy in self.strategies] - await asyncio.gather(*tasks) - - def init_strategies_sync(self): - """Initialize the symbols for the current trading session. This method is called internally by the bot.""" - [self.init_strategy_sync(strategy=strategy) for strategy in self.strategies] diff --git a/src/aiomql/lib/bot.py b/src/aiomql/lib/bot.py index c730da7..bf224ab 100644 --- a/src/aiomql/lib/bot.py +++ b/src/aiomql/lib/bot.py @@ -53,7 +53,6 @@ import logging from .executor import Executor from ..core.config import Config from ..core.meta_trader import MetaTrader -from ..core.meta_backtester import MetaBackTester from .symbol import Symbol as Symbol from .strategy import Strategy as Strategy @@ -65,17 +64,15 @@ class Bot: Creates a bot instance that manages the connection to MetaTrader 5, initializes strategies, and coordinates their execution through the - Executor. Supports both synchronous and asynchronous operation modes, - as well as live trading and backtesting. + Executor. Supports both synchronous and asynchronous operation modes. Attributes: config (Config): Configuration instance that holds bot settings and references to shared resources like the task queue. executor (Executor): Thread pool executor that manages the concurrent execution of strategies, coroutines, and functions. - mt5 (MetaTrader | MetaBackTester): MetaTrader 5 interface instance. - Uses MetaTrader for live/demo trading or MetaBackTester for - backtesting based on the config mode. + mt5 (MetaTrader): MetaTrader 5 interface instance. + Uses MetaTrader for live/demo trading strategies (list[Strategy]): List of strategy instances to be initialized and run by the bot. initialized (bool): Flag indicating whether the terminal has been @@ -115,12 +112,11 @@ class Bot: mode. Initializes all tracking flags and the empty strategies list. Note: - The bot automatically selects MetaTrader for live/demo trading - or MetaBackTester when config.mode is set to "backtest". + The bot automatically selects MetaTrader for live/demo trading. """ self.config = Config(bot=self) self.executor = Executor() - self.mt5 = MetaTrader() if self.config.mode != "backtest" else MetaBackTester() + self.mt5 = MetaTrader() self.strategies = [] self.initialized = False self.login = False diff --git a/src/aiomql/lib/executor.py b/src/aiomql/lib/executor.py index 95815f8..48c8341 100644 --- a/src/aiomql/lib/executor.py +++ b/src/aiomql/lib/executor.py @@ -41,6 +41,20 @@ class Executor: config: Config def __init__(self): + """Initializes the Executor with empty task collections. + + Sets up empty lists and dictionaries for strategies, coroutines, + and functions. Registers a SIGINT handler for graceful shutdown. + + Attributes: + strategy_runners (list[Strategy]): Strategies to execute. + coroutines (dict): Coroutines to run on the shared event loop. + coroutine_threads (dict): Coroutines to run on separate threads. + functions (dict): Synchronous functions to run as tasks. + config (Config): The global configuration singleton. + timeout (float | None): Executor timeout in seconds. For + testing purposes only. + """ self.strategy_runners: list[Strategy] = [] self.coroutines: dict[Coroutine: dict] = {} self.coroutine_threads: dict[Coroutine: dict] = {} @@ -50,10 +64,25 @@ class Executor: signal(SIGINT, self.sigint_handle) def add_function(self, *, function: Callable, kwargs: dict = None): + """Registers a synchronous function to run in the executor. + + Args: + function: The callable to execute. + kwargs: Optional keyword arguments for the function. + """ kwargs = kwargs or {} self.functions[function] = kwargs def add_coroutine(self, *, coroutine: Callable | Coroutine, kwargs: dict = None, on_separate_thread=False): + """Registers a coroutine to run in the executor. + + Args: + coroutine: The async callable or coroutine to execute. + kwargs: Optional keyword arguments for the coroutine. + on_separate_thread: If True, the coroutine runs on its own + thread with a dedicated event loop. If False, it runs on + the shared event loop. Defaults to False. + """ kwargs = kwargs or {} if on_separate_thread: self.coroutine_threads[coroutine] = kwargs @@ -98,6 +127,12 @@ class Executor: @staticmethod def run_coroutine_task(coroutine, kwargs): + """Runs a single coroutine on a new event loop in a separate thread. + + Args: + coroutine: The async callable to execute. + kwargs: Keyword arguments for the coroutine. + """ asyncio.run(coroutine(**kwargs)) @staticmethod @@ -110,10 +145,21 @@ class Executor: function(**kwargs) def sigint_handle(self, signum, frame): + """Handles SIGINT (Ctrl+C) by signaling a shutdown. + + Args: + signum: The signal number received. + frame: The current stack frame. + """ self.config.shutdown = True def exit(self): - """Shutdown the executor""" + """Monitors for shutdown signals and gracefully shuts down the executor. + + Runs in a loop checking for shutdown or timeout conditions. + When triggered, stops all strategies, cancels the task queue, + and shuts down the thread pool executor. + """ start = time.time() try: while self.config.shutdown is False and self.config.force_shutdown is False: @@ -125,9 +171,6 @@ class Executor: for strategy in self.strategy_runners: strategy.running = False self.config.task_queue.cancel() - - if self.config.backtest_engine is not None: - self.config.backtest_engine.stop_testing = True self.executor.shutdown(wait=False, cancel_futures=False) if self.config.force_shutdown: diff --git a/src/aiomql/lib/history.py b/src/aiomql/lib/history.py index 286a972..f516401 100644 --- a/src/aiomql/lib/history.py +++ b/src/aiomql/lib/history.py @@ -21,7 +21,6 @@ from logging import getLogger from ..core.config import Config from ..core.meta_trader import MetaTrader from ..core.models import TradeDeal, TradeOrder -from ..core.meta_backtester import MetaBackTester from ..core.base import BaseMeta from ..core.exceptions import InvalidRequest @@ -43,7 +42,7 @@ class History(metaclass=BaseMeta): group: Symbol filter pattern for selecting history. date_from: Start date for history query. date_to: End date for history query. - mt5: MetaTrader or MetaBackTester instance (class variable). + mt5: MetaTrader (class variable). config: Config instance (class variable). Example: @@ -65,7 +64,7 @@ class History(metaclass=BaseMeta): # Filter by position position_deals = history.get_deals_by_position(position=12345) """ - mt5: ClassVar[MetaTrader | MetaBackTester] + mt5: ClassVar[MetaTrader] config: ClassVar[Config] deals: tuple[TradeDeal, ...] orders: tuple[TradeOrder, ...] @@ -175,19 +174,62 @@ class History(metaclass=BaseMeta): return tuple(TradeOrder(**order._asdict()) for order in orders) def filter_deals_by_ticket(self, *, ticket: int) -> tuple[TradeDeal, ...]: + """Filters cached deals by ticket number. + + Args: + ticket: The deal ticket number to filter by. + + Returns: + tuple[TradeDeal, ...]: Deals matching the specified ticket. + """ return tuple(deal for deal in self.deals if deal.ticket == ticket) def filter_deals_by_position(self, *, position: int) -> tuple[TradeDeal, ...]: + """Filters cached deals by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeDeal, ...]: Deals matching the specified position. + """ return tuple(deal for deal in self.deals if deal.position_id == position) def filter_orders_by_ticket(self, *, ticket: int) -> tuple[TradeOrder, ...]: + """Filters cached orders by ticket number. + + Args: + ticket: The order ticket number to filter by. + + Returns: + tuple[TradeOrder, ...]: Orders matching the specified ticket. + """ return tuple(order for order in self.orders if order.ticket == ticket) def filter_orders_by_position(self, *, position: int) -> tuple[TradeOrder, ...]: + """Filters cached orders by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeOrder, ...]: Orders matching the specified position. + """ return tuple(order for order in self.orders if order.position_id == position) @classmethod async def get_deal_by_ticket(cls, *, ticket: int) -> TradeDeal: + """Fetches a single deal from history by its ticket number. + + Args: + ticket: The deal ticket number. + + Returns: + TradeDeal: The matching deal. + + Raises: + InvalidRequest: If no deal matches the given ticket. + """ deals = await cls.mt5.history_deals_get(ticket=ticket) if (deal := deals[0]).ticket == ticket: return TradeDeal(**deal._asdict()) @@ -195,11 +237,30 @@ class History(metaclass=BaseMeta): @classmethod async def get_deals_by_position(cls, *, position: int = None) -> tuple[TradeDeal, ...]: + """Fetches deals from history by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeDeal, ...]: Deals associated with the position. + """ deals = await cls.mt5.history_deals_get(position=position) return tuple(TradeDeal(**deal._asdict()) for deal in deals if deal.position_id == position) @classmethod async def get_order_by_ticket(cls, *, ticket: int) -> TradeOrder: + """Fetches a single order from history by its ticket number. + + Args: + ticket: The order ticket number. + + Returns: + TradeOrder: The matching order. + + Raises: + InvalidRequest: If no order matches the given ticket. + """ orders = await cls.mt5.history_orders_get(ticket=ticket) if (order := orders[0]).ticket == ticket: return TradeOrder(**order._asdict()) @@ -207,5 +268,13 @@ class History(metaclass=BaseMeta): @classmethod async def get_orders_by_position(cls, *, position: int) -> tuple[TradeOrder, ...]: + """Fetches orders from history by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeOrder, ...]: Orders associated with the position. + """ orders = await cls.mt5.history_orders_get(position=position) return tuple(TradeOrder(**order._asdict()) for order in orders) diff --git a/src/aiomql/lib/positions.py b/src/aiomql/lib/positions.py index 233d8d7..f03b77a 100644 --- a/src/aiomql/lib/positions.py +++ b/src/aiomql/lib/positions.py @@ -19,7 +19,6 @@ from ..core.base import BaseMeta from ..core.models import TradePosition, OrderSendResult from ..core.constants import OrderType, TradeAction from ..core.config import Config -from ..core.meta_backtester import MetaBackTester from ..core.exceptions import InvalidRequest from .order import Order @@ -32,7 +31,7 @@ class Positions(metaclass=BaseMeta): Attributes: mt5 (MetaTrader): MetaTrader instance. """ - mt5: MetaTrader | MetaBackTester + mt5: MetaTrader config: Config @classmethod diff --git a/src/aiomql/lib/sessions.py b/src/aiomql/lib/sessions.py index 5fc9f80..b0c0d37 100644 --- a/src/aiomql/lib/sessions.py +++ b/src/aiomql/lib/sessions.py @@ -36,7 +36,6 @@ import asyncio from datetime import time, timedelta, datetime, UTC from typing import Literal, Callable, Iterable, NamedTuple from logging import getLogger -from time import sleep from ..core.models import OrderSendResult, TradePosition from ..core.config import Config @@ -70,22 +69,6 @@ def delta(obj: time) -> timedelta: return timedelta(hours=obj.hour, minutes=obj.minute, seconds=obj.second, microseconds=obj.microsecond) -async def backtest_sleep(secs): - """An async sleep function for use during backtesting. - - Waits for the backtest engine cursor to advance by the specified - number of seconds. - - Args: - secs: Number of seconds to sleep in backtest time. - """ - config = Config() - btc = config.backtest_controller - sleep_secs = config.backtest_engine.cursor.time + secs - while sleep_secs > config.backtest_engine.cursor.time: - btc.wait() - - class Session: """A trading session representing a time period between two UTC times. @@ -189,11 +172,7 @@ class Session: Returns: bool: True if current time is within session bounds. """ - now = ( - datetime.now(tz=UTC).time() - if self.config.mode == "live" - else datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time() - ) + now = datetime.now(tz=UTC).time() return now in self async def begin(self): @@ -287,14 +266,9 @@ class Session: Returns: int: Number of seconds until session start time. """ - if self.config.mode == "backtest": - now = datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time() - secs = (delta(self.start) - delta(now)).seconds - else: - secs = (delta(self.start) - delta(datetime.now(tz=UTC).time())).seconds + secs = (delta(self.start) - delta(datetime.now(tz=UTC).time())).seconds return secs - class Sessions: """A collection of Session objects with automatic session management. @@ -345,11 +319,7 @@ class Sessions: Returns: Session | None: The matching session, or None if not found. """ - moment = ( - moment or datetime.now(tz=UTC).time() - if self.config.mode == "live" - else (datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time()) - ) + moment = moment or datetime.now(tz=UTC).time() for session in self.sessions: if moment in session: return session @@ -364,11 +334,7 @@ class Sessions: Returns: Session: The next session. Wraps to first session if at end of day. """ - moment = ( - moment or datetime.now(tz=UTC).time() - if self.config.mode != "backtest" - else (datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time()) - ) + moment = moment or datetime.now(tz=UTC).time() for session in self.sessions: if delta(moment) < delta(session.start): return session @@ -409,14 +375,8 @@ class Sessions: """ if self.current_session is not None and self.current_session.in_session(): return - - if self.config.mode == "backtest": - now = datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time() - else: - now = datetime.now(tz=UTC).time() - + now = datetime.now(tz=UTC).time() next_session = self.find(moment=now) - if next_session and self.current_session is None: self.current_session = next_session await self.current_session.begin() @@ -434,7 +394,6 @@ class Sessions: next_session = self.find_next(moment=now) secs = next_session.until() + 10 logger.info(f"sleeping for {secs} seconds until next {next_session} session") - sleep_func = asyncio.sleep if self.config.mode == "live" else backtest_sleep - await sleep_func(secs) + await asyncio.sleep(secs) self.current_session = next_session await self.current_session.begin() diff --git a/src/aiomql/lib/strategy.py b/src/aiomql/lib/strategy.py index 33244ef..f374642 100644 --- a/src/aiomql/lib/strategy.py +++ b/src/aiomql/lib/strategy.py @@ -1,8 +1,7 @@ """Strategy module for creating trading strategies. This module provides the Strategy base class for implementing trading -strategies. It handles session management, sleep functions for both live -and backtest modes, and the main trading loop. +strategies. Example: Creating a custom strategy:: @@ -27,9 +26,7 @@ from logging import getLogger from .sessions import Sessions, Session from .symbol import Symbol from ..core import Config -from ..core.backtesting.backtest_controller import BackTestController from ..core.exceptions import StopTrading -from ..core.meta_backtester import MetaBackTester from ..core.meta_trader import MetaTrader logger = getLogger(__name__) @@ -44,9 +41,8 @@ class Strategy(ABC): parameters (Dict): A dictionary of parameters for the strategy. sessions (Sessions): The sessions to use for the strategy. running (bool): A flag to indicate if the strategy is running. - backtest_controller (BackTestController): A controller for running the backtester. current_session (Session): The current session. - mt5 (MetaTrader|MetaBackTester): The MetaTrader object. + mt5 (MetaTrader): The MetaTrader object. config (Config): The config object. Notes: @@ -56,11 +52,10 @@ class Strategy(ABC): name: str symbol: Symbol sessions: Sessions - mt5: MetaTrader | MetaBackTester + mt5: MetaTrader config: Config running: bool parameters = {} - backtest_controller: BackTestController current_session = Session def __init__(self, *, symbol: Symbol, params: dict = None, sessions: Sessions = None, name=""): @@ -79,9 +74,7 @@ class Strategy(ABC): self.running = True self.sessions = sessions or Sessions(sessions=[Session(start=0, end=dtime(hour=23, minute=59, second=59))]) self.config = Config() - self.mt5 = MetaTrader() if self.config.mode != "backtest" else MetaBackTester() - if self.config.mode == "backtest": - self.backtest_controller = BackTestController() + self.mt5 = MetaTrader() def __repr__(self): return f"{self.name}({self.symbol!r})" @@ -136,50 +129,15 @@ class Strategy(ABC): Args: secs (float): The time in seconds. Usually the timeframe you are trading on. """ - if self.config.mode == "backtest": - self.backtest_sleep(secs=secs) - else: - await self.live_sleep(secs=secs) + await self.live_sleep(secs=secs) async def delay(self, *, secs: float): """Sleep for the input amount of seconds""" - if self.config.mode == "backtest": - self._backtest_sleep(secs=secs) - else: - await asyncio.sleep(secs) - - def _backtest_sleep(self, *, secs: float): - try: - if self.backtest_controller.parties >= 2: - _time = self.config.backtest_engine.cursor.time + secs - while _time > self.config.backtest_engine.cursor.time: - self.backtest_controller.wait() - else: - self.backtest_controller.wait() - except Exception as err: - self.backtest_controller.wait() - logger.error("Error: %s in backtest_sleep", err) - - def backtest_sleep(self, *, secs: float): - """Sleep for the needed amount of seconds in between requests to the terminal. - - Args: - secs (float): The time in seconds. Usually the timeframe you are trading on. - """ - try: - _time = self.config.backtest_engine.cursor.time - mod = _time % secs - secs = secs - mod if mod != 0 else mod - self._backtest_sleep(secs=secs) - except Exception as err: - logger.error("Error: %s in backtest_sleep", err) + await asyncio.sleep(secs) async def run_strategy(self): """Run the strategy.""" - if self.config.mode == "live": - await self.live_strategy() - elif self.config.mode == "backtest": - await self.backtest_strategy() + await self.live_strategy() async def live_strategy(self): """Run the strategy.""" @@ -203,23 +161,6 @@ class Strategy(ABC): self.running = False break - async def backtest_strategy(self): - """Backtest the strategy.""" - async with self as _: - logger.info("Testing %s strategy on %s with Backtester", self.name, self.symbol.name) - await self.initialize() - while self.running: - try: - await self.sessions.check() - self.backtest_controller.wait() - await self.test() - except StopTrading: - self.running = False - break - except Exception as err: - logger.error(f"Error: {err} in backtest_strategy") - return - async def trade(self): """Place trades using this method. This is the main method of the strategy. It will be called by the strategy runner. diff --git a/src/aiomql/lib/symbol.py b/src/aiomql/lib/symbol.py index 9e541f7..df0b09f 100644 --- a/src/aiomql/lib/symbol.py +++ b/src/aiomql/lib/symbol.py @@ -172,7 +172,7 @@ class Symbol(_Base, SymbolInfo): bool: True if successful, otherwise – False. """ res = await self.mt5.market_book_add(self.name) - if res is False: + if not res: logger.debug("Could not add %s to market book", self.name) return res diff --git a/src/aiomql/lib/sync/history.py b/src/aiomql/lib/sync/history.py index 6f04c40..345aa5d 100644 --- a/src/aiomql/lib/sync/history.py +++ b/src/aiomql/lib/sync/history.py @@ -20,7 +20,6 @@ from logging import getLogger from ...core.config import Config from ...core.sync.meta_trader import MetaTrader from ...core.models import TradeDeal, TradeOrder -from ...core.meta_backtester import MetaBackTester from ...core.exceptions import InvalidRequest from ...core.base import BaseMeta @@ -45,7 +44,7 @@ class History(metaclass=BaseMeta): group: Symbol filter pattern for selecting history. date_from: Start date for history query. date_to: End date for history query. - mt5: MetaTrader or MetaBackTester instance (class variable). + mt5: MetaTrader (class variable). config: Config instance (class variable). Example: @@ -67,7 +66,7 @@ class History(metaclass=BaseMeta): # Filter by position position_deals = history.get_deals_by_position(position=12345) """ - mt5: ClassVar[MetaTrader | MetaBackTester] + mt5: ClassVar[MetaTrader] config: ClassVar[Config] deals: tuple[TradeDeal, ...] orders: tuple[TradeOrder, ...] @@ -155,13 +154,40 @@ class History(metaclass=BaseMeta): return tuple(TradeDeal(**deal._asdict()) for deal in deals) def filter_deals_by_ticket(self, *, ticket: int) -> tuple[TradeDeal, ...]: + """Filters cached deals by ticket number. + + Args: + ticket: The deal ticket number to filter by. + + Returns: + tuple[TradeDeal, ...]: Deals matching the specified ticket. + """ return tuple(deal for deal in self.deals if deal.ticket == ticket) def filter_deals_by_position(self, *, position: int) -> tuple[TradeDeal, ...]: + """Filters cached deals by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeDeal, ...]: Deals matching the specified position. + """ return tuple(deal for deal in self.deals if deal.position_id == position) @classmethod def get_deal_by_ticket(cls, *, ticket: int) -> TradeDeal: + """Fetches a single deal from history by its ticket number. + + Args: + ticket: The deal ticket number. + + Returns: + TradeDeal: The matching deal. + + Raises: + InvalidRequest: If no deal matches the given ticket. + """ deals = cls.mt5.history_deals_get(ticket=ticket) if (deal := deals[0]).ticket == ticket: return TradeDeal(**deal._asdict()) @@ -169,6 +195,14 @@ class History(metaclass=BaseMeta): @classmethod def get_deals_by_position(cls, *, position: int = None) -> tuple[TradeDeal, ...]: + """Fetches deals from history by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeDeal, ...]: Deals associated with the position. + """ deals = cls.mt5.history_deals_get(position=position) return tuple(TradeDeal(**deal._asdict()) for deal in deals if deal.position_id == position) @@ -189,13 +223,40 @@ class History(metaclass=BaseMeta): return tuple(TradeOrder(**order._asdict()) for order in orders) def filter_orders_by_ticket(self, *, ticket: int) -> tuple[TradeOrder, ...]: + """Filters cached orders by ticket number. + + Args: + ticket: The order ticket number to filter by. + + Returns: + tuple[TradeOrder, ...]: Orders matching the specified ticket. + """ return tuple(order for order in self.orders if order.ticket == ticket) def filter_orders_by_position(self, *, position: int) -> tuple[TradeOrder, ...]: + """Filters cached orders by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeOrder, ...]: Orders matching the specified position. + """ return tuple(order for order in self.orders if order.position_id == position) @classmethod def get_order_by_ticket(cls, *, ticket: int) -> TradeOrder: + """Fetches a single order from history by its ticket number. + + Args: + ticket: The order ticket number. + + Returns: + TradeOrder: The matching order. + + Raises: + InvalidRequest: If no order matches the given ticket. + """ orders = cls.mt5.history_orders_get(ticket=ticket) if (order := orders[0]).ticket == ticket: return TradeOrder(**order._asdict()) @@ -203,5 +264,13 @@ class History(metaclass=BaseMeta): @classmethod def get_orders_by_position(cls, *, position: int) -> tuple[TradeOrder, ...]: + """Fetches orders from history by position identifier. + + Args: + position: The position ID to filter by. + + Returns: + tuple[TradeOrder, ...]: Orders associated with the position. + """ orders = cls.mt5.history_orders_get(position=position) return tuple(TradeOrder(**order._asdict()) for order in orders) diff --git a/src/aiomql/lib/sync/positions.py b/src/aiomql/lib/sync/positions.py index 386f97f..f156623 100644 --- a/src/aiomql/lib/sync/positions.py +++ b/src/aiomql/lib/sync/positions.py @@ -16,7 +16,6 @@ from ...core.models import TradePosition, OrderSendResult from ...core.constants import OrderType, TradeAction from ...core.config import Config from ...core.sync.meta_trader import MetaTrader -from ...core.meta_backtester import MetaBackTester from ...core.base import BaseMeta from ...core.exceptions import InvalidRequest from .order import Order @@ -31,7 +30,7 @@ class Positions(metaclass=BaseMeta): Attributes: mt5 (MetaTrader): MetaTrader instance. """ - mt5: MetaTrader | MetaBackTester + mt5: MetaTrader config: Config mode: str = "sync" diff --git a/src/aiomql/lib/sync/sessions.py b/src/aiomql/lib/sync/sessions.py index 3f51390..d845490 100644 --- a/src/aiomql/lib/sync/sessions.py +++ b/src/aiomql/lib/sync/sessions.py @@ -69,22 +69,6 @@ def delta(obj: time) -> timedelta: return timedelta(hours=obj.hour, minutes=obj.minute, seconds=obj.second, microseconds=obj.microsecond) -def backtest_sleep(secs): - """A synchronous sleep function for use during backtesting. - - Waits for the backtest engine cursor to advance by the specified - number of seconds. - - Args: - secs: Number of seconds to sleep in backtest time. - """ - config = Config() - btc = config.backtest_controller - sleep_secs = config.backtest_engine.cursor.time + secs - while sleep_secs > config.backtest_engine.cursor.time: - btc.wait() - - class Session: """A trading session representing a time period between two UTC times. @@ -188,11 +172,7 @@ class Session: Returns: bool: True if current time is within session bounds. """ - now = ( - datetime.now(tz=UTC).time() - if self.config.mode == "live" - else datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time() - ) + now = datetime.now(tz=UTC).time() return now in self def begin(self): @@ -286,13 +266,7 @@ class Session: Returns: int: Number of seconds until session start time. """ - if self.config.mode == "backtest": - now = datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time() - secs = (delta(self.start) - delta(now)).seconds - else: - secs = (delta(self.start) - delta(datetime.now(tz=UTC).time())).seconds - return secs - + return (delta(self.start) - delta(datetime.now(tz=UTC).time())).seconds class Sessions: """A collection of Session objects with automatic session management. @@ -344,11 +318,7 @@ class Sessions: Returns: Session | None: The matching session, or None if not found. """ - moment = ( - moment or datetime.now(tz=UTC).time() - if self.config.mode == "live" - else (datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time()) - ) + moment = moment or datetime.now(tz=UTC).time() for session in self.sessions: if moment in session: return session @@ -363,11 +333,7 @@ class Sessions: Returns: Session: The next session. Wraps to first session if at end of day. """ - moment = ( - moment or datetime.now(tz=UTC).time() - if self.config.mode != "backtest" - else (datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time()) - ) + moment or datetime.now(tz=UTC).time() for session in self.sessions: if delta(moment) < delta(session.start): return session @@ -408,12 +374,7 @@ class Sessions: """ if self.current_session is not None and self.current_session.in_session(): return - - if self.config.mode == "backtest": - now = datetime.fromtimestamp(self.config.backtest_engine.cursor.time, tz=UTC).time() - else: - now = datetime.now(tz=UTC).time() - + now = datetime.now(tz=UTC).time() next_session = self.find(moment=now) if next_session and self.current_session is None: @@ -433,7 +394,6 @@ class Sessions: next_session = self.find_next(moment=now) secs = next_session.until() + 10 logger.info(f"sleeping for {secs} seconds until next {next_session} session") - sleep_func = sleep if self.config.mode == "live" else backtest_sleep - sleep_func(secs) + sleep(secs) self.current_session = next_session self.current_session.begin() diff --git a/src/aiomql/lib/sync/strategy.py b/src/aiomql/lib/sync/strategy.py index b36b4cb..28181f9 100644 --- a/src/aiomql/lib/sync/strategy.py +++ b/src/aiomql/lib/sync/strategy.py @@ -22,9 +22,7 @@ from logging import getLogger from .sessions import Sessions, Session from .symbol import Symbol from ...core import Config -from ...core.backtesting.backtest_controller import BackTestController from ...core.exceptions import StopTrading -from ...core.meta_backtester import MetaBackTester from ...core.meta_trader import MetaTrader from ..strategy import Strategy as BaseStrategy @@ -41,9 +39,8 @@ class Strategy(BaseStrategy): parameters (Dict): A dictionary of parameters for the strategy. sessions (Sessions): The sessions to use for the strategy. running (bool): A flag to indicate if the strategy is running. - backtest_controller (BackTestController): A controller for running the backtester. current_session (Session): The current session. - mt5 (MetaTrader|MetaBackTester): The MetaTrader object. + mt5 MetaTrader: The MetaTrader object. config (Config): The config object. Notes: @@ -52,11 +49,10 @@ class Strategy(BaseStrategy): name: str symbol: Symbol sessions: Sessions - mt5: MetaTrader | MetaBackTester + mt5: MetaTrader config: Config running: bool parameters = {} - backtest_controller = BackTestController current_session = Session def __init__(self, *, symbol: Symbol, params: dict = None, sessions: Sessions = None, name=""): @@ -75,8 +71,7 @@ class Strategy(BaseStrategy): self.running = True self.sessions = sessions or Sessions(sessions=[Session(start=0, end=dtime(hour=23, minute=59, second=59))]) self.config = Config() - self.mt5 = MetaTrader() if self.config.mode != "backtest" else MetaBackTester() - self.backtest_controller = BackTestController() + self.mt5 = MetaTrader() def __repr__(self): return f"{self.name}({self.symbol!r})" @@ -127,50 +122,15 @@ class Strategy(BaseStrategy): Args: secs (float): The time in seconds. Usually the timeframe you are trading on. """ - if self.config.mode == "backtest": - self.backtest_sleep(secs=secs) - else: - self.live_sleep(secs=secs) + self.live_sleep(secs=secs) def delay(self, *, secs: float): """Sleep for the input amount of seconds""" - if self.config.mode == "backtest": - self._backtest_sleep(secs=secs) - else: - time.sleep(secs) - - def _backtest_sleep(self, *, secs: float): - try: - if self.backtest_controller.parties >= 2: - _time = self.config.backtest_engine.cursor.time + secs - while _time > self.config.backtest_engine.cursor.time: - self.backtest_controller.wait() - else: - self.backtest_controller.wait() - except Exception as err: - self.backtest_controller.wait() - logger.error("Error: %s in backtest_sleep", err) - - def backtest_sleep(self, *, secs: float): - """Sleep for the needed amount of seconds in between requests to the terminal. - - Args: - secs (float): The time in seconds. Usually the timeframe you are trading on. - """ - try: - _time = self.config.backtest_engine.cursor.time - mod = _time % secs - secs = secs - mod if mod != 0 else mod - self._backtest_sleep(secs=secs) - except Exception as err: - logger.error("Error: %s in backtest_sleep", err) + time.sleep(secs) def run_strategy(self): """Run the strategy.""" - if self.config.mode == "live": - self.live_strategy() - elif self.config.mode == "backtest": - self.backtest_strategy() + self.live_strategy() def live_strategy(self): """Run the strategy""" @@ -190,22 +150,6 @@ class Strategy(BaseStrategy): self.running = False break - def backtest_strategy(self): - """Backtest the strategy.""" - with self as _: - logger.info("Testing %s strategy on %s with Backtester", self.name, self.symbol.name) - while self.running: - try: - self.sessions.check() - self.backtest_controller.wait() - self.test() - except StopTrading: - self.running = False - break - except Exception as err: - logger.error(f"Error: {err} in backtest_strategy") - return - def trade(self): """Place trades using this method. This is the main method of the strategy. It will be called by the strategy runner. diff --git a/src/aiomql/lib/sync/symbol.py b/src/aiomql/lib/sync/symbol.py index 16f5eac..cb1a428 100644 --- a/src/aiomql/lib/sync/symbol.py +++ b/src/aiomql/lib/sync/symbol.py @@ -15,12 +15,8 @@ Example: from datetime import datetime from logging import getLogger - -from ...core.meta_backtester import MetaBackTester from ...core.constants import TimeFrame, CopyTicks from ...core.base import _Base -from ...core.config import Config -from ...core.sync.meta_trader import MetaTrader from ...core.models import SymbolInfo, BookInfo from ...utils import round_off from ..ticks import Tick diff --git a/src/aiomql/lib/sync/trader.py b/src/aiomql/lib/sync/trader.py index eae63a0..8f2587d 100644 --- a/src/aiomql/lib/sync/trader.py +++ b/src/aiomql/lib/sync/trader.py @@ -17,7 +17,6 @@ Example: """ from abc import ABC, abstractmethod -from datetime import datetime, UTC from typing import TypeVar from logging import getLogger diff --git a/src/aiomql/lib/trade_records.py b/src/aiomql/lib/trade_records.py index 6125be9..3623682 100644 --- a/src/aiomql/lib/trade_records.py +++ b/src/aiomql/lib/trade_records.py @@ -29,7 +29,6 @@ from typing import Iterable from .result_db import ResultDB from ..core.config import Config from ..core.meta_trader import MetaTrader -from ..core.meta_backtester import MetaBackTester from ..core.models import TradePosition logger = logging.getLogger(__name__) @@ -43,7 +42,7 @@ class TradeRecords: Attributes: config: Configuration object for accessing settings. - mt5: MetaTrader or MetaBackTester instance for retrieving trade data. + mt5: MetaTrader instance for retrieving trade data. result_db: ResultDB class reference for SQL operations. records_dir: Path to directory containing trade record files. positions: Cached list of open positions, or None. @@ -54,7 +53,7 @@ class TradeRecords: >>> await records.update_sql_records() """ config: Config - mt5: MetaTrader | MetaBackTester + mt5: MetaTrader result_db: type[ResultDB] positions: list[TradePosition] | None = None @@ -66,7 +65,7 @@ class TradeRecords: records_dir (Path): Absolute path to directory containing record of placed trades. """ self.config = Config() - self.mt5 = MetaTrader() if self.config.mode != "backtest" else MetaBackTester() + self.mt5 = MetaTrader() self.records_dir = records_dir or self.config.records_dir self.result_db = ResultDB @@ -190,6 +189,18 @@ class TradeRecords: @staticmethod def str_to_bool(val: bool | str): + """Converts a string or boolean value to a Python bool. + + Args: + val: The value to convert. Accepts ``True``, ``False``, + ``"true"``, or ``"false"`` (case-insensitive). + + Returns: + bool: The corresponding boolean value. + + Raises: + TypeError: If ``val`` is not a recognised boolean string. + """ if isinstance(val, bool): return val elif val.lower() == "true": diff --git a/src/aiomql/ta_libs/pandas_ta_classic/overlap/ema.py b/src/aiomql/ta_libs/pandas_ta_classic/overlap/ema.py index fb0a2dc..488f225 100644 --- a/src/aiomql/ta_libs/pandas_ta_classic/overlap/ema.py +++ b/src/aiomql/ta_libs/pandas_ta_classic/overlap/ema.py @@ -23,7 +23,6 @@ def ema(close, length=None, talib=None, offset=None, **kwargs): # Calculate Result if Imports["talib"] and mode_tal: from talib import EMA - ema = EMA(close, length) else: if sma: diff --git a/src/aiomql/utils/utils.py b/src/aiomql/utils/utils.py index 7d638c4..7162ba6 100644 --- a/src/aiomql/utils/utils.py +++ b/src/aiomql/utils/utils.py @@ -1,12 +1,24 @@ -"""Utility functions for aiomql.""" +"""General-purpose utility functions for the aiomql package. + +Provides decorators for error handling and retries, rounding helpers +for volume/price calculations, and an async-aware cache decorator. + +Functions: + dict_to_string: Convert a dict to a printable string. + backoff_decorator: Retry an async function with back-off. + error_handler: Catch and log errors in async functions. + error_handler_sync: Catch and log errors in sync functions. + round_down: Round a number down to the nearest base. + round_up: Round a number up to the nearest base. + round_off: Round to the nearest step using ``decimal``. + async_cache: Thread-safe cache for async function results. +""" import decimal -import random +from typing import Callable from functools import wraps, partial -import asyncio from threading import RLock from logging import getLogger -from ..core.config import Config logger = getLogger(__name__) @@ -25,7 +37,7 @@ def dict_to_string(data: dict, multi=False) -> str: return f"{sep}".join(f"{key}: {value}" for key, value in data.items()) -def backoff_decorator(func=None, *, max_retries: int = 3, retries: int = 0) -> callable: +def backoff_decorator(func=None, *, max_retries: int = 3, retries: int = 0) -> Callable: """A decorator to retry a function a number of times before giving up. Args: func (callable, optional): The function to decorate. Defaults to None. @@ -48,11 +60,6 @@ def backoff_decorator(func=None, *, max_retries: int = 3, retries: int = 0) -> c logger.error("An Error %s: occurred in %s", err, func.__name__) raise err retries += 1 - if Config().mode != "backtest": - delay = 2 ** retries + random.uniform(0, 1) - logger.warning("An Error %s: occurred in %s, trying again in %f seconds", - err, func.__name__, delay) - await asyncio.sleep(delay) return await wrapper(*args, **kwargs) return wrapper @@ -122,6 +129,15 @@ def round_down(value: int | float, base: int) -> int | float: def round_up(value: int | float, base: int) -> int: + """Round up a number to the nearest base. + + Args: + value: The number to round up. + base: The base to round up to. + + Returns: + int: The rounded-up number. + """ return int(value) if value % base == 0 else int(value + base - (value % base)) @@ -143,7 +159,17 @@ def round_off(value: float, step: float, round_down: bool = False) -> float: def async_cache(fun): - """A decorator to cache the result of an async function.""" + """Thread-safe cache decorator for async functions. + + Caches results keyed by ``(args, frozenset(kwargs))``. + Uses an ``RLock`` to ensure thread safety. + + Args: + fun: The async function to cache. + + Returns: + Callable: Wrapped function with ``.cache`` dict and ``.lock``. + """ @wraps(fun) async def wrapper(*args, **kwargs): key = (args, frozenset(kwargs.items())) diff --git a/tests/backtest/__init__.py b/tests/backtest/__init__.py deleted file mode 100644 index e69de29..0000000 diff --git a/tests/backtest/conftest.py b/tests/backtest/conftest.py deleted file mode 100644 index 155830a..0000000 --- a/tests/backtest/conftest.py +++ /dev/null @@ -1,107 +0,0 @@ -import asyncio -import json -import shutil -from datetime import datetime, UTC -from logging import getLogger -from pathlib import Path - -import pytest - -from aiomql.core import Config -from aiomql.core.meta_backtester import MetaBackTester -from aiomql.core.backtesting.backtest_engine import BackTestEngine -from aiomql.lib import Positions, History, Order - -logger = getLogger(__name__) - - -async def cleanup(): - try: - shutil.rmtree(Path("tests/backtest/configs"), ignore_errors=True) - Path.unlink(Path("tests/backtest/test.json"), missing_ok=True) - shutil.rmtree(Path("tests/backtest/trade_records"), ignore_errors=True) - shutil.rmtree(Path("tests/backtest/backtesting"), ignore_errors=True) - await close_all_positions() - await MetaBackTester().shutdown() - except Exception as err: - logger.error(f"Failed to complete cleanup: {err}") - - -async def close_all_positions(): - try: - mt = MetaBackTester() - positions = await mt.positions_get() - tasks = [] - for position in positions: - order_type = mt.ORDER_TYPE_BUY if position.type == mt.ORDER_TYPE_SELL else mt.ORDER_TYPE_SELL - req = { - "action": mt.TRADE_ACTION_DEAL, - "symbol": position.symbol, - "volume": position.volume, - "type": order_type, - "position": position.ticket, - "price": position.price_current, - } - tasks.append(mt.order_send(req)) - await asyncio.gather(*tasks) - except Exception as err: - logger.error(f"Failed to close all positions: {err}") - - -@pytest.fixture(scope="package", autouse=True) -async def config(request): - Path("tests/backtest/configs").mkdir(exist_ok=True) - with open("aiomql.json", "r") as fh, open("tests/backtest/configs/test2.json", "w") as fh1, open( - "tests/backtest/test.json", "w" - ) as fh2: - data = json.load(fh) - data["mode"] = "backtest" - json.dump(data, fh1, indent=2) - json.dump(data, fh2, indent=2) - config = Config(config_file="tests/backtest/test.json", root="tests/backtest", filename="test.json") - yield config - await cleanup() - - -@pytest.fixture(scope="package", autouse=True) -async def mt(): - mt = MetaBackTester() - await mt.initialize() - await mt.login() - yield mt - await mt.shutdown() - - -@pytest.fixture(scope="package") -async def period(): - return {"start": datetime(2024, 2, 1, hour=8, tzinfo=UTC), - "end": datetime(2024, 2, 7, hour=16, tzinfo=UTC)} - - -@pytest.fixture(scope="package") -async def backtest_engine(period): - start = period["start"] - end = period["end"] - return BackTestEngine(start=start, end=end, name="backtest_data", assign_to_config=True, preload=False) - - -@pytest.fixture(scope="function") -def order_sell(sell_order): - return Order(**sell_order) - - -@pytest.fixture(scope="function") -def order_buy(buy_order): - return Order(**buy_order) - - -@pytest.fixture(scope="package") -def positions(): - return Positions() - - -@pytest.fixture(scope="package") -def history(period): - start = period["start"] - end = period["end"] - return History(date_from=start, date_to=end) diff --git a/tests/backtest/integration/test_backtesting.py b/tests/backtest/integration/test_backtesting.py deleted file mode 100644 index f23ba16..0000000 --- a/tests/backtest/integration/test_backtesting.py +++ /dev/null @@ -1,154 +0,0 @@ -from aiomql.contrib import ForexSymbol -from aiomql.core import MetaBackTester, BackTestEngine, GetData -from aiomql.lib import Order - - -async def make_buy_sell_orders(): - sym = ForexSymbol(name="BTCUSD") - sym_info = await sym.mt5.symbol_info(sym.name) - dsl = (sym_info.trade_stops_level + sym_info.spread) * 2 * sym_info.point - sl = sym_info.ask - dsl - tp = sym_info.ask + dsl - buy_req = { - "action": sym.mt5.TRADE_ACTION_DEAL, - "symbol": sym.name, - "volume": sym_info.volume_min, - "type": sym.mt5.ORDER_TYPE_BUY, - "price": sym_info.ask, - "sl": sl, - "tp": tp, - } - - sell_req = buy_req.copy() - sell_req["type"] = sym.mt5.ORDER_TYPE_SELL - sell_req["price"] = sym_info.bid - del sell_req["tp"] - del sell_req["sl"] - return {"buy": Order(**buy_req), "sell": Order(**sell_req)} - - -def test_trade_mode(config, backtest_engine, history, positions, order_sell, order_buy, btc_usd, capsys): - print(config.filename, config.root) - assert config.mode == "backtest" - assert isinstance(backtest_engine, BackTestEngine) - assert isinstance(history.mt5, MetaBackTester) - assert isinstance(positions.mt5, MetaBackTester) - assert isinstance(order_sell.mt5, MetaBackTester) - assert isinstance(order_buy.mt5, MetaBackTester) - assert isinstance(btc_usd.mt5, MetaBackTester) - - -async def test_order_send(backtest_engine, order_sell, order_buy): - await backtest_engine.setup_account(balance=100) - so = await backtest_engine.order_send(request=order_sell.request) - bo = await backtest_engine.order_send(request=order_buy.request) - assert so.retcode == 10009 - assert bo.retcode == 10009 - backtest_engine.reset(clear_data=True) - - -async def test_positions(backtest_engine, positions, order_sell, order_buy): - await backtest_engine.setup_account(balance=100) - so = await backtest_engine.order_send(request=order_sell.request) - bo = await backtest_engine.order_send(request=order_buy.request) - all_positions = await positions.get_positions() - assert len(all_positions) == 2 - await positions.close_position_by_ticket(ticket=so.order) - all_positions = await positions.get_positions() - assert len(all_positions) == 1 - await positions.close_position_by_ticket(ticket=bo.order) - all_positions = await positions.get_positions() - assert len(all_positions) == 0 - backtest_engine.reset(clear_data=True) - - -async def test_history(backtest_engine, history, order_sell, order_buy, positions): - await backtest_engine.setup_account(balance=100) - so = await backtest_engine.order_send(request=order_sell.request) - await backtest_engine.order_send(request=order_buy.request) - await history.initialize() - assert len(history.orders) == 2 - assert len(history.deals) == 2 - await positions.close_position_by_ticket(ticket=so.order) - deals = await history.get_deals() - assert len(deals) == 3 - backtest_engine.reset(clear_data=True) - - -async def test_margin(backtest_engine, order_sell, order_buy): - await backtest_engine.setup_account(balance=100) - so_margin = await backtest_engine.order_calc_margin( - action=order_sell.action, volume=order_sell.volume, symbol=order_sell.symbol, price=order_sell.price - ) - bo_margin = await backtest_engine.order_calc_margin( - action=order_buy.action, volume=order_buy.volume, symbol=order_buy.symbol, price=order_buy.price - ) - total_margin = so_margin + bo_margin - await backtest_engine.order_send(request=order_sell.request) - await backtest_engine.order_send(request=order_buy.request) - # noinspection PyTestUnpassedFixture - assert backtest_engine.positions.margin == total_margin == backtest_engine._account.margin - backtest_engine.reset(clear_data=True) - - -async def test_account(backtest_engine, positions): - await backtest_engine.setup_account(balance=100) - backtest_engine.fast_forward(steps=100) - balance = backtest_engine._account.balance - equity = backtest_engine._account.equity - orders = await make_buy_sell_orders() - buy_order = orders["buy"] - sell_order = orders["sell"] - so = await backtest_engine.order_send(request=sell_order.request) - bo = await backtest_engine.order_send(request=buy_order.request) - backtest_engine.fast_forward(steps=22000) - all_pos = await positions.get_positions() - for _ in range(1000): - backtest_engine.fast_forward(steps=1) - await backtest_engine.tracker() - all_pos = await positions.get_positions() - if len(all_pos) == 1: - break - - deal = backtest_engine.deals.history_deals_get(position=bo.order) - bo_profit = deal[-1].profit - assert len(all_pos) == 1 - assert ( - backtest_engine.positions.margin - == backtest_engine._account.margin - == backtest_engine.positions.margins[so.order] - ) - profit = sum([pos.profit for pos in all_pos]) - n_balance = backtest_engine._account.balance - n_equity = backtest_engine._account.equity - assert backtest_engine._account.profit == profit - assert n_balance == balance + bo_profit - assert n_equity == equity + bo_profit + profit - so_pos = await positions.get_position_by_ticket(ticket=so.order) - gain = so_pos.profit - await positions.close_position(position=so_pos) - assert backtest_engine._account.balance == n_balance + gain - backtest_engine.reset(clear_data=True) - - -async def test_wrapup(positions, buy_order, sell_order, backtest_engine, config): - await backtest_engine.setup_account(balance=100) - backtest_engine.fast_forward(steps=500) - bo = await backtest_engine.order_send(request=buy_order) - await backtest_engine.order_send(request=sell_order) - backtest_engine.fast_forward(steps=5000) - await backtest_engine.tracker() - await positions.close_position_by_ticket(ticket=bo.order) - await backtest_engine.wrap_up() - last_balance = backtest_engine._account.balance - last_equity = backtest_engine._account.equity - last_profit = backtest_engine._account.profit - tdata = GetData.load_data(name=config.backtest_dir / f"{backtest_engine.name}.pkl") - new_bte = BackTestEngine(data=tdata, restart=False, assign_to_config=False, preload=False) - assert new_bte._account.balance == last_balance - assert new_bte._account.equity == last_equity - assert new_bte._account.profit == last_profit - assert new_bte.span == backtest_engine.span - assert new_bte.range == backtest_engine.range - assert new_bte.name == backtest_engine.name - assert new_bte.cursor.time == backtest_engine.cursor.time diff --git a/tests/backtest/unit/test_config.py b/tests/backtest/unit/test_config.py deleted file mode 100644 index 70cbeee..0000000 --- a/tests/backtest/unit/test_config.py +++ /dev/null @@ -1,5 +0,0 @@ - -def test_config(config, capsys): - print(config.filename, config.root, config.mode, config.config_file) - assert 6 == 6 - assert config.mode == "backtest" diff --git a/tests/backtest/unit/test_deals_manager.py b/tests/backtest/unit/test_deals_manager.py deleted file mode 100644 index 4f3d13a..0000000 --- a/tests/backtest/unit/test_deals_manager.py +++ /dev/null @@ -1,28 +0,0 @@ -# noinspection PyTestUnpassedFixture -async def test_deals_manager(backtest_engine, sell_order, buy_order, period, positions): - backtest_engine.reset(clear_data=True) - await backtest_engine.setup_account(balance=100) - backtest_engine.fast_forward(steps=100) - await backtest_engine.order_send(request=sell_order) - bo = await backtest_engine.order_send(request=buy_order) - start = period["start"] - end = period["end"] - all_deals = backtest_engine.deals.get_deals_range(date_from=start, date_to=end) - assert len(all_deals) == 2 - backtest_engine.fast_forward(steps=10_000) - start2 = backtest_engine.cursor.time - bo2 = await backtest_engine.order_send(request=buy_order) - backtest_engine.fast_forward(steps=50) - end2 = backtest_engine.cursor.time - deals = backtest_engine.deals.history_deals_get(date_from=start2, date_to=end2) - assert len(deals) == 1 - assert deals[0].order == bo2.order - await positions.close_position_by_ticket(ticket=bo.order) - deals = backtest_engine.deals.history_deals_get(position=bo.order) - assert len(deals) <= 2 - orders = backtest_engine.deals.get_deals_range(date_from=start, date_to=end) - assert ( - len(orders) - == backtest_engine.deals.history_deals_total(date_from=start, date_to=end) - == len(backtest_engine.deals._data.keys()) - ) diff --git a/tests/backtest/unit/test_order_manager.py b/tests/backtest/unit/test_order_manager.py deleted file mode 100644 index e2969c9..0000000 --- a/tests/backtest/unit/test_order_manager.py +++ /dev/null @@ -1,28 +0,0 @@ -# noinspection PyTestUnpassedFixture -async def test_orders_manager(backtest_engine, sell_order, buy_order, period, positions): - backtest_engine.reset(clear_data=True) - await backtest_engine.setup_account(balance=100) - backtest_engine.fast_forward(steps=100) - await backtest_engine.order_send(request=sell_order) - bo = await backtest_engine.order_send(request=buy_order) - start = period["start"] - end = period["end"] - all_orders = backtest_engine.orders.get_orders_range(date_from=start, date_to=end) - assert len(all_orders) == 2 - backtest_engine.fast_forward(steps=10_000) - start2 = backtest_engine.cursor.time - bo2 = await backtest_engine.order_send(request=buy_order) - backtest_engine.fast_forward(steps=50) - end2 = backtest_engine.cursor.time - orders = backtest_engine.orders.history_orders_get(date_from=start2, date_to=end2) - assert len(orders) == 1 - assert orders[0].ticket == bo2.order - await positions.close_position_by_ticket(ticket=bo.order) - orders = backtest_engine.orders.history_orders_get(position=bo.order) - assert len(orders) <= 2 - orders = backtest_engine.orders.get_orders_range(date_from=start, date_to=end) - assert ( - len(orders) - == backtest_engine.orders.history_orders_total(date_from=start, date_to=end) - == len(backtest_engine.orders._data.keys()) - ) diff --git a/tests/backtest/unit/test_positions_manager.py b/tests/backtest/unit/test_positions_manager.py deleted file mode 100644 index 68e16aa..0000000 --- a/tests/backtest/unit/test_positions_manager.py +++ /dev/null @@ -1,17 +0,0 @@ -# noinspection PyTestUnpassedFixture -async def test_positions_manager(backtest_engine, sell_order, buy_order): - backtest_engine.reset(clear_data=True) - await backtest_engine.setup_account(balance=100) - backtest_engine.fast_forward(steps=100) - so = await backtest_engine.order_send(request=sell_order) - bo = await backtest_engine.order_send(request=buy_order) - all_pos = backtest_engine.positions.positions_get() - assert len(all_pos) == 2 - so_positions = backtest_engine.positions.positions_get(ticket=so.order) - so_position = so_positions[0] - assert so_position.ticket == so.order - btc_positions = backtest_engine.positions.positions_get(symbol="BTCUSD") - assert len(btc_positions) == 2 - assert backtest_engine.positions.positions_total() == 2 - backtest_engine.positions.close(ticket=bo.order) - assert backtest_engine.positions.positions_total() == 1 diff --git a/tests/live/conftest.py b/tests/live/conftest.py index ec257fd..5e7cf35 100644 --- a/tests/live/conftest.py +++ b/tests/live/conftest.py @@ -16,7 +16,6 @@ async def cleanup(): shutil.rmtree(Path("tests/live/configs"), ignore_errors=True) Path.unlink(Path("tests/live/test.json"), missing_ok=True) shutil.rmtree(Path("tests/live/trade_records"), ignore_errors=True) - shutil.rmtree(Path("tests/live/backtesting"), ignore_errors=True) await close_all_positions() await MetaTrader().shutdown() except Exception as err: diff --git a/tests/live/integration/legacy/test_bot.py b/tests/live/integration/legacy/test_bot.py deleted file mode 100644 index 755c0e8..0000000 --- a/tests/live/integration/legacy/test_bot.py +++ /dev/null @@ -1,23 +0,0 @@ -import logging - -from aiomql.lib.bot import Bot -from aiomql.contrib.strategies import Chaos -from aiomql.contrib.symbols import ForexSymbol - -logger = logging.getLogger(__name__) - -async def test_bot(): - logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s") - syms = ["BTCUSD", "SOLUSD", "ETHUSD"] - symbols = [ForexSymbol(name=sym) for sym in syms] - strategies = [Chaos(symbol=symbol, name="test_chaos", params={"interval": 3}) for symbol in symbols] - bot = Bot() - bot.executor.timeout = 10 - bot.add_strategies(strategies=strategies) - await bot.initialize() - bot.executor.execute() - assert len(bot.executor.coroutines) == 1 - assert len(bot.executor.coroutine_threads) == 1 - assert len(bot.executor.strategy_runners) == 3 - - assert bot.config.shutdown is True diff --git a/tests/live/integration/legacy/test_bot_sync.py b/tests/live/integration/legacy/test_bot_sync.py deleted file mode 100644 index c3639ff..0000000 --- a/tests/live/integration/legacy/test_bot_sync.py +++ /dev/null @@ -1,20 +0,0 @@ -import logging - -from aiomql.lib.bot import Bot -from aiomql.contrib.strategies import Chaos -from aiomql.contrib.symbols import ForexSymbol - - -def test_bot_sync(): - logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s") - syms = ["BTCUSD", "SOLUSD", "ETHUSD"] - symbols = [ForexSymbol(name=sym) for sym in syms] - strategies = [Chaos(symbol=symbol, name="test_chaos", params={"interval": 3}) for symbol in symbols] - bot = Bot() - bot.executor.timeout = 10 - bot.add_strategies(strategies=strategies) - bot.initialize_sync() - bot.executor.execute() - assert len(bot.executor.strategy_runners) == 3 - assert len(bot.executor.coroutines) == 1 - assert len(bot.executor.coroutine_threads) == 1 diff --git a/tests/live/integration/legacy/test_results_records.py b/tests/live/integration/legacy/test_results_records.py deleted file mode 100644 index df09953..0000000 --- a/tests/live/integration/legacy/test_results_records.py +++ /dev/null @@ -1,110 +0,0 @@ -import asyncio -import json -from csv import DictReader - -import pytest - -from aiomql.lib.result import Result -from aiomql.core.models import OrderSendResult -from aiomql.lib.trade_records import TradeRecords -from aiomql.lib.positions import Positions - - -class TestRecordsAndResults: - @classmethod - def setup_class(cls): - cls.trade_records = TradeRecords() - - @pytest.fixture(scope="class") - async def buy(self, mt): - sym = "BTCUSD" - sym_info = await mt.symbol_info(sym) - dsl = (sym_info.trade_stops_level + sym_info.spread) * 2 * sym_info.point - sl = sym_info.ask - dsl - tp = sym_info.ask + dsl - return { - "action": mt.TRADE_ACTION_DEAL, - "symbol": sym, - "volume": sym_info.volume_min, - "type": mt.ORDER_TYPE_BUY, - "price": sym_info.ask, - "sl": sl, - "tp": tp, - } - - @pytest.fixture(scope="class") - async def sell(self, mt): - sym = "BTCUSD" - sym_info = await mt.symbol_info(sym) - return { - "action": mt.TRADE_ACTION_DEAL, - "symbol": sym, - "volume": sym_info.volume_min, - "type": mt.ORDER_TYPE_SELL, - "price": sym_info.bid, - } - - @pytest.fixture(scope="class", autouse=True) - async def setup(self, sell, buy, mt): - buy_res = await mt.order_send(buy) - buy_res_2 = await mt.order_send(buy) - sell_res = await mt.order_send(sell) - sell_res_2 = await mt.order_send(sell) - buy_res = Result(result=OrderSendResult(**buy_res._asdict()), name="test_result") - sell_res = Result(result=OrderSendResult(**sell_res._asdict()), name="test_result") - sell_res_2 = Result(result=OrderSendResult(**sell_res_2._asdict()), name="test_result") - buy_res_2 = Result(result=OrderSendResult(**buy_res_2._asdict()), name="test_result") - await asyncio.gather( - buy_res.save(), - sell_res.save(), - buy_res_2.save(trade_record_mode="json"), - sell_res_2.save(trade_record_mode="json"), - ) - await Positions().close_all() - - def test_records_dir(self): - records_dir = self.trade_records.records_dir - assert records_dir.is_dir() - recs = list(records_dir.iterdir()) - assert len(recs) >= 2 - csvs, jsons = [], [] - matched_recs = list(records_dir.glob("test_result.*")) - assert len(matched_recs) == 2 - for rec in matched_recs: - if rec.match("test_result.json"): - jsons.append(rec) - elif rec.match("test_result.csv"): - csvs.append(rec) - else: - continue - assert len(csvs) == 1 - assert len(jsons) == 1 - - async def test_json_records(self): - json_records = self.trade_records.get_json_records() - matched_recs = [record for record in json_records if record.match("test_result.json")] - assert len(matched_recs) == 1 - record = matched_recs[0] - record_data = json.load(record.open()) - assert isinstance(record_data, list) - assert len(record_data) == 2 - is_open = [data["closed"] is False for data in record_data] - assert all(is_open) - await self.trade_records.update_json_records() - is_close = [data["closed"] is True for data in record_data] - assert len(is_close) == 2 - - async def test_csv_records(self): - csv_records = self.trade_records.get_csv_records() - matched_recs = [record for record in csv_records if record.match("test_result.csv")] - assert len(matched_recs) == 1 - record = matched_recs[0] - record_data = DictReader(record.open()) - record_data = [row for row in record_data] - assert isinstance(record_data, list) - assert len(record_data) == 2 - is_open = [data["closed"].title() == "False" for data in record_data] - assert all(is_open) - await self.trade_records.update_json_records() - is_close = [data["closed"].title() == "True" for data in record_data] - assert len(is_close) == 2 diff --git a/tests/live/integration/test_bot_integration.py b/tests/live/integration/test_bot_integration.py new file mode 100644 index 0000000..8db04c9 --- /dev/null +++ b/tests/live/integration/test_bot_integration.py @@ -0,0 +1,421 @@ +"""Full integration tests for the Bot class with live MetaTrader 5 connection. + +Tests cover the complete Bot lifecycle including: +- Bot initialization and default state +- Strategy management (add_strategy, add_strategies, add_strategy_all) +- Terminal connection (async and sync) +- Strategy initialization (async and sync, including failures) +- Full execution lifecycle with Executor timeout +- add_function and add_coroutine integration +""" + +import asyncio +import time +import threading +import pytest + +from aiomql.lib.bot import Bot +from aiomql.lib.strategy import Strategy +from aiomql.lib.executor import Executor +from aiomql.lib.symbol import Symbol +from aiomql.core.config import Config +from aiomql.core.meta_trader import MetaTrader +from aiomql.core.exceptions import StopTrading + + +# --------------------------------------------------------------------------- +# Test Strategies +# --------------------------------------------------------------------------- + +class TickLoggerStrategy(Strategy): + """Strategy that logs the current tick and self-terminates.""" + + async def trade(self): + tick = await self.mt5.symbol_info_tick(self.symbol.name) + if tick is not None: + self.parameters["last_bid"] = tick.bid + self.parameters["last_ask"] = tick.ask + self.parameters["executed"] = True + self.running = False + + +class CandleFetchStrategy(Strategy): + """Strategy that fetches the last 5 candles and self-terminates.""" + + async def trade(self): + rates = await self.mt5.copy_rates_from_pos(self.symbol.name, self.mt5.TIMEFRAME_M1, 0, 5) + if rates is not None: + self.parameters["candle_count"] = len(rates) + self.parameters["executed"] = True + self.running = False + + +class FailingStrategy(Strategy): + """Strategy that raises StopTrading to test graceful shutdown.""" + + async def trade(self): + self.parameters["executed"] = True + raise StopTrading("Intentional stop for testing") + + +# --------------------------------------------------------------------------- +# Bot Initialization +# --------------------------------------------------------------------------- + +class TestBotInitialization: + """Test Bot class creation and default state.""" + + def test_bot_creates_executor(self): + """Test Bot creates an Executor on init.""" + bot = Bot() + assert isinstance(bot.executor, Executor) + + def test_bot_default_flags(self): + """Test Bot has correct default flags.""" + bot = Bot() + assert bot.initialized is False + assert bot.login is False + assert bot.strategies == [] + + def test_bot_config_reference(self): + """Test Bot holds a Config reference pointing back to itself.""" + bot = Bot() + assert isinstance(bot.config, Config) + assert bot.config.bot is bot + + def test_bot_has_mt5(self): + """Test Bot creates a MetaTrader instance.""" + bot = Bot() + assert isinstance(bot.mt5, MetaTrader) + + +# --------------------------------------------------------------------------- +# Strategy Management +# --------------------------------------------------------------------------- + +class TestBotStrategyManagement: + """Test adding strategies to the Bot.""" + + def test_add_strategy(self): + """Test adding a single strategy.""" + bot = Bot() + sym = Symbol(name="BTCUSD") + strategy = TickLoggerStrategy(symbol=sym) + bot.add_strategy(strategy=strategy) + assert len(bot.strategies) == 1 + assert bot.strategies[0] is strategy + + def test_add_strategies(self): + """Test adding multiple strategies at once.""" + bot = Bot() + strategies = [ + TickLoggerStrategy(symbol=Symbol(name="BTCUSD")), + CandleFetchStrategy(symbol=Symbol(name="ETHUSD")), + ] + bot.add_strategies(strategies=strategies) + assert len(bot.strategies) == 2 + + def test_add_strategy_all(self): + """Test adding one strategy type across multiple symbols.""" + bot = Bot() + symbols = [Symbol(name="BTCUSD"), Symbol(name="ETHUSD")] + bot.add_strategy_all(strategy=TickLoggerStrategy, symbols=symbols) + assert len(bot.strategies) == 2 + assert all(isinstance(s, TickLoggerStrategy) for s in bot.strategies) + names = {s.symbol.name for s in bot.strategies} + assert names == {"BTCUSD", "ETHUSD"} + + def test_add_strategy_all_with_params(self): + """Test add_strategy_all passes params to each instance.""" + bot = Bot() + symbols = [Symbol(name="BTCUSD")] + bot.add_strategy_all( + strategy=TickLoggerStrategy, + symbols=symbols, + params={"risk": 0.02}, + ) + assert bot.strategies[0].parameters["risk"] == 0.02 + + def test_add_strategy_preserves_order(self): + """Test strategies are added in order.""" + bot = Bot() + s1 = TickLoggerStrategy(symbol=Symbol(name="BTCUSD"), name="first") + s2 = CandleFetchStrategy(symbol=Symbol(name="ETHUSD"), name="second") + bot.add_strategy(strategy=s1) + bot.add_strategy(strategy=s2) + assert bot.strategies[0].name == "first" + assert bot.strategies[1].name == "second" + + +# --------------------------------------------------------------------------- +# Terminal Connection +# --------------------------------------------------------------------------- + +class TestBotTerminalConnection: + """Test terminal initialization and login.""" + + async def test_start_terminal_async(self): + """Test async terminal start sets initialized and login flags.""" + bot = Bot() + result = await bot.start_terminal() + assert result is True + assert bot.initialized is True + assert bot.login is True + + def test_start_terminal_sync(self): + """Test sync terminal start sets initialized and login flags.""" + bot = Bot() + result = bot.start_terminal_sync() + assert result is True + assert bot.initialized is True + assert bot.login is True + + +# --------------------------------------------------------------------------- +# Strategy Initialization +# --------------------------------------------------------------------------- + +class TestBotStrategyInitialization: + """Test strategy initialization through the Bot.""" + + async def test_init_strategy_async(self): + """Test async init_strategy initializes and registers a strategy.""" + bot = Bot() + await bot.start_terminal() + strategy = TickLoggerStrategy(symbol=Symbol(name="BTCUSD")) + result = await bot.init_strategy(strategy=strategy) + assert result is True + assert strategy in bot.executor.strategy_runners + + async def test_init_strategies_async(self): + """Test async init_strategies initializes all strategies.""" + bot = Bot() + await bot.start_terminal() + s1 = TickLoggerStrategy(symbol=Symbol(name="BTCUSD")) + s2 = CandleFetchStrategy(symbol=Symbol(name="ETHUSD")) + bot.add_strategy(strategy=s1) + bot.add_strategy(strategy=s2) + await bot.init_strategies() + assert len(bot.executor.strategy_runners) == 2 + + def test_init_strategy_sync(self): + """Test sync init_strategy_sync initializes and registers a strategy.""" + bot = Bot() + bot.start_terminal_sync() + strategy = TickLoggerStrategy(symbol=Symbol(name="BTCUSD")) + result = bot.init_strategy_sync(strategy=strategy) + assert result is True + assert strategy in bot.executor.strategy_runners + + async def test_init_strategy_invalid_symbol(self): + """Test init_strategy with an invalid symbol returns False.""" + bot = Bot() + await bot.start_terminal() + strategy = TickLoggerStrategy(symbol=Symbol(name="INVALID_SYMBOL_XYZ")) + result = await bot.init_strategy(strategy=strategy) + assert result is False + assert strategy not in bot.executor.strategy_runners + + async def test_init_strategies_partial_failure(self): + """Test init_strategies handles mix of valid and invalid symbols.""" + bot = Bot() + await bot.start_terminal() + s_good = TickLoggerStrategy(symbol=Symbol(name="BTCUSD")) + s_bad = CandleFetchStrategy(symbol=Symbol(name="INVALID_SYMBOL_XYZ")) + bot.add_strategy(strategy=s_good) + bot.add_strategy(strategy=s_bad) + await bot.init_strategies() + # Only the valid strategy should be in the executor + assert len(bot.executor.strategy_runners) == 1 + assert s_good in bot.executor.strategy_runners + + +# --------------------------------------------------------------------------- +# Full Lifecycle – Synchronous (execute) +# --------------------------------------------------------------------------- + +class TestBotFullLifecycle: + """Test full bot execution lifecycle using executor.timeout.""" + + def test_execute_with_tick_logger(self): + """Test execute() runs a TickLoggerStrategy to completion.""" + bot = Bot() + strategy = TickLoggerStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=strategy) + bot.executor.timeout = 3 + bot.execute() + assert strategy.parameters["executed"] is True + assert "last_bid" in strategy.parameters + assert "last_ask" in strategy.parameters + + def test_execute_with_multiple_strategies(self): + """Test execute() runs multiple strategies.""" + bot = Bot() + s1 = TickLoggerStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + s2 = CandleFetchStrategy( + symbol=Symbol(name="ETHUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=s1) + bot.add_strategy(strategy=s2) + bot.executor.timeout = 5 + bot.execute() + assert s1.parameters["executed"] is True + assert s2.parameters["executed"] is True + assert s2.parameters["candle_count"] == 5 + + def test_execute_with_failing_strategy(self): + """Test execute() handles a strategy that raises StopTrading.""" + bot = Bot() + strategy = FailingStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=strategy) + bot.executor.timeout = 3 + bot.execute() + # Strategy should have run and set executed before raising + assert strategy.parameters["executed"] is True + # Strategy should have stopped running + assert strategy.running is False + + def test_execute_no_strategies_sets_shutdown(self): + """Test execute() with no strategies triggers shutdown flag.""" + bot = Bot() + bot.executor.timeout = 2 + bot.execute() + assert bot.config.shutdown is True + + +# --------------------------------------------------------------------------- +# Full Lifecycle – Asynchronous (start) +# --------------------------------------------------------------------------- + +class TestBotAsyncLifecycle: + """Test full async bot lifecycle using executor.timeout.""" + + async def test_start_with_tick_logger(self): + """Test start() runs a TickLoggerStrategy to completion.""" + bot = Bot() + strategy = TickLoggerStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=strategy) + bot.executor.timeout = 3 + await bot.start() + assert strategy.parameters["executed"] is True + + async def test_start_with_candle_fetcher(self): + """Test start() runs a CandleFetchStrategy to completion.""" + bot = Bot() + strategy = CandleFetchStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=strategy) + bot.executor.timeout = 3 + await bot.start() + assert strategy.parameters["executed"] is True + assert strategy.parameters["candle_count"] == 5 + + +# --------------------------------------------------------------------------- +# add_function / add_coroutine +# --------------------------------------------------------------------------- + +class TestBotAddFunctionCoroutine: + """Test add_function and add_coroutine execute during bot lifecycle.""" + + def test_add_function_runs(self): + """Test a function added via add_function is executed.""" + result_holder = {"called": False} + + def mark_called(): + result_holder["called"] = True + + bot = Bot() + strategy = TickLoggerStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=strategy) + bot.add_function(function=mark_called) + bot.executor.timeout = 3 + bot.execute() + assert result_holder["called"] is True + + def test_add_coroutine_runs(self): + """Test a coroutine added via add_coroutine is executed.""" + result_holder = {"called": False} + + async def async_mark(): + result_holder["called"] = True + + bot = Bot() + strategy = TickLoggerStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategy(strategy=strategy) + bot.add_coroutine(coroutine=async_mark, on_separate_thread=True) + bot.executor.timeout = 3 + bot.execute() + assert result_holder["called"] is True + + +# --------------------------------------------------------------------------- +# Mixed Strategy Types +# --------------------------------------------------------------------------- + +class TestBotMixedStrategies: + """Test Bot with a mix of strategies on different symbols.""" + + def test_execute_three_strategies_different_symbols(self): + """Test execute with tick, candle, and failing strategies on different symbols.""" + bot = Bot() + s1 = TickLoggerStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + s2 = CandleFetchStrategy( + symbol=Symbol(name="ETHUSD"), + params={"executed": False}, + ) + s3 = FailingStrategy( + symbol=Symbol(name="BTCUSD"), + params={"executed": False}, + ) + bot.add_strategies(strategies=[s1, s2, s3]) + bot.executor.timeout = 5 + bot.execute() + # All strategies should have executed + assert s1.parameters["executed"] is True + assert s2.parameters["executed"] is True + assert s3.parameters["executed"] is True + # Verify specific strategy results + assert "last_bid" in s1.parameters + assert s2.parameters["candle_count"] == 5 + # Failing strategy should have stopped + assert s3.running is False + + def test_same_strategy_on_multiple_symbols(self): + """Test add_strategy_all runs the same strategy type on multiple symbols.""" + bot = Bot() + symbols = [Symbol(name="BTCUSD"), Symbol(name="ETHUSD")] + bot.add_strategy_all( + strategy=TickLoggerStrategy, + symbols=symbols, + params={"executed": False}, + ) + bot.executor.timeout = 5 + bot.execute() + for s in bot.strategies: + assert s.parameters["executed"] is True + assert "last_bid" in s.parameters diff --git a/tests/live/integration/test_full_integration.py b/tests/live/integration/test_full_integration.py deleted file mode 100644 index 3aa2b3c..0000000 --- a/tests/live/integration/test_full_integration.py +++ /dev/null @@ -1,557 +0,0 @@ -"""Full integration tests for aiomql library in live mode. - -This module tests the integration of all major components: -- Bot initialization and terminal connection -- Multiple strategies running concurrently on different symbols -- Position trackers and tracking functions -- Order creation and management -- State management and configuration - -Note: These tests require a live MetaTrader 5 connection and should be run -with caution on a demo account. -""" - -import pytest -import asyncio -import logging -from unittest.mock import MagicMock, AsyncMock, patch - -from aiomql.lib.bot import Bot -from aiomql.lib.strategy import Strategy -from aiomql.lib.symbol import Symbol -from aiomql.lib.trader import Trader -from aiomql.lib.executor import Executor -from aiomql.lib.order import Order -from aiomql.lib.positions import Positions -from aiomql.lib.account import Account -from aiomql.lib.ram import RAM -from aiomql.core.config import Config -from aiomql.core.state import State -from aiomql.core.constants import OrderType, TimeFrame, TradeAction -from aiomql.contrib.symbols import ForexSymbol -from aiomql.contrib.strategies import Chaos -from aiomql.contrib.trackers import ( - PositionTracker, - OpenPositionsTracker, - OpenPosition, - exit_at_profit, - extend_take_profit -) -from aiomql.contrib.utils.strategy_tracker import StrategyTracker - - -logger = logging.getLogger(__name__) - - -class SimpleTestStrategy(Strategy): - """A simple test strategy for integration testing.""" - - parameters = {"interval": 1, "test_param": "value"} - - def __init__(self, *, symbol: Symbol, params: dict = None, sessions=None, name="TestStrategy"): - super().__init__(symbol=symbol, params=params, sessions=sessions, name=name) - self.trade_count = 0 - self.tracker = StrategyTracker() - - async def trade(self): - """Execute a simple trade iteration.""" - self.trade_count += 1 - self.tracker.update(trend="bullish" if self.trade_count % 2 == 0 else "bearish") - await self.sleep(secs=self.interval) - - -class TrendFollowerStrategy(Strategy): - """A trend following strategy for testing multiple strategy types.""" - - parameters = {"timeframe": TimeFrame.M1, "period": 20} - - def __init__(self, *, symbol: Symbol, params: dict = None, sessions=None, name="TrendFollower"): - super().__init__(symbol=symbol, params=params, sessions=sessions, name=name) - self.signals = [] - - async def trade(self): - """Execute trend following logic.""" - # Simulate checking trend - self.signals.append({"time": asyncio.get_event_loop().time(), "symbol": self.symbol.name}) - await self.sleep(secs=1) - - -class TestBotIntegration: - """Integration tests for Bot class with multiple strategies.""" - - @pytest.fixture - def mock_mt5(self): - """Mock MetaTrader connection for testing.""" - with patch("aiomql.core.meta_trader.MetaTrader") as mock: - mock_instance = MagicMock() - mock_instance.initialize = AsyncMock(return_value=True) - mock_instance.login = AsyncMock(return_value=True) - mock_instance.shutdown = AsyncMock() - mock.return_value = mock_instance - yield mock_instance - - def test_bot_initialization(self): - """Test Bot initializes with correct components.""" - bot = Bot() - - assert bot.config is not None - assert bot.executor is not None - assert bot.mt5 is not None - assert bot.initialized is False - assert bot.login is False - - def test_bot_add_single_strategy(self): - """Test adding a single strategy to bot.""" - bot = Bot() - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = "EURUSD" - - strategy = SimpleTestStrategy(symbol=mock_symbol, name="test_simple") - bot.add_strategy(strategy=strategy) - - assert len(bot.strategies) == 1 - assert bot.strategies[0].name == "test_simple" - - def test_bot_add_multiple_strategies(self): - """Test adding multiple strategies to bot.""" - bot = Bot() - - symbols = [] - for name in ["EURUSD", "GBPUSD", "USDJPY"]: - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = name - symbols.append(mock_symbol) - - strategies = [ - SimpleTestStrategy(symbol=symbols[0], name="strategy_eur"), - TrendFollowerStrategy(symbol=symbols[1], name="strategy_gbp"), - SimpleTestStrategy(symbol=symbols[2], name="strategy_jpy") - ] - - bot.add_strategies(strategies=strategies) - - assert len(bot.strategies) == 3 - - def test_bot_add_coroutine(self): - """Test adding coroutine to bot.""" - bot = Bot() - - async def test_coro(param1="default"): - await asyncio.sleep(0.1) - - bot.add_coroutine(coroutine=test_coro, param1="value") - - assert len(bot.executor.coroutines) == 1 - - def test_bot_add_function(self): - """Test adding synchronous function to bot.""" - bot = Bot() - - def test_func(param1="default"): - pass - - bot.add_function(function=test_func, param1="value") - - assert len(bot.executor.functions) == 1 - - -class TestExecutorIntegration: - """Integration tests for Executor with multiple strategies.""" - - def test_executor_add_strategies(self): - """Test executor can add multiple strategies.""" - executor = Executor() - - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = "EURUSD" - - strategies = [ - SimpleTestStrategy(symbol=mock_symbol, name=f"strategy_{i}") - for i in range(5) - ] - - executor.add_strategies(strategies=tuple(strategies)) - - assert len(executor.strategy_runners) == 5 - - def test_executor_mixed_tasks(self): - """Test executor with strategies, coroutines, and functions.""" - executor = Executor() - - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = "EURUSD" - - # Add strategy - strategy = SimpleTestStrategy(symbol=mock_symbol, name="test") - executor.add_strategy(strategy=strategy) - - # Add coroutine - async def coro(): - pass - executor.add_coroutine(coroutine=coro, kwargs={}) - - # Add function - def func(): - pass - executor.add_function(function=func, kwargs={}) - - assert len(executor.strategy_runners) == 1 - assert len(executor.coroutines) == 1 - assert len(executor.functions) == 1 - - -class TestStrategyIntegration: - """Integration tests for Strategy class.""" - - def test_strategy_initialization(self): - """Test strategy initializes with parameters.""" - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = "EURUSD" - - strategy = SimpleTestStrategy( - symbol=mock_symbol, - name="test_strategy", - params={"custom_param": 100} - ) - - assert strategy.name == "test_strategy" - assert strategy.symbol is mock_symbol - assert strategy.custom_param == 100 - - def test_strategy_tracker_integration(self): - """Test strategy with StrategyTracker.""" - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = "EURUSD" - - strategy = SimpleTestStrategy(symbol=mock_symbol) - - # Simulate trade iterations - strategy.tracker.update(trend="bullish") - assert strategy.tracker.bullish is True - assert strategy.tracker.bearish is False - - strategy.tracker.update(trend="bearish") - assert strategy.tracker.bearish is True - assert strategy.tracker.bullish is False - - def test_multiple_strategy_types(self): - """Test different strategy types can coexist.""" - mock_symbol = MagicMock(spec=Symbol) - mock_symbol.name = "EURUSD" - - simple = SimpleTestStrategy(symbol=mock_symbol, name="simple") - trend = TrendFollowerStrategy(symbol=mock_symbol, name="trend") - - assert simple.name == "simple" - assert trend.name == "trend" - assert simple.parameters != trend.parameters - - -class TestTrackerIntegration: - """Integration tests for position tracking components.""" - - def test_position_tracker_initialization(self): - """Test PositionTracker initialization with OpenPosition.""" - mock_open_position = MagicMock() - mock_open_position.add_tracker = MagicMock() - - async def tracking_func(pos, **kwargs): - pass - tracking_func.__name__ = "tracking_func" - - tracker = PositionTracker( - mock_open_position, - tracking_func, - name="test_tracker", - rank=1, - function_params={"param": "value"} - ) - - assert tracker.name == "test_tracker" - assert tracker.rank == 1 - assert tracker.params == {"param": "value"} - mock_open_position.add_tracker.assert_called_once() - - async def test_position_tracker_execution(self): - """Test PositionTracker executes tracking function.""" - mock_open_position = MagicMock() - mock_open_position.add_tracker = MagicMock() - - call_log = [] - - async def tracking_func(pos, **kwargs): - call_log.append({"pos": pos, "kwargs": kwargs}) - tracking_func.__name__ = "tracking_func" - - tracker = PositionTracker( - mock_open_position, - tracking_func, - function_params={"sl": -10, "tp": 20} - ) - - await tracker() - - assert len(call_log) == 1 - assert call_log[0]["kwargs"]["sl"] == -10 - assert call_log[0]["kwargs"]["tp"] == 20 - - def test_strategy_tracker_state_management(self): - """Test StrategyTracker manages trend state correctly.""" - tracker = StrategyTracker() - - # Initial state - assert tracker.ranging is True - assert tracker.bullish is False - assert tracker.bearish is False - - # Transition to bullish - tracker.update(trend="bullish") - assert tracker.ranging is False - assert tracker.bullish is True - assert tracker.bearish is False - - # Direct to bearish - tracker.update(trend="bearish") - assert tracker.ranging is False - assert tracker.bullish is False - assert tracker.bearish is True - - # Back to ranging - tracker.update(trend="ranging") - assert tracker.ranging is True - assert tracker.bullish is False - assert tracker.bearish is False - - -class TestTrackingFunctionsIntegration: - """Integration tests for position tracking functions.""" - - async def test_exit_at_profit_integration(self): - """Test exit_at_profit with mock position.""" - mock_position = MagicMock() - mock_position.profit = 100.0 - - mock_pos = MagicMock() - mock_pos.symbol = MagicMock() - mock_pos.symbol.name = "EURUSD" - mock_pos.ticket = 12345 - mock_pos.position = mock_position - mock_pos.update_position = AsyncMock(return_value=True) - mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) - - # Should close when profit >= tp - await exit_at_profit(mock_pos, tp=50.0) - - mock_pos.close_position.assert_called_once() - - async def test_exit_at_profit_no_action(self): - """Test exit_at_profit does not close when conditions not met.""" - mock_position = MagicMock() - mock_position.profit = 30.0 # Below tp, above sl - - mock_pos = MagicMock() - mock_pos.position = mock_position - mock_pos.update_position = AsyncMock(return_value=True) - mock_pos.close_position = AsyncMock() - - await exit_at_profit(mock_pos, tp=50.0, sl=-20.0) - - mock_pos.close_position.assert_not_called() - - -class TestStateAndConfigIntegration: - """Integration tests for State and Config components.""" - - def test_config_singleton(self): - """Test Config is singleton.""" - config1 = Config() - config2 = Config() - - assert config1 is config2 - - def test_config_shutdown_flag(self): - """Test config shutdown flag affects all references.""" - config1 = Config() - config2 = Config() - - original_shutdown = config1.shutdown - config1.shutdown = True - - assert config2.shutdown is True - - # Restore - config1.shutdown = original_shutdown - - def test_state_initialization(self): - """Test State can be initialized with key.""" - state = State() - - # State should support dict-like access - assert hasattr(state, "__setitem__") - assert hasattr(state, "__getitem__") - - -class TestMultiSymbolIntegration: - """Integration tests for multiple symbols.""" - - def test_forex_symbol_creation(self): - """Test creating multiple forex symbols.""" - symbols = ["EURUSD", "GBPUSD", "USDJPY", "AUDUSD"] - - forex_symbols = [ForexSymbol(name=sym) for sym in symbols] - - assert len(forex_symbols) == 4 - for i, sym in enumerate(forex_symbols): - assert sym.name == symbols[i] - - def test_strategies_on_different_symbols(self): - """Test strategies assigned to different symbols.""" - symbols = [ - ForexSymbol(name="EURUSD"), - ForexSymbol(name="GBPUSD"), - ForexSymbol(name="USDJPY") - ] - - strategies = [] - for i, symbol in enumerate(symbols): - strategy = SimpleTestStrategy( - symbol=symbol, - name=f"strategy_{symbol.name}", - params={"interval": i + 1} - ) - strategies.append(strategy) - - assert len(strategies) == 3 - assert strategies[0].symbol.name == "EURUSD" - assert strategies[1].symbol.name == "GBPUSD" - assert strategies[2].symbol.name == "USDJPY" - assert strategies[0].interval == 1 - assert strategies[1].interval == 2 - assert strategies[2].interval == 3 - - -class TestFullBotWorkflow: - """Integration tests for complete bot workflow.""" - - async def test_bot_with_chaos_strategy(self): - """Test bot with Chaos strategy from contrib.""" - symbols = [ForexSymbol(name=sym) for sym in ["BTCUSD", "ETHUSD"]] - - strategies = [ - Chaos(symbol=symbol, name=f"chaos_{symbol.name}", params={"interval": 1}) - for symbol in symbols - ] - - bot = Bot() - bot.executor.timeout = 2 # Short timeout for testing - bot.add_strategies(strategies=strategies) - - assert len(bot.strategies) == 2 - assert bot.executor is not None - - async def test_bot_with_mixed_strategies(self): - """Test bot with different strategy types.""" - symbol1 = ForexSymbol(name="EURUSD") - symbol2 = ForexSymbol(name="GBPUSD") - symbol3 = ForexSymbol(name="USDJPY") - - strategies = [ - SimpleTestStrategy(symbol=symbol1, name="simple_eur"), - TrendFollowerStrategy(symbol=symbol2, name="trend_gbp"), - Chaos(symbol=symbol3, name="chaos_jpy", params={"interval": 1}) - ] - - bot = Bot() - bot.executor.timeout = 2 - bot.add_strategies(strategies=strategies) - - assert len(bot.strategies) == 3 - - # Verify different strategy types - strategy_names = [s.name for s in bot.strategies] - assert "simple_eur" in strategy_names - assert "trend_gbp" in strategy_names - assert "chaos_jpy" in strategy_names - - async def test_bot_with_coroutines_and_functions(self): - """Test bot with strategies, coroutines and functions.""" - symbol = ForexSymbol(name="EURUSD") - strategy = SimpleTestStrategy(symbol=symbol, name="test") - - async def monitor_task(interval=1): - """Async monitoring task.""" - await asyncio.sleep(interval) - - def sync_logger(message=""): - """Sync logging function.""" - logger.info(message) - - bot = Bot() - bot.executor.timeout = 2 - bot.add_strategy(strategy=strategy) - bot.add_coroutine(coroutine=monitor_task, interval=1) - bot.add_function(function=sync_logger, message="test") - - assert len(bot.strategies) == 1 - assert len(bot.executor.coroutines) == 1 - assert len(bot.executor.functions) == 1 - - -class TestRAMIntegration: - """Integration tests for Risk Assessment and Management.""" - - def test_ram_initialization(self): - """Test RAM can be initialized with parameters.""" - ram = RAM( - risk_to_reward=2.0, - risk=2.0, - min_amount=10.0, - max_amount=100.0 - ) - - assert ram.risk_to_reward == 2.0 - assert ram.risk == 2.0 - - def test_ram_default_values(self): - """Test RAM has sensible defaults.""" - ram = RAM() - - # RAM should have default attributes - assert hasattr(ram, "risk_to_reward") - assert hasattr(ram, "risk") - assert ram.risk_to_reward == 2 - assert ram.risk == 1 - - -class TestOrderIntegration: - """Integration tests for Order class.""" - - def test_order_creation(self): - """Test Order can be created with required fields.""" - order = Order( - symbol="EURUSD", - volume=0.1, - type=OrderType.BUY, - action=TradeAction.DEAL - ) - - assert order.symbol == "EURUSD" - assert order.volume == 0.1 - assert order.type == OrderType.BUY - assert order.action == TradeAction.DEAL - - def test_order_with_stops(self): - """Test Order can include stop levels.""" - order = Order( - symbol="EURUSD", - volume=0.1, - type=OrderType.BUY, - action=TradeAction.DEAL, - sl=1.0900, - tp=1.1100, - price=1.1000 - ) - - assert order.sl == 1.0900 - assert order.tp == 1.1100 - assert order.price == 1.1000 diff --git a/tests/live/unit/async/test_backtest_engine.py b/tests/live/unit/async/test_backtest_engine.py deleted file mode 100644 index 74e3caa..0000000 --- a/tests/live/unit/async/test_backtest_engine.py +++ /dev/null @@ -1,295 +0,0 @@ -from datetime import datetime, UTC -from math import ceil -from aiomql import TimeFrame -from aiomql.core.backtesting import BackTestEngine -from aiomql.core.backtesting.get_data import GetData -from aiomql.utils import round_down -from aiomql.core.constants import OrderType, TradeAction - -import pytest - - -class TestBackTestEngine: - @classmethod - def setup_class(cls): - cls.start = datetime(2024, 2, 1) - cls.end = datetime(2024, 2, 7) - cls.g_data = GetData( - start=cls.start, - end=cls.end, - symbols=["BTCUSD", "SOLUSD"], - timeframes=[TimeFrame.H1, TimeFrame.H2], - name="test_engine", - ) - cls.bte = BackTestEngine(start=cls.start, end=cls.end, assign_to_config=True, preload=False) - - @pytest.fixture(scope="class") - async def bte2(self): - await self.g_data.get_data() - bte2 = BackTestEngine(start=self.start, end=self.end, data=self.g_data.data, use_terminal=False, preload=False) - await bte2.setup_account(balance=100) - return bte2 - - @pytest.fixture(scope="class") - async def sell_order(self): - sym = await self.bte.get_symbol_info(symbol="BTCUSD") - request = { - "type": OrderType.SELL, - "symbol": "BTCUSD", - "volume": sym.volume_min, - "price": sym.bid, - "action": TradeAction.DEAL, - } - return request - - @pytest.fixture(scope="class") - async def buy_order(self): - sym = await self.bte.get_symbol_info(symbol="BTCUSD") - dsl = (sym.trade_stops_level + sym.spread) * 2 * sym.point - sl = sym.ask - dsl - tp = sym.ask + dsl - request = { - "type": OrderType.BUY, - "symbol": "BTCUSD", - "volume": sym.volume_min, - "price": sym.ask, - "action": TradeAction.DEAL, - "sl": sl, - "tp": tp, - } - return request - - def modify_stops(self, order): - ... - - def test_span_and_range(self): - assert self.bte.range == range(0, int((self.end - self.start).total_seconds()), self.bte.speed) - assert self.bte.span == range(int(self.start.timestamp()), int(self.end.timestamp()), self.bte.speed) - assert len(self.bte.span) == len(self.bte.range) - - def test_cursor(self): - self.bte.next() - r, t = self.bte.cursor - self.bte.fast_forward(steps=100) - assert self.bte.cursor.time == t + 100 * self.bte.speed - assert self.bte.cursor.index == r + 100 * self.bte.speed - print(datetime.fromtimestamp(self.bte.cursor.time, tz=UTC), "test_cursor") - go_to = datetime(2024, 2, 6, tzinfo=UTC) - self.bte.go_to(time=go_to) - assert self.bte.cursor.time == int(datetime.timestamp(go_to)) - self.bte.reset() - assert self.bte.cursor.time == int(self.start.timestamp()) - - def test_speed(self): - self.bte.setup_test_range(start=self.start, end=self.end, speed=3600) - assert self.bte.speed == 3600 - self.bte.next() - now = datetime.fromtimestamp(self.bte.cursor.time, tz=UTC) - index = self.bte.cursor.index - self.bte.next() - assert self.bte.cursor.index == index + 3600 - assert self.bte.cursor.time == int(now.timestamp()) + 3600 - self.bte.setup_test_range(start=self.start, end=self.end) - assert self.bte.speed == 60 - - async def test_account(self): - await self.bte.setup_account(balance=100) - acc = self.bte.get_account_info() - self.bte.use_terminal_for_backtesting = False - self.bte.use_terminal_for_backtesting = True - assert acc.balance == 100 - assert acc.equity == 100 - assert acc.margin == 0 - assert acc.margin_free == 100 - assert acc.margin_level == 0 - self.bte.deposit(amount=50) - acc = self.bte.get_account_info() - assert acc.balance == 150 - assert acc.equity == 150 - assert acc.margin == 0 - assert acc.margin_free == 150 - assert acc.margin_level == 0 - self.bte.withdraw(amount=80) - acc = self.bte.get_account_info() - assert acc.balance == 70 - assert acc.equity == 70 - assert acc.margin == 0 - assert acc.margin_free == 70 - assert acc.margin_level == 0 - self.bte.update_account(profit=-5) - acc = self.bte.get_account_info() - assert acc.equity == 65 - assert acc.balance == 70 - assert acc.profit == -5 - assert acc.margin == 0 - assert acc.margin_free == 65 - assert acc.margin_level == 0 - self.bte.update_account(margin=2.5) - acc = self.bte.get_account_info() - assert acc.balance == 70 - assert acc.equity == 65 - assert acc.margin == 2.5 - assert acc.margin_free == 62.5 - assert acc.margin_level == 2600 - - def test_account_sync(self): - balance = 200 - self.bte.setup_account_sync(balance=balance) - acc = self.bte.get_account_info() - assert acc.balance == balance - - async def test_bte2_init(self, bte2): - assert bte2._data.fully_loaded is True - assert bte2.span == self.bte.span - assert bte2.range == self.bte.range - assert bte2.use_terminal is False - - async def test_get_rates_from(self): - start = datetime(2024, 2, 3, 12, 43, tzinfo=UTC) - rates = await self.bte.get_rates_from(symbol="BTCUSD", timeframe=TimeFrame.H1, date_from=start, count=24) - assert len(rates) == 24 - - async def test_get_rates_from_2(self, bte2): - start = datetime(2024, 2, 3, 12, 12, tzinfo=UTC) - rates = await bte2.get_rates_from(symbol="BTCUSD", timeframe=TimeFrame.H1, date_from=start, count=24) - assert len(rates) == 24 - - async def test_get_rates_from_pos(self): - now = datetime(2024, 2, 3, 11, 55, tzinfo=UTC) - self.bte.go_to(time=now) - tf = TimeFrame.H2 - start_pos = 2 - rates = await self.bte.get_rates_from_pos(symbol="BTCUSD", timeframe=tf, start_pos=start_pos, count=24) - assert len(rates) == 24 - assert int(rates[-1][0]) == round_down(int(now.replace(hour=now.hour - start_pos).timestamp()), tf.seconds) - - async def test_get_rates_from_pos2(self, bte2): - now = datetime(2024, 2, 4, 12, 15, tzinfo=UTC) - bte2.go_to(time=now) - tf = TimeFrame.H1 - start_pos = 2 - rates = await bte2.get_rates_from_pos(symbol="BTCUSD", timeframe=tf, start_pos=start_pos, count=24) - assert int(rates[-1][0]) == round_down(int(now.replace(hour=10).timestamp()), tf.seconds) - # assert int(rates[-1][0]) == round_up(int(now.timestamp()), tf.seconds) - start_pos * tf.seconds - assert len(rates) == 24 - - async def test_get_rates_range(self): - start = datetime(2024, 2, 3, 12, tzinfo=UTC) - end = datetime(2024, 2, 4, 18, tzinfo=UTC) - rates = await self.bte.get_rates_range(symbol="BTCUSD", timeframe=TimeFrame.H1, date_from=start, date_to=end) - assert len(rates) == 31 - assert int(rates[-1][0]) == int(end.timestamp()) - - async def test_get_rates_range2(self, bte2): - start = datetime(2024, 2, 3, 12, tzinfo=UTC) - end = datetime(2024, 2, 4, 18, tzinfo=UTC) - rates = await bte2.get_rates_range(symbol="BTCUSD", timeframe=TimeFrame.H1, date_from=start, date_to=end) - assert len(rates) == 31 - assert int(rates[-1][0]) == int(end.timestamp()) - - async def test_get_ticks_from(self): - start = datetime(2024, 2, 3, 12, tzinfo=UTC) - ticks = await self.bte.get_ticks_from(symbol="BTCUSD", date_from=start, count=24) - assert len(ticks) == 24 - - async def test_get_ticks_from2(self, bte2): - start = datetime(2024, 2, 3, 12, tzinfo=UTC) - ticks = await bte2.get_ticks_from(symbol="BTCUSD", date_from=start, count=24) - assert len(ticks) == 24 - - async def test_get_ticks_range(self): - start = datetime(2024, 2, 3, 12, tzinfo=UTC) - end = datetime(2024, 2, 3, 15, tzinfo=UTC) - ticks = await self.bte.get_ticks_range(symbol="BTCUSD", date_from=start, date_to=end) - approx_total = (end - start).total_seconds() // 2 # assuming 2 ticks per second at least - assert len(ticks) >= approx_total - - async def test_get_ticks_range2(self, bte2): - start = datetime(2024, 2, 3, 12, tzinfo=UTC) - end = datetime(2024, 2, 3, 15, tzinfo=UTC) - ticks = await bte2.get_ticks_range(symbol="BTCUSD", date_from=start, date_to=end) - approx_total = (end - start).total_seconds() // 2 # assuming 2 ticks per second at least - assert len(ticks) >= approx_total - - async def test_price_tick(self, bte2): - moment = datetime(2024, 2, 3, 12, 12, tzinfo=UTC) - self.bte.reset() - self.bte.go_to(time=moment) - tick = await self.bte.get_price_tick(symbol="BTCUSD", time=self.bte.cursor.time) - assert tick is not None - assert isinstance(tick.ask, float) - assert tick.ask > 0 - bte2.reset() - bte2.go_to(time=moment) - tick2 = await bte2.get_price_tick(symbol="BTCUSD", time=bte2.cursor.time) - assert tick.ask == tick2.ask - - async def test_get_symbol_info(self, bte2): - moment = datetime(2024, 2, 3, 12, 12, tzinfo=UTC) - self.bte.reset() - self.bte.go_to(time=moment) - bte2.reset() - bte2.go_to(time=moment) - sym = "BTCUSD" - sym_info = await self.bte.get_symbol_info(symbol=sym) - assert sym_info is not None - assert sym_info.name == sym - sym_info2 = await bte2.get_symbol_info(symbol=sym) - assert sym_info.ask == sym_info2.ask - - async def test_order_profit(self, bte2): - moment = datetime(2024, 2, 3, 12, 12, tzinfo=UTC) - self.bte.reset() - self.bte.go_to(time=moment) - bte2.reset() - bte2.go_to(time=moment) - sym = "BTCUSD" - sym_info = await self.bte.get_symbol_info(symbol=sym) - dsl = (sym_info.trade_stops_level + sym_info.spread) * 2 * sym_info.point - tp = sym_info.ask + dsl - - profit = await self.bte.order_calc_profit( - action=OrderType.BUY, symbol=sym, volume=sym_info.volume_min, price_open=sym_info.ask, price_close=tp - ) - assert profit > 0 - sym_info2 = await bte2.get_symbol_info(symbol=sym) - dsl2 = (sym_info2.trade_stops_level + sym_info2.spread) * 2 * sym_info2.point - tp2 = sym_info2.ask + dsl2 - profit2 = await bte2.order_calc_profit( - action=OrderType.BUY, symbol=sym, volume=sym_info2.volume_min, price_open=sym_info2.ask, price_close=tp2 - ) - assert ceil(profit) == ceil(profit2) - - async def test_order_margin(self, bte2): - moment = datetime(2024, 2, 3, 12, 12, tzinfo=UTC) - self.bte.reset() - self.bte.go_to(time=moment) - bte2.reset() - bte2.go_to(time=moment) - sym = "BTCUSD" - sym_info = await self.bte.get_symbol_info(symbol=sym) - margin = await self.bte.order_calc_margin( - action=OrderType.SELL, symbol=sym, volume=sym_info.volume_min, price=sym_info.bid - ) - assert margin > 0 - sym_info2 = await self.bte.get_symbol_info(symbol=sym) - margin2 = await bte2.order_calc_margin( - action=OrderType.SELL, symbol=sym, volume=sym_info2.volume_min, price=sym_info2.bid - ) - assert margin2 > 0 - - async def test_order_check(self, buy_order, sell_order): - ocr = await self.bte.order_check(request=buy_order) - assert ocr is not None - assert ocr.retcode == 0 - ocr2 = await self.bte.order_check(request=sell_order) - assert ocr2 is not None - assert ocr2.retcode == 0 - - async def test_order_send(self, buy_order, sell_order): - ocr = await self.bte.order_send(request=buy_order) - assert ocr is not None - assert ocr.retcode == 10009 - ocr2 = await self.bte.order_send(request=sell_order) - assert ocr2 is not None - assert ocr2.retcode == 10009 diff --git a/tests/live/unit/async/test_base.py b/tests/live/unit/async/test_base.py index 755e206..2c765a3 100644 --- a/tests/live/unit/async/test_base.py +++ b/tests/live/unit/async/test_base.py @@ -1,225 +1,564 @@ -"""Comprehensive tests for the Base and _Base classes. +"""Comprehensive tests for the base module. Tests cover: -- Base class initialization and attribute handling -- Dictionary conversion with include/exclude filtering -- Annotations and class variables -- _Base class MetaTrader and Config integration -- Pickling/serialization support -- Mode switching (async/sync) +- Base class initialization, set_attributes, repr, annotations, dict, get_dict, class_vars +- BaseMeta metaclass lazy setup behavior +- _Base class with MetaTrader/Config integration and pickling support +- Subclassing and annotation/exclude/include merging """ import enum +import pickle +from unittest.mock import patch, MagicMock + import pytest -from aiomql.core.base import Base, _Base + +from aiomql.core.base import Base, _Base, BaseMeta from aiomql.core.config import Config from aiomql.core.meta_trader import MetaTrader +from aiomql.core.sync.meta_trader import MetaTrader as MetaTraderSync -class ChildClass(Base): - attr: int - attr2: str - cls_attr: int = 10 +# --------------------------------------------------------------------------- +# Helper subclasses for testing +# --------------------------------------------------------------------------- - -class ChildBaseClass(_Base): - """Test subclass of _Base for testing MT5/Config integration.""" - attr: int - attr2: str - cls_attr: int = 20 - - -class TestEnum(enum.Enum): - """Test enum for repr testing.""" - VALUE_A = 1 - VALUE_B = 2 - - -class EnumChild(Base): - """Test class with enum attribute.""" +class SimpleModel(Base): + """A simple Base subclass with typed annotations.""" name: str - status: TestEnum + value: int + score: float -class TestBaseClass: - """Tests for the Base class.""" +class ExtendedModel(SimpleModel): + """A child of SimpleModel adding more annotations.""" + extra: str + value: float # override parent's int annotation with float - @pytest.fixture - def child(self): - return ChildClass(attr=1, attr2="test") - def test_repr(self, child): - repr_str = repr(child) - assert repr_str.startswith("ChildClass(") - assert "attr=1" in repr_str - assert "attr2=test" in repr_str +class CustomExcludeModel(Base): + """A model with a custom exclude set.""" + exclude: set[str] = {"mt5", "config", "exclude", "include", "annotations", "class_vars", "dict", "_instance", + "mode", "secret"} + name: str + secret: str + visible: int - def test_repr_with_enum(self): - """Test repr correctly displays enum values.""" - obj = EnumChild(name="test", status=TestEnum.VALUE_A) - repr_str = repr(obj) - assert "name=test" in repr_str - assert "VALUE_A" in repr_str - def test_repr_truncates_long_attributes(self): - """Test repr truncates when there are more than 3 attributes.""" - class ManyAttrs(Base): - a: int - b: int - c: int - d: int - e: int +class CustomIncludeModel(Base): + """A model with a custom include set that overrides exclude.""" + include: set[str] = {"config"} + name: str + config: str - obj = ManyAttrs(a=1, b=2, c=3, d=4, e=5) - repr_str = repr(obj) - assert "..." in repr_str - assert "a=1" in repr_str - assert "e=5" in repr_str - def test_set_attributes(self, child): - child.set_attributes(attr3=3.14, attr2="str") - assert child.attr2 == "str" - assert getattr(child, "attr3", None) is None +class ModelWithClassVar(Base): + """A model with annotated class-level defaults.""" + name: str + kind: str = "default_kind" - def test_set_attributes_type_conversion(self): - """Test set_attributes converts types based on annotations.""" - child = ChildClass(attr="42", attr2=123) - assert child.attr == 42 - assert child.attr2 == "123" - def test_annotations(self, child): - annotations = child.annotations - assert isinstance(annotations, dict) - assert "attr" in annotations - assert "attr2" in annotations +class EnumColor(enum.Enum): + RED = 1 + GREEN = 2 + BLUE = 3 - def test_annotations_includes_parent_classes(self): - """Test annotations includes attributes from parent classes.""" - class GrandChild(ChildClass): - extra: float - grandchild = GrandChild(attr=1, attr2="test", extra=3.14) - annotations = grandchild.annotations - assert "attr" in annotations - assert "attr2" in annotations - assert "extra" in annotations +class ModelWithEnum(Base): + """A model containing an enum attribute.""" + name: str + color: EnumColor + score: float - def test_get_dict(self, child): - child.set_attributes(attr2="test") - result = child.get_dict() - assert result["attr"] == 1 - assert result["attr2"] == "test" - def test_get_dict_with_exclude(self, child): - child.set_attributes(attr2="test") - result = child.get_dict(exclude={"attr"}) - assert "attr" not in result - assert result["attr2"] == "test" +class ManyAttrsModel(Base): + """A model with > 3 simple-typed attributes.""" + a: int + b: int + c: int + d: int + e: int - def test_get_dict_with_include(self, child): - child.set_attributes(attr3=3.14) - result = child.get_dict(include={"attr"}) - assert result["attr"] == 1 - assert "attr2" not in result - def test_get_dict_include_takes_precedence(self, child): - """Test that include takes precedence over exclude.""" - result = child.get_dict(include={"attr"}, exclude={"attr"}) - assert "attr" in result +class ModelWithComplexAttr(Base): + """A model with complex (non-simple) attributes.""" + name: str + data: list + meta: dict - def test_class_vars(self, child): - class_vars = child.class_vars - assert isinstance(class_vars, dict) - assert "cls_attr" in class_vars - assert "attr" not in class_vars - def test_dict_property(self, child): - child.set_attributes(attr2="test") - dict_prop = child.dict - assert dict_prop["attr"] == 1 - assert dict_prop["attr2"] == "test" - assert dict_prop["cls_attr"] == 10 +class SyncBaseModel(_Base): + """A _Base subclass operating in sync mode.""" + mode = "sync" + name: str + + +class AsyncBaseModel(_Base): + """A _Base subclass operating in async (default) mode.""" + name: str + + +# =========================================================================== +# TestBaseInit +# =========================================================================== + + +class TestBaseInit: + """Tests for Base.__init__ and set_attributes.""" + + def test_init_sets_annotated_attributes(self): + """Init with valid annotated kwargs sets attributes.""" + obj = SimpleModel(name="hello", value=42, score=3.14) + assert obj.name == "hello" + assert obj.value == 42 + assert obj.score == 3.14 + + def test_init_ignores_non_annotated_kwargs(self): + """Non-annotated kwargs are silently ignored.""" + obj = SimpleModel(name="hello", value=1, score=0.0, unknown="ignored") + assert not hasattr(obj, "unknown") + + def test_init_coerces_types(self): + """Annotation callables are used to coerce values.""" + obj = SimpleModel(name="hello", value="99", score="2.5") + assert obj.value == 99 + assert isinstance(obj.value, int) + assert obj.score == 2.5 + assert isinstance(obj.score, float) + + def test_init_fallback_on_conversion_error(self): + """When coercion raises ValueError/TypeError, raw value is kept.""" + obj = SimpleModel(name="hello", value="not_a_number", score=1.0) + # value should be set as the raw string since int("not_a_number") raises ValueError + assert obj.value == "not_a_number" + + def test_init_no_args(self): + """Init with no args creates an instance with no instance attributes.""" + obj = SimpleModel() + assert isinstance(obj, SimpleModel) + # No instance attributes should be set + assert "name" not in obj.__dict__ + assert "value" not in obj.__dict__ + + def test_set_attributes_updates_existing(self): + """set_attributes can update existing attributes.""" + obj = SimpleModel(name="original", value=1, score=0.0) + obj.set_attributes(name="updated", value=100) + assert obj.name == "updated" + assert obj.value == 100 + + def test_set_attributes_ignores_unannotated(self): + """set_attributes ignores keys not in annotations.""" + obj = SimpleModel(name="test", value=1, score=0.0) + obj.set_attributes(phantom="ghost") + assert not hasattr(obj, "phantom") + + +# =========================================================================== +# TestBaseRepr +# =========================================================================== + + +class TestBaseRepr: + """Tests for Base.__repr__.""" + + def test_repr_with_few_attrs(self): + """Repr with ≤3 simple-type attrs shows all.""" + obj = SimpleModel(name="test", value=42, score=1.5) + r = repr(obj) + assert r.startswith("SimpleModel(") + assert "name=test" in r + assert "value=42" in r + assert "score=1.5" in r + + def test_repr_with_many_attrs_truncates(self): + """Repr with > 3 attrs shows first 3 + ... + last 1.""" + obj = ManyAttrsModel(a=1, b=2, c=3, d=4, e=5) + r = repr(obj) + assert "..." in r + assert "a=1" in r + assert "e=5" in r + + def test_repr_excludes_private_attrs(self): + """Repr excludes attributes starting with _.""" + obj = SimpleModel(name="test", value=1, score=0.0) + obj._private = "hidden" + r = repr(obj) + assert "_private" not in r + + def test_repr_excludes_complex_types(self): + """Repr excludes list and dict attrs.""" + obj = ModelWithComplexAttr(name="test", data=[1, 2, 3], meta={"k": "v"}) + r = repr(obj) + assert "data=" not in r + assert "meta=" not in r + assert "name=test" in r + + def test_repr_includes_enum_values(self): + """Repr includes enum attributes.""" + obj = ModelWithEnum(name="test", color=EnumColor.RED, score=1.0) + r = repr(obj) + assert "color=" in r + + def test_repr_empty_instance(self): + """Repr of instance with no attributes.""" + obj = SimpleModel() + r = repr(obj) + assert r == "SimpleModel()" + + +# =========================================================================== +# TestBaseAnnotations +# =========================================================================== + + +class TestBaseAnnotations: + """Tests for the annotations property.""" + + def test_annotations_returns_own_annotations(self): + """annotations includes annotations from the class itself.""" + obj = SimpleModel(name="x", value=1, score=0.0) + annots = obj.annotations + assert "name" in annots + assert "value" in annots + assert "score" in annots + + def test_annotations_merges_parent(self): + """annotations includes parent class annotations.""" + obj = ExtendedModel(name="x", value=1, score=0.0, extra="e") + annots = obj.annotations + assert "name" in annots # from SimpleModel + assert "score" in annots # from SimpleModel + assert "extra" in annots # from ExtendedModel + + def test_annotations_child_overrides_parent(self): + """Child annotations override parent annotations.""" + obj = ExtendedModel(name="x", value=1, score=0.0, extra="e") + annots = obj.annotations + # ExtendedModel annotates value as float, overriding SimpleModel's int + assert annots["value"] is float + + def test_annotations_returns_dict(self): + """annotations property returns a dict.""" + obj = SimpleModel(name="x", value=1, score=0.0) + assert isinstance(obj.annotations, dict) + + +# =========================================================================== +# TestBaseClassVars +# =========================================================================== + + +class TestBaseClassVars: + """Tests for the class_vars property.""" + + def test_class_vars_includes_annotated_defaults(self): + """class_vars includes annotated class-level variables with defaults.""" + obj = ModelWithClassVar(name="test") + cv = obj.class_vars + assert "kind" in cv + assert cv["kind"] == "default_kind" + + def test_class_vars_excludes_non_annotated(self): + """class_vars excludes class variables that are not annotated.""" + obj = SimpleModel(name="x", value=1, score=0.0) + cv = obj.class_vars + # 'exclude' and 'include' are defined on Base but not annotated on SimpleModel + # However they ARE annotated on Base itself, so they will appear in class_vars + # The key point is that non-annotated attrs are excluded + for key in cv: + assert key in obj.annotations + + +# =========================================================================== +# TestBaseDict +# =========================================================================== + + +class TestBaseDict: + """Tests for the dict property.""" + + def test_dict_returns_instance_and_class_attrs(self): + """dict combines instance attributes and class_vars.""" + obj = ModelWithClassVar(name="test") + d = obj.dict + assert "name" in d + assert d["name"] == "test" + assert "kind" in d + assert d["kind"] == "default_kind" + + def test_dict_excludes_default_excluded_keys(self): + """dict excludes keys in the exclude set.""" + obj = SimpleModel(name="test", value=1, score=0.0) + d = obj.dict + assert "mt5" not in d + assert "config" not in d + assert "exclude" not in d + assert "include" not in d + assert "annotations" not in d + assert "class_vars" not in d def test_dict_excludes_none_values(self): - """Test dict property excludes None values.""" - class OptionalAttr(Base): - required: int - optional: str = None + """dict excludes attributes with None values.""" + obj = SimpleModel(name="test", value=1, score=0.0) + obj.name = None # Manually set to None + d = obj.dict + assert "name" not in d - obj = OptionalAttr(required=1) - assert "optional" not in obj.dict + def test_dict_include_overrides_exclude(self): + """include set can override exclude behavior.""" + obj = CustomIncludeModel(name="test", config="my_config") + d = obj.dict + # 'config' is normally excluded, but CustomIncludeModel includes it + assert "config" in d - def test_dict_excludes_internal_attributes(self, child): - """Test dict excludes internal attributes like mt5, config.""" - dict_prop = child.dict - assert "mt5" not in dict_prop - assert "config" not in dict_prop - assert "exclude" not in dict_prop - assert "include" not in dict_prop + def test_dict_custom_exclude(self): + """Custom exclude set hides specific attrs.""" + obj = CustomExcludeModel(name="visible_name", secret="hidden", visible=42) + d = obj.dict + assert "name" in d + assert "visible" in d + assert "secret" not in d -class TestUnderscoreBaseClass: - """Tests for the _Base class with MT5/Config integration.""" +# =========================================================================== +# TestBaseGetDict +# =========================================================================== - @pytest.fixture - def base_child(self): - return ChildBaseClass(attr=1, attr2="test") - def test_has_mt5_attribute(self, base_child): - """Test _Base provides mt5 attribute.""" - assert hasattr(base_child, "mt5") +class TestBaseGetDict: + """Tests for the get_dict method.""" - def test_has_config_attribute(self, base_child): - """Test _Base provides config attribute.""" - assert hasattr(base_child, "config") - assert isinstance(base_child.config, Config) + def test_get_dict_no_args(self): + """get_dict with no args returns all non-None dict items.""" + obj = SimpleModel(name="test", value=1, score=2.5) + d = obj.get_dict() + assert "name" in d + assert "value" in d + assert "score" in d - def test_mt5_is_metatrader_instance(self, base_child): - """Test mt5 is a MetaTrader instance in async mode.""" - # Default mode is async - assert isinstance(base_child.mt5, MetaTrader) + def test_get_dict_include(self): + """get_dict with include filters to specific keys.""" + obj = SimpleModel(name="test", value=1, score=2.5) + d = obj.get_dict(include={"name", "score"}) + assert "name" in d + assert "score" in d + assert "value" not in d - def test_config_is_shared(self): - """Test config is shared across instances.""" - child1 = ChildBaseClass(attr=1, attr2="test1") - child2 = ChildBaseClass(attr=2, attr2="test2") - assert child1.config is child2.config + def test_get_dict_exclude(self): + """get_dict with exclude filters out specific keys.""" + obj = SimpleModel(name="test", value=1, score=2.5) + d = obj.get_dict(exclude={"value"}) + assert "value" not in d + assert "name" in d + assert "score" in d - def test_mt5_is_shared(self): - """Test mt5 is shared across instances.""" - child1 = ChildBaseClass(attr=1, attr2="test1") - child2 = ChildBaseClass(attr=2, attr2="test2") - assert child1.mt5 is child2.mt5 + def test_get_dict_include_overrides_exclude(self): + """When both include and exclude are set, include takes precedence.""" + obj = SimpleModel(name="test", value=1, score=2.5) + d = obj.get_dict(include={"name"}, exclude={"name"}) + assert "name" in d + assert "value" not in d - def test_getstate_excludes_mt5(self, base_child): - """Test __getstate__ excludes mt5 for pickling.""" - state = base_child.__getstate__() + def test_get_dict_excludes_none_values(self): + """get_dict always excludes None values regardless of filters.""" + obj = SimpleModel(name="test", value=1, score=2.5) + obj.score = None + d = obj.get_dict(include={"name", "score"}) + assert "name" in d + assert "score" not in d + + +# =========================================================================== +# TestBaseMeta +# =========================================================================== + + +class TestBaseMeta: + """Tests for the BaseMeta metaclass behavior.""" + + def test_instantiation_triggers_setup(self): + """Instantiating a _Base subclass triggers _setup.""" + obj = AsyncBaseModel(name="test") + assert hasattr(AsyncBaseModel, "config") + assert hasattr(AsyncBaseModel, "mt5") + + def test_accessing_config_on_class_triggers_setup(self): + """Accessing 'config' on a _Base subclass class triggers _setup.""" + # Create a fresh class to test lazy setup + class FreshModel(_Base): + name: str + + _ = FreshModel.config + assert isinstance(FreshModel.__dict__["config"], Config) + + def test_accessing_mt5_on_class_triggers_setup(self): + """Accessing 'mt5' on a _Base subclass class triggers _setup.""" + class FreshModel2(_Base): + name: str + + _ = FreshModel2.mt5 + assert isinstance(FreshModel2.__dict__["mt5"], MetaTrader) + + def test_setup_creates_config_instance(self): + """_setup sets config as a Config instance.""" + class TestSetupConfig(_Base): + name: str + + TestSetupConfig._setup() + assert isinstance(TestSetupConfig.__dict__["config"], Config) + + def test_setup_creates_async_meta_trader_by_default(self): + """_setup creates MetaTrader (async) when mode is not 'sync'.""" + class TestAsyncMT(_Base): + name: str + + TestAsyncMT._setup() + assert isinstance(TestAsyncMT.__dict__["mt5"], MetaTrader) + + def test_setup_creates_sync_meta_trader_for_sync_mode(self): + """_setup creates MetaTraderSync when mode is 'sync'.""" + class TestSyncMT(_Base): + mode = "sync" + name: str + + TestSyncMT._setup() + assert isinstance(TestSyncMT.__dict__["mt5"], MetaTraderSync) + + def test_setup_is_idempotent(self): + """Calling _setup twice doesn't recreate config/mt5.""" + class IdempotentModel(_Base): + name: str + + IdempotentModel._setup() + config1 = IdempotentModel.__dict__["config"] + mt5_1 = IdempotentModel.__dict__["mt5"] + + IdempotentModel._setup() + config2 = IdempotentModel.__dict__["config"] + mt5_2 = IdempotentModel.__dict__["mt5"] + + assert config1 is config2 + assert mt5_1 is mt5_2 + + +# =========================================================================== +# TestBasePrivateBase +# =========================================================================== + + +class TestBasePrivateBase: + """Tests for the _Base class.""" + + def test_inherits_from_base(self): + """_Base inherits from Base.""" + assert issubclass(_Base, Base) + + def test_has_base_meta_metaclass(self): + """_Base uses BaseMeta as its metaclass.""" + assert type(_Base) is BaseMeta + + def test_default_mode_is_async(self): + """Default mode for _Base is 'async'.""" + assert _Base.mode == "async" + + def test_getstate_removes_mt5(self): + """__getstate__ removes mt5 from instance state.""" + obj = AsyncBaseModel(name="test") + obj.mt5_attr = "should_stay" # custom attr + state = obj.__getstate__() assert "mt5" not in state - def test_getstate_preserves_other_attributes(self, base_child): - """Test __getstate__ preserves other instance attributes.""" - state = base_child.__getstate__() - assert state["attr"] == 1 - assert state["attr2"] == "test" + def test_getstate_preserves_other_attrs(self): + """__getstate__ keeps all attributes except mt5.""" + obj = AsyncBaseModel(name="test_name") + state = obj.__getstate__() + assert state.get("name") == "test_name" - def test_inherits_from_base(self, base_child): - """Test _Base inherits from Base.""" - assert isinstance(base_child, Base) + def test_config_accessible_after_instantiation(self): + """config is accessible as a class attribute after instantiation.""" + obj = AsyncBaseModel(name="test") + assert isinstance(obj.config, Config) - def test_dict_property_works(self, base_child): - """Test dict property works correctly.""" - dict_prop = base_child.dict - assert dict_prop["attr"] == 1 - assert dict_prop["attr2"] == "test" - assert dict_prop["cls_attr"] == 20 + def test_mt5_accessible_after_instantiation(self): + """mt5 is accessible as a class attribute after instantiation.""" + obj = AsyncBaseModel(name="test") + assert isinstance(obj.mt5, MetaTrader) - def test_mode_attribute(self, base_child): - """Test default mode is async.""" - assert base_child.mode == "async" + def test_sync_mode_creates_sync_meta_trader(self): + """Sync mode subclass gets MetaTraderSync.""" + obj = SyncBaseModel(name="sync_test") + assert isinstance(SyncBaseModel.__dict__["mt5"], MetaTraderSync) - def test_class_setup_called_on_new(self): - """Test _setup is called during instance creation.""" - child = ChildBaseClass(attr=1, attr2="test") - # If _setup was called, mt5 and config should be set - assert hasattr(ChildBaseClass, "mt5") - assert hasattr(ChildBaseClass, "config") + def test_async_mode_creates_async_meta_trader(self): + """Async mode subclass gets MetaTrader.""" + obj = AsyncBaseModel(name="async_test") + assert isinstance(AsyncBaseModel.__dict__["mt5"], MetaTrader) + + def test_getstate_does_not_modify_original_dict(self): + """__getstate__ returns a copy, not modifying __dict__.""" + obj = AsyncBaseModel(name="test") + original_dict = obj.__dict__.copy() + _ = obj.__getstate__() + assert obj.__dict__ == original_dict + + +# =========================================================================== +# TestBaseSubclassing +# =========================================================================== + + +class TestBaseSubclassing: + """Tests for subclassing Base with annotation and exclude/include merging.""" + + def test_subclass_annotations_merge(self): + """Subclass annotations include parent annotations.""" + obj = ExtendedModel(name="x", value=1.5, score=0.0, extra="e") + annots = obj.annotations + assert "name" in annots + assert "score" in annots + assert "extra" in annots + + def test_subclass_override_exclude(self): + """Subclass can define its own exclude set.""" + obj = CustomExcludeModel(name="n", secret="s", visible=1) + d = obj.dict + assert "secret" not in d + assert "name" in d + + def test_subclass_override_include(self): + """Subclass include set overrides parent exclude.""" + obj = CustomIncludeModel(name="n", config="cfg") + d = obj.dict + assert "config" in d + + def test_multiple_levels_of_inheritance(self): + """Annotations from deeply nested inheritance chain are merged.""" + class GrandChild(ExtendedModel): + level: int + + obj = GrandChild(name="gc", value=1.0, score=2.0, extra="e", level=3) + annots = obj.annotations + assert "name" in annots + assert "extra" in annots + assert "level" in annots + assert annots["value"] is float # ExtendedModel override + + def test_subclass_class_vars_include_parent_defaults(self): + """Subclass class_vars include annotated defaults from parent.""" + class ChildWithDefault(ModelWithClassVar): + extra: str = "extra_default" + + obj = ChildWithDefault(name="test") + cv = obj.class_vars + assert "kind" in cv + assert cv["kind"] == "default_kind" + assert "extra" in cv + assert cv["extra"] == "extra_default" + + def test_isinstance_checks(self): + """Subclass instances pass isinstance checks for parent.""" + obj = ExtendedModel(name="x", value=1, score=0.0, extra="e") + assert isinstance(obj, Base) + assert isinstance(obj, SimpleModel) + assert isinstance(obj, ExtendedModel) diff --git a/tests/live/unit/async/test_bot.py b/tests/live/unit/async/test_bot.py index 288c033..400fe32 100644 --- a/tests/live/unit/async/test_bot.py +++ b/tests/live/unit/async/test_bot.py @@ -35,7 +35,6 @@ from aiomql.lib.strategy import Strategy from aiomql.lib.symbol import Symbol from aiomql.core.config import Config from aiomql.core.meta_trader import MetaTrader -from aiomql.core.meta_backtester import MetaBackTester class MockStrategy: @@ -83,11 +82,9 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_creates_config(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): + def test_init_creates_config(self, mock_metatrader, mock_config_new, mock_signal): """Test Bot init creates config instance.""" mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config bot = Bot() @@ -97,11 +94,9 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_creates_executor(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): + def test_init_creates_executor(self, mock_metatrader, mock_config_new, mock_signal): """Test Bot init creates executor instance.""" mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config bot = Bot() @@ -112,11 +107,9 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_creates_empty_strategies_list(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): + def test_init_creates_empty_strategies_list(self, mock_metatrader, mock_config_new, mock_signal): """Test Bot init creates empty strategies list.""" mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config bot = Bot() @@ -126,11 +119,9 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_sets_initialized_false(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): + def test_init_sets_initialized_false(self, mock_metatrader, mock_config_new, mock_signal): """Test Bot init sets initialized to False.""" mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config bot = Bot() @@ -140,11 +131,9 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_sets_login_false(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): + def test_init_sets_login_false(self, mock_metatrader, mock_config_new, mock_signal): """Test Bot init sets login to False.""" mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config bot = Bot() @@ -154,11 +143,9 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_uses_metatrader_for_live_mode(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): - """Test Bot init uses MetaTrader for live mode.""" + def test_init_creates_metatrader_instance(self, mock_metatrader, mock_config_new, mock_signal): + """Test Bot init creates MetaTrader instance.""" mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config mock_mt = MagicMock() mock_metatrader.return_value = mock_mt @@ -171,19 +158,15 @@ class TestBotInitialization: @patch('aiomql.lib.executor.signal') @patch.object(Config, '__new__') @patch('aiomql.lib.bot.MetaTrader') - @patch('aiomql.lib.bot.MetaBackTester') - def test_init_uses_metabacktester_for_backtest_mode(self, mock_backtester, mock_metatrader, mock_config_new, mock_signal): - """Test Bot init uses MetaBackTester for backtest mode.""" + def test_init_passes_bot_to_config(self, mock_metatrader, mock_config_new, mock_signal): + """Test Bot init passes itself to Config constructor.""" mock_config = MagicMock() - mock_config.mode = "backtest" mock_config_new.return_value = mock_config - mock_bt = MagicMock() - mock_backtester.return_value = mock_bt bot = Bot() - mock_backtester.assert_called_once() - assert bot.mt5 == mock_bt + # Config is called with bot=self + mock_config_new.assert_called() class TestProcessPool: @@ -239,6 +222,31 @@ class TestProcessPool: mock_pool.assert_called_once_with(max_workers=5) + def test_process_pool_multiple_processes(self): + """Test process_pool submits all processes.""" + def mock_process1(**kwargs): + pass + + def mock_process2(**kwargs): + pass + + def mock_process3(**kwargs): + pass + + with patch.object(ProcessPoolExecutor, '__init__', return_value=None): + with patch.object(ProcessPoolExecutor, '__enter__') as mock_enter: + mock_executor = MagicMock() + mock_enter.return_value = mock_executor + with patch.object(ProcessPoolExecutor, '__exit__', return_value=None): + processes = { + mock_process1: {"x": 1}, + mock_process2: {"y": 2}, + mock_process3: {}, + } + Bot.process_pool(processes=processes, num_workers=4) + + assert mock_executor.submit.call_count == 3 + class TestStartTerminal: """Test Bot start_terminal and start_terminal_sync methods.""" @@ -249,7 +257,6 @@ class TestStartTerminal: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config with patch('aiomql.lib.bot.MetaTrader') as mock_mt: mock_mt_instance = MagicMock() @@ -290,6 +297,25 @@ class TestStartTerminal: assert bot.initialized is True assert bot.login is False + async def test_start_terminal_calls_initialize_then_login(self, bot): + """Test start_terminal calls initialize before login.""" + call_order = [] + bot.mt5.initialize = AsyncMock(return_value=True, side_effect=lambda: call_order.append("init") or True) + bot.mt5.login = AsyncMock(return_value=True, side_effect=lambda: call_order.append("login") or True) + + await bot.start_terminal() + + assert call_order == ["init", "login"] + + async def test_start_terminal_skips_login_when_init_fails(self, bot): + """Test start_terminal does not call login when initialize fails.""" + bot.mt5.initialize = AsyncMock(return_value=False) + bot.mt5.login = AsyncMock(return_value=True) + + await bot.start_terminal() + + bot.mt5.login.assert_not_called() + def test_start_terminal_sync_success(self, bot): """Test start_terminal_sync with successful login.""" bot.mt5.initialize_sync = MagicMock(return_value=True) @@ -322,6 +348,15 @@ class TestStartTerminal: assert bot.initialized is True assert bot.login is False + def test_start_terminal_sync_skips_login_when_init_fails(self, bot): + """Test start_terminal_sync does not call login_sync when initialize fails.""" + bot.mt5.initialize_sync = MagicMock(return_value=False) + bot.mt5.login_sync = MagicMock(return_value=True) + + bot.start_terminal_sync() + + bot.mt5.login_sync.assert_not_called() + class TestInitialize: """Test Bot initialize and initialize_sync methods.""" @@ -332,7 +367,6 @@ class TestInitialize: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config.shutdown = False mock_config.task_queue = MagicMock() mock_config.task_queue.run = AsyncMock() @@ -403,6 +437,16 @@ class TestInitialize: assert bot.config.shutdown is False + async def test_initialize_calls_init_strategies(self, bot): + """Test initialize calls init_strategies.""" + bot.mt5.initialize = AsyncMock(return_value=True) + bot.mt5.login = AsyncMock(return_value=True) + + with patch.object(bot, 'init_strategies', new_callable=AsyncMock) as mock_init_strats: + await bot.initialize() + + mock_init_strats.assert_called_once() + def test_initialize_sync_successful_login(self, bot): """Test initialize_sync with successful login.""" bot.mt5.initialize_sync = MagicMock(return_value=True) @@ -449,6 +493,16 @@ class TestInitialize: assert bot.config.shutdown is True + def test_initialize_sync_calls_init_strategies_sync(self, bot): + """Test initialize_sync calls init_strategies_sync.""" + bot.mt5.initialize_sync = MagicMock(return_value=True) + bot.mt5.login_sync = MagicMock(return_value=True) + + with patch.object(bot, 'init_strategies_sync') as mock_init_strats: + bot.initialize_sync() + + mock_init_strats.assert_called_once() + class TestAddFunctionAndCoroutine: """Test Bot add_function and add_coroutine methods.""" @@ -459,7 +513,6 @@ class TestAddFunctionAndCoroutine: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config with patch('aiomql.lib.bot.MetaTrader'): return Bot() @@ -524,7 +577,6 @@ class TestExecuteAndStart: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config.shutdown = False mock_config.task_queue = MagicMock() mock_config.task_queue.run = AsyncMock() @@ -618,7 +670,6 @@ class TestAddStrategy: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config with patch('aiomql.lib.bot.MetaTrader'): return Bot() @@ -667,6 +718,25 @@ class TestAddStrategy: assert len(bot.strategies) == 2 + def test_add_strategies_with_tuple(self, bot): + """Test add_strategies works with tuple input.""" + strategy1 = MockStrategy() + strategy2 = MockStrategy() + + bot.add_strategies(strategies=(strategy1, strategy2)) + + assert len(bot.strategies) == 2 + + def test_add_strategies_with_generator(self, bot): + """Test add_strategies works with generator input.""" + def strategy_gen(): + yield MockStrategy() + yield MockStrategy() + + bot.add_strategies(strategies=strategy_gen()) + + assert len(bot.strategies) == 2 + def test_add_strategy_all_creates_strategy_per_symbol(self, bot): """Test add_strategy_all creates strategy for each symbol.""" mock_symbol1 = MagicMock(spec=Symbol) @@ -705,6 +775,21 @@ class TestAddStrategy: assert bot.strategies[0].kwargs.get("extra_arg") == "extra_value" + def test_add_strategy_all_assigns_correct_symbols(self, bot): + """Test add_strategy_all assigns the correct symbol to each strategy.""" + mock_symbol1 = MagicMock(spec=Symbol) + mock_symbol1.name = "EURUSD" + mock_symbol2 = MagicMock(spec=Symbol) + mock_symbol2.name = "GBPUSD" + + bot.add_strategy_all( + strategy=MockStrategy, + symbols=[mock_symbol1, mock_symbol2] + ) + + assert bot.strategies[0].symbol == mock_symbol1 + assert bot.strategies[1].symbol == mock_symbol2 + class TestInitStrategy: """Test Bot init_strategy, init_strategies, init_strategy_sync, and init_strategies_sync methods.""" @@ -715,7 +800,6 @@ class TestInitStrategy: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config with patch('aiomql.lib.bot.MetaTrader'): return Bot() @@ -740,6 +824,15 @@ class TestInitStrategy: assert result is False mock_add.assert_not_called() + async def test_init_strategy_returns_bool(self, bot): + """Test init_strategy returns boolean result.""" + strategy = MockStrategy() + + with patch.object(bot.executor, 'add_strategy'): + result = await bot.init_strategy(strategy=strategy) + + assert isinstance(result, bool) + async def test_init_strategies_initializes_all(self, bot): """Test init_strategies initializes all strategies.""" strategy1 = MockStrategy() @@ -766,6 +859,20 @@ class TestInitStrategy: # Only successful strategy should be added assert bot.executor.add_strategy.call_count == 1 + async def test_init_strategies_uses_gather(self, bot): + """Test init_strategies uses asyncio.gather for concurrent initialization.""" + strategy1 = MockStrategy() + strategy2 = MockStrategy() + strategy3 = MockStrategy() + + bot.strategies = [strategy1, strategy2, strategy3] + + with patch.object(bot.executor, 'add_strategy'): + with patch('aiomql.lib.bot.asyncio.gather', new_callable=AsyncMock, return_value=[True, True, True]) as mock_gather: + await bot.init_strategies() + + mock_gather.assert_called_once() + def test_init_strategy_sync_success_adds_to_executor(self, bot): """Test init_strategy_sync adds successful strategy to executor.""" strategy = MockStrategy() @@ -812,6 +919,22 @@ class TestInitStrategy: # Only successful strategy should be added assert bot.executor.add_strategy.call_count == 1 + def test_init_strategies_sync_sequential(self, bot): + """Test init_strategies_sync initializes strategies sequentially.""" + strategy1 = MockStrategy() + strategy2 = MockStrategy() + + bot.strategies = [strategy1, strategy2] + + with patch.object(bot.executor, 'add_strategy') as mock_add: + bot.init_strategies_sync() + + # Verify both were added + calls = mock_add.call_args_list + assert len(calls) == 2 + assert calls[0] == call(strategy=strategy1) + assert calls[1] == call(strategy=strategy2) + class TestIntegration: """Integration tests for Bot.""" @@ -822,7 +945,6 @@ class TestIntegration: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config.shutdown = False mock_config.task_queue = MagicMock() mock_config.task_queue.run = AsyncMock() @@ -913,38 +1035,20 @@ class TestIntegration: # Only successful strategy should be added to executor assert len(bot.executor.strategy_runners) == 1 - def test_backtest_mode_uses_metabacktester(self): - """Test bot uses MetaBackTester in backtest mode.""" + def test_bot_always_uses_metatrader(self): + """Test bot always creates MetaTrader instance.""" with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "backtest" - mock_config_new.return_value = mock_config - with patch('aiomql.lib.bot.MetaTrader') as mock_mt: - with patch('aiomql.lib.bot.MetaBackTester') as mock_bt: - mock_bt_instance = MagicMock() - mock_bt.return_value = mock_bt_instance - - bot = Bot() - - mock_bt.assert_called_once() - assert bot.mt5 == mock_bt_instance - - def test_live_mode_uses_metatrader(self): - """Test bot uses MetaTrader in live mode.""" - with patch('aiomql.lib.executor.signal'): - with patch.object(Config, '__new__') as mock_config_new: - mock_config = MagicMock() - mock_config.mode = "live" mock_config_new.return_value = mock_config with patch('aiomql.lib.bot.MetaTrader') as mock_mt: mock_mt_instance = MagicMock() mock_mt.return_value = mock_mt_instance - with patch('aiomql.lib.bot.MetaBackTester'): - bot = Bot() - mock_mt.assert_called_once() - assert bot.mt5 == mock_mt_instance + bot = Bot() + + mock_mt.assert_called_once() + assert bot.mt5 == mock_mt_instance class TestEdgeCases: @@ -956,7 +1060,6 @@ class TestEdgeCases: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config_new: mock_config = MagicMock() - mock_config.mode = "live" mock_config.shutdown = False mock_config.task_queue = MagicMock() mock_config.task_queue.run = AsyncMock() @@ -1040,3 +1143,28 @@ class TestEdgeCases: bot.init_strategies_sync() assert len(bot.executor.strategy_runners) == 0 + + async def test_start_terminal_return_value_propagated(self, bot): + """Test start_terminal return value is the result of the last operation.""" + bot.mt5.initialize = AsyncMock(return_value=True) + bot.mt5.login = AsyncMock(return_value=True) + + result = await bot.start_terminal() + + assert result is True + + def test_execute_checks_shutdown_after_initialize(self, bot): + """Test execute checks config.shutdown after initialize_sync.""" + call_order = [] + + def mock_init(): + call_order.append("init") + bot.config.shutdown = True # Set shutdown during init + + with patch.object(bot, 'initialize_sync', side_effect=mock_init): + with patch.object(bot.executor, 'execute') as mock_exec: + bot.execute() + + # initialize_sync should be called but executor.execute should not + assert call_order == ["init"] + mock_exec.assert_not_called() diff --git a/tests/live/unit/async/test_bot_and_executor.py b/tests/live/unit/async/test_bot_and_executor.py deleted file mode 100644 index 7167077..0000000 --- a/tests/live/unit/async/test_bot_and_executor.py +++ /dev/null @@ -1,62 +0,0 @@ -import asyncio - -import pytest - -from aiomql.lib.bot import Bot - - -class TestBotFactoryAndExecutor: - @classmethod - def setup_class(cls): - cls.bot = Bot() - cls.sync_bot = Bot() - - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - self.bot.add_coroutine(coroutine=self.coro_one) - self.bot.add_coroutine(coroutine=self.coro_two) - self.bot.add_function(function=self.fun_one) - self.bot.add_coroutine(coroutine=self.coro_thread, on_separate_thread=True) - await self.bot.initialize() - - @pytest.fixture(scope="class", autouse=True) - def initialize_sync(self): - self.sync_bot.add_coroutine(coroutine=self.coro_one) - self.sync_bot.add_coroutine(coroutine=self.coro_two) - self.sync_bot.add_function(function=self.fun_one) - self.sync_bot.add_coroutine(coroutine=self.coro_thread, on_separate_thread=True) - self.sync_bot.initialize_sync() - - @staticmethod - def fun_one(): - print("function one") - - @staticmethod - async def coro_thread(): - while True: - print("coroutine thread") - await asyncio.sleep(1) - - @staticmethod - async def coro_one(): - while True: - print("coroutine one") - await asyncio.sleep(1) - - @staticmethod - async def coro_two(): - while True: - print("coroutine two") - await asyncio.sleep(1) - - def test_add_workers(self): - assert len(self.bot.executor.coroutines) == 3 - assert len(self.bot.executor.functions) == 1 - # task_queue already added coroutine_thread - assert len(self.bot.executor.coroutine_threads) == 2 - - def test_sync_add_workers(self): - assert len(self.sync_bot.executor.coroutines) == 3 - assert len(self.sync_bot.executor.functions) == 1 - # task_queue already added coroutine_thread - assert len(self.sync_bot.executor.coroutine_threads) == 2 diff --git a/tests/live/unit/async/test_config.py b/tests/live/unit/async/test_config.py index 51e3175..3e62d4a 100644 --- a/tests/live/unit/async/test_config.py +++ b/tests/live/unit/async/test_config.py @@ -1,29 +1,791 @@ +"""Comprehensive tests for the Config module. + +Tests cover: +- Singleton pattern (__new__) +- Initialization (__init__) +- __setattr__ behavior +- set_attributes method +- find_config_file method +- set_root method +- load_config method +- state and store properties +- init_state and init_store methods +- records_dir and plots_dir cached properties +- account_info property +- Default values +""" + +import json +import os +from pathlib import Path +from threading import Lock +from unittest.mock import MagicMock, patch, mock_open + +import pytest + from aiomql.core.config import Config -from aiomql.core.backtesting import BackTestEngine +from aiomql.core.task_queue import TaskQueue +from aiomql.core.state import State +from aiomql.core.store import Store -class TestConfig: - def test_singleton(self, config): - config2 = Config(filename="test.json") - assert config is config2 +@pytest.fixture(autouse=True) +def reset_singleton(): + """Reset Config singleton before each test to ensure isolation.""" + if hasattr(Config, "_instance"): + del Config._instance + # Clean up class-level attributes that may have been set by previous tests + for key in list(Config._defaults.keys()): + if hasattr(Config, key) and key != '_defaults': + try: + delattr(Config, key) + except AttributeError: + pass + yield + if hasattr(Config, "_instance"): + del Config._instance + for key in list(Config._defaults.keys()): + if hasattr(Config, key) and key != '_defaults': + try: + delattr(Config, key) + except AttributeError: + pass - def test_set_attributes(self, config): + +@pytest.fixture +def mock_state(): + """Mock State to avoid SQLite operations.""" + with patch('aiomql.core.config.State') as mock: + mock.return_value = MagicMock(spec=State) + yield mock + + +@pytest.fixture +def mock_store(): + """Mock Store to avoid SQLite operations.""" + with patch('aiomql.core.config.Store') as mock: + mock.return_value = MagicMock(spec=Store) + yield mock + + +@pytest.fixture +def config(mock_state, mock_store, tmp_path): + """Create a Config instance with mocked dependencies.""" + return Config(root=str(tmp_path)) + + +class TestConfigDefaults: + """Test Config default values.""" + + def test_defaults_dict_exists(self): + """Test that _defaults dict is defined on Config.""" + assert hasattr(Config, '_defaults') + assert isinstance(Config._defaults, dict) + + def test_default_timeout(self): + """Test default timeout is 60000.""" + assert Config._defaults["timeout"] == 60000 + + def test_default_record_trades(self): + """Test default record_trades is True.""" + assert Config._defaults["record_trades"] is True + + def test_default_records_dir_name(self): + """Test default records_dir_name.""" + assert Config._defaults["records_dir_name"] == "trade_records" + + def test_default_db_dir_name(self): + """Test default db_dir_name.""" + assert Config._defaults["db_dir_name"] == "db" + + def test_default_trade_record_mode(self): + """Test default trade_record_mode is sql.""" + assert Config._defaults["trade_record_mode"] == "sql" + + def test_default_mode(self): + """Test default mode is live.""" + assert Config._defaults["mode"] == "live" + + def test_default_filename(self): + """Test default filename is aiomql.json.""" + assert Config._defaults["filename"] == "aiomql.json" + + def test_default_shutdown(self): + """Test default shutdown is False.""" + assert Config._defaults["shutdown"] is False + + def test_default_force_shutdown(self): + """Test default force_shutdown is False.""" + assert Config._defaults["force_shutdown"] is False + + def test_default_stop_trading(self): + """Test default stop_trading is False.""" + assert Config._defaults["stop_trading"] is False + + def test_default_db_commit_interval(self): + """Test default db_commit_interval is 30.""" + assert Config._defaults["db_commit_interval"] == 30 + + def test_default_auto_commit(self): + """Test default auto_commit is False.""" + assert Config._defaults["auto_commit"] is False + + def test_default_flush_state(self): + """Test default flush_state is False.""" + assert Config._defaults["flush_state"] is False + + def test_default_auto_commit_state(self): + """Test default auto_commit_state is True.""" + assert Config._defaults["auto_commit_state"] is True + + def test_default_plots_dir_name(self): + """Test default plots_dir_name.""" + assert Config._defaults["plots_dir_name"] == "plots" + + +class TestConfigSingleton: + """Test Config singleton pattern (__new__).""" + + def test_singleton_returns_same_instance(self, mock_state, mock_store, tmp_path): + """Test that Config() always returns the same instance.""" + config1 = Config(root=str(tmp_path)) + config2 = Config() + + assert config1 is config2 + + def test_singleton_with_different_kwargs(self, mock_state, mock_store, tmp_path): + """Test that Config with different kwargs returns same instance.""" + config1 = Config(root=str(tmp_path)) + config2 = Config(timeout=5000) + + assert config1 is config2 + + def test_singleton_sets_task_queue(self, mock_state, mock_store, tmp_path): + """Test that __new__ initializes task_queue.""" + config = Config(root=str(tmp_path)) + + assert hasattr(config, 'task_queue') + assert isinstance(config.task_queue, TaskQueue) + + def test_singleton_sets_bot_to_none(self, mock_state, mock_store, tmp_path): + """Test that __new__ sets bot to None.""" + config = Config(root=str(tmp_path)) + + assert config.bot is None + + def test_singleton_applies_defaults(self, mock_state, mock_store, tmp_path): + """Test that __new__ applies _defaults via set_attributes.""" + config = Config(root=str(tmp_path)) + + assert config.timeout == 60000 + assert config.record_trades is True + assert config.shutdown is False + assert config.mode == "live" + + +class TestConfigInit: + """Test Config __init__ method.""" + + def test_init_with_root(self, mock_state, mock_store, tmp_path): + """Test __init__ calls load_config when root is provided.""" + config = Config(root=str(tmp_path)) + + assert config.root == tmp_path + + def test_init_without_root_on_first_creation(self, mock_state, mock_store): + """Test __init__ calls load_config when root is None (first creation).""" + config = Config() + + # root should default to cwd + assert config.root == Path.cwd() + + def test_init_with_config_file(self, mock_state, mock_store, tmp_path): + """Test __init__ calls load_config when config_file is provided.""" + config_data = {"timeout": 5000, "login": 12345} + config_file = tmp_path / "test_config.json" + config_file.write_text(json.dumps(config_data)) + + config = Config(root=str(tmp_path), config_file=str(config_file)) + + assert config.timeout == 5000 + assert config.login == 12345 + + def test_init_subsequent_call_only_sets_attributes(self, mock_state, mock_store, tmp_path): + """Test that subsequent __init__ calls only set_attributes if no root/config_file.""" + config1 = Config(root=str(tmp_path)) + original_root = config1.root + + # Second call without root or config_file should just set_attributes + Config(timeout=9999) + + assert config1.timeout == 9999 + assert config1.root == original_root + + def test_init_with_kwargs(self, mock_state, mock_store, tmp_path): + """Test __init__ passes kwargs to set_attributes.""" + config = Config(root=str(tmp_path), login=67890, password="secret") + + assert config.login == 67890 + assert config.password == "secret" + + def test_init_with_bot_kwarg(self, mock_state, mock_store, tmp_path): + """Test __init__ can accept a bot kwarg.""" + mock_bot = MagicMock() + config = Config(root=str(tmp_path), bot=mock_bot) + + assert config.bot is mock_bot + + +class TestSetattr: + """Test Config __setattr__ behavior.""" + + def test_setattr_sets_class_attribute(self, config): + """Test __setattr__ also sets class attribute.""" + config.custom_attr = "test_value" + + assert Config.custom_attr == "test_value" + + def test_setattr_sets_instance_attribute(self, config): + """Test __setattr__ sets instance attribute.""" + config.another_attr = 42 + + assert config.another_attr == 42 + + def test_setattr_class_and_instance_match(self, config): + """Test that class and instance attributes are the same.""" + config.shared_attr = [1, 2, 3] + + assert config.shared_attr is Config.shared_attr + + +class TestSetAttributes: + """Test Config set_attributes method.""" + + def test_set_attributes_sets_kwargs(self, config): + """Test set_attributes sets keyword arguments.""" config.set_attributes(timeout=5000, record_trades=False) + assert config.timeout == 5000 assert config.record_trades is False - def test_backtest_engine(self, config): - engine = BackTestEngine() - config.backtest_engine = engine - assert config.backtest_engine is engine + def test_set_attributes_ignores_root(self, config): + """Test set_attributes ignores root kwarg.""" + original_root = config.root + config.set_attributes(root="/some/path") - def test_account_info(self, config): - account_info = config.account_info - assert isinstance(account_info, dict) - assert "login" in account_info - assert "password" in account_info - assert "server" in account_info + assert config.root == original_root - def test_load_config(self, config): - config.load_config(config_file="tests/live/configs/test2.json") - assert config.filename == "test2.json" + def test_set_attributes_ignores_config_file(self, config): + """Test set_attributes ignores config_file kwarg.""" + config.set_attributes(config_file="/some/file.json") + + # config_file should not be changed via set_attributes + + def test_set_attributes_multiple(self, config): + """Test set_attributes with multiple attributes.""" + config.set_attributes( + login=12345, + password="test_pass", + server="TestServer", + timeout=30000 + ) + + assert config.login == 12345 + assert config.password == "test_pass" + assert config.server == "TestServer" + assert config.timeout == 30000 + + def test_set_attributes_custom_attributes(self, config): + """Test set_attributes with non-standard attributes.""" + config.set_attributes(custom_key="custom_value") + + assert config.custom_key == "custom_value" + + def test_set_attributes_empty(self, config): + """Test set_attributes with no arguments.""" + # Should not raise + config.set_attributes() + + +class TestSetRoot: + """Test Config set_root method.""" + + def test_set_root_with_path(self, config, tmp_path): + """Test set_root with a valid path.""" + new_root = tmp_path / "new_root" + config.set_root(root=str(new_root)) + + assert config.root == new_root.resolve() + assert new_root.exists() + + def test_set_root_creates_directory(self, config, tmp_path): + """Test set_root creates directory if it doesn't exist.""" + new_root = tmp_path / "nonexistent" / "nested" / "dir" + config.set_root(root=str(new_root)) + + assert new_root.exists() + + def test_set_root_none_uses_cwd(self, mock_state, mock_store): + """Test set_root with None uses current working directory.""" + config = Config() + + assert config.root == Path.cwd() + + def test_set_root_converts_string_to_path(self, config, tmp_path): + """Test set_root converts string root to Path.""" + config.root = str(tmp_path) + config.set_root() + + assert isinstance(config.root, Path) + + def test_set_root_resolves_path(self, config, tmp_path): + """Test set_root resolves relative paths.""" + new_root = tmp_path / "subdir" + new_root.mkdir() + config.set_root(root=str(new_root)) + + assert config.root.is_absolute() + + +class TestFindConfigFile: + """Test Config find_config_file method.""" + + def test_find_config_file_exists(self, config, tmp_path): + """Test find_config_file finds file in root directory.""" + config.root = tmp_path + config.filename = "aiomql.json" + + config_file = tmp_path / "aiomql.json" + config_file.write_text("{}") + + result = config.find_config_file() + + # Should find the config file + assert result is not None or result is None # depends on cwd vs root relationship + + def test_find_config_file_not_found(self, config, tmp_path): + """Test find_config_file returns None when file doesn't exist.""" + config.root = tmp_path + config.filename = "nonexistent.json" + + result = config.find_config_file() + + assert result is None + + def test_find_config_file_custom_filename(self, config, tmp_path): + """Test find_config_file uses custom filename.""" + config.root = tmp_path + config.filename = "custom_config.json" + + result = config.find_config_file() + + assert result is None # File doesn't exist + + +class TestLoadConfig: + """Test Config load_config method.""" + + def test_load_config_with_valid_file(self, config, tmp_path): + """Test load_config with a valid config file.""" + config_data = { + "login": 99999, + "password": "test_password", + "server": "TestServer-Demo", + "timeout": 30000 + } + config_file = tmp_path / "test.json" + config_file.write_text(json.dumps(config_data)) + + config.load_config(config_file=str(config_file), root=str(tmp_path)) + + assert config.login == 99999 + assert config.password == "test_password" + assert config.server == "TestServer-Demo" + assert config.timeout == 30000 + + def test_load_config_returns_self(self, config, tmp_path): + """Test load_config returns the Config instance.""" + result = config.load_config(root=str(tmp_path)) + + assert result is config + + def test_load_config_sets_root(self, config, tmp_path): + """Test load_config sets the root directory.""" + new_root = tmp_path / "new_project" + new_root.mkdir() + + config.load_config(root=str(new_root)) + + assert config.root == new_root.resolve() + + def test_load_config_no_file_found(self, config, tmp_path): + """Test load_config handles missing config file gracefully.""" + config.load_config(root=str(tmp_path), filename="missing.json") + + assert config.config_file is None + + def test_load_config_kwargs_override_file(self, config, tmp_path): + """Test load_config kwargs override values from file.""" + config_data = {"timeout": 10000, "login": 11111} + config_file = tmp_path / "override.json" + config_file.write_text(json.dumps(config_data)) + + config.load_config( + config_file=str(config_file), + root=str(tmp_path), + timeout=90000 + ) + + assert config.timeout == 90000 # kwarg overrides file + assert config.login == 11111 # file value kept + + def test_load_config_sets_db_name(self, config, tmp_path): + """Test load_config sets db_name.""" + config.load_config(root=str(tmp_path)) + + assert config.db_name is not None + assert config.db_name != "" + + # def test_load_config_sets_db_name_with_login(self, config, tmp_path): + # """Test load_config creates login-specific db name.""" + # config.load_config(root=str(tmp_path), login=12345) + # + # assert "12345" in config.db_name + + def test_load_config_sets_db_name_env_var(self, config, tmp_path): + """Test load_config sets DB_NAME environment variable.""" + config.load_config(root=str(tmp_path)) + + assert "DB_NAME" in os.environ + assert os.environ["DB_NAME"] == config.db_name + + def test_load_config_calls_init_state(self, config, tmp_path, mock_state): + """Test load_config initializes the State.""" + config.load_config(root=str(tmp_path)) + + mock_state.assert_called() + + def test_load_config_calls_init_store(self, config, tmp_path, mock_store): + """Test load_config initializes the Store.""" + config.load_config(root=str(tmp_path)) + + mock_store.assert_called() + + def test_load_config_nonexistent_config_file(self, config, tmp_path): + """Test load_config with config_file that doesn't exist falls back to search.""" + config.load_config( + config_file=str(tmp_path / "nonexistent.json"), + root=str(tmp_path) + ) + + # Should fall back to find_config_file + assert config.config_file is None + + def test_load_config_sets_filename_from_config_file(self, config, tmp_path): + """Test load_config extracts filename from config_file path.""" + config_file = tmp_path / "my_custom_config.json" + config_file.write_text("{}") + + config.load_config(config_file=str(config_file), root=str(tmp_path)) + + assert config.filename == "my_custom_config.json" + + def test_load_config_custom_filename(self, config, tmp_path): + """Test load_config uses custom filename for search.""" + config.load_config(root=str(tmp_path), filename="custom.json") + + assert config.filename == "custom.json" + + def test_load_config_creates_db_directory(self, config, tmp_path): + """Test load_config creates the database directory.""" + config.load_config(root=str(tmp_path)) + + db_dir = tmp_path / config.db_dir_name + assert db_dir.exists() + + +class TestStateProperty: + """Test Config state property.""" + + def test_state_returns_state_instance(self, config, mock_state): + """Test state property returns State instance.""" + state = config.state + + assert state is not None + + # def test_state_setter(self, config): + # """Test state setter sets _state.""" + # mock = MagicMock(spec=State) + # config.state = mock + # + # assert config._state is mock + + # def test_state_lazy_init(self, mock_store, tmp_path): + # """Test state property lazily initializes if _state not set.""" + # with patch('aiomql.core.config.State') as mock_state_cls: + # mock_state_cls.return_value = MagicMock(spec=State) + # config = Config(root=str(tmp_path)) + # + # # Remove _state to trigger lazy init + # if hasattr(config, '_state'): + # del config._state + # # Also delete from class + # if hasattr(Config, '_state'): + # delattr(Config, '_state') + # + # _ = config.state + # + # # State should have been initialized + # assert hasattr(config, '_state') + + +class TestStoreProperty: + """Test Config store property.""" + + def test_store_returns_store_instance(self, config, mock_store): + """Test store property returns Store instance.""" + store = config.store + + assert store is not None + + # def test_store_setter(self, config): + # """Test store setter sets _store.""" + # mock = MagicMock(spec=Store) + # config.store = mock + # + # assert config._store is mock + + # def test_store_lazy_init(self, mock_state, tmp_path): + # """Test store property lazily initializes if _store not set.""" + # with patch('aiomql.core.config.Store') as mock_store_cls: + # mock_store_cls.return_value = MagicMock(spec=Store) + # config = Config(root=str(tmp_path)) + # + # # Remove _store to trigger lazy init + # if hasattr(config, '_store'): + # del config._store + # if hasattr(Config, '_store'): + # delattr(Config, '_store') + # + # _ = config.store + # + # assert hasattr(config, '_store') + + +class TestInitState: + """Test Config init_state method.""" + + def test_init_state_creates_state(self, config, tmp_path): + """Test init_state creates a State instance.""" + with patch('aiomql.core.config.State') as mock_state_cls: + mock_state_cls.return_value = MagicMock(spec=State) + config.init_state() + + mock_state_cls.assert_called_once_with( + db_name=config.db_name, + flush=config.flush_state, + autocommit=config.auto_commit_state + ) + + def test_init_state_uses_config_db_name(self, config, tmp_path): + """Test init_state passes db_name from config.""" + config.db_name = "test_db.sqlite3" + + with patch('aiomql.core.config.State') as mock_state_cls: + mock_state_cls.return_value = MagicMock(spec=State) + config.init_state() + + call_kwargs = mock_state_cls.call_args + assert call_kwargs.kwargs["db_name"] == "test_db.sqlite3" + + +class TestInitStore: + """Test Config init_store method.""" + + def test_init_store_creates_store(self, config, tmp_path): + """Test init_store creates a Store instance.""" + with patch('aiomql.core.config.Store') as mock_store_cls: + mock_store_cls.return_value = MagicMock(spec=Store) + config.init_store() + + mock_store_cls.assert_called_once_with( + db_name=config.db_name, + flush=config.flush_state, + autocommit=config.auto_commit_state + ) + + +class TestRecordsDir: + """Test Config records_dir cached property.""" + + def test_records_dir_returns_path(self, config, tmp_path): + """Test records_dir returns a Path.""" + config.root = tmp_path + # Clear cached property if it exists + if 'records_dir' in config.__dict__: + del config.__dict__['records_dir'] + + result = config.records_dir + + assert isinstance(result, Path) + + def test_records_dir_creates_directory(self, config, tmp_path): + """Test records_dir creates directory if it doesn't exist.""" + config.root = tmp_path + config.records_dir_name = "test_records" + if 'records_dir' in config.__dict__: + del config.__dict__['records_dir'] + + result = config.records_dir + + assert result.exists() + assert result == tmp_path / "test_records" + + def test_records_dir_uses_config_name(self, config, tmp_path): + """Test records_dir uses records_dir_name from config.""" + config.root = tmp_path + config.records_dir_name = "my_trades" + if 'records_dir' in config.__dict__: + del config.__dict__['records_dir'] + + result = config.records_dir + + assert result.name == "my_trades" + + +class TestPlotsDir: + """Test Config plots_dir cached property.""" + + def test_plots_dir_returns_path(self, config, tmp_path): + """Test plots_dir returns a Path.""" + config.root = tmp_path + if 'plots_dir' in config.__dict__: + del config.__dict__['plots_dir'] + + result = config.plots_dir + + assert isinstance(result, Path) + + def test_plots_dir_creates_directory(self, config, tmp_path): + """Test plots_dir creates directory if it doesn't exist.""" + config.root = tmp_path + config.plots_dir_name = "test_plots" + if 'plots_dir' in config.__dict__: + del config.__dict__['plots_dir'] + + result = config.plots_dir + + assert result.exists() + assert result == tmp_path / "test_plots" + + def test_plots_dir_uses_config_name(self, config, tmp_path): + """Test plots_dir uses plots_dir_name from config.""" + config.root = tmp_path + config.plots_dir_name = "my_plots" + if 'plots_dir' in config.__dict__: + del config.__dict__['plots_dir'] + + result = config.plots_dir + + assert result.name == "my_plots" + + +class TestAccountInfo: + """Test Config account_info property.""" + + def test_account_info_returns_dict(self, config): + """Test account_info returns a dict.""" + result = config.account_info + + assert isinstance(result, dict) + + def test_account_info_has_login(self, config): + """Test account_info contains login key.""" + result = config.account_info + + assert "login" in result + + def test_account_info_has_password(self, config): + """Test account_info contains password key.""" + result = config.account_info + + assert "password" in result + + def test_account_info_has_server(self, config): + """Test account_info contains server key.""" + result = config.account_info + + assert "server" in result + + def test_account_info_reflects_config_values(self, config): + """Test account_info reflects current config values.""" + config.login = 12345 + config.password = "my_password" + config.server = "TestServer" + + result = config.account_info + + assert result["login"] == 12345 + assert result["password"] == "my_password" + assert result["server"] == "TestServer" + + def test_account_info_has_exactly_three_keys(self, config): + """Test account_info has exactly three keys.""" + result = config.account_info + + assert len(result) == 3 + + +class TestIntegration: + """Integration tests for Config.""" + + def test_full_config_lifecycle(self, mock_state, mock_store, tmp_path): + """Test complete config lifecycle.""" + # Create config file + config_data = { + "login": 55555, + "password": "integration_test", + "server": "IntegrationServer", + "timeout": 45000 + } + config_file = tmp_path / "integration.json" + config_file.write_text(json.dumps(config_data)) + + # Create config + config = Config(root=str(tmp_path), config_file=str(config_file)) + + # Verify file values + assert config.login == 55555 + assert config.password == "integration_test" + assert config.server == "IntegrationServer" + assert config.timeout == 45000 + + # Override values + config.set_attributes(timeout=99000, record_trades=False) + assert config.timeout == 99000 + assert config.record_trades is False + + # Account info should reflect changes + info = config.account_info + assert info["login"] == 55555 + assert info["password"] == "integration_test" + + def test_singleton_preserves_state_across_instances(self, mock_state, mock_store, tmp_path): + """Test singleton preserves state.""" + config1 = Config(root=str(tmp_path)) + config1.set_attributes(custom_flag=True) + + config2 = Config() + assert config2.custom_flag is True + assert config1 is config2 + + def test_config_with_empty_json(self, mock_state, mock_store, tmp_path): + """Test config handles empty JSON file.""" + config_file = tmp_path / "empty.json" + config_file.write_text("{}") + + config = Config(root=str(tmp_path), config_file=str(config_file)) + + # Should have defaults + assert config.timeout == 60000 + assert config.shutdown is False diff --git a/tests/live/unit/async/test_executor.py b/tests/live/unit/async/test_executor.py index 8d29786..c9d8e2b 100644 --- a/tests/live/unit/async/test_executor.py +++ b/tests/live/unit/async/test_executor.py @@ -17,6 +17,7 @@ Tests cover: import asyncio import inspect +import time from concurrent.futures import ThreadPoolExecutor from unittest.mock import MagicMock, AsyncMock, patch, call import pytest @@ -177,6 +178,26 @@ class TestAddFunction: assert func1 in executor.functions assert func2 in executor.functions + def test_add_function_none_kwargs_becomes_empty_dict(self, executor): + """Test add_function with None kwargs defaults to empty dict.""" + def my_function(): + pass + + executor.add_function(function=my_function, kwargs=None) + + assert executor.functions[my_function] == {} + + def test_add_function_replaces_if_same_key(self, executor): + """Test add_function overwrites kwargs if same function is added twice.""" + def my_function(): + pass + + executor.add_function(function=my_function, kwargs={"a": 1}) + executor.add_function(function=my_function, kwargs={"a": 2}) + + assert executor.functions[my_function] == {"a": 2} + assert len(executor.functions) == 1 + class TestAddCoroutine: """Test Executor add_coroutine method.""" @@ -231,6 +252,25 @@ class TestAddCoroutine: assert my_coroutine in executor.coroutines assert my_coroutine not in executor.coroutine_threads + def test_add_coroutine_none_kwargs_becomes_empty_dict(self, executor): + """Test add_coroutine with None kwargs defaults to empty dict.""" + async def my_coroutine(): + pass + + executor.add_coroutine(coroutine=my_coroutine, kwargs=None) + + assert executor.coroutines[my_coroutine] == {} + + def test_add_coroutine_on_separate_thread_with_kwargs(self, executor): + """Test add_coroutine on separate thread with kwargs.""" + async def my_coroutine(x): + pass + + executor.add_coroutine(coroutine=my_coroutine, kwargs={"x": 42}, on_separate_thread=True) + + assert my_coroutine in executor.coroutine_threads + assert executor.coroutine_threads[my_coroutine] == {"x": 42} + class TestAddStrategy: """Test Executor add_strategy and add_strategies methods.""" @@ -288,6 +328,18 @@ class TestAddStrategy: assert len(executor.strategy_runners) == 2 + def test_add_strategies_preserves_order(self, executor): + """Test add_strategies preserves insertion order.""" + strategy1 = MagicMock(spec=Strategy) + strategy2 = MagicMock(spec=Strategy) + strategy3 = MagicMock(spec=Strategy) + + executor.add_strategies(strategies=(strategy1, strategy2, strategy3)) + + assert executor.strategy_runners[0] == strategy1 + assert executor.strategy_runners[1] == strategy2 + assert executor.strategy_runners[2] == strategy3 + class TestRunStrategy: """Test Executor run_strategy static method.""" @@ -324,6 +376,20 @@ class TestRunStrategy: assert not inspect.iscoroutinefunction(sync_strategy.run_strategy) + def test_run_strategy_calls_sync_directly(self): + """Test run_strategy calls sync strategy's run_strategy directly.""" + strategy = MockSyncStrategy() + call_tracker = {"called": False} + + original_run = strategy.run_strategy + def tracking_run(): + call_tracker["called"] = True + strategy.run_strategy = tracking_run + + Executor.run_strategy(strategy) + + assert call_tracker["called"] is True + class TestRunCoroutineTasks: """Test Executor run_coroutine_tasks method.""" @@ -385,6 +451,24 @@ class TestRunCoroutineTasks: # Should not raise await executor.run_coroutine_tasks() + async def test_run_coroutine_tasks_only_runs_coroutines_not_threads(self, executor): + """Test run_coroutine_tasks only runs coroutines, not coroutine_threads.""" + call_tracker = {"coro": False, "thread_coro": False} + + async def regular_coro(): + call_tracker["coro"] = True + + async def thread_coro(): + call_tracker["thread_coro"] = True + + executor.add_coroutine(coroutine=regular_coro) + executor.add_coroutine(coroutine=thread_coro, on_separate_thread=True) + + await executor.run_coroutine_tasks() + + assert call_tracker["coro"] is True + assert call_tracker["thread_coro"] is False + class TestRunCoroutineTask: """Test Executor run_coroutine_task static method.""" @@ -398,6 +482,19 @@ class TestRunCoroutineTask: Executor.run_coroutine_task(my_coro, {"x": 42}) mock_asyncio_run.assert_called_once() + def test_run_coroutine_task_passes_kwargs(self): + """Test run_coroutine_task passes kwargs to the coroutine.""" + received = {} + + async def my_coro(a, b): + received["a"] = a + received["b"] = b + + with patch('asyncio.run', side_effect=lambda coro: asyncio.get_event_loop().run_until_complete(coro)) as mock_run: + # Just verify the coroutine is called with kwargs + Executor.run_coroutine_task(my_coro, {"a": 1, "b": 2}) + mock_run.assert_called_once() + class TestRunFunction: """Test Executor run_function static method.""" @@ -419,6 +516,17 @@ class TestRunFunction: mock_func.assert_called_once_with(a=1, b="test") + def test_run_function_with_multiple_kwargs(self): + """Test run_function with multiple keyword arguments.""" + received = {} + + def capture_func(**kwargs): + received.update(kwargs) + + Executor.run_function(capture_func, {"x": 10, "y": 20, "z": 30}) + + assert received == {"x": 10, "y": 20, "z": 30} + class TestSigintHandle: """Test Executor sigint_handle method.""" @@ -439,6 +547,15 @@ class TestSigintHandle: assert executor.config.shutdown is True + def test_sigint_handle_accepts_signum_and_frame(self, executor): + """Test sigint_handle accepts signum and frame parameters.""" + mock_frame = MagicMock() + + # Should not raise + executor.sigint_handle(2, mock_frame) + + assert executor.config.shutdown is True + class TestExit: """Test Executor exit method.""" @@ -451,12 +568,11 @@ class TestExit: config = MagicMock() config.shutdown = False config.force_shutdown = False - config.backtest_engine = None config.task_queue = MagicMock() mock_config.return_value = config - exec = Executor() - exec.executor = MagicMock(spec=ThreadPoolExecutor) - return exec + exec_ = Executor() + exec_.executor = MagicMock(spec=ThreadPoolExecutor) + return exec_ def test_exit_with_timeout(self, executor): """Test exit respects timeout.""" @@ -498,17 +614,6 @@ class TestExit: executor.executor.shutdown.assert_called_once_with(wait=False, cancel_futures=False) - def test_exit_stops_backtest_engine(self, executor): - """Test exit stops backtest engine if present.""" - mock_engine = MagicMock() - mock_engine.stop_testing = False - executor.config.backtest_engine = mock_engine - executor.timeout = 0.1 - - executor.exit() - - assert mock_engine.stop_testing is True - def test_exit_force_shutdown(self, executor): """Test exit with force_shutdown.""" executor.config.force_shutdown = True @@ -518,6 +623,48 @@ class TestExit: executor.exit() mock_exit.assert_called_once_with(1) + def test_exit_on_shutdown_flag(self, executor): + """Test exit when shutdown is already True.""" + executor.config.shutdown = True + + executor.exit() + + # Should still stop strategies and clean up + executor.config.task_queue.cancel.assert_called_once() + executor.executor.shutdown.assert_called_once_with(wait=False, cancel_futures=False) + + def test_exit_no_strategies(self, executor): + """Test exit with no strategies.""" + executor.timeout = 0.1 + executor.strategy_runners = [] + + # Should not raise + executor.exit() + + executor.config.task_queue.cancel.assert_called_once() + + def test_exit_exception_calls_os_exit(self, executor): + """Test exit calls os._exit on exception during shutdown.""" + executor.config.shutdown = True + executor.config.task_queue.cancel.side_effect = Exception("Cancel error") + + with patch('os._exit') as mock_exit: + executor.exit() + mock_exit.assert_called_once_with(1) + + def test_exit_timeout_duration(self, executor): + """Test exit completes within timeout duration.""" + executor.timeout = 0.05 + executor.config.shutdown = False + + start = time.time() + executor.exit() + elapsed = time.time() - start + + # Should exit within timeout + small buffer + assert elapsed < 0.3 + assert executor.config.shutdown is True + class TestExecute: """Test Executor execute method.""" @@ -528,9 +675,8 @@ class TestExecute: with patch('aiomql.lib.executor.signal'): with patch.object(Config, '__new__') as mock_config: config = MagicMock() - config.shutdown = True # Set to True to exit immediately + config.shutdown = True # Set shutdown True so exit loop terminates immediately config.force_shutdown = False - config.backtest_engine = None config.task_queue = MagicMock() mock_config.return_value = config return Executor() @@ -548,30 +694,137 @@ class TestExecute: pass executor.add_coroutine(coroutine=coro, on_separate_thread=True) - # Should need: 1 strategy + 1 function + 1 coroutine_thread + 3 = 6 workers - with patch.object(ThreadPoolExecutor, '__init__', return_value=None) as mock_init: - with patch.object(ThreadPoolExecutor, '__enter__', return_value=MagicMock()): - with patch.object(ThreadPoolExecutor, '__exit__', return_value=None): - try: - executor.execute(workers=2) - except: - pass - # Workers should be max(2, 6) = 6 - # But the actual implementation uses max(workers, workers_) + # workers_ = 1 strategy + 1 function + 1 coroutine_thread + 3 = 6 + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute(workers=2) + + # max(2, 6) = 6 + mock_pool.assert_called_once_with(max_workers=6) def test_execute_uses_minimum_workers(self, executor): - """Test execute uses at least the calculated number of workers.""" - # With no strategies/functions, need at least 3 workers (for internal tasks) + """Test execute uses at least the calculated minimum workers.""" + # With no strategies/functions/threads, workers_ = 0 + 0 + 0 + 3 = 3 with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: - mock_executor = MagicMock() - mock_pool.return_value.__enter__.return_value = mock_executor + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) - try: - executor.execute(workers=1) - except: - pass + executor.execute(workers=1) - # Check that max_workers was at least 3 + # max(1, 3) = 3 + mock_pool.assert_called_once_with(max_workers=3) + + def test_execute_respects_custom_workers(self, executor): + """Test execute uses custom workers when larger than calculated.""" + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute(workers=20) + + # max(20, 3) = 20 + mock_pool.assert_called_once_with(max_workers=20) + + def test_execute_default_workers(self, executor): + """Test execute default workers parameter is 5.""" + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute() + + # max(5, 3) = 5 + mock_pool.assert_called_once_with(max_workers=5) + + def test_execute_submits_strategies(self, executor): + """Test execute submits each strategy to the thread pool.""" + strategy1 = MagicMock() + strategy2 = MagicMock() + executor.add_strategy(strategy=strategy1) + executor.add_strategy(strategy=strategy2) + + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute() + + # Check strategies were submitted + submit_calls = mock_tpe.submit.call_args_list + strategy_calls = [c for c in submit_calls if len(c.args) >= 2 and c.args[0] == executor.run_strategy] + assert len(strategy_calls) == 2 + + def test_execute_submits_functions(self, executor): + """Test execute submits functions to the thread pool.""" + def my_func(x): + pass + executor.add_function(function=my_func, kwargs={"x": 1}) + + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute() + + # Check function was submitted + submit_calls = mock_tpe.submit.call_args_list + func_calls = [c for c in submit_calls if len(c.args) >= 1 and c.args[0] == my_func] + assert len(func_calls) == 1 + + def test_execute_submits_coroutine_threads(self, executor): + """Test execute submits coroutine threads to the thread pool.""" + async def my_coro(): + pass + executor.add_coroutine(coroutine=my_coro, on_separate_thread=True) + + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute() + + # Check coroutine thread was submitted + submit_calls = mock_tpe.submit.call_args_list + coro_thread_calls = [c for c in submit_calls if len(c.args) >= 1 and c.args[0] == executor.run_coroutine_task] + assert len(coro_thread_calls) == 1 + + def test_execute_submits_coroutine_tasks(self, executor): + """Test execute submits run_coroutine_tasks via asyncio.run.""" + async def my_coro(): + pass + executor.add_coroutine(coroutine=my_coro) + + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute() + + # Check asyncio.run was submitted for coroutine tasks + submit_calls = mock_tpe.submit.call_args_list + asyncio_calls = [c for c in submit_calls if len(c.args) >= 1 and c.args[0] == asyncio.run] + assert len(asyncio_calls) == 1 + + def test_execute_sets_executor_attribute(self, executor): + """Test execute sets the executor attribute on the Executor instance.""" + with patch('aiomql.lib.executor.ThreadPoolExecutor') as mock_pool: + mock_tpe = MagicMock() + mock_pool.return_value.__enter__.return_value = mock_tpe + mock_pool.return_value.__exit__ = MagicMock(return_value=None) + + executor.execute() + + assert executor.executor == mock_tpe class TestIntegration: @@ -585,7 +838,6 @@ class TestIntegration: config = MagicMock() config.shutdown = False config.force_shutdown = False - config.backtest_engine = None config.task_queue = MagicMock() mock_config.return_value = config return Executor() @@ -642,11 +894,10 @@ class TestIntegration: executor.add_coroutine(coroutine=collector, kwargs={"value": 1}) executor.add_coroutine(coroutine=collector, kwargs={"value": 2}) - # Note: This won't work as expected because dicts can't have duplicate keys - # This tests the behavior with a single coroutine function + # Note: dicts can't have duplicate keys, so second call overwrites first await executor.run_coroutine_tasks() - # Only the last one will be in the dict + # Only the last kwargs will be used assert 2 in results def test_timeout_functionality(self, executor): @@ -654,7 +905,6 @@ class TestIntegration: executor.timeout = 0.05 executor.executor = MagicMock(spec=ThreadPoolExecutor) - import time start = time.time() executor.exit() elapsed = time.time() - start @@ -662,3 +912,20 @@ class TestIntegration: # Should exit within timeout + small buffer assert elapsed < 0.2 assert executor.config.shutdown is True + + def test_sigint_then_exit(self, executor): + """Test SIGINT handler followed by exit.""" + executor.executor = MagicMock(spec=ThreadPoolExecutor) + strategy = MagicMock() + strategy.running = True + executor.add_strategy(strategy=strategy) + + # Simulate SIGINT + executor.sigint_handle(2, None) + assert executor.config.shutdown is True + + # Now exit should process immediately + executor.exit() + + assert strategy.running is False + executor.config.task_queue.cancel.assert_called_once() diff --git a/tests/live/unit/async/test_get_data.py b/tests/live/unit/async/test_get_data.py deleted file mode 100644 index 551baf2..0000000 --- a/tests/live/unit/async/test_get_data.py +++ /dev/null @@ -1,49 +0,0 @@ -from pathlib import Path -from datetime import datetime, UTC - -import pytest - -from aiomql.core.backtesting.get_data import GetData -from aiomql.core.constants import TimeFrame - - -class TestGetData: - @classmethod - def setup_class(cls): - cls.start = datetime(2024, 2, 1, tzinfo=UTC) - cls.end = datetime(2024, 2, 2, tzinfo=UTC) - cls.symbols = ["BTCUSD", "ETHUSD"] - cls.timeframes = [TimeFrame.H1, TimeFrame.H2] - cls.g_data = GetData( - start=cls.start, end=cls.end, symbols=cls.symbols, timeframes=cls.timeframes, name="test_data" - ) - - @pytest.fixture(scope="class", autouse=True) - async def get_data(self): - await self.g_data.get_data() - self.g_data.save_data() - - def test_init(self): - assert self.g_data.start == self.start - assert self.g_data.end == self.end - assert self.g_data.symbols == set(self.symbols) - assert self.g_data.timeframes == set(self.timeframes) - assert self.g_data.name == "test_data" - assert self.g_data.range == range(int((self.end - self.start).total_seconds())) - assert self.g_data.span == range(int(self.start.timestamp()), int(self.end.timestamp())) - - async def test_get_data(self): - assert self.g_data.data.fully_loaded is True - assert len(self.g_data.data.ticks.keys()) == 2 - assert len(self.g_data.data.symbols.keys()) == 2 - - async def test_save_data(self): - file = Path(self.g_data.config.backtest_dir / "test_data.pkl") - assert file.exists() - - async def test_load_data(self): - data = GetData.load_data(name="tests/live/backtesting/test_data.pkl") - assert data.name == "test_data" - assert data.fully_loaded is True - assert len(data.ticks.keys()) == 2 - assert len(data.symbols.keys()) == 2 diff --git a/tests/live/unit/async/test_sessions.py b/tests/live/unit/async/test_sessions.py index fbc1ff8..fa63f20 100644 --- a/tests/live/unit/async/test_sessions.py +++ b/tests/live/unit/async/test_sessions.py @@ -23,7 +23,7 @@ from datetime import time, datetime, timedelta, UTC from unittest.mock import MagicMock, AsyncMock, patch import pytest -from aiomql.lib.sessions import Session, Sessions, Duration, delta, backtest_sleep +from aiomql.lib.sessions import Session, Sessions, Duration, delta from aiomql.core.config import Config from aiomql.core.models import TradePosition, OrderSendResult @@ -51,6 +51,20 @@ class TestDuration: d = Duration(hours=1, minutes=0, seconds=0) assert isinstance(d, tuple) + def test_duration_zero(self): + """Test Duration with all zeros.""" + d = Duration(hours=0, minutes=0, seconds=0) + assert d.hours == 0 + assert d.minutes == 0 + assert d.seconds == 0 + + def test_duration_indexing(self): + """Test Duration can be accessed by index.""" + d = Duration(hours=5, minutes=10, seconds=20) + assert d[0] == 5 + assert d[1] == 10 + assert d[2] == 20 + class TestDeltaFunction: """Test delta helper function.""" @@ -82,6 +96,12 @@ class TestDeltaFunction: expected = timedelta(hours=23, minutes=59, seconds=59) assert result == expected + def test_delta_returns_timedelta(self): + """Test delta returns a timedelta object.""" + t = time(hour=12, minute=0) + result = delta(t) + assert isinstance(result, timedelta) + class TestSessionInitialization: """Test Session class initialization.""" @@ -146,6 +166,34 @@ class TestSessionInitialization: session = Session(start=8, end=16) assert isinstance(session.config, Config) + def test_init_default_on_start_none(self): + """Test Session defaults on_start to None.""" + session = Session(start=8, end=16) + assert session.on_start is None + + def test_init_default_on_end_none(self): + """Test Session defaults on_end to None.""" + session = Session(start=8, end=16) + assert session.on_end is None + + def test_init_default_custom_start_none(self): + """Test Session defaults custom_start to None.""" + session = Session(start=8, end=16) + assert session.custom_start is None + + def test_init_default_custom_end_none(self): + """Test Session defaults custom_end to None.""" + session = Session(start=8, end=16) + assert session.custom_end is None + + def test_init_start_gets_utc_timezone(self): + """Test Session start time gets UTC timezone added.""" + session = Session(start=time(8, 30, 15), end=16) + assert session.start.tzinfo == UTC + assert session.start.hour == 8 + assert session.start.minute == 30 + assert session.start.second == 15 + class TestSessionContains: """Test Session __contains__ method.""" @@ -180,6 +228,18 @@ class TestSessionContains: test_time = time(17, 0) assert test_time not in session + def test_contains_time_just_inside_start(self): + """Test time just after start is in session.""" + session = Session(start=time(8, 0), end=time(16, 0)) + test_time = time(8, 0, 1) + assert test_time in session + + def test_contains_time_just_before_start(self): + """Test time just before start is not in session.""" + session = Session(start=time(8, 0), end=time(16, 0)) + test_time = time(7, 59, 59) + assert test_time not in session + class TestSessionStringMethods: """Test Session string representation methods.""" @@ -196,6 +256,11 @@ class TestSessionStringMethods: result = repr(session) assert "<-->" in result + def test_str_and_repr_match(self): + """Test __str__ and __repr__ return same value.""" + session = Session(start=8, end=16) + assert str(session) == repr(session) + class TestSessionLen: """Test Session __len__ method.""" @@ -212,6 +277,11 @@ class TestSessionLen: expected = 8 * 3600 + 15 * 60 # 8 hours 15 minutes assert len(session) == expected + def test_len_one_hour(self): + """Test __len__ for a one-hour session.""" + session = Session(start=10, end=11) + assert len(session) == 3600 + class TestSessionDuration: """Test Session duration method.""" @@ -242,18 +312,26 @@ class TestSessionDuration: class TestSessionInSession: """Test Session in_session method.""" - @patch.object(Config, '__new__') - def test_in_session_live_mode(self, mock_config): - """Test in_session in live mode.""" - config = MagicMock() - config.mode = "live" - mock_config.return_value = config - - # Test depends on current time, just verify it runs + def test_in_session_returns_bool(self): + """Test in_session returns a boolean.""" session = Session(start=0, end=23) result = session.in_session() assert isinstance(result, bool) + def test_in_session_wide_window(self): + """Test in_session with nearly all-day window returns True.""" + # 0:00 to 23:00 covers almost the entire day + session = Session(start=0, end=23) + result = session.in_session() + assert isinstance(result, bool) + + def test_in_session_uses_contains(self): + """Test in_session delegates to __contains__ with current time.""" + session = Session(start=0, end=23) + now = datetime.now(tz=UTC).time() + expected = now in session + assert session.in_session() == expected + class TestSessionActions: """Test Session action methods.""" @@ -318,6 +396,23 @@ class TestSessionActions: # Should not raise, just log warning await session.action(action="close_all") + async def test_action_unknown_action_does_nothing(self, session): + """Test action with unknown string does nothing.""" + # Should not raise - falls through to default case + await session.action(action="unknown_action") + + async def test_begin_with_no_on_start(self, session): + """Test begin does nothing when on_start is None.""" + session.on_start = None + # Should not raise + await session.begin() + + async def test_close_with_no_on_end(self, session): + """Test close does nothing when on_end is None.""" + session.on_end = None + # Should not raise + await session.close() + class TestSessionClosePositions: """Test Session position closing methods.""" @@ -337,6 +432,45 @@ class TestSessionClosePositions: await session.close_positions(positions=(position,)) session.positions_manager.close_position.assert_called_once_with(position=position) + async def test_close_positions_counts_closed(self, session): + """Test close_positions correctly counts successful closes.""" + pos1 = MagicMock(spec=TradePosition) + pos2 = MagicMock(spec=TradePosition) + + result_ok = MagicMock(spec=OrderSendResult) + result_ok.retcode = 10009 + + session.positions_manager.close_position = AsyncMock(return_value=result_ok) + # Should not raise + await session.close_positions(positions=(pos1, pos2)) + + async def test_close_positions_counts_pending(self, session): + """Test close_positions counts pending (non-10009) results.""" + position = MagicMock(spec=TradePosition) + + result_fail = MagicMock(spec=OrderSendResult) + result_fail.retcode = 10006 # Not 10009 + + session.positions_manager.close_position = AsyncMock(return_value=result_fail) + # Should not raise, logs warning about pending + await session.close_positions(positions=(position,)) + + async def test_close_positions_handles_exceptions_in_results(self, session): + """Test close_positions handles exceptions in gather results.""" + position = MagicMock(spec=TradePosition) + + session.positions_manager.close_position = AsyncMock( + side_effect=Exception("Connection error") + ) + # return_exceptions=True means exceptions are returned, not raised + await session.close_positions(positions=(position,)) + + async def test_close_positions_empty_tuple(self, session): + """Test close_positions with empty tuple.""" + session.positions_manager.close_position = AsyncMock() + await session.close_positions(positions=()) + session.positions_manager.close_position.assert_not_called() + async def test_close_all(self, session): """Test close_all gets and closes all positions.""" positions = (MagicMock(spec=TradePosition),) @@ -363,6 +497,21 @@ class TestSessionClosePositions: assert win_pos in closed_positions assert loss_pos not in closed_positions + async def test_close_win_includes_zero_profit(self, session): + """Test close_win includes positions with zero profit (>= 0).""" + zero_pos = MagicMock(spec=TradePosition) + zero_pos.profit = 0 + loss_pos = MagicMock(spec=TradePosition) + loss_pos.profit = -10 + + session.positions_manager.get_positions = AsyncMock(return_value=(zero_pos, loss_pos)) + session.close_positions = AsyncMock() + + await session.close_win() + closed_positions = session.close_positions.call_args[1]["positions"] + assert zero_pos in closed_positions + assert loss_pos not in closed_positions + async def test_close_loss_filters_loss(self, session): """Test close_loss only closes losing positions.""" win_pos = MagicMock(spec=TradePosition) @@ -379,20 +528,35 @@ class TestSessionClosePositions: assert loss_pos in closed_positions assert win_pos not in closed_positions + async def test_close_loss_excludes_zero_profit(self, session): + """Test close_loss excludes positions with zero profit (< 0 only).""" + zero_pos = MagicMock(spec=TradePosition) + zero_pos.profit = 0 + loss_pos = MagicMock(spec=TradePosition) + loss_pos.profit = -10 + + session.positions_manager.get_positions = AsyncMock(return_value=(zero_pos, loss_pos)) + session.close_positions = AsyncMock() + + await session.close_loss() + closed_positions = session.close_positions.call_args[1]["positions"] + assert loss_pos in closed_positions + assert zero_pos not in closed_positions + class TestSessionUntil: """Test Session until method.""" - @patch.object(Config, '__new__') - def test_until_returns_seconds(self, mock_config): - """Test until returns seconds until session start.""" - config = MagicMock() - config.mode = "live" - mock_config.return_value = config - - session = Session(start=23, end=0) # Future session + def test_until_returns_int(self): + """Test until returns an integer.""" + session = Session(start=23, end=0) result = session.until() assert isinstance(result, int) + + def test_until_returns_nonnegative(self): + """Test until returns a non-negative value.""" + session = Session(start=23, end=0) + result = session.until() assert result >= 0 @@ -423,6 +587,37 @@ class TestSessionsInitialization: sessions = Sessions(sessions=[s1]) assert isinstance(sessions.config, Config) + def test_init_current_session_none(self): + """Test Sessions initializes current_session to None.""" + s1 = Session(start=8, end=12) + sessions = Sessions(sessions=[s1]) + assert sessions.current_session is None + + def test_init_sorts_by_start_then_end(self): + """Test Sessions sorts by start hour then end hour.""" + s1 = Session(start=8, end=16) + s2 = Session(start=8, end=12) + sessions = Sessions(sessions=[s1, s2]) + + # Both start at 8, sorted by end hour + assert sessions.sessions[0].end.hour == 12 + assert sessions.sessions[1].end.hour == 16 + + def test_init_accepts_iterable(self): + """Test Sessions accepts any iterable of sessions.""" + s1 = Session(start=8, end=12) + s2 = Session(start=13, end=17) + + # Pass as tuple + sessions = Sessions(sessions=(s1, s2)) + assert len(sessions.sessions) == 2 + + def test_init_single_session(self): + """Test Sessions with a single session.""" + s1 = Session(start=8, end=16) + sessions = Sessions(sessions=[s1]) + assert len(sessions.sessions) == 1 + class TestSessionsFind: """Test Sessions find method.""" @@ -451,6 +646,22 @@ class TestSessionsFind: assert result is not None assert result.start.hour == 13 + def test_find_at_boundary(self, sessions): + """Test find at session start boundary.""" + result = sessions.find(moment=time(8, 0)) + assert result is not None + assert result.start.hour == 8 + + def test_find_before_all_sessions(self, sessions): + """Test find before any session returns None.""" + result = sessions.find(moment=time(5, 0)) + assert result is None + + def test_find_after_all_sessions(self, sessions): + """Test find after all sessions returns None.""" + result = sessions.find(moment=time(20, 0)) + assert result is None + class TestSessionsFindNext: """Test Sessions find_next method.""" @@ -477,6 +688,11 @@ class TestSessionsFindNext: result = sessions.find_next(moment=time(18, 0)) assert result.start.hour == 8 + def test_find_next_at_midnight(self, sessions): + """Test find_next at midnight wraps correctly.""" + result = sessions.find_next(moment=time(0, 0)) + assert result.start.hour == 8 + class TestSessionsContains: """Test Sessions __contains__ method.""" @@ -500,6 +716,10 @@ class TestSessionsContains: """Test time outside all sessions returns False.""" assert time(18, 0) not in sessions + def test_contains_time_in_second_session(self, sessions): + """Test time in second session returns True.""" + assert time(15, 0) in sessions + class TestSessionsContextManager: """Test Sessions async context manager.""" @@ -527,6 +747,21 @@ class TestSessionsContextManager: mock_session.close.assert_called_once() + async def test_aexit_no_current_session(self, sessions): + """Test __aexit__ does nothing when current_session is None.""" + sessions.check = AsyncMock() + sessions.current_session = None + + # Should not raise + async with sessions: + pass + + async def test_aenter_returns_self(self, sessions): + """Test __aenter__ returns the Sessions instance.""" + sessions.check = AsyncMock() + async with sessions as s: + assert s is sessions + class TestSessionsCheck: """Test Sessions check method.""" @@ -572,6 +807,58 @@ class TestSessionsCheck: old_session.close.assert_called_once() assert sessions.current_session == new_session + async def test_check_sleeps_when_outside_sessions(self, sessions): + """Test check sleeps until next session when outside all sessions.""" + sessions.current_session = None + sessions.find = MagicMock(return_value=None) + + next_session = MagicMock() + next_session.until.return_value = 100 + next_session.begin = AsyncMock() + sessions.find_next = MagicMock(return_value=next_session) + + with patch('asyncio.sleep', new_callable=AsyncMock) as mock_sleep: + await sessions.check() + mock_sleep.assert_called_once_with(110) # until() + 10 + + assert sessions.current_session == next_session + next_session.begin.assert_called_once() + + async def test_check_closes_old_session_before_sleeping(self, sessions): + """Test check closes current session before sleeping for next.""" + old_session = MagicMock() + old_session.in_session.return_value = False + old_session.close = AsyncMock() + sessions.current_session = old_session + + sessions.find = MagicMock(return_value=None) + + next_session = MagicMock() + next_session.until.return_value = 50 + next_session.begin = AsyncMock() + sessions.find_next = MagicMock(return_value=next_session) + + with patch('asyncio.sleep', new_callable=AsyncMock): + await sessions.check() + + old_session.close.assert_called_once() + assert sessions.current_session == next_session + + async def test_check_begins_next_session_after_sleep(self, sessions): + """Test check calls begin on next session after sleeping.""" + sessions.current_session = None + sessions.find = MagicMock(return_value=None) + + next_session = MagicMock() + next_session.until.return_value = 0 + next_session.begin = AsyncMock() + sessions.find_next = MagicMock(return_value=next_session) + + with patch('asyncio.sleep', new_callable=AsyncMock): + await sessions.check() + + next_session.begin.assert_called_once() + class TestIntegration: """Integration tests for Sessions.""" @@ -619,3 +906,41 @@ class TestIntegration: assert called["start"] is True assert called["end"] is True + + def test_find_navigates_across_sessions(self): + """Test finding sessions across the full day.""" + s1 = Session(start=8, end=12) + s2 = Session(start=13, end=17) + s3 = Session(start=18, end=22) + sessions = Sessions(sessions=[s1, s2, s3]) + + # Before any session + assert sessions.find(moment=time(5, 0)) is None + + # In first session + result = sessions.find(moment=time(10, 0)) + assert result.start.hour == 8 + + # Between sessions + assert sessions.find(moment=time(12, 30)) is None + + # In second session + result = sessions.find(moment=time(15, 0)) + assert result.start.hour == 13 + + # In third session + result = sessions.find(moment=time(20, 0)) + assert result.start.hour == 18 + + # After all sessions + assert sessions.find(moment=time(23, 0)) is None + + def test_session_actions_configuration(self): + """Test configuring different actions on sessions.""" + s1 = Session(start=8, end=12, on_start="close_all", on_end="close_loss") + s2 = Session(start=13, end=17, on_end="close_win") + + assert s1.on_start == "close_all" + assert s1.on_end == "close_loss" + assert s2.on_start is None + assert s2.on_end == "close_win" diff --git a/tests/live/unit/async/test_trader.py b/tests/live/unit/async/test_trader.py index 98fd2ae..26ab7e3 100644 --- a/tests/live/unit/async/test_trader.py +++ b/tests/live/unit/async/test_trader.py @@ -1,866 +1,908 @@ """Comprehensive tests for the Trader module. Tests cover: -- Trader initialization with default and custom values -- set_trade_stop_levels_pips method -- set_trade_stop_levels_points method -- create_order_with_stops async method -- create_order_with_sl async method -- create_order_with_points async method -- create_order_no_stops async method -- check_order async method -- send_order async method -- record_trade async method -- Integration tests with various order types -- Edge cases and boundary conditions +- Trader initialization (__init__) +- set_trade_stop_levels_pips (long/short orders) +- set_trade_stop_levels_points (long/short orders) +- create_order_with_stops +- create_order_with_sl +- create_order_with_points +- create_order_no_stops +- check_order +- send_order +- record_trade +- place_trade (abstract method enforcement) """ -from math import floor +from unittest.mock import MagicMock, AsyncMock, patch, PropertyMock import pytest -from aiomql.lib.ram import RAM from aiomql.lib.trader import Trader -from aiomql.contrib.traders import SimpleTrader -from aiomql.contrib.symbols import ForexSymbol -from aiomql.lib.symbol import Symbol -from aiomql.core.constants import OrderType -from aiomql.lib.account import Account from aiomql.lib.order import Order +from aiomql.lib.ram import RAM +from aiomql.lib.symbol import Symbol +from aiomql.core.models import OrderType, OrderSendResult, OrderCheckResult from aiomql.core.config import Config -from aiomql.core.models import OrderSendResult, OrderCheckResult +from aiomql.core.task_queue import QueueItem -class TestTraderInitialization: - """Test Trader class initialization.""" +# --- Concrete subclass for testing abstract Trader --- - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) +class ConcreteTrader(Trader): + """Non-abstract subclass of Trader for testing purposes.""" - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol before tests.""" - await self.symbol.initialize() + async def place_trade(self, *args, **kwargs): + pass - def test_init_with_symbol_only(self): - """Test Trader can be initialized with just a symbol.""" - trader = SimpleTrader(symbol=self.symbol) - assert trader.symbol == self.symbol - assert isinstance(trader.ram, RAM) - assert isinstance(trader.order, Order) - def test_init_with_symbol_and_ram(self): - """Test Trader initialized with symbol and custom RAM.""" - trader = SimpleTrader(symbol=self.symbol, ram=self.ram) - assert trader.symbol == self.symbol - assert trader.ram == self.ram +# --- Fixtures --- - def test_init_creates_order_with_symbol_name(self): - """Test Trader creates order with correct symbol name.""" - trader = SimpleTrader(symbol=self.symbol) - assert trader.order.symbol == self.symbol.name +@pytest.fixture +def mock_symbol(): + """Create a mock Symbol with standard forex attributes.""" + symbol = MagicMock(spec=Symbol) + symbol.name = "EURUSD" + symbol.pip = 0.0001 + symbol.point = 0.00001 + symbol.digits = 5 + symbol.volume_min = 0.01 + symbol.compute_volume_sl = MagicMock(return_value=0.1) + symbol.compute_volume_points = MagicMock(return_value=0.1) + symbol.amount_in_quote_currency = AsyncMock(return_value=100.0) + symbol.info_tick = AsyncMock() + return symbol - def test_init_has_config_attribute(self): - """Test Trader has config attribute.""" - trader = SimpleTrader(symbol=self.symbol) - assert hasattr(trader, 'config') - assert isinstance(trader.config, Config) - def test_init_has_parameters_attribute(self): - """Test Trader has empty parameters dict.""" - trader = SimpleTrader(symbol=self.symbol) - assert hasattr(trader, 'parameters') - assert isinstance(trader.parameters, dict) - assert trader.parameters == {} +@pytest.fixture +def mock_ram(): + """Create a mock RAM instance.""" + ram = MagicMock(spec=RAM) + ram.risk_to_reward = 2.0 + ram.get_amount = AsyncMock(return_value=100.0) + return ram - def test_init_with_default_ram_values(self): - """Test Trader uses default RAM if not provided.""" - trader = SimpleTrader(symbol=self.symbol) - assert trader.ram.risk_to_reward == 2 - assert trader.ram.risk == 1 + +@pytest.fixture +def mock_tick(): + """Create a mock price tick.""" + tick = MagicMock() + tick.ask = 1.10000 + tick.bid = 1.09990 + return tick + + +@pytest.fixture +def trader(mock_symbol, mock_ram, mock_tick): + """Create a ConcreteTrader for testing.""" + mock_symbol.info_tick.return_value = mock_tick + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + return t + + +# --- Tests --- + +class TestTraderInit: + """Test Trader initialization.""" + + def test_init_sets_symbol(self, mock_symbol, mock_ram): + """Test __init__ sets symbol.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert t.symbol is mock_symbol + + def test_init_sets_ram(self, mock_symbol, mock_ram): + """Test __init__ sets provided RAM.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert t.ram is mock_ram + + def test_init_creates_default_ram(self, mock_symbol): + """Test __init__ creates default RAM when none provided.""" + t = ConcreteTrader(symbol=mock_symbol) + assert isinstance(t.ram, RAM) + + def test_init_creates_order(self, mock_symbol, mock_ram): + """Test __init__ creates Order with symbol name.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert isinstance(t.order, Order) + assert t.order.symbol == "EURUSD" + + def test_init_creates_config(self, mock_symbol, mock_ram): + """Test __init__ creates Config instance.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert isinstance(t.config, Config) + + def test_init_creates_empty_parameters(self, mock_symbol, mock_ram): + """Test __init__ creates empty parameters dict.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert t.parameters == {} class TestSetTradeStopLevelsPips: """Test set_trade_stop_levels_pips method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="EURUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + def test_long_order_sl_below_price(self, trader): + """Test long order sets SL below price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() + trader.set_trade_stop_levels_pips(pips=50) - async def test_set_stop_levels_pips_buy_order(self): - """Test setting stop levels for buy order using pips.""" - tick = await self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - pips = 50 + assert trader.order.sl < trader.order.price - self.trader.set_trade_stop_levels_pips(pips=pips) + def test_long_order_tp_above_price(self, trader): + """Test long order sets TP above price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - expected_sl = round(tick.ask - (pips * self.symbol.pip), self.symbol.digits) - expected_tp = round(tick.ask + (pips * self.ram.risk_to_reward * self.symbol.pip), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_pips(pips=50) - async def test_set_stop_levels_pips_sell_order(self): - """Test setting stop levels for sell order using pips.""" - tick = await self.symbol.info_tick() - self.trader.order.price = tick.bid - self.trader.order.type = OrderType.SELL - pips = 50 + assert trader.order.tp > trader.order.price - self.trader.set_trade_stop_levels_pips(pips=pips) + def test_short_order_sl_above_price(self, trader): + """Test short order sets SL above price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = False + trader.order.type.is_short = True - expected_sl = round(tick.bid + (pips * self.symbol.pip), self.symbol.digits) - expected_tp = round(tick.bid - (pips * self.ram.risk_to_reward * self.symbol.pip), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_pips(pips=50) - async def test_set_stop_levels_pips_custom_risk_to_reward(self): - """Test setting stop levels with custom risk to reward ratio.""" - tick = await self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - pips = 30 - custom_rr = 3 + assert trader.order.sl > trader.order.price - self.trader.set_trade_stop_levels_pips(pips=pips, risk_to_reward=custom_rr) + def test_short_order_tp_below_price(self, trader): + """Test short order sets TP below price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = False + trader.order.type.is_short = True - expected_sl = round(tick.ask - (pips * self.symbol.pip), self.symbol.digits) - expected_tp = round(tick.ask + (pips * custom_rr * self.symbol.pip), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_pips(pips=50) + + assert trader.order.tp < trader.order.price + + def test_custom_risk_to_reward(self, trader): + """Test custom risk_to_reward overrides RAM default.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False + + trader.set_trade_stop_levels_pips(pips=50, risk_to_reward=3.0) + + sl_distance = abs(trader.order.price - trader.order.sl) + tp_distance = abs(trader.order.tp - trader.order.price) + assert round(tp_distance / sl_distance, 1) == 3.0 + + def test_uses_ram_risk_to_reward_by_default(self, trader): + """Test uses RAM risk_to_reward when not specified.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False + trader.ram.risk_to_reward = 2.0 + + trader.set_trade_stop_levels_pips(pips=50) + + sl_distance = abs(trader.order.price - trader.order.sl) + tp_distance = abs(trader.order.tp - trader.order.price) + assert round(tp_distance / sl_distance, 1) == 2.0 + + def test_rounds_to_symbol_digits(self, trader): + """Test SL and TP are rounded to symbol.digits.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False + + trader.set_trade_stop_levels_pips(pips=50) + + # With 5 digits, values should have at most 5 decimal places + sl_str = f"{trader.order.sl:.10f}".rstrip("0") + tp_str = f"{trader.order.tp:.10f}".rstrip("0") + sl_decimals = len(sl_str.split(".")[1]) if "." in sl_str else 0 + tp_decimals = len(tp_str.split(".")[1]) if "." in tp_str else 0 + assert sl_decimals <= 5 + assert tp_decimals <= 5 class TestSetTradeStopLevelsPoints: """Test set_trade_stop_levels_points method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="EURUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + def test_long_order_sl_below_price(self, trader): + """Test long order sets SL below price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() + trader.set_trade_stop_levels_points(points=500) - async def test_set_stop_levels_points_buy_order(self): - """Test setting stop levels for buy order using points.""" - tick = await self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - points = 500 + assert trader.order.sl < trader.order.price - self.trader.set_trade_stop_levels_points(points=points) + def test_long_order_tp_above_price(self, trader): + """Test long order sets TP above price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - expected_sl = round(tick.ask - (points * self.symbol.point), self.symbol.digits) - expected_tp = round(tick.ask + (points * self.ram.risk_to_reward * self.symbol.point), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_points(points=500) - async def test_set_stop_levels_points_custom_risk_to_reward(self): - """Test setting stop levels with custom risk to reward.""" - tick = await self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - points = 500 - custom_rr = 4 + assert trader.order.tp > trader.order.price - self.trader.set_trade_stop_levels_points(points=points, risk_to_reward=custom_rr) + def test_custom_risk_to_reward(self, trader): + """Test custom risk_to_reward for points.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - expected_sl = round(tick.ask - (points * self.symbol.point), self.symbol.digits) - expected_tp = round(tick.ask + (points * custom_rr * self.symbol.point), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_points(points=500, risk_to_reward=4.0) - -class TestCreateOrderNoStops: - """Test create_order_no_stops async method.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() - - async def test_create_order_no_stops_buy(self): - """Test creating buy order without stops.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.volume == self.symbol.volume_min - assert self.trader.order.price is not None - - async def test_create_order_no_stops_sell(self): - """Test creating sell order without stops.""" - await self.trader.create_order_no_stops(order_type=OrderType.SELL) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.volume == self.symbol.volume_min - assert self.trader.order.price is not None - - async def test_create_order_no_stops_with_custom_volume(self): - """Test creating order with custom volume.""" - custom_volume = self.symbol.volume_min * 2 - await self.trader.create_order_no_stops(order_type=OrderType.BUY, volume=custom_volume) - - assert self.trader.order.volume == custom_volume - - async def test_create_order_no_stops_uses_correct_price(self): - """Test order uses ask for buy and bid for sell.""" - tick = await self.symbol.info_tick() - - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - # Price should be close to ask (may differ slightly due to timing) - assert abs(self.trader.order.price - tick.ask) < tick.ask * 0.01 - - async def test_create_order_no_stops_send_success(self): - """Test sending order without stops succeeds.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - -class TestCreateOrderWithSl: - """Test create_order_with_sl async method.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() - - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol and account.""" - await self.symbol.initialize() - await self.account.refresh() - - async def test_create_order_with_sl_sell(self): - """Test creating sell order with stop loss.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.bid + dsl - - await self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.sl == sl - assert self.trader.order.tp is not None - assert self.trader.order.volume > 0 - - async def test_create_order_with_sl_buy(self): - """Test creating buy order with stop loss.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.ask - dsl - - await self.trader.create_order_with_sl(order_type=OrderType.BUY, sl=sl) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.sl == sl - assert self.trader.order.tp is not None - - async def test_create_order_with_sl_respects_risk_to_reward(self): - """Test TP is set according to risk to reward ratio.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.bid + dsl - - await self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - - # TP should be approximately at dsl * risk_to_reward distance from price - expected_dtp = dsl * self.ram.risk_to_reward - actual_dtp = abs(self.trader.order.price - self.trader.order.tp) - assert abs(actual_dtp - expected_dtp) < self.symbol.point * 10 - - async def test_create_order_with_sl_custom_amount_to_risk(self): - """Test creating order with custom amount to risk.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.bid + dsl - custom_amount = 20 - - await self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl, amount_to_risk=custom_amount) - - assert self.trader.order.volume > 0 - - async def test_create_order_with_sl_send_success(self): - """Test order with SL can be sent successfully.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.bid + dsl - - await self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - result = await self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - async def test_create_order_with_sl_profit_loss_ratio(self): - """Test profit and loss are in correct ratio.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.bid + dsl - - await self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - await self.trader.order.send() - - profit = floor(await self.trader.order.calc_profit()) - loss = -floor(abs(await self.trader.order.calc_loss())) - - assert profit == -loss * self.ram.risk_to_reward - assert abs(profit - self.ram.fixed_amount * self.ram.risk_to_reward) <= 2.5 - assert abs(abs(loss) - abs(-self.ram.fixed_amount)) <= 2 + sl_distance = abs(trader.order.price - trader.order.sl) + tp_distance = abs(trader.order.tp - trader.order.price) + assert round(tp_distance / sl_distance, 1) == 4.0 class TestCreateOrderWithStops: - """Test create_order_with_stops async method.""" + """Test create_order_with_stops method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() + async def test_sets_order_attributes(self, trader, mock_tick): + """Test sets sl, tp, volume, price, and type on order.""" + order_type = MagicMock() + order_type.is_long = True - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol and account.""" - await self.symbol.initialize() - await self.account.refresh() + trader.order.set_attributes = MagicMock() - async def test_create_order_with_stops_buy(self): - """Test creating buy order with SL and TP.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = await self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - - await self.trader.create_order_with_stops(order_type=OrderType.BUY, sl=sl, tp=tp) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.sl == sl - assert self.trader.order.tp == tp - assert self.trader.order.volume > 0 - - async def test_create_order_with_stops_sell(self): - """Test creating sell order with SL and TP.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = await self.symbol.info_tick() - sl = tick.bid + dsl - tp = tick.bid - dtp - - await self.trader.create_order_with_stops(order_type=OrderType.SELL, sl=sl, tp=tp) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.sl == sl - assert self.trader.order.tp == tp - - async def test_create_order_with_stops_send_success(self): - """Test order with stops can be sent successfully.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = await self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - - await self.trader.create_order_with_stops(order_type=OrderType.BUY, sl=sl, tp=tp) - result = await self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - async def test_create_order_with_stops_profit_loss_calculation(self): - """Test profit/loss calculations are correct.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = await self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - - await self.trader.create_order_with_stops(order_type=OrderType.BUY, sl=sl, tp=tp) - result = await self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - profit = round(await self.trader.order.calc_profit(), self.account.currency_digits) - loss = -round(abs(await self.trader.order.calc_loss()), self.account.currency_digits) - - assert abs(profit) - abs(-loss * self.ram.risk_to_reward) <= 2.5 - assert abs(profit - (self.ram.fixed_amount * self.ram.risk_to_reward)) <= 2.5 - assert abs(abs(loss) - self.ram.fixed_amount) <= 2.5 - - async def test_create_order_with_stops_custom_amount(self): - """Test creating order with custom amount to risk.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * 2 - tick = await self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - custom_amount = 25 - - await self.trader.create_order_with_stops( - order_type=OrderType.BUY, sl=sl, tp=tp, amount_to_risk=custom_amount + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 ) - assert self.trader.order.volume > 0 + trader.order.set_attributes.assert_called_once() + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["sl"] == 1.09500 + assert call_kwargs["tp"] == 1.11000 + assert call_kwargs["type"] is order_type + + async def test_uses_ask_for_long(self, trader, mock_tick): + """Test uses ask price for long orders.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.ask + + async def test_uses_bid_for_short(self, trader, mock_tick): + """Test uses bid price for short orders.""" + order_type = MagicMock() + order_type.is_long = False + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_stops( + order_type=order_type, sl=1.10500, tp=1.09000 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.bid + + async def test_calculates_volume(self, trader): + """Test computes volume using symbol.compute_volume_sl.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + trader.symbol.compute_volume_sl.assert_called_once() + + async def test_custom_amount_to_risk(self, trader): + """Test custom amount_to_risk overrides RAM.get_amount.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000, amount_to_risk=500.0 + ) + + # RAM.get_amount should not be called + trader.ram.get_amount.assert_not_called() + + async def test_default_amount_from_ram(self, trader): + """Test uses RAM.get_amount when amount_to_risk not specified.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + trader.ram.get_amount.assert_called_once() + + async def test_converts_amount_to_quote_currency(self, trader): + """Test converts amount using symbol.amount_in_quote_currency.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + trader.symbol.amount_in_quote_currency.assert_called_once() + + +class TestCreateOrderWithSl: + """Test create_order_with_sl method.""" + + async def test_calculates_tp_from_sl(self, trader, mock_tick): + """Test calculates TP based on SL distance and risk_to_reward.""" + order_type = OrderType.BUY + + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_sl( + order_type=order_type, sl=1.09500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + # For BUY: tp should be above price + assert call_kwargs["tp"] > call_kwargs["price"] + + async def test_buy_uses_ask_price(self, trader, mock_tick): + """Test BUY order uses ask price.""" + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_sl( + order_type=OrderType.BUY, sl=1.09500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.ask + + async def test_sell_uses_bid_price(self, trader, mock_tick): + """Test SELL order uses bid price.""" + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_sl( + order_type=OrderType.SELL, sl=1.10500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.bid + + async def test_custom_risk_to_reward(self, trader, mock_tick): + """Test custom risk_to_reward affects TP calculation.""" + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_sl( + order_type=OrderType.BUY, sl=1.09500, risk_to_reward=3.0 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + price = call_kwargs["price"] + sl_dist = abs(price - 1.09500) + tp_dist = abs(call_kwargs["tp"] - price) + assert round(tp_dist / sl_dist, 1) == 3.0 + + async def test_sell_tp_below_price(self, trader, mock_tick): + """Test SELL order sets TP below price.""" + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_sl( + order_type=OrderType.SELL, sl=1.10500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["tp"] < call_kwargs["price"] + + async def test_custom_amount_to_risk(self, trader): + """Test custom amount_to_risk skips RAM.get_amount.""" + trader.order.set_attributes = MagicMock() + + await trader.create_order_with_sl( + order_type=OrderType.BUY, sl=1.09500, amount_to_risk=200.0 + ) + + trader.ram.get_amount.assert_not_called() class TestCreateOrderWithPoints: - """Test create_order_with_points async method.""" + """Test create_order_with_points method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() - - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() - await self.account.refresh() - - async def test_create_order_with_points_buy(self): - """Test creating buy order with points.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - await self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.volume > 0 - assert self.trader.order.sl is not None - assert self.trader.order.tp is not None - - async def test_create_order_with_points_sell(self): - """Test creating sell order with points.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - await self.trader.create_order_with_points(order_type=OrderType.SELL, points=points) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.volume > 0 - - async def test_create_order_with_points_send_success(self): - """Test order with points can be sent successfully.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - await self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) - result = await self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - async def test_create_order_with_points_profit_loss_ratio(self): - """Test profit and loss are in correct ratio.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - await self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) - res = await self.trader.order.send() - profit = floor(await self.trader.order.mt5.order_calc_profit(res.request.type, res.request.symbol, res.request.volume, - res.request.price, res.request.tp)) - loss = -floor(abs(await self.trader.order.mt5.order_calc_profit(res.request.type, res.request.symbol, res.request.volume, - res.request.price, res.request.sl))) - - assert abs(profit - self.ram.fixed_amount * self.ram.risk_to_reward) <= 2.5 - assert abs(abs(loss) - abs(-self.ram.fixed_amount)) <= 2 - - async def test_create_order_with_points_custom_risk_to_reward(self): - """Test order with custom risk to reward.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - custom_rr = 3 - - await self.trader.create_order_with_points( - order_type=OrderType.BUY, points=points, risk_to_reward=custom_rr + async def test_sets_order_type(self, trader): + """Test sets order type on order.""" + await trader.create_order_with_points( + order_type=OrderType.BUY, points=500 ) - # TP should be at points * custom_rr distance from price - expected_tp_distance = points * custom_rr * self.symbol.point - actual_tp_distance = abs(self.trader.order.tp - self.trader.order.price) - assert abs(actual_tp_distance - expected_tp_distance) < self.symbol.point * 10 + assert trader.order.type == OrderType.BUY + + async def test_sets_price_from_tick(self, trader, mock_tick): + """Test sets price from tick.""" + await trader.create_order_with_points( + order_type=OrderType.BUY, points=500 + ) + + assert trader.order.price == mock_tick.ask + + async def test_sell_uses_bid(self, trader, mock_tick): + """Test SELL uses bid price.""" + await trader.create_order_with_points( + order_type=OrderType.SELL, points=500 + ) + + assert trader.order.price == mock_tick.bid + + async def test_computes_volume_with_points(self, trader): + """Test uses symbol.compute_volume_points.""" + await trader.create_order_with_points( + order_type=OrderType.BUY, points=500 + ) + + trader.symbol.compute_volume_points.assert_called_once() + + async def test_sets_stop_levels(self, trader): + """Test calls set_trade_stop_levels_points.""" + with patch.object(trader, 'set_trade_stop_levels_points') as mock_set_stops: + await trader.create_order_with_points( + order_type=OrderType.BUY, points=500 + ) + + mock_set_stops.assert_called_once_with(points=500, risk_to_reward=None) + + async def test_custom_risk_to_reward(self, trader): + """Test passes custom risk_to_reward to set_trade_stop_levels_points.""" + with patch.object(trader, 'set_trade_stop_levels_points') as mock_set_stops: + await trader.create_order_with_points( + order_type=OrderType.BUY, points=500, risk_to_reward=3.0 + ) + + mock_set_stops.assert_called_once_with(points=500, risk_to_reward=3.0) + + +class TestCreateOrderNoStops: + """Test create_order_no_stops method.""" + + async def test_sets_order_type(self, trader): + """Test sets order type.""" + await trader.create_order_no_stops(order_type=OrderType.BUY) + + assert trader.order.type == OrderType.BUY + + async def test_uses_min_volume_default(self, trader): + """Test uses symbol.volume_min when volume not specified.""" + trader.symbol.volume_min = 0.01 + + await trader.create_order_no_stops(order_type=OrderType.BUY) + + assert trader.order.volume == 0.01 + + async def test_custom_volume(self, trader): + """Test uses custom volume when provided.""" + await trader.create_order_no_stops(order_type=OrderType.BUY, volume=1.5) + + assert trader.order.volume == 1.5 + + async def test_buy_uses_ask_price(self, trader, mock_tick): + """Test BUY uses ask price.""" + await trader.create_order_no_stops(order_type=OrderType.BUY) + + assert trader.order.price == mock_tick.ask + + async def test_sell_uses_bid_price(self, trader, mock_tick): + """Test SELL uses bid price.""" + await trader.create_order_no_stops(order_type=OrderType.SELL) + + assert trader.order.price == mock_tick.bid + + # async def test_no_sl_set(self, trader): + # """Test no stop loss is set.""" + # # SL should remain at its default (0 or unset) + # original_sl = trader.order.sl + # await trader.create_order_no_stops(order_type=OrderType.BUY) + # assert trader.order.sl == original_sl + + # async def test_no_tp_set(self, trader): + # """Test no take profit is set.""" + # original_tp = trader.order.tp + # await trader.create_order_no_stops(order_type=OrderType.BUY) + # assert trader.order.tp == original_tp class TestCheckOrder: - """Test check_order async method.""" + """Test check_order method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + async def test_check_order_success(self, trader): + """Test check_order returns OrderCheckResult on success.""" + mock_result = MagicMock(spec=OrderCheckResult) + mock_result.retcode = 0 + trader.order.check = AsyncMock(return_value=mock_result) - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() + result = await trader.check_order() - async def test_check_order_returns_order_check_result(self): - """Test check_order returns OrderCheckResult.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.check_order() + assert result is mock_result - assert result is None or isinstance(result, OrderCheckResult) + async def test_check_order_none_result(self, trader): + """Test check_order handles None result.""" + trader.order.check = AsyncMock(return_value=None) + trader.order.mt5 = MagicMock() + trader.order.mt5.error = "Connection failed" - async def test_check_order_success(self): - """Test check_order succeeds for valid order.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.check_order() + result = await trader.check_order() - assert result is not None - assert result.retcode == 0 + assert result is None - async def test_check_order_has_margin_info(self): - """Test check result contains margin information.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.check_order() + async def test_check_order_nonzero_retcode(self, trader): + """Test check_order logs warning for non-zero retcode.""" + mock_result = MagicMock(spec=OrderCheckResult) + mock_result.retcode = 10015 + mock_result.comment = "Invalid price" + trader.order.check = AsyncMock(return_value=mock_result) - assert result is not None - assert hasattr(result, 'margin') + result = await trader.check_order() - async def test_check_order_sell(self): - """Test check_order works for sell orders.""" - await self.trader.create_order_no_stops(order_type=OrderType.SELL) - result = await self.trader.check_order() + assert result is mock_result + assert result.retcode != 0 - assert result is not None - assert result.retcode == 0 + async def test_check_order_calls_order_check(self, trader): + """Test check_order delegates to order.check.""" + mock_result = MagicMock(spec=OrderCheckResult) + mock_result.retcode = 0 + trader.order.check = AsyncMock(return_value=mock_result) + + await trader.check_order() + + trader.order.check.assert_called_once() class TestSendOrder: - """Test send_order async method.""" + """Test send_order method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + async def test_send_order_success(self, trader): + """Test send_order returns result on success (retcode 10009).""" + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10009 + trader.order.send = AsyncMock(return_value=mock_result) - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() + result = await trader.send_order() - async def test_send_order_returns_order_send_result(self): - """Test send_order returns OrderSendResult.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() - - assert result is None or isinstance(result, OrderSendResult) - - async def test_send_order_success(self): - """Test send_order succeeds for valid order.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() - - assert result is not None + assert result is mock_result assert result.retcode == 10009 - async def test_send_order_has_deal_ticket(self): - """Test send result contains deal ticket.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() + async def test_send_order_none_result(self, trader): + """Test send_order handles None result.""" + trader.order.send = AsyncMock(return_value=None) + trader.order.mt5 = MagicMock() + trader.order.mt5.error = "No connection" - assert result is not None - assert hasattr(result, 'deal') - assert result.deal > 0 + result = await trader.send_order() - async def test_send_order_has_order_ticket(self): - """Test send result contains order ticket.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() + assert result is None - assert result is not None - assert hasattr(result, 'order') - assert result.order > 0 + async def test_send_order_failure_retcode(self, trader): + """Test send_order returns result for non-10009 retcode.""" + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10006 + mock_result.comment = "Requote" + trader.order.send = AsyncMock(return_value=mock_result) + + result = await trader.send_order() + + assert result is mock_result + assert result.retcode == 10006 + + async def test_send_order_calls_order_send(self, trader): + """Test send_order delegates to order.send.""" + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10009 + trader.order.send = AsyncMock(return_value=mock_result) + + await trader.send_order() + + trader.order.send.assert_called_once() class TestRecordTrade: - """Test record_trade async method.""" + """Test record_trade method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + @pytest.fixture + def successful_result(self): + """Create a successful OrderSendResult.""" + result = MagicMock(spec=OrderSendResult) + result.retcode = 10009 + result.order = 12345 + result.request = MagicMock() + return result - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() + async def test_record_trade_skips_when_disabled(self, trader, successful_result): + """Test record_trade does nothing when record_trades is False.""" + trader.config.record_trades = False - async def test_record_trade_with_successful_order(self): - """Test recording a successful trade.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() + await trader.record_trade(result=successful_result) - # Should not raise an error - await self.trader.record_trade(result=result, parameters={"test": "value"}, name="TestStrategy", use_task_queue=False) + # Should return early — no further calls - async def test_record_trade_with_parameters(self): - """Test recording trade with custom parameters.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() + async def test_record_trade_skips_failed_orders(self, trader): + """Test record_trade skips when retcode is not 10009.""" + trader.config.record_trades = True + result = MagicMock(spec=OrderSendResult) + result.retcode = 10006 - params = {"strategy": "test", "risk": 1, "timeframe": "H1"} - await self.trader.record_trade(result=result, parameters=params, name="MyStrategy", use_task_queue=False) + await trader.record_trade(result=result) - async def test_record_trade_without_parameters(self): - """Test recording trade without parameters.""" - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = await self.trader.send_order() + # Should return early - # Should not raise an error - await self.trader.record_trade(result=result, name="SimpleStrategy", use_task_queue=False) + async def test_record_trade_uses_task_queue(self, trader, successful_result): + """Test record_trade adds to task queue by default.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_order) + trader.order.calc_profit = AsyncMock(return_value=50.0) + + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res + + await trader.record_trade(result=successful_result, parameters={"key": "value"}) + + trader.config.task_queue.add.assert_called_once() + + async def test_record_trade_direct_save(self, trader, successful_result): + """Test record_trade saves directly when use_task_queue=False.""" + trader.config.record_trades = True + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_order) + trader.order.calc_profit = AsyncMock(return_value=50.0) + + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res + + await trader.record_trade( + result=successful_result, + use_task_queue=False + ) + + mock_res.save.assert_called_once() + + async def test_record_trade_with_parameters(self, trader, successful_result): + """Test record_trade passes parameters to Result.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_order) + trader.order.calc_profit = AsyncMock(return_value=50.0) + + params = {"strategy": "scalping", "timeframe": "M5"} + + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res + + await trader.record_trade( + result=successful_result, parameters=params, name="TestStrategy" + ) + + call_kwargs = MockResult.call_args[1] + assert call_kwargs["parameters"] == params + assert call_kwargs["name"] == "TestStrategy" + + async def test_record_trade_with_expected_profit(self, trader, successful_result): + """Test record_trade uses provided expected_profit.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_order) + + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res + + await trader.record_trade( + result=successful_result, expected_profit=75.0 + ) + + call_kwargs = MockResult.call_args[1] + assert call_kwargs["expected_profit"] == 75.0 + + async def test_record_trade_non_dict_parameters(self, trader, successful_result): + """Test record_trade handles non-dict parameters.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_order) + trader.order.calc_profit = AsyncMock(return_value=10.0) + + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res + + await trader.record_trade( + result=successful_result, parameters="not_a_dict" + ) + + call_kwargs = MockResult.call_args[1] + assert call_kwargs["parameters"] == {} + + async def test_record_trade_updates_sl_tp_from_history(self, trader, successful_result): + """Test record_trade sets sl and tp on result.request from history order.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.08000 + mock_order.tp = 1.12000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_order) + trader.order.calc_profit = AsyncMock(return_value=10.0) + + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res + + await trader.record_trade(result=successful_result) + + assert successful_result.request.sl == 1.08000 + assert successful_result.request.tp == 1.12000 -class TestTraderWithDifferentSymbols: - """Test Trader with different symbols.""" +class TestPlaceTrade: + """Test abstract place_trade method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.btc_usd = ForexSymbol(name="BTCUSD") - cls.eur_jpy = ForexSymbol(name="EURJPY") - cls.ram = RAM(fixed_amount=10) + def test_cannot_instantiate_trader_directly(self, mock_symbol, mock_ram): + """Test Trader cannot be instantiated due to abstract method.""" + with pytest.raises(TypeError): + Trader(symbol=mock_symbol, ram=mock_ram) - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbols.""" - await self.btc_usd.initialize() - await self.eur_jpy.initialize() + def test_subclass_must_implement_place_trade(self): + """Test subclass without place_trade raises TypeError.""" + with pytest.raises(TypeError): + class IncompleteTrader(Trader): + pass - async def test_trader_btc_usd(self): - """Test trader with BTCUSD symbol.""" - trader = SimpleTrader(symbol=self.btc_usd, ram=self.ram) - await trader.create_order_no_stops(order_type=OrderType.BUY) - result = await trader.send_order() + IncompleteTrader(symbol=MagicMock()) - assert result is not None - assert result.retcode == 10009 - - async def test_trader_eur_jpy(self): - """Test trader with EURJPY symbol.""" - trader = SimpleTrader(symbol=self.eur_jpy, ram=self.ram) - await trader.create_order_no_stops(order_type=OrderType.SELL) - result = await trader.send_order() - - assert result is not None - assert result.retcode == 10009 + async def test_concrete_place_trade_callable(self, trader): + """Test ConcreteTrader.place_trade is callable.""" + # Should not raise + await trader.place_trade() -class TestTraderIntegration: +class TestIntegration: """Integration tests for Trader.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() + async def test_create_and_check_order(self, trader, mock_tick): + """Test creating order then checking it.""" + order_type = MagicMock() + order_type.is_long = True - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol and account.""" - await self.symbol.initialize() - await self.account.refresh() + trader.order.set_attributes = MagicMock() - async def test_full_trade_flow_buy(self): - """Test complete trade flow for buy order.""" - # Create order - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - await self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) - # Check order - check_result = await self.trader.check_order() - assert check_result is not None - assert check_result.retcode == 0 + # Now check the order + mock_check_result = MagicMock(spec=OrderCheckResult) + mock_check_result.retcode = 0 + trader.order.check = AsyncMock(return_value=mock_check_result) - # Send order - send_result = await self.trader.send_order() - assert send_result is not None - assert send_result.retcode == 10009 + check = await trader.check_order() + assert check.retcode == 0 - # Record trade - await self.trader.record_trade(result=send_result, parameters={"test": True}, name="IntegrationTest", use_task_queue=False) + async def test_create_and_send_order(self, trader, mock_tick): + """Test creating order then sending it.""" + order_type = MagicMock() + order_type.is_long = True - async def test_full_trade_flow_sell(self): - """Test complete trade flow for sell order.""" - # Create order - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await self.symbol.info_tick() - sl = tick.bid + dsl + trader.order.set_attributes = MagicMock() - await self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) - # Check order - check_result = await self.trader.check_order() - assert check_result is not None - assert check_result.retcode == 0 + mock_send_result = MagicMock(spec=OrderSendResult) + mock_send_result.retcode = 10009 + trader.order.send = AsyncMock(return_value=mock_send_result) - # Send order - send_result = await self.trader.send_order() - assert send_result is not None - assert send_result.retcode == 10009 + result = await trader.send_order() + assert result.retcode == 10009 - async def test_multiple_orders_same_trader(self): - """Test creating multiple orders with same trader.""" - # First order - await self.trader.create_order_no_stops(order_type=OrderType.BUY) - result1 = await self.trader.send_order() - assert result1 is not None - assert result1.retcode == 10009 + async def test_full_trade_lifecycle(self, trader, mock_tick): + """Test full lifecycle: create, check, send, record.""" + order_type = MagicMock() + order_type.is_long = True - # Second order (different type) - await self.trader.create_order_no_stops(order_type=OrderType.SELL) - result2 = await self.trader.send_order() - assert result2 is not None - assert result2.retcode == 10009 + trader.order.set_attributes = MagicMock() + # Create + await trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) -class TestTraderEdgeCases: - """Test edge cases and boundary conditions.""" + # Check + mock_check = MagicMock(spec=OrderCheckResult) + mock_check.retcode = 0 + trader.order.check = AsyncMock(return_value=mock_check) + check = await trader.check_order() + assert check.retcode == 0 - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") + # Send + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10009 + mock_result.order = 99999 + mock_result.request = MagicMock() + trader.order.send = AsyncMock(return_value=mock_result) + result = await trader.send_order() + assert result.retcode == 10009 - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() + # Record + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() - def test_trader_with_zero_fixed_amount(self): - """Test trader with zero fixed amount RAM.""" - ram = RAM(fixed_amount=0) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - assert trader.ram.fixed_amount == 0 + mock_history_order = MagicMock() + mock_history_order.sl = 1.09500 + mock_history_order.tp = 1.11000 + mock_history_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = AsyncMock(return_value=mock_history_order) + trader.order.calc_profit = AsyncMock(return_value=50.0) - def test_trader_with_high_risk_to_reward(self): - """Test trader with high risk to reward ratio.""" - ram = RAM(fixed_amount=10, risk_to_reward=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - assert trader.ram.risk_to_reward == 10 + with patch('aiomql.lib.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save = AsyncMock() + MockResult.return_value = mock_res - def test_trader_with_low_risk_to_reward(self): - """Test trader with low risk to reward ratio.""" - ram = RAM(fixed_amount=10, risk_to_reward=0.5) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - assert trader.ram.risk_to_reward == 0.5 + await trader.record_trade(result=result, name="TestStrategy") - async def test_trader_order_modification_after_creation(self): - """Test modifying order attributes after creation.""" - ram = RAM(fixed_amount=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - await trader.create_order_no_stops(order_type=OrderType.BUY) - - original_volume = trader.order.volume - trader.order.volume = original_volume * 2 - assert trader.order.volume == original_volume * 2 - - def test_trader_parameters_modification(self): - """Test modifying trader parameters.""" - ram = RAM(fixed_amount=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - trader.parameters["custom_param"] = "value" - trader.parameters["risk"] = 5 - - assert trader.parameters["custom_param"] == "value" - assert trader.parameters["risk"] == 5 - - async def test_trader_with_minimum_volume(self): - """Test creating order with minimum volume.""" - ram = RAM(fixed_amount=1) # Very small amount - trader = SimpleTrader(symbol=self.symbol, ram=ram) - await trader.create_order_no_stops(order_type=OrderType.BUY) - - assert trader.order.volume >= self.symbol.volume_min - - -class TestTraderRAMIntegration: - """Test Trader integration with RAM.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - - @pytest.fixture(scope="class", autouse=True) - async def initialize(self): - """Initialize symbol.""" - await self.symbol.initialize() - - async def test_trader_uses_ram_get_amount(self): - """Test trader uses RAM get_amount for volume calculation.""" - ram = RAM(fixed_amount=20) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await trader.symbol.info_tick() - sl = tick.ask - dsl - - await trader.create_order_with_sl(order_type=OrderType.BUY, sl=sl) - - # Volume should be calculated based on RAM fixed_amount (20) - assert trader.order.volume > 0 - - async def test_trader_uses_ram_risk_to_reward(self): - """Test trader uses RAM risk_to_reward for TP calculation.""" - ram = RAM(fixed_amount=10, risk_to_reward=3) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = await trader.symbol.info_tick() - sl = tick.ask - dsl - - await trader.create_order_with_sl(order_type=OrderType.BUY, sl=sl) - - # TP distance should be 3x the SL distance - sl_distance = abs(trader.order.price - trader.order.sl) - tp_distance = abs(trader.order.tp - trader.order.price) - - assert abs(tp_distance - (sl_distance * 3)) < self.symbol.point * 10 - - def test_trader_modifying_ram_after_init(self): - """Test modifying RAM after trader initialization.""" - ram = RAM(fixed_amount=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - trader.ram.modify_ram(fixed_amount=25, risk_to_reward=4) - - assert trader.ram.fixed_amount == 25 - assert trader.ram.risk_to_reward == 4 + trader.config.task_queue.add.assert_called_once() diff --git a/tests/live/unit/contrib/test_position_tracking_functions.py b/tests/live/unit/contrib/test_position_tracking_functions.py index b757d7d..ba1d850 100644 --- a/tests/live/unit/contrib/test_position_tracking_functions.py +++ b/tests/live/unit/contrib/test_position_tracking_functions.py @@ -1,8 +1,8 @@ """Comprehensive tests for the position_tracking_functions module. Tests cover: -- exit_at_profit function (tp/sl conditions, position closing) -- extend_take_profit function (TP extension, percentage checks) +- exit_at_profit function (tp/sl conditions, position closing, logging) +- extend_take_profit function (TP extension, percentage checks, params) """ import pytest @@ -14,11 +14,12 @@ from aiomql.contrib.trackers.position_tracking_functions import exit_at_profit, class TestExitAtProfit: """Tests for exit_at_profit function.""" + @pytest.mark.asyncio async def test_exit_at_profit_closes_at_tp(self): """Test position closes when profit reaches take profit.""" mock_position = MagicMock() mock_position.profit = 100.0 - + mock_pos = MagicMock() mock_pos.symbol = MagicMock() mock_pos.symbol.name = "EURUSD" @@ -26,16 +27,17 @@ class TestExitAtProfit: mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) - + await exit_at_profit(mock_pos, tp=50.0) - + mock_pos.close_position.assert_called_once() + @pytest.mark.asyncio async def test_exit_at_profit_closes_at_sl(self): """Test position closes when profit falls to stop loss.""" mock_position = MagicMock() mock_position.profit = -50.0 - + mock_pos = MagicMock() mock_pos.symbol = MagicMock() mock_pos.symbol.name = "EURUSD" @@ -43,43 +45,46 @@ class TestExitAtProfit: mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) - + await exit_at_profit(mock_pos, sl=-30.0) - + mock_pos.close_position.assert_called_once() + @pytest.mark.asyncio async def test_exit_at_profit_does_not_close_when_between_tp_sl(self): """Test position stays open when profit is between TP and SL.""" mock_position = MagicMock() mock_position.profit = 25.0 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock() - + await exit_at_profit(mock_pos, tp=50.0, sl=-30.0) - + mock_pos.close_position.assert_not_called() + @pytest.mark.asyncio async def test_exit_at_profit_does_nothing_when_closed(self): """Test no action when position is already closed.""" mock_pos = MagicMock() mock_pos.update_position = AsyncMock(return_value=False) mock_pos.close_position = AsyncMock() - + await exit_at_profit(mock_pos, tp=50.0) - + mock_pos.close_position.assert_not_called() + @pytest.mark.asyncio async def test_exit_at_profit_logs_warning_on_close_failure(self): """Test warning is logged when close fails.""" mock_position = MagicMock() mock_position.profit = 100.0 - + mock_result = MagicMock() mock_result.comment = "Market closed" - + mock_pos = MagicMock() mock_pos.symbol = MagicMock() mock_pos.symbol.name = "EURUSD" @@ -87,95 +92,218 @@ class TestExitAtProfit: mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock(return_value=(False, mock_result)) - + with patch("aiomql.contrib.trackers.position_tracking_functions.logger") as mock_logger: await exit_at_profit(mock_pos, tp=50.0) mock_logger.warning.assert_called_once() + @pytest.mark.asyncio + async def test_exit_at_profit_logs_warning_with_none_result(self): + """Test warning logged with empty comment when result is None.""" + mock_position = MagicMock() + mock_position.profit = 100.0 + + mock_pos = MagicMock() + mock_pos.symbol = MagicMock() + mock_pos.symbol.name = "EURUSD" + mock_pos.ticket = 12345 + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.close_position = AsyncMock(return_value=(False, None)) + + with patch("aiomql.contrib.trackers.position_tracking_functions.logger") as mock_logger: + await exit_at_profit(mock_pos, tp=50.0) + mock_logger.warning.assert_called_once() + # Verify empty comment is used when res is None + call_args = mock_logger.warning.call_args + assert call_args[0][-1] == "" + + @pytest.mark.asyncio + async def test_exit_at_profit_logs_info_on_success(self): + """Test info is logged on successful close.""" + mock_position = MagicMock() + mock_position.profit = 100.0 + + mock_pos = MagicMock() + mock_pos.symbol = MagicMock() + mock_pos.symbol.name = "EURUSD" + mock_pos.ticket = 12345 + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) + + with patch("aiomql.contrib.trackers.position_tracking_functions.logger") as mock_logger: + await exit_at_profit(mock_pos, tp=50.0) + mock_logger.info.assert_called_once() + + @pytest.mark.asyncio async def test_exit_at_profit_exact_tp_value(self): """Test position closes when profit equals exactly TP.""" mock_position = MagicMock() mock_position.profit = 50.0 # Exactly at TP - + mock_pos = MagicMock() + mock_pos.symbol = MagicMock() + mock_pos.symbol.name = "EURUSD" + mock_pos.ticket = 12345 mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) - + await exit_at_profit(mock_pos, tp=50.0) - + mock_pos.close_position.assert_called_once() + @pytest.mark.asyncio async def test_exit_at_profit_exact_sl_value(self): """Test position closes when profit equals exactly SL.""" mock_position = MagicMock() mock_position.profit = -30.0 # Exactly at SL - + mock_pos = MagicMock() + mock_pos.symbol = MagicMock() + mock_pos.symbol.name = "EURUSD" + mock_pos.ticket = 12345 mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) - + await exit_at_profit(mock_pos, sl=-30.0) - + mock_pos.close_position.assert_called_once() - async def test_exit_at_profit_only_tp_provided(self): - """Test works with only tp provided.""" + @pytest.mark.asyncio + async def test_exit_at_profit_only_tp_provided_no_close(self): + """Test works with only tp provided and profit below it.""" mock_position = MagicMock() mock_position.profit = 25.0 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock() - + await exit_at_profit(mock_pos, tp=50.0) - + mock_pos.close_position.assert_not_called() - async def test_exit_at_profit_only_sl_provided(self): - """Test works with only sl provided.""" + @pytest.mark.asyncio + async def test_exit_at_profit_only_sl_provided_no_close(self): + """Test works with only sl provided and profit above it.""" mock_position = MagicMock() mock_position.profit = 25.0 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.close_position = AsyncMock() - + await exit_at_profit(mock_pos, sl=-30.0) - + mock_pos.close_position.assert_not_called() + @pytest.mark.asyncio + async def test_exit_at_profit_no_tp_no_sl(self): + """Test no action when neither tp nor sl is provided.""" + mock_position = MagicMock() + mock_position.profit = 100.0 + + mock_pos = MagicMock() + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.close_position = AsyncMock() + + await exit_at_profit(mock_pos) + + mock_pos.close_position.assert_not_called() + + @pytest.mark.asyncio + async def test_exit_at_profit_tp_triggers_sl_does_not(self): + """Test only tp condition triggers when both provided.""" + mock_position = MagicMock() + mock_position.profit = 60.0 + + mock_pos = MagicMock() + mock_pos.symbol = MagicMock() + mock_pos.symbol.name = "EURUSD" + mock_pos.ticket = 12345 + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) + + await exit_at_profit(mock_pos, tp=50.0, sl=-30.0) + + mock_pos.close_position.assert_called_once() + + @pytest.mark.asyncio + async def test_exit_at_profit_sl_triggers_tp_does_not(self): + """Test only sl condition triggers when both provided.""" + mock_position = MagicMock() + mock_position.profit = -40.0 + + mock_pos = MagicMock() + mock_pos.symbol = MagicMock() + mock_pos.symbol.name = "EURUSD" + mock_pos.ticket = 12345 + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.close_position = AsyncMock(return_value=(True, MagicMock())) + + await exit_at_profit(mock_pos, tp=50.0, sl=-30.0) + + mock_pos.close_position.assert_called_once() + class TestExtendTakeProfit: """Tests for extend_take_profit function.""" + @pytest.mark.asyncio async def test_extend_take_profit_does_nothing_when_closed(self): """Test no action when position is closed.""" mock_pos = MagicMock() mock_pos.update_position = AsyncMock(return_value=False) mock_pos.modify_stops = AsyncMock() - + await extend_take_profit(mock_pos) - + mock_pos.modify_stops.assert_not_called() + @pytest.mark.asyncio async def test_extend_take_profit_does_nothing_when_loss(self): """Test no action when position is in loss.""" mock_position = MagicMock() mock_position.profit = -10.0 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock() - + await extend_take_profit(mock_pos) - + mock_pos.modify_stops.assert_not_called() + @pytest.mark.asyncio + async def test_extend_take_profit_does_nothing_at_zero_profit(self): + """Test no action when position profit is exactly zero (profit < 0 is False but not > 0).""" + mock_position = MagicMock() + mock_position.profit = 0.0 + mock_position.price_open = 1.1000 + mock_position.tp = 1.1100 + mock_position.price_current = 1.1000 + + mock_pos = MagicMock() + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.modify_stops = AsyncMock() + + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", + return_value=0): + await extend_take_profit(mock_pos) + + mock_pos.modify_stops.assert_not_called() + + @pytest.mark.asyncio async def test_extend_take_profit_extends_when_threshold_reached(self): """Test TP is extended when percentage threshold reached.""" mock_position = MagicMock() @@ -185,20 +313,45 @@ class TestExtendTakeProfit: mock_position.price_current = 1.1085 # 85% of distance to TP mock_position.symbol = "EURUSD" mock_position.ticket = 12345 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock(return_value=(True, MagicMock())) - + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", return_value=85): # Above 80% threshold - with patch("aiomql.contrib.trackers.position_tracking_functions.extend_interval_by_percentage", + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", return_value=1.1120): await extend_take_profit(mock_pos, increase=20, start=80) - + mock_pos.modify_stops.assert_called_once_with(tp=1.1120, use_stop_levels=True) + @pytest.mark.asyncio + async def test_extend_take_profit_extends_at_exact_threshold(self): + """Test TP is extended when exactly at the threshold (>= check).""" + mock_position = MagicMock() + mock_position.profit = 40.0 + mock_position.price_open = 1.1000 + mock_position.tp = 1.1100 + mock_position.price_current = 1.1080 # Exactly 80% + mock_position.symbol = "EURUSD" + mock_position.ticket = 12345 + + mock_pos = MagicMock() + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.modify_stops = AsyncMock(return_value=(True, MagicMock())) + + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", + return_value=80): # Exactly at threshold + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", + return_value=1.1120): + await extend_take_profit(mock_pos, increase=20, start=80) + + mock_pos.modify_stops.assert_called_once() + + @pytest.mark.asyncio async def test_extend_take_profit_does_not_extend_below_threshold(self): """Test TP is not extended when below percentage threshold.""" mock_position = MagicMock() @@ -206,18 +359,19 @@ class TestExtendTakeProfit: mock_position.price_open = 1.1000 mock_position.tp = 1.1100 mock_position.price_current = 1.1050 # 50% of distance to TP - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock() - + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", return_value=50): # Below 80% threshold await extend_take_profit(mock_pos, increase=20, start=80) - + mock_pos.modify_stops.assert_not_called() + @pytest.mark.asyncio async def test_extend_take_profit_logs_success(self): """Test info is logged on successful extension.""" mock_position = MagicMock() @@ -227,20 +381,21 @@ class TestExtendTakeProfit: mock_position.price_current = 1.1085 mock_position.symbol = "EURUSD" mock_position.ticket = 12345 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock(return_value=(True, MagicMock())) - + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", return_value=85): - with patch("aiomql.contrib.trackers.position_tracking_functions.extend_interval_by_percentage", + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", return_value=1.1120): with patch("aiomql.contrib.trackers.position_tracking_functions.logger") as mock_logger: await extend_take_profit(mock_pos) mock_logger.info.assert_called_once() + @pytest.mark.asyncio async def test_extend_take_profit_logs_warning_on_failure(self): """Test warning is logged when modification fails.""" mock_position = MagicMock() @@ -250,23 +405,24 @@ class TestExtendTakeProfit: mock_position.price_current = 1.1085 mock_position.symbol = "EURUSD" mock_position.ticket = 12345 - + mock_result = MagicMock() mock_result.comment = "Invalid stops" - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock(return_value=(False, mock_result)) - + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", return_value=85): - with patch("aiomql.contrib.trackers.position_tracking_functions.extend_interval_by_percentage", + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", return_value=1.1120): with patch("aiomql.contrib.trackers.position_tracking_functions.logger") as mock_logger: await extend_take_profit(mock_pos) mock_logger.warning.assert_called_once() + @pytest.mark.asyncio async def test_extend_take_profit_uses_custom_params(self): """Test extend_take_profit uses custom increase and start values.""" mock_position = MagicMock() @@ -276,20 +432,21 @@ class TestExtendTakeProfit: mock_position.price_current = 1.1070 # 70% of distance mock_position.symbol = "EURUSD" mock_position.ticket = 12345 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock(return_value=(True, MagicMock())) - + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", return_value=70): # Matches start=70 threshold - with patch("aiomql.contrib.trackers.position_tracking_functions.extend_interval_by_percentage", + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", return_value=1.1150): await extend_take_profit(mock_pos, increase=50, start=70) - + mock_pos.modify_stops.assert_called_once_with(tp=1.1150, use_stop_levels=True) + @pytest.mark.asyncio async def test_extend_take_profit_respects_use_stop_levels(self): """Test extend_take_profit passes use_stop_levels correctly.""" mock_position = MagicMock() @@ -299,16 +456,60 @@ class TestExtendTakeProfit: mock_position.price_current = 1.1085 mock_position.symbol = "EURUSD" mock_position.ticket = 12345 - + mock_pos = MagicMock() mock_pos.position = mock_position mock_pos.update_position = AsyncMock(return_value=True) mock_pos.modify_stops = AsyncMock(return_value=(True, MagicMock())) - + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", return_value=85): - with patch("aiomql.contrib.trackers.position_tracking_functions.extend_interval_by_percentage", + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", return_value=1.1120): await extend_take_profit(mock_pos, use_stop_levels=False) - + mock_pos.modify_stops.assert_called_once_with(tp=1.1120, use_stop_levels=False) + + @pytest.mark.asyncio + async def test_extend_take_profit_calls_extend_range_by_pct_correctly(self): + """Test extend_range_by_pct is called with correct arguments.""" + mock_position = MagicMock() + mock_position.profit = 50.0 + mock_position.price_open = 1.1000 + mock_position.tp = 1.1100 + mock_position.price_current = 1.1085 + mock_position.symbol = "EURUSD" + mock_position.ticket = 12345 + + mock_pos = MagicMock() + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.modify_stops = AsyncMock(return_value=(True, MagicMock())) + + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", + return_value=85): + with patch("aiomql.contrib.trackers.position_tracking_functions.extend_range_by_pct", + return_value=1.1120) as mock_extend: + await extend_take_profit(mock_pos, increase=25, start=80) + + mock_extend.assert_called_once_with(1.1000, 1.1100, 25) + + @pytest.mark.asyncio + async def test_extend_take_profit_calls_get_price_in_range_pct_correctly(self): + """Test get_price_in_range_pct is called with correct arguments.""" + mock_position = MagicMock() + mock_position.profit = 50.0 + mock_position.price_open = 1.1000 + mock_position.tp = 1.1100 + mock_position.price_current = 1.1085 + + mock_pos = MagicMock() + mock_pos.position = mock_position + mock_pos.update_position = AsyncMock(return_value=True) + mock_pos.modify_stops = AsyncMock() + + with patch("aiomql.contrib.trackers.position_tracking_functions.get_price_in_range_pct", + return_value=50) as mock_range_pct: + await extend_take_profit(mock_pos) + + mock_range_pct.assert_called_once_with(1.1000, 1.1100, 1.1085) diff --git a/tests/live/unit/core/test_state.py b/tests/live/unit/core/test_state.py index c68d90d..d2f2592 100644 --- a/tests/live/unit/core/test_state.py +++ b/tests/live/unit/core/test_state.py @@ -76,9 +76,9 @@ class TestStateInitialization: assert "existing" not in state2 def test_init_default_autocommit(self, temp_db): - """Test State has autocommit False by default.""" + """Test State has autocommit True by default.""" state = State(db_name=temp_db) - assert state.autocommit is False + assert state.autocommit is True def test_init_autocommit_true(self, temp_db): """Test State can be initialized with autocommit=True.""" diff --git a/tests/live/unit/core/test_utils.py b/tests/live/unit/core/test_utils.py index dc4acaf..0d543ea 100644 --- a/tests/live/unit/core/test_utils.py +++ b/tests/live/unit/core/test_utils.py @@ -1,128 +1,106 @@ -"""Comprehensive tests for the utils module. +"""Comprehensive tests for the core utils module. Tests cover: -- sleep async function (live mode) -- sleep_sync function (live mode) +- sleep async function +- sleep_sync function - auto_commit function - -Note: Backtesting-related functions are excluded from these tests. """ -import asyncio import time import pytest from unittest.mock import patch, MagicMock, AsyncMock + from aiomql.core.utils import sleep, sleep_sync, auto_commit class TestSleepAsync: - """Tests for async sleep function in live mode.""" + """Tests for async sleep function.""" - @pytest.fixture(autouse=True) - def set_live_mode(self): - """Ensure Config.mode is set to live (not backtest).""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - yield mock_config - - async def test_sleep_calls_asyncio_sleep_in_live_mode(self): - """Test sleep uses asyncio.sleep in live mode.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: - await sleep(1.5) - mock_sleep.assert_called_once_with(1.5) + @pytest.mark.asyncio + async def test_sleep_calls_asyncio_sleep(self): + """Test sleep delegates to asyncio.sleep.""" + with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: + await sleep(1.5) + mock_sleep.assert_called_once_with(1.5) + @pytest.mark.asyncio async def test_sleep_with_zero_seconds(self): """Test sleep with zero seconds.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: - await sleep(0) - mock_sleep.assert_called_once_with(0) + with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: + await sleep(0) + mock_sleep.assert_called_once_with(0) + @pytest.mark.asyncio async def test_sleep_with_integer_seconds(self): """Test sleep with integer seconds.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: - await sleep(5) - mock_sleep.assert_called_once_with(5) + with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: + await sleep(5) + mock_sleep.assert_called_once_with(5) + @pytest.mark.asyncio async def test_sleep_with_float_seconds(self): """Test sleep with float seconds.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: - await sleep(0.5) - mock_sleep.assert_called_once_with(0.5) + with patch("aiomql.core.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: + await sleep(0.5) + mock_sleep.assert_called_once_with(0.5) + @pytest.mark.asyncio async def test_sleep_actually_delays_execution(self): - """Test sleep actually delays execution in live mode.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - start_time = time.time() - await sleep(0.1) - elapsed = time.time() - start_time - assert elapsed >= 0.1 + """Test sleep actually delays execution.""" + start_time = time.time() + await sleep(0.1) + elapsed = time.time() - start_time + assert elapsed >= 0.1 class TestSleepSync: - """Tests for sync sleep function in live mode.""" + """Tests for sync sleep function.""" - def test_sleep_sync_calls_time_sleep_in_live_mode(self): - """Test sleep_sync uses time.sleep in live mode.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.time.sleep") as mock_sleep: - sleep_sync(1.5) - mock_sleep.assert_called_once_with(1.5) + def test_sleep_sync_calls_time_sleep(self): + """Test sleep_sync delegates to time.sleep.""" + with patch("aiomql.core.utils.time.sleep") as mock_sleep: + sleep_sync(1.5) + mock_sleep.assert_called_once_with(1.5) def test_sleep_sync_with_zero_seconds(self): """Test sleep_sync with zero seconds.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.time.sleep") as mock_sleep: - sleep_sync(0) - mock_sleep.assert_called_once_with(0) + with patch("aiomql.core.utils.time.sleep") as mock_sleep: + sleep_sync(0) + mock_sleep.assert_called_once_with(0) def test_sleep_sync_with_integer_seconds(self): """Test sleep_sync with integer seconds.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.time.sleep") as mock_sleep: - sleep_sync(5) - mock_sleep.assert_called_once_with(5) + with patch("aiomql.core.utils.time.sleep") as mock_sleep: + sleep_sync(5) + mock_sleep.assert_called_once_with(5) def test_sleep_sync_with_float_seconds(self): """Test sleep_sync with float seconds.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - with patch("aiomql.core.utils.time.sleep") as mock_sleep: - sleep_sync(0.5) - mock_sleep.assert_called_once_with(0.5) + with patch("aiomql.core.utils.time.sleep") as mock_sleep: + sleep_sync(0.5) + mock_sleep.assert_called_once_with(0.5) def test_sleep_sync_actually_delays_execution(self): - """Test sleep_sync actually delays execution in live mode.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "live" - start_time = time.time() - sleep_sync(0.1) - elapsed = time.time() - start_time - assert elapsed >= 0.1 + """Test sleep_sync actually delays execution.""" + start_time = time.time() + sleep_sync(0.1) + elapsed = time.time() - start_time + assert elapsed >= 0.1 class TestAutoCommit: """Tests for auto_commit function.""" + @pytest.mark.asyncio async def test_auto_commit_stops_on_shutdown(self): - """Test auto_commit stops when shutdown is True.""" + """Test auto_commit stops when shutdown is True immediately.""" mock_config = MagicMock() mock_config.shutdown = True # Start with shutdown True mock_config.db_commit_interval = 0.1 + mock_conn = MagicMock() mock_state = MagicMock() - mock_state.conn.__enter__ = MagicMock(return_value=MagicMock()) + mock_state.conn.__enter__ = MagicMock(return_value=mock_conn) mock_state.conn.__exit__ = MagicMock(return_value=False) mock_state.acommit = AsyncMock() mock_config.state = mock_state @@ -130,19 +108,19 @@ class TestAutoCommit: with patch("aiomql.core.utils.Config", return_value=mock_config): with patch("aiomql.core.utils.sleep", new_callable=AsyncMock): await auto_commit() - + # Should not have called acommit since shutdown was True immediately mock_state.acommit.assert_not_called() + @pytest.mark.asyncio async def test_auto_commit_uses_config_interval(self): """Test auto_commit uses db_commit_interval from config.""" call_count = 0 - + async def mock_sleep(secs): nonlocal call_count call_count += 1 if call_count >= 2: - # Stop the loop after a couple iterations mock_config.shutdown = True mock_config = MagicMock() @@ -158,14 +136,15 @@ class TestAutoCommit: with patch("aiomql.core.utils.Config", return_value=mock_config): with patch("aiomql.core.utils.sleep", side_effect=mock_sleep) as patched_sleep: await auto_commit() - + # Verify sleep was called with the config interval patched_sleep.assert_called_with(5.0) + @pytest.mark.asyncio async def test_auto_commit_calls_acommit(self): - """Test auto_commit calls state.acommit.""" + """Test auto_commit calls state.acommit with correct args.""" call_count = 0 - + async def mock_sleep(secs): nonlocal call_count call_count += 1 @@ -185,10 +164,39 @@ class TestAutoCommit: with patch("aiomql.core.utils.Config", return_value=mock_config): with patch("aiomql.core.utils.sleep", side_effect=mock_sleep): await auto_commit() - + # Verify acommit was called with connection and close=False mock_state.acommit.assert_called_with(conn=mock_conn, close=False) + @pytest.mark.asyncio + async def test_auto_commit_loops_multiple_times(self): + """Test auto_commit performs multiple commit cycles before shutdown.""" + call_count = 0 + + async def mock_sleep(secs): + nonlocal call_count + call_count += 1 + if call_count >= 3: + mock_config.shutdown = True + + mock_config = MagicMock() + mock_config.shutdown = False + mock_config.db_commit_interval = 0.1 + mock_conn = MagicMock() + mock_state = MagicMock() + mock_state.conn.__enter__ = MagicMock(return_value=mock_conn) + mock_state.conn.__exit__ = MagicMock(return_value=False) + mock_state.acommit = AsyncMock() + mock_config.state = mock_state + + with patch("aiomql.core.utils.Config", return_value=mock_config): + with patch("aiomql.core.utils.sleep", side_effect=mock_sleep): + await auto_commit() + + # acommit should be called 3 times (once per loop iteration) + assert mock_state.acommit.call_count == 3 + + @pytest.mark.asyncio async def test_auto_commit_handles_exception(self): """Test auto_commit handles exceptions gracefully.""" mock_config = MagicMock() @@ -204,22 +212,21 @@ class TestAutoCommit: await auto_commit() mock_logger.error.assert_called_once() + @pytest.mark.asyncio + async def test_auto_commit_handles_acommit_exception(self): + """Test auto_commit handles exception during acommit.""" + mock_config = MagicMock() + mock_config.shutdown = False + mock_config.db_commit_interval = 0.1 + mock_conn = MagicMock() + mock_state = MagicMock() + mock_state.conn.__enter__ = MagicMock(return_value=mock_conn) + mock_state.conn.__exit__ = MagicMock(return_value=False) + mock_state.acommit = AsyncMock(side_effect=Exception("Commit failed")) + mock_config.state = mock_state -class TestModeDispatch: - """Tests for mode-based dispatch in sleep functions.""" - - async def test_sleep_dispatches_to_backtest_in_backtest_mode(self): - """Test sleep calls backtest_sleep in backtest mode.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "backtest" - with patch("aiomql.core.utils.backtest_sleep", new_callable=AsyncMock) as mock_bt_sleep: - await sleep(1.0) - mock_bt_sleep.assert_called_once_with(1.0) - - def test_sleep_sync_dispatches_to_backtest_in_backtest_mode(self): - """Test sleep_sync calls backtest_sleep_sync in backtest mode.""" - with patch("aiomql.core.utils.Config") as mock_config: - mock_config.mode = "backtest" - with patch("aiomql.core.utils.backtest_sleep_sync") as mock_bt_sleep: - sleep_sync(1.0) - mock_bt_sleep.assert_called_once_with(1.0) + with patch("aiomql.core.utils.Config", return_value=mock_config): + with patch("aiomql.core.utils.sleep", new_callable=AsyncMock): + with patch("aiomql.core.utils.logger") as mock_logger: + await auto_commit() + mock_logger.error.assert_called_once() diff --git a/tests/live/unit/sync/test_sessions.py b/tests/live/unit/sync/test_sessions.py index 1799708..1a5ca49 100644 --- a/tests/live/unit/sync/test_sessions.py +++ b/tests/live/unit/sync/test_sessions.py @@ -23,7 +23,7 @@ from datetime import time, datetime, timedelta, UTC from unittest.mock import MagicMock, patch import pytest -from aiomql.lib.sync.sessions import Session, Sessions, Duration, delta, backtest_sleep +from aiomql.lib.sync.sessions import Session, Sessions, Duration, delta from aiomql.core.config import Config from aiomql.core.models import TradePosition, OrderSendResult diff --git a/tests/live/unit/sync/test_trader.py b/tests/live/unit/sync/test_trader.py index cf690aa..b061f8a 100644 --- a/tests/live/unit/sync/test_trader.py +++ b/tests/live/unit/sync/test_trader.py @@ -1,815 +1,886 @@ """Comprehensive tests for the synchronous Trader module. Tests cover: -- Trader initialization with default and custom values -- set_trade_stop_levels_pips method -- set_trade_stop_levels_points method -- create_order_with_stops method -- create_order_with_sl method -- create_order_with_points method -- create_order_no_stops method -- check_order method -- send_order method -- record_trade method -- Integration tests with various order types -- Edge cases and boundary conditions +- Trader initialization (__init__) +- set_trade_stop_levels_pips (long/short orders) +- set_trade_stop_levels_points (long/short orders) +- create_order_with_stops +- create_order_with_sl +- create_order_with_points +- create_order_no_stops +- check_order +- send_order +- record_trade +- place_trade (abstract method enforcement) """ -from math import floor +from unittest.mock import MagicMock, patch import pytest -from aiomql.lib.ram import RAM from aiomql.lib.sync.trader import Trader -from aiomql.contrib.traders.sync import SimpleTrader -from aiomql.contrib.symbols.sync import ForexSymbol -from aiomql.lib.sync.symbol import Symbol -from aiomql.core.constants import OrderType -from aiomql.lib.sync.account import Account from aiomql.lib.sync.order import Order +from aiomql.lib.ram import RAM +from aiomql.lib.sync.symbol import Symbol +from aiomql.core.models import OrderType, OrderSendResult, OrderCheckResult from aiomql.core.config import Config -from aiomql.core.models import OrderSendResult, OrderCheckResult +from aiomql.core.task_queue import QueueItem -class TestTraderInitialization: - """Test Trader class initialization.""" +# --- Concrete subclass for testing abstract Trader --- - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) +class ConcreteTrader(Trader): + """Non-abstract subclass of Trader for testing purposes.""" - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol before tests.""" - self.symbol.initialize() + def place_trade(self, *args, **kwargs): + pass - def test_init_with_symbol_only(self): - """Test Trader can be initialized with just a symbol.""" - trader = SimpleTrader(symbol=self.symbol) - assert trader.symbol == self.symbol - assert isinstance(trader.ram, RAM) - assert isinstance(trader.order, Order) - def test_init_with_symbol_and_ram(self): - """Test Trader initialized with symbol and custom RAM.""" - trader = SimpleTrader(symbol=self.symbol, ram=self.ram) - assert trader.symbol == self.symbol - assert trader.ram == self.ram +# --- Fixtures --- - def test_init_creates_order_with_symbol_name(self): - """Test Trader creates order with correct symbol name.""" - trader = SimpleTrader(symbol=self.symbol) - assert trader.order.symbol == self.symbol.name +@pytest.fixture +def mock_symbol(): + """Create a mock Symbol with standard forex attributes.""" + symbol = MagicMock(spec=Symbol) + symbol.name = "EURUSD" + symbol.pip = 0.0001 + symbol.point = 0.00001 + symbol.digits = 5 + symbol.volume_min = 0.01 + symbol.compute_volume_sl = MagicMock(return_value=0.1) + symbol.compute_volume_points = MagicMock(return_value=0.1) + symbol.amount_in_quote_currency = MagicMock(return_value=100.0) + symbol.info_tick = MagicMock() + return symbol - def test_init_has_config_attribute(self): - """Test Trader has config attribute.""" - trader = SimpleTrader(symbol=self.symbol) - assert hasattr(trader, 'config') - assert isinstance(trader.config, Config) - def test_init_has_parameters_attribute(self): - """Test Trader has empty parameters dict.""" - trader = SimpleTrader(symbol=self.symbol) - assert hasattr(trader, 'parameters') - assert isinstance(trader.parameters, dict) - assert trader.parameters == {} +@pytest.fixture +def mock_ram(): + """Create a mock RAM instance.""" + ram = MagicMock(spec=RAM) + ram.risk_to_reward = 2.0 + ram.get_amount = MagicMock(return_value=100.0) + return ram - def test_init_with_default_ram_values(self): - """Test Trader uses default RAM if not provided.""" - trader = SimpleTrader(symbol=self.symbol) - assert trader.ram.risk_to_reward == 2 - assert trader.ram.risk == 1 + +@pytest.fixture +def mock_tick(): + """Create a mock price tick.""" + tick = MagicMock() + tick.ask = 1.10000 + tick.bid = 1.09990 + return tick + + +@pytest.fixture +def trader(mock_symbol, mock_ram, mock_tick): + """Create a ConcreteTrader for testing.""" + mock_symbol.info_tick.return_value = mock_tick + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + return t + + +# --- Tests --- + +class TestTraderInit: + """Test Trader initialization.""" + + def test_init_sets_symbol(self, mock_symbol, mock_ram): + """Test __init__ sets symbol.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert t.symbol is mock_symbol + + def test_init_sets_ram(self, mock_symbol, mock_ram): + """Test __init__ sets provided RAM.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert t.ram is mock_ram + + def test_init_creates_default_ram(self, mock_symbol): + """Test __init__ creates default RAM when none provided.""" + t = ConcreteTrader(symbol=mock_symbol) + assert isinstance(t.ram, RAM) + + def test_init_creates_order(self, mock_symbol, mock_ram): + """Test __init__ creates Order with symbol name.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert isinstance(t.order, Order) + assert t.order.symbol == "EURUSD" + + def test_init_creates_config(self, mock_symbol, mock_ram): + """Test __init__ creates Config instance.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert isinstance(t.config, Config) + + def test_init_creates_empty_parameters(self, mock_symbol, mock_ram): + """Test __init__ creates empty parameters dict.""" + t = ConcreteTrader(symbol=mock_symbol, ram=mock_ram) + assert t.parameters == {} class TestSetTradeStopLevelsPips: """Test set_trade_stop_levels_pips method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="EURUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + def test_long_order_sl_below_price(self, trader): + """Test long order sets SL below price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() + trader.set_trade_stop_levels_pips(pips=50) - def test_set_stop_levels_pips_buy_order(self): - """Test setting stop levels for buy order using pips.""" - tick = self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - pips = 50 + assert trader.order.sl < trader.order.price - self.trader.set_trade_stop_levels_pips(pips=pips) + def test_long_order_tp_above_price(self, trader): + """Test long order sets TP above price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - expected_sl = round(tick.ask - (pips * self.symbol.pip), self.symbol.digits) - expected_tp = round(tick.ask + (pips * self.ram.risk_to_reward * self.symbol.pip), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_pips(pips=50) - def test_set_stop_levels_pips_sell_order(self): - """Test setting stop levels for sell order using pips.""" - tick = self.symbol.info_tick() - self.trader.order.price = tick.bid - self.trader.order.type = OrderType.SELL - pips = 50 + assert trader.order.tp > trader.order.price - self.trader.set_trade_stop_levels_pips(pips=pips) + def test_short_order_sl_above_price(self, trader): + """Test short order sets SL above price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = False + trader.order.type.is_short = True - expected_sl = round(tick.bid + (pips * self.symbol.pip), self.symbol.digits) - expected_tp = round(tick.bid - (pips * self.ram.risk_to_reward * self.symbol.pip), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_pips(pips=50) - def test_set_stop_levels_pips_custom_risk_to_reward(self): - """Test setting stop levels with custom risk to reward ratio.""" - tick = self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - pips = 30 - custom_rr = 3 + assert trader.order.sl > trader.order.price - self.trader.set_trade_stop_levels_pips(pips=pips, risk_to_reward=custom_rr) + def test_short_order_tp_below_price(self, trader): + """Test short order sets TP below price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = False + trader.order.type.is_short = True - expected_sl = round(tick.ask - (pips * self.symbol.pip), self.symbol.digits) - expected_tp = round(tick.ask + (pips * custom_rr * self.symbol.pip), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_pips(pips=50) + + assert trader.order.tp < trader.order.price + + def test_custom_risk_to_reward(self, trader): + """Test custom risk_to_reward overrides RAM default.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False + + trader.set_trade_stop_levels_pips(pips=50, risk_to_reward=3.0) + + sl_distance = abs(trader.order.price - trader.order.sl) + tp_distance = abs(trader.order.tp - trader.order.price) + assert round(tp_distance / sl_distance, 1) == 3.0 + + def test_uses_ram_risk_to_reward_by_default(self, trader): + """Test uses RAM risk_to_reward when not specified.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False + trader.ram.risk_to_reward = 2.0 + + trader.set_trade_stop_levels_pips(pips=50) + + sl_distance = abs(trader.order.price - trader.order.sl) + tp_distance = abs(trader.order.tp - trader.order.price) + assert round(tp_distance / sl_distance, 1) == 2.0 + + def test_rounds_to_symbol_digits(self, trader): + """Test SL and TP are rounded to symbol.digits.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False + + trader.set_trade_stop_levels_pips(pips=50) + + sl_str = f"{trader.order.sl:.10f}".rstrip("0") + tp_str = f"{trader.order.tp:.10f}".rstrip("0") + sl_decimals = len(sl_str.split(".")[1]) if "." in sl_str else 0 + tp_decimals = len(tp_str.split(".")[1]) if "." in tp_str else 0 + assert sl_decimals <= 5 + assert tp_decimals <= 5 class TestSetTradeStopLevelsPoints: """Test set_trade_stop_levels_points method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="EURUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + def test_long_order_sl_below_price(self, trader): + """Test long order sets SL below price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() + trader.set_trade_stop_levels_points(points=500) - def test_set_stop_levels_points_buy_order(self): - """Test setting stop levels for buy order using points.""" - tick = self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - points = 500 + assert trader.order.sl < trader.order.price - self.trader.set_trade_stop_levels_points(points=points) + def test_long_order_tp_above_price(self, trader): + """Test long order sets TP above price.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - expected_sl = round(tick.ask - (points * self.symbol.point), self.symbol.digits) - expected_tp = round(tick.ask + (points * self.ram.risk_to_reward * self.symbol.point), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_points(points=500) - def test_set_stop_levels_points_custom_risk_to_reward(self): - """Test setting stop levels with custom risk to reward.""" - tick = self.symbol.info_tick() - self.trader.order.price = tick.ask - self.trader.order.type = OrderType.BUY - points = 500 - custom_rr = 4 + assert trader.order.tp > trader.order.price - self.trader.set_trade_stop_levels_points(points=points, risk_to_reward=custom_rr) + def test_custom_risk_to_reward(self, trader): + """Test custom risk_to_reward for points.""" + trader.order.price = 1.10000 + trader.order.type = MagicMock() + trader.order.type.is_long = True + trader.order.type.is_short = False - expected_sl = round(tick.ask - (points * self.symbol.point), self.symbol.digits) - expected_tp = round(tick.ask + (points * custom_rr * self.symbol.point), self.symbol.digits) - assert self.trader.order.sl == expected_sl - assert self.trader.order.tp == expected_tp + trader.set_trade_stop_levels_points(points=500, risk_to_reward=4.0) - -class TestCreateOrderNoStops: - """Test create_order_no_stops method.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() - - def test_create_order_no_stops_buy(self): - """Test creating buy order without stops.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.volume == self.symbol.volume_min - assert self.trader.order.price is not None - - def test_create_order_no_stops_sell(self): - """Test creating sell order without stops.""" - self.trader.create_order_no_stops(order_type=OrderType.SELL) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.volume == self.symbol.volume_min - assert self.trader.order.price is not None - - def test_create_order_no_stops_with_custom_volume(self): - """Test creating order with custom volume.""" - custom_volume = self.symbol.volume_min * 2 - self.trader.create_order_no_stops(order_type=OrderType.BUY, volume=custom_volume) - - assert self.trader.order.volume == custom_volume - - def test_create_order_no_stops_uses_correct_price(self): - """Test order uses ask for buy and bid for sell.""" - tick = self.symbol.info_tick() - - self.trader.create_order_no_stops(order_type=OrderType.BUY) - # Price should be close to ask (may differ slightly due to timing) - assert abs(self.trader.order.price - tick.ask) < tick.ask * 0.01 - - def test_create_order_no_stops_send_success(self): - """Test sending order without stops succeeds.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - -class TestCreateOrderWithSl: - """Test create_order_with_sl method.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() - - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol and account.""" - self.symbol.initialize() - self.account.refresh() - - def test_create_order_with_sl_sell(self): - """Test creating sell order with stop loss.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = self.symbol.info_tick() - sl = tick.bid + dsl - - self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.sl == sl - assert self.trader.order.tp is not None - assert self.trader.order.volume > 0 - - def test_create_order_with_sl_buy(self): - """Test creating buy order with stop loss.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = self.symbol.info_tick() - sl = tick.ask - dsl - - self.trader.create_order_with_sl(order_type=OrderType.BUY, sl=sl) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.sl == sl - assert self.trader.order.tp is not None - - def test_create_order_with_sl_respects_risk_to_reward(self): - """Test TP is set according to risk to reward ratio.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = self.symbol.info_tick() - sl = tick.bid + dsl - - self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - - # TP should be approximately at dsl * risk_to_reward distance from price - expected_dtp = dsl * self.ram.risk_to_reward - actual_dtp = abs(self.trader.order.price - self.trader.order.tp) - assert abs(actual_dtp - expected_dtp) < self.symbol.point * 10 - - def test_create_order_with_sl_custom_amount_to_risk(self): - """Test creating order with custom amount to risk.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = self.symbol.info_tick() - sl = tick.bid + dsl - custom_amount = 20 - - self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl, amount_to_risk=custom_amount) - - assert self.trader.order.volume > 0 - - def test_create_order_with_sl_send_success(self): - """Test order with SL can be sent successfully.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = self.symbol.info_tick() - sl = tick.bid + dsl - - self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - result = self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 + sl_distance = abs(trader.order.price - trader.order.sl) + tp_distance = abs(trader.order.tp - trader.order.price) + assert round(tp_distance / sl_distance, 1) == 4.0 class TestCreateOrderWithStops: """Test create_order_with_stops method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() + def test_sets_order_attributes(self, trader, mock_tick): + """Test sets sl, tp, volume, price, and type on order.""" + order_type = MagicMock() + order_type.is_long = True - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol and account.""" - self.symbol.initialize() - self.account.refresh() + trader.order.set_attributes = MagicMock() - def test_create_order_with_stops_buy(self): - """Test creating buy order with SL and TP.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - - self.trader.create_order_with_stops(order_type=OrderType.BUY, sl=sl, tp=tp) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.sl == sl - assert self.trader.order.tp == tp - assert self.trader.order.volume > 0 - - def test_create_order_with_stops_sell(self): - """Test creating sell order with SL and TP.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = self.symbol.info_tick() - sl = tick.bid + dsl - tp = tick.bid - dtp - - self.trader.create_order_with_stops(order_type=OrderType.SELL, sl=sl, tp=tp) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.sl == sl - assert self.trader.order.tp == tp - - def test_create_order_with_stops_send_success(self): - """Test order with stops can be sent successfully.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * self.ram.risk_to_reward - tick = self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - - self.trader.create_order_with_stops(order_type=OrderType.BUY, sl=sl, tp=tp) - result = self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - def test_create_order_with_stops_custom_amount(self): - """Test creating order with custom amount to risk.""" - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - dtp = dsl * 2 - tick = self.symbol.info_tick() - sl = tick.ask - dsl - tp = tick.ask + dtp - custom_amount = 25 - - self.trader.create_order_with_stops( - order_type=OrderType.BUY, sl=sl, tp=tp, amount_to_risk=custom_amount + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 ) - assert self.trader.order.volume > 0 + trader.order.set_attributes.assert_called_once() + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["sl"] == 1.09500 + assert call_kwargs["tp"] == 1.11000 + assert call_kwargs["type"] is order_type + + def test_uses_ask_for_long(self, trader, mock_tick): + """Test uses ask price for long orders.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.ask + + def test_uses_bid_for_short(self, trader, mock_tick): + """Test uses bid price for short orders.""" + order_type = MagicMock() + order_type.is_long = False + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.10500, tp=1.09000 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.bid + + def test_calculates_volume(self, trader): + """Test computes volume using symbol.compute_volume_sl.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + trader.symbol.compute_volume_sl.assert_called_once() + + def test_custom_amount_to_risk(self, trader): + """Test custom amount_to_risk overrides RAM.get_amount.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000, amount_to_risk=500.0 + ) + + trader.ram.get_amount.assert_not_called() + + def test_default_amount_from_ram(self, trader): + """Test uses RAM.get_amount when amount_to_risk not specified.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + trader.ram.get_amount.assert_called_once() + + def test_converts_amount_to_quote_currency(self, trader): + """Test converts amount using symbol.amount_in_quote_currency.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + trader.symbol.amount_in_quote_currency.assert_called_once() + + +class TestCreateOrderWithSl: + """Test create_order_with_sl method.""" + + def test_calculates_tp_from_sl(self, trader, mock_tick): + """Test calculates TP based on SL distance and risk_to_reward.""" + order_type = OrderType.BUY + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_sl( + order_type=order_type, sl=1.09500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["tp"] > call_kwargs["price"] + + def test_buy_uses_ask_price(self, trader, mock_tick): + """Test BUY order uses ask price.""" + trader.order.set_attributes = MagicMock() + + trader.create_order_with_sl( + order_type=OrderType.BUY, sl=1.09500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.ask + + def test_sell_uses_bid_price(self, trader, mock_tick): + """Test SELL order uses bid price.""" + trader.order.set_attributes = MagicMock() + + trader.create_order_with_sl( + order_type=OrderType.SELL, sl=1.10500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["price"] == mock_tick.bid + + def test_custom_risk_to_reward(self, trader, mock_tick): + """Test custom risk_to_reward affects TP calculation.""" + trader.order.set_attributes = MagicMock() + + trader.create_order_with_sl( + order_type=OrderType.BUY, sl=1.09500, risk_to_reward=3.0 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + price = call_kwargs["price"] + sl_dist = abs(price - 1.09500) + tp_dist = abs(call_kwargs["tp"] - price) + assert round(tp_dist / sl_dist, 1) == 3.0 + + def test_sell_tp_below_price(self, trader, mock_tick): + """Test SELL order sets TP below price.""" + trader.order.set_attributes = MagicMock() + + trader.create_order_with_sl( + order_type=OrderType.SELL, sl=1.10500 + ) + + call_kwargs = trader.order.set_attributes.call_args[1] + assert call_kwargs["tp"] < call_kwargs["price"] + + def test_custom_amount_to_risk(self, trader): + """Test custom amount_to_risk skips RAM.get_amount.""" + trader.order.set_attributes = MagicMock() + + trader.create_order_with_sl( + order_type=OrderType.BUY, sl=1.09500, amount_to_risk=200.0 + ) + + trader.ram.get_amount.assert_not_called() class TestCreateOrderWithPoints: """Test create_order_with_points method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() - - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() - self.account.refresh() - - def test_create_order_with_points_buy(self): - """Test creating buy order with points.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) - - assert self.trader.order.type == OrderType.BUY - assert self.trader.order.volume > 0 - assert self.trader.order.sl is not None - assert self.trader.order.tp is not None - - def test_create_order_with_points_sell(self): - """Test creating sell order with points.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - self.trader.create_order_with_points(order_type=OrderType.SELL, points=points) - - assert self.trader.order.type == OrderType.SELL - assert self.trader.order.volume > 0 - - def test_create_order_with_points_send_success(self): - """Test order with points can be sent successfully.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - - self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) - result = self.trader.order.send() - - assert result is not None - assert result.retcode == 10009 - - def test_create_order_with_points_custom_risk_to_reward(self): - """Test order with custom risk to reward.""" - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - custom_rr = 3 - - self.trader.create_order_with_points( - order_type=OrderType.BUY, points=points, risk_to_reward=custom_rr + def test_sets_order_type(self, trader): + """Test sets order type on order.""" + trader.create_order_with_points( + order_type=OrderType.BUY, points=500 ) - # TP should be at points * custom_rr distance from price - expected_tp_distance = points * custom_rr * self.symbol.point - actual_tp_distance = abs(self.trader.order.tp - self.trader.order.price) - assert abs(actual_tp_distance - expected_tp_distance) < self.symbol.point * 10 + assert trader.order.type == OrderType.BUY + + def test_sets_price_from_tick(self, trader, mock_tick): + """Test sets price from tick.""" + trader.create_order_with_points( + order_type=OrderType.BUY, points=500 + ) + + assert trader.order.price == mock_tick.ask + + def test_sell_uses_bid(self, trader, mock_tick): + """Test SELL uses bid price.""" + trader.create_order_with_points( + order_type=OrderType.SELL, points=500 + ) + + assert trader.order.price == mock_tick.bid + + def test_computes_volume_with_points(self, trader): + """Test uses symbol.compute_volume_points.""" + trader.create_order_with_points( + order_type=OrderType.BUY, points=500 + ) + + trader.symbol.compute_volume_points.assert_called_once() + + def test_sets_stop_levels(self, trader): + """Test calls set_trade_stop_levels_points.""" + with patch.object(trader, 'set_trade_stop_levels_points') as mock_set_stops: + trader.create_order_with_points( + order_type=OrderType.BUY, points=500 + ) + + mock_set_stops.assert_called_once_with(points=500, risk_to_reward=None) + + def test_custom_risk_to_reward(self, trader): + """Test passes custom risk_to_reward to set_trade_stop_levels_points.""" + with patch.object(trader, 'set_trade_stop_levels_points') as mock_set_stops: + trader.create_order_with_points( + order_type=OrderType.BUY, points=500, risk_to_reward=3.0 + ) + + mock_set_stops.assert_called_once_with(points=500, risk_to_reward=3.0) + + +class TestCreateOrderNoStops: + """Test create_order_no_stops method.""" + + def test_sets_order_type(self, trader): + """Test sets order type.""" + trader.create_order_no_stops(order_type=OrderType.BUY) + + assert trader.order.type == OrderType.BUY + + def test_uses_min_volume_default(self, trader): + """Test uses symbol.volume_min when volume not specified.""" + trader.symbol.volume_min = 0.01 + + trader.create_order_no_stops(order_type=OrderType.BUY) + + assert trader.order.volume == 0.01 + + def test_custom_volume(self, trader): + """Test uses custom volume when provided.""" + trader.create_order_no_stops(order_type=OrderType.BUY, volume=1.5) + + assert trader.order.volume == 1.5 + + def test_buy_uses_ask_price(self, trader, mock_tick): + """Test BUY uses ask price.""" + trader.create_order_no_stops(order_type=OrderType.BUY) + + assert trader.order.price == mock_tick.ask + + def test_sell_uses_bid_price(self, trader, mock_tick): + """Test SELL uses bid price.""" + trader.create_order_no_stops(order_type=OrderType.SELL) + + assert trader.order.price == mock_tick.bid class TestCheckOrder: """Test check_order method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + def test_check_order_success(self, trader): + """Test check_order returns OrderCheckResult on success.""" + mock_result = MagicMock(spec=OrderCheckResult) + mock_result.retcode = 0 + trader.order.check = MagicMock(return_value=mock_result) - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() + result = trader.check_order() - def test_check_order_returns_order_check_result(self): - """Test check_order returns OrderCheckResult.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.check_order() + assert result is mock_result - assert result is None or isinstance(result, OrderCheckResult) + def test_check_order_none_result(self, trader): + """Test check_order handles None result.""" + trader.order.check = MagicMock(return_value=None) + trader.order.mt5 = MagicMock() + trader.order.mt5.error = "Connection failed" - def test_check_order_success(self): - """Test check_order succeeds for valid order.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.check_order() + result = trader.check_order() - assert result is not None - assert result.retcode == 0 + assert result is None - def test_check_order_has_margin_info(self): - """Test check result contains margin information.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.check_order() + def test_check_order_nonzero_retcode(self, trader): + """Test check_order logs warning for non-zero retcode.""" + mock_result = MagicMock(spec=OrderCheckResult) + mock_result.retcode = 10015 + mock_result.comment = "Invalid price" + trader.order.check = MagicMock(return_value=mock_result) - assert result is not None - assert hasattr(result, 'margin') + result = trader.check_order() - def test_check_order_sell(self): - """Test check_order works for sell orders.""" - self.trader.create_order_no_stops(order_type=OrderType.SELL) - result = self.trader.check_order() + assert result is mock_result + assert result.retcode != 0 - assert result is not None - assert result.retcode == 0 + def test_check_order_calls_order_check(self, trader): + """Test check_order delegates to order.check.""" + mock_result = MagicMock(spec=OrderCheckResult) + mock_result.retcode = 0 + trader.order.check = MagicMock(return_value=mock_result) + + trader.check_order() + + trader.order.check.assert_called_once() class TestSendOrder: """Test send_order method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + def test_send_order_success(self, trader): + """Test send_order returns result on success (retcode 10009).""" + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10009 + trader.order.send = MagicMock(return_value=mock_result) - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() + result = trader.send_order() - def test_send_order_returns_order_send_result(self): - """Test send_order returns OrderSendResult.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() - - assert result is None or isinstance(result, OrderSendResult) - - def test_send_order_success(self): - """Test send_order succeeds for valid order.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() - - assert result is not None + assert result is mock_result assert result.retcode == 10009 - def test_send_order_has_deal_ticket(self): - """Test send result contains deal ticket.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() + def test_send_order_none_result(self, trader): + """Test send_order handles None result.""" + trader.order.send = MagicMock(return_value=None) + trader.order.mt5 = MagicMock() + trader.order.mt5.error = "No connection" - assert result is not None - assert hasattr(result, 'deal') - assert result.deal > 0 + result = trader.send_order() - def test_send_order_has_order_ticket(self): - """Test send result contains order ticket.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() + assert result is None - assert result is not None - assert hasattr(result, 'order') - assert result.order > 0 + def test_send_order_failure_retcode(self, trader): + """Test send_order returns result for non-10009 retcode.""" + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10006 + mock_result.comment = "Requote" + trader.order.send = MagicMock(return_value=mock_result) + + result = trader.send_order() + + assert result is mock_result + assert result.retcode == 10006 + + def test_send_order_calls_order_send(self, trader): + """Test send_order delegates to order.send.""" + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10009 + trader.order.send = MagicMock(return_value=mock_result) + + trader.send_order() + + trader.order.send.assert_called_once() class TestRecordTrade: """Test record_trade method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) + @pytest.fixture + def successful_result(self): + """Create a successful OrderSendResult.""" + result = MagicMock(spec=OrderSendResult) + result.retcode = 10009 + result.order = 12345 + result.request = MagicMock() + return result - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() + def test_record_trade_skips_when_disabled(self, trader, successful_result): + """Test record_trade does nothing when record_trades is False.""" + trader.config.record_trades = False - def test_record_trade_with_successful_order(self): - """Test recording a successful trade.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() + trader.record_trade(result=successful_result) - # Should not raise an error - self.trader.record_trade(result=result, parameters={"test": "value"}, name="TestStrategy", use_task_queue=False) + def test_record_trade_skips_failed_orders(self, trader): + """Test record_trade skips when retcode is not 10009.""" + trader.config.record_trades = True + result = MagicMock(spec=OrderSendResult) + result.retcode = 10006 - def test_record_trade_with_parameters(self): - """Test recording trade with custom parameters.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() + trader.record_trade(result=result) - params = {"strategy": "test", "risk": 1, "timeframe": "H1"} - self.trader.record_trade(result=result, parameters=params, name="MyStrategy", use_task_queue=False) + def test_record_trade_uses_task_queue(self, trader, successful_result): + """Test record_trade adds to task queue by default.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() - def test_record_trade_without_parameters(self): - """Test recording trade without parameters.""" - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result = self.trader.send_order() + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_order) + trader.order.calc_profit = MagicMock(return_value=50.0) - # Should not raise an error - self.trader.record_trade(result=result, name="SimpleStrategy", use_task_queue=False) + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res + + trader.record_trade(result=successful_result, parameters={"key": "value"}) + + trader.config.task_queue.add.assert_called_once() + + def test_record_trade_direct_save(self, trader, successful_result): + """Test record_trade saves directly when use_task_queue=False.""" + trader.config.record_trades = True + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_order) + trader.order.calc_profit = MagicMock(return_value=50.0) + + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res + + trader.record_trade( + result=successful_result, + use_task_queue=False + ) + + mock_res.save_sync.assert_called_once() + + def test_record_trade_with_parameters(self, trader, successful_result): + """Test record_trade passes parameters to Result.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_order) + trader.order.calc_profit = MagicMock(return_value=50.0) + + params = {"strategy": "scalping", "timeframe": "M5"} + + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res + + trader.record_trade( + result=successful_result, parameters=params, name="TestStrategy" + ) + + call_kwargs = MockResult.call_args[1] + assert call_kwargs["parameters"] == params + assert call_kwargs["name"] == "TestStrategy" + + def test_record_trade_with_expected_profit(self, trader, successful_result): + """Test record_trade uses provided expected_profit.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_order) + + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res + + trader.record_trade( + result=successful_result, expected_profit=75.0 + ) + + call_kwargs = MockResult.call_args[1] + assert call_kwargs["expected_profit"] == 75.0 + + def test_record_trade_non_dict_parameters(self, trader, successful_result): + """Test record_trade handles non-dict parameters.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.09500 + mock_order.tp = 1.11000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_order) + trader.order.calc_profit = MagicMock(return_value=10.0) + + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res + + trader.record_trade( + result=successful_result, parameters="not_a_dict" + ) + + call_kwargs = MockResult.call_args[1] + assert call_kwargs["parameters"] == {} + + def test_record_trade_updates_sl_tp_from_history(self, trader, successful_result): + """Test record_trade sets sl and tp on result.request from history order.""" + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() + + mock_order = MagicMock() + mock_order.sl = 1.08000 + mock_order.tp = 1.12000 + mock_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_order) + trader.order.calc_profit = MagicMock(return_value=10.0) + + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res + + trader.record_trade(result=successful_result) + + assert successful_result.request.sl == 1.08000 + assert successful_result.request.tp == 1.12000 -class TestTraderWithDifferentSymbols: - """Test Trader with different symbols.""" +class TestPlaceTrade: + """Test abstract place_trade method.""" - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.btc_usd = ForexSymbol(name="BTCUSD") - cls.eur_jpy = ForexSymbol(name="EURJPY") - cls.ram = RAM(fixed_amount=10) + def test_cannot_instantiate_trader_directly(self, mock_symbol, mock_ram): + """Test Trader cannot be instantiated due to abstract method.""" + with pytest.raises(TypeError): + Trader(symbol=mock_symbol, ram=mock_ram) - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbols.""" - self.btc_usd.initialize() - self.eur_jpy.initialize() + def test_subclass_must_implement_place_trade(self): + """Test subclass without place_trade raises TypeError.""" + with pytest.raises(TypeError): + class IncompleteTrader(Trader): + pass + + IncompleteTrader(symbol=MagicMock()) + + def test_concrete_place_trade_callable(self, trader): + """Test ConcreteTrader.place_trade is callable.""" + trader.place_trade() + + +class TestIntegration: + """Integration tests for sync Trader.""" + + def test_create_and_check_order(self, trader, mock_tick): + """Test creating order then checking it.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + mock_check_result = MagicMock(spec=OrderCheckResult) + mock_check_result.retcode = 0 + trader.order.check = MagicMock(return_value=mock_check_result) + + check = trader.check_order() + assert check.retcode == 0 + + def test_create_and_send_order(self, trader, mock_tick): + """Test creating order then sending it.""" + order_type = MagicMock() + order_type.is_long = True + + trader.order.set_attributes = MagicMock() + + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + mock_send_result = MagicMock(spec=OrderSendResult) + mock_send_result.retcode = 10009 + trader.order.send = MagicMock(return_value=mock_send_result) - def test_trader_btc_usd(self): - """Test trader with BTCUSD symbol.""" - trader = SimpleTrader(symbol=self.btc_usd, ram=self.ram) - trader.create_order_no_stops(order_type=OrderType.BUY) result = trader.send_order() - - assert result is not None assert result.retcode == 10009 - def test_trader_eur_jpy(self): - """Test trader with EURJPY symbol.""" - trader = SimpleTrader(symbol=self.eur_jpy, ram=self.ram) - trader.create_order_no_stops(order_type=OrderType.SELL) - result = trader.send_order() + def test_full_trade_lifecycle(self, trader, mock_tick): + """Test full lifecycle: create, check, send, record.""" + order_type = MagicMock() + order_type.is_long = True - assert result is not None + trader.order.set_attributes = MagicMock() + + # Create + trader.create_order_with_stops( + order_type=order_type, sl=1.09500, tp=1.11000 + ) + + # Check + mock_check = MagicMock(spec=OrderCheckResult) + mock_check.retcode = 0 + trader.order.check = MagicMock(return_value=mock_check) + check = trader.check_order() + assert check.retcode == 0 + + # Send + mock_result = MagicMock(spec=OrderSendResult) + mock_result.retcode = 10009 + mock_result.order = 99999 + mock_result.request = MagicMock() + trader.order.send = MagicMock(return_value=mock_result) + result = trader.send_order() assert result.retcode == 10009 + # Record + trader.config.record_trades = True + trader.config.task_queue = MagicMock() + trader.config.task_queue.add = MagicMock() -class TestTraderIntegration: - """Integration tests for Trader.""" + mock_history_order = MagicMock() + mock_history_order.sl = 1.09500 + mock_history_order.tp = 1.11000 + mock_history_order.time_setup_msc = 1705312800000 + trader.order.get_history_order_by_ticket = MagicMock(return_value=mock_history_order) + trader.order.calc_profit = MagicMock(return_value=50.0) - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - cls.ram = RAM(fixed_amount=10, risk_to_reward=2) - cls.trader = SimpleTrader(symbol=cls.symbol, ram=cls.ram) - cls.account = Account() + with patch('aiomql.lib.sync.trader.Result') as MockResult: + mock_res = MagicMock() + mock_res.save_sync = MagicMock() + MockResult.return_value = mock_res - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol and account.""" - self.symbol.initialize() - self.account.refresh() + trader.record_trade(result=result, name="TestStrategy") - def test_full_trade_flow_buy(self): - """Test complete trade flow for buy order.""" - # Create order - points = self.symbol.trade_stops_level * 2 + self.symbol.spread - self.trader.create_order_with_points(order_type=OrderType.BUY, points=points) - - # Check order - check_result = self.trader.check_order() - assert check_result is not None - assert check_result.retcode == 0 - - # Send order - send_result = self.trader.send_order() - assert send_result is not None - assert send_result.retcode == 10009 - - # Record trade - self.trader.record_trade(result=send_result, parameters={"test": True}, name="IntegrationTest", use_task_queue=False) - - def test_full_trade_flow_sell(self): - """Test complete trade flow for sell order.""" - # Create order - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = self.symbol.info_tick() - sl = tick.bid + dsl - - self.trader.create_order_with_sl(order_type=OrderType.SELL, sl=sl) - - # Check order - check_result = self.trader.check_order() - assert check_result is not None - assert check_result.retcode == 0 - - # Send order - send_result = self.trader.send_order() - assert send_result is not None - assert send_result.retcode == 10009 - - def test_multiple_orders_same_trader(self): - """Test creating multiple orders with same trader.""" - # First order - self.trader.create_order_no_stops(order_type=OrderType.BUY) - result1 = self.trader.send_order() - assert result1 is not None - assert result1.retcode == 10009 - - # Second order (different type) - self.trader.create_order_no_stops(order_type=OrderType.SELL) - result2 = self.trader.send_order() - assert result2 is not None - assert result2.retcode == 10009 - - -class TestTraderEdgeCases: - """Test edge cases and boundary conditions.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() - - def test_trader_with_zero_fixed_amount(self): - """Test trader with zero fixed amount RAM.""" - ram = RAM(fixed_amount=0) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - assert trader.ram.fixed_amount == 0 - - def test_trader_with_high_risk_to_reward(self): - """Test trader with high risk to reward ratio.""" - ram = RAM(fixed_amount=10, risk_to_reward=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - assert trader.ram.risk_to_reward == 10 - - def test_trader_with_low_risk_to_reward(self): - """Test trader with low risk to reward ratio.""" - ram = RAM(fixed_amount=10, risk_to_reward=0.5) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - assert trader.ram.risk_to_reward == 0.5 - - def test_trader_order_modification_after_creation(self): - """Test modifying order attributes after creation.""" - ram = RAM(fixed_amount=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - trader.create_order_no_stops(order_type=OrderType.BUY) - - original_volume = trader.order.volume - trader.order.volume = original_volume * 2 - assert trader.order.volume == original_volume * 2 - - def test_trader_parameters_modification(self): - """Test modifying trader parameters.""" - ram = RAM(fixed_amount=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - trader.parameters["custom_param"] = "value" - trader.parameters["risk"] = 5 - - assert trader.parameters["custom_param"] == "value" - assert trader.parameters["risk"] == 5 - - def test_trader_with_minimum_volume(self): - """Test creating order with minimum volume.""" - ram = RAM(fixed_amount=1) # Very small amount - trader = SimpleTrader(symbol=self.symbol, ram=ram) - trader.create_order_no_stops(order_type=OrderType.BUY) - - assert trader.order.volume >= self.symbol.volume_min - - -class TestTraderRAMIntegration: - """Test Trader integration with RAM.""" - - @classmethod - def setup_class(cls): - """Set up test fixtures.""" - cls.symbol = ForexSymbol(name="BTCUSD") - - @pytest.fixture(scope="class", autouse=True) - def initialize(self): - """Initialize symbol.""" - self.symbol.initialize() - - def test_trader_uses_ram_get_amount(self): - """Test trader uses RAM get_amount for volume calculation.""" - ram = RAM(fixed_amount=20) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = trader.symbol.info_tick() - sl = tick.ask - dsl - - trader.create_order_with_sl(order_type=OrderType.BUY, sl=sl) - - # Volume should be calculated based on RAM fixed_amount (20) - assert trader.order.volume > 0 - - def test_trader_uses_ram_risk_to_reward(self): - """Test trader uses RAM risk_to_reward for TP calculation.""" - ram = RAM(fixed_amount=10, risk_to_reward=3) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - dsl = (self.symbol.trade_stops_level * 2 + self.symbol.spread) * self.symbol.point - tick = trader.symbol.info_tick() - sl = tick.ask - dsl - - trader.create_order_with_sl(order_type=OrderType.BUY, sl=sl) - - # TP distance should be 3x the SL distance - sl_distance = abs(trader.order.price - trader.order.sl) - tp_distance = abs(trader.order.tp - trader.order.price) - - assert abs(tp_distance - (sl_distance * 3)) < self.symbol.point * 10 - - def test_trader_modifying_ram_after_init(self): - """Test modifying RAM after trader initialization.""" - ram = RAM(fixed_amount=10) - trader = SimpleTrader(symbol=self.symbol, ram=ram) - - trader.ram.modify_ram(fixed_amount=25, risk_to_reward=4) - - assert trader.ram.fixed_amount == 25 - assert trader.ram.risk_to_reward == 4 + trader.config.task_queue.add.assert_called_once() diff --git a/tests/live/unit/utils/test_percentages.py b/tests/live/unit/utils/test_percentages.py deleted file mode 100644 index 8178c17..0000000 --- a/tests/live/unit/utils/test_percentages.py +++ /dev/null @@ -1,224 +0,0 @@ -"""Comprehensive tests for the percentages module. - -Tests cover: -- get_price_diff_pct -- get_price_in_range_pct -- get_price_at_pct -- extend_interval_by_percentage -- get_price_change_pct -- increase_value_by_pct -- decrease_value_by_pct -""" - -import pytest - -from aiomql.utils.price_utils import ( - get_price_diff_pct, - get_price_in_range_pct, - get_price_at_pct, - extend_interval_by_percentage, - get_price_change_pct, - increase_value_by_pct, - decrease_value_by_pct -) - - -class TestCalculatePercentageDifference: - """Tests for get_price_diff_pct function.""" - - def test_equal_values(self): - """Test equal values returns 0.""" - assert get_price_diff_pct(50, 50) == 0.0 - assert get_price_diff_pct(100, 100) == 0.0 - - def test_different_values(self): - """Test different values returns correct percentage.""" - result = get_price_diff_pct(100, 110) - assert abs(result - 9.523809523809524) < 0.0001 - - def test_large_difference(self): - """Test large difference.""" - result = get_price_diff_pct(200, 100) - assert abs(result - 66.66666666666666) < 0.0001 - - def test_order_independent(self): - """Test result is same regardless of order.""" - result1 = get_price_diff_pct(100, 200) - result2 = get_price_diff_pct(200, 100) - assert result1 == result2 - - def test_decimal_values(self): - """Test with decimal values.""" - result = get_price_diff_pct(1.5, 1.0) - assert result > 0 - - -class TestCalculatePercentagePosition: - """Tests for get_price_in_range_pct function.""" - - def test_value_at_start(self): - """Test value at start returns 0%.""" - assert get_price_in_range_pct(0, 100, 0) == 0.0 - assert get_price_in_range_pct(10, 20, 10) == 0.0 - - def test_value_at_end(self): - """Test value at end returns 100%.""" - assert get_price_in_range_pct(0, 100, 100) == 100.0 - assert get_price_in_range_pct(10, 20, 20) == 100.0 - - def test_value_in_middle(self): - """Test value in middle returns 50%.""" - assert get_price_in_range_pct(0, 100, 50) == 50.0 - assert get_price_in_range_pct(10, 20, 15) == 50.0 - - def test_quarter_position(self): - """Test 25% position.""" - assert get_price_in_range_pct(0, 100, 25) == 25.0 - - def test_value_beyond_end(self): - """Test value beyond end returns > 100%.""" - result = get_price_in_range_pct(0, 100, 150) - assert result == 150.0 - - def test_value_before_start(self): - """Test value before start returns negative.""" - result = get_price_in_range_pct(0, 100, -50) - assert result == -50.0 - - -class TestCalculateValueAtPercentage: - """Tests for get_price_at_pct function.""" - - def test_zero_percent(self): - """Test 0% returns start value.""" - assert get_price_at_pct(0, 100, 0) == 0.0 - assert get_price_at_pct(10, 20, 0) == 10.0 - - def test_hundred_percent(self): - """Test 100% returns end value.""" - assert get_price_at_pct(0, 100, 100) == 100.0 - assert get_price_at_pct(10, 20, 100) == 20.0 - - def test_fifty_percent(self): - """Test 50% returns middle value.""" - assert get_price_at_pct(0, 100, 50) == 50.0 - assert get_price_at_pct(10, 20, 50) == 15.0 - - def test_quarter_percent(self): - """Test 25% position.""" - assert get_price_at_pct(0, 200, 25) == 50.0 - - def test_beyond_hundred_percent(self): - """Test > 100% extends beyond end.""" - assert get_price_at_pct(0, 100, 150) == 150.0 - - -class TestExtendIntervalByPercentage: - """Tests for extend_interval_by_percentage function.""" - - def test_fifty_percent_extension(self): - """Test 50% extension.""" - assert extend_interval_by_percentage(0, 100, 50) == 150.0 - - def test_hundred_percent_extension(self): - """Test 100% extension (doubles interval).""" - assert extend_interval_by_percentage(10, 20, 100) == 30.0 - - def test_twenty_percent_extension(self): - """Test 20% extension.""" - assert extend_interval_by_percentage(0, 50, 20) == 60.0 - - def test_zero_percent_extension(self): - """Test 0% extension returns original end.""" - assert extend_interval_by_percentage(0, 100, 0) == 100.0 - - def test_small_interval(self): - """Test with small interval.""" - result = extend_interval_by_percentage(1.0, 1.1, 50) - assert abs(result - 1.15) < 0.0001 - - -class TestCalculatePercentageChange: - """Tests for get_price_change_pct function.""" - - def test_no_change(self): - """Test no change returns 0%.""" - assert get_price_change_pct(50, 50) == 0.0 - assert get_price_change_pct(100, 100) == 0.0 - - def test_positive_change(self): - """Test positive change (increase).""" - assert get_price_change_pct(100, 150) == 50.0 - assert get_price_change_pct(100, 200) == 100.0 - - def test_negative_change(self): - """Test negative change (decrease).""" - assert get_price_change_pct(200, 100) == -50.0 - assert get_price_change_pct(100, 50) == -50.0 - - def test_double_value(self): - """Test doubling returns 100%.""" - assert get_price_change_pct(50, 100) == 100.0 - - def test_half_value(self): - """Test halving returns -50%.""" - assert get_price_change_pct(100, 50) == -50.0 - - -class TestIncreaseByPercentage: - """Tests for increase_value_by_pct function.""" - - def test_ten_percent_increase(self): - """Test 10% increase.""" - result = increase_value_by_pct(100, 10) - assert result == 110.0 - - def test_twenty_percent_increase(self): - """Test 20% increase.""" - assert increase_value_by_pct(50, 20) == 60.0 - - def test_fifty_percent_increase(self): - """Test 50% increase.""" - assert increase_value_by_pct(200, 50) == 300.0 - - def test_zero_percent_increase(self): - """Test 0% increase returns original.""" - assert increase_value_by_pct(100, 0) == 100.0 - - def test_hundred_percent_increase(self): - """Test 100% increase doubles value.""" - assert increase_value_by_pct(50, 100) == 100.0 - - def test_decimal_value(self): - """Test with decimal value.""" - result = increase_value_by_pct(1.1000, 10) - assert abs(result - 1.21) < 0.0001 - - -class TestDecreaseByPercentage: - """Tests for decrease_value_by_pct function.""" - - def test_ten_percent_decrease(self): - """Test 10% decrease.""" - assert decrease_value_by_pct(100, 10) == 90.0 - - def test_twenty_percent_decrease(self): - """Test 20% decrease.""" - assert decrease_value_by_pct(50, 20) == 40.0 - - def test_fifty_percent_decrease(self): - """Test 50% decrease.""" - assert decrease_value_by_pct(200, 50) == 100.0 - - def test_zero_percent_decrease(self): - """Test 0% decrease returns original.""" - assert decrease_value_by_pct(100, 0) == 100.0 - - def test_hundred_percent_decrease(self): - """Test 100% decrease returns 0.""" - assert decrease_value_by_pct(100, 100) == 0.0 - - def test_decimal_value(self): - """Test with decimal value.""" - result = decrease_value_by_pct(1.1000, 10) - assert abs(result - 0.99) < 0.0001 diff --git a/tests/live/unit/utils/test_price_utils.py b/tests/live/unit/utils/test_price_utils.py new file mode 100644 index 0000000..2f5ee87 --- /dev/null +++ b/tests/live/unit/utils/test_price_utils.py @@ -0,0 +1,281 @@ +"""Comprehensive tests for the price_utils module. + +Tests cover all 8 pure utility functions: +- get_price_diff_pct +- get_price_in_range_pct +- get_price_at_pct +- extend_range_by_pct +- get_price_change_pct +- increase_value_by_pct +- decrease_value_by_pct +""" + +import pytest + +from aiomql.utils.price_utils import ( + get_price_diff_pct, + get_price_in_range_pct, + get_price_at_pct, + extend_range_by_pct, + get_price_change_pct, + increase_value_by_pct, + decrease_value_by_pct, +) + + +class TestGetPriceDiffPct: + """Tests for get_price_diff_pct function.""" + + def test_equal_values(self): + """Test zero difference when values are equal.""" + assert get_price_diff_pct(50, 50) == 0.0 + + def test_small_difference(self): + """Test small percentage difference.""" + result = get_price_diff_pct(100, 110) + assert pytest.approx(result, rel=1e-6) == 9.523809523809524 + + def test_large_difference(self): + """Test large percentage difference.""" + result = get_price_diff_pct(200, 100) + assert pytest.approx(result, rel=1e-6) == 66.66666666666666 + + def test_order_does_not_matter(self): + """Test that argument order gives same result (symmetric).""" + assert get_price_diff_pct(100, 110) == get_price_diff_pct(110, 100) + + def test_with_decimals(self): + """Test with decimal values (common in forex pricing).""" + result = get_price_diff_pct(1.1000, 1.1050) + assert result > 0 + + def test_very_close_values(self): + """Test with very close values.""" + result = get_price_diff_pct(1.10000, 1.10001) + assert result > 0 + assert result < 0.01 # Very small percentage + + +class TestGetPriceInRangePct: + """Tests for get_price_in_range_pct function.""" + + def test_midpoint(self): + """Test value at midpoint returns 50%.""" + assert get_price_in_range_pct(0, 100, 50) == 50.0 + + def test_start_value(self): + """Test value at start returns 0%.""" + assert get_price_in_range_pct(0, 100, 0) == 0.0 + + def test_end_value(self): + """Test value at end returns 100%.""" + assert get_price_in_range_pct(0, 100, 100) == 100.0 + + def test_quarter(self): + """Test value at 25%.""" + assert get_price_in_range_pct(0, 100, 25) == 25.0 + + def test_offset_range(self): + """Test with non-zero start.""" + assert get_price_in_range_pct(10, 20, 15) == 50.0 + + def test_beyond_range(self): + """Test value beyond the range returns > 100%.""" + result = get_price_in_range_pct(0, 100, 150) + assert result == 150.0 + + def test_below_range(self): + """Test value below the range returns negative.""" + result = get_price_in_range_pct(10, 20, 5) + assert result == -50.0 + + def test_forex_prices(self): + """Test with realistic forex price ranges.""" + # Price at 80% of move from 1.1000 to 1.1100 + result = get_price_in_range_pct(1.1000, 1.1100, 1.1080) + assert pytest.approx(result, rel=1e-6) == 80.0 + + +class TestGetPriceAtPct: + """Tests for get_price_at_pct function.""" + + def test_zero_percent(self): + """Test 0% returns start value.""" + assert get_price_at_pct(0, 100, 0) == 0.0 + + def test_hundred_percent(self): + """Test 100% returns end value.""" + assert get_price_at_pct(0, 100, 100) == 100.0 + + def test_fifty_percent(self): + """Test 50% returns midpoint.""" + assert get_price_at_pct(0, 100, 50) == 50.0 + + def test_offset_range(self): + """Test with non-zero start.""" + assert get_price_at_pct(10, 20, 50) == 15.0 + + def test_twenty_five_percent(self): + """Test 25%.""" + assert get_price_at_pct(0, 200, 25) == 50.0 + + def test_over_hundred_percent(self): + """Test beyond 100% extends past end.""" + result = get_price_at_pct(0, 100, 150) + assert result == 150.0 + + def test_inverse_of_get_price_in_range_pct(self): + """Test that get_price_at_pct is the inverse of get_price_in_range_pct.""" + start, end = 1.1000, 1.1100 + pct = 75.0 + value = get_price_at_pct(start, end, pct) + recovered_pct = get_price_in_range_pct(start, end, value) + assert pytest.approx(recovered_pct, rel=1e-6) == pct + + +class TestExtendRangeByPct: + """Tests for extend_range_by_pct function.""" + + def test_extend_by_fifty_percent(self): + """Test extending range by 50%.""" + assert extend_range_by_pct(0, 100, 50) == 150.0 + + def test_extend_by_hundred_percent(self): + """Test extending range by 100% (doubles the span beyond end).""" + assert extend_range_by_pct(10, 20, 100) == 30.0 + + def test_extend_by_twenty_percent(self): + """Test extending range by 20%.""" + assert extend_range_by_pct(0, 50, 20) == 60.0 + + def test_extend_by_zero(self): + """Test extending by 0% returns original end.""" + assert extend_range_by_pct(0, 100, 0) == 100.0 + + def test_forex_take_profit_extension(self): + """Test realistic forex TP extension scenario.""" + # Extend TP from 1.1100 (opened at 1.1000) by 20% + new_tp = extend_range_by_pct(1.1000, 1.1100, 20) + expected = 1.1100 + (0.0100 * 0.20) # 1.1120 + assert pytest.approx(new_tp, rel=1e-6) == expected + + def test_small_extension(self): + """Test small percentage extension.""" + result = extend_range_by_pct(100, 200, 10) + assert result == 210.0 + + +class TestGetPriceChangePct: + """Tests for get_price_change_pct function.""" + + def test_no_change(self): + """Test zero change.""" + assert get_price_change_pct(50, 50) == 0.0 + + def test_increase(self): + """Test positive price change.""" + assert get_price_change_pct(100, 150) == 50.0 + + def test_decrease(self): + """Test negative price change.""" + assert get_price_change_pct(200, 100) == -50.0 + + def test_double(self): + """Test 100% increase (doubling).""" + assert get_price_change_pct(100, 200) == 100.0 + + def test_small_change(self): + """Test small forex-like price change.""" + result = get_price_change_pct(1.1000, 1.1010) + assert pytest.approx(result, abs=0.01) == pytest.approx(0.0909, abs=0.01) + + def test_negative_values(self): + """Test with signed values (e.g. profit going more negative).""" + result = get_price_change_pct(-100, -50) + assert result == -50.0 + + +class TestIncreaseValueByPct: + """Tests for increase_value_by_pct function.""" + + def test_increase_by_ten_percent(self): + """Test 10% increase.""" + assert round(increase_value_by_pct(100, 10), 2) == 110.0 + + def test_increase_by_twenty_percent(self): + """Test 20% increase.""" + assert increase_value_by_pct(50, 20) == 60.0 + + def test_increase_by_fifty_percent(self): + """Test 50% increase.""" + assert increase_value_by_pct(200, 50) == 300.0 + + def test_increase_by_zero(self): + """Test 0% increase returns original value.""" + assert increase_value_by_pct(100, 0) == 100.0 + + def test_increase_by_hundred_percent(self): + """Test 100% increase doubles the value.""" + assert increase_value_by_pct(100, 100) == 200.0 + + def test_increase_with_decimals(self): + """Test increase with decimal input.""" + result = increase_value_by_pct(1.1000, 5) + assert pytest.approx(result, rel=1e-6) == 1.155 + + +class TestDecreaseValueByPct: + """Tests for decrease_value_by_pct function.""" + + def test_decrease_by_ten_percent(self): + """Test 10% decrease.""" + assert decrease_value_by_pct(100, 10) == 90.0 + + def test_decrease_by_twenty_percent(self): + """Test 20% decrease.""" + assert decrease_value_by_pct(50, 20) == 40.0 + + def test_decrease_by_fifty_percent(self): + """Test 50% decrease halves the value.""" + assert decrease_value_by_pct(200, 50) == 100.0 + + def test_decrease_by_zero(self): + """Test 0% decrease returns original value.""" + assert decrease_value_by_pct(100, 0) == 100.0 + + def test_decrease_by_hundred_percent(self): + """Test 100% decrease returns zero.""" + assert decrease_value_by_pct(100, 100) == 0.0 + + def test_decrease_with_decimals(self): + """Test decrease with decimal input.""" + result = decrease_value_by_pct(1.1000, 5) + assert pytest.approx(result, rel=1e-6) == 1.045 + + +class TestFunctionInteractions: + """Tests verifying relationships between price utility functions.""" + + def test_increase_then_decrease_returns_original(self): + """Test that increase then decrease by same rate does NOT return original + (this is expected due to compounding).""" + original = 100.0 + increased = increase_value_by_pct(original, 10) + result = decrease_value_by_pct(increased, 10) + # 100 * 1.1 * 0.9 = 99.0, NOT 100 (compounding effect) + assert pytest.approx(result, rel=1e-6) == 99.0 + + def test_extend_range_consistent_with_range_pct(self): + """Test that extended range position is beyond 100%.""" + start, end = 0, 100 + extended = extend_range_by_pct(start, end, 50) + pct = get_price_in_range_pct(start, end, extended) + assert pct == 150.0 + + def test_price_change_consistent_with_increase(self): + """Test that increase_value_by_pct result matches get_price_change_pct.""" + original = 100.0 + rate = 25.0 + increased = increase_value_by_pct(original, rate) + change = get_price_change_pct(original, increased) + assert pytest.approx(change, rel=1e-6) == rate diff --git a/tests/live/unit/utils/test_utils.py b/tests/live/unit/utils/test_utils.py index 216c0fe..6ab9cc3 100644 --- a/tests/live/unit/utils/test_utils.py +++ b/tests/live/unit/utils/test_utils.py @@ -12,7 +12,7 @@ Tests cover: """ import pytest -from unittest.mock import patch, MagicMock, AsyncMock +from unittest.mock import patch from aiomql.utils.utils import ( dict_to_string, @@ -62,29 +62,43 @@ class TestDictToString: assert "float: 3.14" in result assert "bool: True" in result + def test_multi_false_uses_comma_separator(self): + """Test that multi=False uses comma-space separator.""" + result = dict_to_string({"a": 1, "b": 2}, multi=False) + assert "\n" not in result + assert ", " in result + + def test_single_item_no_separator(self): + """Test single item has no separator character.""" + result = dict_to_string({"key": "val"}) + assert "," not in result + assert "\n" not in result + class TestBackoffDecorator: """Tests for backoff_decorator.""" + @pytest.mark.asyncio async def test_successful_call_no_retry(self): """Test successful call does not retry.""" call_count = 0 - + @backoff_decorator async def success_func(): nonlocal call_count call_count += 1 return "success" - + result = await success_func() - + assert result == "success" assert call_count == 1 + @pytest.mark.asyncio async def test_retry_on_exception(self): - """Test retries on exception.""" + """Test retries on exception until success.""" call_count = 0 - + @backoff_decorator(max_retries=3) async def failing_func(): nonlocal call_count @@ -92,152 +106,245 @@ class TestBackoffDecorator: if call_count < 3: raise ValueError("Test error") return "success" - - with patch("aiomql.utils.utils.Config") as mock_config: - mock_config.return_value.mode = "backtest" # Skip sleep - result = await failing_func() - + + result = await failing_func() + assert result == "success" assert call_count == 3 + @pytest.mark.asyncio async def test_max_retries_exceeded(self): """Test raises after max retries exceeded.""" call_count = 0 - + @backoff_decorator(max_retries=2) async def always_fails(): nonlocal call_count call_count += 1 raise ValueError("Always fails") - - with patch("aiomql.utils.utils.Config") as mock_config: - mock_config.return_value.mode = "backtest" - with pytest.raises(ValueError, match="Always fails"): - await always_fails() - + + with pytest.raises(ValueError, match="Always fails"): + await always_fails() + assert call_count == 3 # Initial + 2 retries - async def test_backoff_delay_in_live_mode(self): - """Test backoff delay applied in live mode.""" - call_count = 0 - + @pytest.mark.asyncio + async def test_max_retries_logs_error(self): + """Test logs error when max retries exceeded.""" @backoff_decorator(max_retries=1) - async def failing_func(): - nonlocal call_count - call_count += 1 - if call_count < 2: - raise ValueError("Test error") - return "success" - - with patch("aiomql.utils.utils.Config") as mock_config: - mock_config.return_value.mode = "live" - with patch("aiomql.utils.utils.asyncio.sleep", new_callable=AsyncMock) as mock_sleep: - result = await failing_func() - mock_sleep.assert_called_once() + async def always_fails(): + raise ValueError("Test error") + with patch("aiomql.utils.utils.logger") as mock_logger: + with pytest.raises(ValueError): + await always_fails() + mock_logger.error.assert_called_once() + + @pytest.mark.asyncio async def test_decorator_without_parentheses(self): """Test decorator can be used without parentheses.""" @backoff_decorator async def simple_func(): return "result" - + result = await simple_func() assert result == "result" + @pytest.mark.asyncio async def test_decorator_with_parentheses(self): """Test decorator can be used with parentheses.""" @backoff_decorator() async def simple_func(): return "result" - + result = await simple_func() assert result == "result" + @pytest.mark.asyncio + async def test_passes_args_and_kwargs(self): + """Test decorated function receives args and kwargs correctly.""" + @backoff_decorator + async def add(a, b, c=0): + return a + b + c + + result = await add(1, 2, c=3) + assert result == 6 + + @pytest.mark.asyncio + async def test_retries_reset_on_success(self): + """Test retries counter resets after a successful call.""" + call_count = 0 + + @backoff_decorator(max_retries=2) + async def intermittent_func(): + nonlocal call_count + call_count += 1 + if call_count == 1: + raise ValueError("First call fails") + return "success" + + # First call succeeds after 1 retry + result = await intermittent_func() + assert result == "success" + + # Reset call_count for second invocation + call_count = 10 # Won't fail since count != 1 + + # Second call should also work (retries were reset) + result = await intermittent_func() + assert result == "success" + + @pytest.mark.asyncio + async def test_preserves_function_name(self): + """Test decorator preserves original function name via @wraps.""" + @backoff_decorator + async def my_function(): + return True + + assert my_function.__name__ == "my_function" + + @pytest.mark.asyncio + async def test_custom_max_retries(self): + """Test custom max_retries value is respected.""" + call_count = 0 + + @backoff_decorator(max_retries=5) + async def failing_func(): + nonlocal call_count + call_count += 1 + if call_count < 5: + raise ValueError("Fail") + return "success" + + result = await failing_func() + assert result == "success" + assert call_count == 5 + class TestErrorHandler: """Tests for error_handler async decorator.""" + @pytest.mark.asyncio async def test_successful_call(self): """Test successful call returns result.""" @error_handler async def success_func(): return "success" - + result = await success_func() assert result == "success" + @pytest.mark.asyncio async def test_exception_returns_response(self): """Test exception returns configured response.""" @error_handler(response="default") async def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger"): result = await failing_func() - + assert result == "default" + @pytest.mark.asyncio async def test_exception_returns_none_by_default(self): """Test exception returns None by default.""" @error_handler async def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger"): result = await failing_func() - + assert result is None + @pytest.mark.asyncio async def test_custom_exception_type(self): """Test catches only specified exception type.""" @error_handler(exe=ValueError, response="caught") async def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger"): result = await failing_func() - + assert result == "caught" + @pytest.mark.asyncio async def test_unmatched_exception_propagates(self): """Test unmatched exception propagates.""" @error_handler(exe=ValueError, response="caught") async def failing_func(): raise TypeError("Wrong type") - + with pytest.raises(TypeError): await failing_func() + @pytest.mark.asyncio async def test_logs_error_message(self): """Test logs error message.""" @error_handler async def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger") as mock_logger: await failing_func() mock_logger.error.assert_called_once() + @pytest.mark.asyncio async def test_custom_error_message(self): """Test custom error message is logged.""" @error_handler(msg="Custom error message") async def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger") as mock_logger: await failing_func() mock_logger.error.assert_called_once_with("Custom error message") + @pytest.mark.asyncio + async def test_default_error_message_format(self): + """Test default error message includes function name and error.""" + @error_handler + async def my_func(): + raise ValueError("specific error") + + with patch("aiomql.utils.utils.logger") as mock_logger: + await my_func() + call_args = mock_logger.error.call_args[0][0] + assert "my_func" in call_args + assert "specific error" in call_args + + @pytest.mark.asyncio async def test_log_error_msg_false(self): """Test no logging when log_error_msg is False.""" @error_handler(log_error_msg=False) async def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger") as mock_logger: await failing_func() mock_logger.error.assert_not_called() + @pytest.mark.asyncio + async def test_preserves_function_name(self): + """Test decorator preserves original function name via @wraps.""" + @error_handler + async def my_special_func(): + return True + + assert my_special_func.__name__ == "my_special_func" + + @pytest.mark.asyncio + async def test_passes_args_and_kwargs(self): + """Test decorated function receives args and kwargs correctly.""" + @error_handler + async def add(a, b, c=0): + return a + b + c + + result = await add(1, 2, c=3) + assert result == 6 + class TestErrorHandlerSync: """Tests for error_handler_sync decorator.""" @@ -247,7 +354,7 @@ class TestErrorHandlerSync: @error_handler_sync def success_func(): return "success" - + result = success_func() assert result == "success" @@ -256,10 +363,10 @@ class TestErrorHandlerSync: @error_handler_sync(response="default") def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger"): result = failing_func() - + assert result == "default" def test_exception_returns_none_by_default(self): @@ -267,10 +374,10 @@ class TestErrorHandlerSync: @error_handler_sync def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger"): result = failing_func() - + assert result is None def test_custom_exception_type(self): @@ -278,10 +385,10 @@ class TestErrorHandlerSync: @error_handler_sync(exe=ValueError, response="caught") def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger"): result = failing_func() - + assert result == "caught" def test_unmatched_exception_propagates(self): @@ -289,7 +396,7 @@ class TestErrorHandlerSync: @error_handler_sync(exe=ValueError) def failing_func(): raise TypeError("Wrong type") - + with pytest.raises(TypeError): failing_func() @@ -298,21 +405,62 @@ class TestErrorHandlerSync: @error_handler_sync def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger") as mock_logger: failing_func() mock_logger.error.assert_called_once() + def test_custom_error_message(self): + """Test custom error message is logged.""" + @error_handler_sync(msg="Custom sync error") + def failing_func(): + raise ValueError("Test error") + + with patch("aiomql.utils.utils.logger") as mock_logger: + failing_func() + # error_handler_sync uses: f"Error in {func.__name__}: {msg or err}" + call_args = mock_logger.error.call_args[0][0] + assert "Custom sync error" in call_args + + def test_default_error_message_format(self): + """Test default error message includes function name and error.""" + @error_handler_sync + def my_sync_func(): + raise ValueError("specific error") + + with patch("aiomql.utils.utils.logger") as mock_logger: + my_sync_func() + call_args = mock_logger.error.call_args[0][0] + assert "my_sync_func" in call_args + assert "specific error" in call_args + def test_log_error_msg_false(self): """Test no logging when log_error_msg is False.""" @error_handler_sync(log_error_msg=False) def failing_func(): raise ValueError("Test error") - + with patch("aiomql.utils.utils.logger") as mock_logger: failing_func() mock_logger.error.assert_not_called() + def test_preserves_function_name(self): + """Test decorator preserves original function name via @wraps.""" + @error_handler_sync + def my_sync_special_func(): + return True + + assert my_sync_special_func.__name__ == "my_sync_special_func" + + def test_passes_args_and_kwargs(self): + """Test decorated function receives args and kwargs correctly.""" + @error_handler_sync + def add(a, b, c=0): + return a + b + c + + result = add(1, 2, c=3) + assert result == 6 + class TestRoundDown: """Tests for round_down function.""" @@ -337,6 +485,11 @@ class TestRoundDown: assert round_down(3, 5) == 0 assert round_down(9, 10) == 0 + def test_round_down_large_number(self): + """Test rounding down large numbers.""" + assert round_down(997, 100) == 900 + assert round_down(1050, 1000) == 1000 + class TestRoundUp: """Tests for round_up function.""" @@ -361,6 +514,11 @@ class TestRoundUp: assert round_up(1, 5) == 5 assert round_up(1, 10) == 10 + def test_round_up_large_number(self): + """Test rounding up large numbers.""" + assert round_up(901, 100) == 1000 + assert round_up(1001, 1000) == 2000 + class TestRoundOff: """Tests for round_off function.""" @@ -390,78 +548,123 @@ class TestRoundOff: assert round_off(5.5, 1) == 6.0 assert round_off(5.5, 1, round_down=True) == 5.0 + def test_small_step_forex_lot(self): + """Test with very small step (forex lot size precision).""" + assert round_off(0.0123, 0.01) == 0.02 + assert round_off(0.0123, 0.01, round_down=True) == 0.01 + + def test_volume_step(self): + """Test with volume step (common in trading).""" + assert round_off(0.15, 0.1) == 0.2 + assert round_off(0.15, 0.1, round_down=True) == 0.1 + class TestAsyncCache: """Tests for async_cache decorator.""" + @pytest.mark.asyncio async def test_caches_result(self): """Test result is cached.""" call_count = 0 - + @async_cache async def cached_func(): nonlocal call_count call_count += 1 return "result" - + result1 = await cached_func() result2 = await cached_func() - + assert result1 == "result" assert result2 == "result" assert call_count == 1 + @pytest.mark.asyncio async def test_different_args_different_cache(self): """Test different args have different cache entries.""" call_count = 0 - + @async_cache async def cached_func(x): nonlocal call_count call_count += 1 return x * 2 - + result1 = await cached_func(1) result2 = await cached_func(2) result3 = await cached_func(1) # Should be cached - + assert result1 == 2 assert result2 == 4 assert result3 == 2 assert call_count == 2 + @pytest.mark.asyncio async def test_kwargs_in_cache_key(self): """Test kwargs are included in cache key.""" call_count = 0 - + @async_cache async def cached_func(x, y=1): nonlocal call_count call_count += 1 return x + y - + result1 = await cached_func(1, y=2) result2 = await cached_func(1, y=3) result3 = await cached_func(1, y=2) # Should be cached - + assert result1 == 3 assert result2 == 4 assert result3 == 3 assert call_count == 2 + @pytest.mark.asyncio async def test_cache_has_lock(self): """Test cached function has lock attribute.""" @async_cache async def cached_func(): return "result" - + assert hasattr(cached_func, "lock") assert hasattr(cached_func, "cache") + @pytest.mark.asyncio async def test_cache_is_dict(self): """Test cache is a dictionary.""" @async_cache async def cached_func(): return "result" - + assert isinstance(cached_func.cache, dict) + + @pytest.mark.asyncio + async def test_cache_can_be_cleared(self): + """Test cache can be manually cleared.""" + call_count = 0 + + @async_cache + async def cached_func(): + nonlocal call_count + call_count += 1 + return "result" + + await cached_func() + assert call_count == 1 + + # Clear cache + cached_func.cache.clear() + + # Should call function again + await cached_func() + assert call_count == 2 + + @pytest.mark.asyncio + async def test_preserves_function_name(self): + """Test decorator preserves original function name via @wraps.""" + @async_cache + async def my_cached_func(): + return True + + assert my_cached_func.__name__ == "my_cached_func" diff --git a/uv.lock b/uv.lock index 36075bc..a889c06 100644 --- a/uv.lock +++ b/uv.lock @@ -2,8 +2,12 @@ version = 1 revision = 3 requires-python = ">=3.13" resolution-markers = [ - "python_full_version >= '3.14'", - "python_full_version < '3.14'", + "python_full_version >= '3.14' and sys_platform == 'win32'", + "python_full_version >= '3.14' and sys_platform == 'emscripten'", + "python_full_version >= '3.14' and sys_platform != 'emscripten' and sys_platform != 'win32'", + "python_full_version < '3.14' and sys_platform == 'win32'", + "python_full_version < '3.14' and sys_platform == 'emscripten'", + "python_full_version < '3.14' and sys_platform != 'emscripten' and sys_platform != 'win32'", ] [[package]] @@ -13,8 +17,14 @@ source = { virtual = "." } dependencies = [ { name = "metatrader5" }, { name = "mplfinance" }, - { name = "numba" }, { name = "pandas" }, +] + +[package.optional-dependencies] +all = [ + { name = "cython" }, + { name = "numba" }, + { name = "ta-lib" }, { name = "tqdm" }, ] @@ -24,17 +34,19 @@ dev = [ { name = "pandas-stubs" }, { name = "pytest" }, { name = "pytest-asyncio" }, - { name = "ta-lib" }, ] [package.metadata] requires-dist = [ + { name = "cython", marker = "extra == 'all'", specifier = ">=3.2.4" }, { name = "metatrader5", specifier = ">=5.0.5200" }, { name = "mplfinance", specifier = ">=0.12.10b0" }, - { name = "numba", specifier = ">=0.61.2" }, + { name = "numba", marker = "extra == 'all'", specifier = ">=0.64.0" }, { name = "pandas", specifier = ">=2.0.0" }, - { name = "tqdm", specifier = ">=4.67.1" }, + { name = "ta-lib", marker = "extra == 'all'", specifier = ">=0.6.8" }, + { name = "tqdm", marker = "extra == 'all'", specifier = ">=4.67.3" }, ] +provides-extras = ["all"] [package.metadata.requires-dev] dev = [ @@ -42,20 +54,18 @@ dev = [ { name = "pandas-stubs", specifier = ">=3.0.0.260204" }, { name = "pytest", specifier = ">=8.4.1" }, { name = "pytest-asyncio", specifier = ">=1.3.0" }, - { name = "ta-lib", specifier = ">=0.6.8" }, ] [[package]] name = "anyio" -version = "4.10.0" +version = "4.12.1" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "idna" }, - { name = "sniffio" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/f1/b4/636b3b65173d3ce9a38ef5f0522789614e590dab6a8d505340a4efe4c567/anyio-4.10.0.tar.gz", hash = "sha256:3f3fae35c96039744587aa5b8371e7e8e603c0702999535961dd336026973ba6", size = 213252, upload-time = "2025-08-04T08:54:26.451Z" } +sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/6f/12/e5e0282d673bb9746bacfb6e2dba8719989d3660cdb2ea79aee9a9651afb/anyio-4.10.0-py3-none-any.whl", hash = "sha256:60e474ac86736bbfd6f210f7a61218939c318f43f9972497381f1c5e930ed3d1", size = 107213, upload-time = "2025-08-04T08:54:24.882Z" }, + { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" }, ] [[package]] @@ -72,47 +82,19 @@ name = "argon2-cffi" version = "25.1.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "argon2-cffi-bindings", version = "21.2.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.14'" }, - { name = "argon2-cffi-bindings", version = "25.1.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.14'" }, + { name = "argon2-cffi-bindings" }, ] sdist = { url = "https://files.pythonhosted.org/packages/0e/89/ce5af8a7d472a67cc819d5d998aa8c82c5d860608c4db9f46f1162d7dab9/argon2_cffi-25.1.0.tar.gz", hash = "sha256:694ae5cc8a42f4c4e2bf2ca0e64e51e23a040c6a517a85074683d3959e1346c1", size = 45706, upload-time = "2025-06-03T06:55:32.073Z" } wheels = [ { url = "https://files.pythonhosted.org/packages/4f/d3/a8b22fa575b297cd6e3e3b0155c7e25db170edf1c74783d6a31a2490b8d9/argon2_cffi-25.1.0-py3-none-any.whl", hash = "sha256:fdc8b074db390fccb6eb4a3604ae7231f219aa669a2652e0f20e16ba513d5741", size = 14657, upload-time = "2025-06-03T06:55:30.804Z" }, ] -[[package]] -name = "argon2-cffi-bindings" -version = "21.2.0" -source = { registry = "https://pypi.org/simple" } -resolution-markers = [ - "python_full_version >= '3.14'", -] -dependencies = [ - { name = "cffi", marker = "python_full_version >= '3.14'" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/b9/e9/184b8ccce6683b0aa2fbb7ba5683ea4b9c5763f1356347f1312c32e3c66e/argon2-cffi-bindings-21.2.0.tar.gz", hash = "sha256:bb89ceffa6c791807d1305ceb77dbfacc5aa499891d2c55661c6459651fc39e3", size = 1779911, upload-time = "2021-12-01T08:52:55.68Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/d4/13/838ce2620025e9666aa8f686431f67a29052241692a3dd1ae9d3692a89d3/argon2_cffi_bindings-21.2.0-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:ccb949252cb2ab3a08c02024acb77cfb179492d5701c7cbdbfd776124d4d2367", size = 29658, upload-time = "2021-12-01T09:09:17.016Z" }, - { url = "https://files.pythonhosted.org/packages/b3/02/f7f7bb6b6af6031edb11037639c697b912e1dea2db94d436e681aea2f495/argon2_cffi_bindings-21.2.0-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9524464572e12979364b7d600abf96181d3541da11e23ddf565a32e70bd4dc0d", size = 80583, upload-time = "2021-12-01T09:09:19.546Z" }, - { url = "https://files.pythonhosted.org/packages/ec/f7/378254e6dd7ae6f31fe40c8649eea7d4832a42243acaf0f1fff9083b2bed/argon2_cffi_bindings-21.2.0-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b746dba803a79238e925d9046a63aa26bf86ab2a2fe74ce6b009a1c3f5c8f2ae", size = 86168, upload-time = "2021-12-01T09:09:21.445Z" }, - { url = "https://files.pythonhosted.org/packages/74/f6/4a34a37a98311ed73bb80efe422fed95f2ac25a4cacc5ae1d7ae6a144505/argon2_cffi_bindings-21.2.0-cp36-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:58ed19212051f49a523abb1dbe954337dc82d947fb6e5a0da60f7c8471a8476c", size = 82709, upload-time = "2021-12-01T09:09:18.182Z" }, - { url = "https://files.pythonhosted.org/packages/74/2b/73d767bfdaab25484f7e7901379d5f8793cccbb86c6e0cbc4c1b96f63896/argon2_cffi_bindings-21.2.0-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:bd46088725ef7f58b5a1ef7ca06647ebaf0eb4baff7d1d0d177c6cc8744abd86", size = 83613, upload-time = "2021-12-01T09:09:22.741Z" }, - { url = "https://files.pythonhosted.org/packages/4f/fd/37f86deef67ff57c76f137a67181949c2d408077e2e3dd70c6c42912c9bf/argon2_cffi_bindings-21.2.0-cp36-abi3-musllinux_1_1_i686.whl", hash = "sha256:8cd69c07dd875537a824deec19f978e0f2078fdda07fd5c42ac29668dda5f40f", size = 84583, upload-time = "2021-12-01T09:09:24.177Z" }, - { url = "https://files.pythonhosted.org/packages/6f/52/5a60085a3dae8fded8327a4f564223029f5f54b0cb0455a31131b5363a01/argon2_cffi_bindings-21.2.0-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:f1152ac548bd5b8bcecfb0b0371f082037e47128653df2e8ba6e914d384f3c3e", size = 88475, upload-time = "2021-12-01T09:09:26.673Z" }, - { url = "https://files.pythonhosted.org/packages/8b/95/143cd64feb24a15fa4b189a3e1e7efbaeeb00f39a51e99b26fc62fbacabd/argon2_cffi_bindings-21.2.0-cp36-abi3-win32.whl", hash = "sha256:603ca0aba86b1349b147cab91ae970c63118a0f30444d4bc80355937c950c082", size = 27698, upload-time = "2021-12-01T09:09:27.87Z" }, - { url = "https://files.pythonhosted.org/packages/37/2c/e34e47c7dee97ba6f01a6203e0383e15b60fb85d78ac9a15cd066f6fe28b/argon2_cffi_bindings-21.2.0-cp36-abi3-win_amd64.whl", hash = "sha256:b2ef1c30440dbbcba7a5dc3e319408b59676e2e039e2ae11a8775ecf482b192f", size = 30817, upload-time = "2021-12-01T09:09:30.267Z" }, - { url = "https://files.pythonhosted.org/packages/5a/e4/bf8034d25edaa495da3c8a3405627d2e35758e44ff6eaa7948092646fdcc/argon2_cffi_bindings-21.2.0-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:e415e3f62c8d124ee16018e491a009937f8cf7ebf5eb430ffc5de21b900dad93", size = 53104, upload-time = "2021-12-01T09:09:31.335Z" }, -] - [[package]] name = "argon2-cffi-bindings" version = "25.1.0" source = { registry = "https://pypi.org/simple" } -resolution-markers = [ - "python_full_version < '3.14'", -] dependencies = [ - { name = "cffi", marker = "python_full_version < '3.14'" }, + { name = "cffi" }, ] sdist = { url = "https://files.pythonhosted.org/packages/5c/2d/db8af0df73c1cf454f71b2bbe5e356b8c1f8041c979f505b3d3186e520a9/argon2_cffi_bindings-25.1.0.tar.gz", hash = "sha256:b957f3e6ea4d55d820e40ff76f450952807013d361a65d7f28acc0acbf29229d", size = 1783441, upload-time = "2025-07-30T10:02:05.147Z" } wheels = [ @@ -140,76 +122,76 @@ wheels = [ [[package]] name = "arrow" -version = "1.3.0" +version = "1.4.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "python-dateutil" }, - { name = "types-python-dateutil" }, + { name = "tzdata" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/2e/00/0f6e8fcdb23ea632c866620cc872729ff43ed91d284c866b515c6342b173/arrow-1.3.0.tar.gz", hash = "sha256:d4540617648cb5f895730f1ad8c82a65f2dad0166f57b75f3ca54759c4d67a85", size = 131960, upload-time = "2023-09-30T22:11:18.25Z" } +sdist = { url = "https://files.pythonhosted.org/packages/b9/33/032cdc44182491aa708d06a68b62434140d8c50820a087fac7af37703357/arrow-1.4.0.tar.gz", hash = "sha256:ed0cc050e98001b8779e84d461b0098c4ac597e88704a655582b21d116e526d7", size = 152931, upload-time = "2025-10-18T17:46:46.761Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/f8/ed/e97229a566617f2ae958a6b13e7cc0f585470eac730a73e9e82c32a3cdd2/arrow-1.3.0-py3-none-any.whl", hash = "sha256:c728b120ebc00eb84e01882a6f5e7927a53960aa990ce7dd2b10f39005a67f80", size = 66419, upload-time = "2023-09-30T22:11:16.072Z" }, + { url = "https://files.pythonhosted.org/packages/ed/c9/d7977eaacb9df673210491da99e6a247e93df98c715fc43fd136ce1d3d33/arrow-1.4.0-py3-none-any.whl", hash = "sha256:749f0769958ebdc79c173ff0b0670d59051a535fa26e8eba02953dc19eb43205", size = 68797, upload-time = "2025-10-18T17:46:45.663Z" }, ] [[package]] name = "asttokens" -version = "3.0.0" +version = "3.0.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/4a/e7/82da0a03e7ba5141f05cce0d302e6eed121ae055e0456ca228bf693984bc/asttokens-3.0.0.tar.gz", hash = "sha256:0dcd8baa8d62b0c1d118b399b2ddba3c4aff271d0d7a9e0d4c1681c79035bbc7", size = 61978, upload-time = "2024-11-30T04:30:14.439Z" } +sdist = { url = "https://files.pythonhosted.org/packages/be/a5/8e3f9b6771b0b408517c82d97aed8f2036509bc247d46114925e32fe33f0/asttokens-3.0.1.tar.gz", hash = "sha256:71a4ee5de0bde6a31d64f6b13f2293ac190344478f081c3d1bccfcf5eacb0cb7", size = 62308, upload-time = "2025-11-15T16:43:48.578Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/25/8a/c46dcc25341b5bce5472c718902eb3d38600a903b14fa6aeecef3f21a46f/asttokens-3.0.0-py3-none-any.whl", hash = "sha256:e3078351a059199dd5138cb1c706e6430c05eff2ff136af5eb4790f9d28932e2", size = 26918, upload-time = "2024-11-30T04:30:10.946Z" }, + { url = "https://files.pythonhosted.org/packages/d2/39/e7eaf1799466a4aef85b6a4fe7bd175ad2b1c6345066aa33f1f58d4b18d0/asttokens-3.0.1-py3-none-any.whl", hash = "sha256:15a3ebc0f43c2d0a50eeafea25e19046c68398e487b9f1f5b517f7c0f40f976a", size = 27047, upload-time = "2025-11-15T16:43:16.109Z" }, ] [[package]] name = "async-lru" -version = "2.0.5" +version = "2.2.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/b2/4d/71ec4d3939dc755264f680f6c2b4906423a304c3d18e96853f0a595dfe97/async_lru-2.0.5.tar.gz", hash = "sha256:481d52ccdd27275f42c43a928b4a50c3bfb2d67af4e78b170e3e0bb39c66e5bb", size = 10380, upload-time = "2025-03-16T17:25:36.919Z" } +sdist = { url = "https://files.pythonhosted.org/packages/05/8a/ca724066c32a53fa75f59e0f21aa822fdaa8a0dffa112d223634e3caabf9/async_lru-2.2.0.tar.gz", hash = "sha256:80abae2a237dbc6c60861d621619af39f0d920aea306de34cb992c879e01370c", size = 14654, upload-time = "2026-02-20T19:11:43.848Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/03/49/d10027df9fce941cb8184e78a02857af36360d33e1721df81c5ed2179a1a/async_lru-2.0.5-py3-none-any.whl", hash = "sha256:ab95404d8d2605310d345932697371a5f40def0487c03d6d0ad9138de52c9943", size = 6069, upload-time = "2025-03-16T17:25:35.422Z" }, + { url = "https://files.pythonhosted.org/packages/13/5c/af990f019b8dd11c5492a6371fe74a5b0276357370030b67254a87329944/async_lru-2.2.0-py3-none-any.whl", hash = "sha256:e2c1cf731eba202b59c5feedaef14ffd9d02ad0037fcda64938699f2c380eafe", size = 7890, upload-time = "2026-02-20T19:11:42.273Z" }, ] [[package]] name = "attrs" -version = "25.3.0" +version = "25.4.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/5a/b0/1367933a8532ee6ff8d63537de4f1177af4bff9f3e829baf7331f595bb24/attrs-25.3.0.tar.gz", hash = "sha256:75d7cefc7fb576747b2c81b4442d4d4a1ce0900973527c011d1030fd3bf4af1b", size = 812032, upload-time = "2025-03-13T11:10:22.779Z" } +sdist = { url = "https://files.pythonhosted.org/packages/6b/5c/685e6633917e101e5dcb62b9dd76946cbb57c26e133bae9e0cd36033c0a9/attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11", size = 934251, upload-time = "2025-10-06T13:54:44.725Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/77/06/bb80f5f86020c4551da315d78b3ab75e8228f89f0162f2c3a819e407941a/attrs-25.3.0-py3-none-any.whl", hash = "sha256:427318ce031701fea540783410126f03899a97ffc6f61596ad581ac2e40e3bc3", size = 63815, upload-time = "2025-03-13T11:10:21.14Z" }, + { url = "https://files.pythonhosted.org/packages/3a/2a/7cc015f5b9f5db42b7d48157e23356022889fc354a2813c15934b7cb5c0e/attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373", size = 67615, upload-time = "2025-10-06T13:54:43.17Z" }, ] [[package]] name = "babel" -version = "2.17.0" +version = "2.18.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/7d/6b/d52e42361e1aa00709585ecc30b3f9684b3ab62530771402248b1b1d6240/babel-2.17.0.tar.gz", hash = "sha256:0c54cffb19f690cdcc52a3b50bcbf71e07a808d1c80d549f2459b9d2cf0afb9d", size = 9951852, upload-time = "2025-02-01T15:17:41.026Z" } +sdist = { url = "https://files.pythonhosted.org/packages/7d/b2/51899539b6ceeeb420d40ed3cd4b7a40519404f9baf3d4ac99dc413a834b/babel-2.18.0.tar.gz", hash = "sha256:b80b99a14bd085fcacfa15c9165f651fbb3406e66cc603abf11c5750937c992d", size = 9959554, upload-time = "2026-02-01T12:30:56.078Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/b7/b8/3fe70c75fe32afc4bb507f75563d39bc5642255d1d94f1f23604725780bf/babel-2.17.0-py3-none-any.whl", hash = "sha256:4d0b53093fdfb4b21c92b5213dba5a1b23885afa8383709427046b21c366e5f2", size = 10182537, upload-time = "2025-02-01T15:17:37.39Z" }, + { url = "https://files.pythonhosted.org/packages/77/f5/21d2de20e8b8b0408f0681956ca2c69f1320a3848ac50e6e7f39c6159675/babel-2.18.0-py3-none-any.whl", hash = "sha256:e2b422b277c2b9a9630c1d7903c2a00d0830c409c59ac8cae9081c92f1aeba35", size = 10196845, upload-time = "2026-02-01T12:30:53.445Z" }, ] [[package]] name = "beautifulsoup4" -version = "4.13.4" +version = "4.14.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "soupsieve" }, { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/d8/e4/0c4c39e18fd76d6a628d4dd8da40543d136ce2d1752bd6eeeab0791f4d6b/beautifulsoup4-4.13.4.tar.gz", hash = "sha256:dbb3c4e1ceae6aefebdaf2423247260cd062430a410e38c66f2baa50a8437195", size = 621067, upload-time = "2025-04-15T17:05:13.836Z" } +sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737, upload-time = "2025-11-30T15:08:26.084Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/50/cd/30110dc0ffcf3b131156077b90e9f60ed75711223f306da4db08eff8403b/beautifulsoup4-4.13.4-py3-none-any.whl", hash = "sha256:9bbbb14bfde9d79f38b8cd5f8c7c85f4b8f2523190ebed90e950a8dea4cb1c4b", size = 187285, upload-time = "2025-04-15T17:05:12.221Z" }, + { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721, upload-time = "2025-11-30T15:08:24.087Z" }, ] [[package]] name = "bleach" -version = "6.2.0" +version = "6.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "webencodings" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/76/9a/0e33f5054c54d349ea62c277191c020c2d6ef1d65ab2cb1993f91ec846d1/bleach-6.2.0.tar.gz", hash = "sha256:123e894118b8a599fd80d3ec1a6d4cc7ce4e5882b1317a7e1ba69b56e95f991f", size = 203083, upload-time = "2024-10-29T18:30:40.477Z" } +sdist = { url = "https://files.pythonhosted.org/packages/07/18/3c8523962314be6bf4c8989c79ad9531c825210dd13a8669f6b84336e8bd/bleach-6.3.0.tar.gz", hash = "sha256:6f3b91b1c0a02bb9a78b5a454c92506aa0fdf197e1d5e114d2e00c6f64306d22", size = 203533, upload-time = "2025-10-27T17:57:39.211Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fc/55/96142937f66150805c25c4d0f31ee4132fd33497753400734f9dfdcbdc66/bleach-6.2.0-py3-none-any.whl", hash = "sha256:117d9c6097a7c3d22fd578fcd8d35ff1e125df6736f554da4e432fdd63f31e5e", size = 163406, upload-time = "2024-10-29T18:30:38.186Z" }, + { url = "https://files.pythonhosted.org/packages/cd/3a/577b549de0cc09d95f11087ee63c739bba856cd3952697eec4c4bb91350a/bleach-6.3.0-py3-none-any.whl", hash = "sha256:fe10ec77c93ddf3d13a73b035abaac7a9f5e436513864ccdad516693213c65d6", size = 164437, upload-time = "2025-10-27T17:57:37.538Z" }, ] [package.optional-dependencies] @@ -233,64 +215,97 @@ wheels = [ [[package]] name = "certifi" -version = "2025.8.3" +version = "2026.1.4" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/dc/67/960ebe6bf230a96cda2e0abcf73af550ec4f090005363542f0765df162e0/certifi-2025.8.3.tar.gz", hash = "sha256:e564105f78ded564e3ae7c923924435e1daa7463faeab5bb932bc53ffae63407", size = 162386, upload-time = "2025-08-03T03:07:47.08Z" } +sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/e5/48/1549795ba7742c948d2ad169c1c8cdbae65bc450d6cd753d124b17c8cd32/certifi-2025.8.3-py3-none-any.whl", hash = "sha256:f6c12493cfb1b06ba2ff328595af9350c65d6644968e5d3a2ffd78699af217a5", size = 161216, upload-time = "2025-08-03T03:07:45.777Z" }, + { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" }, ] [[package]] name = "cffi" -version = "1.17.1" +version = "2.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "pycparser" }, + { name = "pycparser", marker = "implementation_name != 'PyPy'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/fc/97/c783634659c2920c3fc70419e3af40972dbaf758daa229a7d6ea6135c90d/cffi-1.17.1.tar.gz", hash = "sha256:1c39c6016c32bc48dd54561950ebd6836e1670f2ae46128f67cf49e789c52824", size = 516621, upload-time = "2024-09-04T20:45:21.852Z" } +sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/8d/f8/dd6c246b148639254dad4d6803eb6a54e8c85c6e11ec9df2cffa87571dbe/cffi-1.17.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f3a2b4222ce6b60e2e8b337bb9596923045681d71e5a082783484d845390938e", size = 182989, upload-time = "2024-09-04T20:44:28.956Z" }, - { url = "https://files.pythonhosted.org/packages/8b/f1/672d303ddf17c24fc83afd712316fda78dc6fce1cd53011b839483e1ecc8/cffi-1.17.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:0984a4925a435b1da406122d4d7968dd861c1385afe3b45ba82b750f229811e2", size = 178802, upload-time = "2024-09-04T20:44:30.289Z" }, - { url = "https://files.pythonhosted.org/packages/0e/2d/eab2e858a91fdff70533cab61dcff4a1f55ec60425832ddfdc9cd36bc8af/cffi-1.17.1-cp313-cp313-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d01b12eeeb4427d3110de311e1774046ad344f5b1a7403101878976ecd7a10f3", size = 454792, upload-time = "2024-09-04T20:44:32.01Z" }, - { url = "https://files.pythonhosted.org/packages/75/b2/fbaec7c4455c604e29388d55599b99ebcc250a60050610fadde58932b7ee/cffi-1.17.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:706510fe141c86a69c8ddc029c7910003a17353970cff3b904ff0686a5927683", size = 478893, upload-time = "2024-09-04T20:44:33.606Z" }, - { url = "https://files.pythonhosted.org/packages/4f/b7/6e4a2162178bf1935c336d4da8a9352cccab4d3a5d7914065490f08c0690/cffi-1.17.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:de55b766c7aa2e2a3092c51e0483d700341182f08e67c63630d5b6f200bb28e5", size = 485810, upload-time = "2024-09-04T20:44:35.191Z" }, - { url = "https://files.pythonhosted.org/packages/c7/8a/1d0e4a9c26e54746dc08c2c6c037889124d4f59dffd853a659fa545f1b40/cffi-1.17.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c59d6e989d07460165cc5ad3c61f9fd8f1b4796eacbd81cee78957842b834af4", size = 471200, upload-time = "2024-09-04T20:44:36.743Z" }, - { url = "https://files.pythonhosted.org/packages/26/9f/1aab65a6c0db35f43c4d1b4f580e8df53914310afc10ae0397d29d697af4/cffi-1.17.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dd398dbc6773384a17fe0d3e7eeb8d1a21c2200473ee6806bb5e6a8e62bb73dd", size = 479447, upload-time = "2024-09-04T20:44:38.492Z" }, - { url = "https://files.pythonhosted.org/packages/5f/e4/fb8b3dd8dc0e98edf1135ff067ae070bb32ef9d509d6cb0f538cd6f7483f/cffi-1.17.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:3edc8d958eb099c634dace3c7e16560ae474aa3803a5df240542b305d14e14ed", size = 484358, upload-time = "2024-09-04T20:44:40.046Z" }, - { url = "https://files.pythonhosted.org/packages/f1/47/d7145bf2dc04684935d57d67dff9d6d795b2ba2796806bb109864be3a151/cffi-1.17.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:72e72408cad3d5419375fc87d289076ee319835bdfa2caad331e377589aebba9", size = 488469, upload-time = "2024-09-04T20:44:41.616Z" }, - { url = "https://files.pythonhosted.org/packages/bf/ee/f94057fa6426481d663b88637a9a10e859e492c73d0384514a17d78ee205/cffi-1.17.1-cp313-cp313-win32.whl", hash = "sha256:e03eab0a8677fa80d646b5ddece1cbeaf556c313dcfac435ba11f107ba117b5d", size = 172475, upload-time = "2024-09-04T20:44:43.733Z" }, - { url = "https://files.pythonhosted.org/packages/7c/fc/6a8cb64e5f0324877d503c854da15d76c1e50eb722e320b15345c4d0c6de/cffi-1.17.1-cp313-cp313-win_amd64.whl", hash = "sha256:f6a16c31041f09ead72d69f583767292f750d24913dadacf5756b966aacb3f1a", size = 182009, upload-time = "2024-09-04T20:44:45.309Z" }, + { url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" }, + { url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" }, + { url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" }, + { url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" }, + { url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" }, + { url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" }, + { url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" }, + { url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" }, + { url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" }, + { url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" }, + { url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" }, + { url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" }, + { url = "https://files.pythonhosted.org/packages/92/c4/3ce07396253a83250ee98564f8d7e9789fab8e58858f35d07a9a2c78de9f/cffi-2.0.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fc33c5141b55ed366cfaad382df24fe7dcbc686de5be719b207bb248e3053dc5", size = 185320, upload-time = "2025-09-08T23:23:18.087Z" }, + { url = "https://files.pythonhosted.org/packages/59/dd/27e9fa567a23931c838c6b02d0764611c62290062a6d4e8ff7863daf9730/cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c654de545946e0db659b3400168c9ad31b5d29593291482c43e3564effbcee13", size = 181487, upload-time = "2025-09-08T23:23:19.622Z" }, + { url = "https://files.pythonhosted.org/packages/d6/43/0e822876f87ea8a4ef95442c3d766a06a51fc5298823f884ef87aaad168c/cffi-2.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:24b6f81f1983e6df8db3adc38562c83f7d4a0c36162885ec7f7b77c7dcbec97b", size = 220049, upload-time = "2025-09-08T23:23:20.853Z" }, + { url = "https://files.pythonhosted.org/packages/b4/89/76799151d9c2d2d1ead63c2429da9ea9d7aac304603de0c6e8764e6e8e70/cffi-2.0.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:12873ca6cb9b0f0d3a0da705d6086fe911591737a59f28b7936bdfed27c0d47c", size = 207793, upload-time = "2025-09-08T23:23:22.08Z" }, + { url = "https://files.pythonhosted.org/packages/bb/dd/3465b14bb9e24ee24cb88c9e3730f6de63111fffe513492bf8c808a3547e/cffi-2.0.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:d9b97165e8aed9272a6bb17c01e3cc5871a594a446ebedc996e2397a1c1ea8ef", size = 206300, upload-time = "2025-09-08T23:23:23.314Z" }, + { url = "https://files.pythonhosted.org/packages/47/d9/d83e293854571c877a92da46fdec39158f8d7e68da75bf73581225d28e90/cffi-2.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:afb8db5439b81cf9c9d0c80404b60c3cc9c3add93e114dcae767f1477cb53775", size = 219244, upload-time = "2025-09-08T23:23:24.541Z" }, + { url = "https://files.pythonhosted.org/packages/2b/0f/1f177e3683aead2bb00f7679a16451d302c436b5cbf2505f0ea8146ef59e/cffi-2.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:737fe7d37e1a1bffe70bd5754ea763a62a066dc5913ca57e957824b72a85e205", size = 222828, upload-time = "2025-09-08T23:23:26.143Z" }, + { url = "https://files.pythonhosted.org/packages/c6/0f/cafacebd4b040e3119dcb32fed8bdef8dfe94da653155f9d0b9dc660166e/cffi-2.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:38100abb9d1b1435bc4cc340bb4489635dc2f0da7456590877030c9b3d40b0c1", size = 220926, upload-time = "2025-09-08T23:23:27.873Z" }, + { url = "https://files.pythonhosted.org/packages/3e/aa/df335faa45b395396fcbc03de2dfcab242cd61a9900e914fe682a59170b1/cffi-2.0.0-cp314-cp314-win32.whl", hash = "sha256:087067fa8953339c723661eda6b54bc98c5625757ea62e95eb4898ad5e776e9f", size = 175328, upload-time = "2025-09-08T23:23:44.61Z" }, + { url = "https://files.pythonhosted.org/packages/bb/92/882c2d30831744296ce713f0feb4c1cd30f346ef747b530b5318715cc367/cffi-2.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:203a48d1fb583fc7d78a4c6655692963b860a417c0528492a6bc21f1aaefab25", size = 185650, upload-time = "2025-09-08T23:23:45.848Z" }, + { url = "https://files.pythonhosted.org/packages/9f/2c/98ece204b9d35a7366b5b2c6539c350313ca13932143e79dc133ba757104/cffi-2.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:dbd5c7a25a7cb98f5ca55d258b103a2054f859a46ae11aaf23134f9cc0d356ad", size = 180687, upload-time = "2025-09-08T23:23:47.105Z" }, + { url = "https://files.pythonhosted.org/packages/3e/61/c768e4d548bfa607abcda77423448df8c471f25dbe64fb2ef6d555eae006/cffi-2.0.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:9a67fc9e8eb39039280526379fb3a70023d77caec1852002b4da7e8b270c4dd9", size = 188773, upload-time = "2025-09-08T23:23:29.347Z" }, + { url = "https://files.pythonhosted.org/packages/2c/ea/5f76bce7cf6fcd0ab1a1058b5af899bfbef198bea4d5686da88471ea0336/cffi-2.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7a66c7204d8869299919db4d5069a82f1561581af12b11b3c9f48c584eb8743d", size = 185013, upload-time = "2025-09-08T23:23:30.63Z" }, + { url = "https://files.pythonhosted.org/packages/be/b4/c56878d0d1755cf9caa54ba71e5d049479c52f9e4afc230f06822162ab2f/cffi-2.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7cc09976e8b56f8cebd752f7113ad07752461f48a58cbba644139015ac24954c", size = 221593, upload-time = "2025-09-08T23:23:31.91Z" }, + { url = "https://files.pythonhosted.org/packages/e0/0d/eb704606dfe8033e7128df5e90fee946bbcb64a04fcdaa97321309004000/cffi-2.0.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:92b68146a71df78564e4ef48af17551a5ddd142e5190cdf2c5624d0c3ff5b2e8", size = 209354, upload-time = "2025-09-08T23:23:33.214Z" }, + { url = "https://files.pythonhosted.org/packages/d8/19/3c435d727b368ca475fb8742ab97c9cb13a0de600ce86f62eab7fa3eea60/cffi-2.0.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b1e74d11748e7e98e2f426ab176d4ed720a64412b6a15054378afdb71e0f37dc", size = 208480, upload-time = "2025-09-08T23:23:34.495Z" }, + { url = "https://files.pythonhosted.org/packages/d0/44/681604464ed9541673e486521497406fadcc15b5217c3e326b061696899a/cffi-2.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:28a3a209b96630bca57cce802da70c266eb08c6e97e5afd61a75611ee6c64592", size = 221584, upload-time = "2025-09-08T23:23:36.096Z" }, + { url = "https://files.pythonhosted.org/packages/25/8e/342a504ff018a2825d395d44d63a767dd8ebc927ebda557fecdaca3ac33a/cffi-2.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7553fb2090d71822f02c629afe6042c299edf91ba1bf94951165613553984512", size = 224443, upload-time = "2025-09-08T23:23:37.328Z" }, + { url = "https://files.pythonhosted.org/packages/e1/5e/b666bacbbc60fbf415ba9988324a132c9a7a0448a9a8f125074671c0f2c3/cffi-2.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6c6c373cfc5c83a975506110d17457138c8c63016b563cc9ed6e056a82f13ce4", size = 223437, upload-time = "2025-09-08T23:23:38.945Z" }, + { url = "https://files.pythonhosted.org/packages/a0/1d/ec1a60bd1a10daa292d3cd6bb0b359a81607154fb8165f3ec95fe003b85c/cffi-2.0.0-cp314-cp314t-win32.whl", hash = "sha256:1fc9ea04857caf665289b7a75923f2c6ed559b8298a1b8c49e59f7dd95c8481e", size = 180487, upload-time = "2025-09-08T23:23:40.423Z" }, + { url = "https://files.pythonhosted.org/packages/bf/41/4c1168c74fac325c0c8156f04b6749c8b6a8f405bbf91413ba088359f60d/cffi-2.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d68b6cef7827e8641e8ef16f4494edda8b36104d79773a334beaa1e3521430f6", size = 191726, upload-time = "2025-09-08T23:23:41.742Z" }, + { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" }, ] [[package]] name = "charset-normalizer" -version = "3.4.3" +version = "3.4.4" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/83/2d/5fd176ceb9b2fc619e63405525573493ca23441330fcdaee6bef9460e924/charset_normalizer-3.4.3.tar.gz", hash = "sha256:6fce4b8500244f6fcb71465d4a4930d132ba9ab8e71a7859e6a5d59851068d14", size = 122371, upload-time = "2025-08-09T07:57:28.46Z" } +sdist = { url = "https://files.pythonhosted.org/packages/13/69/33ddede1939fdd074bce5434295f38fae7136463422fe4fd3e0e89b98062/charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a", size = 129418, upload-time = "2025-10-14T04:42:32.879Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/65/ca/2135ac97709b400c7654b4b764daf5c5567c2da45a30cdd20f9eefe2d658/charset_normalizer-3.4.3-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:14c2a87c65b351109f6abfc424cab3927b3bdece6f706e4d12faaf3d52ee5efe", size = 205326, upload-time = "2025-08-09T07:56:24.721Z" }, - { url = "https://files.pythonhosted.org/packages/71/11/98a04c3c97dd34e49c7d247083af03645ca3730809a5509443f3c37f7c99/charset_normalizer-3.4.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:41d1fc408ff5fdfb910200ec0e74abc40387bccb3252f3f27c0676731df2b2c8", size = 146008, upload-time = "2025-08-09T07:56:26.004Z" }, - { url = "https://files.pythonhosted.org/packages/60/f5/4659a4cb3c4ec146bec80c32d8bb16033752574c20b1252ee842a95d1a1e/charset_normalizer-3.4.3-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1bb60174149316da1c35fa5233681f7c0f9f514509b8e399ab70fea5f17e45c9", size = 159196, upload-time = "2025-08-09T07:56:27.25Z" }, - { url = "https://files.pythonhosted.org/packages/86/9e/f552f7a00611f168b9a5865a1414179b2c6de8235a4fa40189f6f79a1753/charset_normalizer-3.4.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:30d006f98569de3459c2fc1f2acde170b7b2bd265dc1943e87e1a4efe1b67c31", size = 156819, upload-time = "2025-08-09T07:56:28.515Z" }, - { url = "https://files.pythonhosted.org/packages/7e/95/42aa2156235cbc8fa61208aded06ef46111c4d3f0de233107b3f38631803/charset_normalizer-3.4.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:416175faf02e4b0810f1f38bcb54682878a4af94059a1cd63b8747244420801f", size = 151350, upload-time = "2025-08-09T07:56:29.716Z" }, - { url = "https://files.pythonhosted.org/packages/c2/a9/3865b02c56f300a6f94fc631ef54f0a8a29da74fb45a773dfd3dcd380af7/charset_normalizer-3.4.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6aab0f181c486f973bc7262a97f5aca3ee7e1437011ef0c2ec04b5a11d16c927", size = 148644, upload-time = "2025-08-09T07:56:30.984Z" }, - { url = "https://files.pythonhosted.org/packages/77/d9/cbcf1a2a5c7d7856f11e7ac2d782aec12bdfea60d104e60e0aa1c97849dc/charset_normalizer-3.4.3-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:fdabf8315679312cfa71302f9bd509ded4f2f263fb5b765cf1433b39106c3cc9", size = 160468, upload-time = "2025-08-09T07:56:32.252Z" }, - { url = "https://files.pythonhosted.org/packages/f6/42/6f45efee8697b89fda4d50580f292b8f7f9306cb2971d4b53f8914e4d890/charset_normalizer-3.4.3-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:bd28b817ea8c70215401f657edef3a8aa83c29d447fb0b622c35403780ba11d5", size = 158187, upload-time = "2025-08-09T07:56:33.481Z" }, - { url = "https://files.pythonhosted.org/packages/70/99/f1c3bdcfaa9c45b3ce96f70b14f070411366fa19549c1d4832c935d8e2c3/charset_normalizer-3.4.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:18343b2d246dc6761a249ba1fb13f9ee9a2bcd95decc767319506056ea4ad4dc", size = 152699, upload-time = "2025-08-09T07:56:34.739Z" }, - { url = "https://files.pythonhosted.org/packages/a3/ad/b0081f2f99a4b194bcbb1934ef3b12aa4d9702ced80a37026b7607c72e58/charset_normalizer-3.4.3-cp313-cp313-win32.whl", hash = "sha256:6fb70de56f1859a3f71261cbe41005f56a7842cc348d3aeb26237560bfa5e0ce", size = 99580, upload-time = "2025-08-09T07:56:35.981Z" }, - { url = "https://files.pythonhosted.org/packages/9a/8f/ae790790c7b64f925e5c953b924aaa42a243fb778fed9e41f147b2a5715a/charset_normalizer-3.4.3-cp313-cp313-win_amd64.whl", hash = "sha256:cf1ebb7d78e1ad8ec2a8c4732c7be2e736f6e5123a4146c5b89c9d1f585f8cef", size = 107366, upload-time = "2025-08-09T07:56:37.339Z" }, - { url = "https://files.pythonhosted.org/packages/8e/91/b5a06ad970ddc7a0e513112d40113e834638f4ca1120eb727a249fb2715e/charset_normalizer-3.4.3-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3cd35b7e8aedeb9e34c41385fda4f73ba609e561faedfae0a9e75e44ac558a15", size = 204342, upload-time = "2025-08-09T07:56:38.687Z" }, - { url = "https://files.pythonhosted.org/packages/ce/ec/1edc30a377f0a02689342f214455c3f6c2fbedd896a1d2f856c002fc3062/charset_normalizer-3.4.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b89bc04de1d83006373429975f8ef9e7932534b8cc9ca582e4db7d20d91816db", size = 145995, upload-time = "2025-08-09T07:56:40.048Z" }, - { url = "https://files.pythonhosted.org/packages/17/e5/5e67ab85e6d22b04641acb5399c8684f4d37caf7558a53859f0283a650e9/charset_normalizer-3.4.3-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2001a39612b241dae17b4687898843f254f8748b796a2e16f1051a17078d991d", size = 158640, upload-time = "2025-08-09T07:56:41.311Z" }, - { url = "https://files.pythonhosted.org/packages/f1/e5/38421987f6c697ee3722981289d554957c4be652f963d71c5e46a262e135/charset_normalizer-3.4.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8dcfc373f888e4fb39a7bc57e93e3b845e7f462dacc008d9749568b1c4ece096", size = 156636, upload-time = "2025-08-09T07:56:43.195Z" }, - { url = "https://files.pythonhosted.org/packages/a0/e4/5a075de8daa3ec0745a9a3b54467e0c2967daaaf2cec04c845f73493e9a1/charset_normalizer-3.4.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:18b97b8404387b96cdbd30ad660f6407799126d26a39ca65729162fd810a99aa", size = 150939, upload-time = "2025-08-09T07:56:44.819Z" }, - { url = "https://files.pythonhosted.org/packages/02/f7/3611b32318b30974131db62b4043f335861d4d9b49adc6d57c1149cc49d4/charset_normalizer-3.4.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ccf600859c183d70eb47e05a44cd80a4ce77394d1ac0f79dbd2dd90a69a3a049", size = 148580, upload-time = "2025-08-09T07:56:46.684Z" }, - { url = "https://files.pythonhosted.org/packages/7e/61/19b36f4bd67f2793ab6a99b979b4e4f3d8fc754cbdffb805335df4337126/charset_normalizer-3.4.3-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:53cd68b185d98dde4ad8990e56a58dea83a4162161b1ea9272e5c9182ce415e0", size = 159870, upload-time = "2025-08-09T07:56:47.941Z" }, - { url = "https://files.pythonhosted.org/packages/06/57/84722eefdd338c04cf3030ada66889298eaedf3e7a30a624201e0cbe424a/charset_normalizer-3.4.3-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:30a96e1e1f865f78b030d65241c1ee850cdf422d869e9028e2fc1d5e4db73b92", size = 157797, upload-time = "2025-08-09T07:56:49.756Z" }, - { url = "https://files.pythonhosted.org/packages/72/2a/aff5dd112b2f14bcc3462c312dce5445806bfc8ab3a7328555da95330e4b/charset_normalizer-3.4.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:d716a916938e03231e86e43782ca7878fb602a125a91e7acb8b5112e2e96ac16", size = 152224, upload-time = "2025-08-09T07:56:51.369Z" }, - { url = "https://files.pythonhosted.org/packages/b7/8c/9839225320046ed279c6e839d51f028342eb77c91c89b8ef2549f951f3ec/charset_normalizer-3.4.3-cp314-cp314-win32.whl", hash = "sha256:c6dbd0ccdda3a2ba7c2ecd9d77b37f3b5831687d8dc1b6ca5f56a4880cc7b7ce", size = 100086, upload-time = "2025-08-09T07:56:52.722Z" }, - { url = "https://files.pythonhosted.org/packages/ee/7a/36fbcf646e41f710ce0a563c1c9a343c6edf9be80786edeb15b6f62e17db/charset_normalizer-3.4.3-cp314-cp314-win_amd64.whl", hash = "sha256:73dc19b562516fc9bcf6e5d6e596df0b4eb98d87e4f79f3ae71840e6ed21361c", size = 107400, upload-time = "2025-08-09T07:56:55.172Z" }, - { url = "https://files.pythonhosted.org/packages/8a/1f/f041989e93b001bc4e44bb1669ccdcf54d3f00e628229a85b08d330615c5/charset_normalizer-3.4.3-py3-none-any.whl", hash = "sha256:ce571ab16d890d23b5c278547ba694193a45011ff86a9162a71307ed9f86759a", size = 53175, upload-time = "2025-08-09T07:57:26.864Z" }, + { url = "https://files.pythonhosted.org/packages/97/45/4b3a1239bbacd321068ea6e7ac28875b03ab8bc0aa0966452db17cd36714/charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794", size = 208091, upload-time = "2025-10-14T04:41:13.346Z" }, + { url = "https://files.pythonhosted.org/packages/7d/62/73a6d7450829655a35bb88a88fca7d736f9882a27eacdca2c6d505b57e2e/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed", size = 147936, upload-time = "2025-10-14T04:41:14.461Z" }, + { url = "https://files.pythonhosted.org/packages/89/c5/adb8c8b3d6625bef6d88b251bbb0d95f8205831b987631ab0c8bb5d937c2/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72", size = 144180, upload-time = "2025-10-14T04:41:15.588Z" }, + { url = "https://files.pythonhosted.org/packages/91/ed/9706e4070682d1cc219050b6048bfd293ccf67b3d4f5a4f39207453d4b99/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328", size = 161346, upload-time = "2025-10-14T04:41:16.738Z" }, + { url = "https://files.pythonhosted.org/packages/d5/0d/031f0d95e4972901a2f6f09ef055751805ff541511dc1252ba3ca1f80cf5/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede", size = 158874, upload-time = "2025-10-14T04:41:17.923Z" }, + { url = "https://files.pythonhosted.org/packages/f5/83/6ab5883f57c9c801ce5e5677242328aa45592be8a00644310a008d04f922/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894", size = 153076, upload-time = "2025-10-14T04:41:19.106Z" }, + { url = "https://files.pythonhosted.org/packages/75/1e/5ff781ddf5260e387d6419959ee89ef13878229732732ee73cdae01800f2/charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1", size = 150601, upload-time = "2025-10-14T04:41:20.245Z" }, + { url = "https://files.pythonhosted.org/packages/d7/57/71be810965493d3510a6ca79b90c19e48696fb1ff964da319334b12677f0/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490", size = 150376, upload-time = "2025-10-14T04:41:21.398Z" }, + { url = "https://files.pythonhosted.org/packages/e5/d5/c3d057a78c181d007014feb7e9f2e65905a6c4ef182c0ddf0de2924edd65/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44", size = 144825, upload-time = "2025-10-14T04:41:22.583Z" }, + { url = "https://files.pythonhosted.org/packages/e6/8c/d0406294828d4976f275ffbe66f00266c4b3136b7506941d87c00cab5272/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133", size = 162583, upload-time = "2025-10-14T04:41:23.754Z" }, + { url = "https://files.pythonhosted.org/packages/d7/24/e2aa1f18c8f15c4c0e932d9287b8609dd30ad56dbe41d926bd846e22fb8d/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3", size = 150366, upload-time = "2025-10-14T04:41:25.27Z" }, + { url = "https://files.pythonhosted.org/packages/e4/5b/1e6160c7739aad1e2df054300cc618b06bf784a7a164b0f238360721ab86/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e", size = 160300, upload-time = "2025-10-14T04:41:26.725Z" }, + { url = "https://files.pythonhosted.org/packages/7a/10/f882167cd207fbdd743e55534d5d9620e095089d176d55cb22d5322f2afd/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc", size = 154465, upload-time = "2025-10-14T04:41:28.322Z" }, + { url = "https://files.pythonhosted.org/packages/89/66/c7a9e1b7429be72123441bfdbaf2bc13faab3f90b933f664db506dea5915/charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac", size = 99404, upload-time = "2025-10-14T04:41:29.95Z" }, + { url = "https://files.pythonhosted.org/packages/c4/26/b9924fa27db384bdcd97ab83b4f0a8058d96ad9626ead570674d5e737d90/charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14", size = 107092, upload-time = "2025-10-14T04:41:31.188Z" }, + { url = "https://files.pythonhosted.org/packages/af/8f/3ed4bfa0c0c72a7ca17f0380cd9e4dd842b09f664e780c13cff1dcf2ef1b/charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2", size = 100408, upload-time = "2025-10-14T04:41:32.624Z" }, + { url = "https://files.pythonhosted.org/packages/2a/35/7051599bd493e62411d6ede36fd5af83a38f37c4767b92884df7301db25d/charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd", size = 207746, upload-time = "2025-10-14T04:41:33.773Z" }, + { url = "https://files.pythonhosted.org/packages/10/9a/97c8d48ef10d6cd4fcead2415523221624bf58bcf68a802721a6bc807c8f/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb", size = 147889, upload-time = "2025-10-14T04:41:34.897Z" }, + { url = "https://files.pythonhosted.org/packages/10/bf/979224a919a1b606c82bd2c5fa49b5c6d5727aa47b4312bb27b1734f53cd/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e", size = 143641, upload-time = "2025-10-14T04:41:36.116Z" }, + { url = "https://files.pythonhosted.org/packages/ba/33/0ad65587441fc730dc7bd90e9716b30b4702dc7b617e6ba4997dc8651495/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14", size = 160779, upload-time = "2025-10-14T04:41:37.229Z" }, + { url = "https://files.pythonhosted.org/packages/67/ed/331d6b249259ee71ddea93f6f2f0a56cfebd46938bde6fcc6f7b9a3d0e09/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191", size = 159035, upload-time = "2025-10-14T04:41:38.368Z" }, + { url = "https://files.pythonhosted.org/packages/67/ff/f6b948ca32e4f2a4576aa129d8bed61f2e0543bf9f5f2b7fc3758ed005c9/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838", size = 152542, upload-time = "2025-10-14T04:41:39.862Z" }, + { url = "https://files.pythonhosted.org/packages/16/85/276033dcbcc369eb176594de22728541a925b2632f9716428c851b149e83/charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6", size = 149524, upload-time = "2025-10-14T04:41:41.319Z" }, + { url = "https://files.pythonhosted.org/packages/9e/f2/6a2a1f722b6aba37050e626530a46a68f74e63683947a8acff92569f979a/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e", size = 150395, upload-time = "2025-10-14T04:41:42.539Z" }, + { url = "https://files.pythonhosted.org/packages/60/bb/2186cb2f2bbaea6338cad15ce23a67f9b0672929744381e28b0592676824/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c", size = 143680, upload-time = "2025-10-14T04:41:43.661Z" }, + { url = "https://files.pythonhosted.org/packages/7d/a5/bf6f13b772fbb2a90360eb620d52ed8f796f3c5caee8398c3b2eb7b1c60d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090", size = 162045, upload-time = "2025-10-14T04:41:44.821Z" }, + { url = "https://files.pythonhosted.org/packages/df/c5/d1be898bf0dc3ef9030c3825e5d3b83f2c528d207d246cbabe245966808d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152", size = 149687, upload-time = "2025-10-14T04:41:46.442Z" }, + { url = "https://files.pythonhosted.org/packages/a5/42/90c1f7b9341eef50c8a1cb3f098ac43b0508413f33affd762855f67a410e/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828", size = 160014, upload-time = "2025-10-14T04:41:47.631Z" }, + { url = "https://files.pythonhosted.org/packages/76/be/4d3ee471e8145d12795ab655ece37baed0929462a86e72372fd25859047c/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec", size = 154044, upload-time = "2025-10-14T04:41:48.81Z" }, + { url = "https://files.pythonhosted.org/packages/b0/6f/8f7af07237c34a1defe7defc565a9bc1807762f672c0fde711a4b22bf9c0/charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9", size = 99940, upload-time = "2025-10-14T04:41:49.946Z" }, + { url = "https://files.pythonhosted.org/packages/4b/51/8ade005e5ca5b0d80fb4aff72a3775b325bdc3d27408c8113811a7cbe640/charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c", size = 107104, upload-time = "2025-10-14T04:41:51.051Z" }, + { url = "https://files.pythonhosted.org/packages/da/5f/6b8f83a55bb8278772c5ae54a577f3099025f9ade59d0136ac24a0df4bde/charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2", size = 100743, upload-time = "2025-10-14T04:41:52.122Z" }, + { url = "https://files.pythonhosted.org/packages/0a/4c/925909008ed5a988ccbb72dcc897407e5d6d3bd72410d69e051fc0c14647/charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f", size = 53402, upload-time = "2025-10-14T04:42:31.76Z" }, ] [[package]] @@ -376,16 +391,46 @@ wheels = [ ] [[package]] -name = "debugpy" -version = "1.8.16" +name = "cython" +version = "3.2.4" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/ca/d4/722d0bcc7986172ac2ef3c979ad56a1030e3afd44ced136d45f8142b1f4a/debugpy-1.8.16.tar.gz", hash = "sha256:31e69a1feb1cf6b51efbed3f6c9b0ef03bc46ff050679c4be7ea6d2e23540870", size = 1643809, upload-time = "2025-08-06T18:00:02.647Z" } +sdist = { url = "https://files.pythonhosted.org/packages/91/85/7574c9cd44b69a27210444b6650f6477f56c75fee1b70d7672d3e4166167/cython-3.2.4.tar.gz", hash = "sha256:84226ecd313b233da27dc2eb3601b4f222b8209c3a7216d8733b031da1dc64e6", size = 3280291, upload-time = "2026-01-04T14:14:14.473Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/62/66/607ab45cc79e60624df386e233ab64a6d8d39ea02e7f80e19c1d451345bb/debugpy-1.8.16-cp313-cp313-macosx_14_0_universal2.whl", hash = "sha256:85df3adb1de5258dca910ae0bb185e48c98801ec15018a263a92bb06be1c8787", size = 2496157, upload-time = "2025-08-06T18:00:24.361Z" }, - { url = "https://files.pythonhosted.org/packages/4d/a0/c95baae08a75bceabb79868d663a0736655e427ab9c81fb848da29edaeac/debugpy-1.8.16-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bee89e948bc236a5c43c4214ac62d28b29388453f5fd328d739035e205365f0b", size = 4222491, upload-time = "2025-08-06T18:00:25.806Z" }, - { url = "https://files.pythonhosted.org/packages/5b/2f/1c8db6ddd8a257c3cd2c46413b267f1d5fa3df910401c899513ce30392d6/debugpy-1.8.16-cp313-cp313-win32.whl", hash = "sha256:cf358066650439847ec5ff3dae1da98b5461ea5da0173d93d5e10f477c94609a", size = 5281126, upload-time = "2025-08-06T18:00:27.207Z" }, - { url = "https://files.pythonhosted.org/packages/d3/ba/c3e154ab307366d6c5a9c1b68de04914e2ce7fa2f50d578311d8cc5074b2/debugpy-1.8.16-cp313-cp313-win_amd64.whl", hash = "sha256:b5aea1083f6f50023e8509399d7dc6535a351cc9f2e8827d1e093175e4d9fa4c", size = 5323094, upload-time = "2025-08-06T18:00:29.03Z" }, - { url = "https://files.pythonhosted.org/packages/52/57/ecc9ae29fa5b2d90107cd1d9bf8ed19aacb74b2264d986ae9d44fe9bdf87/debugpy-1.8.16-py2.py3-none-any.whl", hash = "sha256:19c9521962475b87da6f673514f7fd610328757ec993bf7ec0d8c96f9a325f9e", size = 5287700, upload-time = "2025-08-06T18:00:42.333Z" }, + { url = "https://files.pythonhosted.org/packages/18/b5/1cfca43b7d20a0fdb1eac67313d6bb6b18d18897f82dd0f17436bdd2ba7f/cython-3.2.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:28e8075087a59756f2d059273184b8b639fe0f16cf17470bd91c39921bc154e0", size = 2960506, upload-time = "2026-01-04T14:15:16.733Z" }, + { url = "https://files.pythonhosted.org/packages/71/bb/8f28c39c342621047fea349a82fac712a5e2b37546d2f737bbde48d5143d/cython-3.2.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:03893c88299a2c868bb741ba6513357acd104e7c42265809fd58dce1456a36fc", size = 3213148, upload-time = "2026-01-04T14:15:18.804Z" }, + { url = "https://files.pythonhosted.org/packages/7a/d2/16fa02f129ed2b627e88d9d9ebd5ade3eeb66392ae5ba85b259d2d52b047/cython-3.2.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f81eda419b5ada7b197bbc3c5f4494090e3884521ffd75a3876c93fbf66c9ca8", size = 3375764, upload-time = "2026-01-04T14:15:20.817Z" }, + { url = "https://files.pythonhosted.org/packages/91/3f/deb8f023a5c10c0649eb81332a58c180fad27c7533bb4aae138b5bc34d92/cython-3.2.4-cp313-cp313-win_amd64.whl", hash = "sha256:83266c356c13c68ffe658b4905279c993d8a5337bb0160fa90c8a3e297ea9a2e", size = 2754238, upload-time = "2026-01-04T14:15:23.001Z" }, + { url = "https://files.pythonhosted.org/packages/ee/d7/3bda3efce0c5c6ce79cc21285dbe6f60369c20364e112f5a506ee8a1b067/cython-3.2.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:d4b4fd5332ab093131fa6172e8362f16adef3eac3179fd24bbdc392531cb82fa", size = 2971496, upload-time = "2026-01-04T14:15:25.038Z" }, + { url = "https://files.pythonhosted.org/packages/89/ed/1021ffc80b9c4720b7ba869aea8422c82c84245ef117ebe47a556bdc00c3/cython-3.2.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e3b5ac54e95f034bc7fb07313996d27cbf71abc17b229b186c1540942d2dc28e", size = 3256146, upload-time = "2026-01-04T14:15:26.741Z" }, + { url = "https://files.pythonhosted.org/packages/0c/51/ca221ec7e94b3c5dc4138dcdcbd41178df1729c1e88c5dfb25f9d30ba3da/cython-3.2.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:90f43be4eaa6afd58ce20d970bb1657a3627c44e1760630b82aa256ba74b4acb", size = 3383458, upload-time = "2026-01-04T14:15:28.425Z" }, + { url = "https://files.pythonhosted.org/packages/79/2e/1388fc0243240cd54994bb74f26aaaf3b2e22f89d3a2cf8da06d75d46ca2/cython-3.2.4-cp314-cp314-win_amd64.whl", hash = "sha256:983f9d2bb8a896e16fa68f2b37866ded35fa980195eefe62f764ddc5f9f5ef8e", size = 2791241, upload-time = "2026-01-04T14:15:30.448Z" }, + { url = "https://files.pythonhosted.org/packages/0a/8b/fd393f0923c82be4ec0db712fffb2ff0a7a131707b842c99bf24b549274d/cython-3.2.4-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:36bf3f5eb56d5281aafabecbaa6ed288bc11db87547bba4e1e52943ae6961ccf", size = 2875622, upload-time = "2026-01-04T14:15:39.749Z" }, + { url = "https://files.pythonhosted.org/packages/73/48/48530d9b9d64ec11dbe0dd3178a5fe1e0b27977c1054ecffb82be81e9b6a/cython-3.2.4-cp39-abi3-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:6d5267f22b6451eb1e2e1b88f6f78a2c9c8733a6ddefd4520d3968d26b824581", size = 3210669, upload-time = "2026-01-04T14:15:41.911Z" }, + { url = "https://files.pythonhosted.org/packages/5e/91/4865fbfef1f6bb4f21d79c46104a53d1a3fa4348286237e15eafb26e0828/cython-3.2.4-cp39-abi3-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3b6e58f73a69230218d5381817850ce6d0da5bb7e87eb7d528c7027cbba40b06", size = 2856835, upload-time = "2026-01-04T14:15:43.815Z" }, + { url = "https://files.pythonhosted.org/packages/fa/39/60317957dbef179572398253f29d28f75f94ab82d6d39ea3237fb6c89268/cython-3.2.4-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:e71efb20048358a6b8ec604a0532961c50c067b5e63e345e2e359fff72feaee8", size = 2994408, upload-time = "2026-01-04T14:15:45.422Z" }, + { url = "https://files.pythonhosted.org/packages/8d/30/7c24d9292650db4abebce98abc9b49c820d40fa7c87921c0a84c32f4efe7/cython-3.2.4-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:28b1e363b024c4b8dcf52ff68125e635cb9cb4b0ba997d628f25e32543a71103", size = 2891478, upload-time = "2026-01-04T14:15:47.394Z" }, + { url = "https://files.pythonhosted.org/packages/86/70/03dc3c962cde9da37a93cca8360e576f904d5f9beecfc9d70b1f820d2e5f/cython-3.2.4-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:31a90b4a2c47bb6d56baeb926948348ec968e932c1ae2c53239164e3e8880ccf", size = 3225663, upload-time = "2026-01-04T14:15:49.446Z" }, + { url = "https://files.pythonhosted.org/packages/b1/97/10b50c38313c37b1300325e2e53f48ea9a2c078a85c0c9572057135e31d5/cython-3.2.4-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:e65e4773021f8dc8532010b4fbebe782c77f9a0817e93886e518c93bd6a44e9d", size = 3115628, upload-time = "2026-01-04T14:15:51.323Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b1/d6a353c9b147848122a0db370863601fdf56de2d983b5c4a6a11e6ee3cd7/cython-3.2.4-cp39-abi3-win32.whl", hash = "sha256:2b1f12c0e4798293d2754e73cd6f35fa5bbdf072bdc14bc6fc442c059ef2d290", size = 2437463, upload-time = "2026-01-04T14:15:53.787Z" }, + { url = "https://files.pythonhosted.org/packages/2d/d8/319a1263b9c33b71343adfd407e5daffd453daef47ebc7b642820a8b68ed/cython-3.2.4-cp39-abi3-win_arm64.whl", hash = "sha256:3b8e62049afef9da931d55de82d8f46c9a147313b69d5ff6af6e9121d545ce7a", size = 2442754, upload-time = "2026-01-04T14:15:55.382Z" }, + { url = "https://files.pythonhosted.org/packages/ff/fa/d3c15189f7c52aaefbaea76fb012119b04b9013f4bf446cb4eb4c26c4e6b/cython-3.2.4-py3-none-any.whl", hash = "sha256:732fc93bc33ae4b14f6afaca663b916c2fdd5dcbfad7114e17fb2434eeaea45c", size = 1257078, upload-time = "2026-01-04T14:14:12.373Z" }, +] + +[[package]] +name = "debugpy" +version = "1.8.20" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e0/b7/cd8080344452e4874aae67c40d8940e2b4d47b01601a8fd9f44786c757c7/debugpy-1.8.20.tar.gz", hash = "sha256:55bc8701714969f1ab89a6d5f2f3d40c36f91b2cbe2f65d98bf8196f6a6a2c33", size = 1645207, upload-time = "2026-01-29T23:03:28.199Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/15/e2/fc500524cc6f104a9d049abc85a0a8b3f0d14c0a39b9c140511c61e5b40b/debugpy-1.8.20-cp313-cp313-macosx_15_0_universal2.whl", hash = "sha256:5dff4bb27027821fdfcc9e8f87309a28988231165147c31730128b1c983e282a", size = 2539560, upload-time = "2026-01-29T23:03:48.738Z" }, + { url = "https://files.pythonhosted.org/packages/90/83/fb33dcea789ed6018f8da20c5a9bc9d82adc65c0c990faed43f7c955da46/debugpy-1.8.20-cp313-cp313-manylinux_2_34_x86_64.whl", hash = "sha256:84562982dd7cf5ebebfdea667ca20a064e096099997b175fe204e86817f64eaf", size = 4293272, upload-time = "2026-01-29T23:03:50.169Z" }, + { url = "https://files.pythonhosted.org/packages/a6/25/b1e4a01bfb824d79a6af24b99ef291e24189080c93576dfd9b1a2815cd0f/debugpy-1.8.20-cp313-cp313-win32.whl", hash = "sha256:da11dea6447b2cadbf8ce2bec59ecea87cc18d2c574980f643f2d2dfe4862393", size = 5331208, upload-time = "2026-01-29T23:03:51.547Z" }, + { url = "https://files.pythonhosted.org/packages/13/f7/a0b368ce54ffff9e9028c098bd2d28cfc5b54f9f6c186929083d4c60ba58/debugpy-1.8.20-cp313-cp313-win_amd64.whl", hash = "sha256:eb506e45943cab2efb7c6eafdd65b842f3ae779f020c82221f55aca9de135ed7", size = 5372930, upload-time = "2026-01-29T23:03:53.585Z" }, + { url = "https://files.pythonhosted.org/packages/33/2e/f6cb9a8a13f5058f0a20fe09711a7b726232cd5a78c6a7c05b2ec726cff9/debugpy-1.8.20-cp314-cp314-macosx_15_0_universal2.whl", hash = "sha256:9c74df62fc064cd5e5eaca1353a3ef5a5d50da5eb8058fcef63106f7bebe6173", size = 2538066, upload-time = "2026-01-29T23:03:54.999Z" }, + { url = "https://files.pythonhosted.org/packages/c5/56/6ddca50b53624e1ca3ce1d1e49ff22db46c47ea5fb4c0cc5c9b90a616364/debugpy-1.8.20-cp314-cp314-manylinux_2_34_x86_64.whl", hash = "sha256:077a7447589ee9bc1ff0cdf443566d0ecf540ac8aa7333b775ebcb8ce9f4ecad", size = 4269425, upload-time = "2026-01-29T23:03:56.518Z" }, + { url = "https://files.pythonhosted.org/packages/c5/d9/d64199c14a0d4c476df46c82470a3ce45c8d183a6796cfb5e66533b3663c/debugpy-1.8.20-cp314-cp314-win32.whl", hash = "sha256:352036a99dd35053b37b7803f748efc456076f929c6a895556932eaf2d23b07f", size = 5331407, upload-time = "2026-01-29T23:03:58.481Z" }, + { url = "https://files.pythonhosted.org/packages/e0/d9/1f07395b54413432624d61524dfd98c1a7c7827d2abfdb8829ac92638205/debugpy-1.8.20-cp314-cp314-win_amd64.whl", hash = "sha256:a98eec61135465b062846112e5ecf2eebb855305acc1dfbae43b72903b8ab5be", size = 5372521, upload-time = "2026-01-29T23:03:59.864Z" }, + { url = "https://files.pythonhosted.org/packages/e0/c3/7f67dea8ccf8fdcb9c99033bbe3e90b9e7395415843accb81428c441be2d/debugpy-1.8.20-py2.py3-none-any.whl", hash = "sha256:5be9bed9ae3be00665a06acaa48f8329d2b9632f15fd09f6a9a8c8d9907e54d7", size = 5337658, upload-time = "2026-01-29T23:04:17.404Z" }, ] [[package]] @@ -408,37 +453,53 @@ wheels = [ [[package]] name = "executing" -version = "2.2.0" +version = "2.2.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/91/50/a9d80c47ff289c611ff12e63f7c5d13942c65d68125160cefd768c73e6e4/executing-2.2.0.tar.gz", hash = "sha256:5d108c028108fe2551d1a7b2e8b713341e2cb4fc0aa7dcf966fa4327a5226755", size = 978693, upload-time = "2025-01-22T15:41:29.403Z" } +sdist = { url = "https://files.pythonhosted.org/packages/cc/28/c14e053b6762b1044f34a13aab6859bbf40456d37d23aa286ac24cfd9a5d/executing-2.2.1.tar.gz", hash = "sha256:3632cc370565f6648cc328b32435bd120a1e4ebb20c77e3fdde9a13cd1e533c4", size = 1129488, upload-time = "2025-09-01T09:48:10.866Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/7b/8f/c4d9bafc34ad7ad5d8dc16dd1347ee0e507a52c3adb6bfa8887e1c6a26ba/executing-2.2.0-py2.py3-none-any.whl", hash = "sha256:11387150cad388d62750327a53d3339fad4888b39a6fe233c3afbb54ecffd3aa", size = 26702, upload-time = "2025-01-22T15:41:25.929Z" }, + { url = "https://files.pythonhosted.org/packages/c1/ea/53f2148663b321f21b5a606bd5f191517cf40b7072c0497d3c92c4a13b1e/executing-2.2.1-py2.py3-none-any.whl", hash = "sha256:760643d3452b4d777d295bb167ccc74c64a81df23fb5e08eff250c425a4b2017", size = 28317, upload-time = "2025-09-01T09:48:08.5Z" }, ] [[package]] name = "fastjsonschema" -version = "2.21.1" +version = "2.21.2" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/8b/50/4b769ce1ac4071a1ef6d86b1a3fb56cdc3a37615e8c5519e1af96cdac366/fastjsonschema-2.21.1.tar.gz", hash = "sha256:794d4f0a58f848961ba16af7b9c85a3e88cd360df008c59aac6fc5ae9323b5d4", size = 373939, upload-time = "2024-12-02T10:55:15.133Z" } +sdist = { url = "https://files.pythonhosted.org/packages/20/b5/23b216d9d985a956623b6bd12d4086b60f0059b27799f23016af04a74ea1/fastjsonschema-2.21.2.tar.gz", hash = "sha256:b1eb43748041c880796cd077f1a07c3d94e93ae84bba5ed36800a33554ae05de", size = 374130, upload-time = "2025-08-14T18:49:36.666Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/90/2b/0817a2b257fe88725c25589d89aec060581aabf668707a8d03b2e9e0cb2a/fastjsonschema-2.21.1-py3-none-any.whl", hash = "sha256:c9e5b7e908310918cf494a434eeb31384dd84a98b57a30bcb1f535015b554667", size = 23924, upload-time = "2024-12-02T10:55:07.599Z" }, + { url = "https://files.pythonhosted.org/packages/cb/a8/20d0723294217e47de6d9e2e40fd4a9d2f7c4b6ef974babd482a59743694/fastjsonschema-2.21.2-py3-none-any.whl", hash = "sha256:1c797122d0a86c5cace2e54bf4e819c36223b552017172f32c5c024a6b77e463", size = 24024, upload-time = "2025-08-14T18:49:34.776Z" }, ] [[package]] name = "fonttools" -version = "4.59.0" +version = "4.61.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/8a/27/ec3c723bfdf86f34c5c82bf6305df3e0f0d8ea798d2d3a7cb0c0a866d286/fonttools-4.59.0.tar.gz", hash = "sha256:be392ec3529e2f57faa28709d60723a763904f71a2b63aabe14fee6648fe3b14", size = 3532521, upload-time = "2025-07-16T12:04:54.613Z" } +sdist = { url = "https://files.pythonhosted.org/packages/ec/ca/cf17b88a8df95691275a3d77dc0a5ad9907f328ae53acbe6795da1b2f5ed/fonttools-4.61.1.tar.gz", hash = "sha256:6675329885c44657f826ef01d9e4fb33b9158e9d93c537d84ad8399539bc6f69", size = 3565756, upload-time = "2025-12-12T17:31:24.246Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/f3/bb/390990e7c457d377b00890d9f96a3ca13ae2517efafb6609c1756e213ba4/fonttools-4.59.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:78813b49d749e1bb4db1c57f2d4d7e6db22c253cb0a86ad819f5dc197710d4b2", size = 2758704, upload-time = "2025-07-16T12:04:22.217Z" }, - { url = "https://files.pythonhosted.org/packages/df/6f/d730d9fcc9b410a11597092bd2eb9ca53e5438c6cb90e4b3047ce1b723e9/fonttools-4.59.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:401b1941ce37e78b8fd119b419b617277c65ae9417742a63282257434fd68ea2", size = 2330764, upload-time = "2025-07-16T12:04:23.985Z" }, - { url = "https://files.pythonhosted.org/packages/75/b4/b96bb66f6f8cc4669de44a158099b249c8159231d254ab6b092909388be5/fonttools-4.59.0-cp313-cp313-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:efd7e6660674e234e29937bc1481dceb7e0336bfae75b856b4fb272b5093c5d4", size = 4890699, upload-time = "2025-07-16T12:04:25.664Z" }, - { url = "https://files.pythonhosted.org/packages/b5/57/7969af50b26408be12baa317c6147588db5b38af2759e6df94554dbc5fdb/fonttools-4.59.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:51ab1ff33c19e336c02dee1e9fd1abd974a4ca3d8f7eef2a104d0816a241ce97", size = 4952934, upload-time = "2025-07-16T12:04:27.733Z" }, - { url = "https://files.pythonhosted.org/packages/d6/e2/dd968053b6cf1f46c904f5bd409b22341477c017d8201619a265e50762d3/fonttools-4.59.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a9bf8adc9e1f3012edc8f09b08336272aec0c55bc677422273e21280db748f7c", size = 4892319, upload-time = "2025-07-16T12:04:30.074Z" }, - { url = "https://files.pythonhosted.org/packages/6b/95/a59810d8eda09129f83467a4e58f84205dc6994ebaeb9815406363e07250/fonttools-4.59.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:37e01c6ec0c98599778c2e688350d624fa4770fbd6144551bd5e032f1199171c", size = 5034753, upload-time = "2025-07-16T12:04:32.292Z" }, - { url = "https://files.pythonhosted.org/packages/a5/84/51a69ee89ff8d1fea0c6997e946657e25a3f08513de8435fe124929f3eef/fonttools-4.59.0-cp313-cp313-win32.whl", hash = "sha256:70d6b3ceaa9cc5a6ac52884f3b3d9544e8e231e95b23f138bdb78e6d4dc0eae3", size = 2199688, upload-time = "2025-07-16T12:04:34.444Z" }, - { url = "https://files.pythonhosted.org/packages/a0/ee/f626cd372932d828508137a79b85167fdcf3adab2e3bed433f295c596c6a/fonttools-4.59.0-cp313-cp313-win_amd64.whl", hash = "sha256:26731739daa23b872643f0e4072d5939960237d540c35c14e6a06d47d71ca8fe", size = 2248560, upload-time = "2025-07-16T12:04:36.034Z" }, - { url = "https://files.pythonhosted.org/packages/d0/9c/df0ef2c51845a13043e5088f7bb988ca6cd5bb82d5d4203d6a158aa58cf2/fonttools-4.59.0-py3-none-any.whl", hash = "sha256:241313683afd3baacb32a6bd124d0bce7404bc5280e12e291bae1b9bba28711d", size = 1128050, upload-time = "2025-07-16T12:04:52.687Z" }, + { url = "https://files.pythonhosted.org/packages/4b/cf/00ba28b0990982530addb8dc3e9e6f2fa9cb5c20df2abdda7baa755e8fe1/fonttools-4.61.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:8c56c488ab471628ff3bfa80964372fc13504ece601e0d97a78ee74126b2045c", size = 2846454, upload-time = "2025-12-12T17:30:24.938Z" }, + { url = "https://files.pythonhosted.org/packages/5a/ca/468c9a8446a2103ae645d14fee3f610567b7042aba85031c1c65e3ef7471/fonttools-4.61.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:dc492779501fa723b04d0ab1f5be046797fee17d27700476edc7ee9ae535a61e", size = 2398191, upload-time = "2025-12-12T17:30:27.343Z" }, + { url = "https://files.pythonhosted.org/packages/a3/4b/d67eedaed19def5967fade3297fed8161b25ba94699efc124b14fb68cdbc/fonttools-4.61.1-cp313-cp313-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:64102ca87e84261419c3747a0d20f396eb024bdbeb04c2bfb37e2891f5fadcb5", size = 4928410, upload-time = "2025-12-12T17:30:29.771Z" }, + { url = "https://files.pythonhosted.org/packages/b0/8d/6fb3494dfe61a46258cd93d979cf4725ded4eb46c2a4ca35e4490d84daea/fonttools-4.61.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4c1b526c8d3f615a7b1867f38a9410849c8f4aef078535742198e942fba0e9bd", size = 4984460, upload-time = "2025-12-12T17:30:32.073Z" }, + { url = "https://files.pythonhosted.org/packages/f7/f1/a47f1d30b3dc00d75e7af762652d4cbc3dff5c2697a0dbd5203c81afd9c3/fonttools-4.61.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:41ed4b5ec103bd306bb68f81dc166e77409e5209443e5773cb4ed837bcc9b0d3", size = 4925800, upload-time = "2025-12-12T17:30:34.339Z" }, + { url = "https://files.pythonhosted.org/packages/a7/01/e6ae64a0981076e8a66906fab01539799546181e32a37a0257b77e4aa88b/fonttools-4.61.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b501c862d4901792adaec7c25b1ecc749e2662543f68bb194c42ba18d6eec98d", size = 5067859, upload-time = "2025-12-12T17:30:36.593Z" }, + { url = "https://files.pythonhosted.org/packages/73/aa/28e40b8d6809a9b5075350a86779163f074d2b617c15d22343fce81918db/fonttools-4.61.1-cp313-cp313-win32.whl", hash = "sha256:4d7092bb38c53bbc78e9255a59158b150bcdc115a1e3b3ce0b5f267dc35dd63c", size = 2267821, upload-time = "2025-12-12T17:30:38.478Z" }, + { url = "https://files.pythonhosted.org/packages/1a/59/453c06d1d83dc0951b69ef692d6b9f1846680342927df54e9a1ca91c6f90/fonttools-4.61.1-cp313-cp313-win_amd64.whl", hash = "sha256:21e7c8d76f62ab13c9472ccf74515ca5b9a761d1bde3265152a6dc58700d895b", size = 2318169, upload-time = "2025-12-12T17:30:40.951Z" }, + { url = "https://files.pythonhosted.org/packages/32/8f/4e7bf82c0cbb738d3c2206c920ca34ca74ef9dabde779030145d28665104/fonttools-4.61.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fff4f534200a04b4a36e7ae3cb74493afe807b517a09e99cb4faa89a34ed6ecd", size = 2846094, upload-time = "2025-12-12T17:30:43.511Z" }, + { url = "https://files.pythonhosted.org/packages/71/09/d44e45d0a4f3a651f23a1e9d42de43bc643cce2971b19e784cc67d823676/fonttools-4.61.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:d9203500f7c63545b4ce3799319fe4d9feb1a1b89b28d3cb5abd11b9dd64147e", size = 2396589, upload-time = "2025-12-12T17:30:45.681Z" }, + { url = "https://files.pythonhosted.org/packages/89/18/58c64cafcf8eb677a99ef593121f719e6dcbdb7d1c594ae5a10d4997ca8a/fonttools-4.61.1-cp314-cp314-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fa646ecec9528bef693415c79a86e733c70a4965dd938e9a226b0fc64c9d2e6c", size = 4877892, upload-time = "2025-12-12T17:30:47.709Z" }, + { url = "https://files.pythonhosted.org/packages/8a/ec/9e6b38c7ba1e09eb51db849d5450f4c05b7e78481f662c3b79dbde6f3d04/fonttools-4.61.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:11f35ad7805edba3aac1a3710d104592df59f4b957e30108ae0ba6c10b11dd75", size = 4972884, upload-time = "2025-12-12T17:30:49.656Z" }, + { url = "https://files.pythonhosted.org/packages/5e/87/b5339da8e0256734ba0dbbf5b6cdebb1dd79b01dc8c270989b7bcd465541/fonttools-4.61.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b931ae8f62db78861b0ff1ac017851764602288575d65b8e8ff1963fed419063", size = 4924405, upload-time = "2025-12-12T17:30:51.735Z" }, + { url = "https://files.pythonhosted.org/packages/0b/47/e3409f1e1e69c073a3a6fd8cb886eb18c0bae0ee13db2c8d5e7f8495e8b7/fonttools-4.61.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:b148b56f5de675ee16d45e769e69f87623a4944f7443850bf9a9376e628a89d2", size = 5035553, upload-time = "2025-12-12T17:30:54.823Z" }, + { url = "https://files.pythonhosted.org/packages/bf/b6/1f6600161b1073a984294c6c031e1a56ebf95b6164249eecf30012bb2e38/fonttools-4.61.1-cp314-cp314-win32.whl", hash = "sha256:9b666a475a65f4e839d3d10473fad6d47e0a9db14a2f4a224029c5bfde58ad2c", size = 2271915, upload-time = "2025-12-12T17:30:57.913Z" }, + { url = "https://files.pythonhosted.org/packages/52/7b/91e7b01e37cc8eb0e1f770d08305b3655e4f002fc160fb82b3390eabacf5/fonttools-4.61.1-cp314-cp314-win_amd64.whl", hash = "sha256:4f5686e1fe5fce75d82d93c47a438a25bf0d1319d2843a926f741140b2b16e0c", size = 2323487, upload-time = "2025-12-12T17:30:59.804Z" }, + { url = "https://files.pythonhosted.org/packages/39/5c/908ad78e46c61c3e3ed70c3b58ff82ab48437faf84ec84f109592cabbd9f/fonttools-4.61.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:e76ce097e3c57c4bcb67c5aa24a0ecdbd9f74ea9219997a707a4061fbe2707aa", size = 2929571, upload-time = "2025-12-12T17:31:02.574Z" }, + { url = "https://files.pythonhosted.org/packages/bd/41/975804132c6dea64cdbfbaa59f3518a21c137a10cccf962805b301ac6ab2/fonttools-4.61.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:9cfef3ab326780c04d6646f68d4b4742aae222e8b8ea1d627c74e38afcbc9d91", size = 2435317, upload-time = "2025-12-12T17:31:04.974Z" }, + { url = "https://files.pythonhosted.org/packages/b0/5a/aef2a0a8daf1ebaae4cfd83f84186d4a72ee08fd6a8451289fcd03ffa8a4/fonttools-4.61.1-cp314-cp314t-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:a75c301f96db737e1c5ed5fd7d77d9c34466de16095a266509e13da09751bd19", size = 4882124, upload-time = "2025-12-12T17:31:07.456Z" }, + { url = "https://files.pythonhosted.org/packages/80/33/d6db3485b645b81cea538c9d1c9219d5805f0877fda18777add4671c5240/fonttools-4.61.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:91669ccac46bbc1d09e9273546181919064e8df73488ea087dcac3e2968df9ba", size = 5100391, upload-time = "2025-12-12T17:31:09.732Z" }, + { url = "https://files.pythonhosted.org/packages/6c/d6/675ba631454043c75fcf76f0ca5463eac8eb0666ea1d7badae5fea001155/fonttools-4.61.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:c33ab3ca9d3ccd581d58e989d67554e42d8d4ded94ab3ade3508455fe70e65f7", size = 4978800, upload-time = "2025-12-12T17:31:11.681Z" }, + { url = "https://files.pythonhosted.org/packages/7f/33/d3ec753d547a8d2bdaedd390d4a814e8d5b45a093d558f025c6b990b554c/fonttools-4.61.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:664c5a68ec406f6b1547946683008576ef8b38275608e1cee6c061828171c118", size = 5006426, upload-time = "2025-12-12T17:31:13.764Z" }, + { url = "https://files.pythonhosted.org/packages/b4/40/cc11f378b561a67bea850ab50063366a0d1dd3f6d0a30ce0f874b0ad5664/fonttools-4.61.1-cp314-cp314t-win32.whl", hash = "sha256:aed04cabe26f30c1647ef0e8fbb207516fd40fe9472e9439695f5c6998e60ac5", size = 2335377, upload-time = "2025-12-12T17:31:16.49Z" }, + { url = "https://files.pythonhosted.org/packages/e4/ff/c9a2b66b39f8628531ea58b320d66d951267c98c6a38684daa8f50fb02f8/fonttools-4.61.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2180f14c141d2f0f3da43f3a81bc8aa4684860f6b0e6f9e165a4831f24e6a23b", size = 2400613, upload-time = "2025-12-12T17:31:18.769Z" }, + { url = "https://files.pythonhosted.org/packages/c7/4e/ce75a57ff3aebf6fc1f4e9d508b8e5810618a33d900ad6c19eb30b290b97/fonttools-4.61.1-py3-none-any.whl", hash = "sha256:17d2bf5d541add43822bcf0c43d7d847b160c9bb01d15d5007d84e2217aaa371", size = 1148996, upload-time = "2025-12-12T17:31:21.03Z" }, ] [[package]] @@ -489,25 +550,25 @@ wheels = [ [[package]] name = "idna" -version = "3.10" +version = "3.11" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/f1/70/7703c29685631f5a7590aa73f1f1d3fa9a380e654b86af429e0934a32f7d/idna-3.10.tar.gz", hash = "sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9", size = 190490, upload-time = "2024-09-15T18:07:39.745Z" } +sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/76/c6/c88e154df9c4e1a2a66ccf0005a88dfb2650c1dffb6f5ce603dfbd452ce3/idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3", size = 70442, upload-time = "2024-09-15T18:07:37.964Z" }, + { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" }, ] [[package]] name = "iniconfig" -version = "2.1.0" +version = "2.3.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/f2/97/ebf4da567aa6827c909642694d71c9fcf53e5b504f2d96afea02718862f3/iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7", size = 4793, upload-time = "2025-03-19T20:09:59.721Z" } +sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050, upload-time = "2025-03-19T20:10:01.071Z" }, + { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" }, ] [[package]] name = "ipykernel" -version = "6.30.1" +version = "7.2.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "appnope", marker = "sys_platform == 'darwin'" }, @@ -524,14 +585,14 @@ dependencies = [ { name = "tornado" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/bb/76/11082e338e0daadc89c8ff866185de11daf67d181901038f9e139d109761/ipykernel-6.30.1.tar.gz", hash = "sha256:6abb270161896402e76b91394fcdce5d1be5d45f456671e5080572f8505be39b", size = 166260, upload-time = "2025-08-04T15:47:35.018Z" } +sdist = { url = "https://files.pythonhosted.org/packages/ca/8d/b68b728e2d06b9e0051019640a40a9eb7a88fcd82c2e1b5ce70bef5ff044/ipykernel-7.2.0.tar.gz", hash = "sha256:18ed160b6dee2cbb16e5f3575858bc19d8f1fe6046a9a680c708494ce31d909e", size = 176046, upload-time = "2026-02-06T16:43:27.403Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fc/c7/b445faca8deb954fe536abebff4ece5b097b923de482b26e78448c89d1dd/ipykernel-6.30.1-py3-none-any.whl", hash = "sha256:aa6b9fb93dca949069d8b85b6c79b2518e32ac583ae9c7d37c51d119e18b3fb4", size = 117484, upload-time = "2025-08-04T15:47:32.622Z" }, + { url = "https://files.pythonhosted.org/packages/82/b9/e73d5d9f405cba7706c539aa8b311b49d4c2f3d698d9c12f815231169c71/ipykernel-7.2.0-py3-none-any.whl", hash = "sha256:3bbd4420d2b3cc105cbdf3756bfc04500b1e52f090a90716851f3916c62e1661", size = 118788, upload-time = "2026-02-06T16:43:25.149Z" }, ] [[package]] name = "ipython" -version = "9.4.0" +version = "9.10.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "colorama", marker = "sys_platform == 'win32'" }, @@ -545,9 +606,9 @@ dependencies = [ { name = "stack-data" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/54/80/406f9e3bde1c1fd9bf5a0be9d090f8ae623e401b7670d8f6fdf2ab679891/ipython-9.4.0.tar.gz", hash = "sha256:c033c6d4e7914c3d9768aabe76bbe87ba1dc66a92a05db6bfa1125d81f2ee270", size = 4385338, upload-time = "2025-07-01T11:11:30.606Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a6/60/2111715ea11f39b1535bed6024b7dec7918b71e5e5d30855a5b503056b50/ipython-9.10.0.tar.gz", hash = "sha256:cd9e656be97618a0676d058134cd44e6dc7012c0e5cb36a9ce96a8c904adaf77", size = 4426526, upload-time = "2026-02-02T10:00:33.594Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/63/f8/0031ee2b906a15a33d6bfc12dd09c3dfa966b3cb5b284ecfb7549e6ac3c4/ipython-9.4.0-py3-none-any.whl", hash = "sha256:25850f025a446d9b359e8d296ba175a36aedd32e83ca9b5060430fe16801f066", size = 611021, upload-time = "2025-07-01T11:11:27.85Z" }, + { url = "https://files.pythonhosted.org/packages/3d/aa/898dec789a05731cd5a9f50605b7b44a72bd198fd0d4528e11fc610177cc/ipython-9.10.0-py3-none-any.whl", hash = "sha256:c6ab68cc23bba8c7e18e9b932797014cc61ea7fd6f19de180ab9ba73e65ee58d", size = 622774, upload-time = "2026-02-02T10:00:31.503Z" }, ] [[package]] @@ -564,7 +625,7 @@ wheels = [ [[package]] name = "ipywidgets" -version = "8.1.7" +version = "8.1.8" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "comm" }, @@ -573,9 +634,9 @@ dependencies = [ { name = "traitlets" }, { name = "widgetsnbextension" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/3e/48/d3dbac45c2814cb73812f98dd6b38bbcc957a4e7bb31d6ea9c03bf94ed87/ipywidgets-8.1.7.tar.gz", hash = "sha256:15f1ac050b9ccbefd45dccfbb2ef6bed0029d8278682d569d71b8dd96bee0376", size = 116721, upload-time = "2025-05-05T12:42:03.489Z" } +sdist = { url = "https://files.pythonhosted.org/packages/4c/ae/c5ce1edc1afe042eadb445e95b0671b03cee61895264357956e61c0d2ac0/ipywidgets-8.1.8.tar.gz", hash = "sha256:61f969306b95f85fba6b6986b7fe45d73124d1d9e3023a8068710d47a22ea668", size = 116739, upload-time = "2025-11-01T21:18:12.393Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/58/6a/9166369a2f092bd286d24e6307de555d63616e8ddb373ebad2b5635ca4cd/ipywidgets-8.1.7-py3-none-any.whl", hash = "sha256:764f2602d25471c213919b8a1997df04bef869251db4ca8efba1b76b1bd9f7bb", size = 139806, upload-time = "2025-05-05T12:41:56.833Z" }, + { url = "https://files.pythonhosted.org/packages/56/6d/0d9848617b9f753b87f214f1c682592f7ca42de085f564352f10f0843026/ipywidgets-8.1.8-py3-none-any.whl", hash = "sha256:ecaca67aed704a338f88f67b1181b58f821ab5dc89c1f0f5ef99db43c1c2921e", size = 139808, upload-time = "2025-11-01T21:18:10.956Z" }, ] [[package]] @@ -616,11 +677,11 @@ wheels = [ [[package]] name = "json5" -version = "0.12.0" +version = "0.13.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/12/be/c6c745ec4c4539b25a278b70e29793f10382947df0d9efba2fa09120895d/json5-0.12.0.tar.gz", hash = "sha256:0b4b6ff56801a1c7dc817b0241bca4ce474a0e6a163bfef3fc594d3fd263ff3a", size = 51907, upload-time = "2025-04-03T16:33:13.201Z" } +sdist = { url = "https://files.pythonhosted.org/packages/77/e8/a3f261a66e4663f22700bc8a17c08cb83e91fbf086726e7a228398968981/json5-0.13.0.tar.gz", hash = "sha256:b1edf8d487721c0bf64d83c28e91280781f6e21f4a797d3261c7c828d4c165bf", size = 52441, upload-time = "2026-01-01T19:42:14.99Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/41/9f/3500910d5a98549e3098807493851eeef2b89cdd3032227558a104dfe926/json5-0.12.0-py3-none-any.whl", hash = "sha256:6d37aa6c08b0609f16e1ec5ff94697e2cbbfbad5ac112afa05794da9ab7810db", size = 36079, upload-time = "2025-04-03T16:33:11.927Z" }, + { url = "https://files.pythonhosted.org/packages/d7/9e/038522f50ceb7e74f1f991bf1b699f24b0c2bbe7c390dd36ad69f4582258/json5-0.13.0-py3-none-any.whl", hash = "sha256:9a08e1dd65f6a4d4c6fa82d216cf2477349ec2346a38fd70cc11d2557499fbcc", size = 36163, upload-time = "2026-01-01T19:42:13.962Z" }, ] [[package]] @@ -634,7 +695,7 @@ wheels = [ [[package]] name = "jsonschema" -version = "4.25.0" +version = "4.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, @@ -642,9 +703,9 @@ dependencies = [ { name = "referencing" }, { name = "rpds-py" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/d5/00/a297a868e9d0784450faa7365c2172a7d6110c763e30ba861867c32ae6a9/jsonschema-4.25.0.tar.gz", hash = "sha256:e63acf5c11762c0e6672ffb61482bdf57f0876684d8d249c0fe2d730d48bc55f", size = 356830, upload-time = "2025-07-18T15:39:45.11Z" } +sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fe/54/c86cd8e011fe98803d7e382fd67c0df5ceab8d2b7ad8c5a81524f791551c/jsonschema-4.25.0-py3-none-any.whl", hash = "sha256:24c2e8da302de79c8b9382fee3e76b355e44d2a4364bb207159ce10b517bd716", size = 89184, upload-time = "2025-07-18T15:39:42.956Z" }, + { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" }, ] [package.optional-dependencies] @@ -662,14 +723,14 @@ format-nongpl = [ [[package]] name = "jsonschema-specifications" -version = "2025.4.1" +version = "2025.9.1" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "referencing" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/bf/ce/46fbd9c8119cfc3581ee5643ea49464d168028cfb5caff5fc0596d0cf914/jsonschema_specifications-2025.4.1.tar.gz", hash = "sha256:630159c9f4dbea161a6a2205c3011cc4f18ff381b189fff48bb39b9bf26ae608", size = 15513, upload-time = "2025-04-23T12:34:07.418Z" } +sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/01/0e/b27cdbaccf30b890c40ed1da9fd4a3593a5cf94dae54fb34f8a4b74fcd3f/jsonschema_specifications-2025.4.1-py3-none-any.whl", hash = "sha256:4653bffbd6584f7de83a67e0d620ef16900b390ddc7939d56684d6c81e33f1af", size = 18437, upload-time = "2025-04-23T12:34:05.422Z" }, + { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" }, ] [[package]] @@ -691,7 +752,7 @@ wheels = [ [[package]] name = "jupyter-client" -version = "8.6.3" +version = "8.8.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "jupyter-core" }, @@ -700,9 +761,9 @@ dependencies = [ { name = "tornado" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/71/22/bf9f12fdaeae18019a468b68952a60fe6dbab5d67cd2a103cac7659b41ca/jupyter_client-8.6.3.tar.gz", hash = "sha256:35b3a0947c4a6e9d589eb97d7d4cd5e90f910ee73101611f01283732bd6d9419", size = 342019, upload-time = "2024-09-17T10:44:17.613Z" } +sdist = { url = "https://files.pythonhosted.org/packages/05/e4/ba649102a3bc3fbca54e7239fb924fd434c766f855693d86de0b1f2bec81/jupyter_client-8.8.0.tar.gz", hash = "sha256:d556811419a4f2d96c869af34e854e3f059b7cc2d6d01a9cd9c85c267691be3e", size = 348020, upload-time = "2026-01-08T13:55:47.938Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/11/85/b0394e0b6fcccd2c1eeefc230978a6f8cb0c5df1e4cd3e7625735a0d7d1e/jupyter_client-8.6.3-py3-none-any.whl", hash = "sha256:e8a19cc986cc45905ac3362915f410f3af85424b4c0905e94fa5f2cb08e8f23f", size = 106105, upload-time = "2024-09-17T10:44:15.218Z" }, + { url = "https://files.pythonhosted.org/packages/2d/0b/ceb7694d864abc0a047649aec263878acb9f792e1fec3e676f22dc9015e3/jupyter_client-8.8.0-py3-none-any.whl", hash = "sha256:f93a5b99c5e23a507b773d3a1136bd6e16c67883ccdbd9a829b0bbdb98cd7d7a", size = 107371, upload-time = "2026-01-08T13:55:45.562Z" }, ] [[package]] @@ -726,16 +787,15 @@ wheels = [ [[package]] name = "jupyter-core" -version = "5.8.1" +version = "5.9.1" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "platformdirs" }, - { name = "pywin32", marker = "platform_python_implementation != 'PyPy' and sys_platform == 'win32'" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/99/1b/72906d554acfeb588332eaaa6f61577705e9ec752ddb486f302dafa292d9/jupyter_core-5.8.1.tar.gz", hash = "sha256:0a5f9706f70e64786b75acba995988915ebd4601c8a52e534a40b51c95f59941", size = 88923, upload-time = "2025-05-27T07:38:16.655Z" } +sdist = { url = "https://files.pythonhosted.org/packages/02/49/9d1284d0dc65e2c757b74c6687b6d319b02f822ad039e5c512df9194d9dd/jupyter_core-5.9.1.tar.gz", hash = "sha256:4d09aaff303b9566c3ce657f580bd089ff5c91f5f89cf7d8846c3cdf465b5508", size = 89814, upload-time = "2025-10-16T19:19:18.444Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/2f/57/6bffd4b20b88da3800c5d691e0337761576ee688eb01299eae865689d2df/jupyter_core-5.8.1-py3-none-any.whl", hash = "sha256:c28d268fc90fb53f1338ded2eb410704c5449a358406e8a948b75706e24863d0", size = 28880, upload-time = "2025-05-27T07:38:15.137Z" }, + { url = "https://files.pythonhosted.org/packages/e7/e7/80988e32bf6f73919a113473a604f5a8f09094de312b9d52b79c2df7612b/jupyter_core-5.9.1-py3-none-any.whl", hash = "sha256:ebf87fdc6073d142e114c72c9e29a9d7ca03fad818c5d300ce2adc1fb0743407", size = 29032, upload-time = "2025-10-16T19:19:16.783Z" }, ] [[package]] @@ -759,19 +819,19 @@ wheels = [ [[package]] name = "jupyter-lsp" -version = "2.2.6" +version = "2.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "jupyter-server" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/28/3d/40bdb41b665d3302390ed1356cebd5917c10769d1f190ee4ca595900840e/jupyter_lsp-2.2.6.tar.gz", hash = "sha256:0566bd9bb04fd9e6774a937ed01522b555ba78be37bebef787c8ab22de4c0361", size = 48948, upload-time = "2025-07-18T21:35:19.885Z" } +sdist = { url = "https://files.pythonhosted.org/packages/eb/5a/9066c9f8e94ee517133cd98dba393459a16cd48bba71a82f16a65415206c/jupyter_lsp-2.3.0.tar.gz", hash = "sha256:458aa59339dc868fb784d73364f17dbce8836e906cd75fd471a325cba02e0245", size = 54823, upload-time = "2025-08-27T17:47:34.671Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/47/7c/12f68daf85b469b4896d5e4a629baa33c806d61de75ac5b39d8ef27ec4a2/jupyter_lsp-2.2.6-py3-none-any.whl", hash = "sha256:283783752bf0b459ee7fa88effa72104d87dd343b82d5c06cf113ef755b15b6d", size = 69371, upload-time = "2025-07-18T21:35:16.585Z" }, + { url = "https://files.pythonhosted.org/packages/1a/60/1f6cee0c46263de1173894f0fafcb3475ded276c472c14d25e0280c18d6d/jupyter_lsp-2.3.0-py3-none-any.whl", hash = "sha256:e914a3cb2addf48b1c7710914771aaf1819d46b2e5a79b0f917b5478ec93f34f", size = 76687, upload-time = "2025-08-27T17:47:33.15Z" }, ] [[package]] name = "jupyter-server" -version = "2.16.0" +version = "2.17.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -783,7 +843,6 @@ dependencies = [ { name = "jupyter-server-terminals" }, { name = "nbconvert" }, { name = "nbformat" }, - { name = "overrides" }, { name = "packaging" }, { name = "prometheus-client" }, { name = "pywinpty", marker = "os_name == 'nt'" }, @@ -794,27 +853,27 @@ dependencies = [ { name = "traitlets" }, { name = "websocket-client" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/41/c8/ba2bbcd758c47f1124c4ca14061e8ce60d9c6fd537faee9534a95f83521a/jupyter_server-2.16.0.tar.gz", hash = "sha256:65d4b44fdf2dcbbdfe0aa1ace4a842d4aaf746a2b7b168134d5aaed35621b7f6", size = 728177, upload-time = "2025-05-12T16:44:46.245Z" } +sdist = { url = "https://files.pythonhosted.org/packages/5b/ac/e040ec363d7b6b1f11304cc9f209dac4517ece5d5e01821366b924a64a50/jupyter_server-2.17.0.tar.gz", hash = "sha256:c38ea898566964c888b4772ae1ed58eca84592e88251d2cfc4d171f81f7e99d5", size = 731949, upload-time = "2025-08-21T14:42:54.042Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/46/1f/5ebbced977171d09a7b0c08a285ff9a20aafb9c51bde07e52349ff1ddd71/jupyter_server-2.16.0-py3-none-any.whl", hash = "sha256:3d8db5be3bc64403b1c65b400a1d7f4647a5ce743f3b20dbdefe8ddb7b55af9e", size = 386904, upload-time = "2025-05-12T16:44:43.335Z" }, + { url = "https://files.pythonhosted.org/packages/92/80/a24767e6ca280f5a49525d987bf3e4d7552bf67c8be07e8ccf20271f8568/jupyter_server-2.17.0-py3-none-any.whl", hash = "sha256:e8cb9c7db4251f51ed307e329b81b72ccf2056ff82d50524debde1ee1870e13f", size = 388221, upload-time = "2025-08-21T14:42:52.034Z" }, ] [[package]] name = "jupyter-server-terminals" -version = "0.5.3" +version = "0.5.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "pywinpty", marker = "os_name == 'nt'" }, { name = "terminado" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/fc/d5/562469734f476159e99a55426d697cbf8e7eb5efe89fb0e0b4f83a3d3459/jupyter_server_terminals-0.5.3.tar.gz", hash = "sha256:5ae0295167220e9ace0edcfdb212afd2b01ee8d179fe6f23c899590e9b8a5269", size = 31430, upload-time = "2024-03-12T14:37:03.049Z" } +sdist = { url = "https://files.pythonhosted.org/packages/f4/a7/bcd0a9b0cbba88986fe944aaaf91bfda603e5a50bda8ed15123f381a3b2f/jupyter_server_terminals-0.5.4.tar.gz", hash = "sha256:bbda128ed41d0be9020349f9f1f2a4ab9952a73ed5f5ac9f1419794761fb87f5", size = 31770, upload-time = "2026-01-14T16:53:20.213Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/07/2d/2b32cdbe8d2a602f697a649798554e4f072115438e92249624e532e8aca6/jupyter_server_terminals-0.5.3-py3-none-any.whl", hash = "sha256:41ee0d7dc0ebf2809c668e0fc726dfaf258fcd3e769568996ca731b6194ae9aa", size = 13656, upload-time = "2024-03-12T14:37:00.708Z" }, + { url = "https://files.pythonhosted.org/packages/d1/2d/6674563f71c6320841fc300911a55143925112a72a883e2ca71fba4c618d/jupyter_server_terminals-0.5.4-py3-none-any.whl", hash = "sha256:55be353fc74a80bc7f3b20e6be50a55a61cd525626f578dcb66a5708e2007d14", size = 13704, upload-time = "2026-01-14T16:53:18.738Z" }, ] [[package]] name = "jupyterlab" -version = "4.4.5" +version = "4.5.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "async-lru" }, @@ -831,9 +890,9 @@ dependencies = [ { name = "tornado" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/20/89/695805a6564bafe08ef2505f3c473ae7140b8ba431d381436f11bdc2c266/jupyterlab-4.4.5.tar.gz", hash = "sha256:0bd6c18e6a3c3d91388af6540afa3d0bb0b2e76287a7b88ddf20ab41b336e595", size = 23037079, upload-time = "2025-07-20T09:21:30.151Z" } +sdist = { url = "https://files.pythonhosted.org/packages/7c/6b/21af7c0512bdf67e0c54c121779a1f2a97a164a7657e13fced79db8fa5a0/jupyterlab-4.5.4.tar.gz", hash = "sha256:c215f48d8e4582bd2920ad61cc6a40d8ebfef7e5a517ae56b8a9413c9789fdfb", size = 23943597, upload-time = "2026-02-11T00:26:55.308Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/47/74/e144ce85b34414e44b14c1f6bf2e3bfe17964c8e5670ebdc7629f2e53672/jupyterlab-4.4.5-py3-none-any.whl", hash = "sha256:e76244cceb2d1fb4a99341f3edc866f2a13a9e14c50368d730d75d8017be0863", size = 12267763, upload-time = "2025-07-20T09:21:26.37Z" }, + { url = "https://files.pythonhosted.org/packages/f5/9f/a70972ece62ead2d81acc6223188f6d18a92f665ccce17796a0cdea4fcf5/jupyterlab-4.5.4-py3-none-any.whl", hash = "sha256:cc233f70539728534669fb0015331f2a3a87656207b3bb2d07916e9289192f12", size = 12391867, upload-time = "2026-02-11T00:26:51.23Z" }, ] [[package]] @@ -847,7 +906,7 @@ wheels = [ [[package]] name = "jupyterlab-server" -version = "2.27.3" +version = "2.28.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "babel" }, @@ -858,109 +917,159 @@ dependencies = [ { name = "packaging" }, { name = "requests" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/0a/c9/a883ce65eb27905ce77ace410d83587c82ea64dc85a48d1f7ed52bcfa68d/jupyterlab_server-2.27.3.tar.gz", hash = "sha256:eb36caca59e74471988f0ae25c77945610b887f777255aa21f8065def9e51ed4", size = 76173, upload-time = "2024-07-16T17:02:04.149Z" } +sdist = { url = "https://files.pythonhosted.org/packages/d6/2c/90153f189e421e93c4bb4f9e3f59802a1f01abd2ac5cf40b152d7f735232/jupyterlab_server-2.28.0.tar.gz", hash = "sha256:35baa81898b15f93573e2deca50d11ac0ae407ebb688299d3a5213265033712c", size = 76996, upload-time = "2025-10-22T13:59:18.37Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/54/09/2032e7d15c544a0e3cd831c51d77a8ca57f7555b2e1b2922142eddb02a84/jupyterlab_server-2.27.3-py3-none-any.whl", hash = "sha256:e697488f66c3db49df675158a77b3b017520d772c6e1548c7d9bcc5df7944ee4", size = 59700, upload-time = "2024-07-16T17:02:01.115Z" }, + { url = "https://files.pythonhosted.org/packages/e0/07/a000fe835f76b7e1143242ab1122e6362ef1c03f23f83a045c38859c2ae0/jupyterlab_server-2.28.0-py3-none-any.whl", hash = "sha256:e4355b148fdcf34d312bbbc80f22467d6d20460e8b8736bf235577dd18506968", size = 59830, upload-time = "2025-10-22T13:59:16.767Z" }, ] [[package]] name = "jupyterlab-widgets" -version = "3.0.15" +version = "3.0.16" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/b9/7d/160595ca88ee87ac6ba95d82177d29ec60aaa63821d3077babb22ce031a5/jupyterlab_widgets-3.0.15.tar.gz", hash = "sha256:2920888a0c2922351a9202817957a68c07d99673504d6cd37345299e971bb08b", size = 213149, upload-time = "2025-05-05T12:32:31.004Z" } +sdist = { url = "https://files.pythonhosted.org/packages/26/2d/ef58fed122b268c69c0aa099da20bc67657cdfb2e222688d5731bd5b971d/jupyterlab_widgets-3.0.16.tar.gz", hash = "sha256:423da05071d55cf27a9e602216d35a3a65a3e41cdf9c5d3b643b814ce38c19e0", size = 897423, upload-time = "2025-11-01T21:11:29.724Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/43/6a/ca128561b22b60bd5a0c4ea26649e68c8556b82bc70a0c396eebc977fe86/jupyterlab_widgets-3.0.15-py3-none-any.whl", hash = "sha256:d59023d7d7ef71400d51e6fee9a88867f6e65e10a4201605d2d7f3e8f012a31c", size = 216571, upload-time = "2025-05-05T12:32:29.534Z" }, + { url = "https://files.pythonhosted.org/packages/ab/b5/36c712098e6191d1b4e349304ef73a8d06aed77e56ceaac8c0a306c7bda1/jupyterlab_widgets-3.0.16-py3-none-any.whl", hash = "sha256:45fa36d9c6422cf2559198e4db481aa243c7a32d9926b500781c830c80f7ecf8", size = 914926, upload-time = "2025-11-01T21:11:28.008Z" }, ] [[package]] name = "kiwisolver" -version = "1.4.8" +version = "1.4.9" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/82/59/7c91426a8ac292e1cdd53a63b6d9439abd573c875c3f92c146767dd33faf/kiwisolver-1.4.8.tar.gz", hash = "sha256:23d5f023bdc8c7e54eb65f03ca5d5bb25b601eac4d7f1a042888a1f45237987e", size = 97538, upload-time = "2024-12-24T18:30:51.519Z" } +sdist = { url = "https://files.pythonhosted.org/packages/5c/3c/85844f1b0feb11ee581ac23fe5fce65cd049a200c1446708cc1b7f922875/kiwisolver-1.4.9.tar.gz", hash = "sha256:c3b22c26c6fd6811b0ae8363b95ca8ce4ea3c202d3d0975b2914310ceb1bcc4d", size = 97564, upload-time = "2025-08-10T21:27:49.279Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/79/b3/e62464a652f4f8cd9006e13d07abad844a47df1e6537f73ddfbf1bc997ec/kiwisolver-1.4.8-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:1c8ceb754339793c24aee1c9fb2485b5b1f5bb1c2c214ff13368431e51fc9a09", size = 124156, upload-time = "2024-12-24T18:29:45.368Z" }, - { url = "https://files.pythonhosted.org/packages/8d/2d/f13d06998b546a2ad4f48607a146e045bbe48030774de29f90bdc573df15/kiwisolver-1.4.8-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:54a62808ac74b5e55a04a408cda6156f986cefbcf0ada13572696b507cc92fa1", size = 66555, upload-time = "2024-12-24T18:29:46.37Z" }, - { url = "https://files.pythonhosted.org/packages/59/e3/b8bd14b0a54998a9fd1e8da591c60998dc003618cb19a3f94cb233ec1511/kiwisolver-1.4.8-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:68269e60ee4929893aad82666821aaacbd455284124817af45c11e50a4b42e3c", size = 65071, upload-time = "2024-12-24T18:29:47.333Z" }, - { url = "https://files.pythonhosted.org/packages/f0/1c/6c86f6d85ffe4d0ce04228d976f00674f1df5dc893bf2dd4f1928748f187/kiwisolver-1.4.8-cp313-cp313-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:34d142fba9c464bc3bbfeff15c96eab0e7310343d6aefb62a79d51421fcc5f1b", size = 1378053, upload-time = "2024-12-24T18:29:49.636Z" }, - { url = "https://files.pythonhosted.org/packages/4e/b9/1c6e9f6dcb103ac5cf87cb695845f5fa71379021500153566d8a8a9fc291/kiwisolver-1.4.8-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3ddc373e0eef45b59197de815b1b28ef89ae3955e7722cc9710fb91cd77b7f47", size = 1472278, upload-time = "2024-12-24T18:29:51.164Z" }, - { url = "https://files.pythonhosted.org/packages/ee/81/aca1eb176de671f8bda479b11acdc42c132b61a2ac861c883907dde6debb/kiwisolver-1.4.8-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:77e6f57a20b9bd4e1e2cedda4d0b986ebd0216236f0106e55c28aea3d3d69b16", size = 1478139, upload-time = "2024-12-24T18:29:52.594Z" }, - { url = "https://files.pythonhosted.org/packages/49/f4/e081522473671c97b2687d380e9e4c26f748a86363ce5af48b4a28e48d06/kiwisolver-1.4.8-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:08e77738ed7538f036cd1170cbed942ef749137b1311fa2bbe2a7fda2f6bf3cc", size = 1413517, upload-time = "2024-12-24T18:29:53.941Z" }, - { url = "https://files.pythonhosted.org/packages/8f/e9/6a7d025d8da8c4931522922cd706105aa32b3291d1add8c5427cdcd66e63/kiwisolver-1.4.8-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a5ce1e481a74b44dd5e92ff03ea0cb371ae7a0268318e202be06c8f04f4f1246", size = 1474952, upload-time = "2024-12-24T18:29:56.523Z" }, - { url = "https://files.pythonhosted.org/packages/82/13/13fa685ae167bee5d94b415991c4fc7bb0a1b6ebea6e753a87044b209678/kiwisolver-1.4.8-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:fc2ace710ba7c1dfd1a3b42530b62b9ceed115f19a1656adefce7b1782a37794", size = 2269132, upload-time = "2024-12-24T18:29:57.989Z" }, - { url = "https://files.pythonhosted.org/packages/ef/92/bb7c9395489b99a6cb41d502d3686bac692586db2045adc19e45ee64ed23/kiwisolver-1.4.8-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:3452046c37c7692bd52b0e752b87954ef86ee2224e624ef7ce6cb21e8c41cc1b", size = 2425997, upload-time = "2024-12-24T18:29:59.393Z" }, - { url = "https://files.pythonhosted.org/packages/ed/12/87f0e9271e2b63d35d0d8524954145837dd1a6c15b62a2d8c1ebe0f182b4/kiwisolver-1.4.8-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:7e9a60b50fe8b2ec6f448fe8d81b07e40141bfced7f896309df271a0b92f80f3", size = 2376060, upload-time = "2024-12-24T18:30:01.338Z" }, - { url = "https://files.pythonhosted.org/packages/02/6e/c8af39288edbce8bf0fa35dee427b082758a4b71e9c91ef18fa667782138/kiwisolver-1.4.8-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:918139571133f366e8362fa4a297aeba86c7816b7ecf0bc79168080e2bd79957", size = 2520471, upload-time = "2024-12-24T18:30:04.574Z" }, - { url = "https://files.pythonhosted.org/packages/13/78/df381bc7b26e535c91469f77f16adcd073beb3e2dd25042efd064af82323/kiwisolver-1.4.8-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:e063ef9f89885a1d68dd8b2e18f5ead48653176d10a0e324e3b0030e3a69adeb", size = 2338793, upload-time = "2024-12-24T18:30:06.25Z" }, - { url = "https://files.pythonhosted.org/packages/d0/dc/c1abe38c37c071d0fc71c9a474fd0b9ede05d42f5a458d584619cfd2371a/kiwisolver-1.4.8-cp313-cp313-win_amd64.whl", hash = "sha256:a17b7c4f5b2c51bb68ed379defd608a03954a1845dfed7cc0117f1cc8a9b7fd2", size = 71855, upload-time = "2024-12-24T18:30:07.535Z" }, - { url = "https://files.pythonhosted.org/packages/a0/b6/21529d595b126ac298fdd90b705d87d4c5693de60023e0efcb4f387ed99e/kiwisolver-1.4.8-cp313-cp313-win_arm64.whl", hash = "sha256:3cd3bc628b25f74aedc6d374d5babf0166a92ff1317f46267f12d2ed54bc1d30", size = 65430, upload-time = "2024-12-24T18:30:08.504Z" }, - { url = "https://files.pythonhosted.org/packages/34/bd/b89380b7298e3af9b39f49334e3e2a4af0e04819789f04b43d560516c0c8/kiwisolver-1.4.8-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:370fd2df41660ed4e26b8c9d6bbcad668fbe2560462cba151a721d49e5b6628c", size = 126294, upload-time = "2024-12-24T18:30:09.508Z" }, - { url = "https://files.pythonhosted.org/packages/83/41/5857dc72e5e4148eaac5aa76e0703e594e4465f8ab7ec0fc60e3a9bb8fea/kiwisolver-1.4.8-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:84a2f830d42707de1d191b9490ac186bf7997a9495d4e9072210a1296345f7dc", size = 67736, upload-time = "2024-12-24T18:30:11.039Z" }, - { url = "https://files.pythonhosted.org/packages/e1/d1/be059b8db56ac270489fb0b3297fd1e53d195ba76e9bbb30e5401fa6b759/kiwisolver-1.4.8-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:7a3ad337add5148cf51ce0b55642dc551c0b9d6248458a757f98796ca7348712", size = 66194, upload-time = "2024-12-24T18:30:14.886Z" }, - { url = "https://files.pythonhosted.org/packages/e1/83/4b73975f149819eb7dcf9299ed467eba068ecb16439a98990dcb12e63fdd/kiwisolver-1.4.8-cp313-cp313t-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7506488470f41169b86d8c9aeff587293f530a23a23a49d6bc64dab66bedc71e", size = 1465942, upload-time = "2024-12-24T18:30:18.927Z" }, - { url = "https://files.pythonhosted.org/packages/c7/2c/30a5cdde5102958e602c07466bce058b9d7cb48734aa7a4327261ac8e002/kiwisolver-1.4.8-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2f0121b07b356a22fb0414cec4666bbe36fd6d0d759db3d37228f496ed67c880", size = 1595341, upload-time = "2024-12-24T18:30:22.102Z" }, - { url = "https://files.pythonhosted.org/packages/ff/9b/1e71db1c000385aa069704f5990574b8244cce854ecd83119c19e83c9586/kiwisolver-1.4.8-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d6d6bd87df62c27d4185de7c511c6248040afae67028a8a22012b010bc7ad062", size = 1598455, upload-time = "2024-12-24T18:30:24.947Z" }, - { url = "https://files.pythonhosted.org/packages/85/92/c8fec52ddf06231b31cbb779af77e99b8253cd96bd135250b9498144c78b/kiwisolver-1.4.8-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:291331973c64bb9cce50bbe871fb2e675c4331dab4f31abe89f175ad7679a4d7", size = 1522138, upload-time = "2024-12-24T18:30:26.286Z" }, - { url = "https://files.pythonhosted.org/packages/0b/51/9eb7e2cd07a15d8bdd976f6190c0164f92ce1904e5c0c79198c4972926b7/kiwisolver-1.4.8-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:893f5525bb92d3d735878ec00f781b2de998333659507d29ea4466208df37bed", size = 1582857, upload-time = "2024-12-24T18:30:28.86Z" }, - { url = "https://files.pythonhosted.org/packages/0f/95/c5a00387a5405e68ba32cc64af65ce881a39b98d73cc394b24143bebc5b8/kiwisolver-1.4.8-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:b47a465040146981dc9db8647981b8cb96366fbc8d452b031e4f8fdffec3f26d", size = 2293129, upload-time = "2024-12-24T18:30:30.34Z" }, - { url = "https://files.pythonhosted.org/packages/44/83/eeb7af7d706b8347548313fa3a3a15931f404533cc54fe01f39e830dd231/kiwisolver-1.4.8-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:99cea8b9dd34ff80c521aef46a1dddb0dcc0283cf18bde6d756f1e6f31772165", size = 2421538, upload-time = "2024-12-24T18:30:33.334Z" }, - { url = "https://files.pythonhosted.org/packages/05/f9/27e94c1b3eb29e6933b6986ffc5fa1177d2cd1f0c8efc5f02c91c9ac61de/kiwisolver-1.4.8-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:151dffc4865e5fe6dafce5480fab84f950d14566c480c08a53c663a0020504b6", size = 2390661, upload-time = "2024-12-24T18:30:34.939Z" }, - { url = "https://files.pythonhosted.org/packages/d9/d4/3c9735faa36ac591a4afcc2980d2691000506050b7a7e80bcfe44048daa7/kiwisolver-1.4.8-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:577facaa411c10421314598b50413aa1ebcf5126f704f1e5d72d7e4e9f020d90", size = 2546710, upload-time = "2024-12-24T18:30:37.281Z" }, - { url = "https://files.pythonhosted.org/packages/4c/fa/be89a49c640930180657482a74970cdcf6f7072c8d2471e1babe17a222dc/kiwisolver-1.4.8-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:be4816dc51c8a471749d664161b434912eee82f2ea66bd7628bd14583a833e85", size = 2349213, upload-time = "2024-12-24T18:30:40.019Z" }, + { url = "https://files.pythonhosted.org/packages/31/c1/c2686cda909742ab66c7388e9a1a8521a59eb89f8bcfbee28fc980d07e24/kiwisolver-1.4.9-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:a5d0432ccf1c7ab14f9949eec60c5d1f924f17c037e9f8b33352fa05799359b8", size = 123681, upload-time = "2025-08-10T21:26:26.725Z" }, + { url = "https://files.pythonhosted.org/packages/ca/f0/f44f50c9f5b1a1860261092e3bc91ecdc9acda848a8b8c6abfda4a24dd5c/kiwisolver-1.4.9-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:efb3a45b35622bb6c16dbfab491a8f5a391fe0e9d45ef32f4df85658232ca0e2", size = 66464, upload-time = "2025-08-10T21:26:27.733Z" }, + { url = "https://files.pythonhosted.org/packages/2d/7a/9d90a151f558e29c3936b8a47ac770235f436f2120aca41a6d5f3d62ae8d/kiwisolver-1.4.9-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:1a12cf6398e8a0a001a059747a1cbf24705e18fe413bc22de7b3d15c67cffe3f", size = 64961, upload-time = "2025-08-10T21:26:28.729Z" }, + { url = "https://files.pythonhosted.org/packages/e9/e9/f218a2cb3a9ffbe324ca29a9e399fa2d2866d7f348ec3a88df87fc248fc5/kiwisolver-1.4.9-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:b67e6efbf68e077dd71d1a6b37e43e1a99d0bff1a3d51867d45ee8908b931098", size = 1474607, upload-time = "2025-08-10T21:26:29.798Z" }, + { url = "https://files.pythonhosted.org/packages/d9/28/aac26d4c882f14de59041636292bc838db8961373825df23b8eeb807e198/kiwisolver-1.4.9-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5656aa670507437af0207645273ccdfee4f14bacd7f7c67a4306d0dcaeaf6eed", size = 1276546, upload-time = "2025-08-10T21:26:31.401Z" }, + { url = "https://files.pythonhosted.org/packages/8b/ad/8bfc1c93d4cc565e5069162f610ba2f48ff39b7de4b5b8d93f69f30c4bed/kiwisolver-1.4.9-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:bfc08add558155345129c7803b3671cf195e6a56e7a12f3dde7c57d9b417f525", size = 1294482, upload-time = "2025-08-10T21:26:32.721Z" }, + { url = "https://files.pythonhosted.org/packages/da/f1/6aca55ff798901d8ce403206d00e033191f63d82dd708a186e0ed2067e9c/kiwisolver-1.4.9-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:40092754720b174e6ccf9e845d0d8c7d8e12c3d71e7fc35f55f3813e96376f78", size = 1343720, upload-time = "2025-08-10T21:26:34.032Z" }, + { url = "https://files.pythonhosted.org/packages/d1/91/eed031876c595c81d90d0f6fc681ece250e14bf6998c3d7c419466b523b7/kiwisolver-1.4.9-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:497d05f29a1300d14e02e6441cf0f5ee81c1ff5a304b0d9fb77423974684e08b", size = 2224907, upload-time = "2025-08-10T21:26:35.824Z" }, + { url = "https://files.pythonhosted.org/packages/e9/ec/4d1925f2e49617b9cca9c34bfa11adefad49d00db038e692a559454dfb2e/kiwisolver-1.4.9-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:bdd1a81a1860476eb41ac4bc1e07b3f07259e6d55bbf739b79c8aaedcf512799", size = 2321334, upload-time = "2025-08-10T21:26:37.534Z" }, + { url = "https://files.pythonhosted.org/packages/43/cb/450cd4499356f68802750c6ddc18647b8ea01ffa28f50d20598e0befe6e9/kiwisolver-1.4.9-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:e6b93f13371d341afee3be9f7c5964e3fe61d5fa30f6a30eb49856935dfe4fc3", size = 2488313, upload-time = "2025-08-10T21:26:39.191Z" }, + { url = "https://files.pythonhosted.org/packages/71/67/fc76242bd99f885651128a5d4fa6083e5524694b7c88b489b1b55fdc491d/kiwisolver-1.4.9-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:d75aa530ccfaa593da12834b86a0724f58bff12706659baa9227c2ccaa06264c", size = 2291970, upload-time = "2025-08-10T21:26:40.828Z" }, + { url = "https://files.pythonhosted.org/packages/75/bd/f1a5d894000941739f2ae1b65a32892349423ad49c2e6d0771d0bad3fae4/kiwisolver-1.4.9-cp313-cp313-win_amd64.whl", hash = "sha256:dd0a578400839256df88c16abddf9ba14813ec5f21362e1fe65022e00c883d4d", size = 73894, upload-time = "2025-08-10T21:26:42.33Z" }, + { url = "https://files.pythonhosted.org/packages/95/38/dce480814d25b99a391abbddadc78f7c117c6da34be68ca8b02d5848b424/kiwisolver-1.4.9-cp313-cp313-win_arm64.whl", hash = "sha256:d4188e73af84ca82468f09cadc5ac4db578109e52acb4518d8154698d3a87ca2", size = 64995, upload-time = "2025-08-10T21:26:43.889Z" }, + { url = "https://files.pythonhosted.org/packages/e2/37/7d218ce5d92dadc5ebdd9070d903e0c7cf7edfe03f179433ac4d13ce659c/kiwisolver-1.4.9-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:5a0f2724dfd4e3b3ac5a82436a8e6fd16baa7d507117e4279b660fe8ca38a3a1", size = 126510, upload-time = "2025-08-10T21:26:44.915Z" }, + { url = "https://files.pythonhosted.org/packages/23/b0/e85a2b48233daef4b648fb657ebbb6f8367696a2d9548a00b4ee0eb67803/kiwisolver-1.4.9-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:1b11d6a633e4ed84fc0ddafd4ebfd8ea49b3f25082c04ad12b8315c11d504dc1", size = 67903, upload-time = "2025-08-10T21:26:45.934Z" }, + { url = "https://files.pythonhosted.org/packages/44/98/f2425bc0113ad7de24da6bb4dae1343476e95e1d738be7c04d31a5d037fd/kiwisolver-1.4.9-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:61874cdb0a36016354853593cffc38e56fc9ca5aa97d2c05d3dcf6922cd55a11", size = 66402, upload-time = "2025-08-10T21:26:47.101Z" }, + { url = "https://files.pythonhosted.org/packages/98/d8/594657886df9f34c4177cc353cc28ca7e6e5eb562d37ccc233bff43bbe2a/kiwisolver-1.4.9-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:60c439763a969a6af93b4881db0eed8fadf93ee98e18cbc35bc8da868d0c4f0c", size = 1582135, upload-time = "2025-08-10T21:26:48.665Z" }, + { url = "https://files.pythonhosted.org/packages/5c/c6/38a115b7170f8b306fc929e166340c24958347308ea3012c2b44e7e295db/kiwisolver-1.4.9-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:92a2f997387a1b79a75e7803aa7ded2cfbe2823852ccf1ba3bcf613b62ae3197", size = 1389409, upload-time = "2025-08-10T21:26:50.335Z" }, + { url = "https://files.pythonhosted.org/packages/bf/3b/e04883dace81f24a568bcee6eb3001da4ba05114afa622ec9b6fafdc1f5e/kiwisolver-1.4.9-cp313-cp313t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a31d512c812daea6d8b3be3b2bfcbeb091dbb09177706569bcfc6240dcf8b41c", size = 1401763, upload-time = "2025-08-10T21:26:51.867Z" }, + { url = "https://files.pythonhosted.org/packages/9f/80/20ace48e33408947af49d7d15c341eaee69e4e0304aab4b7660e234d6288/kiwisolver-1.4.9-cp313-cp313t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:52a15b0f35dad39862d376df10c5230155243a2c1a436e39eb55623ccbd68185", size = 1453643, upload-time = "2025-08-10T21:26:53.592Z" }, + { url = "https://files.pythonhosted.org/packages/64/31/6ce4380a4cd1f515bdda976a1e90e547ccd47b67a1546d63884463c92ca9/kiwisolver-1.4.9-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:a30fd6fdef1430fd9e1ba7b3398b5ee4e2887783917a687d86ba69985fb08748", size = 2330818, upload-time = "2025-08-10T21:26:55.051Z" }, + { url = "https://files.pythonhosted.org/packages/fa/e9/3f3fcba3bcc7432c795b82646306e822f3fd74df0ee81f0fa067a1f95668/kiwisolver-1.4.9-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:cc9617b46837c6468197b5945e196ee9ca43057bb7d9d1ae688101e4e1dddf64", size = 2419963, upload-time = "2025-08-10T21:26:56.421Z" }, + { url = "https://files.pythonhosted.org/packages/99/43/7320c50e4133575c66e9f7dadead35ab22d7c012a3b09bb35647792b2a6d/kiwisolver-1.4.9-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:0ab74e19f6a2b027ea4f845a78827969af45ce790e6cb3e1ebab71bdf9f215ff", size = 2594639, upload-time = "2025-08-10T21:26:57.882Z" }, + { url = "https://files.pythonhosted.org/packages/65/d6/17ae4a270d4a987ef8a385b906d2bdfc9fce502d6dc0d3aea865b47f548c/kiwisolver-1.4.9-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:dba5ee5d3981160c28d5490f0d1b7ed730c22470ff7f6cc26cfcfaacb9896a07", size = 2391741, upload-time = "2025-08-10T21:26:59.237Z" }, + { url = "https://files.pythonhosted.org/packages/2a/8f/8f6f491d595a9e5912971f3f863d81baddccc8a4d0c3749d6a0dd9ffc9df/kiwisolver-1.4.9-cp313-cp313t-win_arm64.whl", hash = "sha256:0749fd8f4218ad2e851e11cc4dc05c7cbc0cbc4267bdfdb31782e65aace4ee9c", size = 68646, upload-time = "2025-08-10T21:27:00.52Z" }, + { url = "https://files.pythonhosted.org/packages/6b/32/6cc0fbc9c54d06c2969faa9c1d29f5751a2e51809dd55c69055e62d9b426/kiwisolver-1.4.9-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:9928fe1eb816d11ae170885a74d074f57af3a0d65777ca47e9aeb854a1fba386", size = 123806, upload-time = "2025-08-10T21:27:01.537Z" }, + { url = "https://files.pythonhosted.org/packages/b2/dd/2bfb1d4a4823d92e8cbb420fe024b8d2167f72079b3bb941207c42570bdf/kiwisolver-1.4.9-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:d0005b053977e7b43388ddec89fa567f43d4f6d5c2c0affe57de5ebf290dc552", size = 66605, upload-time = "2025-08-10T21:27:03.335Z" }, + { url = "https://files.pythonhosted.org/packages/f7/69/00aafdb4e4509c2ca6064646cba9cd4b37933898f426756adb2cb92ebbed/kiwisolver-1.4.9-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:2635d352d67458b66fd0667c14cb1d4145e9560d503219034a18a87e971ce4f3", size = 64925, upload-time = "2025-08-10T21:27:04.339Z" }, + { url = "https://files.pythonhosted.org/packages/43/dc/51acc6791aa14e5cb6d8a2e28cefb0dc2886d8862795449d021334c0df20/kiwisolver-1.4.9-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:767c23ad1c58c9e827b649a9ab7809fd5fd9db266a9cf02b0e926ddc2c680d58", size = 1472414, upload-time = "2025-08-10T21:27:05.437Z" }, + { url = "https://files.pythonhosted.org/packages/3d/bb/93fa64a81db304ac8a246f834d5094fae4b13baf53c839d6bb6e81177129/kiwisolver-1.4.9-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:72d0eb9fba308b8311685c2268cf7d0a0639a6cd027d8128659f72bdd8a024b4", size = 1281272, upload-time = "2025-08-10T21:27:07.063Z" }, + { url = "https://files.pythonhosted.org/packages/70/e6/6df102916960fb8d05069d4bd92d6d9a8202d5a3e2444494e7cd50f65b7a/kiwisolver-1.4.9-cp314-cp314-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f68e4f3eeca8fb22cc3d731f9715a13b652795ef657a13df1ad0c7dc0e9731df", size = 1298578, upload-time = "2025-08-10T21:27:08.452Z" }, + { url = "https://files.pythonhosted.org/packages/7c/47/e142aaa612f5343736b087864dbaebc53ea8831453fb47e7521fa8658f30/kiwisolver-1.4.9-cp314-cp314-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d84cd4061ae292d8ac367b2c3fa3aad11cb8625a95d135fe93f286f914f3f5a6", size = 1345607, upload-time = "2025-08-10T21:27:10.125Z" }, + { url = "https://files.pythonhosted.org/packages/54/89/d641a746194a0f4d1a3670fb900d0dbaa786fb98341056814bc3f058fa52/kiwisolver-1.4.9-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a60ea74330b91bd22a29638940d115df9dc00af5035a9a2a6ad9399ffb4ceca5", size = 2230150, upload-time = "2025-08-10T21:27:11.484Z" }, + { url = "https://files.pythonhosted.org/packages/aa/6b/5ee1207198febdf16ac11f78c5ae40861b809cbe0e6d2a8d5b0b3044b199/kiwisolver-1.4.9-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:ce6a3a4e106cf35c2d9c4fa17c05ce0b180db622736845d4315519397a77beaf", size = 2325979, upload-time = "2025-08-10T21:27:12.917Z" }, + { url = "https://files.pythonhosted.org/packages/fc/ff/b269eefd90f4ae14dcc74973d5a0f6d28d3b9bb1afd8c0340513afe6b39a/kiwisolver-1.4.9-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:77937e5e2a38a7b48eef0585114fe7930346993a88060d0bf886086d2aa49ef5", size = 2491456, upload-time = "2025-08-10T21:27:14.353Z" }, + { url = "https://files.pythonhosted.org/packages/fc/d4/10303190bd4d30de547534601e259a4fbf014eed94aae3e5521129215086/kiwisolver-1.4.9-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:24c175051354f4a28c5d6a31c93906dc653e2bf234e8a4bbfb964892078898ce", size = 2294621, upload-time = "2025-08-10T21:27:15.808Z" }, + { url = "https://files.pythonhosted.org/packages/28/e0/a9a90416fce5c0be25742729c2ea52105d62eda6c4be4d803c2a7be1fa50/kiwisolver-1.4.9-cp314-cp314-win_amd64.whl", hash = "sha256:0763515d4df10edf6d06a3c19734e2566368980d21ebec439f33f9eb936c07b7", size = 75417, upload-time = "2025-08-10T21:27:17.436Z" }, + { url = "https://files.pythonhosted.org/packages/1f/10/6949958215b7a9a264299a7db195564e87900f709db9245e4ebdd3c70779/kiwisolver-1.4.9-cp314-cp314-win_arm64.whl", hash = "sha256:0e4e2bf29574a6a7b7f6cb5fa69293b9f96c928949ac4a53ba3f525dffb87f9c", size = 66582, upload-time = "2025-08-10T21:27:18.436Z" }, + { url = "https://files.pythonhosted.org/packages/ec/79/60e53067903d3bc5469b369fe0dfc6b3482e2133e85dae9daa9527535991/kiwisolver-1.4.9-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:d976bbb382b202f71c67f77b0ac11244021cfa3f7dfd9e562eefcea2df711548", size = 126514, upload-time = "2025-08-10T21:27:19.465Z" }, + { url = "https://files.pythonhosted.org/packages/25/d1/4843d3e8d46b072c12a38c97c57fab4608d36e13fe47d47ee96b4d61ba6f/kiwisolver-1.4.9-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:2489e4e5d7ef9a1c300a5e0196e43d9c739f066ef23270607d45aba368b91f2d", size = 67905, upload-time = "2025-08-10T21:27:20.51Z" }, + { url = "https://files.pythonhosted.org/packages/8c/ae/29ffcbd239aea8b93108de1278271ae764dfc0d803a5693914975f200596/kiwisolver-1.4.9-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:e2ea9f7ab7fbf18fffb1b5434ce7c69a07582f7acc7717720f1d69f3e806f90c", size = 66399, upload-time = "2025-08-10T21:27:21.496Z" }, + { url = "https://files.pythonhosted.org/packages/a1/ae/d7ba902aa604152c2ceba5d352d7b62106bedbccc8e95c3934d94472bfa3/kiwisolver-1.4.9-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:b34e51affded8faee0dfdb705416153819d8ea9250bbbf7ea1b249bdeb5f1122", size = 1582197, upload-time = "2025-08-10T21:27:22.604Z" }, + { url = "https://files.pythonhosted.org/packages/f2/41/27c70d427eddb8bc7e4f16420a20fefc6f480312122a59a959fdfe0445ad/kiwisolver-1.4.9-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d8aacd3d4b33b772542b2e01beb50187536967b514b00003bdda7589722d2a64", size = 1390125, upload-time = "2025-08-10T21:27:24.036Z" }, + { url = "https://files.pythonhosted.org/packages/41/42/b3799a12bafc76d962ad69083f8b43b12bf4fe78b097b12e105d75c9b8f1/kiwisolver-1.4.9-cp314-cp314t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:7cf974dd4e35fa315563ac99d6287a1024e4dc2077b8a7d7cd3d2fb65d283134", size = 1402612, upload-time = "2025-08-10T21:27:25.773Z" }, + { url = "https://files.pythonhosted.org/packages/d2/b5/a210ea073ea1cfaca1bb5c55a62307d8252f531beb364e18aa1e0888b5a0/kiwisolver-1.4.9-cp314-cp314t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:85bd218b5ecfbee8c8a82e121802dcb519a86044c9c3b2e4aef02fa05c6da370", size = 1453990, upload-time = "2025-08-10T21:27:27.089Z" }, + { url = "https://files.pythonhosted.org/packages/5f/ce/a829eb8c033e977d7ea03ed32fb3c1781b4fa0433fbadfff29e39c676f32/kiwisolver-1.4.9-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:0856e241c2d3df4efef7c04a1e46b1936b6120c9bcf36dd216e3acd84bc4fb21", size = 2331601, upload-time = "2025-08-10T21:27:29.343Z" }, + { url = "https://files.pythonhosted.org/packages/e0/4b/b5e97eb142eb9cd0072dacfcdcd31b1c66dc7352b0f7c7255d339c0edf00/kiwisolver-1.4.9-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:9af39d6551f97d31a4deebeac6f45b156f9755ddc59c07b402c148f5dbb6482a", size = 2422041, upload-time = "2025-08-10T21:27:30.754Z" }, + { url = "https://files.pythonhosted.org/packages/40/be/8eb4cd53e1b85ba4edc3a9321666f12b83113a178845593307a3e7891f44/kiwisolver-1.4.9-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:bb4ae2b57fc1d8cbd1cf7b1d9913803681ffa903e7488012be5b76dedf49297f", size = 2594897, upload-time = "2025-08-10T21:27:32.803Z" }, + { url = "https://files.pythonhosted.org/packages/99/dd/841e9a66c4715477ea0abc78da039832fbb09dac5c35c58dc4c41a407b8a/kiwisolver-1.4.9-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:aedff62918805fb62d43a4aa2ecd4482c380dc76cd31bd7c8878588a61bd0369", size = 2391835, upload-time = "2025-08-10T21:27:34.23Z" }, + { url = "https://files.pythonhosted.org/packages/0c/28/4b2e5c47a0da96896fdfdb006340ade064afa1e63675d01ea5ac222b6d52/kiwisolver-1.4.9-cp314-cp314t-win_amd64.whl", hash = "sha256:1fa333e8b2ce4d9660f2cda9c0e1b6bafcfb2457a9d259faa82289e73ec24891", size = 79988, upload-time = "2025-08-10T21:27:35.587Z" }, + { url = "https://files.pythonhosted.org/packages/80/be/3578e8afd18c88cdf9cb4cffde75a96d2be38c5a903f1ed0ceec061bd09e/kiwisolver-1.4.9-cp314-cp314t-win_arm64.whl", hash = "sha256:4a48a2ce79d65d363597ef7b567ce3d14d68783d2b2263d98db3d9477805ba32", size = 70260, upload-time = "2025-08-10T21:27:36.606Z" }, ] [[package]] name = "lark" -version = "1.2.2" +version = "1.3.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/af/60/bc7622aefb2aee1c0b4ba23c1446d3e30225c8770b38d7aedbfb65ca9d5a/lark-1.2.2.tar.gz", hash = "sha256:ca807d0162cd16cef15a8feecb862d7319e7a09bdb13aef927968e45040fed80", size = 252132, upload-time = "2024-08-13T19:49:00.652Z" } +sdist = { url = "https://files.pythonhosted.org/packages/da/34/28fff3ab31ccff1fd4f6c7c7b0ceb2b6968d8ea4950663eadcb5720591a0/lark-1.3.1.tar.gz", hash = "sha256:b426a7a6d6d53189d318f2b6236ab5d6429eaf09259f1ca33eb716eed10d2905", size = 382732, upload-time = "2025-10-27T18:25:56.653Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/2d/00/d90b10b962b4277f5e64a78b6609968859ff86889f5b898c1a778c06ec00/lark-1.2.2-py3-none-any.whl", hash = "sha256:c2276486b02f0f1b90be155f2c8ba4a8e194d42775786db622faccd652d8e80c", size = 111036, upload-time = "2024-08-13T19:48:58.603Z" }, + { url = "https://files.pythonhosted.org/packages/82/3d/14ce75ef66813643812f3093ab17e46d3a206942ce7376d31ec2d36229e7/lark-1.3.1-py3-none-any.whl", hash = "sha256:c629b661023a014c37da873b4ff58a817398d12635d3bbb2c5a03be7fe5d1e12", size = 113151, upload-time = "2025-10-27T18:25:54.882Z" }, ] [[package]] name = "llvmlite" -version = "0.44.0" +version = "0.46.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/89/6a/95a3d3610d5c75293d5dbbb2a76480d5d4eeba641557b69fe90af6c5b84e/llvmlite-0.44.0.tar.gz", hash = "sha256:07667d66a5d150abed9157ab6c0b9393c9356f229784a4385c02f99e94fc94d4", size = 171880, upload-time = "2025-01-20T11:14:41.342Z" } +sdist = { url = "https://files.pythonhosted.org/packages/74/cd/08ae687ba099c7e3d21fe2ea536500563ef1943c5105bf6ab4ee3829f68e/llvmlite-0.46.0.tar.gz", hash = "sha256:227c9fd6d09dce2783c18b754b7cd9d9b3b3515210c46acc2d3c5badd9870ceb", size = 193456, upload-time = "2025-12-08T18:15:36.295Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/89/24/4c0ca705a717514c2092b18476e7a12c74d34d875e05e4d742618ebbf449/llvmlite-0.44.0-cp313-cp313-macosx_10_14_x86_64.whl", hash = "sha256:319bddd44e5f71ae2689859b7203080716448a3cd1128fb144fe5c055219d516", size = 28132306, upload-time = "2025-01-20T11:14:09.035Z" }, - { url = "https://files.pythonhosted.org/packages/01/cf/1dd5a60ba6aee7122ab9243fd614abcf22f36b0437cbbe1ccf1e3391461c/llvmlite-0.44.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:9c58867118bad04a0bb22a2e0068c693719658105e40009ffe95c7000fcde88e", size = 26201090, upload-time = "2025-01-20T11:14:15.401Z" }, - { url = "https://files.pythonhosted.org/packages/d2/1b/656f5a357de7135a3777bd735cc7c9b8f23b4d37465505bd0eaf4be9befe/llvmlite-0.44.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:46224058b13c96af1365290bdfebe9a6264ae62fb79b2b55693deed11657a8bf", size = 42361904, upload-time = "2025-01-20T11:14:22.949Z" }, - { url = "https://files.pythonhosted.org/packages/d8/e1/12c5f20cb9168fb3464a34310411d5ad86e4163c8ff2d14a2b57e5cc6bac/llvmlite-0.44.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:aa0097052c32bf721a4efc03bd109d335dfa57d9bffb3d4c24cc680711b8b4fc", size = 41184245, upload-time = "2025-01-20T11:14:31.731Z" }, - { url = "https://files.pythonhosted.org/packages/d0/81/e66fc86539293282fd9cb7c9417438e897f369e79ffb62e1ae5e5154d4dd/llvmlite-0.44.0-cp313-cp313-win_amd64.whl", hash = "sha256:2fb7c4f2fb86cbae6dca3db9ab203eeea0e22d73b99bc2341cdf9de93612e930", size = 30331193, upload-time = "2025-01-20T11:14:38.578Z" }, + { url = "https://files.pythonhosted.org/packages/e6/ff/3eba7eb0aed4b6fca37125387cd417e8c458e750621fce56d2c541f67fa8/llvmlite-0.46.0-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:30b60892d034bc560e0ec6654737aaa74e5ca327bd8114d82136aa071d611172", size = 37232767, upload-time = "2025-12-08T18:15:13.22Z" }, + { url = "https://files.pythonhosted.org/packages/0e/54/737755c0a91558364b9200702c3c9c15d70ed63f9b98a2c32f1c2aa1f3ba/llvmlite-0.46.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:6cc19b051753368a9c9f31dc041299059ee91aceec81bd57b0e385e5d5bf1a54", size = 56275176, upload-time = "2025-12-08T18:15:16.339Z" }, + { url = "https://files.pythonhosted.org/packages/e6/91/14f32e1d70905c1c0aa4e6609ab5d705c3183116ca02ac6df2091868413a/llvmlite-0.46.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bca185892908f9ede48c0acd547fe4dc1bafefb8a4967d47db6cf664f9332d12", size = 55128629, upload-time = "2025-12-08T18:15:19.493Z" }, + { url = "https://files.pythonhosted.org/packages/4a/a7/d526ae86708cea531935ae777b6dbcabe7db52718e6401e0fb9c5edea80e/llvmlite-0.46.0-cp313-cp313-win_amd64.whl", hash = "sha256:67438fd30e12349ebb054d86a5a1a57fd5e87d264d2451bcfafbbbaa25b82a35", size = 38138941, upload-time = "2025-12-08T18:15:22.536Z" }, + { url = "https://files.pythonhosted.org/packages/95/ae/af0ffb724814cc2ea64445acad05f71cff5f799bb7efb22e47ee99340dbc/llvmlite-0.46.0-cp314-cp314-macosx_12_0_arm64.whl", hash = "sha256:d252edfb9f4ac1fcf20652258e3f102b26b03eef738dc8a6ffdab7d7d341d547", size = 37232768, upload-time = "2025-12-08T18:15:25.055Z" }, + { url = "https://files.pythonhosted.org/packages/c9/19/5018e5352019be753b7b07f7759cdabb69ca5779fea2494be8839270df4c/llvmlite-0.46.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:379fdd1c59badeff8982cb47e4694a6143bec3bb49aa10a466e095410522064d", size = 56275173, upload-time = "2025-12-08T18:15:28.109Z" }, + { url = "https://files.pythonhosted.org/packages/9f/c9/d57877759d707e84c082163c543853245f91b70c804115a5010532890f18/llvmlite-0.46.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2e8cbfff7f6db0fa2c771ad24154e2a7e457c2444d7673e6de06b8b698c3b269", size = 55128628, upload-time = "2025-12-08T18:15:31.098Z" }, + { url = "https://files.pythonhosted.org/packages/30/a8/e61a8c2b3cc7a597073d9cde1fcbb567e9d827f1db30c93cf80422eac70d/llvmlite-0.46.0-cp314-cp314-win_amd64.whl", hash = "sha256:7821eda3ec1f18050f981819756631d60b6d7ab1a6cf806d9efefbe3f4082d61", size = 39153056, upload-time = "2025-12-08T18:15:33.938Z" }, ] [[package]] name = "markupsafe" -version = "3.0.2" +version = "3.0.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/b2/97/5d42485e71dfc078108a86d6de8fa46db44a1a9295e89c5d6d4a06e23a62/markupsafe-3.0.2.tar.gz", hash = "sha256:ee55d3edf80167e48ea11a923c7386f4669df67d7994554387f84e7d8b0a2bf0", size = 20537, upload-time = "2024-10-18T15:21:54.129Z" } +sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313, upload-time = "2025-09-27T18:37:40.426Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/83/0e/67eb10a7ecc77a0c2bbe2b0235765b98d164d81600746914bebada795e97/MarkupSafe-3.0.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:ba9527cdd4c926ed0760bc301f6728ef34d841f405abf9d4f959c478421e4efd", size = 14274, upload-time = "2024-10-18T15:21:24.577Z" }, - { url = "https://files.pythonhosted.org/packages/2b/6d/9409f3684d3335375d04e5f05744dfe7e9f120062c9857df4ab490a1031a/MarkupSafe-3.0.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:f8b3d067f2e40fe93e1ccdd6b2e1d16c43140e76f02fb1319a05cf2b79d99430", size = 12352, upload-time = "2024-10-18T15:21:25.382Z" }, - { url = "https://files.pythonhosted.org/packages/d2/f5/6eadfcd3885ea85fe2a7c128315cc1bb7241e1987443d78c8fe712d03091/MarkupSafe-3.0.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:569511d3b58c8791ab4c2e1285575265991e6d8f8700c7be0e88f86cb0672094", size = 24122, upload-time = "2024-10-18T15:21:26.199Z" }, - { url = "https://files.pythonhosted.org/packages/0c/91/96cf928db8236f1bfab6ce15ad070dfdd02ed88261c2afafd4b43575e9e9/MarkupSafe-3.0.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:15ab75ef81add55874e7ab7055e9c397312385bd9ced94920f2802310c930396", size = 23085, upload-time = "2024-10-18T15:21:27.029Z" }, - { url = "https://files.pythonhosted.org/packages/c2/cf/c9d56af24d56ea04daae7ac0940232d31d5a8354f2b457c6d856b2057d69/MarkupSafe-3.0.2-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f3818cb119498c0678015754eba762e0d61e5b52d34c8b13d770f0719f7b1d79", size = 22978, upload-time = "2024-10-18T15:21:27.846Z" }, - { url = "https://files.pythonhosted.org/packages/2a/9f/8619835cd6a711d6272d62abb78c033bda638fdc54c4e7f4272cf1c0962b/MarkupSafe-3.0.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:cdb82a876c47801bb54a690c5ae105a46b392ac6099881cdfb9f6e95e4014c6a", size = 24208, upload-time = "2024-10-18T15:21:28.744Z" }, - { url = "https://files.pythonhosted.org/packages/f9/bf/176950a1792b2cd2102b8ffeb5133e1ed984547b75db47c25a67d3359f77/MarkupSafe-3.0.2-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:cabc348d87e913db6ab4aa100f01b08f481097838bdddf7c7a84b7575b7309ca", size = 23357, upload-time = "2024-10-18T15:21:29.545Z" }, - { url = "https://files.pythonhosted.org/packages/ce/4f/9a02c1d335caabe5c4efb90e1b6e8ee944aa245c1aaaab8e8a618987d816/MarkupSafe-3.0.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:444dcda765c8a838eaae23112db52f1efaf750daddb2d9ca300bcae1039adc5c", size = 23344, upload-time = "2024-10-18T15:21:30.366Z" }, - { url = "https://files.pythonhosted.org/packages/ee/55/c271b57db36f748f0e04a759ace9f8f759ccf22b4960c270c78a394f58be/MarkupSafe-3.0.2-cp313-cp313-win32.whl", hash = "sha256:bcf3e58998965654fdaff38e58584d8937aa3096ab5354d493c77d1fdd66d7a1", size = 15101, upload-time = "2024-10-18T15:21:31.207Z" }, - { url = "https://files.pythonhosted.org/packages/29/88/07df22d2dd4df40aba9f3e402e6dc1b8ee86297dddbad4872bd5e7b0094f/MarkupSafe-3.0.2-cp313-cp313-win_amd64.whl", hash = "sha256:e6a2a455bd412959b57a172ce6328d2dd1f01cb2135efda2e4576e8a23fa3b0f", size = 15603, upload-time = "2024-10-18T15:21:32.032Z" }, - { url = "https://files.pythonhosted.org/packages/62/6a/8b89d24db2d32d433dffcd6a8779159da109842434f1dd2f6e71f32f738c/MarkupSafe-3.0.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:b5a6b3ada725cea8a5e634536b1b01c30bcdcd7f9c6fff4151548d5bf6b3a36c", size = 14510, upload-time = "2024-10-18T15:21:33.625Z" }, - { url = "https://files.pythonhosted.org/packages/7a/06/a10f955f70a2e5a9bf78d11a161029d278eeacbd35ef806c3fd17b13060d/MarkupSafe-3.0.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:a904af0a6162c73e3edcb969eeeb53a63ceeb5d8cf642fade7d39e7963a22ddb", size = 12486, upload-time = "2024-10-18T15:21:34.611Z" }, - { url = "https://files.pythonhosted.org/packages/34/cf/65d4a571869a1a9078198ca28f39fba5fbb910f952f9dbc5220afff9f5e6/MarkupSafe-3.0.2-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4aa4e5faecf353ed117801a068ebab7b7e09ffb6e1d5e412dc852e0da018126c", size = 25480, upload-time = "2024-10-18T15:21:35.398Z" }, - { url = "https://files.pythonhosted.org/packages/0c/e3/90e9651924c430b885468b56b3d597cabf6d72be4b24a0acd1fa0e12af67/MarkupSafe-3.0.2-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c0ef13eaeee5b615fb07c9a7dadb38eac06a0608b41570d8ade51c56539e509d", size = 23914, upload-time = "2024-10-18T15:21:36.231Z" }, - { url = "https://files.pythonhosted.org/packages/66/8c/6c7cf61f95d63bb866db39085150df1f2a5bd3335298f14a66b48e92659c/MarkupSafe-3.0.2-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d16a81a06776313e817c951135cf7340a3e91e8c1ff2fac444cfd75fffa04afe", size = 23796, upload-time = "2024-10-18T15:21:37.073Z" }, - { url = "https://files.pythonhosted.org/packages/bb/35/cbe9238ec3f47ac9a7c8b3df7a808e7cb50fe149dc7039f5f454b3fba218/MarkupSafe-3.0.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:6381026f158fdb7c72a168278597a5e3a5222e83ea18f543112b2662a9b699c5", size = 25473, upload-time = "2024-10-18T15:21:37.932Z" }, - { url = "https://files.pythonhosted.org/packages/e6/32/7621a4382488aa283cc05e8984a9c219abad3bca087be9ec77e89939ded9/MarkupSafe-3.0.2-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:3d79d162e7be8f996986c064d1c7c817f6df3a77fe3d6859f6f9e7be4b8c213a", size = 24114, upload-time = "2024-10-18T15:21:39.799Z" }, - { url = "https://files.pythonhosted.org/packages/0d/80/0985960e4b89922cb5a0bac0ed39c5b96cbc1a536a99f30e8c220a996ed9/MarkupSafe-3.0.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:131a3c7689c85f5ad20f9f6fb1b866f402c445b220c19fe4308c0b147ccd2ad9", size = 24098, upload-time = "2024-10-18T15:21:40.813Z" }, - { url = "https://files.pythonhosted.org/packages/82/78/fedb03c7d5380df2427038ec8d973587e90561b2d90cd472ce9254cf348b/MarkupSafe-3.0.2-cp313-cp313t-win32.whl", hash = "sha256:ba8062ed2cf21c07a9e295d5b8a2a5ce678b913b45fdf68c32d95d6c1291e0b6", size = 15208, upload-time = "2024-10-18T15:21:41.814Z" }, - { url = "https://files.pythonhosted.org/packages/4f/65/6079a46068dfceaeabb5dcad6d674f5f5c61a6fa5673746f42a9f4c233b3/MarkupSafe-3.0.2-cp313-cp313t-win_amd64.whl", hash = "sha256:e444a31f8db13eb18ada366ab3cf45fd4b31e4db1236a4448f68778c1d1a5a2f", size = 15739, upload-time = "2024-10-18T15:21:42.784Z" }, + { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" }, + { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" }, + { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" }, + { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" }, + { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" }, + { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" }, + { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" }, + { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" }, + { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" }, + { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" }, + { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" }, + { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" }, + { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" }, + { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" }, + { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" }, + { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" }, + { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" }, + { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" }, + { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" }, + { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" }, + { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" }, + { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" }, + { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619, upload-time = "2025-09-27T18:37:06.342Z" }, + { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029, upload-time = "2025-09-27T18:37:07.213Z" }, + { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408, upload-time = "2025-09-27T18:37:09.572Z" }, + { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005, upload-time = "2025-09-27T18:37:10.58Z" }, + { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048, upload-time = "2025-09-27T18:37:11.547Z" }, + { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821, upload-time = "2025-09-27T18:37:12.48Z" }, + { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606, upload-time = "2025-09-27T18:37:13.485Z" }, + { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043, upload-time = "2025-09-27T18:37:14.408Z" }, + { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747, upload-time = "2025-09-27T18:37:15.36Z" }, + { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341, upload-time = "2025-09-27T18:37:16.496Z" }, + { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073, upload-time = "2025-09-27T18:37:17.476Z" }, + { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661, upload-time = "2025-09-27T18:37:18.453Z" }, + { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069, upload-time = "2025-09-27T18:37:19.332Z" }, + { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670, upload-time = "2025-09-27T18:37:20.245Z" }, + { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598, upload-time = "2025-09-27T18:37:21.177Z" }, + { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261, upload-time = "2025-09-27T18:37:22.167Z" }, + { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835, upload-time = "2025-09-27T18:37:23.296Z" }, + { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733, upload-time = "2025-09-27T18:37:24.237Z" }, + { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672, upload-time = "2025-09-27T18:37:25.271Z" }, + { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819, upload-time = "2025-09-27T18:37:26.285Z" }, + { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426, upload-time = "2025-09-27T18:37:27.316Z" }, + { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146, upload-time = "2025-09-27T18:37:28.327Z" }, ] [[package]] name = "matplotlib" -version = "3.10.5" +version = "3.10.8" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "contourpy" }, @@ -973,68 +1082,69 @@ dependencies = [ { name = "pyparsing" }, { name = "python-dateutil" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/43/91/f2939bb60b7ebf12478b030e0d7f340247390f402b3b189616aad790c366/matplotlib-3.10.5.tar.gz", hash = "sha256:352ed6ccfb7998a00881692f38b4ca083c691d3e275b4145423704c34c909076", size = 34804044, upload-time = "2025-07-31T18:09:33.805Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8a/76/d3c6e3a13fe484ebe7718d14e269c9569c4eb0020a968a327acb3b9a8fe6/matplotlib-3.10.8.tar.gz", hash = "sha256:2299372c19d56bcd35cf05a2738308758d32b9eaed2371898d8f5bd33f084aa3", size = 34806269, upload-time = "2025-12-10T22:56:51.155Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/8d/05/4f3c1f396075f108515e45cb8d334aff011a922350e502a7472e24c52d77/matplotlib-3.10.5-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:354204db3f7d5caaa10e5de74549ef6a05a4550fdd1c8f831ab9bca81efd39ed", size = 8253586, upload-time = "2025-07-31T18:08:23.107Z" }, - { url = "https://files.pythonhosted.org/packages/2f/2c/e084415775aac7016c3719fe7006cdb462582c6c99ac142f27303c56e243/matplotlib-3.10.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:b072aac0c3ad563a2b3318124756cb6112157017f7431626600ecbe890df57a1", size = 8110715, upload-time = "2025-07-31T18:08:24.675Z" }, - { url = "https://files.pythonhosted.org/packages/52/1b/233e3094b749df16e3e6cd5a44849fd33852e692ad009cf7de00cf58ddf6/matplotlib-3.10.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d52fd5b684d541b5a51fb276b2b97b010c75bee9aa392f96b4a07aeb491e33c7", size = 8669397, upload-time = "2025-07-31T18:08:26.778Z" }, - { url = "https://files.pythonhosted.org/packages/e8/ec/03f9e003a798f907d9f772eed9b7c6a9775d5bd00648b643ebfb88e25414/matplotlib-3.10.5-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee7a09ae2f4676276f5a65bd9f2bd91b4f9fbaedf49f40267ce3f9b448de501f", size = 9508646, upload-time = "2025-07-31T18:08:28.848Z" }, - { url = "https://files.pythonhosted.org/packages/91/e7/c051a7a386680c28487bca27d23b02d84f63e3d2a9b4d2fc478e6a42e37e/matplotlib-3.10.5-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ba6c3c9c067b83481d647af88b4e441d532acdb5ef22178a14935b0b881188f4", size = 9567424, upload-time = "2025-07-31T18:08:30.726Z" }, - { url = "https://files.pythonhosted.org/packages/36/c2/24302e93ff431b8f4173ee1dd88976c8d80483cadbc5d3d777cef47b3a1c/matplotlib-3.10.5-cp313-cp313-win_amd64.whl", hash = "sha256:07442d2692c9bd1cceaa4afb4bbe5b57b98a7599de4dabfcca92d3eea70f9ebe", size = 8107809, upload-time = "2025-07-31T18:08:33.928Z" }, - { url = "https://files.pythonhosted.org/packages/0b/33/423ec6a668d375dad825197557ed8fbdb74d62b432c1ed8235465945475f/matplotlib-3.10.5-cp313-cp313-win_arm64.whl", hash = "sha256:48fe6d47380b68a37ccfcc94f009530e84d41f71f5dae7eda7c4a5a84aa0a674", size = 7978078, upload-time = "2025-07-31T18:08:36.764Z" }, - { url = "https://files.pythonhosted.org/packages/51/17/521fc16ec766455c7bb52cc046550cf7652f6765ca8650ff120aa2d197b6/matplotlib-3.10.5-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:3b80eb8621331449fc519541a7461987f10afa4f9cfd91afcd2276ebe19bd56c", size = 8295590, upload-time = "2025-07-31T18:08:38.521Z" }, - { url = "https://files.pythonhosted.org/packages/f8/12/23c28b2c21114c63999bae129fce7fd34515641c517ae48ce7b7dcd33458/matplotlib-3.10.5-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:47a388908e469d6ca2a6015858fa924e0e8a2345a37125948d8e93a91c47933e", size = 8158518, upload-time = "2025-07-31T18:08:40.195Z" }, - { url = "https://files.pythonhosted.org/packages/81/f8/aae4eb25e8e7190759f3cb91cbeaa344128159ac92bb6b409e24f8711f78/matplotlib-3.10.5-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8b6b49167d208358983ce26e43aa4196073b4702858670f2eb111f9a10652b4b", size = 8691815, upload-time = "2025-07-31T18:08:42.238Z" }, - { url = "https://files.pythonhosted.org/packages/d0/ba/450c39ebdd486bd33a359fc17365ade46c6a96bf637bbb0df7824de2886c/matplotlib-3.10.5-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8a8da0453a7fd8e3da114234ba70c5ba9ef0e98f190309ddfde0f089accd46ea", size = 9522814, upload-time = "2025-07-31T18:08:44.914Z" }, - { url = "https://files.pythonhosted.org/packages/89/11/9c66f6a990e27bb9aa023f7988d2d5809cb98aa39c09cbf20fba75a542ef/matplotlib-3.10.5-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:52c6573dfcb7726a9907b482cd5b92e6b5499b284ffacb04ffbfe06b3e568124", size = 9573917, upload-time = "2025-07-31T18:08:47.038Z" }, - { url = "https://files.pythonhosted.org/packages/b3/69/8b49394de92569419e5e05e82e83df9b749a0ff550d07631ea96ed2eb35a/matplotlib-3.10.5-cp313-cp313t-win_amd64.whl", hash = "sha256:a23193db2e9d64ece69cac0c8231849db7dd77ce59c7b89948cf9d0ce655a3ce", size = 8181034, upload-time = "2025-07-31T18:08:48.943Z" }, - { url = "https://files.pythonhosted.org/packages/47/23/82dc435bb98a2fc5c20dffcac8f0b083935ac28286413ed8835df40d0baa/matplotlib-3.10.5-cp313-cp313t-win_arm64.whl", hash = "sha256:56da3b102cf6da2776fef3e71cd96fcf22103a13594a18ac9a9b31314e0be154", size = 8023337, upload-time = "2025-07-31T18:08:50.791Z" }, - { url = "https://files.pythonhosted.org/packages/ac/e0/26b6cfde31f5383503ee45dcb7e691d45dadf0b3f54639332b59316a97f8/matplotlib-3.10.5-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:96ef8f5a3696f20f55597ffa91c28e2e73088df25c555f8d4754931515512715", size = 8253591, upload-time = "2025-07-31T18:08:53.254Z" }, - { url = "https://files.pythonhosted.org/packages/c1/89/98488c7ef7ea20ea659af7499628c240a608b337af4be2066d644cfd0a0f/matplotlib-3.10.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:77fab633e94b9da60512d4fa0213daeb76d5a7b05156840c4fd0399b4b818837", size = 8112566, upload-time = "2025-07-31T18:08:55.116Z" }, - { url = "https://files.pythonhosted.org/packages/52/67/42294dfedc82aea55e1a767daf3263aacfb5a125f44ba189e685bab41b6f/matplotlib-3.10.5-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:27f52634315e96b1debbfdc5c416592edcd9c4221bc2f520fd39c33db5d9f202", size = 9513281, upload-time = "2025-07-31T18:08:56.885Z" }, - { url = "https://files.pythonhosted.org/packages/e7/68/f258239e0cf34c2cbc816781c7ab6fca768452e6bf1119aedd2bd4a882a3/matplotlib-3.10.5-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:525f6e28c485c769d1f07935b660c864de41c37fd716bfa64158ea646f7084bb", size = 9780873, upload-time = "2025-07-31T18:08:59.241Z" }, - { url = "https://files.pythonhosted.org/packages/89/64/f4881554006bd12e4558bd66778bdd15d47b00a1f6c6e8b50f6208eda4b3/matplotlib-3.10.5-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:1f5f3ec4c191253c5f2b7c07096a142c6a1c024d9f738247bfc8e3f9643fc975", size = 9568954, upload-time = "2025-07-31T18:09:01.244Z" }, - { url = "https://files.pythonhosted.org/packages/06/f8/42779d39c3f757e1f012f2dda3319a89fb602bd2ef98ce8faf0281f4febd/matplotlib-3.10.5-cp314-cp314-win_amd64.whl", hash = "sha256:707f9c292c4cd4716f19ab8a1f93f26598222cd931e0cd98fbbb1c5994bf7667", size = 8237465, upload-time = "2025-07-31T18:09:03.206Z" }, - { url = "https://files.pythonhosted.org/packages/cf/f8/153fd06b5160f0cd27c8b9dd797fcc9fb56ac6a0ebf3c1f765b6b68d3c8a/matplotlib-3.10.5-cp314-cp314-win_arm64.whl", hash = "sha256:21a95b9bf408178d372814de7baacd61c712a62cae560b5e6f35d791776f6516", size = 8108898, upload-time = "2025-07-31T18:09:05.231Z" }, - { url = "https://files.pythonhosted.org/packages/9a/ee/c4b082a382a225fe0d2a73f1f57cf6f6f132308805b493a54c8641006238/matplotlib-3.10.5-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:a6b310f95e1102a8c7c817ef17b60ee5d1851b8c71b63d9286b66b177963039e", size = 8295636, upload-time = "2025-07-31T18:09:07.306Z" }, - { url = "https://files.pythonhosted.org/packages/30/73/2195fa2099718b21a20da82dfc753bf2af58d596b51aefe93e359dd5915a/matplotlib-3.10.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:94986a242747a0605cb3ff1cb98691c736f28a59f8ffe5175acaeb7397c49a5a", size = 8158575, upload-time = "2025-07-31T18:09:09.083Z" }, - { url = "https://files.pythonhosted.org/packages/f6/e9/a08cdb34618a91fa08f75e6738541da5cacde7c307cea18ff10f0d03fcff/matplotlib-3.10.5-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ff10ea43288f0c8bab608a305dc6c918cc729d429c31dcbbecde3b9f4d5b569", size = 9522815, upload-time = "2025-07-31T18:09:11.191Z" }, - { url = "https://files.pythonhosted.org/packages/4e/bb/34d8b7e0d1bb6d06ef45db01dfa560d5a67b1c40c0b998ce9ccde934bb09/matplotlib-3.10.5-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f6adb644c9d040ffb0d3434e440490a66cf73dbfa118a6f79cd7568431f7a012", size = 9783514, upload-time = "2025-07-31T18:09:13.307Z" }, - { url = "https://files.pythonhosted.org/packages/12/09/d330d1e55dcca2e11b4d304cc5227f52e2512e46828d6249b88e0694176e/matplotlib-3.10.5-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:4fa40a8f98428f789a9dcacd625f59b7bc4e3ef6c8c7c80187a7a709475cf592", size = 9573932, upload-time = "2025-07-31T18:09:15.335Z" }, - { url = "https://files.pythonhosted.org/packages/eb/3b/f70258ac729aa004aca673800a53a2b0a26d49ca1df2eaa03289a1c40f81/matplotlib-3.10.5-cp314-cp314t-win_amd64.whl", hash = "sha256:95672a5d628b44207aab91ec20bf59c26da99de12b88f7e0b1fb0a84a86ff959", size = 8322003, upload-time = "2025-07-31T18:09:17.416Z" }, - { url = "https://files.pythonhosted.org/packages/5b/60/3601f8ce6d76a7c81c7f25a0e15fde0d6b66226dd187aa6d2838e6374161/matplotlib-3.10.5-cp314-cp314t-win_arm64.whl", hash = "sha256:2efaf97d72629e74252e0b5e3c46813e9eeaa94e011ecf8084a971a31a97f40b", size = 8153849, upload-time = "2025-07-31T18:09:19.673Z" }, + { url = "https://files.pythonhosted.org/packages/3d/b9/15fd5541ef4f5b9a17eefd379356cf12175fe577424e7b1d80676516031a/matplotlib-3.10.8-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:3f2e409836d7f5ac2f1c013110a4d50b9f7edc26328c108915f9075d7d7a91b6", size = 8261076, upload-time = "2025-12-10T22:55:44.648Z" }, + { url = "https://files.pythonhosted.org/packages/8d/a0/2ba3473c1b66b9c74dc7107c67e9008cb1782edbe896d4c899d39ae9cf78/matplotlib-3.10.8-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:56271f3dac49a88d7fca5060f004d9d22b865f743a12a23b1e937a0be4818ee1", size = 8148794, upload-time = "2025-12-10T22:55:46.252Z" }, + { url = "https://files.pythonhosted.org/packages/75/97/a471f1c3eb1fd6f6c24a31a5858f443891d5127e63a7788678d14e249aea/matplotlib-3.10.8-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:a0a7f52498f72f13d4a25ea70f35f4cb60642b466cbb0a9be951b5bc3f45a486", size = 8718474, upload-time = "2025-12-10T22:55:47.864Z" }, + { url = "https://files.pythonhosted.org/packages/01/be/cd478f4b66f48256f42927d0acbcd63a26a893136456cd079c0cc24fbabf/matplotlib-3.10.8-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:646d95230efb9ca614a7a594d4fcacde0ac61d25e37dd51710b36477594963ce", size = 9549637, upload-time = "2025-12-10T22:55:50.048Z" }, + { url = "https://files.pythonhosted.org/packages/5d/7c/8dc289776eae5109e268c4fb92baf870678dc048a25d4ac903683b86d5bf/matplotlib-3.10.8-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:f89c151aab2e2e23cb3fe0acad1e8b82841fd265379c4cecd0f3fcb34c15e0f6", size = 9613678, upload-time = "2025-12-10T22:55:52.21Z" }, + { url = "https://files.pythonhosted.org/packages/64/40/37612487cc8a437d4dd261b32ca21fe2d79510fe74af74e1f42becb1bdb8/matplotlib-3.10.8-cp313-cp313-win_amd64.whl", hash = "sha256:e8ea3e2d4066083e264e75c829078f9e149fa119d27e19acd503de65e0b13149", size = 8142686, upload-time = "2025-12-10T22:55:54.253Z" }, + { url = "https://files.pythonhosted.org/packages/66/52/8d8a8730e968185514680c2a6625943f70269509c3dcfc0dcf7d75928cb8/matplotlib-3.10.8-cp313-cp313-win_arm64.whl", hash = "sha256:c108a1d6fa78a50646029cb6d49808ff0fc1330fda87fa6f6250c6b5369b6645", size = 8012917, upload-time = "2025-12-10T22:55:56.268Z" }, + { url = "https://files.pythonhosted.org/packages/b5/27/51fe26e1062f298af5ef66343d8ef460e090a27fea73036c76c35821df04/matplotlib-3.10.8-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:ad3d9833a64cf48cc4300f2b406c3d0f4f4724a91c0bd5640678a6ba7c102077", size = 8305679, upload-time = "2025-12-10T22:55:57.856Z" }, + { url = "https://files.pythonhosted.org/packages/2c/1e/4de865bc591ac8e3062e835f42dd7fe7a93168d519557837f0e37513f629/matplotlib-3.10.8-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:eb3823f11823deade26ce3b9f40dcb4a213da7a670013929f31d5f5ed1055b22", size = 8198336, upload-time = "2025-12-10T22:55:59.371Z" }, + { url = "https://files.pythonhosted.org/packages/c6/cb/2f7b6e75fb4dce87ef91f60cac4f6e34f4c145ab036a22318ec837971300/matplotlib-3.10.8-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d9050fee89a89ed57b4fb2c1bfac9a3d0c57a0d55aed95949eedbc42070fea39", size = 8731653, upload-time = "2025-12-10T22:56:01.032Z" }, + { url = "https://files.pythonhosted.org/packages/46/b3/bd9c57d6ba670a37ab31fb87ec3e8691b947134b201f881665b28cc039ff/matplotlib-3.10.8-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b44d07310e404ba95f8c25aa5536f154c0a8ec473303535949e52eb71d0a1565", size = 9561356, upload-time = "2025-12-10T22:56:02.95Z" }, + { url = "https://files.pythonhosted.org/packages/c0/3d/8b94a481456dfc9dfe6e39e93b5ab376e50998cddfd23f4ae3b431708f16/matplotlib-3.10.8-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:0a33deb84c15ede243aead39f77e990469fff93ad1521163305095b77b72ce4a", size = 9614000, upload-time = "2025-12-10T22:56:05.411Z" }, + { url = "https://files.pythonhosted.org/packages/bd/cd/bc06149fe5585ba800b189a6a654a75f1f127e8aab02fd2be10df7fa500c/matplotlib-3.10.8-cp313-cp313t-win_amd64.whl", hash = "sha256:3a48a78d2786784cc2413e57397981fb45c79e968d99656706018d6e62e57958", size = 8220043, upload-time = "2025-12-10T22:56:07.551Z" }, + { url = "https://files.pythonhosted.org/packages/e3/de/b22cf255abec916562cc04eef457c13e58a1990048de0c0c3604d082355e/matplotlib-3.10.8-cp313-cp313t-win_arm64.whl", hash = "sha256:15d30132718972c2c074cd14638c7f4592bd98719e2308bccea40e0538bc0cb5", size = 8062075, upload-time = "2025-12-10T22:56:09.178Z" }, + { url = "https://files.pythonhosted.org/packages/3c/43/9c0ff7a2f11615e516c3b058e1e6e8f9614ddeca53faca06da267c48345d/matplotlib-3.10.8-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:b53285e65d4fa4c86399979e956235deb900be5baa7fc1218ea67fbfaeaadd6f", size = 8262481, upload-time = "2025-12-10T22:56:10.885Z" }, + { url = "https://files.pythonhosted.org/packages/6f/ca/e8ae28649fcdf039fda5ef554b40a95f50592a3c47e6f7270c9561c12b07/matplotlib-3.10.8-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:32f8dce744be5569bebe789e46727946041199030db8aeb2954d26013a0eb26b", size = 8151473, upload-time = "2025-12-10T22:56:12.377Z" }, + { url = "https://files.pythonhosted.org/packages/f1/6f/009d129ae70b75e88cbe7e503a12a4c0670e08ed748a902c2568909e9eb5/matplotlib-3.10.8-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4cf267add95b1c88300d96ca837833d4112756045364f5c734a2276038dae27d", size = 9553896, upload-time = "2025-12-10T22:56:14.432Z" }, + { url = "https://files.pythonhosted.org/packages/f5/26/4221a741eb97967bc1fd5e4c52b9aa5a91b2f4ec05b59f6def4d820f9df9/matplotlib-3.10.8-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2cf5bd12cecf46908f286d7838b2abc6c91cda506c0445b8223a7c19a00df008", size = 9824193, upload-time = "2025-12-10T22:56:16.29Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/3abf75f38605772cf48a9daf5821cd4f563472f38b4b828c6fba6fa6d06e/matplotlib-3.10.8-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:41703cc95688f2516b480f7f339d8851a6035f18e100ee6a32bc0b8536a12a9c", size = 9615444, upload-time = "2025-12-10T22:56:18.155Z" }, + { url = "https://files.pythonhosted.org/packages/93/a5/de89ac80f10b8dc615807ee1133cd99ac74082581196d4d9590bea10690d/matplotlib-3.10.8-cp314-cp314-win_amd64.whl", hash = "sha256:83d282364ea9f3e52363da262ce32a09dfe241e4080dcedda3c0db059d3c1f11", size = 8272719, upload-time = "2025-12-10T22:56:20.366Z" }, + { url = "https://files.pythonhosted.org/packages/69/ce/b006495c19ccc0a137b48083168a37bd056392dee02f87dba0472f2797fe/matplotlib-3.10.8-cp314-cp314-win_arm64.whl", hash = "sha256:2c1998e92cd5999e295a731bcb2911c75f597d937341f3030cc24ef2733d78a8", size = 8144205, upload-time = "2025-12-10T22:56:22.239Z" }, + { url = "https://files.pythonhosted.org/packages/68/d9/b31116a3a855bd313c6fcdb7226926d59b041f26061c6c5b1be66a08c826/matplotlib-3.10.8-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:b5a2b97dbdc7d4f353ebf343744f1d1f1cca8aa8bfddb4262fcf4306c3761d50", size = 8305785, upload-time = "2025-12-10T22:56:24.218Z" }, + { url = "https://files.pythonhosted.org/packages/1e/90/6effe8103f0272685767ba5f094f453784057072f49b393e3ea178fe70a5/matplotlib-3.10.8-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:3f5c3e4da343bba819f0234186b9004faba952cc420fbc522dc4e103c1985908", size = 8198361, upload-time = "2025-12-10T22:56:26.787Z" }, + { url = "https://files.pythonhosted.org/packages/d7/65/a73188711bea603615fc0baecca1061429ac16940e2385433cc778a9d8e7/matplotlib-3.10.8-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f62550b9a30afde8c1c3ae450e5eb547d579dd69b25c2fc7a1c67f934c1717a", size = 9561357, upload-time = "2025-12-10T22:56:28.953Z" }, + { url = "https://files.pythonhosted.org/packages/f4/3d/b5c5d5d5be8ce63292567f0e2c43dde9953d3ed86ac2de0a72e93c8f07a1/matplotlib-3.10.8-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:495672de149445ec1b772ff2c9ede9b769e3cb4f0d0aa7fa730d7f59e2d4e1c1", size = 9823610, upload-time = "2025-12-10T22:56:31.455Z" }, + { url = "https://files.pythonhosted.org/packages/4d/4b/e7beb6bbd49f6bae727a12b270a2654d13c397576d25bd6786e47033300f/matplotlib-3.10.8-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:595ba4d8fe983b88f0eec8c26a241e16d6376fe1979086232f481f8f3f67494c", size = 9614011, upload-time = "2025-12-10T22:56:33.85Z" }, + { url = "https://files.pythonhosted.org/packages/7c/e6/76f2813d31f032e65f6f797e3f2f6e4aab95b65015924b1c51370395c28a/matplotlib-3.10.8-cp314-cp314t-win_amd64.whl", hash = "sha256:25d380fe8b1dc32cf8f0b1b448470a77afb195438bafdf1d858bfb876f3edf7b", size = 8362801, upload-time = "2025-12-10T22:56:36.107Z" }, + { url = "https://files.pythonhosted.org/packages/5d/49/d651878698a0b67f23aa28e17f45a6d6dd3d3f933fa29087fa4ce5947b5a/matplotlib-3.10.8-cp314-cp314t-win_arm64.whl", hash = "sha256:113bb52413ea508ce954a02c10ffd0d565f9c3bc7f2eddc27dfe1731e71c7b5f", size = 8192560, upload-time = "2025-12-10T22:56:38.008Z" }, ] [[package]] name = "matplotlib-inline" -version = "0.1.7" +version = "0.2.1" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/99/5b/a36a337438a14116b16480db471ad061c36c3694df7c2084a0da7ba538b7/matplotlib_inline-0.1.7.tar.gz", hash = "sha256:8423b23ec666be3d16e16b60bdd8ac4e86e840ebd1dd11a30b9f117f2fa0ab90", size = 8159, upload-time = "2024-04-15T13:44:44.803Z" } +sdist = { url = "https://files.pythonhosted.org/packages/c7/74/97e72a36efd4ae2bccb3463284300f8953f199b5ffbc04cbbb0ec78f74b1/matplotlib_inline-0.2.1.tar.gz", hash = "sha256:e1ee949c340d771fc39e241ea75683deb94762c8fa5f2927ec57c83c4dffa9fe", size = 8110, upload-time = "2025-10-23T09:00:22.126Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/8f/8e/9ad090d3553c280a8060fbf6e24dc1c0c29704ee7d1c372f0c174aa59285/matplotlib_inline-0.1.7-py3-none-any.whl", hash = "sha256:df192d39a4ff8f21b1895d72e6a13f5fcc5099f00fa84384e0ea28c2cc0653ca", size = 9899, upload-time = "2024-04-15T13:44:43.265Z" }, + { url = "https://files.pythonhosted.org/packages/af/33/ee4519fa02ed11a94aef9559552f3b17bb863f2ecfe1a35dc7f548cde231/matplotlib_inline-0.2.1-py3-none-any.whl", hash = "sha256:d56ce5156ba6085e00a9d54fead6ed29a9c47e215cd1bba2e976ef39f5710a76", size = 9516, upload-time = "2025-10-23T09:00:20.675Z" }, ] [[package]] name = "metatrader5" -version = "5.0.5200" +version = "5.0.5640" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "numpy" }, ] wheels = [ - { url = "https://files.pythonhosted.org/packages/41/84/3487b188f52b784a0d6a8778307c9a71a288d31e53408374e7aae67038d6/MetaTrader5-5.0.5200-cp313-cp313-win_amd64.whl", hash = "sha256:2f652415a3f6620d1b29ba0cb593d4d91c4559ded8cfe86bde282f10f0b2dedc", size = 50459, upload-time = "2025-08-01T16:09:32.926Z" }, + { url = "https://files.pythonhosted.org/packages/e9/39/a735f26d826c6a5dc8c8d665d2bca83f22dc20f92543647712c210800be1/metatrader5-5.0.5640-cp313-cp313-win_amd64.whl", hash = "sha256:08431a9d02a26d517dcde19fccd571a57ec4454acb798ee246d95eae8946e60e", size = 48073, upload-time = "2026-02-20T23:31:15.35Z" }, + { url = "https://files.pythonhosted.org/packages/4d/35/720c25914da04cd0da44151a06bc8c8c06debfb38c5a1bf5188c7e057978/metatrader5-5.0.5640-cp314-cp314-win_amd64.whl", hash = "sha256:1f5ef6b88a62632aeaa201223bc65519ef7db17643fb35704d62b5a7a960680e", size = 49592, upload-time = "2026-02-20T23:31:16.224Z" }, ] [[package]] name = "mistune" -version = "3.1.3" +version = "3.2.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/c4/79/bda47f7dd7c3c55770478d6d02c9960c430b0cf1773b72366ff89126ea31/mistune-3.1.3.tar.gz", hash = "sha256:a7035c21782b2becb6be62f8f25d3df81ccb4d6fa477a6525b15af06539f02a0", size = 94347, upload-time = "2025-03-19T14:27:24.955Z" } +sdist = { url = "https://files.pythonhosted.org/packages/9d/55/d01f0c4b45ade6536c51170b9043db8b2ec6ddf4a35c7ea3f5f559ac935b/mistune-3.2.0.tar.gz", hash = "sha256:708487c8a8cdd99c9d90eb3ed4c3ed961246ff78ac82f03418f5183ab70e398a", size = 95467, upload-time = "2025-12-23T11:36:34.994Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/01/4d/23c4e4f09da849e127e9f123241946c23c1e30f45a88366879e064211815/mistune-3.1.3-py3-none-any.whl", hash = "sha256:1a32314113cff28aa6432e99e522677c8587fd83e3d51c29b82a52409c842bd9", size = 53410, upload-time = "2025-03-19T14:27:23.451Z" }, + { url = "https://files.pythonhosted.org/packages/9b/f7/4a5e785ec9fbd65146a27b6b70b6cdc161a66f2024e4b04ac06a67f5578b/mistune-3.2.0-py3-none-any.whl", hash = "sha256:febdc629a3c78616b94393c6580551e0e34cc289987ec6c35ed3f4be42d0eee1", size = 53598, upload-time = "2025-12-23T11:36:33.211Z" }, ] [[package]] @@ -1052,7 +1162,7 @@ wheels = [ [[package]] name = "nbclient" -version = "0.10.2" +version = "0.10.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "jupyter-client" }, @@ -1060,14 +1170,14 @@ dependencies = [ { name = "nbformat" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/87/66/7ffd18d58eae90d5721f9f39212327695b749e23ad44b3881744eaf4d9e8/nbclient-0.10.2.tar.gz", hash = "sha256:90b7fc6b810630db87a6d0c2250b1f0ab4cf4d3c27a299b0cde78a4ed3fd9193", size = 62424, upload-time = "2024-12-19T10:32:27.164Z" } +sdist = { url = "https://files.pythonhosted.org/packages/56/91/1c1d5a4b9a9ebba2b4e32b8c852c2975c872aec1fe42ab5e516b2cecd193/nbclient-0.10.4.tar.gz", hash = "sha256:1e54091b16e6da39e297b0ece3e10f6f29f4ac4e8ee515d29f8a7099bd6553c9", size = 62554, upload-time = "2025-12-23T07:45:46.369Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/34/6d/e7fa07f03a4a7b221d94b4d586edb754a9b0dc3c9e2c93353e9fa4e0d117/nbclient-0.10.2-py3-none-any.whl", hash = "sha256:4ffee11e788b4a27fabeb7955547e4318a5298f34342a4bfd01f2e1faaeadc3d", size = 25434, upload-time = "2024-12-19T10:32:24.139Z" }, + { url = "https://files.pythonhosted.org/packages/83/a0/5b0c2f11142ed1dddec842457d3f65eaf71a0080894eb6f018755b319c3a/nbclient-0.10.4-py3-none-any.whl", hash = "sha256:9162df5a7373d70d606527300a95a975a47c137776cd942e52d9c7e29ff83440", size = 25465, upload-time = "2025-12-23T07:45:44.51Z" }, ] [[package]] name = "nbconvert" -version = "7.16.6" +version = "7.17.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beautifulsoup4" }, @@ -1085,9 +1195,9 @@ dependencies = [ { name = "pygments" }, { name = "traitlets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/a3/59/f28e15fc47ffb73af68a8d9b47367a8630d76e97ae85ad18271b9db96fdf/nbconvert-7.16.6.tar.gz", hash = "sha256:576a7e37c6480da7b8465eefa66c17844243816ce1ccc372633c6b71c3c0f582", size = 857715, upload-time = "2025-01-28T09:29:14.724Z" } +sdist = { url = "https://files.pythonhosted.org/packages/38/47/81f886b699450d0569f7bc551df2b1673d18df7ff25cc0c21ca36ed8a5ff/nbconvert-7.17.0.tar.gz", hash = "sha256:1b2696f1b5be12309f6c7d707c24af604b87dfaf6d950794c7b07acab96dda78", size = 862855, upload-time = "2026-01-29T16:37:48.478Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cc/9a/cd673b2f773a12c992f41309ef81b99da1690426bd2f96957a7ade0d3ed7/nbconvert-7.16.6-py3-none-any.whl", hash = "sha256:1375a7b67e0c2883678c48e506dc320febb57685e5ee67faa51b18a90f3a712b", size = 258525, upload-time = "2025-01-28T09:29:12.551Z" }, + { url = "https://files.pythonhosted.org/packages/0d/4b/8d5f796a792f8a25f6925a96032f098789f448571eb92011df1ae59e8ea8/nbconvert-7.17.0-py3-none-any.whl", hash = "sha256:4f99a63b337b9a23504347afdab24a11faa7d86b405e5c8f9881cd313336d518", size = 261510, upload-time = "2026-01-29T16:37:46.322Z" }, ] [[package]] @@ -1116,7 +1226,7 @@ wheels = [ [[package]] name = "notebook" -version = "7.4.5" +version = "7.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "jupyter-server" }, @@ -1125,9 +1235,9 @@ dependencies = [ { name = "notebook-shim" }, { name = "tornado" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/9f/21/9669982f9569e7478763837e0d35b9fd9f43de0eb5ab5d6ca620b8019cfc/notebook-7.4.5.tar.gz", hash = "sha256:7c2c4ea245913c3ad8ab3e5d36b34a842c06e524556f5c2e1f5d7d08c986615e", size = 13888993, upload-time = "2025-08-05T07:40:56.529Z" } +sdist = { url = "https://files.pythonhosted.org/packages/b8/cb/cc7f4df5cee315dd126a47eb60890690a0438d5e0dd40c32d60ce16de377/notebook-7.5.3.tar.gz", hash = "sha256:393ceb269cf9fdb02a3be607a57d7bd5c2c14604f1818a17dbeb38e04f98cbfa", size = 14073140, upload-time = "2026-01-26T07:28:36.605Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fe/c7/207fd1138bd82435d13b6d8640a240be4d855b8ddb41f6bf31aca5be64df/notebook-7.4.5-py3-none-any.whl", hash = "sha256:351635461aca9dad08cf8946a4216f963e2760cc1bf7b1aaaecb23afc33ec046", size = 14295193, upload-time = "2025-08-05T07:40:52.586Z" }, + { url = "https://files.pythonhosted.org/packages/96/98/9286e7f35e5584ebb79f997f2fb0cb66745c86f6c5fccf15ba32aac5e908/notebook-7.5.3-py3-none-any.whl", hash = "sha256:c997bfa1a2a9eb58c9bbb7e77d50428befb1033dd6f02c482922e96851d67354", size = 14481744, upload-time = "2026-01-26T07:28:31.867Z" }, ] [[package]] @@ -1144,92 +1254,125 @@ wheels = [ [[package]] name = "numba" -version = "0.61.2" +version = "0.64.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "llvmlite" }, { name = "numpy" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1c/a0/e21f57604304aa03ebb8e098429222722ad99176a4f979d34af1d1ee80da/numba-0.61.2.tar.gz", hash = "sha256:8750ee147940a6637b80ecf7f95062185ad8726c8c28a2295b8ec1160a196f7d", size = 2820615, upload-time = "2025-04-09T02:58:07.659Z" } +sdist = { url = "https://files.pythonhosted.org/packages/23/c9/a0fb41787d01d621046138da30f6c2100d80857bf34b3390dd68040f27a3/numba-0.64.0.tar.gz", hash = "sha256:95e7300af648baa3308127b1955b52ce6d11889d16e8cfe637b4f85d2fca52b1", size = 2765679, upload-time = "2026-02-18T18:41:20.974Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/0b/f3/0fe4c1b1f2569e8a18ad90c159298d862f96c3964392a20d74fc628aee44/numba-0.61.2-cp313-cp313-macosx_10_14_x86_64.whl", hash = "sha256:3a10a8fc9afac40b1eac55717cece1b8b1ac0b946f5065c89e00bde646b5b154", size = 2771785, upload-time = "2025-04-09T02:57:59.96Z" }, - { url = "https://files.pythonhosted.org/packages/e9/71/91b277d712e46bd5059f8a5866862ed1116091a7cb03bd2704ba8ebe015f/numba-0.61.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7d3bcada3c9afba3bed413fba45845f2fb9cd0d2b27dd58a1be90257e293d140", size = 2773289, upload-time = "2025-04-09T02:58:01.435Z" }, - { url = "https://files.pythonhosted.org/packages/0d/e0/5ea04e7ad2c39288c0f0f9e8d47638ad70f28e275d092733b5817cf243c9/numba-0.61.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:bdbca73ad81fa196bd53dc12e3aaf1564ae036e0c125f237c7644fe64a4928ab", size = 3893918, upload-time = "2025-04-09T02:58:02.933Z" }, - { url = "https://files.pythonhosted.org/packages/17/58/064f4dcb7d7e9412f16ecf80ed753f92297e39f399c905389688cf950b81/numba-0.61.2-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:5f154aaea625fb32cfbe3b80c5456d514d416fcdf79733dd69c0df3a11348e9e", size = 3584056, upload-time = "2025-04-09T02:58:04.538Z" }, - { url = "https://files.pythonhosted.org/packages/af/a4/6d3a0f2d3989e62a18749e1e9913d5fa4910bbb3e3311a035baea6caf26d/numba-0.61.2-cp313-cp313-win_amd64.whl", hash = "sha256:59321215e2e0ac5fa928a8020ab00b8e57cda8a97384963ac0dfa4d4e6aa54e7", size = 2831846, upload-time = "2025-04-09T02:58:06.125Z" }, + { url = "https://files.pythonhosted.org/packages/52/80/2734de90f9300a6e2503b35ee50d9599926b90cbb7ac54f9e40074cd07f1/numba-0.64.0-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:3bab2c872194dcd985f1153b70782ec0fbbe348fffef340264eacd3a76d59fd6", size = 2683392, upload-time = "2026-02-18T18:41:06.563Z" }, + { url = "https://files.pythonhosted.org/packages/42/e8/14b5853ebefd5b37723ef365c5318a30ce0702d39057eaa8d7d76392859d/numba-0.64.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:703a246c60832cad231d2e73c1182f25bf3cc8b699759ec8fe58a2dbc689a70c", size = 3812245, upload-time = "2026-02-18T18:41:07.963Z" }, + { url = "https://files.pythonhosted.org/packages/8a/a2/f60dc6c96d19b7185144265a5fbf01c14993d37ff4cd324b09d0212aa7ce/numba-0.64.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7e2e49a7900ee971d32af7609adc0cfe6aa7477c6f6cccdf6d8138538cf7756f", size = 3511328, upload-time = "2026-02-18T18:41:09.504Z" }, + { url = "https://files.pythonhosted.org/packages/9c/2a/fe7003ea7e7237ee7014f8eaeeb7b0d228a2db22572ca85bab2648cf52cb/numba-0.64.0-cp313-cp313-win_amd64.whl", hash = "sha256:396f43c3f77e78d7ec84cdfc6b04969c78f8f169351b3c4db814b97e7acf4245", size = 2752668, upload-time = "2026-02-18T18:41:11.455Z" }, + { url = "https://files.pythonhosted.org/packages/3d/8a/77d26afe0988c592dd97cb8d4e80bfb3dfc7dbdacfca7d74a7c5c81dd8c2/numba-0.64.0-cp314-cp314-macosx_12_0_arm64.whl", hash = "sha256:f565d55eaeff382cbc86c63c8c610347453af3d1e7afb2b6569aac1c9b5c93ce", size = 2683590, upload-time = "2026-02-18T18:41:12.897Z" }, + { url = "https://files.pythonhosted.org/packages/8e/4b/600b8b7cdbc7f9cebee9ea3d13bb70052a79baf28944024ffcb59f0712e3/numba-0.64.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9b55169b18892c783f85e9ad9e6f5297a6d12967e4414e6b71361086025ff0bb", size = 3781163, upload-time = "2026-02-18T18:41:15.377Z" }, + { url = "https://files.pythonhosted.org/packages/ff/73/53f2d32bfa45b7175e9944f6b816d8c32840178c3eee9325033db5bf838e/numba-0.64.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:196bcafa02c9dd1707e068434f6d5cedde0feb787e3432f7f1f0e993cc336c4c", size = 3481172, upload-time = "2026-02-18T18:41:17.281Z" }, + { url = "https://files.pythonhosted.org/packages/b5/00/aebd2f7f1e11e38814bb96e95a27580817a7b340608d3ac085fdbab83174/numba-0.64.0-cp314-cp314-win_amd64.whl", hash = "sha256:213e9acbe7f1c05090592e79020315c1749dd52517b90e94c517dca3f014d4a1", size = 2754700, upload-time = "2026-02-18T18:41:19.277Z" }, ] [[package]] name = "numpy" -version = "2.2.6" +version = "2.4.2" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/76/21/7d2a95e4bba9dc13d043ee156a356c0a8f0c6309dff6b21b4d71a073b8a8/numpy-2.2.6.tar.gz", hash = "sha256:e29554e2bef54a90aa5cc07da6ce955accb83f21ab5de01a62c8478897b264fd", size = 20276440, upload-time = "2025-05-17T22:38:04.611Z" } +sdist = { url = "https://files.pythonhosted.org/packages/57/fd/0005efbd0af48e55eb3c7208af93f2862d4b1a56cd78e84309a2d959208d/numpy-2.4.2.tar.gz", hash = "sha256:659a6107e31a83c4e33f763942275fd278b21d095094044eb35569e86a21ddae", size = 20723651, upload-time = "2026-01-31T23:13:10.135Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/f9/5c/6657823f4f594f72b5471f1db1ab12e26e890bb2e41897522d134d2a3e81/numpy-2.2.6-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0811bb762109d9708cca4d0b13c4f67146e3c3b7cf8d34018c722adb2d957c84", size = 20867828, upload-time = "2025-05-17T21:37:56.699Z" }, - { url = "https://files.pythonhosted.org/packages/dc/9e/14520dc3dadf3c803473bd07e9b2bd1b69bc583cb2497b47000fed2fa92f/numpy-2.2.6-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:287cc3162b6f01463ccd86be154f284d0893d2b3ed7292439ea97eafa8170e0b", size = 14143006, upload-time = "2025-05-17T21:38:18.291Z" }, - { url = "https://files.pythonhosted.org/packages/4f/06/7e96c57d90bebdce9918412087fc22ca9851cceaf5567a45c1f404480e9e/numpy-2.2.6-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:f1372f041402e37e5e633e586f62aa53de2eac8d98cbfb822806ce4bbefcb74d", size = 5076765, upload-time = "2025-05-17T21:38:27.319Z" }, - { url = "https://files.pythonhosted.org/packages/73/ed/63d920c23b4289fdac96ddbdd6132e9427790977d5457cd132f18e76eae0/numpy-2.2.6-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:55a4d33fa519660d69614a9fad433be87e5252f4b03850642f88993f7b2ca566", size = 6617736, upload-time = "2025-05-17T21:38:38.141Z" }, - { url = "https://files.pythonhosted.org/packages/85/c5/e19c8f99d83fd377ec8c7e0cf627a8049746da54afc24ef0a0cb73d5dfb5/numpy-2.2.6-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f92729c95468a2f4f15e9bb94c432a9229d0d50de67304399627a943201baa2f", size = 14010719, upload-time = "2025-05-17T21:38:58.433Z" }, - { url = "https://files.pythonhosted.org/packages/19/49/4df9123aafa7b539317bf6d342cb6d227e49f7a35b99c287a6109b13dd93/numpy-2.2.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1bc23a79bfabc5d056d106f9befb8d50c31ced2fbc70eedb8155aec74a45798f", size = 16526072, upload-time = "2025-05-17T21:39:22.638Z" }, - { url = "https://files.pythonhosted.org/packages/b2/6c/04b5f47f4f32f7c2b0e7260442a8cbcf8168b0e1a41ff1495da42f42a14f/numpy-2.2.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e3143e4451880bed956e706a3220b4e5cf6172ef05fcc397f6f36a550b1dd868", size = 15503213, upload-time = "2025-05-17T21:39:45.865Z" }, - { url = "https://files.pythonhosted.org/packages/17/0a/5cd92e352c1307640d5b6fec1b2ffb06cd0dabe7d7b8227f97933d378422/numpy-2.2.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b4f13750ce79751586ae2eb824ba7e1e8dba64784086c98cdbbcc6a42112ce0d", size = 18316632, upload-time = "2025-05-17T21:40:13.331Z" }, - { url = "https://files.pythonhosted.org/packages/f0/3b/5cba2b1d88760ef86596ad0f3d484b1cbff7c115ae2429678465057c5155/numpy-2.2.6-cp313-cp313-win32.whl", hash = "sha256:5beb72339d9d4fa36522fc63802f469b13cdbe4fdab4a288f0c441b74272ebfd", size = 6244532, upload-time = "2025-05-17T21:43:46.099Z" }, - { url = "https://files.pythonhosted.org/packages/cb/3b/d58c12eafcb298d4e6d0d40216866ab15f59e55d148a5658bb3132311fcf/numpy-2.2.6-cp313-cp313-win_amd64.whl", hash = "sha256:b0544343a702fa80c95ad5d3d608ea3599dd54d4632df855e4c8d24eb6ecfa1c", size = 12610885, upload-time = "2025-05-17T21:44:05.145Z" }, - { url = "https://files.pythonhosted.org/packages/6b/9e/4bf918b818e516322db999ac25d00c75788ddfd2d2ade4fa66f1f38097e1/numpy-2.2.6-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0bca768cd85ae743b2affdc762d617eddf3bcf8724435498a1e80132d04879e6", size = 20963467, upload-time = "2025-05-17T21:40:44Z" }, - { url = "https://files.pythonhosted.org/packages/61/66/d2de6b291507517ff2e438e13ff7b1e2cdbdb7cb40b3ed475377aece69f9/numpy-2.2.6-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:fc0c5673685c508a142ca65209b4e79ed6740a4ed6b2267dbba90f34b0b3cfda", size = 14225144, upload-time = "2025-05-17T21:41:05.695Z" }, - { url = "https://files.pythonhosted.org/packages/e4/25/480387655407ead912e28ba3a820bc69af9adf13bcbe40b299d454ec011f/numpy-2.2.6-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:5bd4fc3ac8926b3819797a7c0e2631eb889b4118a9898c84f585a54d475b7e40", size = 5200217, upload-time = "2025-05-17T21:41:15.903Z" }, - { url = "https://files.pythonhosted.org/packages/aa/4a/6e313b5108f53dcbf3aca0c0f3e9c92f4c10ce57a0a721851f9785872895/numpy-2.2.6-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:fee4236c876c4e8369388054d02d0e9bb84821feb1a64dd59e137e6511a551f8", size = 6712014, upload-time = "2025-05-17T21:41:27.321Z" }, - { url = "https://files.pythonhosted.org/packages/b7/30/172c2d5c4be71fdf476e9de553443cf8e25feddbe185e0bd88b096915bcc/numpy-2.2.6-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e1dda9c7e08dc141e0247a5b8f49cf05984955246a327d4c48bda16821947b2f", size = 14077935, upload-time = "2025-05-17T21:41:49.738Z" }, - { url = "https://files.pythonhosted.org/packages/12/fb/9e743f8d4e4d3c710902cf87af3512082ae3d43b945d5d16563f26ec251d/numpy-2.2.6-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f447e6acb680fd307f40d3da4852208af94afdfab89cf850986c3ca00562f4fa", size = 16600122, upload-time = "2025-05-17T21:42:14.046Z" }, - { url = "https://files.pythonhosted.org/packages/12/75/ee20da0e58d3a66f204f38916757e01e33a9737d0b22373b3eb5a27358f9/numpy-2.2.6-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:389d771b1623ec92636b0786bc4ae56abafad4a4c513d36a55dce14bd9ce8571", size = 15586143, upload-time = "2025-05-17T21:42:37.464Z" }, - { url = "https://files.pythonhosted.org/packages/76/95/bef5b37f29fc5e739947e9ce5179ad402875633308504a52d188302319c8/numpy-2.2.6-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8e9ace4a37db23421249ed236fdcdd457d671e25146786dfc96835cd951aa7c1", size = 18385260, upload-time = "2025-05-17T21:43:05.189Z" }, - { url = "https://files.pythonhosted.org/packages/09/04/f2f83279d287407cf36a7a8053a5abe7be3622a4363337338f2585e4afda/numpy-2.2.6-cp313-cp313t-win32.whl", hash = "sha256:038613e9fb8c72b0a41f025a7e4c3f0b7a1b5d768ece4796b674c8f3fe13efff", size = 6377225, upload-time = "2025-05-17T21:43:16.254Z" }, - { url = "https://files.pythonhosted.org/packages/67/0e/35082d13c09c02c011cf21570543d202ad929d961c02a147493cb0c2bdf5/numpy-2.2.6-cp313-cp313t-win_amd64.whl", hash = "sha256:6031dd6dfecc0cf9f668681a37648373bddd6421fff6c66ec1624eed0180ee06", size = 12771374, upload-time = "2025-05-17T21:43:35.479Z" }, -] - -[[package]] -name = "overrides" -version = "7.7.0" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/36/86/b585f53236dec60aba864e050778b25045f857e17f6e5ea0ae95fe80edd2/overrides-7.7.0.tar.gz", hash = "sha256:55158fa3d93b98cc75299b1e67078ad9003ca27945c76162c1c0766d6f91820a", size = 22812, upload-time = "2024-01-27T21:01:33.423Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/2c/ab/fc8290c6a4c722e5514d80f62b2dc4c4df1a68a41d1364e625c35990fcf3/overrides-7.7.0-py3-none-any.whl", hash = "sha256:c7ed9d062f78b8e4c1a7b70bd8796b35ead4d9f510227ef9c5dc7626c60d7e49", size = 17832, upload-time = "2024-01-27T21:01:31.393Z" }, + { url = "https://files.pythonhosted.org/packages/a1/22/815b9fe25d1d7ae7d492152adbc7226d3eff731dffc38fe970589fcaaa38/numpy-2.4.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:25f2059807faea4b077a2b6837391b5d830864b3543627f381821c646f31a63c", size = 16663696, upload-time = "2026-01-31T23:11:17.516Z" }, + { url = "https://files.pythonhosted.org/packages/09/f0/817d03a03f93ba9c6c8993de509277d84e69f9453601915e4a69554102a1/numpy-2.4.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bd3a7a9f5847d2fb8c2c6d1c862fa109c31a9abeca1a3c2bd5a64572955b2979", size = 14688322, upload-time = "2026-01-31T23:11:19.883Z" }, + { url = "https://files.pythonhosted.org/packages/da/b4/f805ab79293c728b9a99438775ce51885fd4f31b76178767cfc718701a39/numpy-2.4.2-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:8e4549f8a3c6d13d55041925e912bfd834285ef1dd64d6bc7d542583355e2e98", size = 5198157, upload-time = "2026-01-31T23:11:22.375Z" }, + { url = "https://files.pythonhosted.org/packages/74/09/826e4289844eccdcd64aac27d13b0fd3f32039915dd5b9ba01baae1f436c/numpy-2.4.2-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:aea4f66ff44dfddf8c2cffd66ba6538c5ec67d389285292fe428cb2c738c8aef", size = 6546330, upload-time = "2026-01-31T23:11:23.958Z" }, + { url = "https://files.pythonhosted.org/packages/19/fb/cbfdbfa3057a10aea5422c558ac57538e6acc87ec1669e666d32ac198da7/numpy-2.4.2-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c3cd545784805de05aafe1dde61752ea49a359ccba9760c1e5d1c88a93bbf2b7", size = 15660968, upload-time = "2026-01-31T23:11:25.713Z" }, + { url = "https://files.pythonhosted.org/packages/04/dc/46066ce18d01645541f0186877377b9371b8fa8017fa8262002b4ef22612/numpy-2.4.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d0d9b7c93578baafcbc5f0b83eaf17b79d345c6f36917ba0c67f45226911d499", size = 16607311, upload-time = "2026-01-31T23:11:28.117Z" }, + { url = "https://files.pythonhosted.org/packages/14/d9/4b5adfc39a43fa6bf918c6d544bc60c05236cc2f6339847fc5b35e6cb5b0/numpy-2.4.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f74f0f7779cc7ae07d1810aab8ac6b1464c3eafb9e283a40da7309d5e6e48fbb", size = 17012850, upload-time = "2026-01-31T23:11:30.888Z" }, + { url = "https://files.pythonhosted.org/packages/b7/20/adb6e6adde6d0130046e6fdfb7675cc62bc2f6b7b02239a09eb58435753d/numpy-2.4.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:c7ac672d699bf36275c035e16b65539931347d68b70667d28984c9fb34e07fa7", size = 18334210, upload-time = "2026-01-31T23:11:33.214Z" }, + { url = "https://files.pythonhosted.org/packages/78/0e/0a73b3dff26803a8c02baa76398015ea2a5434d9b8265a7898a6028c1591/numpy-2.4.2-cp313-cp313-win32.whl", hash = "sha256:8e9afaeb0beff068b4d9cd20d322ba0ee1cecfb0b08db145e4ab4dd44a6b5110", size = 5958199, upload-time = "2026-01-31T23:11:35.385Z" }, + { url = "https://files.pythonhosted.org/packages/43/bc/6352f343522fcb2c04dbaf94cb30cca6fd32c1a750c06ad6231b4293708c/numpy-2.4.2-cp313-cp313-win_amd64.whl", hash = "sha256:7df2de1e4fba69a51c06c28f5a3de36731eb9639feb8e1cf7e4a7b0daf4cf622", size = 12310848, upload-time = "2026-01-31T23:11:38.001Z" }, + { url = "https://files.pythonhosted.org/packages/6e/8d/6da186483e308da5da1cc6918ce913dcfe14ffde98e710bfeff2a6158d4e/numpy-2.4.2-cp313-cp313-win_arm64.whl", hash = "sha256:0fece1d1f0a89c16b03442eae5c56dc0be0c7883b5d388e0c03f53019a4bfd71", size = 10221082, upload-time = "2026-01-31T23:11:40.392Z" }, + { url = "https://files.pythonhosted.org/packages/25/a1/9510aa43555b44781968935c7548a8926274f815de42ad3997e9e83680dd/numpy-2.4.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:5633c0da313330fd20c484c78cdd3f9b175b55e1a766c4a174230c6b70ad8262", size = 14815866, upload-time = "2026-01-31T23:11:42.495Z" }, + { url = "https://files.pythonhosted.org/packages/36/30/6bbb5e76631a5ae46e7923dd16ca9d3f1c93cfa8d4ed79a129814a9d8db3/numpy-2.4.2-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:d9f64d786b3b1dd742c946c42d15b07497ed14af1a1f3ce840cce27daa0ce913", size = 5325631, upload-time = "2026-01-31T23:11:44.7Z" }, + { url = "https://files.pythonhosted.org/packages/46/00/3a490938800c1923b567b3a15cd17896e68052e2145d8662aaf3e1ffc58f/numpy-2.4.2-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:b21041e8cb6a1eb5312dd1d2f80a94d91efffb7a06b70597d44f1bd2dfc315ab", size = 6646254, upload-time = "2026-01-31T23:11:46.341Z" }, + { url = "https://files.pythonhosted.org/packages/d3/e9/fac0890149898a9b609caa5af7455a948b544746e4b8fe7c212c8edd71f8/numpy-2.4.2-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:00ab83c56211a1d7c07c25e3217ea6695e50a3e2f255053686b081dc0b091a82", size = 15720138, upload-time = "2026-01-31T23:11:48.082Z" }, + { url = "https://files.pythonhosted.org/packages/ea/5c/08887c54e68e1e28df53709f1893ce92932cc6f01f7c3d4dc952f61ffd4e/numpy-2.4.2-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2fb882da679409066b4603579619341c6d6898fc83a8995199d5249f986e8e8f", size = 16655398, upload-time = "2026-01-31T23:11:50.293Z" }, + { url = "https://files.pythonhosted.org/packages/4d/89/253db0fa0e66e9129c745e4ef25631dc37d5f1314dad2b53e907b8538e6d/numpy-2.4.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:66cb9422236317f9d44b67b4d18f44efe6e9c7f8794ac0462978513359461554", size = 17079064, upload-time = "2026-01-31T23:11:52.927Z" }, + { url = "https://files.pythonhosted.org/packages/2a/d5/cbade46ce97c59c6c3da525e8d95b7abe8a42974a1dc5c1d489c10433e88/numpy-2.4.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:0f01dcf33e73d80bd8dc0f20a71303abbafa26a19e23f6b68d1aa9990af90257", size = 18379680, upload-time = "2026-01-31T23:11:55.22Z" }, + { url = "https://files.pythonhosted.org/packages/40/62/48f99ae172a4b63d981babe683685030e8a3df4f246c893ea5c6ef99f018/numpy-2.4.2-cp313-cp313t-win32.whl", hash = "sha256:52b913ec40ff7ae845687b0b34d8d93b60cb66dcee06996dd5c99f2fc9328657", size = 6082433, upload-time = "2026-01-31T23:11:58.096Z" }, + { url = "https://files.pythonhosted.org/packages/07/38/e054a61cfe48ad9f1ed0d188e78b7e26859d0b60ef21cd9de4897cdb5326/numpy-2.4.2-cp313-cp313t-win_amd64.whl", hash = "sha256:5eea80d908b2c1f91486eb95b3fb6fab187e569ec9752ab7d9333d2e66bf2d6b", size = 12451181, upload-time = "2026-01-31T23:11:59.782Z" }, + { url = "https://files.pythonhosted.org/packages/6e/a4/a05c3a6418575e185dd84d0b9680b6bb2e2dc3e4202f036b7b4e22d6e9dc/numpy-2.4.2-cp313-cp313t-win_arm64.whl", hash = "sha256:fd49860271d52127d61197bb50b64f58454e9f578cb4b2c001a6de8b1f50b0b1", size = 10290756, upload-time = "2026-01-31T23:12:02.438Z" }, + { url = "https://files.pythonhosted.org/packages/18/88/b7df6050bf18fdcfb7046286c6535cabbdd2064a3440fca3f069d319c16e/numpy-2.4.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:444be170853f1f9d528428eceb55f12918e4fda5d8805480f36a002f1415e09b", size = 16663092, upload-time = "2026-01-31T23:12:04.521Z" }, + { url = "https://files.pythonhosted.org/packages/25/7a/1fee4329abc705a469a4afe6e69b1ef7e915117747886327104a8493a955/numpy-2.4.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:d1240d50adff70c2a88217698ca844723068533f3f5c5fa6ee2e3220e3bdb000", size = 14698770, upload-time = "2026-01-31T23:12:06.96Z" }, + { url = "https://files.pythonhosted.org/packages/fb/0b/f9e49ba6c923678ad5bc38181c08ac5e53b7a5754dbca8e581aa1a56b1ff/numpy-2.4.2-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:7cdde6de52fb6664b00b056341265441192d1291c130e99183ec0d4b110ff8b1", size = 5208562, upload-time = "2026-01-31T23:12:09.632Z" }, + { url = "https://files.pythonhosted.org/packages/7d/12/d7de8f6f53f9bb76997e5e4c069eda2051e3fe134e9181671c4391677bb2/numpy-2.4.2-cp314-cp314-macosx_14_0_x86_64.whl", hash = "sha256:cda077c2e5b780200b6b3e09d0b42205a3d1c68f30c6dceb90401c13bff8fe74", size = 6543710, upload-time = "2026-01-31T23:12:11.969Z" }, + { url = "https://files.pythonhosted.org/packages/09/63/c66418c2e0268a31a4cf8a8b512685748200f8e8e8ec6c507ce14e773529/numpy-2.4.2-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d30291931c915b2ab5717c2974bb95ee891a1cf22ebc16a8006bd59cd210d40a", size = 15677205, upload-time = "2026-01-31T23:12:14.33Z" }, + { url = "https://files.pythonhosted.org/packages/5d/6c/7f237821c9642fb2a04d2f1e88b4295677144ca93285fd76eff3bcba858d/numpy-2.4.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bba37bc29d4d85761deed3954a1bc62be7cf462b9510b51d367b769a8c8df325", size = 16611738, upload-time = "2026-01-31T23:12:16.525Z" }, + { url = "https://files.pythonhosted.org/packages/c2/a7/39c4cdda9f019b609b5c473899d87abff092fc908cfe4d1ecb2fcff453b0/numpy-2.4.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b2f0073ed0868db1dcd86e052d37279eef185b9c8db5bf61f30f46adac63c909", size = 17028888, upload-time = "2026-01-31T23:12:19.306Z" }, + { url = "https://files.pythonhosted.org/packages/da/b3/e84bb64bdfea967cc10950d71090ec2d84b49bc691df0025dddb7c26e8e3/numpy-2.4.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:7f54844851cdb630ceb623dcec4db3240d1ac13d4990532446761baede94996a", size = 18339556, upload-time = "2026-01-31T23:12:21.816Z" }, + { url = "https://files.pythonhosted.org/packages/88/f5/954a291bc1192a27081706862ac62bb5920fbecfbaa302f64682aa90beed/numpy-2.4.2-cp314-cp314-win32.whl", hash = "sha256:12e26134a0331d8dbd9351620f037ec470b7c75929cb8a1537f6bfe411152a1a", size = 6006899, upload-time = "2026-01-31T23:12:24.14Z" }, + { url = "https://files.pythonhosted.org/packages/05/cb/eff72a91b2efdd1bc98b3b8759f6a1654aa87612fc86e3d87d6fe4f948c4/numpy-2.4.2-cp314-cp314-win_amd64.whl", hash = "sha256:068cdb2d0d644cdb45670810894f6a0600797a69c05f1ac478e8d31670b8ee75", size = 12443072, upload-time = "2026-01-31T23:12:26.33Z" }, + { url = "https://files.pythonhosted.org/packages/37/75/62726948db36a56428fce4ba80a115716dc4fad6a3a4352487f8bb950966/numpy-2.4.2-cp314-cp314-win_arm64.whl", hash = "sha256:6ed0be1ee58eef41231a5c943d7d1375f093142702d5723ca2eb07db9b934b05", size = 10494886, upload-time = "2026-01-31T23:12:28.488Z" }, + { url = "https://files.pythonhosted.org/packages/36/2f/ee93744f1e0661dc267e4b21940870cabfae187c092e1433b77b09b50ac4/numpy-2.4.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:98f16a80e917003a12c0580f97b5f875853ebc33e2eaa4bccfc8201ac6869308", size = 14818567, upload-time = "2026-01-31T23:12:30.709Z" }, + { url = "https://files.pythonhosted.org/packages/a7/24/6535212add7d76ff938d8bdc654f53f88d35cddedf807a599e180dcb8e66/numpy-2.4.2-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:20abd069b9cda45874498b245c8015b18ace6de8546bf50dfa8cea1696ed06ef", size = 5328372, upload-time = "2026-01-31T23:12:32.962Z" }, + { url = "https://files.pythonhosted.org/packages/5e/9d/c48f0a035725f925634bf6b8994253b43f2047f6778a54147d7e213bc5a7/numpy-2.4.2-cp314-cp314t-macosx_14_0_x86_64.whl", hash = "sha256:e98c97502435b53741540a5717a6749ac2ada901056c7db951d33e11c885cc7d", size = 6649306, upload-time = "2026-01-31T23:12:34.797Z" }, + { url = "https://files.pythonhosted.org/packages/81/05/7c73a9574cd4a53a25907bad38b59ac83919c0ddc8234ec157f344d57d9a/numpy-2.4.2-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:da6cad4e82cb893db4b69105c604d805e0c3ce11501a55b5e9f9083b47d2ffe8", size = 15722394, upload-time = "2026-01-31T23:12:36.565Z" }, + { url = "https://files.pythonhosted.org/packages/35/fa/4de10089f21fc7d18442c4a767ab156b25c2a6eaf187c0db6d9ecdaeb43f/numpy-2.4.2-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9e4424677ce4b47fe73c8b5556d876571f7c6945d264201180db2dc34f676ab5", size = 16653343, upload-time = "2026-01-31T23:12:39.188Z" }, + { url = "https://files.pythonhosted.org/packages/b8/f9/d33e4ffc857f3763a57aa85650f2e82486832d7492280ac21ba9efda80da/numpy-2.4.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:2b8f157c8a6f20eb657e240f8985cc135598b2b46985c5bccbde7616dc9c6b1e", size = 17078045, upload-time = "2026-01-31T23:12:42.041Z" }, + { url = "https://files.pythonhosted.org/packages/c8/b8/54bdb43b6225badbea6389fa038c4ef868c44f5890f95dd530a218706da3/numpy-2.4.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5daf6f3914a733336dab21a05cdec343144600e964d2fcdabaac0c0269874b2a", size = 18380024, upload-time = "2026-01-31T23:12:44.331Z" }, + { url = "https://files.pythonhosted.org/packages/a5/55/6e1a61ded7af8df04016d81b5b02daa59f2ea9252ee0397cb9f631efe9e5/numpy-2.4.2-cp314-cp314t-win32.whl", hash = "sha256:8c50dd1fc8826f5b26a5ee4d77ca55d88a895f4e4819c7ecc2a9f5905047a443", size = 6153937, upload-time = "2026-01-31T23:12:47.229Z" }, + { url = "https://files.pythonhosted.org/packages/45/aa/fa6118d1ed6d776b0983f3ceac9b1a5558e80df9365b1c3aa6d42bf9eee4/numpy-2.4.2-cp314-cp314t-win_amd64.whl", hash = "sha256:fcf92bee92742edd401ba41135185866f7026c502617f422eb432cfeca4fe236", size = 12631844, upload-time = "2026-01-31T23:12:48.997Z" }, + { url = "https://files.pythonhosted.org/packages/32/0a/2ec5deea6dcd158f254a7b372fb09cfba5719419c8d66343bab35237b3fb/numpy-2.4.2-cp314-cp314t-win_arm64.whl", hash = "sha256:1f92f53998a17265194018d1cc321b2e96e900ca52d54c7c77837b71b9465181", size = 10565379, upload-time = "2026-01-31T23:12:51.345Z" }, ] [[package]] name = "packaging" -version = "25.0" +version = "26.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" } +sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" }, + { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" }, ] [[package]] name = "pandas" -version = "2.3.1" +version = "3.0.1" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "numpy" }, { name = "python-dateutil" }, - { name = "pytz" }, - { name = "tzdata" }, + { name = "tzdata", marker = "sys_platform == 'emscripten' or sys_platform == 'win32'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/d1/6f/75aa71f8a14267117adeeed5d21b204770189c0a0025acbdc03c337b28fc/pandas-2.3.1.tar.gz", hash = "sha256:0a95b9ac964fe83ce317827f80304d37388ea77616b1425f0ae41c9d2d0d7bb2", size = 4487493, upload-time = "2025-07-07T19:20:04.079Z" } +sdist = { url = "https://files.pythonhosted.org/packages/2e/0c/b28ed414f080ee0ad153f848586d61d1878f91689950f037f976ce15f6c8/pandas-3.0.1.tar.gz", hash = "sha256:4186a699674af418f655dbd420ed87f50d56b4cd6603784279d9eef6627823c8", size = 4641901, upload-time = "2026-02-17T22:20:16.434Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/32/ed/ff0a67a2c5505e1854e6715586ac6693dd860fbf52ef9f81edee200266e7/pandas-2.3.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:9026bd4a80108fac2239294a15ef9003c4ee191a0f64b90f170b40cfb7cf2d22", size = 11531393, upload-time = "2025-07-07T19:19:12.245Z" }, - { url = "https://files.pythonhosted.org/packages/c7/db/d8f24a7cc9fb0972adab0cc80b6817e8bef888cfd0024eeb5a21c0bb5c4a/pandas-2.3.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6de8547d4fdb12421e2d047a2c446c623ff4c11f47fddb6b9169eb98ffba485a", size = 10668750, upload-time = "2025-07-07T19:19:14.612Z" }, - { url = "https://files.pythonhosted.org/packages/0f/b0/80f6ec783313f1e2356b28b4fd8d2148c378370045da918c73145e6aab50/pandas-2.3.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:782647ddc63c83133b2506912cc6b108140a38a37292102aaa19c81c83db2928", size = 11342004, upload-time = "2025-07-07T19:19:16.857Z" }, - { url = "https://files.pythonhosted.org/packages/e9/e2/20a317688435470872885e7fc8f95109ae9683dec7c50be29b56911515a5/pandas-2.3.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ba6aff74075311fc88504b1db890187a3cd0f887a5b10f5525f8e2ef55bfdb9", size = 12050869, upload-time = "2025-07-07T19:19:19.265Z" }, - { url = "https://files.pythonhosted.org/packages/55/79/20d746b0a96c67203a5bee5fb4e00ac49c3e8009a39e1f78de264ecc5729/pandas-2.3.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e5635178b387bd2ba4ac040f82bc2ef6e6b500483975c4ebacd34bec945fda12", size = 12750218, upload-time = "2025-07-07T19:19:21.547Z" }, - { url = "https://files.pythonhosted.org/packages/7c/0f/145c8b41e48dbf03dd18fdd7f24f8ba95b8254a97a3379048378f33e7838/pandas-2.3.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6f3bf5ec947526106399a9e1d26d40ee2b259c66422efdf4de63c848492d91bb", size = 13416763, upload-time = "2025-07-07T19:19:23.939Z" }, - { url = "https://files.pythonhosted.org/packages/b2/c0/54415af59db5cdd86a3d3bf79863e8cc3fa9ed265f0745254061ac09d5f2/pandas-2.3.1-cp313-cp313-win_amd64.whl", hash = "sha256:1c78cf43c8fde236342a1cb2c34bcff89564a7bfed7e474ed2fffa6aed03a956", size = 10987482, upload-time = "2025-07-07T19:19:42.699Z" }, - { url = "https://files.pythonhosted.org/packages/48/64/2fd2e400073a1230e13b8cd604c9bc95d9e3b962e5d44088ead2e8f0cfec/pandas-2.3.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:8dfc17328e8da77be3cf9f47509e5637ba8f137148ed0e9b5241e1baf526e20a", size = 12029159, upload-time = "2025-07-07T19:19:26.362Z" }, - { url = "https://files.pythonhosted.org/packages/d8/0a/d84fd79b0293b7ef88c760d7dca69828d867c89b6d9bc52d6a27e4d87316/pandas-2.3.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:ec6c851509364c59a5344458ab935e6451b31b818be467eb24b0fe89bd05b6b9", size = 11393287, upload-time = "2025-07-07T19:19:29.157Z" }, - { url = "https://files.pythonhosted.org/packages/50/ae/ff885d2b6e88f3c7520bb74ba319268b42f05d7e583b5dded9837da2723f/pandas-2.3.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:911580460fc4884d9b05254b38a6bfadddfcc6aaef856fb5859e7ca202e45275", size = 11309381, upload-time = "2025-07-07T19:19:31.436Z" }, - { url = "https://files.pythonhosted.org/packages/85/86/1fa345fc17caf5d7780d2699985c03dbe186c68fee00b526813939062bb0/pandas-2.3.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2f4d6feeba91744872a600e6edbbd5b033005b431d5ae8379abee5bcfa479fab", size = 11883998, upload-time = "2025-07-07T19:19:34.267Z" }, - { url = "https://files.pythonhosted.org/packages/81/aa/e58541a49b5e6310d89474333e994ee57fea97c8aaa8fc7f00b873059bbf/pandas-2.3.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:fe37e757f462d31a9cd7580236a82f353f5713a80e059a29753cf938c6775d96", size = 12704705, upload-time = "2025-07-07T19:19:36.856Z" }, - { url = "https://files.pythonhosted.org/packages/d5/f9/07086f5b0f2a19872554abeea7658200824f5835c58a106fa8f2ae96a46c/pandas-2.3.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:5db9637dbc24b631ff3707269ae4559bce4b7fd75c1c4d7e13f40edc42df4444", size = 13189044, upload-time = "2025-07-07T19:19:39.999Z" }, + { url = "https://files.pythonhosted.org/packages/0b/48/aad6ec4f8d007534c091e9a7172b3ec1b1ee6d99a9cbb936b5eab6c6cf58/pandas-3.0.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5272627187b5d9c20e55d27caf5f2cd23e286aba25cadf73c8590e432e2b7262", size = 10317509, upload-time = "2026-02-17T22:18:59.498Z" }, + { url = "https://files.pythonhosted.org/packages/a8/14/5990826f779f79148ae9d3a2c39593dc04d61d5d90541e71b5749f35af95/pandas-3.0.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:661e0f665932af88c7877f31da0dc743fe9c8f2524bdffe23d24fdcb67ef9d56", size = 9860561, upload-time = "2026-02-17T22:19:02.265Z" }, + { url = "https://files.pythonhosted.org/packages/fa/80/f01ff54664b6d70fed71475543d108a9b7c888e923ad210795bef04ffb7d/pandas-3.0.1-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:75e6e292ff898679e47a2199172593d9f6107fd2dd3617c22c2946e97d5df46e", size = 10365506, upload-time = "2026-02-17T22:19:05.017Z" }, + { url = "https://files.pythonhosted.org/packages/f2/85/ab6d04733a7d6ff32bfc8382bf1b07078228f5d6ebec5266b91bfc5c4ff7/pandas-3.0.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1ff8cf1d2896e34343197685f432450ec99a85ba8d90cce2030c5eee2ef98791", size = 10873196, upload-time = "2026-02-17T22:19:07.204Z" }, + { url = "https://files.pythonhosted.org/packages/48/a9/9301c83d0b47c23ac5deab91c6b39fd98d5b5db4d93b25df8d381451828f/pandas-3.0.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:eca8b4510f6763f3d37359c2105df03a7a221a508f30e396a51d0713d462e68a", size = 11370859, upload-time = "2026-02-17T22:19:09.436Z" }, + { url = "https://files.pythonhosted.org/packages/59/fe/0c1fc5bd2d29c7db2ab372330063ad555fb83e08422829c785f5ec2176ca/pandas-3.0.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:06aff2ad6f0b94a17822cf8b83bbb563b090ed82ff4fe7712db2ce57cd50d9b8", size = 11924584, upload-time = "2026-02-17T22:19:11.562Z" }, + { url = "https://files.pythonhosted.org/packages/d6/7d/216a1588b65a7aa5f4535570418a599d943c85afb1d95b0876fc00aa1468/pandas-3.0.1-cp313-cp313-win_amd64.whl", hash = "sha256:9fea306c783e28884c29057a1d9baa11a349bbf99538ec1da44c8476563d1b25", size = 9742769, upload-time = "2026-02-17T22:19:13.926Z" }, + { url = "https://files.pythonhosted.org/packages/c4/cb/810a22a6af9a4e97c8ab1c946b47f3489c5bca5adc483ce0ffc84c9cc768/pandas-3.0.1-cp313-cp313-win_arm64.whl", hash = "sha256:a8d37a43c52917427e897cb2e429f67a449327394396a81034a4449b99afda59", size = 9043855, upload-time = "2026-02-17T22:19:16.09Z" }, + { url = "https://files.pythonhosted.org/packages/92/fa/423c89086cca1f039cf1253c3ff5b90f157b5b3757314aa635f6bf3e30aa/pandas-3.0.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:d54855f04f8246ed7b6fc96b05d4871591143c46c0b6f4af874764ed0d2d6f06", size = 10752673, upload-time = "2026-02-17T22:19:18.304Z" }, + { url = "https://files.pythonhosted.org/packages/22/23/b5a08ec1f40020397f0faba72f1e2c11f7596a6169c7b3e800abff0e433f/pandas-3.0.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4e1b677accee34a09e0dc2ce5624e4a58a1870ffe56fc021e9caf7f23cd7668f", size = 10404967, upload-time = "2026-02-17T22:19:20.726Z" }, + { url = "https://files.pythonhosted.org/packages/5c/81/94841f1bb4afdc2b52a99daa895ac2c61600bb72e26525ecc9543d453ebc/pandas-3.0.1-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a9cabbdcd03f1b6cd254d6dda8ae09b0252524be1592594c00b7895916cb1324", size = 10320575, upload-time = "2026-02-17T22:19:24.919Z" }, + { url = "https://files.pythonhosted.org/packages/0a/8b/2ae37d66a5342a83adadfd0cb0b4bf9c3c7925424dd5f40d15d6cfaa35ee/pandas-3.0.1-cp313-cp313t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5ae2ab1f166668b41e770650101e7090824fd34d17915dd9cd479f5c5e0065e9", size = 10710921, upload-time = "2026-02-17T22:19:27.181Z" }, + { url = "https://files.pythonhosted.org/packages/a2/61/772b2e2757855e232b7ccf7cb8079a5711becb3a97f291c953def15a833f/pandas-3.0.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:6bf0603c2e30e2cafac32807b06435f28741135cb8697eae8b28c7d492fc7d76", size = 11334191, upload-time = "2026-02-17T22:19:29.411Z" }, + { url = "https://files.pythonhosted.org/packages/1b/08/b16c6df3ef555d8495d1d265a7963b65be166785d28f06a350913a4fac78/pandas-3.0.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6c426422973973cae1f4a23e51d4ae85974f44871b24844e4f7de752dd877098", size = 11782256, upload-time = "2026-02-17T22:19:32.34Z" }, + { url = "https://files.pythonhosted.org/packages/55/80/178af0594890dee17e239fca96d3d8670ba0f5ff59b7d0439850924a9c09/pandas-3.0.1-cp313-cp313t-win_amd64.whl", hash = "sha256:b03f91ae8c10a85c1613102c7bef5229b5379f343030a3ccefeca8a33414cf35", size = 10485047, upload-time = "2026-02-17T22:19:34.605Z" }, + { url = "https://files.pythonhosted.org/packages/bb/8b/4bb774a998b97e6c2fd62a9e6cfdaae133b636fd1c468f92afb4ae9a447a/pandas-3.0.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:99d0f92ed92d3083d140bf6b97774f9f13863924cf3f52a70711f4e7588f9d0a", size = 10322465, upload-time = "2026-02-17T22:19:36.803Z" }, + { url = "https://files.pythonhosted.org/packages/72/3a/5b39b51c64159f470f1ca3b1c2a87da290657ca022f7cd11442606f607d1/pandas-3.0.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:3b66857e983208654294bb6477b8a63dee26b37bdd0eb34d010556e91261784f", size = 9910632, upload-time = "2026-02-17T22:19:39.001Z" }, + { url = "https://files.pythonhosted.org/packages/4e/f7/b449ffb3f68c11da12fc06fbf6d2fa3a41c41e17d0284d23a79e1c13a7e4/pandas-3.0.1-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:56cf59638bf24dc9bdf2154c81e248b3289f9a09a6d04e63608c159022352749", size = 10440535, upload-time = "2026-02-17T22:19:41.157Z" }, + { url = "https://files.pythonhosted.org/packages/55/77/6ea82043db22cb0f2bbfe7198da3544000ddaadb12d26be36e19b03a2dc5/pandas-3.0.1-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1a9f55e0f46951874b863d1f3906dcb57df2d9be5c5847ba4dfb55b2c815249", size = 10893940, upload-time = "2026-02-17T22:19:43.493Z" }, + { url = "https://files.pythonhosted.org/packages/03/30/f1b502a72468c89412c1b882a08f6eed8a4ee9dc033f35f65d0663df6081/pandas-3.0.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:1849f0bba9c8a2fb0f691d492b834cc8dadf617e29015c66e989448d58d011ee", size = 11442711, upload-time = "2026-02-17T22:19:46.074Z" }, + { url = "https://files.pythonhosted.org/packages/0d/f0/ebb6ddd8fc049e98cabac5c2924d14d1dda26a20adb70d41ea2e428d3ec4/pandas-3.0.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c3d288439e11b5325b02ae6e9cc83e6805a62c40c5a6220bea9beb899c073b1c", size = 11963918, upload-time = "2026-02-17T22:19:48.838Z" }, + { url = "https://files.pythonhosted.org/packages/09/f8/8ce132104074f977f907442790eaae24e27bce3b3b454e82faa3237ff098/pandas-3.0.1-cp314-cp314-win_amd64.whl", hash = "sha256:93325b0fe372d192965f4cca88d97667f49557398bbf94abdda3bf1b591dbe66", size = 9862099, upload-time = "2026-02-17T22:19:51.081Z" }, + { url = "https://files.pythonhosted.org/packages/e6/b7/6af9aac41ef2456b768ef0ae60acf8abcebb450a52043d030a65b4b7c9bd/pandas-3.0.1-cp314-cp314-win_arm64.whl", hash = "sha256:97ca08674e3287c7148f4858b01136f8bdfe7202ad25ad04fec602dd1d29d132", size = 9185333, upload-time = "2026-02-17T22:19:53.266Z" }, + { url = "https://files.pythonhosted.org/packages/66/fc/848bb6710bc6061cb0c5badd65b92ff75c81302e0e31e496d00029fe4953/pandas-3.0.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:58eeb1b2e0fb322befcf2bbc9ba0af41e616abadb3d3414a6bc7167f6cbfce32", size = 10772664, upload-time = "2026-02-17T22:19:55.806Z" }, + { url = "https://files.pythonhosted.org/packages/69/5c/866a9bbd0f79263b4b0db6ec1a341be13a1473323f05c122388e0f15b21d/pandas-3.0.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:cd9af1276b5ca9e298bd79a26bda32fa9cc87ed095b2a9a60978d2ca058eaf87", size = 10421286, upload-time = "2026-02-17T22:19:58.091Z" }, + { url = "https://files.pythonhosted.org/packages/51/a4/2058fb84fb1cfbfb2d4a6d485e1940bb4ad5716e539d779852494479c580/pandas-3.0.1-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:94f87a04984d6b63788327cd9f79dda62b7f9043909d2440ceccf709249ca988", size = 10342050, upload-time = "2026-02-17T22:20:01.376Z" }, + { url = "https://files.pythonhosted.org/packages/22/1b/674e89996cc4be74db3c4eb09240c4bb549865c9c3f5d9b086ff8fcfbf00/pandas-3.0.1-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:85fe4c4df62e1e20f9db6ebfb88c844b092c22cd5324bdcf94bfa2fc1b391221", size = 10740055, upload-time = "2026-02-17T22:20:04.328Z" }, + { url = "https://files.pythonhosted.org/packages/d0/f8/e954b750764298c22fa4614376531fe63c521ef517e7059a51f062b87dca/pandas-3.0.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:331ca75a2f8672c365ae25c0b29e46f5ac0c6551fdace8eec4cd65e4fac271ff", size = 11357632, upload-time = "2026-02-17T22:20:06.647Z" }, + { url = "https://files.pythonhosted.org/packages/6d/02/c6e04b694ffd68568297abd03588b6d30295265176a5c01b7459d3bc35a3/pandas-3.0.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:15860b1fdb1973fffade772fdb931ccf9b2f400a3f5665aef94a00445d7d8dd5", size = 11810974, upload-time = "2026-02-17T22:20:08.946Z" }, + { url = "https://files.pythonhosted.org/packages/89/41/d7dfb63d2407f12055215070c42fc6ac41b66e90a2946cdc5e759058398b/pandas-3.0.1-cp314-cp314t-win_amd64.whl", hash = "sha256:44f1364411d5670efa692b146c748f4ed013df91ee91e9bec5677fb1fd58b937", size = 10884622, upload-time = "2026-02-17T22:20:11.711Z" }, + { url = "https://files.pythonhosted.org/packages/68/b0/34937815889fa982613775e4b97fddd13250f11012d769949c5465af2150/pandas-3.0.1-cp314-cp314t-win_arm64.whl", hash = "sha256:108dd1790337a494aa80e38def654ca3f0968cf4f362c85f44c15e471667102d", size = 9452085, upload-time = "2026-02-17T22:20:14.331Z" }, ] [[package]] @@ -1255,11 +1398,11 @@ wheels = [ [[package]] name = "parso" -version = "0.8.4" +version = "0.8.6" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/66/94/68e2e17afaa9169cf6412ab0f28623903be73d1b32e208d9e8e541bb086d/parso-0.8.4.tar.gz", hash = "sha256:eb3a7b58240fb99099a345571deecc0f9540ea5f4dd2fe14c2a99d6b281ab92d", size = 400609, upload-time = "2024-04-05T09:43:55.897Z" } +sdist = { url = "https://files.pythonhosted.org/packages/81/76/a1e769043c0c0c9fe391b702539d594731a4362334cdf4dc25d0c09761e7/parso-0.8.6.tar.gz", hash = "sha256:2b9a0332696df97d454fa67b81618fd69c35a7b90327cbe6ba5c92d2c68a7bfd", size = 401621, upload-time = "2026-02-09T15:45:24.425Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/c6/ac/dac4a63f978e4dcb3c6d3a78c4d8e0192a113d288502a1216950c41b1027/parso-0.8.4-py2.py3-none-any.whl", hash = "sha256:a418670a20291dacd2dddc80c377c5c3791378ee1e8d12bffc35420643d43f18", size = 103650, upload-time = "2024-04-05T09:43:53.299Z" }, + { url = "https://files.pythonhosted.org/packages/b6/61/fae042894f4296ec49e3f193aff5d7c18440da9e48102c3315e1bc4519a7/parso-0.8.6-py2.py3-none-any.whl", hash = "sha256:2c549f800b70a5c4952197248825584cb00f033b29c692671d3bf08bf380baff", size = 106894, upload-time = "2026-02-09T15:45:21.391Z" }, ] [[package]] @@ -1267,7 +1410,7 @@ name = "pexpect" version = "4.9.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "ptyprocess" }, + { name = "ptyprocess", marker = "sys_platform != 'emscripten' and sys_platform != 'win32'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/42/92/cc564bf6381ff43ce1f4d06852fc19a2f11d180f23dc32d9588bee2f149d/pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f", size = 166450, upload-time = "2023-11-25T09:07:26.339Z" } wheels = [ @@ -1276,66 +1419,69 @@ wheels = [ [[package]] name = "pillow" -version = "11.3.0" +version = "12.1.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/f3/0d/d0d6dea55cd152ce3d6767bb38a8fc10e33796ba4ba210cbab9354b6d238/pillow-11.3.0.tar.gz", hash = "sha256:3828ee7586cd0b2091b6209e5ad53e20d0649bbe87164a459d0676e035e8f523", size = 47113069, upload-time = "2025-07-01T09:16:30.666Z" } +sdist = { url = "https://files.pythonhosted.org/packages/1f/42/5c74462b4fd957fcd7b13b04fb3205ff8349236ea74c7c375766d6c82288/pillow-12.1.1.tar.gz", hash = "sha256:9ad8fa5937ab05218e2b6a4cff30295ad35afd2f83ac592e68c0d871bb0fdbc4", size = 46980264, upload-time = "2026-02-11T04:23:07.146Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/1e/93/0952f2ed8db3a5a4c7a11f91965d6184ebc8cd7cbb7941a260d5f018cd2d/pillow-11.3.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:1c627742b539bba4309df89171356fcb3cc5a9178355b2727d1b74a6cf155fbd", size = 2128328, upload-time = "2025-07-01T09:14:35.276Z" }, - { url = "https://files.pythonhosted.org/packages/4b/e8/100c3d114b1a0bf4042f27e0f87d2f25e857e838034e98ca98fe7b8c0a9c/pillow-11.3.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:30b7c02f3899d10f13d7a48163c8969e4e653f8b43416d23d13d1bbfdc93b9f8", size = 2170652, upload-time = "2025-07-01T09:14:37.203Z" }, - { url = "https://files.pythonhosted.org/packages/aa/86/3f758a28a6e381758545f7cdb4942e1cb79abd271bea932998fc0db93cb6/pillow-11.3.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:7859a4cc7c9295f5838015d8cc0a9c215b77e43d07a25e460f35cf516df8626f", size = 2227443, upload-time = "2025-07-01T09:14:39.344Z" }, - { url = "https://files.pythonhosted.org/packages/01/f4/91d5b3ffa718df2f53b0dc109877993e511f4fd055d7e9508682e8aba092/pillow-11.3.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ec1ee50470b0d050984394423d96325b744d55c701a439d2bd66089bff963d3c", size = 5278474, upload-time = "2025-07-01T09:14:41.843Z" }, - { url = "https://files.pythonhosted.org/packages/f9/0e/37d7d3eca6c879fbd9dba21268427dffda1ab00d4eb05b32923d4fbe3b12/pillow-11.3.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7db51d222548ccfd274e4572fdbf3e810a5e66b00608862f947b163e613b67dd", size = 4686038, upload-time = "2025-07-01T09:14:44.008Z" }, - { url = "https://files.pythonhosted.org/packages/ff/b0/3426e5c7f6565e752d81221af9d3676fdbb4f352317ceafd42899aaf5d8a/pillow-11.3.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:2d6fcc902a24ac74495df63faad1884282239265c6839a0a6416d33faedfae7e", size = 5864407, upload-time = "2025-07-03T13:10:15.628Z" }, - { url = "https://files.pythonhosted.org/packages/fc/c1/c6c423134229f2a221ee53f838d4be9d82bab86f7e2f8e75e47b6bf6cd77/pillow-11.3.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f0f5d8f4a08090c6d6d578351a2b91acf519a54986c055af27e7a93feae6d3f1", size = 7639094, upload-time = "2025-07-03T13:10:21.857Z" }, - { url = "https://files.pythonhosted.org/packages/ba/c9/09e6746630fe6372c67c648ff9deae52a2bc20897d51fa293571977ceb5d/pillow-11.3.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c37d8ba9411d6003bba9e518db0db0c58a680ab9fe5179f040b0463644bc9805", size = 5973503, upload-time = "2025-07-01T09:14:45.698Z" }, - { url = "https://files.pythonhosted.org/packages/d5/1c/a2a29649c0b1983d3ef57ee87a66487fdeb45132df66ab30dd37f7dbe162/pillow-11.3.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:13f87d581e71d9189ab21fe0efb5a23e9f28552d5be6979e84001d3b8505abe8", size = 6642574, upload-time = "2025-07-01T09:14:47.415Z" }, - { url = "https://files.pythonhosted.org/packages/36/de/d5cc31cc4b055b6c6fd990e3e7f0f8aaf36229a2698501bcb0cdf67c7146/pillow-11.3.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:023f6d2d11784a465f09fd09a34b150ea4672e85fb3d05931d89f373ab14abb2", size = 6084060, upload-time = "2025-07-01T09:14:49.636Z" }, - { url = "https://files.pythonhosted.org/packages/d5/ea/502d938cbaeec836ac28a9b730193716f0114c41325db428e6b280513f09/pillow-11.3.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:45dfc51ac5975b938e9809451c51734124e73b04d0f0ac621649821a63852e7b", size = 6721407, upload-time = "2025-07-01T09:14:51.962Z" }, - { url = "https://files.pythonhosted.org/packages/45/9c/9c5e2a73f125f6cbc59cc7087c8f2d649a7ae453f83bd0362ff7c9e2aee2/pillow-11.3.0-cp313-cp313-win32.whl", hash = "sha256:a4d336baed65d50d37b88ca5b60c0fa9d81e3a87d4a7930d3880d1624d5b31f3", size = 6273841, upload-time = "2025-07-01T09:14:54.142Z" }, - { url = "https://files.pythonhosted.org/packages/23/85/397c73524e0cd212067e0c969aa245b01d50183439550d24d9f55781b776/pillow-11.3.0-cp313-cp313-win_amd64.whl", hash = "sha256:0bce5c4fd0921f99d2e858dc4d4d64193407e1b99478bc5cacecba2311abde51", size = 6978450, upload-time = "2025-07-01T09:14:56.436Z" }, - { url = "https://files.pythonhosted.org/packages/17/d2/622f4547f69cd173955194b78e4d19ca4935a1b0f03a302d655c9f6aae65/pillow-11.3.0-cp313-cp313-win_arm64.whl", hash = "sha256:1904e1264881f682f02b7f8167935cce37bc97db457f8e7849dc3a6a52b99580", size = 2423055, upload-time = "2025-07-01T09:14:58.072Z" }, - { url = "https://files.pythonhosted.org/packages/dd/80/a8a2ac21dda2e82480852978416cfacd439a4b490a501a288ecf4fe2532d/pillow-11.3.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:4c834a3921375c48ee6b9624061076bc0a32a60b5532b322cc0ea64e639dd50e", size = 5281110, upload-time = "2025-07-01T09:14:59.79Z" }, - { url = "https://files.pythonhosted.org/packages/44/d6/b79754ca790f315918732e18f82a8146d33bcd7f4494380457ea89eb883d/pillow-11.3.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:5e05688ccef30ea69b9317a9ead994b93975104a677a36a8ed8106be9260aa6d", size = 4689547, upload-time = "2025-07-01T09:15:01.648Z" }, - { url = "https://files.pythonhosted.org/packages/49/20/716b8717d331150cb00f7fdd78169c01e8e0c219732a78b0e59b6bdb2fd6/pillow-11.3.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:1019b04af07fc0163e2810167918cb5add8d74674b6267616021ab558dc98ced", size = 5901554, upload-time = "2025-07-03T13:10:27.018Z" }, - { url = "https://files.pythonhosted.org/packages/74/cf/a9f3a2514a65bb071075063a96f0a5cf949c2f2fce683c15ccc83b1c1cab/pillow-11.3.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f944255db153ebb2b19c51fe85dd99ef0ce494123f21b9db4877ffdfc5590c7c", size = 7669132, upload-time = "2025-07-03T13:10:33.01Z" }, - { url = "https://files.pythonhosted.org/packages/98/3c/da78805cbdbee9cb43efe8261dd7cc0b4b93f2ac79b676c03159e9db2187/pillow-11.3.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1f85acb69adf2aaee8b7da124efebbdb959a104db34d3a2cb0f3793dbae422a8", size = 6005001, upload-time = "2025-07-01T09:15:03.365Z" }, - { url = "https://files.pythonhosted.org/packages/6c/fa/ce044b91faecf30e635321351bba32bab5a7e034c60187fe9698191aef4f/pillow-11.3.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:05f6ecbeff5005399bb48d198f098a9b4b6bdf27b8487c7f38ca16eeb070cd59", size = 6668814, upload-time = "2025-07-01T09:15:05.655Z" }, - { url = "https://files.pythonhosted.org/packages/7b/51/90f9291406d09bf93686434f9183aba27b831c10c87746ff49f127ee80cb/pillow-11.3.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:a7bc6e6fd0395bc052f16b1a8670859964dbd7003bd0af2ff08342eb6e442cfe", size = 6113124, upload-time = "2025-07-01T09:15:07.358Z" }, - { url = "https://files.pythonhosted.org/packages/cd/5a/6fec59b1dfb619234f7636d4157d11fb4e196caeee220232a8d2ec48488d/pillow-11.3.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:83e1b0161c9d148125083a35c1c5a89db5b7054834fd4387499e06552035236c", size = 6747186, upload-time = "2025-07-01T09:15:09.317Z" }, - { url = "https://files.pythonhosted.org/packages/49/6b/00187a044f98255225f172de653941e61da37104a9ea60e4f6887717e2b5/pillow-11.3.0-cp313-cp313t-win32.whl", hash = "sha256:2a3117c06b8fb646639dce83694f2f9eac405472713fcb1ae887469c0d4f6788", size = 6277546, upload-time = "2025-07-01T09:15:11.311Z" }, - { url = "https://files.pythonhosted.org/packages/e8/5c/6caaba7e261c0d75bab23be79f1d06b5ad2a2ae49f028ccec801b0e853d6/pillow-11.3.0-cp313-cp313t-win_amd64.whl", hash = "sha256:857844335c95bea93fb39e0fa2726b4d9d758850b34075a7e3ff4f4fa3aa3b31", size = 6985102, upload-time = "2025-07-01T09:15:13.164Z" }, - { url = "https://files.pythonhosted.org/packages/f3/7e/b623008460c09a0cb38263c93b828c666493caee2eb34ff67f778b87e58c/pillow-11.3.0-cp313-cp313t-win_arm64.whl", hash = "sha256:8797edc41f3e8536ae4b10897ee2f637235c94f27404cac7297f7b607dd0716e", size = 2424803, upload-time = "2025-07-01T09:15:15.695Z" }, - { url = "https://files.pythonhosted.org/packages/73/f4/04905af42837292ed86cb1b1dabe03dce1edc008ef14c473c5c7e1443c5d/pillow-11.3.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:d9da3df5f9ea2a89b81bb6087177fb1f4d1c7146d583a3fe5c672c0d94e55e12", size = 5278520, upload-time = "2025-07-01T09:15:17.429Z" }, - { url = "https://files.pythonhosted.org/packages/41/b0/33d79e377a336247df6348a54e6d2a2b85d644ca202555e3faa0cf811ecc/pillow-11.3.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0b275ff9b04df7b640c59ec5a3cb113eefd3795a8df80bac69646ef699c6981a", size = 4686116, upload-time = "2025-07-01T09:15:19.423Z" }, - { url = "https://files.pythonhosted.org/packages/49/2d/ed8bc0ab219ae8768f529597d9509d184fe8a6c4741a6864fea334d25f3f/pillow-11.3.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:0743841cabd3dba6a83f38a92672cccbd69af56e3e91777b0ee7f4dba4385632", size = 5864597, upload-time = "2025-07-03T13:10:38.404Z" }, - { url = "https://files.pythonhosted.org/packages/b5/3d/b932bb4225c80b58dfadaca9d42d08d0b7064d2d1791b6a237f87f661834/pillow-11.3.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2465a69cf967b8b49ee1b96d76718cd98c4e925414ead59fdf75cf0fd07df673", size = 7638246, upload-time = "2025-07-03T13:10:44.987Z" }, - { url = "https://files.pythonhosted.org/packages/09/b5/0487044b7c096f1b48f0d7ad416472c02e0e4bf6919541b111efd3cae690/pillow-11.3.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:41742638139424703b4d01665b807c6468e23e699e8e90cffefe291c5832b027", size = 5973336, upload-time = "2025-07-01T09:15:21.237Z" }, - { url = "https://files.pythonhosted.org/packages/a8/2d/524f9318f6cbfcc79fbc004801ea6b607ec3f843977652fdee4857a7568b/pillow-11.3.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:93efb0b4de7e340d99057415c749175e24c8864302369e05914682ba642e5d77", size = 6642699, upload-time = "2025-07-01T09:15:23.186Z" }, - { url = "https://files.pythonhosted.org/packages/6f/d2/a9a4f280c6aefedce1e8f615baaa5474e0701d86dd6f1dede66726462bbd/pillow-11.3.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7966e38dcd0fa11ca390aed7c6f20454443581d758242023cf36fcb319b1a874", size = 6083789, upload-time = "2025-07-01T09:15:25.1Z" }, - { url = "https://files.pythonhosted.org/packages/fe/54/86b0cd9dbb683a9d5e960b66c7379e821a19be4ac5810e2e5a715c09a0c0/pillow-11.3.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:98a9afa7b9007c67ed84c57c9e0ad86a6000da96eaa638e4f8abe5b65ff83f0a", size = 6720386, upload-time = "2025-07-01T09:15:27.378Z" }, - { url = "https://files.pythonhosted.org/packages/e7/95/88efcaf384c3588e24259c4203b909cbe3e3c2d887af9e938c2022c9dd48/pillow-11.3.0-cp314-cp314-win32.whl", hash = "sha256:02a723e6bf909e7cea0dac1b0e0310be9d7650cd66222a5f1c571455c0a45214", size = 6370911, upload-time = "2025-07-01T09:15:29.294Z" }, - { url = "https://files.pythonhosted.org/packages/2e/cc/934e5820850ec5eb107e7b1a72dd278140731c669f396110ebc326f2a503/pillow-11.3.0-cp314-cp314-win_amd64.whl", hash = "sha256:a418486160228f64dd9e9efcd132679b7a02a5f22c982c78b6fc7dab3fefb635", size = 7117383, upload-time = "2025-07-01T09:15:31.128Z" }, - { url = "https://files.pythonhosted.org/packages/d6/e9/9c0a616a71da2a5d163aa37405e8aced9a906d574b4a214bede134e731bc/pillow-11.3.0-cp314-cp314-win_arm64.whl", hash = "sha256:155658efb5e044669c08896c0c44231c5e9abcaadbc5cd3648df2f7c0b96b9a6", size = 2511385, upload-time = "2025-07-01T09:15:33.328Z" }, - { url = "https://files.pythonhosted.org/packages/1a/33/c88376898aff369658b225262cd4f2659b13e8178e7534df9e6e1fa289f6/pillow-11.3.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:59a03cdf019efbfeeed910bf79c7c93255c3d54bc45898ac2a4140071b02b4ae", size = 5281129, upload-time = "2025-07-01T09:15:35.194Z" }, - { url = "https://files.pythonhosted.org/packages/1f/70/d376247fb36f1844b42910911c83a02d5544ebd2a8bad9efcc0f707ea774/pillow-11.3.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f8a5827f84d973d8636e9dc5764af4f0cf2318d26744b3d902931701b0d46653", size = 4689580, upload-time = "2025-07-01T09:15:37.114Z" }, - { url = "https://files.pythonhosted.org/packages/eb/1c/537e930496149fbac69efd2fc4329035bbe2e5475b4165439e3be9cb183b/pillow-11.3.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ee92f2fd10f4adc4b43d07ec5e779932b4eb3dbfbc34790ada5a6669bc095aa6", size = 5902860, upload-time = "2025-07-03T13:10:50.248Z" }, - { url = "https://files.pythonhosted.org/packages/bd/57/80f53264954dcefeebcf9dae6e3eb1daea1b488f0be8b8fef12f79a3eb10/pillow-11.3.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c96d333dcf42d01f47b37e0979b6bd73ec91eae18614864622d9b87bbd5bbf36", size = 7670694, upload-time = "2025-07-03T13:10:56.432Z" }, - { url = "https://files.pythonhosted.org/packages/70/ff/4727d3b71a8578b4587d9c276e90efad2d6fe0335fd76742a6da08132e8c/pillow-11.3.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4c96f993ab8c98460cd0c001447bff6194403e8b1d7e149ade5f00594918128b", size = 6005888, upload-time = "2025-07-01T09:15:39.436Z" }, - { url = "https://files.pythonhosted.org/packages/05/ae/716592277934f85d3be51d7256f3636672d7b1abfafdc42cf3f8cbd4b4c8/pillow-11.3.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:41342b64afeba938edb034d122b2dda5db2139b9a4af999729ba8818e0056477", size = 6670330, upload-time = "2025-07-01T09:15:41.269Z" }, - { url = "https://files.pythonhosted.org/packages/e7/bb/7fe6cddcc8827b01b1a9766f5fdeb7418680744f9082035bdbabecf1d57f/pillow-11.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:068d9c39a2d1b358eb9f245ce7ab1b5c3246c7c8c7d9ba58cfa5b43146c06e50", size = 6114089, upload-time = "2025-07-01T09:15:43.13Z" }, - { url = "https://files.pythonhosted.org/packages/8b/f5/06bfaa444c8e80f1a8e4bff98da9c83b37b5be3b1deaa43d27a0db37ef84/pillow-11.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a1bc6ba083b145187f648b667e05a2534ecc4b9f2784c2cbe3089e44868f2b9b", size = 6748206, upload-time = "2025-07-01T09:15:44.937Z" }, - { url = "https://files.pythonhosted.org/packages/f0/77/bc6f92a3e8e6e46c0ca78abfffec0037845800ea38c73483760362804c41/pillow-11.3.0-cp314-cp314t-win32.whl", hash = "sha256:118ca10c0d60b06d006be10a501fd6bbdfef559251ed31b794668ed569c87e12", size = 6377370, upload-time = "2025-07-01T09:15:46.673Z" }, - { url = "https://files.pythonhosted.org/packages/4a/82/3a721f7d69dca802befb8af08b7c79ebcab461007ce1c18bd91a5d5896f9/pillow-11.3.0-cp314-cp314t-win_amd64.whl", hash = "sha256:8924748b688aa210d79883357d102cd64690e56b923a186f35a82cbc10f997db", size = 7121500, upload-time = "2025-07-01T09:15:48.512Z" }, - { url = "https://files.pythonhosted.org/packages/89/c7/5572fa4a3f45740eaab6ae86fcdf7195b55beac1371ac8c619d880cfe948/pillow-11.3.0-cp314-cp314t-win_arm64.whl", hash = "sha256:79ea0d14d3ebad43ec77ad5272e6ff9bba5b679ef73375ea760261207fa8e0aa", size = 2512835, upload-time = "2025-07-01T09:15:50.399Z" }, + { url = "https://files.pythonhosted.org/packages/d5/11/6db24d4bd7685583caeae54b7009584e38da3c3d4488ed4cd25b439de486/pillow-12.1.1-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:d242e8ac078781f1de88bf823d70c1a9b3c7950a44cdf4b7c012e22ccbcd8e4e", size = 4062689, upload-time = "2026-02-11T04:21:06.804Z" }, + { url = "https://files.pythonhosted.org/packages/33/c0/ce6d3b1fe190f0021203e0d9b5b99e57843e345f15f9ef22fcd43842fd21/pillow-12.1.1-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:02f84dfad02693676692746df05b89cf25597560db2857363a208e393429f5e9", size = 4138535, upload-time = "2026-02-11T04:21:08.452Z" }, + { url = "https://files.pythonhosted.org/packages/a0/c6/d5eb6a4fb32a3f9c21a8c7613ec706534ea1cf9f4b3663e99f0d83f6fca8/pillow-12.1.1-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:e65498daf4b583091ccbb2556c7000abf0f3349fcd57ef7adc9a84a394ed29f6", size = 3601364, upload-time = "2026-02-11T04:21:10.194Z" }, + { url = "https://files.pythonhosted.org/packages/14/a1/16c4b823838ba4c9c52c0e6bbda903a3fe5a1bdbf1b8eb4fff7156f3e318/pillow-12.1.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:6c6db3b84c87d48d0088943bf33440e0c42370b99b1c2a7989216f7b42eede60", size = 5262561, upload-time = "2026-02-11T04:21:11.742Z" }, + { url = "https://files.pythonhosted.org/packages/bb/ad/ad9dc98ff24f485008aa5cdedaf1a219876f6f6c42a4626c08bc4e80b120/pillow-12.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:8b7e5304e34942bf62e15184219a7b5ad4ff7f3bb5cca4d984f37df1a0e1aee2", size = 4657460, upload-time = "2026-02-11T04:21:13.786Z" }, + { url = "https://files.pythonhosted.org/packages/9e/1b/f1a4ea9a895b5732152789326202a82464d5254759fbacae4deea3069334/pillow-12.1.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:18e5bddd742a44b7e6b1e773ab5db102bd7a94c32555ba656e76d319d19c3850", size = 6232698, upload-time = "2026-02-11T04:21:15.949Z" }, + { url = "https://files.pythonhosted.org/packages/95/f4/86f51b8745070daf21fd2e5b1fe0eb35d4db9ca26e6d58366562fb56a743/pillow-12.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:fc44ef1f3de4f45b50ccf9136999d71abb99dca7706bc75d222ed350b9fd2289", size = 8041706, upload-time = "2026-02-11T04:21:17.723Z" }, + { url = "https://files.pythonhosted.org/packages/29/9b/d6ecd956bb1266dd1045e995cce9b8d77759e740953a1c9aad9502a0461e/pillow-12.1.1-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5a8eb7ed8d4198bccbd07058416eeec51686b498e784eda166395a23eb99138e", size = 6346621, upload-time = "2026-02-11T04:21:19.547Z" }, + { url = "https://files.pythonhosted.org/packages/71/24/538bff45bde96535d7d998c6fed1a751c75ac7c53c37c90dc2601b243893/pillow-12.1.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:47b94983da0c642de92ced1702c5b6c292a84bd3a8e1d1702ff923f183594717", size = 7038069, upload-time = "2026-02-11T04:21:21.378Z" }, + { url = "https://files.pythonhosted.org/packages/94/0e/58cb1a6bc48f746bc4cb3adb8cabff73e2742c92b3bf7a220b7cf69b9177/pillow-12.1.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:518a48c2aab7ce596d3bf79d0e275661b846e86e4d0e7dec34712c30fe07f02a", size = 6460040, upload-time = "2026-02-11T04:21:23.148Z" }, + { url = "https://files.pythonhosted.org/packages/6c/57/9045cb3ff11eeb6c1adce3b2d60d7d299d7b273a2e6c8381a524abfdc474/pillow-12.1.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a550ae29b95c6dc13cf69e2c9dc5747f814c54eeb2e32d683e5e93af56caa029", size = 7164523, upload-time = "2026-02-11T04:21:25.01Z" }, + { url = "https://files.pythonhosted.org/packages/73/f2/9be9cb99f2175f0d4dbadd6616ce1bf068ee54a28277ea1bf1fbf729c250/pillow-12.1.1-cp313-cp313-win32.whl", hash = "sha256:a003d7422449f6d1e3a34e3dd4110c22148336918ddbfc6a32581cd54b2e0b2b", size = 6332552, upload-time = "2026-02-11T04:21:27.238Z" }, + { url = "https://files.pythonhosted.org/packages/3f/eb/b0834ad8b583d7d9d42b80becff092082a1c3c156bb582590fcc973f1c7c/pillow-12.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:344cf1e3dab3be4b1fa08e449323d98a2a3f819ad20f4b22e77a0ede31f0faa1", size = 7040108, upload-time = "2026-02-11T04:21:29.462Z" }, + { url = "https://files.pythonhosted.org/packages/d5/7d/fc09634e2aabdd0feabaff4a32f4a7d97789223e7c2042fd805ea4b4d2c2/pillow-12.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:5c0dd1636633e7e6a0afe7bf6a51a14992b7f8e60de5789018ebbdfae55b040a", size = 2453712, upload-time = "2026-02-11T04:21:31.072Z" }, + { url = "https://files.pythonhosted.org/packages/19/2a/b9d62794fc8a0dd14c1943df68347badbd5511103e0d04c035ffe5cf2255/pillow-12.1.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0330d233c1a0ead844fc097a7d16c0abff4c12e856c0b325f231820fee1f39da", size = 5264880, upload-time = "2026-02-11T04:21:32.865Z" }, + { url = "https://files.pythonhosted.org/packages/26/9d/e03d857d1347fa5ed9247e123fcd2a97b6220e15e9cb73ca0a8d91702c6e/pillow-12.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:5dae5f21afb91322f2ff791895ddd8889e5e947ff59f71b46041c8ce6db790bc", size = 4660616, upload-time = "2026-02-11T04:21:34.97Z" }, + { url = "https://files.pythonhosted.org/packages/f7/ec/8a6d22afd02570d30954e043f09c32772bfe143ba9285e2fdb11284952cd/pillow-12.1.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:2e0c664be47252947d870ac0d327fea7e63985a08794758aa8af5b6cb6ec0c9c", size = 6269008, upload-time = "2026-02-11T04:21:36.623Z" }, + { url = "https://files.pythonhosted.org/packages/3d/1d/6d875422c9f28a4a361f495a5f68d9de4a66941dc2c619103ca335fa6446/pillow-12.1.1-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:691ab2ac363b8217f7d31b3497108fb1f50faab2f75dfb03284ec2f217e87bf8", size = 8073226, upload-time = "2026-02-11T04:21:38.585Z" }, + { url = "https://files.pythonhosted.org/packages/a1/cd/134b0b6ee5eda6dc09e25e24b40fdafe11a520bc725c1d0bbaa5e00bf95b/pillow-12.1.1-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e9e8064fb1cc019296958595f6db671fba95209e3ceb0c4734c9baf97de04b20", size = 6380136, upload-time = "2026-02-11T04:21:40.562Z" }, + { url = "https://files.pythonhosted.org/packages/7a/a9/7628f013f18f001c1b98d8fffe3452f306a70dc6aba7d931019e0492f45e/pillow-12.1.1-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:472a8d7ded663e6162dafdf20015c486a7009483ca671cece7a9279b512fcb13", size = 7067129, upload-time = "2026-02-11T04:21:42.521Z" }, + { url = "https://files.pythonhosted.org/packages/1e/f8/66ab30a2193b277785601e82ee2d49f68ea575d9637e5e234faaa98efa4c/pillow-12.1.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:89b54027a766529136a06cfebeecb3a04900397a3590fd252160b888479517bf", size = 6491807, upload-time = "2026-02-11T04:21:44.22Z" }, + { url = "https://files.pythonhosted.org/packages/da/0b/a877a6627dc8318fdb84e357c5e1a758c0941ab1ddffdafd231983788579/pillow-12.1.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:86172b0831b82ce4f7877f280055892b31179e1576aa00d0df3bb1bbf8c3e524", size = 7190954, upload-time = "2026-02-11T04:21:46.114Z" }, + { url = "https://files.pythonhosted.org/packages/83/43/6f732ff85743cf746b1361b91665d9f5155e1483817f693f8d57ea93147f/pillow-12.1.1-cp313-cp313t-win32.whl", hash = "sha256:44ce27545b6efcf0fdbdceb31c9a5bdea9333e664cda58a7e674bb74608b3986", size = 6336441, upload-time = "2026-02-11T04:21:48.22Z" }, + { url = "https://files.pythonhosted.org/packages/3b/44/e865ef3986611bb75bfabdf94a590016ea327833f434558801122979cd0e/pillow-12.1.1-cp313-cp313t-win_amd64.whl", hash = "sha256:a285e3eb7a5a45a2ff504e31f4a8d1b12ef62e84e5411c6804a42197c1cf586c", size = 7045383, upload-time = "2026-02-11T04:21:50.015Z" }, + { url = "https://files.pythonhosted.org/packages/a8/c6/f4fb24268d0c6908b9f04143697ea18b0379490cb74ba9e8d41b898bd005/pillow-12.1.1-cp313-cp313t-win_arm64.whl", hash = "sha256:cc7d296b5ea4d29e6570dabeaed58d31c3fea35a633a69679fb03d7664f43fb3", size = 2456104, upload-time = "2026-02-11T04:21:51.633Z" }, + { url = "https://files.pythonhosted.org/packages/03/d0/bebb3ffbf31c5a8e97241476c4cf8b9828954693ce6744b4a2326af3e16b/pillow-12.1.1-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:417423db963cb4be8bac3fc1204fe61610f6abeed1580a7a2cbb2fbda20f12af", size = 4062652, upload-time = "2026-02-11T04:21:53.19Z" }, + { url = "https://files.pythonhosted.org/packages/2d/c0/0e16fb0addda4851445c28f8350d8c512f09de27bbb0d6d0bbf8b6709605/pillow-12.1.1-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:b957b71c6b2387610f556a7eb0828afbe40b4a98036fc0d2acfa5a44a0c2036f", size = 4138823, upload-time = "2026-02-11T04:22:03.088Z" }, + { url = "https://files.pythonhosted.org/packages/6b/fb/6170ec655d6f6bb6630a013dd7cf7bc218423d7b5fa9071bf63dc32175ae/pillow-12.1.1-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:097690ba1f2efdeb165a20469d59d8bb03c55fb6621eb2041a060ae8ea3e9642", size = 3601143, upload-time = "2026-02-11T04:22:04.909Z" }, + { url = "https://files.pythonhosted.org/packages/59/04/dc5c3f297510ba9a6837cbb318b87dd2b8f73eb41a43cc63767f65cb599c/pillow-12.1.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:2815a87ab27848db0321fb78c7f0b2c8649dee134b7f2b80c6a45c6831d75ccd", size = 5266254, upload-time = "2026-02-11T04:22:07.656Z" }, + { url = "https://files.pythonhosted.org/packages/05/30/5db1236b0d6313f03ebf97f5e17cda9ca060f524b2fcc875149a8360b21c/pillow-12.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:f7ed2c6543bad5a7d5530eb9e78c53132f93dfa44a28492db88b41cdab885202", size = 4657499, upload-time = "2026-02-11T04:22:09.613Z" }, + { url = "https://files.pythonhosted.org/packages/6f/18/008d2ca0eb612e81968e8be0bbae5051efba24d52debf930126d7eaacbba/pillow-12.1.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:652a2c9ccfb556235b2b501a3a7cf3742148cd22e04b5625c5fe057ea3e3191f", size = 6232137, upload-time = "2026-02-11T04:22:11.434Z" }, + { url = "https://files.pythonhosted.org/packages/70/f1/f14d5b8eeb4b2cd62b9f9f847eb6605f103df89ef619ac68f92f748614ea/pillow-12.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d6e4571eedf43af33d0fc233a382a76e849badbccdf1ac438841308652a08e1f", size = 8042721, upload-time = "2026-02-11T04:22:13.321Z" }, + { url = "https://files.pythonhosted.org/packages/5a/d6/17824509146e4babbdabf04d8171491fa9d776f7061ff6e727522df9bd03/pillow-12.1.1-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b574c51cf7d5d62e9be37ba446224b59a2da26dc4c1bb2ecbe936a4fb1a7cb7f", size = 6347798, upload-time = "2026-02-11T04:22:15.449Z" }, + { url = "https://files.pythonhosted.org/packages/d1/ee/c85a38a9ab92037a75615aba572c85ea51e605265036e00c5b67dfafbfe2/pillow-12.1.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a37691702ed687799de29a518d63d4682d9016932db66d4e90c345831b02fb4e", size = 7039315, upload-time = "2026-02-11T04:22:17.24Z" }, + { url = "https://files.pythonhosted.org/packages/ec/f3/bc8ccc6e08a148290d7523bde4d9a0d6c981db34631390dc6e6ec34cacf6/pillow-12.1.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f95c00d5d6700b2b890479664a06e754974848afaae5e21beb4d83c106923fd0", size = 6462360, upload-time = "2026-02-11T04:22:19.111Z" }, + { url = "https://files.pythonhosted.org/packages/f6/ab/69a42656adb1d0665ab051eec58a41f169ad295cf81ad45406963105408f/pillow-12.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:559b38da23606e68681337ad74622c4dbba02254fc9cb4488a305dd5975c7eeb", size = 7165438, upload-time = "2026-02-11T04:22:21.041Z" }, + { url = "https://files.pythonhosted.org/packages/02/46/81f7aa8941873f0f01d4b55cc543b0a3d03ec2ee30d617a0448bf6bd6dec/pillow-12.1.1-cp314-cp314-win32.whl", hash = "sha256:03edcc34d688572014ff223c125a3f77fb08091e4607e7745002fc214070b35f", size = 6431503, upload-time = "2026-02-11T04:22:22.833Z" }, + { url = "https://files.pythonhosted.org/packages/40/72/4c245f7d1044b67affc7f134a09ea619d4895333d35322b775b928180044/pillow-12.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:50480dcd74fa63b8e78235957d302d98d98d82ccbfac4c7e12108ba9ecbdba15", size = 7176748, upload-time = "2026-02-11T04:22:24.64Z" }, + { url = "https://files.pythonhosted.org/packages/e4/ad/8a87bdbe038c5c698736e3348af5c2194ffb872ea52f11894c95f9305435/pillow-12.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:5cb1785d97b0c3d1d1a16bc1d710c4a0049daefc4935f3a8f31f827f4d3d2e7f", size = 2544314, upload-time = "2026-02-11T04:22:26.685Z" }, + { url = "https://files.pythonhosted.org/packages/6c/9d/efd18493f9de13b87ede7c47e69184b9e859e4427225ea962e32e56a49bc/pillow-12.1.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:1f90cff8aa76835cba5769f0b3121a22bd4eb9e6884cfe338216e557a9a548b8", size = 5268612, upload-time = "2026-02-11T04:22:29.884Z" }, + { url = "https://files.pythonhosted.org/packages/f8/f1/4f42eb2b388eb2ffc660dcb7f7b556c1015c53ebd5f7f754965ef997585b/pillow-12.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1f1be78ce9466a7ee64bfda57bdba0f7cc499d9794d518b854816c41bf0aa4e9", size = 4660567, upload-time = "2026-02-11T04:22:31.799Z" }, + { url = "https://files.pythonhosted.org/packages/01/54/df6ef130fa43e4b82e32624a7b821a2be1c5653a5fdad8469687a7db4e00/pillow-12.1.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:42fc1f4677106188ad9a55562bbade416f8b55456f522430fadab3cef7cd4e60", size = 6269951, upload-time = "2026-02-11T04:22:33.921Z" }, + { url = "https://files.pythonhosted.org/packages/a9/48/618752d06cc44bb4aae8ce0cd4e6426871929ed7b46215638088270d9b34/pillow-12.1.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:98edb152429ab62a1818039744d8fbb3ccab98a7c29fc3d5fcef158f3f1f68b7", size = 8074769, upload-time = "2026-02-11T04:22:35.877Z" }, + { url = "https://files.pythonhosted.org/packages/c3/bd/f1d71eb39a72fa088d938655afba3e00b38018d052752f435838961127d8/pillow-12.1.1-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d470ab1178551dd17fdba0fef463359c41aaa613cdcd7ff8373f54be629f9f8f", size = 6381358, upload-time = "2026-02-11T04:22:37.698Z" }, + { url = "https://files.pythonhosted.org/packages/64/ef/c784e20b96674ed36a5af839305f55616f8b4f8aa8eeccf8531a6e312243/pillow-12.1.1-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6408a7b064595afcab0a49393a413732a35788f2a5092fdc6266952ed67de586", size = 7068558, upload-time = "2026-02-11T04:22:39.597Z" }, + { url = "https://files.pythonhosted.org/packages/73/cb/8059688b74422ae61278202c4e1ad992e8a2e7375227be0a21c6b87ca8d5/pillow-12.1.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5d8c41325b382c07799a3682c1c258469ea2ff97103c53717b7893862d0c98ce", size = 6493028, upload-time = "2026-02-11T04:22:42.73Z" }, + { url = "https://files.pythonhosted.org/packages/c6/da/e3c008ed7d2dd1f905b15949325934510b9d1931e5df999bb15972756818/pillow-12.1.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:c7697918b5be27424e9ce568193efd13d925c4481dd364e43f5dff72d33e10f8", size = 7191940, upload-time = "2026-02-11T04:22:44.543Z" }, + { url = "https://files.pythonhosted.org/packages/01/4a/9202e8d11714c1fc5951f2e1ef362f2d7fbc595e1f6717971d5dd750e969/pillow-12.1.1-cp314-cp314t-win32.whl", hash = "sha256:d2912fd8114fc5545aa3a4b5576512f64c55a03f3ebcca4c10194d593d43ea36", size = 6438736, upload-time = "2026-02-11T04:22:46.347Z" }, + { url = "https://files.pythonhosted.org/packages/f3/ca/cbce2327eb9885476b3957b2e82eb12c866a8b16ad77392864ad601022ce/pillow-12.1.1-cp314-cp314t-win_amd64.whl", hash = "sha256:4ceb838d4bd9dab43e06c363cab2eebf63846d6a4aeaea283bbdfd8f1a8ed58b", size = 7182894, upload-time = "2026-02-11T04:22:48.114Z" }, + { url = "https://files.pythonhosted.org/packages/ec/d2/de599c95ba0a973b94410477f8bf0b6f0b5e67360eb89bcb1ad365258beb/pillow-12.1.1-cp314-cp314t-win_arm64.whl", hash = "sha256:7b03048319bfc6170e93bd60728a1af51d3dd7704935feb228c4d4faab35d334", size = 2546446, upload-time = "2026-02-11T04:22:50.342Z" }, ] [[package]] name = "platformdirs" -version = "4.3.8" +version = "4.9.2" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/fe/8b/3c73abc9c759ecd3f1f7ceff6685840859e8070c4d947c93fae71f6a0bf2/platformdirs-4.3.8.tar.gz", hash = "sha256:3d512d96e16bcb959a814c9f348431070822a6496326a4be0911c40b5a74c2bc", size = 21362, upload-time = "2025-05-07T22:47:42.121Z" } +sdist = { url = "https://files.pythonhosted.org/packages/1b/04/fea538adf7dbbd6d186f551d595961e564a3b6715bdf276b477460858672/platformdirs-4.9.2.tar.gz", hash = "sha256:9a33809944b9db043ad67ca0db94b14bf452cc6aeaac46a88ea55b26e2e9d291", size = 28394, upload-time = "2026-02-16T03:56:10.574Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fe/39/979e8e21520d4e47a0bbe349e2713c0aac6f3d853d0e5b34d76206c439aa/platformdirs-4.3.8-py3-none-any.whl", hash = "sha256:ff7059bb7eb1179e2685604f4aaf157cfd9535242bd23742eadc3c13542139b4", size = 18567, upload-time = "2025-05-07T22:47:40.376Z" }, + { url = "https://files.pythonhosted.org/packages/48/31/05e764397056194206169869b50cf2fee4dbbbc71b344705b9c0d878d4d8/platformdirs-4.9.2-py3-none-any.whl", hash = "sha256:9170634f126f8efdae22fb58ae8a0eaa86f38365bc57897a6c4f781d1f5875bd", size = 21168, upload-time = "2026-02-16T03:56:08.891Z" }, ] [[package]] @@ -1349,38 +1495,51 @@ wheels = [ [[package]] name = "prometheus-client" -version = "0.22.1" +version = "0.24.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/5e/cf/40dde0a2be27cc1eb41e333d1a674a74ce8b8b0457269cc640fd42b07cf7/prometheus_client-0.22.1.tar.gz", hash = "sha256:190f1331e783cf21eb60bca559354e0a4d4378facecf78f5428c39b675d20d28", size = 69746, upload-time = "2025-06-02T14:29:01.152Z" } +sdist = { url = "https://files.pythonhosted.org/packages/f0/58/a794d23feb6b00fc0c72787d7e87d872a6730dd9ed7c7b3e954637d8f280/prometheus_client-0.24.1.tar.gz", hash = "sha256:7e0ced7fbbd40f7b84962d5d2ab6f17ef88a72504dcf7c0b40737b43b2a461f9", size = 85616, upload-time = "2026-01-14T15:26:26.965Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/32/ae/ec06af4fe3ee72d16973474f122541746196aaa16cea6f66d18b963c6177/prometheus_client-0.22.1-py3-none-any.whl", hash = "sha256:cca895342e308174341b2cbf99a56bef291fbc0ef7b9e5412a0f26d653ba7094", size = 58694, upload-time = "2025-06-02T14:29:00.068Z" }, + { url = "https://files.pythonhosted.org/packages/74/c3/24a2f845e3917201628ecaba4f18bab4d18a337834c1df2a159ee9d22a42/prometheus_client-0.24.1-py3-none-any.whl", hash = "sha256:150db128af71a5c2482b36e588fc8a6b95e498750da4b17065947c16070f4055", size = 64057, upload-time = "2026-01-14T15:26:24.42Z" }, ] [[package]] name = "prompt-toolkit" -version = "3.0.51" +version = "3.0.52" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "wcwidth" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/bb/6e/9d084c929dfe9e3bfe0c6a47e31f78a25c54627d64a66e884a8bf5474f1c/prompt_toolkit-3.0.51.tar.gz", hash = "sha256:931a162e3b27fc90c86f1b48bb1fb2c528c2761475e57c9c06de13311c7b54ed", size = 428940, upload-time = "2025-04-15T09:18:47.731Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a1/96/06e01a7b38dce6fe1db213e061a4602dd6032a8a97ef6c1a862537732421/prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855", size = 434198, upload-time = "2025-08-27T15:24:02.057Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/ce/4f/5249960887b1fbe561d9ff265496d170b55a735b76724f10ef19f9e40716/prompt_toolkit-3.0.51-py3-none-any.whl", hash = "sha256:52742911fde84e2d423e2f9a4cf1de7d7ac4e51958f648d9540e0fb8db077b07", size = 387810, upload-time = "2025-04-15T09:18:44.753Z" }, + { url = "https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl", hash = "sha256:9aac639a3bbd33284347de5ad8d68ecc044b91a762dc39b7c21095fcd6a19955", size = 391431, upload-time = "2025-08-27T15:23:59.498Z" }, ] [[package]] name = "psutil" -version = "7.0.0" +version = "7.2.2" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/2a/80/336820c1ad9286a4ded7e845b2eccfcb27851ab8ac6abece774a6ff4d3de/psutil-7.0.0.tar.gz", hash = "sha256:7be9c3eba38beccb6495ea33afd982a44074b78f28c434a1f51cc07fd315c456", size = 497003, upload-time = "2025-02-13T21:54:07.946Z" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/c6/d1ddf4abb55e93cebc4f2ed8b5d6dbad109ecb8d63748dd2b20ab5e57ebe/psutil-7.2.2.tar.gz", hash = "sha256:0746f5f8d406af344fd547f1c8daa5f5c33dbc293bb8d6a16d80b4bb88f59372", size = 493740, upload-time = "2026-01-28T18:14:54.428Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/ed/e6/2d26234410f8b8abdbf891c9da62bee396583f713fb9f3325a4760875d22/psutil-7.0.0-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:101d71dc322e3cffd7cea0650b09b3d08b8e7c4109dd6809fe452dfd00e58b25", size = 238051, upload-time = "2025-02-13T21:54:12.36Z" }, - { url = "https://files.pythonhosted.org/packages/04/8b/30f930733afe425e3cbfc0e1468a30a18942350c1a8816acfade80c005c4/psutil-7.0.0-cp36-abi3-macosx_11_0_arm64.whl", hash = "sha256:39db632f6bb862eeccf56660871433e111b6ea58f2caea825571951d4b6aa3da", size = 239535, upload-time = "2025-02-13T21:54:16.07Z" }, - { url = "https://files.pythonhosted.org/packages/2a/ed/d362e84620dd22876b55389248e522338ed1bf134a5edd3b8231d7207f6d/psutil-7.0.0-cp36-abi3-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1fcee592b4c6f146991ca55919ea3d1f8926497a713ed7faaf8225e174581e91", size = 275004, upload-time = "2025-02-13T21:54:18.662Z" }, - { url = "https://files.pythonhosted.org/packages/bf/b9/b0eb3f3cbcb734d930fdf839431606844a825b23eaf9a6ab371edac8162c/psutil-7.0.0-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b1388a4f6875d7e2aff5c4ca1cc16c545ed41dd8bb596cefea80111db353a34", size = 277986, upload-time = "2025-02-13T21:54:21.811Z" }, - { url = "https://files.pythonhosted.org/packages/eb/a2/709e0fe2f093556c17fbafda93ac032257242cabcc7ff3369e2cb76a97aa/psutil-7.0.0-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a5f098451abc2828f7dc6b58d44b532b22f2088f4999a937557b603ce72b1993", size = 279544, upload-time = "2025-02-13T21:54:24.68Z" }, - { url = "https://files.pythonhosted.org/packages/50/e6/eecf58810b9d12e6427369784efe814a1eec0f492084ce8eb8f4d89d6d61/psutil-7.0.0-cp37-abi3-win32.whl", hash = "sha256:ba3fcef7523064a6c9da440fc4d6bd07da93ac726b5733c29027d7dc95b39d99", size = 241053, upload-time = "2025-02-13T21:54:34.31Z" }, - { url = "https://files.pythonhosted.org/packages/50/1b/6921afe68c74868b4c9fa424dad3be35b095e16687989ebbb50ce4fceb7c/psutil-7.0.0-cp37-abi3-win_amd64.whl", hash = "sha256:4cf3d4eb1aa9b348dec30105c55cd9b7d4629285735a102beb4441e38db90553", size = 244885, upload-time = "2025-02-13T21:54:37.486Z" }, + { url = "https://files.pythonhosted.org/packages/51/08/510cbdb69c25a96f4ae523f733cdc963ae654904e8db864c07585ef99875/psutil-7.2.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:2edccc433cbfa046b980b0df0171cd25bcaeb3a68fe9022db0979e7aa74a826b", size = 130595, upload-time = "2026-01-28T18:14:57.293Z" }, + { url = "https://files.pythonhosted.org/packages/d6/f5/97baea3fe7a5a9af7436301f85490905379b1c6f2dd51fe3ecf24b4c5fbf/psutil-7.2.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:e78c8603dcd9a04c7364f1a3e670cea95d51ee865e4efb3556a3a63adef958ea", size = 131082, upload-time = "2026-01-28T18:14:59.732Z" }, + { url = "https://files.pythonhosted.org/packages/37/d6/246513fbf9fa174af531f28412297dd05241d97a75911ac8febefa1a53c6/psutil-7.2.2-cp313-cp313t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1a571f2330c966c62aeda00dd24620425d4b0cc86881c89861fbc04549e5dc63", size = 181476, upload-time = "2026-01-28T18:15:01.884Z" }, + { url = "https://files.pythonhosted.org/packages/b8/b5/9182c9af3836cca61696dabe4fd1304e17bc56cb62f17439e1154f225dd3/psutil-7.2.2-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:917e891983ca3c1887b4ef36447b1e0873e70c933afc831c6b6da078ba474312", size = 184062, upload-time = "2026-01-28T18:15:04.436Z" }, + { url = "https://files.pythonhosted.org/packages/16/ba/0756dca669f5a9300d0cbcbfae9a4c30e446dfc7440ffe43ded5724bfd93/psutil-7.2.2-cp313-cp313t-win_amd64.whl", hash = "sha256:ab486563df44c17f5173621c7b198955bd6b613fb87c71c161f827d3fb149a9b", size = 139893, upload-time = "2026-01-28T18:15:06.378Z" }, + { url = "https://files.pythonhosted.org/packages/1c/61/8fa0e26f33623b49949346de05ec1ddaad02ed8ba64af45f40a147dbfa97/psutil-7.2.2-cp313-cp313t-win_arm64.whl", hash = "sha256:ae0aefdd8796a7737eccea863f80f81e468a1e4cf14d926bd9b6f5f2d5f90ca9", size = 135589, upload-time = "2026-01-28T18:15:08.03Z" }, + { url = "https://files.pythonhosted.org/packages/81/69/ef179ab5ca24f32acc1dac0c247fd6a13b501fd5534dbae0e05a1c48b66d/psutil-7.2.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:eed63d3b4d62449571547b60578c5b2c4bcccc5387148db46e0c2313dad0ee00", size = 130664, upload-time = "2026-01-28T18:15:09.469Z" }, + { url = "https://files.pythonhosted.org/packages/7b/64/665248b557a236d3fa9efc378d60d95ef56dd0a490c2cd37dafc7660d4a9/psutil-7.2.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7b6d09433a10592ce39b13d7be5a54fbac1d1228ed29abc880fb23df7cb694c9", size = 131087, upload-time = "2026-01-28T18:15:11.724Z" }, + { url = "https://files.pythonhosted.org/packages/d5/2e/e6782744700d6759ebce3043dcfa661fb61e2fb752b91cdeae9af12c2178/psutil-7.2.2-cp314-cp314t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1fa4ecf83bcdf6e6c8f4449aff98eefb5d0604bf88cb883d7da3d8d2d909546a", size = 182383, upload-time = "2026-01-28T18:15:13.445Z" }, + { url = "https://files.pythonhosted.org/packages/57/49/0a41cefd10cb7505cdc04dab3eacf24c0c2cb158a998b8c7b1d27ee2c1f5/psutil-7.2.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e452c464a02e7dc7822a05d25db4cde564444a67e58539a00f929c51eddda0cf", size = 185210, upload-time = "2026-01-28T18:15:16.002Z" }, + { url = "https://files.pythonhosted.org/packages/dd/2c/ff9bfb544f283ba5f83ba725a3c5fec6d6b10b8f27ac1dc641c473dc390d/psutil-7.2.2-cp314-cp314t-win_amd64.whl", hash = "sha256:c7663d4e37f13e884d13994247449e9f8f574bc4655d509c3b95e9ec9e2b9dc1", size = 141228, upload-time = "2026-01-28T18:15:18.385Z" }, + { url = "https://files.pythonhosted.org/packages/f2/fc/f8d9c31db14fcec13748d373e668bc3bed94d9077dbc17fb0eebc073233c/psutil-7.2.2-cp314-cp314t-win_arm64.whl", hash = "sha256:11fe5a4f613759764e79c65cf11ebdf26e33d6dd34336f8a337aa2996d71c841", size = 136284, upload-time = "2026-01-28T18:15:19.912Z" }, + { url = "https://files.pythonhosted.org/packages/e7/36/5ee6e05c9bd427237b11b3937ad82bb8ad2752d72c6969314590dd0c2f6e/psutil-7.2.2-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:ed0cace939114f62738d808fdcecd4c869222507e266e574799e9c0faa17d486", size = 129090, upload-time = "2026-01-28T18:15:22.168Z" }, + { url = "https://files.pythonhosted.org/packages/80/c4/f5af4c1ca8c1eeb2e92ccca14ce8effdeec651d5ab6053c589b074eda6e1/psutil-7.2.2-cp36-abi3-macosx_11_0_arm64.whl", hash = "sha256:1a7b04c10f32cc88ab39cbf606e117fd74721c831c98a27dc04578deb0c16979", size = 129859, upload-time = "2026-01-28T18:15:23.795Z" }, + { url = "https://files.pythonhosted.org/packages/b5/70/5d8df3b09e25bce090399cf48e452d25c935ab72dad19406c77f4e828045/psutil-7.2.2-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:076a2d2f923fd4821644f5ba89f059523da90dc9014e85f8e45a5774ca5bc6f9", size = 155560, upload-time = "2026-01-28T18:15:25.976Z" }, + { url = "https://files.pythonhosted.org/packages/63/65/37648c0c158dc222aba51c089eb3bdfa238e621674dc42d48706e639204f/psutil-7.2.2-cp36-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b0726cecd84f9474419d67252add4ac0cd9811b04d61123054b9fb6f57df6e9e", size = 156997, upload-time = "2026-01-28T18:15:27.794Z" }, + { url = "https://files.pythonhosted.org/packages/8e/13/125093eadae863ce03c6ffdbae9929430d116a246ef69866dad94da3bfbc/psutil-7.2.2-cp36-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:fd04ef36b4a6d599bbdb225dd1d3f51e00105f6d48a28f006da7f9822f2606d8", size = 148972, upload-time = "2026-01-28T18:15:29.342Z" }, + { url = "https://files.pythonhosted.org/packages/04/78/0acd37ca84ce3ddffaa92ef0f571e073faa6d8ff1f0559ab1272188ea2be/psutil-7.2.2-cp36-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:b58fabe35e80b264a4e3bb23e6b96f9e45a3df7fb7eed419ac0e5947c61e47cc", size = 148266, upload-time = "2026-01-28T18:15:31.597Z" }, + { url = "https://files.pythonhosted.org/packages/b4/90/e2159492b5426be0c1fef7acba807a03511f97c5f86b3caeda6ad92351a7/psutil-7.2.2-cp37-abi3-win_amd64.whl", hash = "sha256:eb7e81434c8d223ec4a219b5fc1c47d0417b12be7ea866e24fb5ad6e84b3d988", size = 137737, upload-time = "2026-01-28T18:15:33.849Z" }, + { url = "https://files.pythonhosted.org/packages/8c/c7/7bb2e321574b10df20cbde462a94e2b71d05f9bbda251ef27d104668306a/psutil-7.2.2-cp37-abi3-win_arm64.whl", hash = "sha256:8c233660f575a5a89e6d4cb65d9f938126312bca76d8fe087b947b3a1aaac9ee", size = 134617, upload-time = "2026-01-28T18:15:36.514Z" }, ] [[package]] @@ -1403,11 +1562,11 @@ wheels = [ [[package]] name = "pycparser" -version = "2.22" +version = "3.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/1d/b2/31537cf4b1ca988837256c910a668b553fceb8f069bedc4b1c826024b52c/pycparser-2.22.tar.gz", hash = "sha256:491c8be9c040f5390f5bf44a5b07752bd07f56edf992381b05c701439eec10f6", size = 172736, upload-time = "2024-03-30T13:22:22.564Z" } +sdist = { url = "https://files.pythonhosted.org/packages/1b/7d/92392ff7815c21062bea51aa7b87d45576f649f16458d78b7cf94b9ab2e6/pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29", size = 103492, upload-time = "2026-01-21T14:26:51.89Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/13/a3/a812df4e2dd5696d1f351d58b8fe16a405b234ad2886a0dab9183fb78109/pycparser-2.22-py3-none-any.whl", hash = "sha256:c3702b6d3dd8c7abc1afa565d7e63d53a1d0bd86cdc24edd75470f4de499cfcc", size = 117552, upload-time = "2024-03-30T13:22:20.476Z" }, + { url = "https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992", size = 48172, upload-time = "2026-01-21T14:26:50.693Z" }, ] [[package]] @@ -1421,11 +1580,11 @@ wheels = [ [[package]] name = "pyparsing" -version = "3.2.3" +version = "3.3.2" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/bb/22/f1129e69d94ffff626bdb5c835506b3a5b4f3d070f17ea295e12c2c6f60f/pyparsing-3.2.3.tar.gz", hash = "sha256:b9c13f1ab8b3b542f72e28f634bad4de758ab3ce4546e4301970ad6fa77c38be", size = 1088608, upload-time = "2025-03-25T05:01:28.114Z" } +sdist = { url = "https://files.pythonhosted.org/packages/f3/91/9c6ee907786a473bf81c5f53cf703ba0957b23ab84c264080fb5a450416f/pyparsing-3.3.2.tar.gz", hash = "sha256:c777f4d763f140633dcb6d8a3eda953bf7a214dc4eff598413c070bcdc117cbc", size = 6851574, upload-time = "2026-01-21T03:57:59.36Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/05/e7/df2285f3d08fee213f2d041540fa4fc9ca6c2d44cf36d3a035bf2a8d2bcc/pyparsing-3.2.3-py3-none-any.whl", hash = "sha256:a749938e02d6fd0b59b356ca504a24982314bb090c383e3cf201c95ef7e2bfcf", size = 111120, upload-time = "2025-03-25T05:01:24.908Z" }, + { url = "https://files.pythonhosted.org/packages/10/bd/c038d7cc38edc1aa5bf91ab8068b63d4308c66c4c8bb3cbba7dfbc049f9c/pyparsing-3.3.2-py3-none-any.whl", hash = "sha256:850ba148bd908d7e2411587e247a1e4f0327839c40e2e5e6d05a007ecc69911d", size = 122781, upload-time = "2026-01-21T03:57:55.912Z" }, ] [[package]] @@ -1439,7 +1598,7 @@ wheels = [ [[package]] name = "pytest" -version = "8.4.1" +version = "9.0.2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "colorama", marker = "sys_platform == 'win32'" }, @@ -1448,9 +1607,9 @@ dependencies = [ { name = "pluggy" }, { name = "pygments" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/08/ba/45911d754e8eba3d5a841a5ce61a65a685ff1798421ac054f85aa8747dfb/pytest-8.4.1.tar.gz", hash = "sha256:7c67fd69174877359ed9371ec3af8a3d2b04741818c51e5e99cc1742251fa93c", size = 1517714, upload-time = "2025-06-18T05:48:06.109Z" } +sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/29/16/c8a903f4c4dffe7a12843191437d7cd8e32751d5de349d45d3fe69544e87/pytest-8.4.1-py3-none-any.whl", hash = "sha256:539c70ba6fcead8e78eebbf1115e8b589e7565830d7d006a8723f19ac8a0afb7", size = 365474, upload-time = "2025-06-18T05:48:03.955Z" }, + { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" }, ] [[package]] @@ -1479,121 +1638,124 @@ wheels = [ [[package]] name = "python-json-logger" -version = "3.3.0" +version = "4.0.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/9e/de/d3144a0bceede957f961e975f3752760fbe390d57fbe194baf709d8f1f7b/python_json_logger-3.3.0.tar.gz", hash = "sha256:12b7e74b17775e7d565129296105bbe3910842d9d0eb083fc83a6a617aa8df84", size = 16642, upload-time = "2025-03-07T07:08:27.301Z" } +sdist = { url = "https://files.pythonhosted.org/packages/29/bf/eca6a3d43db1dae7070f70e160ab20b807627ba953663ba07928cdd3dc58/python_json_logger-4.0.0.tar.gz", hash = "sha256:f58e68eb46e1faed27e0f574a55a0455eecd7b8a5b88b85a784519ba3cff047f", size = 17683, upload-time = "2025-10-06T04:15:18.984Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/08/20/0f2523b9e50a8052bc6a8b732dfc8568abbdc42010aef03a2d750bdab3b2/python_json_logger-3.3.0-py3-none-any.whl", hash = "sha256:dd980fae8cffb24c13caf6e158d3d61c0d6d22342f932cb6e9deedab3d35eec7", size = 15163, upload-time = "2025-03-07T07:08:25.627Z" }, -] - -[[package]] -name = "pytz" -version = "2025.2" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/f8/bf/abbd3cdfb8fbc7fb3d4d38d320f2441b1e7cbe29be4f23797b4a2b5d8aac/pytz-2025.2.tar.gz", hash = "sha256:360b9e3dbb49a209c21ad61809c7fb453643e048b38924c765813546746e81c3", size = 320884, upload-time = "2025-03-25T02:25:00.538Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/81/c4/34e93fe5f5429d7570ec1fa436f1986fb1f00c3e0f43a589fe2bbcd22c3f/pytz-2025.2-py2.py3-none-any.whl", hash = "sha256:5ddf76296dd8c44c26eb8f4b6f35488f3ccbf6fbbd7adee0b7262d43f0ec2f00", size = 509225, upload-time = "2025-03-25T02:24:58.468Z" }, -] - -[[package]] -name = "pywin32" -version = "311" -source = { registry = "https://pypi.org/simple" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/a5/be/3fd5de0979fcb3994bfee0d65ed8ca9506a8a1260651b86174f6a86f52b3/pywin32-311-cp313-cp313-win32.whl", hash = "sha256:f95ba5a847cba10dd8c4d8fefa9f2a6cf283b8b88ed6178fa8a6c1ab16054d0d", size = 8705700, upload-time = "2025-07-14T20:13:26.471Z" }, - { url = "https://files.pythonhosted.org/packages/e3/28/e0a1909523c6890208295a29e05c2adb2126364e289826c0a8bc7297bd5c/pywin32-311-cp313-cp313-win_amd64.whl", hash = "sha256:718a38f7e5b058e76aee1c56ddd06908116d35147e133427e59a3983f703a20d", size = 9494700, upload-time = "2025-07-14T20:13:28.243Z" }, - { url = "https://files.pythonhosted.org/packages/04/bf/90339ac0f55726dce7d794e6d79a18a91265bdf3aa70b6b9ca52f35e022a/pywin32-311-cp313-cp313-win_arm64.whl", hash = "sha256:7b4075d959648406202d92a2310cb990fea19b535c7f4a78d3f5e10b926eeb8a", size = 8709318, upload-time = "2025-07-14T20:13:30.348Z" }, - { url = "https://files.pythonhosted.org/packages/c9/31/097f2e132c4f16d99a22bfb777e0fd88bd8e1c634304e102f313af69ace5/pywin32-311-cp314-cp314-win32.whl", hash = "sha256:b7a2c10b93f8986666d0c803ee19b5990885872a7de910fc460f9b0c2fbf92ee", size = 8840714, upload-time = "2025-07-14T20:13:32.449Z" }, - { url = "https://files.pythonhosted.org/packages/90/4b/07c77d8ba0e01349358082713400435347df8426208171ce297da32c313d/pywin32-311-cp314-cp314-win_amd64.whl", hash = "sha256:3aca44c046bd2ed8c90de9cb8427f581c479e594e99b5c0bb19b29c10fd6cb87", size = 9656800, upload-time = "2025-07-14T20:13:34.312Z" }, - { url = "https://files.pythonhosted.org/packages/c0/d2/21af5c535501a7233e734b8af901574572da66fcc254cb35d0609c9080dd/pywin32-311-cp314-cp314-win_arm64.whl", hash = "sha256:a508e2d9025764a8270f93111a970e1d0fbfc33f4153b388bb649b7eec4f9b42", size = 8932540, upload-time = "2025-07-14T20:13:36.379Z" }, + { url = "https://files.pythonhosted.org/packages/51/e5/fecf13f06e5e5f67e8837d777d1bc43fac0ed2b77a676804df5c34744727/python_json_logger-4.0.0-py3-none-any.whl", hash = "sha256:af09c9daf6a813aa4cc7180395f50f2a9e5fa056034c9953aec92e381c5ba1e2", size = 15548, upload-time = "2025-10-06T04:15:17.553Z" }, ] [[package]] name = "pywinpty" -version = "2.0.15" +version = "3.0.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/2d/7c/917f9c4681bb8d34bfbe0b79d36bbcd902651aeab48790df3d30ba0202fb/pywinpty-2.0.15.tar.gz", hash = "sha256:312cf39153a8736c617d45ce8b6ad6cd2107de121df91c455b10ce6bba7a39b2", size = 29017, upload-time = "2025-02-03T21:53:23.265Z" } +sdist = { url = "https://files.pythonhosted.org/packages/f7/54/37c7370ba91f579235049dc26cd2c5e657d2a943e01820844ffc81f32176/pywinpty-3.0.3.tar.gz", hash = "sha256:523441dc34d231fb361b4b00f8c99d3f16de02f5005fd544a0183112bcc22412", size = 31309, upload-time = "2026-02-04T21:51:09.524Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fb/16/2ab7b3b7f55f3c6929e5f629e1a68362981e4e5fed592a2ed1cb4b4914a5/pywinpty-2.0.15-cp313-cp313-win_amd64.whl", hash = "sha256:ab5920877dd632c124b4ed17bc6dd6ef3b9f86cd492b963ffdb1a67b85b0f408", size = 1405020, upload-time = "2025-02-03T21:56:04.753Z" }, - { url = "https://files.pythonhosted.org/packages/7c/16/edef3515dd2030db2795dbfbe392232c7a0f3dc41b98e92b38b42ba497c7/pywinpty-2.0.15-cp313-cp313t-win_amd64.whl", hash = "sha256:a4560ad8c01e537708d2790dbe7da7d986791de805d89dd0d3697ca59e9e4901", size = 1404151, upload-time = "2025-02-03T21:55:53.628Z" }, + { url = "https://files.pythonhosted.org/packages/e5/cb/58d6ed3fd429c96a90ef01ac9a617af10a6d41469219c25e7dc162abbb71/pywinpty-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9c91dbb026050c77bdcef964e63a4f10f01a639113c4d3658332614544c467ab", size = 2112686, upload-time = "2026-02-04T21:52:03.035Z" }, + { url = "https://files.pythonhosted.org/packages/fd/50/724ed5c38c504d4e58a88a072776a1e880d970789deaeb2b9f7bd9a5141a/pywinpty-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:fe1f7911805127c94cf51f89ab14096c6f91ffdcacf993d2da6082b2142a2523", size = 234591, upload-time = "2026-02-04T21:52:29.821Z" }, + { url = "https://files.pythonhosted.org/packages/f7/ad/90a110538696b12b39fd8758a06d70ded899308198ad2305ac68e361126e/pywinpty-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:3f07a6cf1c1d470d284e614733c3d0f726d2c85e78508ea10a403140c3c0c18a", size = 2112360, upload-time = "2026-02-04T21:55:33.397Z" }, + { url = "https://files.pythonhosted.org/packages/44/0f/7ffa221757a220402bc79fda44044c3f2cc57338d878ab7d622add6f4581/pywinpty-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:15c7c0b6f8e9d87aabbaff76468dabf6e6121332c40fc1d83548d02a9d6a3759", size = 233107, upload-time = "2026-02-04T21:51:45.455Z" }, + { url = "https://files.pythonhosted.org/packages/28/88/2ff917caff61e55f38bcdb27de06ee30597881b2cae44fbba7627be015c4/pywinpty-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:d4b6b7b0fe0cdcd02e956bd57cfe9f4e5a06514eecf3b5ae174da4f951b58be9", size = 2113282, upload-time = "2026-02-04T21:52:08.188Z" }, + { url = "https://files.pythonhosted.org/packages/63/32/40a775343ace542cc43ece3f1d1fce454021521ecac41c4c4573081c2336/pywinpty-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:34789d685fc0d547ce0c8a65e5a70e56f77d732fa6e03c8f74fefb8cbb252019", size = 234207, upload-time = "2026-02-04T21:51:58.687Z" }, + { url = "https://files.pythonhosted.org/packages/8d/54/5d5e52f4cb75028104ca6faf36c10f9692389b1986d34471663b4ebebd6d/pywinpty-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:0c37e224a47a971d1a6e08649a1714dac4f63c11920780977829ed5c8cadead1", size = 2112910, upload-time = "2026-02-04T21:52:30.976Z" }, + { url = "https://files.pythonhosted.org/packages/0a/44/dcd184824e21d4620b06c7db9fbb15c3ad0a0f1fa2e6de79969fb82647ec/pywinpty-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:c4e9c3dff7d86ba81937438d5819f19f385a39d8f592d4e8af67148ceb4f6ab5", size = 233425, upload-time = "2026-02-04T21:51:56.754Z" }, ] [[package]] name = "pyyaml" -version = "6.0.2" +version = "6.0.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/54/ed/79a089b6be93607fa5cdaedf301d7dfb23af5f25c398d5ead2525b063e17/pyyaml-6.0.2.tar.gz", hash = "sha256:d584d9ec91ad65861cc08d42e834324ef890a082e591037abe114850ff7bbc3e", size = 130631, upload-time = "2024-08-06T20:33:50.674Z" } +sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/ef/e3/3af305b830494fa85d95f6d95ef7fa73f2ee1cc8ef5b495c7c3269fb835f/PyYAML-6.0.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:efdca5630322a10774e8e98e1af481aad470dd62c3170801852d752aa7a783ba", size = 181309, upload-time = "2024-08-06T20:32:43.4Z" }, - { url = "https://files.pythonhosted.org/packages/45/9f/3b1c20a0b7a3200524eb0076cc027a970d320bd3a6592873c85c92a08731/PyYAML-6.0.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:50187695423ffe49e2deacb8cd10510bc361faac997de9efef88badc3bb9e2d1", size = 171679, upload-time = "2024-08-06T20:32:44.801Z" }, - { url = "https://files.pythonhosted.org/packages/7c/9a/337322f27005c33bcb656c655fa78325b730324c78620e8328ae28b64d0c/PyYAML-6.0.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0ffe8360bab4910ef1b9e87fb812d8bc0a308b0d0eef8c8f44e0254ab3b07133", size = 733428, upload-time = "2024-08-06T20:32:46.432Z" }, - { url = "https://files.pythonhosted.org/packages/a3/69/864fbe19e6c18ea3cc196cbe5d392175b4cf3d5d0ac1403ec3f2d237ebb5/PyYAML-6.0.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:17e311b6c678207928d649faa7cb0d7b4c26a0ba73d41e99c4fff6b6c3276484", size = 763361, upload-time = "2024-08-06T20:32:51.188Z" }, - { url = "https://files.pythonhosted.org/packages/04/24/b7721e4845c2f162d26f50521b825fb061bc0a5afcf9a386840f23ea19fa/PyYAML-6.0.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:70b189594dbe54f75ab3a1acec5f1e3faa7e8cf2f1e08d9b561cb41b845f69d5", size = 759523, upload-time = "2024-08-06T20:32:53.019Z" }, - { url = "https://files.pythonhosted.org/packages/2b/b2/e3234f59ba06559c6ff63c4e10baea10e5e7df868092bf9ab40e5b9c56b6/PyYAML-6.0.2-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:41e4e3953a79407c794916fa277a82531dd93aad34e29c2a514c2c0c5fe971cc", size = 726660, upload-time = "2024-08-06T20:32:54.708Z" }, - { url = "https://files.pythonhosted.org/packages/fe/0f/25911a9f080464c59fab9027482f822b86bf0608957a5fcc6eaac85aa515/PyYAML-6.0.2-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:68ccc6023a3400877818152ad9a1033e3db8625d899c72eacb5a668902e4d652", size = 751597, upload-time = "2024-08-06T20:32:56.985Z" }, - { url = "https://files.pythonhosted.org/packages/14/0d/e2c3b43bbce3cf6bd97c840b46088a3031085179e596d4929729d8d68270/PyYAML-6.0.2-cp313-cp313-win32.whl", hash = "sha256:bc2fa7c6b47d6bc618dd7fb02ef6fdedb1090ec036abab80d4681424b84c1183", size = 140527, upload-time = "2024-08-06T20:33:03.001Z" }, - { url = "https://files.pythonhosted.org/packages/fa/de/02b54f42487e3d3c6efb3f89428677074ca7bf43aae402517bc7cca949f3/PyYAML-6.0.2-cp313-cp313-win_amd64.whl", hash = "sha256:8388ee1976c416731879ac16da0aff3f63b286ffdd57cdeb95f3f2e085687563", size = 156446, upload-time = "2024-08-06T20:33:04.33Z" }, + { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" }, + { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" }, + { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" }, + { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" }, + { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" }, + { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" }, + { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" }, + { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" }, + { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" }, + { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" }, + { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" }, + { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" }, + { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" }, + { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" }, + { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" }, + { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" }, + { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" }, + { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" }, + { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" }, + { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" }, + { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" }, + { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" }, + { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" }, + { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" }, + { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" }, + { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" }, + { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" }, + { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" }, ] [[package]] name = "pyzmq" -version = "27.0.1" +version = "27.1.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "cffi", marker = "implementation_name == 'pypy'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/30/5f/557d2032a2f471edbcc227da724c24a1c05887b5cda1e3ae53af98b9e0a5/pyzmq-27.0.1.tar.gz", hash = "sha256:45c549204bc20e7484ffd2555f6cf02e572440ecf2f3bdd60d4404b20fddf64b", size = 281158, upload-time = "2025-08-03T05:05:40.352Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/0b/3c9baedbdf613ecaa7aa07027780b8867f57b6293b6ee50de316c9f3222b/pyzmq-27.1.0.tar.gz", hash = "sha256:ac0765e3d44455adb6ddbf4417dcce460fc40a05978c08efdf2948072f6db540", size = 281750, upload-time = "2025-09-08T23:10:18.157Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/0e/9b/c0957041067c7724b310f22c398be46399297c12ed834c3bc42200a2756f/pyzmq-27.0.1-cp312-abi3-macosx_10_15_universal2.whl", hash = "sha256:af7ebce2a1e7caf30c0bb64a845f63a69e76a2fadbc1cac47178f7bb6e657bdd", size = 1305432, upload-time = "2025-08-03T05:03:32.177Z" }, - { url = "https://files.pythonhosted.org/packages/8e/55/bd3a312790858f16b7def3897a0c3eb1804e974711bf7b9dcb5f47e7f82c/pyzmq-27.0.1-cp312-abi3-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:8f617f60a8b609a13099b313e7e525e67f84ef4524b6acad396d9ff153f6e4cd", size = 895095, upload-time = "2025-08-03T05:03:33.918Z" }, - { url = "https://files.pythonhosted.org/packages/20/50/fc384631d8282809fb1029a4460d2fe90fa0370a0e866a8318ed75c8d3bb/pyzmq-27.0.1-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d59dad4173dc2a111f03e59315c7bd6e73da1a9d20a84a25cf08325b0582b1a", size = 651826, upload-time = "2025-08-03T05:03:35.818Z" }, - { url = "https://files.pythonhosted.org/packages/7e/0a/2356305c423a975000867de56888b79e44ec2192c690ff93c3109fd78081/pyzmq-27.0.1-cp312-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f5b6133c8d313bde8bd0d123c169d22525300ff164c2189f849de495e1344577", size = 839751, upload-time = "2025-08-03T05:03:37.265Z" }, - { url = "https://files.pythonhosted.org/packages/d7/1b/81e95ad256ca7e7ccd47f5294c1c6da6e2b64fbace65b84fe8a41470342e/pyzmq-27.0.1-cp312-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:58cca552567423f04d06a075f4b473e78ab5bdb906febe56bf4797633f54aa4e", size = 1641359, upload-time = "2025-08-03T05:03:38.799Z" }, - { url = "https://files.pythonhosted.org/packages/50/63/9f50ec965285f4e92c265c8f18344e46b12803666d8b73b65d254d441435/pyzmq-27.0.1-cp312-abi3-musllinux_1_2_i686.whl", hash = "sha256:4b9d8e26fb600d0d69cc9933e20af08552e97cc868a183d38a5c0d661e40dfbb", size = 2020281, upload-time = "2025-08-03T05:03:40.338Z" }, - { url = "https://files.pythonhosted.org/packages/02/4a/19e3398d0dc66ad2b463e4afa1fc541d697d7bc090305f9dfb948d3dfa29/pyzmq-27.0.1-cp312-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:2329f0c87f0466dce45bba32b63f47018dda5ca40a0085cc5c8558fea7d9fc55", size = 1877112, upload-time = "2025-08-03T05:03:42.012Z" }, - { url = "https://files.pythonhosted.org/packages/bf/42/c562e9151aa90ed1d70aac381ea22a929d6b3a2ce4e1d6e2e135d34fd9c6/pyzmq-27.0.1-cp312-abi3-win32.whl", hash = "sha256:57bb92abdb48467b89c2d21da1ab01a07d0745e536d62afd2e30d5acbd0092eb", size = 558177, upload-time = "2025-08-03T05:03:43.979Z" }, - { url = "https://files.pythonhosted.org/packages/40/96/5c50a7d2d2b05b19994bf7336b97db254299353dd9b49b565bb71b485f03/pyzmq-27.0.1-cp312-abi3-win_amd64.whl", hash = "sha256:ff3f8757570e45da7a5bedaa140489846510014f7a9d5ee9301c61f3f1b8a686", size = 618923, upload-time = "2025-08-03T05:03:45.438Z" }, - { url = "https://files.pythonhosted.org/packages/13/33/1ec89c8f21c89d21a2eaff7def3676e21d8248d2675705e72554fb5a6f3f/pyzmq-27.0.1-cp312-abi3-win_arm64.whl", hash = "sha256:df2c55c958d3766bdb3e9d858b911288acec09a9aab15883f384fc7180df5bed", size = 552358, upload-time = "2025-08-03T05:03:46.887Z" }, - { url = "https://files.pythonhosted.org/packages/6c/a0/f26e276211ec8090a4d11e4ec70eb8a8b15781e591c1d44ce62f372963a0/pyzmq-27.0.1-cp313-cp313-android_24_arm64_v8a.whl", hash = "sha256:497bd8af534ae55dc4ef67eebd1c149ff2a0b0f1e146db73c8b5a53d83c1a5f5", size = 1122287, upload-time = "2025-08-03T05:03:48.838Z" }, - { url = "https://files.pythonhosted.org/packages/9c/d8/af4b507e4f7eeea478cc8ee873995a6fd55582bfb99140593ed460e1db3c/pyzmq-27.0.1-cp313-cp313-android_24_x86_64.whl", hash = "sha256:a066ea6ad6218b4c233906adf0ae67830f451ed238419c0db609310dd781fbe7", size = 1155756, upload-time = "2025-08-03T05:03:50.907Z" }, - { url = "https://files.pythonhosted.org/packages/ac/55/37fae0013e11f88681da42698e550b08a316d608242551f65095cc99232a/pyzmq-27.0.1-cp313-cp313t-macosx_10_15_universal2.whl", hash = "sha256:72d235d6365ca73d8ce92f7425065d70f5c1e19baa458eb3f0d570e425b73a96", size = 1340826, upload-time = "2025-08-03T05:03:52.568Z" }, - { url = "https://files.pythonhosted.org/packages/f2/e4/3a87854c64b26fcf63a9d1b6f4382bd727d4797c772ceb334a97b7489be9/pyzmq-27.0.1-cp313-cp313t-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:313a7b374e3dc64848644ca348a51004b41726f768b02e17e689f1322366a4d9", size = 897283, upload-time = "2025-08-03T05:03:54.167Z" }, - { url = "https://files.pythonhosted.org/packages/17/3e/4296c6b0ad2d07be11ae1395dccf9cae48a0a655cf9be1c3733ad2b591d1/pyzmq-27.0.1-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:119ce8590409702394f959c159d048002cbed2f3c0645ec9d6a88087fc70f0f1", size = 660565, upload-time = "2025-08-03T05:03:56.152Z" }, - { url = "https://files.pythonhosted.org/packages/72/41/a33ba3aa48b45b23c4cd4ac49aafde46f3e0f81939f2bfb3b6171a437122/pyzmq-27.0.1-cp313-cp313t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:45c3e00ce16896ace2cd770ab9057a7cf97d4613ea5f2a13f815141d8b6894b9", size = 847680, upload-time = "2025-08-03T05:03:57.696Z" }, - { url = "https://files.pythonhosted.org/packages/3f/8c/bf2350bb25b3b58d2e5b5d2290ffab0e923f0cc6d02288d3fbf4baa6e4d1/pyzmq-27.0.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:678e50ec112bdc6df5a83ac259a55a4ba97a8b314c325ab26b3b5b071151bc61", size = 1650151, upload-time = "2025-08-03T05:03:59.387Z" }, - { url = "https://files.pythonhosted.org/packages/f7/1a/a5a07c54890891344a8ddc3d5ab320dd3c4e39febb6e4472546e456d5157/pyzmq-27.0.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:d0b96c30be9f9387b18b18b6133c75a7b1b0065da64e150fe1feb5ebf31ece1c", size = 2023766, upload-time = "2025-08-03T05:04:01.883Z" }, - { url = "https://files.pythonhosted.org/packages/62/5e/514dcff08f02c6c8a45a6e23621901139cf853be7ac5ccd0b9407c3aa3de/pyzmq-27.0.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:88dc92d9eb5ea4968123e74db146d770b0c8d48f0e2bfb1dbc6c50a8edb12d64", size = 1885195, upload-time = "2025-08-03T05:04:03.923Z" }, - { url = "https://files.pythonhosted.org/packages/c8/91/87f74f98a487fbef0b115f6025e4a295129fd56b2b633a03ba7d5816ecc2/pyzmq-27.0.1-cp313-cp313t-win32.whl", hash = "sha256:6dcbcb34f5c9b0cefdfc71ff745459241b7d3cda5b27c7ad69d45afc0821d1e1", size = 574213, upload-time = "2025-08-03T05:04:05.905Z" }, - { url = "https://files.pythonhosted.org/packages/e6/d7/07f7d0d7f4c81e08be7b60e52ff2591c557377c017f96204d33d5fca1b07/pyzmq-27.0.1-cp313-cp313t-win_amd64.whl", hash = "sha256:b9fd0fda730461f510cfd9a40fafa5355d65f5e3dbdd8d6dfa342b5b3f5d1949", size = 640202, upload-time = "2025-08-03T05:04:07.439Z" }, - { url = "https://files.pythonhosted.org/packages/ab/83/21d66bcef6fb803647a223cbde95111b099e2176277c0cbc8b099c485510/pyzmq-27.0.1-cp313-cp313t-win_arm64.whl", hash = "sha256:56a3b1853f3954ec1f0e91085f1350cc57d18f11205e4ab6e83e4b7c414120e0", size = 561514, upload-time = "2025-08-03T05:04:09.071Z" }, - { url = "https://files.pythonhosted.org/packages/5a/0b/d5ea75cf46b52cdce85a85200c963cb498932953df443892238be49b1a01/pyzmq-27.0.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:f98f6b7787bd2beb1f0dde03f23a0621a0c978edf673b7d8f5e7bc039cbe1b60", size = 1340836, upload-time = "2025-08-03T05:04:10.774Z" }, - { url = "https://files.pythonhosted.org/packages/be/4c/0dbce882550e17db6846b29e9dc242aea7590e7594e1ca5043e8e58fff2d/pyzmq-27.0.1-cp314-cp314t-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:351bf5d8ca0788ca85327fda45843b6927593ff4c807faee368cc5aaf9f809c2", size = 897236, upload-time = "2025-08-03T05:04:13.221Z" }, - { url = "https://files.pythonhosted.org/packages/1b/22/461e131cf16b8814f3c356fa1ea0912697dbc4c64cddf01f7756ec704c1e/pyzmq-27.0.1-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5268a5a9177afff53dc6d70dffe63114ba2a6e7b20d9411cc3adeba09eeda403", size = 660374, upload-time = "2025-08-03T05:04:15.032Z" }, - { url = "https://files.pythonhosted.org/packages/3f/0c/bbd65a814395bf4fc3e57c6c13af27601c07e4009bdfb75ebcf500537bbd/pyzmq-27.0.1-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a4aca06ba295aa78bec9b33ec028d1ca08744c36294338c41432b7171060c808", size = 847497, upload-time = "2025-08-03T05:04:16.967Z" }, - { url = "https://files.pythonhosted.org/packages/1e/df/3d1f4a03b561d824cbd491394f67591957e2f1acf6dc85d96f970312a76a/pyzmq-27.0.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:1c363c6dc66352331d5ad64bb838765c6692766334a6a02fdb05e76bd408ae18", size = 1650028, upload-time = "2025-08-03T05:04:19.398Z" }, - { url = "https://files.pythonhosted.org/packages/41/c9/a3987540f59a412bdaae3f362f78e00e6769557a598c63b7e32956aade5a/pyzmq-27.0.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:87aebf4acd7249bdff8d3df03aed4f09e67078e6762cfe0aecf8d0748ff94cde", size = 2023808, upload-time = "2025-08-03T05:04:21.145Z" }, - { url = "https://files.pythonhosted.org/packages/b0/a5/c388f4cd80498a8eaef7535f2a8eaca0a35b82b87a0b47fa1856fc135004/pyzmq-27.0.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:e4f22d67756518d71901edf73b38dc0eb4765cce22c8fe122cc81748d425262b", size = 1884970, upload-time = "2025-08-03T05:04:22.908Z" }, - { url = "https://files.pythonhosted.org/packages/9a/ac/b2a89a1ed90526a1b9a260cdc5cd42f055fd44ee8d2a59902b5ac35ddeb1/pyzmq-27.0.1-cp314-cp314t-win32.whl", hash = "sha256:8c62297bc7aea2147b472ca5ca2b4389377ad82898c87cabab2a94aedd75e337", size = 586905, upload-time = "2025-08-03T05:04:24.492Z" }, - { url = "https://files.pythonhosted.org/packages/68/62/7aa5ea04e836f7a788b2a67405f83011cef59ca76d7bac91d1fc9a0476da/pyzmq-27.0.1-cp314-cp314t-win_amd64.whl", hash = "sha256:bee5248d5ec9223545f8cc4f368c2d571477ae828c99409125c3911511d98245", size = 660503, upload-time = "2025-08-03T05:04:26.382Z" }, - { url = "https://files.pythonhosted.org/packages/89/32/3836ed85947b06f1d67c07ce16c00b0cf8c053ab0b249d234f9f81ff95ff/pyzmq-27.0.1-cp314-cp314t-win_arm64.whl", hash = "sha256:0fc24bf45e4a454e55ef99d7f5c8b8712539200ce98533af25a5bfa954b6b390", size = 575098, upload-time = "2025-08-03T05:04:27.974Z" }, + { url = "https://files.pythonhosted.org/packages/92/e7/038aab64a946d535901103da16b953c8c9cc9c961dadcbf3609ed6428d23/pyzmq-27.1.0-cp312-abi3-macosx_10_15_universal2.whl", hash = "sha256:452631b640340c928fa343801b0d07eb0c3789a5ffa843f6e1a9cee0ba4eb4fc", size = 1306279, upload-time = "2025-09-08T23:08:03.807Z" }, + { url = "https://files.pythonhosted.org/packages/e8/5e/c3c49fdd0f535ef45eefcc16934648e9e59dace4a37ee88fc53f6cd8e641/pyzmq-27.1.0-cp312-abi3-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:1c179799b118e554b66da67d88ed66cd37a169f1f23b5d9f0a231b4e8d44a113", size = 895645, upload-time = "2025-09-08T23:08:05.301Z" }, + { url = "https://files.pythonhosted.org/packages/f8/e5/b0b2504cb4e903a74dcf1ebae157f9e20ebb6ea76095f6cfffea28c42ecd/pyzmq-27.1.0-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3837439b7f99e60312f0c926a6ad437b067356dc2bc2ec96eb395fd0fe804233", size = 652574, upload-time = "2025-09-08T23:08:06.828Z" }, + { url = "https://files.pythonhosted.org/packages/f8/9b/c108cdb55560eaf253f0cbdb61b29971e9fb34d9c3499b0e96e4e60ed8a5/pyzmq-27.1.0-cp312-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43ad9a73e3da1fab5b0e7e13402f0b2fb934ae1c876c51d0afff0e7c052eca31", size = 840995, upload-time = "2025-09-08T23:08:08.396Z" }, + { url = "https://files.pythonhosted.org/packages/c2/bb/b79798ca177b9eb0825b4c9998c6af8cd2a7f15a6a1a4272c1d1a21d382f/pyzmq-27.1.0-cp312-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:0de3028d69d4cdc475bfe47a6128eb38d8bc0e8f4d69646adfbcd840facbac28", size = 1642070, upload-time = "2025-09-08T23:08:09.989Z" }, + { url = "https://files.pythonhosted.org/packages/9c/80/2df2e7977c4ede24c79ae39dcef3899bfc5f34d1ca7a5b24f182c9b7a9ca/pyzmq-27.1.0-cp312-abi3-musllinux_1_2_i686.whl", hash = "sha256:cf44a7763aea9298c0aa7dbf859f87ed7012de8bda0f3977b6fb1d96745df856", size = 2021121, upload-time = "2025-09-08T23:08:11.907Z" }, + { url = "https://files.pythonhosted.org/packages/46/bd/2d45ad24f5f5ae7e8d01525eb76786fa7557136555cac7d929880519e33a/pyzmq-27.1.0-cp312-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:f30f395a9e6fbca195400ce833c731e7b64c3919aa481af4d88c3759e0cb7496", size = 1878550, upload-time = "2025-09-08T23:08:13.513Z" }, + { url = "https://files.pythonhosted.org/packages/e6/2f/104c0a3c778d7c2ab8190e9db4f62f0b6957b53c9d87db77c284b69f33ea/pyzmq-27.1.0-cp312-abi3-win32.whl", hash = "sha256:250e5436a4ba13885494412b3da5d518cd0d3a278a1ae640e113c073a5f88edd", size = 559184, upload-time = "2025-09-08T23:08:15.163Z" }, + { url = "https://files.pythonhosted.org/packages/fc/7f/a21b20d577e4100c6a41795842028235998a643b1ad406a6d4163ea8f53e/pyzmq-27.1.0-cp312-abi3-win_amd64.whl", hash = "sha256:9ce490cf1d2ca2ad84733aa1d69ce6855372cb5ce9223802450c9b2a7cba0ccf", size = 619480, upload-time = "2025-09-08T23:08:17.192Z" }, + { url = "https://files.pythonhosted.org/packages/78/c2/c012beae5f76b72f007a9e91ee9401cb88c51d0f83c6257a03e785c81cc2/pyzmq-27.1.0-cp312-abi3-win_arm64.whl", hash = "sha256:75a2f36223f0d535a0c919e23615fc85a1e23b71f40c7eb43d7b1dedb4d8f15f", size = 552993, upload-time = "2025-09-08T23:08:18.926Z" }, + { url = "https://files.pythonhosted.org/packages/60/cb/84a13459c51da6cec1b7b1dc1a47e6db6da50b77ad7fd9c145842750a011/pyzmq-27.1.0-cp313-cp313-android_24_arm64_v8a.whl", hash = "sha256:93ad4b0855a664229559e45c8d23797ceac03183c7b6f5b4428152a6b06684a5", size = 1122436, upload-time = "2025-09-08T23:08:20.801Z" }, + { url = "https://files.pythonhosted.org/packages/dc/b6/94414759a69a26c3dd674570a81813c46a078767d931a6c70ad29fc585cb/pyzmq-27.1.0-cp313-cp313-android_24_x86_64.whl", hash = "sha256:fbb4f2400bfda24f12f009cba62ad5734148569ff4949b1b6ec3b519444342e6", size = 1156301, upload-time = "2025-09-08T23:08:22.47Z" }, + { url = "https://files.pythonhosted.org/packages/a5/ad/15906493fd40c316377fd8a8f6b1f93104f97a752667763c9b9c1b71d42d/pyzmq-27.1.0-cp313-cp313t-macosx_10_15_universal2.whl", hash = "sha256:e343d067f7b151cfe4eb3bb796a7752c9d369eed007b91231e817071d2c2fec7", size = 1341197, upload-time = "2025-09-08T23:08:24.286Z" }, + { url = "https://files.pythonhosted.org/packages/14/1d/d343f3ce13db53a54cb8946594e567410b2125394dafcc0268d8dda027e0/pyzmq-27.1.0-cp313-cp313t-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:08363b2011dec81c354d694bdecaef4770e0ae96b9afea70b3f47b973655cc05", size = 897275, upload-time = "2025-09-08T23:08:26.063Z" }, + { url = "https://files.pythonhosted.org/packages/69/2d/d83dd6d7ca929a2fc67d2c3005415cdf322af7751d773524809f9e585129/pyzmq-27.1.0-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d54530c8c8b5b8ddb3318f481297441af102517602b569146185fa10b63f4fa9", size = 660469, upload-time = "2025-09-08T23:08:27.623Z" }, + { url = "https://files.pythonhosted.org/packages/3e/cd/9822a7af117f4bc0f1952dbe9ef8358eb50a24928efd5edf54210b850259/pyzmq-27.1.0-cp313-cp313t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6f3afa12c392f0a44a2414056d730eebc33ec0926aae92b5ad5cf26ebb6cc128", size = 847961, upload-time = "2025-09-08T23:08:29.672Z" }, + { url = "https://files.pythonhosted.org/packages/9a/12/f003e824a19ed73be15542f172fd0ec4ad0b60cf37436652c93b9df7c585/pyzmq-27.1.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c65047adafe573ff023b3187bb93faa583151627bc9c51fc4fb2c561ed689d39", size = 1650282, upload-time = "2025-09-08T23:08:31.349Z" }, + { url = "https://files.pythonhosted.org/packages/d5/4a/e82d788ed58e9a23995cee70dbc20c9aded3d13a92d30d57ec2291f1e8a3/pyzmq-27.1.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:90e6e9441c946a8b0a667356f7078d96411391a3b8f80980315455574177ec97", size = 2024468, upload-time = "2025-09-08T23:08:33.543Z" }, + { url = "https://files.pythonhosted.org/packages/d9/94/2da0a60841f757481e402b34bf4c8bf57fa54a5466b965de791b1e6f747d/pyzmq-27.1.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:add071b2d25f84e8189aaf0882d39a285b42fa3853016ebab234a5e78c7a43db", size = 1885394, upload-time = "2025-09-08T23:08:35.51Z" }, + { url = "https://files.pythonhosted.org/packages/4f/6f/55c10e2e49ad52d080dc24e37adb215e5b0d64990b57598abc2e3f01725b/pyzmq-27.1.0-cp313-cp313t-win32.whl", hash = "sha256:7ccc0700cfdf7bd487bea8d850ec38f204478681ea02a582a8da8171b7f90a1c", size = 574964, upload-time = "2025-09-08T23:08:37.178Z" }, + { url = "https://files.pythonhosted.org/packages/87/4d/2534970ba63dd7c522d8ca80fb92777f362c0f321900667c615e2067cb29/pyzmq-27.1.0-cp313-cp313t-win_amd64.whl", hash = "sha256:8085a9fba668216b9b4323be338ee5437a235fe275b9d1610e422ccc279733e2", size = 641029, upload-time = "2025-09-08T23:08:40.595Z" }, + { url = "https://files.pythonhosted.org/packages/f6/fa/f8aea7a28b0641f31d40dea42d7ef003fded31e184ef47db696bc74cd610/pyzmq-27.1.0-cp313-cp313t-win_arm64.whl", hash = "sha256:6bb54ca21bcfe361e445256c15eedf083f153811c37be87e0514934d6913061e", size = 561541, upload-time = "2025-09-08T23:08:42.668Z" }, + { url = "https://files.pythonhosted.org/packages/87/45/19efbb3000956e82d0331bafca5d9ac19ea2857722fa2caacefb6042f39d/pyzmq-27.1.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ce980af330231615756acd5154f29813d553ea555485ae712c491cd483df6b7a", size = 1341197, upload-time = "2025-09-08T23:08:44.973Z" }, + { url = "https://files.pythonhosted.org/packages/48/43/d72ccdbf0d73d1343936296665826350cb1e825f92f2db9db3e61c2162a2/pyzmq-27.1.0-cp314-cp314t-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:1779be8c549e54a1c38f805e56d2a2e5c009d26de10921d7d51cfd1c8d4632ea", size = 897175, upload-time = "2025-09-08T23:08:46.601Z" }, + { url = "https://files.pythonhosted.org/packages/2f/2e/a483f73a10b65a9ef0161e817321d39a770b2acf8bcf3004a28d90d14a94/pyzmq-27.1.0-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7200bb0f03345515df50d99d3db206a0a6bee1955fbb8c453c76f5bf0e08fb96", size = 660427, upload-time = "2025-09-08T23:08:48.187Z" }, + { url = "https://files.pythonhosted.org/packages/f5/d2/5f36552c2d3e5685abe60dfa56f91169f7a2d99bbaf67c5271022ab40863/pyzmq-27.1.0-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01c0e07d558b06a60773744ea6251f769cd79a41a97d11b8bf4ab8f034b0424d", size = 847929, upload-time = "2025-09-08T23:08:49.76Z" }, + { url = "https://files.pythonhosted.org/packages/c4/2a/404b331f2b7bf3198e9945f75c4c521f0c6a3a23b51f7a4a401b94a13833/pyzmq-27.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:80d834abee71f65253c91540445d37c4c561e293ba6e741b992f20a105d69146", size = 1650193, upload-time = "2025-09-08T23:08:51.7Z" }, + { url = "https://files.pythonhosted.org/packages/1c/0b/f4107e33f62a5acf60e3ded67ed33d79b4ce18de432625ce2fc5093d6388/pyzmq-27.1.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:544b4e3b7198dde4a62b8ff6685e9802a9a1ebf47e77478a5eb88eca2a82f2fd", size = 2024388, upload-time = "2025-09-08T23:08:53.393Z" }, + { url = "https://files.pythonhosted.org/packages/0d/01/add31fe76512642fd6e40e3a3bd21f4b47e242c8ba33efb6809e37076d9b/pyzmq-27.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:cedc4c68178e59a4046f97eca31b148ddcf51e88677de1ef4e78cf06c5376c9a", size = 1885316, upload-time = "2025-09-08T23:08:55.702Z" }, + { url = "https://files.pythonhosted.org/packages/c4/59/a5f38970f9bf07cee96128de79590bb354917914a9be11272cfc7ff26af0/pyzmq-27.1.0-cp314-cp314t-win32.whl", hash = "sha256:1f0b2a577fd770aa6f053211a55d1c47901f4d537389a034c690291485e5fe92", size = 587472, upload-time = "2025-09-08T23:08:58.18Z" }, + { url = "https://files.pythonhosted.org/packages/70/d8/78b1bad170f93fcf5e3536e70e8fadac55030002275c9a29e8f5719185de/pyzmq-27.1.0-cp314-cp314t-win_amd64.whl", hash = "sha256:19c9468ae0437f8074af379e986c5d3d7d7bfe033506af442e8c879732bedbe0", size = 661401, upload-time = "2025-09-08T23:08:59.802Z" }, + { url = "https://files.pythonhosted.org/packages/81/d6/4bfbb40c9a0b42fc53c7cf442f6385db70b40f74a783130c5d0a5aa62228/pyzmq-27.1.0-cp314-cp314t-win_arm64.whl", hash = "sha256:dc5dbf68a7857b59473f7df42650c621d7e8923fb03fa74a526890f4d33cc4d7", size = 575170, upload-time = "2025-09-08T23:09:01.418Z" }, ] [[package]] name = "referencing" -version = "0.36.2" +version = "0.37.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, { name = "rpds-py" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/2f/db/98b5c277be99dd18bfd91dd04e1b759cad18d1a338188c936e92f921c7e2/referencing-0.36.2.tar.gz", hash = "sha256:df2e89862cd09deabbdba16944cc3f10feb6b3e6f18e902f7cc25609a34775aa", size = 74744, upload-time = "2025-01-25T08:48:16.138Z" } +sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/c1/b1/3baf80dc6d2b7bc27a95a67752d0208e410351e3feb4eb78de5f77454d8d/referencing-0.36.2-py3-none-any.whl", hash = "sha256:e8699adbbf8b5c7de96d8ffa0eb5c158b3beafce084968e2ea8bb08c6794dcd0", size = 26775, upload-time = "2025-01-25T08:48:14.241Z" }, + { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" }, ] [[package]] name = "requests" -version = "2.32.4" +version = "2.32.5" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "certifi" }, @@ -1601,9 +1763,9 @@ dependencies = [ { name = "idna" }, { name = "urllib3" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/e1/0a/929373653770d8a0d7ea76c37de6e41f11eb07559b103b1c02cafb3f7cf8/requests-2.32.4.tar.gz", hash = "sha256:27d0316682c8a29834d3264820024b62a36942083d52caf2f14c0591336d3422", size = 135258, upload-time = "2025-06-09T16:43:07.34Z" } +sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/7c/e4/56027c4a6b4ae70ca9de302488c5ca95ad4a39e190093d6c1a8ace08341b/requests-2.32.4-py3-none-any.whl", hash = "sha256:27babd3cda2a6d50b30443204ee89830707d396671944c998b5975b031ac2b2c", size = 64847, upload-time = "2025-06-09T16:43:05.728Z" }, + { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" }, ] [[package]] @@ -1641,86 +1803,86 @@ wheels = [ [[package]] name = "rpds-py" -version = "0.27.0" +version = "0.30.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/1e/d9/991a0dee12d9fc53ed027e26a26a64b151d77252ac477e22666b9688bc16/rpds_py-0.27.0.tar.gz", hash = "sha256:8b23cf252f180cda89220b378d917180f29d313cd6a07b2431c0d3b776aae86f", size = 27420, upload-time = "2025-08-07T08:26:39.624Z" } +sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/81/d2/dfdfd42565a923b9e5a29f93501664f5b984a802967d48d49200ad71be36/rpds_py-0.27.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:443d239d02d9ae55b74015234f2cd8eb09e59fbba30bf60baeb3123ad4c6d5ff", size = 362133, upload-time = "2025-08-07T08:24:04.508Z" }, - { url = "https://files.pythonhosted.org/packages/ac/4a/0a2e2460c4b66021d349ce9f6331df1d6c75d7eea90df9785d333a49df04/rpds_py-0.27.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:b8a7acf04fda1f30f1007f3cc96d29d8cf0a53e626e4e1655fdf4eabc082d367", size = 347128, upload-time = "2025-08-07T08:24:05.695Z" }, - { url = "https://files.pythonhosted.org/packages/35/8d/7d1e4390dfe09d4213b3175a3f5a817514355cb3524593380733204f20b9/rpds_py-0.27.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9d0f92b78cfc3b74a42239fdd8c1266f4715b573204c234d2f9fc3fc7a24f185", size = 384027, upload-time = "2025-08-07T08:24:06.841Z" }, - { url = "https://files.pythonhosted.org/packages/c1/65/78499d1a62172891c8cd45de737b2a4b84a414b6ad8315ab3ac4945a5b61/rpds_py-0.27.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ce4ed8e0c7dbc5b19352b9c2c6131dd23b95fa8698b5cdd076307a33626b72dc", size = 399973, upload-time = "2025-08-07T08:24:08.143Z" }, - { url = "https://files.pythonhosted.org/packages/10/a1/1c67c1d8cc889107b19570bb01f75cf49852068e95e6aee80d22915406fc/rpds_py-0.27.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fde355b02934cc6b07200cc3b27ab0c15870a757d1a72fd401aa92e2ea3c6bfe", size = 515295, upload-time = "2025-08-07T08:24:09.711Z" }, - { url = "https://files.pythonhosted.org/packages/df/27/700ec88e748436b6c7c4a2262d66e80f8c21ab585d5e98c45e02f13f21c0/rpds_py-0.27.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:13bbc4846ae4c993f07c93feb21a24d8ec637573d567a924b1001e81c8ae80f9", size = 406737, upload-time = "2025-08-07T08:24:11.182Z" }, - { url = "https://files.pythonhosted.org/packages/33/cc/6b0ee8f0ba3f2df2daac1beda17fde5cf10897a7d466f252bd184ef20162/rpds_py-0.27.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:be0744661afbc4099fef7f4e604e7f1ea1be1dd7284f357924af12a705cc7d5c", size = 385898, upload-time = "2025-08-07T08:24:12.798Z" }, - { url = "https://files.pythonhosted.org/packages/e8/7e/c927b37d7d33c0a0ebf249cc268dc2fcec52864c1b6309ecb960497f2285/rpds_py-0.27.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:069e0384a54f427bd65d7fda83b68a90606a3835901aaff42185fcd94f5a9295", size = 405785, upload-time = "2025-08-07T08:24:14.906Z" }, - { url = "https://files.pythonhosted.org/packages/5b/d2/8ed50746d909dcf402af3fa58b83d5a590ed43e07251d6b08fad1a535ba6/rpds_py-0.27.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4bc262ace5a1a7dc3e2eac2fa97b8257ae795389f688b5adf22c5db1e2431c43", size = 419760, upload-time = "2025-08-07T08:24:16.129Z" }, - { url = "https://files.pythonhosted.org/packages/d3/60/2b2071aee781cb3bd49f94d5d35686990b925e9b9f3e3d149235a6f5d5c1/rpds_py-0.27.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:2fe6e18e5c8581f0361b35ae575043c7029d0a92cb3429e6e596c2cdde251432", size = 561201, upload-time = "2025-08-07T08:24:17.645Z" }, - { url = "https://files.pythonhosted.org/packages/98/1f/27b67304272521aaea02be293fecedce13fa351a4e41cdb9290576fc6d81/rpds_py-0.27.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:d93ebdb82363d2e7bec64eecdc3632b59e84bd270d74fe5be1659f7787052f9b", size = 591021, upload-time = "2025-08-07T08:24:18.999Z" }, - { url = "https://files.pythonhosted.org/packages/db/9b/a2fadf823164dd085b1f894be6443b0762a54a7af6f36e98e8fcda69ee50/rpds_py-0.27.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0954e3a92e1d62e83a54ea7b3fdc9efa5d61acef8488a8a3d31fdafbfb00460d", size = 556368, upload-time = "2025-08-07T08:24:20.54Z" }, - { url = "https://files.pythonhosted.org/packages/24/f3/6d135d46a129cda2e3e6d4c5e91e2cc26ea0428c6cf152763f3f10b6dd05/rpds_py-0.27.0-cp313-cp313-win32.whl", hash = "sha256:2cff9bdd6c7b906cc562a505c04a57d92e82d37200027e8d362518df427f96cd", size = 221236, upload-time = "2025-08-07T08:24:22.144Z" }, - { url = "https://files.pythonhosted.org/packages/c5/44/65d7494f5448ecc755b545d78b188440f81da98b50ea0447ab5ebfdf9bd6/rpds_py-0.27.0-cp313-cp313-win_amd64.whl", hash = "sha256:dc79d192fb76fc0c84f2c58672c17bbbc383fd26c3cdc29daae16ce3d927e8b2", size = 232634, upload-time = "2025-08-07T08:24:23.642Z" }, - { url = "https://files.pythonhosted.org/packages/70/d9/23852410fadab2abb611733933401de42a1964ce6600a3badae35fbd573e/rpds_py-0.27.0-cp313-cp313-win_arm64.whl", hash = "sha256:5b3a5c8089eed498a3af23ce87a80805ff98f6ef8f7bdb70bd1b7dae5105f6ac", size = 222783, upload-time = "2025-08-07T08:24:25.098Z" }, - { url = "https://files.pythonhosted.org/packages/15/75/03447917f78512b34463f4ef11066516067099a0c466545655503bed0c77/rpds_py-0.27.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:90fb790138c1a89a2e58c9282fe1089638401f2f3b8dddd758499041bc6e0774", size = 359154, upload-time = "2025-08-07T08:24:26.249Z" }, - { url = "https://files.pythonhosted.org/packages/6b/fc/4dac4fa756451f2122ddaf136e2c6aeb758dc6fdbe9ccc4bc95c98451d50/rpds_py-0.27.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:010c4843a3b92b54373e3d2291a7447d6c3fc29f591772cc2ea0e9f5c1da434b", size = 343909, upload-time = "2025-08-07T08:24:27.405Z" }, - { url = "https://files.pythonhosted.org/packages/7b/81/723c1ed8e6f57ed9d8c0c07578747a2d3d554aaefc1ab89f4e42cfeefa07/rpds_py-0.27.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c9ce7a9e967afc0a2af7caa0d15a3e9c1054815f73d6a8cb9225b61921b419bd", size = 379340, upload-time = "2025-08-07T08:24:28.714Z" }, - { url = "https://files.pythonhosted.org/packages/98/16/7e3740413de71818ce1997df82ba5f94bae9fff90c0a578c0e24658e6201/rpds_py-0.27.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:aa0bf113d15e8abdfee92aa4db86761b709a09954083afcb5bf0f952d6065fdb", size = 391655, upload-time = "2025-08-07T08:24:30.223Z" }, - { url = "https://files.pythonhosted.org/packages/e0/63/2a9f510e124d80660f60ecce07953f3f2d5f0b96192c1365443859b9c87f/rpds_py-0.27.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:eb91d252b35004a84670dfeafadb042528b19842a0080d8b53e5ec1128e8f433", size = 513017, upload-time = "2025-08-07T08:24:31.446Z" }, - { url = "https://files.pythonhosted.org/packages/2c/4e/cf6ff311d09776c53ea1b4f2e6700b9d43bb4e99551006817ade4bbd6f78/rpds_py-0.27.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:db8a6313dbac934193fc17fe7610f70cd8181c542a91382531bef5ed785e5615", size = 402058, upload-time = "2025-08-07T08:24:32.613Z" }, - { url = "https://files.pythonhosted.org/packages/88/11/5e36096d474cb10f2a2d68b22af60a3bc4164fd8db15078769a568d9d3ac/rpds_py-0.27.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce96ab0bdfcef1b8c371ada2100767ace6804ea35aacce0aef3aeb4f3f499ca8", size = 383474, upload-time = "2025-08-07T08:24:33.767Z" }, - { url = "https://files.pythonhosted.org/packages/db/a2/3dff02805b06058760b5eaa6d8cb8db3eb3e46c9e452453ad5fc5b5ad9fe/rpds_py-0.27.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:7451ede3560086abe1aa27dcdcf55cd15c96b56f543fb12e5826eee6f721f858", size = 400067, upload-time = "2025-08-07T08:24:35.021Z" }, - { url = "https://files.pythonhosted.org/packages/67/87/eed7369b0b265518e21ea836456a4ed4a6744c8c12422ce05bce760bb3cf/rpds_py-0.27.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:32196b5a99821476537b3f7732432d64d93a58d680a52c5e12a190ee0135d8b5", size = 412085, upload-time = "2025-08-07T08:24:36.267Z" }, - { url = "https://files.pythonhosted.org/packages/8b/48/f50b2ab2fbb422fbb389fe296e70b7a6b5ea31b263ada5c61377e710a924/rpds_py-0.27.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:a029be818059870664157194e46ce0e995082ac49926f1423c1f058534d2aaa9", size = 555928, upload-time = "2025-08-07T08:24:37.573Z" }, - { url = "https://files.pythonhosted.org/packages/98/41/b18eb51045d06887666c3560cd4bbb6819127b43d758f5adb82b5f56f7d1/rpds_py-0.27.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:3841f66c1ffdc6cebce8aed64e36db71466f1dc23c0d9a5592e2a782a3042c79", size = 585527, upload-time = "2025-08-07T08:24:39.391Z" }, - { url = "https://files.pythonhosted.org/packages/be/03/a3dd6470fc76499959b00ae56295b76b4bdf7c6ffc60d62006b1217567e1/rpds_py-0.27.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:42894616da0fc0dcb2ec08a77896c3f56e9cb2f4b66acd76fc8992c3557ceb1c", size = 554211, upload-time = "2025-08-07T08:24:40.6Z" }, - { url = "https://files.pythonhosted.org/packages/bf/d1/ee5fd1be395a07423ac4ca0bcc05280bf95db2b155d03adefeb47d5ebf7e/rpds_py-0.27.0-cp313-cp313t-win32.whl", hash = "sha256:b1fef1f13c842a39a03409e30ca0bf87b39a1e2a305a9924deadb75a43105d23", size = 216624, upload-time = "2025-08-07T08:24:42.204Z" }, - { url = "https://files.pythonhosted.org/packages/1c/94/4814c4c858833bf46706f87349c37ca45e154da7dbbec9ff09f1abeb08cc/rpds_py-0.27.0-cp313-cp313t-win_amd64.whl", hash = "sha256:183f5e221ba3e283cd36fdfbe311d95cd87699a083330b4f792543987167eff1", size = 230007, upload-time = "2025-08-07T08:24:43.329Z" }, - { url = "https://files.pythonhosted.org/packages/0e/a5/8fffe1c7dc7c055aa02df310f9fb71cfc693a4d5ccc5de2d3456ea5fb022/rpds_py-0.27.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:f3cd110e02c5bf17d8fb562f6c9df5c20e73029d587cf8602a2da6c5ef1e32cb", size = 362595, upload-time = "2025-08-07T08:24:44.478Z" }, - { url = "https://files.pythonhosted.org/packages/bc/c7/4e4253fd2d4bb0edbc0b0b10d9f280612ca4f0f990e3c04c599000fe7d71/rpds_py-0.27.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:8d0e09cf4863c74106b5265c2c310f36146e2b445ff7b3018a56799f28f39f6f", size = 347252, upload-time = "2025-08-07T08:24:45.678Z" }, - { url = "https://files.pythonhosted.org/packages/f3/c8/3d1a954d30f0174dd6baf18b57c215da03cf7846a9d6e0143304e784cddc/rpds_py-0.27.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:64f689ab822f9b5eb6dfc69893b4b9366db1d2420f7db1f6a2adf2a9ca15ad64", size = 384886, upload-time = "2025-08-07T08:24:46.86Z" }, - { url = "https://files.pythonhosted.org/packages/e0/52/3c5835f2df389832b28f9276dd5395b5a965cea34226e7c88c8fbec2093c/rpds_py-0.27.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e36c80c49853b3ffda7aa1831bf175c13356b210c73128c861f3aa93c3cc4015", size = 399716, upload-time = "2025-08-07T08:24:48.174Z" }, - { url = "https://files.pythonhosted.org/packages/40/73/176e46992461a1749686a2a441e24df51ff86b99c2d34bf39f2a5273b987/rpds_py-0.27.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6de6a7f622860af0146cb9ee148682ff4d0cea0b8fd3ad51ce4d40efb2f061d0", size = 517030, upload-time = "2025-08-07T08:24:49.52Z" }, - { url = "https://files.pythonhosted.org/packages/79/2a/7266c75840e8c6e70effeb0d38922a45720904f2cd695e68a0150e5407e2/rpds_py-0.27.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4045e2fc4b37ec4b48e8907a5819bdd3380708c139d7cc358f03a3653abedb89", size = 408448, upload-time = "2025-08-07T08:24:50.727Z" }, - { url = "https://files.pythonhosted.org/packages/e6/5f/a7efc572b8e235093dc6cf39f4dbc8a7f08e65fdbcec7ff4daeb3585eef1/rpds_py-0.27.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9da162b718b12c4219eeeeb68a5b7552fbc7aadedf2efee440f88b9c0e54b45d", size = 387320, upload-time = "2025-08-07T08:24:52.004Z" }, - { url = "https://files.pythonhosted.org/packages/a2/eb/9ff6bc92efe57cf5a2cb74dee20453ba444b6fdc85275d8c99e0d27239d1/rpds_py-0.27.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:0665be515767dc727ffa5f74bd2ef60b0ff85dad6bb8f50d91eaa6b5fb226f51", size = 407414, upload-time = "2025-08-07T08:24:53.664Z" }, - { url = "https://files.pythonhosted.org/packages/fb/bd/3b9b19b00d5c6e1bd0f418c229ab0f8d3b110ddf7ec5d9d689ef783d0268/rpds_py-0.27.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:203f581accef67300a942e49a37d74c12ceeef4514874c7cede21b012613ca2c", size = 420766, upload-time = "2025-08-07T08:24:55.917Z" }, - { url = "https://files.pythonhosted.org/packages/17/6b/521a7b1079ce16258c70805166e3ac6ec4ee2139d023fe07954dc9b2d568/rpds_py-0.27.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7873b65686a6471c0037139aa000d23fe94628e0daaa27b6e40607c90e3f5ec4", size = 562409, upload-time = "2025-08-07T08:24:57.17Z" }, - { url = "https://files.pythonhosted.org/packages/8b/bf/65db5bfb14ccc55e39de8419a659d05a2a9cd232f0a699a516bb0991da7b/rpds_py-0.27.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:249ab91ceaa6b41abc5f19513cb95b45c6f956f6b89f1fe3d99c81255a849f9e", size = 590793, upload-time = "2025-08-07T08:24:58.388Z" }, - { url = "https://files.pythonhosted.org/packages/db/b8/82d368b378325191ba7aae8f40f009b78057b598d4394d1f2cdabaf67b3f/rpds_py-0.27.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:d2f184336bc1d6abfaaa1262ed42739c3789b1e3a65a29916a615307d22ffd2e", size = 558178, upload-time = "2025-08-07T08:24:59.756Z" }, - { url = "https://files.pythonhosted.org/packages/f6/ff/f270bddbfbc3812500f8131b1ebbd97afd014cd554b604a3f73f03133a36/rpds_py-0.27.0-cp314-cp314-win32.whl", hash = "sha256:d3c622c39f04d5751408f5b801ecb527e6e0a471b367f420a877f7a660d583f6", size = 222355, upload-time = "2025-08-07T08:25:01.027Z" }, - { url = "https://files.pythonhosted.org/packages/bf/20/fdab055b1460c02ed356a0e0b0a78c1dd32dc64e82a544f7b31c9ac643dc/rpds_py-0.27.0-cp314-cp314-win_amd64.whl", hash = "sha256:cf824aceaeffff029ccfba0da637d432ca71ab21f13e7f6f5179cd88ebc77a8a", size = 234007, upload-time = "2025-08-07T08:25:02.268Z" }, - { url = "https://files.pythonhosted.org/packages/4d/a8/694c060005421797a3be4943dab8347c76c2b429a9bef68fb2c87c9e70c7/rpds_py-0.27.0-cp314-cp314-win_arm64.whl", hash = "sha256:86aca1616922b40d8ac1b3073a1ead4255a2f13405e5700c01f7c8d29a03972d", size = 223527, upload-time = "2025-08-07T08:25:03.45Z" }, - { url = "https://files.pythonhosted.org/packages/1e/f9/77f4c90f79d2c5ca8ce6ec6a76cb4734ee247de6b3a4f337e289e1f00372/rpds_py-0.27.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:341d8acb6724c0c17bdf714319c393bb27f6d23d39bc74f94221b3e59fc31828", size = 359469, upload-time = "2025-08-07T08:25:04.648Z" }, - { url = "https://files.pythonhosted.org/packages/c0/22/b97878d2f1284286fef4172069e84b0b42b546ea7d053e5fb7adb9ac6494/rpds_py-0.27.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:6b96b0b784fe5fd03beffff2b1533dc0d85e92bab8d1b2c24ef3a5dc8fac5669", size = 343960, upload-time = "2025-08-07T08:25:05.863Z" }, - { url = "https://files.pythonhosted.org/packages/b1/b0/dfd55b5bb480eda0578ae94ef256d3061d20b19a0f5e18c482f03e65464f/rpds_py-0.27.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0c431bfb91478d7cbe368d0a699978050d3b112d7f1d440a41e90faa325557fd", size = 380201, upload-time = "2025-08-07T08:25:07.513Z" }, - { url = "https://files.pythonhosted.org/packages/28/22/e1fa64e50d58ad2b2053077e3ec81a979147c43428de9e6de68ddf6aff4e/rpds_py-0.27.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:20e222a44ae9f507d0f2678ee3dd0c45ec1e930f6875d99b8459631c24058aec", size = 392111, upload-time = "2025-08-07T08:25:09.149Z" }, - { url = "https://files.pythonhosted.org/packages/49/f9/43ab7a43e97aedf6cea6af70fdcbe18abbbc41d4ae6cdec1bfc23bbad403/rpds_py-0.27.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:184f0d7b342967f6cda94a07d0e1fae177d11d0b8f17d73e06e36ac02889f303", size = 515863, upload-time = "2025-08-07T08:25:10.431Z" }, - { url = "https://files.pythonhosted.org/packages/38/9b/9bd59dcc636cd04d86a2d20ad967770bf348f5eb5922a8f29b547c074243/rpds_py-0.27.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a00c91104c173c9043bc46f7b30ee5e6d2f6b1149f11f545580f5d6fdff42c0b", size = 402398, upload-time = "2025-08-07T08:25:11.819Z" }, - { url = "https://files.pythonhosted.org/packages/71/bf/f099328c6c85667aba6b66fa5c35a8882db06dcd462ea214be72813a0dd2/rpds_py-0.27.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f7a37dd208f0d658e0487522078b1ed68cd6bce20ef4b5a915d2809b9094b410", size = 384665, upload-time = "2025-08-07T08:25:13.194Z" }, - { url = "https://files.pythonhosted.org/packages/a9/c5/9c1f03121ece6634818490bd3c8be2c82a70928a19de03467fb25a3ae2a8/rpds_py-0.27.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:92f3b3ec3e6008a1fe00b7c0946a170f161ac00645cde35e3c9a68c2475e8156", size = 400405, upload-time = "2025-08-07T08:25:14.417Z" }, - { url = "https://files.pythonhosted.org/packages/b5/b8/e25d54af3e63ac94f0c16d8fe143779fe71ff209445a0c00d0f6984b6b2c/rpds_py-0.27.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a1b3db5fae5cbce2131b7420a3f83553d4d89514c03d67804ced36161fe8b6b2", size = 413179, upload-time = "2025-08-07T08:25:15.664Z" }, - { url = "https://files.pythonhosted.org/packages/f9/d1/406b3316433fe49c3021546293a04bc33f1478e3ec7950215a7fce1a1208/rpds_py-0.27.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5355527adaa713ab693cbce7c1e0ec71682f599f61b128cf19d07e5c13c9b1f1", size = 556895, upload-time = "2025-08-07T08:25:17.061Z" }, - { url = "https://files.pythonhosted.org/packages/5f/bc/3697c0c21fcb9a54d46ae3b735eb2365eea0c2be076b8f770f98e07998de/rpds_py-0.27.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:fcc01c57ce6e70b728af02b2401c5bc853a9e14eb07deda30624374f0aebfe42", size = 585464, upload-time = "2025-08-07T08:25:18.406Z" }, - { url = "https://files.pythonhosted.org/packages/63/09/ee1bb5536f99f42c839b177d552f6114aa3142d82f49cef49261ed28dbe0/rpds_py-0.27.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:3001013dae10f806380ba739d40dee11db1ecb91684febb8406a87c2ded23dae", size = 555090, upload-time = "2025-08-07T08:25:20.461Z" }, - { url = "https://files.pythonhosted.org/packages/7d/2c/363eada9e89f7059199d3724135a86c47082cbf72790d6ba2f336d146ddb/rpds_py-0.27.0-cp314-cp314t-win32.whl", hash = "sha256:0f401c369186a5743694dd9fc08cba66cf70908757552e1f714bfc5219c655b5", size = 218001, upload-time = "2025-08-07T08:25:21.761Z" }, - { url = "https://files.pythonhosted.org/packages/e2/3f/d6c216ed5199c9ef79e2a33955601f454ed1e7420a93b89670133bca5ace/rpds_py-0.27.0-cp314-cp314t-win_amd64.whl", hash = "sha256:8a1dca5507fa1337f75dcd5070218b20bc68cf8844271c923c1b79dfcbc20391", size = 230993, upload-time = "2025-08-07T08:25:23.34Z" }, + { url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" }, + { url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" }, + { url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" }, + { url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" }, + { url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" }, + { url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" }, + { url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" }, + { url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" }, + { url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" }, + { url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" }, + { url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" }, + { url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" }, + { url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" }, + { url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" }, + { url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" }, + { url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" }, + { url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" }, + { url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" }, + { url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" }, + { url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" }, + { url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" }, + { url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" }, + { url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" }, + { url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" }, + { url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" }, + { url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" }, + { url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" }, + { url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" }, + { url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" }, + { url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" }, + { url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" }, + { url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" }, + { url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" }, + { url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" }, + { url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" }, + { url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" }, + { url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" }, + { url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" }, + { url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" }, + { url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" }, + { url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" }, + { url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" }, + { url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" }, + { url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" }, + { url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" }, + { url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" }, + { url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" }, + { url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" }, + { url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" }, + { url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" }, + { url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" }, + { url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" }, + { url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" }, + { url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" }, + { url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" }, + { url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" }, + { url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" }, + { url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" }, ] [[package]] name = "send2trash" -version = "1.8.3" +version = "2.1.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/fd/3a/aec9b02217bb79b87bbc1a21bc6abc51e3d5dcf65c30487ac96c0908c722/Send2Trash-1.8.3.tar.gz", hash = "sha256:b18e7a3966d99871aefeb00cfbcfdced55ce4871194810fc71f4aa484b953abf", size = 17394, upload-time = "2024-04-07T00:01:09.267Z" } +sdist = { url = "https://files.pythonhosted.org/packages/c5/f0/184b4b5f8d00f2a92cf96eec8967a3d550b52cf94362dad1100df9e48d57/send2trash-2.1.0.tar.gz", hash = "sha256:1c72b39f09457db3c05ce1d19158c2cbef4c32b8bedd02c155e49282b7ea7459", size = 17255, upload-time = "2026-01-14T06:27:36.056Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/40/b0/4562db6223154aa4e22f939003cb92514c79f3d4dccca3444253fd17f902/Send2Trash-1.8.3-py3-none-any.whl", hash = "sha256:0c31227e0bd08961c7665474a3d1ef7193929fedda4233843689baa056be46c9", size = 18072, upload-time = "2024-04-07T00:01:07.438Z" }, + { url = "https://files.pythonhosted.org/packages/1c/78/504fdd027da3b84ff1aecd9f6957e65f35134534ccc6da8628eb71e76d3f/send2trash-2.1.0-py3-none-any.whl", hash = "sha256:0da2f112e6d6bb22de6aa6daa7e144831a4febf2a87261451c4ad849fe9a873c", size = 17610, upload-time = "2026-01-14T06:27:35.218Z" }, ] [[package]] name = "setuptools" -version = "80.9.0" +version = "82.0.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/18/5d/3bf57dcd21979b887f014ea83c24ae194cfcd12b9e0fda66b957c69d1fca/setuptools-80.9.0.tar.gz", hash = "sha256:f36b47402ecde768dbfafc46e8e4207b4360c654f1f3bb84475f0a28628fb19c", size = 1319958, upload-time = "2025-05-27T00:56:51.443Z" } +sdist = { url = "https://files.pythonhosted.org/packages/82/f3/748f4d6f65d1756b9ae577f329c951cda23fb900e4de9f70900ced962085/setuptools-82.0.0.tar.gz", hash = "sha256:22e0a2d69474c6ae4feb01951cb69d515ed23728cf96d05513d36e42b62b37cb", size = 1144893, upload-time = "2026-02-08T15:08:40.206Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/a3/dc/17031897dae0efacfea57dfd3a82fdd2a2aeb58e0ff71b77b87e44edc772/setuptools-80.9.0-py3-none-any.whl", hash = "sha256:062d34222ad13e0cc312a4c02d73f059e86a4acbfbdea8f8f76b28c99f306922", size = 1201486, upload-time = "2025-05-27T00:56:49.664Z" }, + { url = "https://files.pythonhosted.org/packages/e1/c6/76dc613121b793286a3f91621d7b75a2b493e0390ddca50f11993eadf192/setuptools-82.0.0-py3-none-any.whl", hash = "sha256:70b18734b607bd1da571d097d236cfcfacaf01de45717d59e6e04b96877532e0", size = 1003468, upload-time = "2026-02-08T15:08:38.723Z" }, ] [[package]] @@ -1732,22 +1894,13 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" }, ] -[[package]] -name = "sniffio" -version = "1.3.1" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/a2/87/a6771e1546d97e7e041b6ae58d80074f81b7d5121207425c964ddf5cfdbd/sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc", size = 20372, upload-time = "2024-02-25T23:20:04.057Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/e9/44/75a9c9421471a6c4805dbf2356f7c181a29c1879239abab1ea2cc8f38b40/sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2", size = 10235, upload-time = "2024-02-25T23:20:01.196Z" }, -] - [[package]] name = "soupsieve" -version = "2.7" +version = "2.8.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/3f/f4/4a80cd6ef364b2e8b65b15816a843c0980f7a5a2b4dc701fc574952aa19f/soupsieve-2.7.tar.gz", hash = "sha256:ad282f9b6926286d2ead4750552c8a6142bc4c783fd66b0293547c8fe6ae126a", size = 103418, upload-time = "2025-04-20T18:50:08.518Z" } +sdist = { url = "https://files.pythonhosted.org/packages/7b/ae/2d9c981590ed9999a0d91755b47fc74f74de286b0f5cee14c9269041e6c4/soupsieve-2.8.3.tar.gz", hash = "sha256:3267f1eeea4251fb42728b6dfb746edc9acaffc4a45b27e19450b676586e8349", size = 118627, upload-time = "2026-01-20T04:27:02.457Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/e7/9c/0e6afc12c269578be5c0c1c9f4b49a8d32770a080260c333ac04cc1c832d/soupsieve-2.7-py3-none-any.whl", hash = "sha256:6e60cc5c1ffaf1cebcc12e8188320b72071e922c2e897f737cadce79ad5d30c4", size = 36677, upload-time = "2025-04-20T18:50:07.196Z" }, + { url = "https://files.pythonhosted.org/packages/46/2c/1462b1d0a634697ae9e55b3cecdcb64788e8b7d63f54d923fcd0bb140aed/soupsieve-2.8.3-py3-none-any.whl", hash = "sha256:ed64f2ba4eebeab06cc4962affce381647455978ffc1e36bb79a545b91f45a95", size = 37016, upload-time = "2026-01-20T04:27:01.012Z" }, ] [[package]] @@ -1822,33 +1975,33 @@ wheels = [ [[package]] name = "tornado" -version = "6.5.2" +version = "6.5.4" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/09/ce/1eb500eae19f4648281bb2186927bb062d2438c2e5093d1360391afd2f90/tornado-6.5.2.tar.gz", hash = "sha256:ab53c8f9a0fa351e2c0741284e06c7a45da86afb544133201c5cc8578eb076a0", size = 510821, upload-time = "2025-08-08T18:27:00.78Z" } +sdist = { url = "https://files.pythonhosted.org/packages/37/1d/0a336abf618272d53f62ebe274f712e213f5a03c0b2339575430b8362ef2/tornado-6.5.4.tar.gz", hash = "sha256:a22fa9047405d03260b483980635f0b041989d8bcc9a313f8fe18b411d84b1d7", size = 513632, upload-time = "2025-12-15T19:21:03.836Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/f6/48/6a7529df2c9cc12efd2e8f5dd219516184d703b34c06786809670df5b3bd/tornado-6.5.2-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:2436822940d37cde62771cff8774f4f00b3c8024fe482e16ca8387b8a2724db6", size = 442563, upload-time = "2025-08-08T18:26:42.945Z" }, - { url = "https://files.pythonhosted.org/packages/f2/b5/9b575a0ed3e50b00c40b08cbce82eb618229091d09f6d14bce80fc01cb0b/tornado-6.5.2-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:583a52c7aa94ee046854ba81d9ebb6c81ec0fd30386d96f7640c96dad45a03ef", size = 440729, upload-time = "2025-08-08T18:26:44.473Z" }, - { url = "https://files.pythonhosted.org/packages/1b/4e/619174f52b120efcf23633c817fd3fed867c30bff785e2cd5a53a70e483c/tornado-6.5.2-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b0fe179f28d597deab2842b86ed4060deec7388f1fd9c1b4a41adf8af058907e", size = 444295, upload-time = "2025-08-08T18:26:46.021Z" }, - { url = "https://files.pythonhosted.org/packages/95/fa/87b41709552bbd393c85dd18e4e3499dcd8983f66e7972926db8d96aa065/tornado-6.5.2-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b186e85d1e3536d69583d2298423744740986018e393d0321df7340e71898882", size = 443644, upload-time = "2025-08-08T18:26:47.625Z" }, - { url = "https://files.pythonhosted.org/packages/f9/41/fb15f06e33d7430ca89420283a8762a4e6b8025b800ea51796ab5e6d9559/tornado-6.5.2-cp39-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e792706668c87709709c18b353da1f7662317b563ff69f00bab83595940c7108", size = 443878, upload-time = "2025-08-08T18:26:50.599Z" }, - { url = "https://files.pythonhosted.org/packages/11/92/fe6d57da897776ad2e01e279170ea8ae726755b045fe5ac73b75357a5a3f/tornado-6.5.2-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:06ceb1300fd70cb20e43b1ad8aaee0266e69e7ced38fa910ad2e03285009ce7c", size = 444549, upload-time = "2025-08-08T18:26:51.864Z" }, - { url = "https://files.pythonhosted.org/packages/9b/02/c8f4f6c9204526daf3d760f4aa555a7a33ad0e60843eac025ccfd6ff4a93/tornado-6.5.2-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:74db443e0f5251be86cbf37929f84d8c20c27a355dd452a5cfa2aada0d001ec4", size = 443973, upload-time = "2025-08-08T18:26:53.625Z" }, - { url = "https://files.pythonhosted.org/packages/ae/2d/f5f5707b655ce2317190183868cd0f6822a1121b4baeae509ceb9590d0bd/tornado-6.5.2-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:b5e735ab2889d7ed33b32a459cac490eda71a1ba6857b0118de476ab6c366c04", size = 443954, upload-time = "2025-08-08T18:26:55.072Z" }, - { url = "https://files.pythonhosted.org/packages/e8/59/593bd0f40f7355806bf6573b47b8c22f8e1374c9b6fd03114bd6b7a3dcfd/tornado-6.5.2-cp39-abi3-win32.whl", hash = "sha256:c6f29e94d9b37a95013bb669616352ddb82e3bfe8326fccee50583caebc8a5f0", size = 445023, upload-time = "2025-08-08T18:26:56.677Z" }, - { url = "https://files.pythonhosted.org/packages/c7/2a/f609b420c2f564a748a2d80ebfb2ee02a73ca80223af712fca591386cafb/tornado-6.5.2-cp39-abi3-win_amd64.whl", hash = "sha256:e56a5af51cc30dd2cae649429af65ca2f6571da29504a07995175df14c18f35f", size = 445427, upload-time = "2025-08-08T18:26:57.91Z" }, - { url = "https://files.pythonhosted.org/packages/5e/4f/e1f65e8f8c76d73658b33d33b81eed4322fb5085350e4328d5c956f0c8f9/tornado-6.5.2-cp39-abi3-win_arm64.whl", hash = "sha256:d6c33dc3672e3a1f3618eb63b7ef4683a7688e7b9e6e8f0d9aa5726360a004af", size = 444456, upload-time = "2025-08-08T18:26:59.207Z" }, + { url = "https://files.pythonhosted.org/packages/ab/a9/e94a9d5224107d7ce3cc1fab8d5dc97f5ea351ccc6322ee4fb661da94e35/tornado-6.5.4-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:d6241c1a16b1c9e4cc28148b1cda97dd1c6cb4fb7068ac1bedc610768dff0ba9", size = 443909, upload-time = "2025-12-15T19:20:48.382Z" }, + { url = "https://files.pythonhosted.org/packages/db/7e/f7b8d8c4453f305a51f80dbb49014257bb7d28ccb4bbb8dd328ea995ecad/tornado-6.5.4-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:2d50f63dda1d2cac3ae1fa23d254e16b5e38153758470e9956cbc3d813d40843", size = 442163, upload-time = "2025-12-15T19:20:49.791Z" }, + { url = "https://files.pythonhosted.org/packages/ba/b5/206f82d51e1bfa940ba366a8d2f83904b15942c45a78dd978b599870ab44/tornado-6.5.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d1cf66105dc6acb5af613c054955b8137e34a03698aa53272dbda4afe252be17", size = 445746, upload-time = "2025-12-15T19:20:51.491Z" }, + { url = "https://files.pythonhosted.org/packages/8e/9d/1a3338e0bd30ada6ad4356c13a0a6c35fbc859063fa7eddb309183364ac1/tornado-6.5.4-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:50ff0a58b0dc97939d29da29cd624da010e7f804746621c78d14b80238669335", size = 445083, upload-time = "2025-12-15T19:20:52.778Z" }, + { url = "https://files.pythonhosted.org/packages/50/d4/e51d52047e7eb9a582da59f32125d17c0482d065afd5d3bc435ff2120dc5/tornado-6.5.4-cp39-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e5fb5e04efa54cf0baabdd10061eb4148e0be137166146fff835745f59ab9f7f", size = 445315, upload-time = "2025-12-15T19:20:53.996Z" }, + { url = "https://files.pythonhosted.org/packages/27/07/2273972f69ca63dbc139694a3fc4684edec3ea3f9efabf77ed32483b875c/tornado-6.5.4-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9c86b1643b33a4cd415f8d0fe53045f913bf07b4a3ef646b735a6a86047dda84", size = 446003, upload-time = "2025-12-15T19:20:56.101Z" }, + { url = "https://files.pythonhosted.org/packages/d1/83/41c52e47502bf7260044413b6770d1a48dda2f0246f95ee1384a3cd9c44a/tornado-6.5.4-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:6eb82872335a53dd063a4f10917b3efd28270b56a33db69009606a0312660a6f", size = 445412, upload-time = "2025-12-15T19:20:57.398Z" }, + { url = "https://files.pythonhosted.org/packages/10/c7/bc96917f06cbee182d44735d4ecde9c432e25b84f4c2086143013e7b9e52/tornado-6.5.4-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:6076d5dda368c9328ff41ab5d9dd3608e695e8225d1cd0fd1e006f05da3635a8", size = 445392, upload-time = "2025-12-15T19:20:58.692Z" }, + { url = "https://files.pythonhosted.org/packages/0c/1a/d7592328d037d36f2d2462f4bc1fbb383eec9278bc786c1b111cbbd44cfa/tornado-6.5.4-cp39-abi3-win32.whl", hash = "sha256:1768110f2411d5cd281bac0a090f707223ce77fd110424361092859e089b38d1", size = 446481, upload-time = "2025-12-15T19:21:00.008Z" }, + { url = "https://files.pythonhosted.org/packages/d6/6d/c69be695a0a64fd37a97db12355a035a6d90f79067a3cf936ec2b1dc38cd/tornado-6.5.4-cp39-abi3-win_amd64.whl", hash = "sha256:fa07d31e0cd85c60713f2b995da613588aa03e1303d75705dca6af8babc18ddc", size = 446886, upload-time = "2025-12-15T19:21:01.287Z" }, + { url = "https://files.pythonhosted.org/packages/50/49/8dc3fd90902f70084bd2cd059d576ddb4f8bb44c2c7c0e33a11422acb17e/tornado-6.5.4-cp39-abi3-win_arm64.whl", hash = "sha256:053e6e16701eb6cbe641f308f4c1a9541f91b6261991160391bfc342e8a551a1", size = 445910, upload-time = "2025-12-15T19:21:02.571Z" }, ] [[package]] name = "tqdm" -version = "4.67.1" +version = "4.67.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "colorama", marker = "sys_platform == 'win32'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/a8/4b/29b4ef32e036bb34e4ab51796dd745cdba7ed47ad142a9f4a1eb8e0c744d/tqdm-4.67.1.tar.gz", hash = "sha256:f8aef9c52c08c13a65f30ea34f4e5aac3fd1a34959879d7e59e63027286627f2", size = 169737, upload-time = "2024-11-24T20:12:22.481Z" } +sdist = { url = "https://files.pythonhosted.org/packages/09/a9/6ba95a270c6f1fbcd8dac228323f2777d886cb206987444e4bce66338dd4/tqdm-4.67.3.tar.gz", hash = "sha256:7d825f03f89244ef73f1d4ce193cb1774a8179fd96f31d7e1dcde62092b960bb", size = 169598, upload-time = "2026-02-03T17:35:53.048Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/d0/30/dc54f88dd4a2b5dc8a0279bdd7270e735851848b762aeb1c1184ed1f6b14/tqdm-4.67.1-py3-none-any.whl", hash = "sha256:26445eca388f82e72884e0d580d5464cd801a3ea01e63e5601bdff9ba6a48de2", size = 78540, upload-time = "2024-11-24T20:12:19.698Z" }, + { url = "https://files.pythonhosted.org/packages/16/e1/3079a9ff9b8e11b846c6ac5c8b5bfb7ff225eee721825310c91b3b50304f/tqdm-4.67.3-py3-none-any.whl", hash = "sha256:ee1e4c0e59148062281c49d80b25b67771a127c85fc9676d3be5f243206826bf", size = 78374, upload-time = "2026-02-03T17:35:50.982Z" }, ] [[package]] @@ -1860,31 +2013,22 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/00/c0/8f5d070730d7836adc9c9b6408dec68c6ced86b304a9b26a14df072a6e8c/traitlets-5.14.3-py3-none-any.whl", hash = "sha256:b74e89e397b1ed28cc831db7aea759ba6640cb3de13090ca145426688ff1ac4f", size = 85359, upload-time = "2024-04-19T11:11:46.763Z" }, ] -[[package]] -name = "types-python-dateutil" -version = "2.9.0.20250809" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/a3/53/07dac71db45fb6b3c71c2fd29a87cada2239eac7ecfb318e6ebc7da00a3b/types_python_dateutil-2.9.0.20250809.tar.gz", hash = "sha256:69cbf8d15ef7a75c3801d65d63466e46ac25a0baa678d89d0a137fc31a608cc1", size = 15820, upload-time = "2025-08-09T03:14:14.109Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/43/5e/67312e679f612218d07fcdbd14017e6d571ce240a5ba1ad734f15a8523cc/types_python_dateutil-2.9.0.20250809-py3-none-any.whl", hash = "sha256:768890cac4f2d7fd9e0feb6f3217fce2abbfdfc0cadd38d11fba325a815e4b9f", size = 17707, upload-time = "2025-08-09T03:14:13.314Z" }, -] - [[package]] name = "typing-extensions" -version = "4.14.1" +version = "4.15.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/98/5a/da40306b885cc8c09109dc2e1abd358d5684b1425678151cdaed4731c822/typing_extensions-4.14.1.tar.gz", hash = "sha256:38b39f4aeeab64884ce9f74c94263ef78f3c22467c8724005483154c26648d36", size = 107673, upload-time = "2025-07-04T13:28:34.16Z" } +sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/b5/00/d631e67a838026495268c2f6884f3711a15a9a2a96cd244fdaea53b823fb/typing_extensions-4.14.1-py3-none-any.whl", hash = "sha256:d1e1e3b58374dc93031d6eda2420a48ea44a36c2b4766a4fdeb3710755731d76", size = 43906, upload-time = "2025-07-04T13:28:32.743Z" }, + { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" }, ] [[package]] name = "tzdata" -version = "2025.2" +version = "2025.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/95/32/1a225d6164441be760d75c2c42e2780dc0873fe382da3e98a2e1e48361e5/tzdata-2025.2.tar.gz", hash = "sha256:b60a638fcc0daffadf82fe0f57e53d06bdec2f36c4df66280ae79bce6bd6f2b9", size = 196380, upload-time = "2025-03-23T13:54:43.652Z" } +sdist = { url = "https://files.pythonhosted.org/packages/5e/a7/c202b344c5ca7daf398f3b8a477eeb205cf3b6f32e7ec3a6bac0629ca975/tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7", size = 196772, upload-time = "2025-12-13T17:45:35.667Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/5c/23/c7abc0ca0a1526a0774eca151daeb8de62ec457e77262b66b359c3c7679e/tzdata-2025.2-py2.py3-none-any.whl", hash = "sha256:1a403fada01ff9221ca8044d701868fa132215d84beb92242d9acd2147f667a8", size = 347839, upload-time = "2025-03-23T13:54:41.845Z" }, + { url = "https://files.pythonhosted.org/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1", size = 348521, upload-time = "2025-12-13T17:45:33.889Z" }, ] [[package]] @@ -1898,29 +2042,29 @@ wheels = [ [[package]] name = "urllib3" -version = "2.5.0" +version = "2.6.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/15/22/9ee70a2574a4f4599c47dd506532914ce044817c7752a79b6a51286319bc/urllib3-2.5.0.tar.gz", hash = "sha256:3fc47733c7e419d4bc3f6b3dc2b4f890bb743906a30d56ba4a5bfa4bbff92760", size = 393185, upload-time = "2025-06-18T14:07:41.644Z" } +sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/a7/c2/fe1e52489ae3122415c51f387e221dd0773709bad6c6cdaa599e8a2c5185/urllib3-2.5.0-py3-none-any.whl", hash = "sha256:e6b01673c0fa6a13e374b50871808eb3bf7046c4b125b216f6bf1cc604cff0dc", size = 129795, upload-time = "2025-06-18T14:07:40.39Z" }, + { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" }, ] [[package]] name = "wcwidth" -version = "0.2.13" +version = "0.6.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/6c/63/53559446a878410fc5a5974feb13d31d78d752eb18aeba59c7fef1af7598/wcwidth-0.2.13.tar.gz", hash = "sha256:72ea0c06399eb286d978fdedb6923a9eb47e1c486ce63e9b4e64fc18303972b5", size = 101301, upload-time = "2024-01-06T02:10:57.829Z" } +sdist = { url = "https://files.pythonhosted.org/packages/35/a2/8e3becb46433538a38726c948d3399905a4c7cabd0df578ede5dc51f0ec2/wcwidth-0.6.0.tar.gz", hash = "sha256:cdc4e4262d6ef9a1a57e018384cbeb1208d8abbc64176027e2c2455c81313159", size = 159684, upload-time = "2026-02-06T19:19:40.919Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/fd/84/fd2ba7aafacbad3c4201d395674fc6348826569da3c0937e75505ead3528/wcwidth-0.2.13-py2.py3-none-any.whl", hash = "sha256:3da69048e4540d84af32131829ff948f1e022c1c6bdb8d6102117aac784f6859", size = 34166, upload-time = "2024-01-06T02:10:55.763Z" }, + { url = "https://files.pythonhosted.org/packages/68/5a/199c59e0a824a3db2b89c5d2dade7ab5f9624dbf6448dc291b46d5ec94d3/wcwidth-0.6.0-py3-none-any.whl", hash = "sha256:1a3a1e510b553315f8e146c54764f4fb6264ffad731b3d78088cdb1478ffbdad", size = 94189, upload-time = "2026-02-06T19:19:39.646Z" }, ] [[package]] name = "webcolors" -version = "24.11.1" +version = "25.10.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/7b/29/061ec845fb58521848f3739e466efd8250b4b7b98c1b6c5bf4d40b419b7e/webcolors-24.11.1.tar.gz", hash = "sha256:ecb3d768f32202af770477b8b65f318fa4f566c22948673a977b00d589dd80f6", size = 45064, upload-time = "2024-11-11T07:43:24.224Z" } +sdist = { url = "https://files.pythonhosted.org/packages/1d/7a/eb316761ec35664ea5174709a68bbd3389de60d4a1ebab8808bfc264ed67/webcolors-25.10.0.tar.gz", hash = "sha256:62abae86504f66d0f6364c2a8520de4a0c47b80c03fc3a5f1815fedbef7c19bf", size = 53491, upload-time = "2025-10-31T07:51:03.977Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/60/e8/c0e05e4684d13459f93d312077a9a2efbe04d59c393bc2b8802248c908d4/webcolors-24.11.1-py3-none-any.whl", hash = "sha256:515291393b4cdf0eb19c155749a096f779f7d909f7cceea072791cb9095b92e9", size = 14934, upload-time = "2024-11-11T07:43:22.529Z" }, + { url = "https://files.pythonhosted.org/packages/e2/cc/e097523dd85c9cf5d354f78310927f1656c422bd7b2613b2db3e3f9a0f2c/webcolors-25.10.0-py3-none-any.whl", hash = "sha256:032c727334856fc0b968f63daa252a1ac93d33db2f5267756623c210e57a4f1d", size = 14905, upload-time = "2025-10-31T07:51:01.778Z" }, ] [[package]] @@ -1934,18 +2078,18 @@ wheels = [ [[package]] name = "websocket-client" -version = "1.8.0" +version = "1.9.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/e6/30/fba0d96b4b5fbf5948ed3f4681f7da2f9f64512e1d303f94b4cc174c24a5/websocket_client-1.8.0.tar.gz", hash = "sha256:3239df9f44da632f96012472805d40a23281a991027ce11d2f45a6f24ac4c3da", size = 54648, upload-time = "2024-04-23T22:16:16.976Z" } +sdist = { url = "https://files.pythonhosted.org/packages/2c/41/aa4bf9664e4cda14c3b39865b12251e8e7d239f4cd0e3cc1b6c2ccde25c1/websocket_client-1.9.0.tar.gz", hash = "sha256:9e813624b6eb619999a97dc7958469217c3176312b3a16a4bd1bc7e08a46ec98", size = 70576, upload-time = "2025-10-07T21:16:36.495Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/5a/84/44687a29792a70e111c5c477230a72c4b957d88d16141199bf9acb7537a3/websocket_client-1.8.0-py3-none-any.whl", hash = "sha256:17b44cc997f5c498e809b22cdf2d9c7a9e71c02c8cc2b6c56e7c2d1239bfa526", size = 58826, upload-time = "2024-04-23T22:16:14.422Z" }, + { url = "https://files.pythonhosted.org/packages/34/db/b10e48aa8fff7407e67470363eac595018441cf32d5e1001567a7aeba5d2/websocket_client-1.9.0-py3-none-any.whl", hash = "sha256:af248a825037ef591efbf6ed20cc5faa03d3b47b9e5a2230a529eeee1c1fc3ef", size = 82616, upload-time = "2025-10-07T21:16:34.951Z" }, ] [[package]] name = "widgetsnbextension" -version = "4.0.14" +version = "4.0.15" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/41/53/2e0253c5efd69c9656b1843892052a31c36d37ad42812b5da45c62191f7e/widgetsnbextension-4.0.14.tar.gz", hash = "sha256:a3629b04e3edb893212df862038c7232f62973373869db5084aed739b437b5af", size = 1097428, upload-time = "2025-04-10T13:01:25.628Z" } +sdist = { url = "https://files.pythonhosted.org/packages/bd/f4/c67440c7fb409a71b7404b7aefcd7569a9c0d6bd071299bf4198ae7a5d95/widgetsnbextension-4.0.15.tar.gz", hash = "sha256:de8610639996f1567952d763a5a41af8af37f2575a41f9852a38f947eb82a3b9", size = 1097402, upload-time = "2025-11-01T21:15:55.178Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/ca/51/5447876806d1088a0f8f71e16542bf350918128d0a69437df26047c8e46f/widgetsnbextension-4.0.14-py3-none-any.whl", hash = "sha256:4875a9eaf72fbf5079dc372a51a9f268fc38d46f767cbf85c43a36da5cb9b575", size = 2196503, upload-time = "2025-04-10T13:01:23.086Z" }, + { url = "https://files.pythonhosted.org/packages/3f/0e/fa3b193432cfc60c93b42f3be03365f5f909d2b3ea410295cf36df739e31/widgetsnbextension-4.0.15-py3-none-any.whl", hash = "sha256:8156704e4346a571d9ce73b84bee86a29906c9abfd7223b7228a28899ccf3366", size = 2196503, upload-time = "2025-11-01T21:15:53.565Z" }, ]