# 一次性配置
git config --global user.name  "Your Name"
git config --global user.email "you@example.com"

# 日常循环（99% 的时间只用这四条）
git status                      # 看哪些文件改了
git diff                        # 看具体改了什么
git add <文件>                  # 把改动加入暂存区
git commit -m "说明这次改了什么"  # 提交（形成历史快照）

# 同步到远端
git push

# 查看历史
git log --oneline -20
git log -p <文件>               # 看某文件的完整变更历史

# 撤销（重要）
git restore <文件>              # 丢弃未提交的修改
git restore --staged <文件>     # 取消暂存
git revert <commit>             # 生成一个"反向提交"（安全，推荐）

git checkout -b feat/table02-teae     # 新建并切到分支
# ... 写代码、提交 ...
git push -u origin feat/table02-teae  # 推到远端
# 在 GitHub 上开 Pull Request → 同事 review → 合并

"""tests/test_report.py —— 报表工具的单元测试"""
import numpy as np
import pandas as pd
import pytest

from clinic.report import pct_format, summarize_continuous
from clinic.derive import sas_round_series, derive_agegr1


class TestSasRound:
    """验证舍入规则与 SAS 一致（这是最容易出错的地方）"""

    @pytest.mark.parametrize("value,expected", [
        (2.5, 3.0), (1.5, 2.0), (0.5, 1.0), (-2.5, -3.0), (-1.5, -2.0),
        (2.4, 2.0), (2.6, 3.0),
    ])
    def test_round_half_away_from_zero(self, value, expected):
        """SAS 的 ROUND 是"四舍五入（远离零）"，而 Python 内置 round 是银行家舍入"""
        assert sas_round_series(pd.Series([value]), 0)[0] == expected

    def test_nearest_unit(self):
        """ROUND(x, 10) 应舍入到最近的 10"""
        assert sas_round_series(pd.Series([1234.0, 1235.0, 1236.0]), 0)[0] == 1234


class TestPctFormat:
    def test_zero_shows_zero(self):
        assert pct_format(0, 86) == "0"

    def test_basic(self):
        assert pct_format(26, 86) == "26 (30.2%)"

    def test_zero_denominator(self):
        assert pct_format(5, 0) == "-"

    def test_rounding(self):
        # 1/3 = 33.333...% → 33.3%
        assert pct_format(1, 3) == "1 (33.3%)"


class TestSummarizeContinuous:
    def test_uses_sample_sd(self):
        """SD 必须用 ddof=1，与 SAS 的 STD 一致"""
        s = pd.Series([63.0, 64.0, 71.0, 74.0, 55.0])
        res = summarize_continuous(s)
        assert res["n"] == 5
        assert res["sd"] == pytest.approx(round(s.std(ddof=1), 1))
        assert res["sd"] != pytest.approx(round(s.std(ddof=0), 1))


class TestAgeGr1:
    """★ 边界测试：这是分组派生最容易出错的地方"""

    @pytest.mark.parametrize("age,expected", [
        (64, "<65"),
        (65, "65-80"),      # 65 属于 65-80（左闭）
        (80, "65-80"),      # 80 属于 65-80（右闭）★ 最易错
        (81, ">80"),
        (51, "<65"),
        (89, ">80"),
    ])
    def test_boundaries(self, age, expected):
        df = pd.DataFrame({"AGE": [age]})
        assert derive_agegr1(df)["AGEGR1"].iloc[0] == expected

pip install pytest
pytest tests/ -v

# 导出当前环境的精确依赖
pip freeze > requirements.txt

# 更好的做法：区分直接依赖与传递依赖
pip install pip-tools
# requirements.in 里写你直接用的包
# requirements.txt 由 pip-compile 生成（含精确版本）
pip-compile requirements.in

name: tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.11", "3.12"]

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}
      - name: 安装依赖
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
      - name: 运行测试
        run: pytest tests/ -v
      - name: 运行案例脚本（冒烟测试）
        run: |
          python cases/case01_数据体检.py
          python cases/case02_人口学表.py