fix: support python 3.9 installs

Author: yjw

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.17] - 2026-06-14
+
+### Fixed
+- Lowered package metadata to Python 3.9+ after verifying the source compiles on Python 3.9, so macOS system `pip3 install young-stock-cli` no longer rejects every release as Python 3.10-only.
+- `young update` now prints a concrete Python-version and `python3 -m pip` retry hint when pip fails.
+- Removed Python 3.10-only `zip(strict=False)` calls so fund-flow parsing works under Python 3.9.
+
+### Changed
+- Install docs now prefer `python3 -m pip install young-stock-cli` and CI covers Python 3.9.
+- `young diagnose --json` now prints read-only machine-readable support diagnostics, and tests cover every top-level command's `--help`.
+
 ## [0.1.16] - 2026-06-04
 
 ### Changed

CONTRIBUTING.md

@@ -7,7 +7,7 @@ Thanks for considering a contribution! This project welcomes pull requests, bug
 ```bash
 git clone https://github.com/AdvancingTitans/young-stock-cli.git
 cd young-stock-cli
-pip install -e ".[dev]"
+python3 -m pip install -e ".[dev]"
 pytest
 ruff check .
 ```

README.md

@@ -18,10 +18,18 @@ Born out of a real workflow: every trading day after close I wanted the same fiv
 ## Install
 
 ```bash
-pip install young-stock-cli
+python3 -m pip install young-stock-cli
 ```
 
-Requires Python 3.10+.
+Requires Python 3.9+.
+
+If `pip3 install young-stock-cli` reports that every release requires a different Python version, your
+`pip3` is attached to an older Python. Check with `python3 --version`, then install or upgrade with a
+Python 3.9+ interpreter:
+
+```bash
+python3 -m pip install --upgrade young-stock-cli
+```
 
 ## Usage
 
@@ -46,6 +54,7 @@ young daily --format full         # full personalized daily report
 young daily --only 基金,A股 --quick
 young news 3690.HK      # multi-source news only
 young diagnose          # network/source diagnostic
+young diagnose --json   # machine-readable support diagnostic
 young note add "today I reduced chasing"
 young alert create 600519 "涨跌幅>5%"
 young stock AAPL --no-news
@@ -94,7 +103,7 @@ The internals are being split into focused modules: `young_stock.calendar` handl
 - **Short report modes** — `young daily --format summary` keeps terminal output compact; `--format key-points` adds a few trend/risk bullets; `--only`, `--order`, and `--quick` trim slower or irrelevant sections.
 - **Investment memory management** — list, remove, clear, and group saved stocks/funds with `young profile list`, `remove-stock`, `remove-fund`, `clear`, `clear-stocks`, `clear-funds`, and `profile group create/add`.
 - **Local workflow helpers** — lightweight `portfolio`, `alert`, `note`, and `diary` commands store local records for portfolio experiments, reminder rules, investment notes, and saved daily-report text.
-- **Diagnostics** — `young diagnose` summarizes recent source health and suggests cache/quick-mode fallbacks when public APIs are unstable.
+- **Diagnostics** — `young diagnose` summarizes recent source health and suggests cache/quick-mode fallbacks when public APIs are unstable; `young diagnose --json` prints read-only, machine-readable support info with Python/version/path/source-health details.
 - **Single-stock news** — `young news 3690.HK` prints only the news/momentum view, with each item showing source and link status.
 - **Smart caching** — `~/.young_stock/cache/`, 7-day TTL, auto-pruned. Pass `--refresh` to skip.
 - **Trade-day awareness** — nearest-trade-day resolution including weekends and (best-effort) holidays.
@@ -123,7 +132,7 @@ print(get_zt_pool(date))
 ```bash
 git clone https://github.com/AdvancingTitans/young-stock-cli.git
 cd young-stock-cli
-pip install -e ".[dev]"
+python3 -m pip install -e ".[dev]"
 pytest
 ruff check .
 ```
@@ -148,7 +157,7 @@ MIT — see [LICENSE](LICENSE).
 A 股盘后行情命令行工具。免登录、免 API key、免反爬技巧 — 一行命令把当日涨跌、涨停板、可核验的 A 股资金流向、板块榜全部打到终端。同时支持港股、美股指数和全球快照视图。
 
 ```bash
-pip install young-stock-cli
+python3 -m pip install young-stock-cli
 young a            # A 股盘后总览（主命令）
 young a --no-news  # 只看 A 股行情与情绪，跳过新闻
 young stock 600519 # 单只股票速览（A股 / 港股 / 美股）

docs/promo-copy.md

@@ -1,6 +1,6 @@
 # 推广文案 — young-stock-cli
 
-发布时机建议：v0.1.0 在 PyPI 上线后再发，文案里的 `pip install` 才有效。
+发布时机建议：v0.1.0 在 PyPI 上线后再发，文案里的 `python3 -m pip install` 才有效。
 
 ---
 
@@ -16,7 +16,7 @@
 每天 15:01 都要刷一遍上证、深成指、创业板、涨停板、北向资金…开网页太慢，付费终端没必要，干脆自己写了个命令行。
 
 ```
