ashareapi 0.1.3__tar.gz → 0.1.4__tar.gz

{ashareapi-0.1.3 → ashareapi-0.1.4}/CHANGELOG.md

@@ -7,6 +7,24 @@
 
 ---
 
+## [0.1.4] — 2026-09-26
+
+### 修复
+- **`finance()` 返回值退化**：`/v1/finance` 的 `data` 是**表列表**
+  （`[[利润表行], [资产负债表行], [现金流量表行]]`），旧实现把它套成
+  `pd.DataFrame([[{...}], [{...}], [{...}]])` → **退化的 3×1「单元格里是 list」**，不可用。
+  现改为**原样返回表列表**（`list[list[dict]]`，对齐 JS SDK 的 `Row[][]`）。
+- **多段结构原样返回**：`shareholder()` / `calendar()` 的 `data` 是 `{tables, data}` 多段对象
+  → 原样返回该 dict（行为未变，本轮补文档与测试锁定）。
+- **User-Agent 版本漂移**：`client.py` 的 `__version__` 曾是 `0.1.0`（包已是 `0.1.3`）
+  → **UA 报的是旧版本**。现版本号**单一事实源**在 `client.py`，`__init__.py` 从它 re-export。
+
+### 测试
+- 新增 `test_frame_table_list_not_wrapped`（表列表**不套** DataFrame）
+- 新增 `test_frame_sectioned_dict_passthrough`（多段 dict 原样返回）
+
+---
+
 ## [0.1.3] — 2026-09-23
 
 ### 变更

{ashareapi-0.1.3 → ashareapi-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ashareapi
-Version: 0.1.3
+Version: 0.1.4
 Summary: A股数据 API 官方 Python SDK —— 行情 / K线 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股（含 MCP）
 Author: ashareapi
 License-Expression: MIT

{ashareapi-0.1.3 → ashareapi-0.1.4}/ashareapi/__init__.py

@@ -9,10 +9,9 @@
 
 文档：https://ashareapi.com/docs  ·  端点清单：https://ashareapi.com/endpoints
 """
-from .client import AShareAPI
+from .client import AShareAPI, __version__
 from .errors import (AShareError, APIError, AuthError, EmptyResultError, RateLimitError,
                      UpstreamError)
 
-__version__ = "0.1.3"
 __all__ = ["AShareAPI", "AShareError", "AuthError", "RateLimitError", "EmptyResultError",
            "UpstreamError", "APIError", "__version__"]

{ashareapi-0.1.3 → ashareapi-0.1.4}/ashareapi/client.py

@@ -9,7 +9,9 @@ import requests
 from ._code import normalize_code
 from .errors import APIError, AuthError, EmptyResultError, RateLimitError, UpstreamError
 
-__version__ = "0.1.0"
+# ⚠️ 版本**单一事实源**（`__init__.py` 从这里 re-export；`_request` 的 User-Agent 也用它）
+#    2026-09-26 修正：此前这里是 `0.1.0`（包已 0.1.3）→ **UA 报的是 0.1.0**，版本漂移。
+__version__ = "0.1.4"
 
 DEFAULT_BASE = "https://api.ashareapi.com"
 FREE_ENDPOINTS = (
@@ -89,6 +91,15 @@ class AShareAPI:
 
         2026-09-23 实测：部分端点 ``data`` 直接是数组，部分是 Markdown 但都带 **``structured``**
         结构化数组 → 这里**零 Markdown 解析** ✓
+
+        ⚠️ **2026-09-26 修正 —— 三种返回形态，不能一律套 DataFrame**：
+          · 单表（多数端点）→ ``DataFrame``（未装 pandas → ``list[dict]``）
+          · **表列表**（``/v1/finance``：``[[利润表行],[资产负债行],[现金流行]]``）
+            → 返回**列表**（``list[list[dict]]``，对齐 JS SDK 的 ``Row[][]``）。
+            旧实现会 ``pd.DataFrame([[{...}],[{...}],[{...}]])`` → **退化的 3×1「单元格里是 list」**，
+            不是可用结果（2026-09-26 实测确认）。
+          · **多段结构**（``/v1/shareholder``、``/v1/calendar``：``{tables, data}``）
+            → 原样返回该 dict（与 JS SDK 一致）。
         """
         if self.raw:
             return body
@@ -97,6 +108,9 @@ class AShareAPI:
             rows = body["data"]
         if rows is None:
             return body.get("data", body)      # 无表格字段（health / challenge / usage）→ 返回整个信封
+        # ⭐ 表列表（首元素是 list）→ 不套 DataFrame（套了就是退化的 3×1 单元格为 list）
+        if rows and isinstance(rows[0], list):
+            return rows                        # list[list[dict]]，对齐 JS SDK 的 Row[][]
         try:
             import pandas as pd
             return pd.DataFrame(rows)

{ashareapi-0.1.3 → ashareapi-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ashareapi"
-version = "0.1.3"
+version = "0.1.4"
 description = "A股数据 API 官方 Python SDK —— 行情 / K线 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股（含 MCP）"
 readme = "README.md"
 requires-python = ">=3.9"

{ashareapi-0.1.3 → ashareapi-0.1.4}/tests/test_convert.py

@@ -49,6 +49,27 @@ def test_frame_non_table_passthrough():
     assert cli._frame({"ok": True, "data": {"k": "v"}}) == {"k": "v"}
 
 
+def test_frame_table_list_not_wrapped():
+    """表列表（/v1/finance）→ 原样返回 list[list[dict]]，**不套 DataFrame**
+
+    旧实现会 pd.DataFrame([[{...}],[{...}],[{...}]]) → 退化的 3×1「单元格里是 list」。
+    """
+    cli = AShareAPI()
+    tabs = [[{"EndDate": "2026-06-30", "OperatingRevenue": 1}],
+            [{"EndDate": "2026-06-30", "TotalAssets": 2}]]
+    r = cli._frame({"ok": True, "data": tabs})
+    assert r == tabs
+    assert isinstance(r[0], list)          # 仍是表列表，不是 DataFrame
+
+
+def test_frame_sectioned_dict_passthrough():
+    """多段结构（/v1/shareholder、/v1/calendar）→ 原样返回 dict（含 tables/data）"""
+    cli = AShareAPI()
+    sec = {"tables": [{"title": "十大股东", "slug": "top10_holders", "rows": [{"name": "A"}]}],
+           "data": {"top10_holders": [{"name": "A"}]}}
+    assert cli._frame({"ok": True, "data": sec}) == sec
+
+
 def test_raw_mode_returns_envelope():
     cli = AShareAPI(raw=True)
     b = {"ok": True, "data": [{"x": 1}], "elapsed_ms": 12}