"Vibe-Trading: Your Personal Trading Agent"
Python ai-agentalgorithmic-tradingbacktestingfintechllmmcpmulti-agentpythonquantitative-financetrading
docs(readme): write the fallback chains in the order the loader walks
Haozhe Wu36485bf55b99
diff --git a/README.md b/README.mdindex 8c578314a..1351c6a2f 100644--- a/README.md+++ b/README.md@@ -582,8 +582,10 @@ One `get_market_data` call, **28 market-data sources**, one of them the optional- **India (NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **Korea (KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **UK (LSE)** → `yahoo` · `yfinance` · `local` *(declared GBP/GBp quotes only)*-- **Crypto** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **Forex / metals** → `mt5` · `yfinance` · `akshare` · `local` · *(futures / fund / macro → `tushare`/`akshare` → `local`)*+- **Crypto** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **Forex / metals** → `mt5` · `akshare` · `yfinance` · `local`+- **Canada / Vietnam / Argentina / indices** → `yahoo` · `yfinance` · `local`+- **China futures** → `akshare` · `local` · **funds** → `tushare` · `akshare` · `local` · **macro** → `akshare` · `tushare` · `local`### Using Longbridge explicitlydiff --git a/README_ar.md b/README_ar.mdindex ee3eedbc9..0ccf22df2 100644--- a/README_ar.md+++ b/README_ar.md@@ -469,8 +469,10 @@ vibe-trading connector install /tmp/my-broker- **أسهم الهند (NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **كوريا (KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **المملكة المتحدة (LSE)** → `yahoo` · `yfinance` · `local` *(الأسعار المعلنة بـ GBP/GBp فقط)*-- **الكريبتو** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **الفوركس / المعادن** → `mt5` · `yfinance` · `akshare` · `local` · *(العقود الآجلة / الصناديق / الاقتصاد الكلي → `tushare`/`akshare` → `local`)*+- **الكريبتو** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **الفوركس / المعادن** → `mt5` · `akshare` · `yfinance` · `local`+- **كندا / فيتنام / الأرجنتين / المؤشرات** → `yahoo` · `yfinance` · `local`+- **العقود الآجلة الصينية** → `akshare` · `local` · **الصناديق** → `tushare` · `akshare` · `local` · **الاقتصاد الكلي** → `akshare` · `tushare` · `local`### استخدام Longbridge صراحةًdiff --git a/README_es.md b/README_es.mdindex b6629fbcb..aeb99c9ca 100644--- a/README_es.md+++ b/README_es.md@@ -468,8 +468,10 @@ Una sola llamada `get_market_data`, **28 fuentes de datos de mercado**, una de e- **India (NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **Corea (KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **Reino Unido (LSE)** → `yahoo` · `yfinance` · `local` *(solo cotizaciones declaradas en GBP/GBp)*-- **Cripto** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **Forex / metales** → `mt5` · `yfinance` · `akshare` · `local` · *(futuros / fondos / macro → `tushare`/`akshare` → `local`)*+- **Cripto** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **Forex / metales** → `mt5` · `akshare` · `yfinance` · `local`+- **Canadá / Vietnam / Argentina / índices** → `yahoo` · `yfinance` · `local`+- **Futuros de China** → `akshare` · `local` · **fondos** → `tushare` · `akshare` · `local` · **macro** → `akshare` · `tushare` · `local`### Uso explícito de Longbridgediff --git a/README_id.md b/README_id.mdindex 1609a4149..7cd59fc59 100644--- a/README_id.md+++ b/README_id.md@@ -630,8 +630,10 @@ Satu call `get_market_data`, **28 sumber data market**, salah satunya marketplac- **India (NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **Korea (KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **UK (LSE)** → `yahoo` · `yfinance` · `local` *(declared GBP/GBp quotes only)*-- **Crypto** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **Forex / metals** → `mt5` · `yfinance` · `akshare` · `local` · *(futures / fund / macro → `tushare`/`akshare` → `local`)*+- **Crypto** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **Forex / metals** → `mt5` · `akshare` · `yfinance` · `local`+- **Canada / Vietnam / Argentina / indices** → `yahoo` · `yfinance` · `local`+- **China futures** → `akshare` · `local` · **funds** → `tushare` · `akshare` · `local` · **macro** → `akshare` · `tushare` · `local`### Menggunakan Longbridge secara eksplisitdiff --git a/README_ja.md b/README_ja.mdindex 71d6c5206..e74acd751 100644--- a/README_ja.md+++ b/README_ja.md@@ -469,8 +469,10 @@ vibe-trading connector install /tmp/my-broker- **インド株(NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **韓国(KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **英国(LSE)** → `yahoo` · `yfinance` · `local` *(GBP/GBp と明示されたクォートのみ)*-- **暗号資産** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **為替/貴金属** → `mt5` · `yfinance` · `akshare` · `local` · *(先物 / ファンド / マクロ → `tushare`/`akshare` → `local`)*+- **暗号資産** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **為替/貴金属** → `mt5` · `akshare` · `yfinance` · `local`+- **カナダ / ベトナム / アルゼンチン / 指数** → `yahoo` · `yfinance` · `local`+- **中国先物** → `akshare` · `local` · **ファンド** → `tushare` · `akshare` · `local` · **マクロ** → `akshare` · `tushare` · `local`### Longbridge を明示的に使うdiff --git a/README_ko.md b/README_ko.mdindex 18b448f92..fead73210 100644--- a/README_ko.md+++ b/README_ko.md@@ -469,8 +469,10 @@ vibe-trading connector install /tmp/my-broker- **인도 (NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **한국 (KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **영국 (LSE)** → `yahoo` · `yfinance` · `local` *(명시된 GBP/GBp 호가만 허용)*-- **크립토** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **외환/귀금속** → `mt5` · `yfinance` · `akshare` · `local` · *(선물 / 펀드 / 매크로 → `tushare`/`akshare` → `local`)*+- **크립토** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **외환/귀금속** → `mt5` · `akshare` · `yfinance` · `local`+- **캐나다 / 베트남 / 아르헨티나 / 지수** → `yahoo` · `yfinance` · `local`+- **중국 선물** → `akshare` · `local` · **펀드** → `tushare` · `akshare` · `local` · **매크로** → `akshare` · `tushare` · `local`### Longbridge를 명시적으로 사용하기diff --git a/README_zh.md b/README_zh.mdindex a649b66b3..ab25eeded 100644--- a/README_zh.md+++ b/README_zh.md@@ -484,8 +484,10 @@ vibe-trading connector install /tmp/my-broker- **印度(NSE/BSE)** → `yahoo` · `yfinance` · `india_broker` · `local`- **韩国(KOSPI/KOSDAQ)** → `pykrx` · `yahoo` · `yfinance` · `local`- **英国(LSE)** → `yahoo` · `yfinance` · `local` *(仅接受明示为 GBP/GBp 的报价)*-- **加密** → `okx` · `ccxt` · `binance` · `yfinance` · `local`-- **外汇 / 贵金属** → `mt5` · `yfinance` · `akshare` · `local` · *(期货 / 基金 / 宏观 → `tushare`/`akshare` → `local`)*+- **加密** → `okx` · `binance` · `ccxt` · `yfinance` · `local`+- **外汇 / 贵金属** → `mt5` · `akshare` · `yfinance` · `local`+- **加拿大 / 越南 / 阿根廷 / 指数** → `yahoo` · `yfinance` · `local`+- **国内期货** → `akshare` · `local` · **基金** → `tushare` · `akshare` · `local` · **宏观** → `akshare` · `tushare` · `local`### 显式使用长桥diff --git a/agent/tests/test_readme_counts.py b/agent/tests/test_readme_counts.pyindex 6225e05fe..21d09c37e 100644--- a/agent/tests/test_readme_counts.py+++ b/agent/tests/test_readme_counts.py@@ -678,3 +678,44 @@ def test_repo_tree_states_the_real_engine_count(readme: str) -> None:f"{readme}: engines tree line says {match.group('count')}, "f"the code ships {_engine_count() - 1} plus the composite engine")+++# A fallback-chain bullet: "- **<label>** → `a` · `b` · …". The label is+# translated, so the chains are matched as sequences, not by market name.+_CHAIN_LINE_RE = re.compile(r"^- \*\*[^*\n]+\*\* → `")+_CHAIN_RUN_RE = re.compile(r"→ ((?:`[a-z0-9_]+`(?: · )?)+)")+++def _readme_chains(name: str) -> set[tuple[str, ...]]:+ """Return every fallback chain a README's bullet list writes out.++ Args:+ name: README file name relative to the repository root.++ Returns:+ Each chain as a tuple of source names, in the order written.+ """+ chains = set()+ for line in _read(name).splitlines():+ if _CHAIN_LINE_RE.match(line):+ for run in _CHAIN_RUN_RE.findall(line):+ chains.add(tuple(re.findall(r"`([a-z0-9_]+)`", run)))+ return chains++[email protected]("readme", READMES)+def test_fallback_chains_are_written_in_the_order_the_loader_walks(readme: str) -> None:+ """The bullet list is the order ``source: "auto"`` tries sources in.++ Crypto read okx · ccxt · binance and forex mt5 · yfinance · akshare for+ months while the loader walked binance before ccxt and akshare before+ yfinance. Checked both ways against the default chains: a written chain the+ loader never walks is wrong, and a chain the loader walks that no bullet+ shows is missing.+ """+ from backtest.loaders.registry import _DEFAULT_CHAINS++ code = {tuple(chain) for chain in _DEFAULT_CHAINS.values()}+ written = _readme_chains(readme)+ assert not written - code, f"{readme}: chains the loader does not walk: {sorted(written - code)}"+ assert not code - written, f"{readme}: chains the loader walks but the README omits: {sorted(code - written)}"