-pip install young-stock-cli
+python3 -m pip install young-stock-cli
 young a
 ```
 
@@ -53,7 +53,7 @@ GitHub: github.com/AdvancingTitans/young-stock-cli
 每天盘后想看的几个数据：四大指数、涨停板数 / 连板天梯、北向资金、板块热点。开 5 个网页太慢，akshare 装一次拖 200MB 依赖，tushare 要 token 还限流。一气之下自己撸。
 
 ### 设计目标
-1. `pip install` 装完就能用，无需任何账号配置
+1. `python3 -m pip install` 装完就能用，无需任何账号配置
 2. 三个运行时依赖：`requests` + `click` + `rich`
 3. 数据源单一可控：东方财富公开行情接口
 4. 输出对终端友好：rich Table，深浅色都好看
@@ -85,7 +85,7 @@ github.com/AdvancingTitans/young-stock-cli — 欢迎 star。
 **正文**：
 
 ```
-pip install young-stock-cli
+python3 -m pip install young-stock-cli
 young a            # A 股盘后总览
 young zt-pool      # 涨停 / 跌停 / 炸板分析
 young flow         # 北向资金 + 主力资金

pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "young-stock-cli"
-version = "0.1.16"
+version = "0.1.17"
 description = "A-share (China stock market) after-hours CLI — no login, no scraping tricks, just data."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.9"
 license = { text = "MIT" }
 authors = [{ name = "AdvancingTitans" }]
 keywords = ["stock", "a-share", "china", "finance", "cli", "eastmoney"]
@@ -19,6 +19,7 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -51,7 +52,7 @@ packages = ["src/young_stock"]
 
 [tool.ruff]
 line-length = 110
-target-version = "py310"
+target-version = "py39"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "B", "UP"]

src/young_stock/__init__.py

@@ -1,3 +1,3 @@
 """young-stock-cli: A-share after-hours CLI."""
 
-__version__ = "0.1.16"
+__version__ = "0.1.17"

src/young_stock/_core.py

@@ -762,7 +762,7 @@ def fetch_sina_sector_money_flow_snapshot(date_str: str) -> dict[str, str]:
     xml = str(data.get("xml") or "")
     labels = re.findall(r"<category label='([^']+)'", xml)
     values = [_safe_float(v) for v in re.findall(r"<set value='([^']+)'", xml)]
-    pairs = [(label, value) for label, value in zip(labels, values, strict=False) if value is not None]
+    pairs = [(label, value) for label, value in zip(labels, values) if value is not None]
     if not pairs:
         diag("Sina sector money-flow snapshot: empty sector values")
         return {}
@@ -1750,7 +1750,7 @@ def get_fund_flow(date_str: str, *, strict_date: bool = True) -> dict[str, str]:
         if klines:
             for row in klines:
                 vals = row.split(",")
-                result = dict(zip(FUND_FLOW_COLS, vals, strict=False))
+                result = dict(zip(FUND_FLOW_COLS, vals))
                 result["_source"] = display_source
                 result["_scope"] = "A股"
                 if latest_result is None:
@@ -1784,7 +1784,7 @@ def get_fund_flow(date_str: str, *, strict_date: bool = True) -> dict[str, str]:
         if klines:
             for row in klines:
                 vals = row.split(",")
-                result = dict(zip(FUND_FLOW_COLS, vals, strict=False))
+                result = dict(zip(FUND_FLOW_COLS, vals))
                 result["_source"] = "东财历史日线资金流"
                 result["_scope"] = "A股"
                 if latest_result is None:

src/young_stock/cli.py

@@ -1,14 +1,16 @@
 """young-stock-cli command line interface."""
 from __future__ import annotations
 
+import json
+import platform
 import subprocess
 import sys
 from datetime import datetime
 
 import click
 
 from . import __version__, _core
