saqds 1.9.5__tar.gz

saqds-1.9.5/.gitignore

@@ -0,0 +1,41 @@
+# 本地环境配置（含密钥，勿提交）
+.env
+.env.*
+!.env.example
+
+# Python 缓存与编译产物
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+
+# uv 虚拟环境
+.venv/
+venv/
+
+# 构建 / 打包产物
+build/
+dist/
+*.build-cache/
+
+# 测试与覆盖率
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# 类型检查缓存
+.ty/
+
+# mkdocs 构建产物
+docs/site/
+
+# 运行期数据 / 日志
+*.log
+ray_workspace/
+
+# 系统与编辑器
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

saqds-1.9.5/LICENSE.txt

@@ -0,0 +1,3 @@
+序衍量化 版权所有
+本项目全部源代码、脚本、算法、绘图组件著作权归属远和资产。
+仅公司内部授权人员可在企业设备、服务器内使用，未经书面许可禁止复制、分发、商用、对外交付。

saqds-1.9.5/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.5
+Name: saqds
+Version: 1.9.5
+Summary: Quant core toolkit: A股行情(SAOIDC密钥鉴权直连ClickHouse)+VNPY数据接口、数学/统计指标、公式可视化绘图、CLI工具、Ray分布式批量任务
+Project-URL: Homepage, https://gitlab.dc3.everonquant.net/foundation/python/core
+Author-email: SequArc 序衍 <dev@sequarc.tech>
+License: 序衍量化 版权所有，未经书面许可禁止外部分发/商用
+License-File: LICENSE.txt
+Requires-Python: >=3.10
+Requires-Dist: akshare
+Requires-Dist: click>=8.3.2
+Requires-Dist: clickhouse-connect>=0.8
+Requires-Dist: matplotlib>=3.8
+Requires-Dist: numpy>=1.26
+Requires-Dist: pandas>=2.0
+Requires-Dist: ray[default]>=2.55.1
+Requires-Dist: vnpy[no-gui]>=4.4.0
+Description-Content-Type: text/markdown
+
+# Saqds Quant Toolkit
+序衍量化内部量化核心工具库
+> Version: v1.7.5 | Python >=3.10 | Package Manager: uv
+
+## 项目简介
+一套面向投研的轻量化量化底层工具集：
+- 📈 行情接口：Akshare A股日线封装，兼容VNPY数据接口
+- 🧮 数值工具：基础数学函数、量化统计指标
+- 📊 可视化：服务端无GUI环境一元数学公式绘图
+- 💻 命令行：内置CLI工具，快速计算
+- ⚡ 分布式：基于Ray实现多标的批量并发任务
+
+> 【版权说明】序衍量化专有代码，未经书面许可禁止外部分发、商用。
+
+## 目录结构
+```
+./
+├── docs/                     # mkdocs 文档站
+├── scripts/                  # 独立运行脚本（调试/演示/分布式任务）
+├── specs/                    # 技术设计文档（Spec）
+├── src/saqds/                # 核心源码包（可import导入）
+├── tests/                    # 单元测试用例
+├── CHANGELOG.md              # 版本变更记录
+├── Dockerfile                # 容器部署文件
+├── LICENSE.txt               # 版权声明
+├── Makefile                  # 工程运维（对齐 saqds 平台模版）
+├── pyproject.toml            # uv项目配置、依赖、工具链
+├── README.md
+├── .env.example              # 环境配置模板（复制为 .env 填写）
+└── uv.lock                   # 依赖锁文件，保障环境一致性
+```
+
+## uv 包管理器安装（国内服务器）
+> ⚠️ 请勿执行 `apt install uv`，Ubuntu官方软件源不包含uv
+
+### 方式1｜二进制部署（生产服务器推荐）
+```bash
+# 版本与架构按需调整：x86_64-unknown-linux-gnu / aarch64-unknown-linux-gnu / armv7-unknown-linux-gnueabihf
+VER=0.11.31
+ARCH=armv7-unknown-linux-gnueabihf
+
+# ghproxy国内加速下载
+wget https://ghproxy.com/https://github.com/astral-sh/uv/releases/download/$VER/uv-$ARCH.tar.gz
+
+# 解压并全局安装
+tar -xf uv-$ARCH.tar.gz
+sudo mv uv uvx /usr/local/bin/
+rm -rf uv-$ARCH.tar.gz
+
+# 写入全局配置：清华PyPI源
+mkdir -p ~/.config/uv
+cat > ~/.config/uv/uv.toml <<'EOF'
+[[index]]
+url = "https://pypi.tuna.tsinghua.edu.cn/simple"
+default = true
+EOF
+
+# 校验安装
+uv --version
+```
+
+### 方式2｜官方脚本快速安装（外网畅通环境）
+```bash
+curl -LsSf https://astral.org.cn/uv/install.sh | sh
+source $HOME/.cargo/env
+# 配置国内源
+uv config set index-url https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+## 环境准备
+### 1. 初始化虚拟环境
+```bash
+# 拉取全部依赖（包含开发工具）
+uv sync --group dev
+# 激活虚拟环境(Linux/macOS)
+source .venv/bin/activate
+```
+
+### 2. 代码质量与静态检查
+```bash
+# 自动修复代码规范
+uv run ruff check src tests --fix
+# 统一格式化
+uv run ruff format src tests
+# 静态类型校验
+uv run ty check src
+```
+
+### 3. 执行单元测试
+```bash
+# 运行测试并开启覆盖率门禁(阈值80%)
+uv run pytest
+# 生成HTML覆盖率可视化报告
+uv run pytest --cov-report=html:htmlcov
+```
+
+## 使用示例
+### 1. 作为Python包导入
+```python
+import saqds
+
+# 获取A股日线数据（纯数字代码，不带.SH/.SZ，SAOIDC 密钥鉴权后直连 ClickHouse）
+df = saqds.get_stock_hist("600519", "20260101", "20260716")
+# 数学计算
+sq_sum = saqds.sum_of_squares([1, 2, 3])
+avg = saqds.mean([2, 4, 6])
+# 公式绘图
+img_path = saqds.plot_custom_formula("x**2 - 4*x")
+```
+
+### 2. 命令行工具（平方和计算）
+```bash
+# 普通正数
+uv run saqds 1 2 3 4
+# 传入负数，必须使用 -- 分隔符
+uv run saqds -- -1 2.5
+```
+
+### 3. 执行scripts下独立脚本
+```bash
+# 交互式自定义公式绘图
+uv run python scripts/draw_formula.py
+```
+
+## Ray分布式说明
+- 支持单机本地集群，同时兼容远程Ray集群；
+- 通过环境变量 `RAY_ADDRESS` 指定集群地址接入多机集群；
+- 任务内部自动配置 `PYTHONPATH`，保证容器/服务器环境导入正常。
+
+## 容器构建与运行
+```bash
+# 构建镜像
+docker build -t saqds-quant:v1.7.5 .
+# 默认执行 saqds CLI（--help）
+docker run --rm saqds-quant:v1.7.5
+# 自定义执行：平方和计算
+docker run --rm saqds-quant:v1.7.5 uv run saqds 1 2 3 4
+```
+
+## 开发规范
+1. 新增核心函数在 `src/saqds/` 对应模块实现，并在 `__init__.py` 按需导出；
+2. 新增API必须配套 `tests/` 单元测试，IO/网络相关使用mock隔离外部依赖；
+3. scripts仅作为可执行入口，不承载业务核心逻辑；
+4. 版本迭代变更写入 `CHANGELOG.md`，遵循 Keep a Changelog 格式。
+
+## 联系方式
+作者: SequArc(序衍量化)

saqds-1.9.5/README.md

@@ -0,0 +1,147 @@
+# Saqds Quant Toolkit
+序衍量化内部量化核心工具库
+> Version: v1.7.5 | Python >=3.10 | Package Manager: uv
+
+## 项目简介
+一套面向投研的轻量化量化底层工具集：
+- 📈 行情接口：Akshare A股日线封装，兼容VNPY数据接口
+- 🧮 数值工具：基础数学函数、量化统计指标
+- 📊 可视化：服务端无GUI环境一元数学公式绘图
+- 💻 命令行：内置CLI工具，快速计算
+- ⚡ 分布式：基于Ray实现多标的批量并发任务
+
+> 【版权说明】序衍量化专有代码，未经书面许可禁止外部分发、商用。
+
+## 目录结构
+```
+./
+├── docs/                     # mkdocs 文档站
+├── scripts/                  # 独立运行脚本（调试/演示/分布式任务）
+├── specs/                    # 技术设计文档（Spec）
+├── src/saqds/                # 核心源码包（可import导入）
+├── tests/                    # 单元测试用例
+├── CHANGELOG.md              # 版本变更记录
+├── Dockerfile                # 容器部署文件
+├── LICENSE.txt               # 版权声明
+├── Makefile                  # 工程运维（对齐 saqds 平台模版）
+├── pyproject.toml            # uv项目配置、依赖、工具链
+├── README.md
+├── .env.example              # 环境配置模板（复制为 .env 填写）
+└── uv.lock                   # 依赖锁文件，保障环境一致性
+```
+
+## uv 包管理器安装（国内服务器）
+> ⚠️ 请勿执行 `apt install uv`，Ubuntu官方软件源不包含uv
+
+### 方式1｜二进制部署（生产服务器推荐）
+```bash
+# 版本与架构按需调整：x86_64-unknown-linux-gnu / aarch64-unknown-linux-gnu / armv7-unknown-linux-gnueabihf
+VER=0.11.31
+ARCH=armv7-unknown-linux-gnueabihf
+
+# ghproxy国内加速下载
+wget https://ghproxy.com/https://github.com/astral-sh/uv/releases/download/$VER/uv-$ARCH.tar.gz
+
+# 解压并全局安装
+tar -xf uv-$ARCH.tar.gz
+sudo mv uv uvx /usr/local/bin/
+rm -rf uv-$ARCH.tar.gz
+
+# 写入全局配置：清华PyPI源
+mkdir -p ~/.config/uv
+cat > ~/.config/uv/uv.toml <<'EOF'
+[[index]]
+url = "https://pypi.tuna.tsinghua.edu.cn/simple"
+default = true
+EOF
+
+# 校验安装
+uv --version
+```
+
+### 方式2｜官方脚本快速安装（外网畅通环境）
+```bash
+curl -LsSf https://astral.org.cn/uv/install.sh | sh
+source $HOME/.cargo/env
+# 配置国内源
+uv config set index-url https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+## 环境准备
+### 1. 初始化虚拟环境
+```bash
+# 拉取全部依赖（包含开发工具）
+uv sync --group dev
+# 激活虚拟环境(Linux/macOS)
+source .venv/bin/activate
+```
+
+### 2. 代码质量与静态检查
+```bash
+# 自动修复代码规范
+uv run ruff check src tests --fix
+# 统一格式化
+uv run ruff format src tests
+# 静态类型校验
+uv run ty check src
+```
+
+### 3. 执行单元测试
+```bash
+# 运行测试并开启覆盖率门禁(阈值80%)
+uv run pytest
+# 生成HTML覆盖率可视化报告
+uv run pytest --cov-report=html:htmlcov
+```
+
+## 使用示例
+### 1. 作为Python包导入
+```python
+import saqds
+
+# 获取A股日线数据（纯数字代码，不带.SH/.SZ，SAOIDC 密钥鉴权后直连 ClickHouse）
+df = saqds.get_stock_hist("600519", "20260101", "20260716")
+# 数学计算
+sq_sum = saqds.sum_of_squares([1, 2, 3])
+avg = saqds.mean([2, 4, 6])
+# 公式绘图
+img_path = saqds.plot_custom_formula("x**2 - 4*x")
+```
+
+### 2. 命令行工具（平方和计算）
+```bash
+# 普通正数
+uv run saqds 1 2 3 4
+# 传入负数，必须使用 -- 分隔符
+uv run saqds -- -1 2.5
+```
+
+### 3. 执行scripts下独立脚本
+```bash
+# 交互式自定义公式绘图
+uv run python scripts/draw_formula.py
+```
+
+## Ray分布式说明
+- 支持单机本地集群，同时兼容远程Ray集群；
+- 通过环境变量 `RAY_ADDRESS` 指定集群地址接入多机集群；
+- 任务内部自动配置 `PYTHONPATH`，保证容器/服务器环境导入正常。
+
+## 容器构建与运行
+```bash
+# 构建镜像
+docker build -t saqds-quant:v1.7.5 .
+# 默认执行 saqds CLI（--help）
+docker run --rm saqds-quant:v1.7.5
+# 自定义执行：平方和计算
+docker run --rm saqds-quant:v1.7.5 uv run saqds 1 2 3 4
+```
+
+## 开发规范
+1. 新增核心函数在 `src/saqds/` 对应模块实现，并在 `__init__.py` 按需导出；
+2. 新增API必须配套 `tests/` 单元测试，IO/网络相关使用mock隔离外部依赖；
+3. scripts仅作为可执行入口，不承载业务核心逻辑；
+4. 版本迭代变更写入 `CHANGELOG.md`，遵循 Keep a Changelog 格式。
+
+## 联系方式
+作者: SequArc(序衍量化)

