Metadata-Version: 2.4
Name: jing
Version: 0.3.14
Summary: Download stock data and perform data analisys
Author-email: sai <dawangfei@gmail.com>
License: MIT
Keywords: jing,sai,stock
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: pandas
Requires-Dist: baostock
Requires-Dist: yfinance
Requires-Dist: akshare
Requires-Dist: pyarrow
Requires-Dist: cos-python-sdk-v5
Requires-Dist: importlib-metadata; python_version < "3.10"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"

# jing

`jing` 用于下载和整理股票行情数据。下面以中国 A 股和 BaoStock 为例。

## 安装

```bash
pip install jing
```

## 下载 CN 行情

BaoStock 是 CN 的默认数据源，代码需带交易所前缀：

```python
import jing

d = jing.D("cn")
d.download("sz.000807")  # 下载单只股票
d.download()             # 按列表批量下载，默认断点续传
```

批量下载列表默认位于 `~/data/jing/list/cn_baostock.txt`。首次使用时会从安装包复制默认列表；可直接编辑该文件维护股票代码。

## 文件位置

默认数据目录是 `~/data/jing`：

```text
~/data/jing/
├── list/cn_baostock.txt
└── raw/baostock/cn/sz.000807.csv
```

可用环境变量统一更改目录：

```bash
export JING_DATA=/data/stocks
```

也可在 Python 中设置：

```python
from jing.data_paths import set_data_root

set_data_root("/data/stocks")
```

更改后，列表和行情文件分别放在 `/data/stocks/list/` 与 `/data/stocks/raw/baostock/cn/`。

## 上传到腾讯云 COS

先在 `~/.cos.yaml` 配置 COS 凭证、地域和存储桶，再运行：

```bash
python -m jing.uploader_cos cn
```
