qs_backtest/
lib.rs

1//! `qs-backtest` — Backtesting engine for the quant-system workspace.
2//!
3//! This crate provides tools for replaying historical market data through the
4//! [`qs_core::TradeEngine`] to evaluate trading strategies and predefined
5//! signal sets.
6//!
7//! # Two modes of operation
8//!
9//! 1. **Strategy-driven** — implement the [`Strategy`] trait; the runner feeds
10//!    market data tick-by-tick and your strategy decides when to act.
11//! 2. **Signal replay** — provide a `Vec<Signal>` with timestamps; the runner
12//!    injects them at the correct moments while replaying price data.
13//!
14//! # Key types
15//!
16//! | Type | Purpose |
17//! |------|---------|
18//! | [`BacktestRunner`] | Orchestrates the backtest loop (both modes) |
19//! | [`BacktestExecutor`] | Tracks simulated fills, positions, and P&L |
20//! | [`BacktestResult`] | Final report — P&L, win rate, drawdown, trade log |
21//! | [`DataFeed`] | Trait for sequential market event sources |
22//! | [`Strategy`] | Trait for strategy-driven backtests |
23
24pub mod artifacts;
25pub mod currency;
26pub mod data_feed;
27pub mod economic_support;
28pub mod evaluation;
29pub mod executor;
30pub mod future_executor;
31pub mod ledger;
32pub mod mtm;
33pub mod portfolio;
34pub mod profile;
35pub mod report;
36pub mod runner;
37pub mod sizing;
38pub mod strategy;
39
40// ── Convenience re-exports ──────────────────────────────────────────────────
41
42pub use artifacts::{
43    CloseEvent, CompletedPosition, ExecutionMetadata, FutureBacktestArtifacts, NetPnlOutcome,
44    OpenPositionSnapshot, PendingOrderLifecycleEvent, PendingOrderLifecycleState,
45    PendingOrderSnapshot, RecordedFill, RiskBasisStatus, RiskTranche,
46};
47pub use currency::{
48    ConversionError, ConversionLeg, ConversionLegAudit, ConversionPriceSide, ConversionQuoteBook,
49    ConversionResult, ConversionRoute, FxPair, FxPairDirection, QuoteValidationError,
50    RunCurrencyPlan, RunCurrencyPlanError, resolve_conversion_route, resolve_fx_pair,
51};
52pub use data_feed::{DataFeed, MarketEvent, VecFeed};
53pub use economic_support::{
54    EconomicSupportError, LEGACY_ECONOMIC_GUARD_ID, LegacyEconomicModel, SupportedLegacyEconomics,
55    resolve_legacy_economics,
56};
57pub use evaluation::{
58    BootstrapConfig, BreakdownDimension, EvaluationContext, EvaluationOptions, EvaluationReport,
59    EvaluationSection, GroupFilter, PositionFilter, PositionSide,
60};
61pub use executor::BacktestExecutor;
62pub use future_executor::FutureExecutor;
63pub use mtm::{
64    DEFAULT_MTM_MAX_POINTS, MAX_MTM_MAX_POINTS, MIN_MTM_MAX_POINTS, MtmCurveCollector,
65    MtmOutputPolicy, MtmOutputPolicyError, MtmOutputSummary,
66};
67pub use profile::{
68    ManagementProfile, PositionRef, PositionResolver, ProfileApplicationError, ProfileError,
69    ProfileRegistry, ProfileRegistryError, ProfileValidationError, RawSignal, ResolvedEntry,
70    RuleConfigDef, StoplossMode, TargetResolution, TargetSelection, allocate_target_units,
71    resolve_signal, resolve_unprofiled_entry,
72};
73pub use report::{
74    BacktestResult, CloseReasonStats, DurationStats, MonthlyReturn, PositionSummary, RiskMetrics,
75    StreakStats, SubsetStats, TradeResult,
76};
77pub use runner::{
78    BacktestRunner, FutureQuoteConfig, ReplayCancelled, ReplayProgress, StreamingReplayError,
79};
80pub use strategy::Strategy;
qs_backtest/lib.rs

qs_backtest/
lib.rs