saqds-1.9.5/pyproject.toml

@@ -0,0 +1,101 @@
+[project]
+name = "saqds"
+version = "1.9.5"
+description = "Quant core toolkit: A股行情(SAOIDC密钥鉴权直连ClickHouse)+VNPY数据接口、数学/统计指标、公式可视化绘图、CLI工具、Ray分布式批量任务"
+readme = "README.md"
+# 企业闭源专有软件，非开源协议
+license = { text = "序衍量化 版权所有，未经书面许可禁止外部分发/商用" }
+authors = [
+  { name = "SequArc 序衍", email = "dev@sequarc.tech" },
+]
+requires-python = ">=3.10"
+dependencies = [
+  "click>=8.3.2",
+  "vnpy[no-gui]>=4.4.0",
+  "akshare",
+  "ray[default]>=2.55.1",
+  "numpy>=1.26",
+  "matplotlib>=3.8",
+  "clickhouse-connect>=0.8",  # 直连 ClickHouse（SAOIDC 密钥鉴权后取数）
+  "pandas>=2.0",              # DataFrame 处理
+]
+
+[project.urls]
+Homepage = "https://gitlab.dc3.everonquant.net/foundation/python/core"
+
+[project.scripts]
+# 全局CLI命令：uv run saqds
+saqds = "saqds.cli:main"
+
+[build-system]
+# uv_build 仅支持单个顶级模块；本包含 saqds，用 hatchling 显式声明
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/saqds"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/scripts"]
+
+[dependency-groups]
+# 本地开发、测试、代码规范、二进制打包依赖
+dev = [
+  "nuitka>=4.0.8",    # Python编译独立二进制程序
+  "ruff>=0.15.10",    # 代码格式化、静态lint
+  "ty>=0.0.29",       # 静态类型检查
+  "pytest>=7.0",      # 单元测试
+  "pytest-cov>=4.0",  # 代码覆盖率统计
+  "flask>=3.1.3",
+  "requests>=2.34.2",
+  "python-dotenv>=1.2.3",
+  "flask-cors>=6.0.5",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+exclude = [
+  ".git",
+  ".venv",
+  "build",
+  "dist",
+  "output",
+  "*.png"
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "C4", "UP", "N", "SIM", "RUF"]
+# E501：允许单行超过120字符（量化长公式/行情参数）
+# RUF001/RUF002/RUF003：允许中文字符串、docstring、中文标点不强制转义
+ignore = ["E501", "RUF001", "RUF002", "RUF003"]
+fixable = ["ALL"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
+
+[tool.ty.src]
+include = ["src"]
+exclude = ["tests/data", "build", "dist"]
+
+[tool.ty.rules]
+unresolved-import = "error"
+index-out-of-bounds = "warn"
+call-non-callable = "error"
+
+[tool.ty.environment]
+root = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+# 仅统计核心库src/saqds，覆盖率门槛80%
+addopts = "-v --cov=src/saqds --cov-report=term-missing --cov-fail-under=80"
+
+[tool.uv]
+
+[[tool.uv.index]]
+url = "https://pypi.tuna.tsinghua.edu.cn/simple"
+default = true

saqds-1.9.5/scripts/build-release-windows.bat

@@ -0,0 +1,82 @@
+@echo off
+rem ==============================================================================
+rem  saqds Windows one-click build & release | double-click to run
+rem
+rem  Flow: enumerate Python 3.10+ -> Nuitka onefile exe per version
+rem        -> uv build (wheel + sdist) -> optional twine publish to pypi.org
+rem
+rem  Edit the CONFIG section below before use if needed. Works as-is:
+rem    * auto-detects installed Python 3.10+ (falls back to 3.12, uv downloads it)
+rem    * reuses pyproject.toml version
+rem    * build only (no publish) unless SAQDS_PYPI_TOKEN is set
+rem ==============================================================================
+setlocal EnableExtensions
+
+cd /d "%~dp0.."
+
+rem ------------------------------------------------------------------------------
+rem  CONFIG (edit me)
+rem  SAQDS_PY_VERSIONS     comma list, e.g. 3.10,3.11,3.12 ; empty = auto-detect
+rem  SAQDS_VERSION         release version, e.g. 1.10.0 ; empty = keep pyproject.toml
+rem  SAQDS_PYPI_TOKEN      pypi.org API token (pypi-xxxx) ; empty = skip publish
+rem  SAQDS_PUBLISH_IF_TOKEN 1 = publish when token above present, 0 = never publish
+rem ------------------------------------------------------------------------------
+set "SAQDS_PY_VERSIONS="
+set "SAQDS_VERSION="
+set "SAQDS_PYPI_TOKEN="
+set "SAQDS_PUBLISH_IF_TOKEN=1"
+rem ------------------------------------------------------------------------------
+rem  END OF CONFIG - no need to change anything below
+rem ------------------------------------------------------------------------------
+
+echo.
+echo === [1/3] Check prerequisites (uv)
+where uv >nul 2>nul
+if errorlevel 1 (
+    echo [..] uv not found, installing via official script...
+    powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"
+    set "PATH=%USERPROFILE%\.local\bin;%PATH%"
+    where uv >nul 2>nul
+    if errorlevel 1 (
+        echo [X] uv install failed. Open a NEW terminal and re-run this file.
+        pause
+        exit /b 1
+    )
+)
+for /f "delims=" %%v in ('uv --version') do echo [OK] %%v
+
+rem ---- assemble powershell arguments from config ----
+set "PS1=%~dp0build-release-windows.ps1"
+set "ARGS="
+if defined SAQDS_PY_VERSIONS set "ARGS=%ARGS% -PyVersions %SAQDS_PY_VERSIONS%"
+if defined SAQDS_VERSION set "ARGS=%ARGS% -Version %SAQDS_VERSION%"
+
+if "%SAQDS_PUBLISH_IF_TOKEN%"=="0" goto nopublish
+if defined SAQDS_PYPI_TOKEN goto dopublish
+echo [i] No SAQDS_PYPI_TOKEN configured - BUILD ONLY (publish skipped)
+goto nopublish
+
+:dopublish
+set "PYPI_TOKEN=%SAQDS_PYPI_TOKEN%"
+set "ARGS=%ARGS% -Publish"
+echo [i] PyPI token found - publish to pypi.org ENABLED (confirm inside script)
+
+:nopublish
+echo.
+echo === [2/3] Build: multi-version exe + wheel/sdist
+echo Running: powershell -ExecutionPolicy Bypass -File %PS1%%ARGS%
+powershell -NoProfile -ExecutionPolicy Bypass -File "%PS1%"%ARGS%
+set "RC=%ERRORLEVEL%"
+
+echo.
+echo === [3/3] Result
+if not "%RC%"=="0" (
+    echo [X] Build finished with exit code %RC%. Review messages above.
+    pause
+    exit /b %RC%
+)
+echo [OK] Done. Artifacts in dist\: saqds-py3xx.exe / saqds.exe / saqds-<version> whl + tar.gz
+echo.
+echo   Verify: .\dist\saqds.exe --help
+pause
+exit /b 0