-from .local_store import load_store, now_label, save_store
+from .local_store import load_store, now_label, save_store, young_home
 from .profile import (
     add_group,
     add_group_item,
@@ -107,7 +109,12 @@ def update(pre: bool, user_install: bool) -> None:
     click.echo("Running: " + " ".join(cmd))
     result = subprocess.run(cmd, check=False)
     if result.returncode != 0:
-        raise click.ClickException(f"update failed with exit code {result.returncode}")
+        raise click.ClickException(
+            "update failed with exit code "
+            f"{result.returncode}. young-stock-cli requires Python 3.9+. "
+            "Check `python3 --version`, then retry with "
+            "`python3 -m pip install --upgrade young-stock-cli`."
+        )
 
 
 @cli.command(help="Uninstall young-stock-cli from the current Python environment.")
@@ -364,10 +371,42 @@ def profile_group_add(name: str, code: str) -> None:
     click.echo(f"Added {code} to group: {name}")
 
 
+def _diagnostic_payload() -> dict:
+    sources = []
+    for name in ["eastmoney", "sina", "tencent", "ths", "futu"]:
+        snap = _core.SOURCE_HEALTH.snapshot(name)
+        sources.append({
+            "name": name,
+            "success_rate": snap.success_rate,
+            "average_latency_ms": snap.average_latency_ms,
+            "should_skip": snap.should_skip,
+        })
+    return {
+        "command": "young diagnose",
+        "version": __version__,
+        "python": {
+            "version": platform.python_version(),
+            "executable": sys.executable,
+        },
+        "paths": {
+            "profile": str(profile_path()),
+            "home": str(young_home()),
+            "cache": str(_core.CACHE_DIR),
+        },
+        "sources": sources,
+        "read_only": True,
+    }
+
+
 @cli.command(help="Run a lightweight network/source diagnostic.")
-def diagnose() -> None:
+@click.option("--json", "as_json", is_flag=True, help="Print machine-readable diagnostics.")
+def diagnose(as_json: bool) -> None:
+    if as_json:
+        click.echo(json.dumps(_diagnostic_payload(), ensure_ascii=False, indent=2))
+        return
     click.echo("# 网络诊断")
-    for name in ["eastmoney", "sina", "tencent", "ths", "futu"]:
+    for source in _diagnostic_payload()["sources"]:
+        name = source["name"]
         snap = _core.SOURCE_HEALTH.snapshot(name)
         state = "建议暂缓使用" if snap.should_skip else "可用/未发现近期异常"
         click.echo(f"{name}: 成功率 {snap.success_rate:.0%}, 平均延迟 {snap.average_latency_ms:.0f}ms, {state}")

tests/test_cli.py

@@ -1,3 +1,4 @@
+import json
 import sys
 from types import SimpleNamespace
 
@@ -67,6 +68,22 @@ def test_cli_subcommands_registered():
         assert sub in result.output, f"subcommand `{sub}` missing from help"
 
 
+def test_cli_top_level_command_help_is_available():
+    from click.testing import CliRunner
+
+    runner = CliRunner()
+    commands = [
+        "a", "hk", "us", "global", "indices", "zt-pool", "flow", "stock", "fund", "news",
+        "daily", "profile", "portfolio", "alert", "note", "diary", "diagnose", "guide", "example",
+        "cache-clear", "update", "uninstall",
+    ]
+
+    for command in commands:
+        result = runner.invoke(cli, [command, "--help"])
+        assert result.exit_code == 0, f"{command} --help failed: {result.output}"
+        assert "Usage:" in result.output
+
+
 def test_cli_stock_runs_single_stock_quote(monkeypatch):
     from click.testing import CliRunner
 
@@ -187,6 +204,22 @@ def fake_run(cmd, check):
     )]
 
 
+def test_cli_update_failure_mentions_python_version(monkeypatch):
+    from click.testing import CliRunner
+
+    def fake_run(cmd, check):
+        return SimpleNamespace(returncode=1)
+
+    monkeypatch.setattr(cli_module.subprocess, "run", fake_run)
+
+    runner = CliRunner()
+    result = runner.invoke(cli, ["update"])
+
+    assert result.exit_code != 0
+    assert "Python 3.9+" in result.output
+    assert "python3 -m pip install --upgrade young-stock-cli" in result.output
+
+
 def test_cli_uninstall_runs_pip_uninstall(monkeypatch):
     from click.testing import CliRunner
 
@@ -403,3 +436,28 @@ def test_cli_diagnose_outputs_network_guidance(monkeypatch):
     assert result.exit_code == 0
     assert "网络诊断" in result.output
     assert "建议" in result.output
+
+
+def test_cli_diagnose_json_outputs_machine_readable_support_info(monkeypatch, tmp_path):
+    from click.testing import CliRunner
+
+    monkeypatch.setenv("YOUNG_STOCK_PROFILE", str(tmp_path / "profile.json"))
+    monkeypatch.setenv("YOUNG_STOCK_HOME", str(tmp_path / "home"))
+    monkeypatch.setattr(
+        cli_module._core,
+        "SOURCE_HEALTH",
+        SimpleNamespace(snapshot=lambda name: SimpleNamespace(success_rate=1.0, average_latency_ms=0.0, should_skip=False)),
+    )
+
+    result = CliRunner().invoke(cli, ["diagnose", "--json"])
+
+    assert result.exit_code == 0
+    payload = json.loads(result.output)
+    assert payload["command"] == "young diagnose"
+    assert payload["version"] == __version__
+    assert payload["python"]["executable"] == sys.executable
+    assert payload["paths"]["profile"].endswith("profile.json")
+    assert payload["paths"]["home"].endswith("home")
+    assert payload["paths"]["cache"]
+    assert payload["read_only"] is True
+    assert {source["name"] for source in payload["sources"]} >= {"eastmoney", "sina", "tencent", "ths", "futu"}