Metadata-Version: 2.5
Name: maoxianyong
Version: 0.1.7
Summary: Unified stock data infrastructure for A-share, HK and US markets
Project-URL: Repository, https://github.com/jackmaoxianyong/quant.maoxianyong.com
License: MIT
Keywords: finance,quant,stock
Requires-Python: >=3.11
Requires-Dist: duckdb>=1.5.3
Requires-Dist: pandas>=3.0.2
Description-Content-Type: text/markdown

# maoxianyong

A 股、港股和美股统一行情数据的只读 Python 包。

```python
from maoxianyong.quant import StockReader

reader = StockReader()
history = reader.get("AAPL.US", start="2024-01-01")
```

该包默认从阿里云 OSS 读取 Parquet 数据；本地 ETL 与分析工具位于仓库的 `pipelines/stock/`。

## 发布

在仓库根目录执行发布脚本。默认升级补丁版本，随后构建、隔离验证并上传到 PyPI：

```bash
scripts/publish_maoxianyong.sh
```

也可以指定版本升级类型：

```bash
scripts/publish_maoxianyong.sh minor
scripts/publish_maoxianyong.sh major
```

如果上传失败但版本号已经升级，使用当前版本重试，避免再次增加版本号：

```bash
scripts/publish_maoxianyong.sh current
```

脚本会在发布前请求确认，并隐蔽读取以 `pypi-` 开头的 PyPI API Token。脚本不会自动提交 Git。
