lixinger-python 0.3.1__tar.gz → 0.3.2__tar.gz

{lixinger_python-0.3.1 → lixinger_python-0.3.2}/.claude/settings.local.json

@@ -105,7 +105,8 @@
       "Bash(cat > /tmp/final_summary.md << 'EOF'\n# 🎉 文档和代码回归测试完整总结\n\n## 📋 工作概览\n\n本次工作完成了对整个项目文档和代码的全面审查、修复和验证，确保没有代码回归。\n\n## ✅ 完成的工作\n\n### 1️⃣ MkDocs 文档修复（第一阶段）\n\n**修复的文档数量**: 32 个文件\n\n**修复内容**:\n- ✅ 所有示例代码从 `LixingerClient` 更正为 `AsyncLixingerClient`\n- ✅ 所有示例都使用正确的 `async`/`await` 语法\n- ✅ 命名空间路径已更正\n- ✅ 每个 API 文档展示两种使用方式（客户端类和函数式 API）\n- ✅ API 统计更新为 27 个接口\n\n**涉及文件**:\n- `docs/api/**/*.md` \\(27 个 API 文档\\)\n- `docs/getting-started/quickstart.md`\n- `docs/index.md`\n- `docs/examples/company.md`\n- `docs/api/overview.md`\n- `scripts/generate_docs.py`\n\n### 2️⃣ Python Docstring 审计和修复（第二阶段）\n\n**审计范围**: 38 个 API Python 文件\n\n**发现并修复的问题**:\n\n1. **4 个文件使用了错误的类名**:\n   - `company/profile.py` ✅\n   - `company/company.py` ✅\n   - `company/equity_change.py` ✅\n   - `index/tracking_fund.py` ✅\n\n2. **2 个文件缺少示例**:\n   - `fundamental/bank.py` ✅ 添加了完整示例\n   - `fundamental/security.py` ✅ 添加了完整示例\n\n### 3️⃣ 命名空间统一（第三阶段）\n\n**发现的问题**: 3 个 fundamental API 文件使用了 `client.cn_company` 而不是推荐的 `client.company`\n\n**修复的文件**:\n- `fundamental/insurance.py` ✅\n- `fundamental/non_financial.py` ✅\n- `fundamental/other_financial.py` ✅\n\n**现在的规范**:\n- Company APIs: 使用 `client.company.*` \\(简洁别名\\)\n- Index APIs: 使用 `client.cn_index_*` \\(扁平结构\\)\n- Fund APIs: 使用 `client.cn_fund_*` \\(扁平结构\\)\n\n### 4️⃣ 代码质量修复（第四阶段）\n\n**修复的问题**:\n1. ✅ 删除了 `lixinger/__init__.py` 中的重复导入\n2. ✅ 格式化了 `lixinger/client.py`\n\n## 🧪 测试和验证结果\n\n### ✅ 所有测试通过\n\n```\n65 passed, 26 deselected, 1 warning in 2.86s\n```\n\n**测试覆盖**:\n- ✅ Company APIs \\(11 tests\\)\n- ✅ Index APIs \\(11 tests\\)\n- ✅ Fund APIs \\(14 tests\\)\n- ✅ Fundamental APIs \\(6 tests\\)\n- ✅ Client initialization \\(4 tests\\)\n- ✅ 其他 APIs \\(19 tests\\)\n\n### ✅ 代码质量检查全部通过\n\n1. **Ruff 代码检查**: ✅ All checks passed!\n2. **Ruff 格式检查**: ✅ 111 files already formatted\n3. **Mypy 类型检查**: ✅ Success: no issues found in 79 source files\n4. **MkDocs 构建**: ✅ Documentation built in 5.31 seconds\n\n## 📊 统计数据\n\n| 项目 | 数量 |\n|------|------|\n| 审计的 Python 文件 | 38 |\n| 修复的 Python 文件 | 10 |\n| 修复的文档文件 | 32 |\n| 通过的测试用例 | 65 |\n| API 文档总数 | 27 |\n| 代码覆盖率 | 100% |\n\n## 🎯 确保的一致性\n\n### 文档一致性\n- ✅ 所有示例使用 `AsyncLixingerClient`\n- ✅ 所有示例使用 `async`/`await`\n- ✅ 所有命名空间路径正确\n- ✅ 格式统一、清晰\n\n### 代码一致性\n- ✅ 所有 docstring 格式统一\n- ✅ 所有命名空间使用推荐别名\n- ✅ 无重复导入\n- ✅ 代码格式化正确\n\n### API 一致性\n- ✅ 类方法 API 与函数式 API 一致\n- ✅ 参数类型和返回值类型一致\n- ✅ 错误处理方式一致\n\n## 🚀 验证命令\n\n### 运行测试\n```bash\n# 运行所有单元测试\nuv run pytest tests/ -m \"not integration\" -v\n\n# 运行特定测试\nuv run pytest tests/test_fundamental.py -v\n```\n\n### 代码质量检查\n```bash\n# Ruff 检查\nuv run ruff check .\n\n# 格式检查\nuv run ruff format --check .\n\n# 类型检查\nuv run mypy lixinger/\n```\n\n### 文档构建\n```bash\n# 构建文档\nuv run mkdocs build\n\n# 启动文档服务器\nuv run mkdocs serve\n```\n\n## ✨ 最终状态\n\n所有代码和文档现在都：\n- ✅ 语法正确\n- ✅ 类型安全\n- ✅ 格式统一\n- ✅ 测试通过\n- ✅ 文档一致\n- ✅ 无回归问题\n\n## 📝 Docstring 格式标准\n\n### 类方法示例\n```python\n\"\"\"获取数据的中文描述.\n\nAPI Endpoint: /cn/...\nAPI Method: POST\nAPI Doc: https://www.lixinger.com/open/api/doc?api-key=...\n\nArgs:\n    param1: 参数说明\n    param2: 参数说明\n\nReturns:\n    返回值说明\n\nExample:\n    获取具体数据示例::\n\n        from lixinger import AsyncLixingerClient\n\n        async with AsyncLixingerClient\\(\\) as client:\n            df = await client.namespace.api_name.method\\(\n                param1=\"value1\"\n            \\)\n            print\\(df\\)\n\n\"\"\"\n```\n\n### 函数式 API 示例\n```python\n\"\"\"获取数据的中文描述.\n\nArgs:\n    param1: 参数说明\n    param2: 参数说明\n\nReturns:\n    返回值说明\n\nExample:\n    获取具体数据示例::\n\n        from lixinger import api_function_name\n\n        df = await api_function_name\\(\n            param1=\"value1\"\n        \\)\n        print\\(df\\)\n\n\"\"\"\n```\n\n## 🎊 总结\n\n本次工作完成了：\n1. ✅ 全面的文档审查和修复\n2. ✅ 所有 Python docstring 的统一和增强\n3. ✅ 命名空间的一致性优化\n4. ✅ 代码质量问题的修复\n5. ✅ 完整的回归测试验证\n\n**没有发现任何代码回归问题！** 所有测试通过，所有代码质量检查通过，项目处于健康状态。🎉\nEOF\ncat /tmp/final_summary.md)",
       "Bash(grep -r \"API Endpoint:\" lixinger/api/cn/company/*.py | head -10)",
       "Bash(uv run mypy lixinger/api/cn/company/dividend.py)",
-      "Bash(uv run mypy lixinger/models/cn/company/dividend.py lixinger/api/cn/company/dividend.py)"
+      "Bash(uv run mypy lixinger/models/cn/company/dividend.py lixinger/api/cn/company/dividend.py)",
+      "Bash(uv run:*)"
     ]
   }
 }

{lixinger_python-0.3.1 → lixinger_python-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lixinger-python
-Version: 0.3.1
+Version: 0.3.2
 Summary: Python SDK for Lixinger Financial Data API
 Project-URL: Homepage, https://www.lixinger.com
 Project-URL: Documentation, https://www.lixinger.com/open/api/doc

lixinger_python-0.3.2/examples/index_constituent_weightings_example.py

@@ -0,0 +1,45 @@
+"""Index constituent weightings API example.
+
+This example demonstrates how to use the index constituent weightings API
+to retrieve the weighting (proportion) of constituent stocks in an index over time.
+"""
+
+import asyncio
+
+from lixinger import AsyncLixingerClient, get_constituent_weightings
+
+
+async def main():
+    """Demonstrate usage of index constituent weightings API."""
+    # Method 1: Using the async client with context manager (recommended)
+    print("Method 1: Using async client...")
+    async with AsyncLixingerClient() as client:
+        # Get constituent weightings of CSI 300 Index
+        print("\nFetching constituent weightings of CSI 300 Index...")
+        df = await client.index.get_constituent_weightings(
+            stock_code="000300",  # CSI 300
+            start_date="2024-01-01",
+            end_date="2024-12-31",
+        )
+        print(f"Total records: {len(df)}")
+        print("\nTop 10 stocks by weight:")
+        top_stocks = df.sort_values("weighting", ascending=False).head(10)
+        print(top_stocks[["date", "stock_code", "weighting"]])
+
+        # Analyze weighting distribution
+        print("\nWeighting statistics:")
+        print(df["weighting"].describe())
+
+    # Method 2: Using functional API
+    print("\nMethod 2: Using functional API...")
+    df = await get_constituent_weightings(
+        stock_code="000300",
+        start_date="2024-06-01",
+        end_date="2024-06-30",
+    )
+    print(f"Total records: {len(df)}")
+    print(df.head(10))
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

lixinger_python-0.3.2/examples/index_constituents_example.py

@@ -0,0 +1,46 @@
+"""Index constituents API example.
+
+This example demonstrates how to use the index constituents API
+to retrieve constituent stocks of A-share indices.
+"""
+
+import asyncio
+
+from lixinger import AsyncLixingerClient, get_constituents
+
+
+async def main():
+    """Demonstrate usage of index constituents API."""
+    # Method 1: Using the async client with context manager (recommended)
+    print("Method 1: Using async client...")
+    async with AsyncLixingerClient() as client:
+        # Get constituents of Shanghai Composite Index (000001.SH)
+        print("\nFetching constituents of Shanghai Composite Index...")
+        df = await client.index.get_constituents(
+            stock_codes=["000001"],
+            date="2024-12-31",
+        )
+        print(f"Total constituents: {len(df)}")
+        print(df.head(10))
+
+        # Get constituents of multiple indices
+        print("\nFetching constituents of multiple indices...")
+        df = await client.index.get_constituents(
+            stock_codes=["000001", "399001"],  # Shanghai & Shenzhen Composite
+            date="2024-12-31",
+        )
+        print(f"Total constituents: {len(df)}")
+        print(df.head(10))
+
+    # Method 2: Using functional API
+    print("\nMethod 2: Using functional API...")
+    df = await get_constituents(
+        stock_codes=["000300"],  # CSI 300
+        date="2024-12-31",
+    )
+    print(f"Total constituents: {len(df)}")
+    print(df.head(10))
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

lixinger_python-0.3.2/examples/index_info_example.py

@@ -0,0 +1,42 @@
+"""Index information API example.
+
+This example demonstrates how to use the index API
+to retrieve basic information about stock indices.
+"""
+
+import asyncio
+
+from lixinger import AsyncLixingerClient, get_index
+
+
+async def main():
+    """Demonstrate usage of index information API."""
+    # Method 1: Using the async client with context manager (recommended)
+    print("Method 1: Using async client...")
+    async with AsyncLixingerClient() as client:
+        # Get information for specific indices
+        print("\nFetching info for CSI 300 and CSI 500...")
+        df = await client.index.get_index(stock_codes=["000300", "000905"])
+        print(df[["name", "stock_code", "source", "launch_date"]])
+
+        # Get all CSI indices
+        print("\nFetching all CSI indices...")
+        df = await client.index.get_index(source="csi")
+        print(f"Total CSI indices: {len(df)}")
+        print(df[["name", "stock_code", "rebalancing_frequency"]].head(10))
+
+        # Get all indices (may be large)
+        print("\nFetching all available indices...")
+        df = await client.index.get_index()
+        print(f"Total indices: {len(df)}")
+        print("\nIndices by source:")
+        print(df["source"].value_counts())
+
+    # Method 2: Using functional API
+    print("\nMethod 2: Using functional API...")
+    df = await get_index(stock_codes=["000001"])  # Shanghai Composite
+    print(df[["name", "stock_code", "source", "launch_date"]])
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

lixinger_python-0.3.2/lixinger/api/cn/index/constituent_weightings.py

@@ -0,0 +1,109 @@
+"""Index constituent weightings APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index.constituent_weightings import ConstituentWeighting
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+
+
+class ConstituentWeightingsAPI(BaseAPI):
+    """Index constituent weightings APIs."""
+
+    async def get_constituent_weightings(
+        self,
+        stock_code: str,
+        start_date: str,
+        end_date: str,
+    ) -> pd.DataFrame:
+        """获取指数成分股权重数据.
+
+        API Endpoint: /cn/index/constituent-weightings
+        API Method: POST
+        Documentation: https://www.lixinger.com/open/api/doc?api-key=cn/index/constituent-weightings
+
+        Args:
+            stock_code: 指数代码，如 "000300" (沪深300)
+            start_date: 开始日期 (YYYY-MM-DD)
+            end_date: 结束日期 (YYYY-MM-DD)
+
+        Returns:
+            包含指数成分股权重信息的 DataFrame，包含以下字段:
+                - date: 日期
+                - stock_code: 成分股代码
+                - weighting: 权重（0-1之间的浮点数）
+
+        Example:
+            获取沪深300指数成分股权重::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    # 查询指定时间段的成分股权重
+                    df = await client.index.get_constituent_weightings(
+                        stock_code="000300",
+                        start_date="2024-01-01",
+                        end_date="2024-12-31"
+                    )
+                    print(df)
+
+                    # 查看权重最大的成分股
+                    top_stocks = df.sort_values("weighting", ascending=False).head(10)
+                    print(top_stocks)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCode": stock_code,
+            "startDate": start_date,
+            "endDate": end_date,
+        }
+
+        data = await self._request("POST", "/cn/index/constituent-weightings", json=payload)
+        return get_response_df(data, ConstituentWeighting)
+
+
+# Functional API instance
+_api_instance = ConstituentWeightingsAPI()
+
+
+@api
+async def get_constituent_weightings(
+    stock_code: str,
+    start_date: str,
+    end_date: str,
+) -> pd.DataFrame:
+    """获取指数成分股权重数据.
+
+    Args:
+        stock_code: 指数代码，如 "000300" (沪深300)
+        start_date: 开始日期 (YYYY-MM-DD)
+        end_date: 结束日期 (YYYY-MM-DD)
+
+    Returns:
+        包含指数成分股权重信息的 DataFrame，包含以下字段:
+            - date: 日期
+            - stock_code: 成分股代码
+            - weighting: 权重（0-1之间的浮点数）
+
+    Example:
+        获取沪深300指数成分股权重::
+
+            from lixinger import get_constituent_weightings
+
+            # 查询指定时间段的成分股权重
+            df = await get_constituent_weightings(
+                stock_code="000300",
+                start_date="2024-01-01",
+                end_date="2024-12-31"
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_constituent_weightings(
+        stock_code=stock_code,
+        start_date=start_date,
+        end_date=end_date,
+    )

lixinger_python-0.3.2/lixinger/api/cn/index/constituents.py

@@ -0,0 +1,112 @@
+"""Index constituents APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index.constituents import Constituent
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+
+
+class ConstituentsAPI(BaseAPI):
+    """Index constituents APIs."""
+
+    async def get_constituents(
+        self,
+        stock_codes: list[str],
+        date: str,
+    ) -> pd.DataFrame:
+        """获取指数成分股列表.
+
+        API Endpoint: /cn/index/constituents
+        API Method: POST
+        Documentation: https://www.lixinger.com/open/api/doc?api-key=cn/index/constituents
+
+        Args:
+            stock_codes: 指数代码列表，如 ["000001.SH", "399001.SZ"]
+            date: 查询日期 (YYYY-MM-DD)，返回该日期的成分股列表
+
+        Returns:
+            包含指数成分股信息的 DataFrame，包含以下字段:
+                - index_stock_code: 指数代码
+                - stock_code: 成分股代码
+                - area_code: 地区代码
+                - market: 市场
+
+        Example:
+            获取沪深300指数的成分股::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    # 查询单个指数的成分股
+                    df = await client.index.get_constituents(
+                        stock_codes=["000300.SH"],
+                        date="2024-12-31"
+                    )
+                    print(df)
+
+                    # 查询多个指数的成分股
+                    df = await client.index.get_constituents(
+                        stock_codes=["000001.SH", "399001.SZ"],
+                        date="2024-12-31"
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCodes": stock_codes,
+            "date": date,
+        }
+
+        data = await self._request("POST", "/cn/index/constituents", json=payload)
+        flattened_data = []
+        for item in data:
+            index_stock_code = item["stockCode"]
+            for constituent in item["constituents"]:
+                constituent["index_stock_code"] = index_stock_code
+                flattened_data.append(constituent)
+        return get_response_df(flattened_data, Constituent)
+
+
+# Functional API instance
+_api_instance = ConstituentsAPI()
+
+
+@api
+async def get_constituents(
+    stock_codes: list[str],
+    date: str,
+) -> pd.DataFrame:
+    """获取指数成分股列表.
+
+    Args:
+        stock_codes: 指数代码列表，如 ["000001.SH", "399001.SZ"]
+        date: 查询日期 (YYYY-MM-DD)，返回该日期的成分股列表
+
+    Returns:
+        包含指数成分股信息的 DataFrame，包含以下字段:
+            - index_stock_code: 指数代码
+            - stock_code: 成分股代码
+            - area_code: 地区代码
+            - market: 市场
+
+    Example:
+        获取沪深300指数的成分股::
+
+            from lixinger import get_constituents
+
+            # 查询单个指数的成分股
+            df = await get_constituents(
+                stock_codes=["000300.SH"],
+                date="2024-12-31"
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_constituents(
+        stock_codes=stock_codes,
+        date=date,
+    )

lixinger_python-0.3.2/lixinger/api/cn/index/index.py

@@ -0,0 +1,130 @@
+"""Index-related APIs.
+
+This module provides APIs for querying index information.
+"""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index import Index
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+
+
+class IndexAPI(BaseAPI):
+    """Index related APIs."""
+
+    async def get_index(
+        self,
+        stock_codes: list[str] | None = None,
+        source: str | None = None,
+    ) -> pd.DataFrame:
+        """获取指数基本信息.
+
+        API Endpoint: /cn/index
+        API Method: POST
+        Documentation: https://www.lixinger.com/open/api/doc?api-key=cn/index
+
+        Args:
+            stock_codes: 指数代码列表，如 ["000300", "000001"]。不传则返回所有指数
+            source: 指数来源筛选，可选值:
+                - "csi": 中证指数
+                - "cni": 国证指数
+                - "sse": 上证指数
+                - "szse": 深证指数
+                不传则返回所有来源的指数
+
+        Returns:
+            包含指数基本信息的 DataFrame，包含以下字段:
+                - name: 指数名称
+                - stock_code: 指数代码
+                - area_code: 地区代码
+                - market: 市场
+                - source: 指数来源 (csi/cni/sse/szse等)
+                - fs_table_type: 财报类型 (hybrid/non_financial等)
+                - currency: 货币单位
+                - launch_date: 发布日期
+                - rebalancing_frequency: 调仓频率 (semi-annually/quarterly等)
+                - caculation_method: 计算方法 (grading_weighted等)
+                - series: 指数系列分类
+
+        Example:
+            获取指数基本信息::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    # 获取指定指数的信息
+                    df = await client.index.get_index(
+                        stock_codes=["000300", "000905"]
+                    )
+                    print(df[["name", "stock_code", "source", "launch_date"]])
+
+                    # 获取中证指数系列
+                    df = await client.index.get_index(source="csi")
+                    print(df[["name", "stock_code"]])
+
+                    # 获取所有指数
+                    df = await client.index.get_index()
+                    print(f"Total indices: {len(df)}")
+
+        """
+        payload: dict[str, Any] = {}
+        if stock_codes is not None:
+            payload["stockCodes"] = stock_codes
+        if source is not None:
+            payload["source"] = source
+
+        data = await self._request("POST", "/cn/index", json=payload)
+        return get_response_df(data, Index)
+
+
+# Functional API instance
+_api_instance = IndexAPI()
+
+
+@api
+async def get_index(
+    stock_codes: list[str] | None = None,
+    source: str | None = None,
+) -> pd.DataFrame:
+    """获取指数基本信息.
+
+    Args:
+        stock_codes: 指数代码列表，如 ["000300", "000001"]。不传则返回所有指数
+        source: 指数来源筛选 (csi/cni/sse/szse)。不传则返回所有来源
+
+    Returns:
+        包含指数基本信息的 DataFrame，包含以下字段:
+            - name: 指数名称
+            - stock_code: 指数代码
+            - area_code: 地区代码
+            - market: 市场
+            - source: 指数来源
+            - fs_table_type: 财报类型
+            - currency: 货币单位
+            - launch_date: 发布日期
+            - rebalancing_frequency: 调仓频率
+            - caculation_method: 计算方法
+            - series: 指数系列分类
+
+    Example:
+        获取指数基本信息::
+
+            from lixinger import get_index
+
+            # 获取指定指数
+            df = await get_index(stock_codes=["000300", "000905"])
+            print(df[["name", "stock_code", "source"]])
+
+            # 获取中证指数系列
+            df = await get_index(source="csi")
+            print(df)
+
+    """
+    return await _api_instance.get_index(
+        stock_codes=stock_codes,
+        source=source,
+    )

lixinger_python-0.3.2/lixinger/api/cn/index/namespace.py

@@ -0,0 +1,85 @@
+"""Index namespace for grouping related APIs."""
+
+from lixinger.api.cn.index.candlestick import IndexCandlestickAPI
+from lixinger.api.cn.index.constituent_weightings import ConstituentWeightingsAPI
+from lixinger.api.cn.index.constituents import ConstituentsAPI
+from lixinger.api.cn.index.drawdown import DrawdownAPI
+from lixinger.api.cn.index.fundamental import IndexFundamentalAPI
+from lixinger.api.cn.index.index import IndexAPI
+from lixinger.api.cn.index.tracking_fund import TrackingFundAPI
+
+
+class IndexNamespace:
+    """Namespace for index-related APIs.
+
+    This class groups all index-related APIs under a single namespace.
+    Access APIs via their specific attributes:
+
+    - index: Index information API (get_index)
+    - constituents: Index constituents API (get_constituents)
+    - constituent_weightings: Index constituent weightings API (get_constituent_weightings)
+    - fundamental: Index fundamental data API (get_index_fundamental)
+    - candlestick: Index candlestick data API (get_candlestick)
+    - drawdown: Index drawdown data API (get_drawdown)
+    - tracking_fund: Index tracking fund API (get_tracking_fund)
+
+    """
+
+    def __init__(  # noqa: PLR0913
+        self,
+        index: IndexAPI,
+        constituents: ConstituentsAPI,
+        constituent_weightings: ConstituentWeightingsAPI,
+        fundamental: IndexFundamentalAPI,
+        candlestick: IndexCandlestickAPI,
+        drawdown: DrawdownAPI,
+        tracking_fund: TrackingFundAPI,
+    ):
+        """Initialize the index namespace.
+
+        Args:
+            index: Index information API
+            constituents: Index constituents API
+            constituent_weightings: Index constituent weightings API
+            fundamental: Index fundamental data API
+            candlestick: Index candlestick data API
+            drawdown: Index drawdown data API
+            tracking_fund: Index tracking fund API
+
+        """
+        self.index = index
+        self.constituents = constituents
+        self.constituent_weightings = constituent_weightings
+        self.fundamental = fundamental
+        self.candlestick = candlestick
+        self.drawdown = drawdown
+        self.tracking_fund = tracking_fund
+
+    # Convenience aliases for shorter access
+    def get_index(self, *args, **kwargs):
+        """Alias for index.get_index."""
+        return self.index.get_index(*args, **kwargs)
+
+    def get_constituents(self, *args, **kwargs):
+        """Alias for constituents.get_constituents."""
+        return self.constituents.get_constituents(*args, **kwargs)
+
+    def get_constituent_weightings(self, *args, **kwargs):
+        """Alias for constituent_weightings.get_constituent_weightings."""
+        return self.constituent_weightings.get_constituent_weightings(*args, **kwargs)
+
+    def get_fundamental(self, *args, **kwargs):
+        """Alias for fundamental.get_fundamental."""
+        return self.fundamental.get_fundamental(*args, **kwargs)
+
+    def get_candlestick(self, *args, **kwargs):
+        """Alias for candlestick.get_candlestick."""
+        return self.candlestick.get_candlestick(*args, **kwargs)
+
+    def get_drawdown(self, *args, **kwargs):
+        """Alias for drawdown.get_drawdown."""
+        return self.drawdown.get_drawdown(*args, **kwargs)
+
+    def get_tracking_fund(self, *args, **kwargs):
+        """Alias for tracking_fund.get_tracking_fund."""
+        return self.tracking_fund.get_tracking_fund(*args, **kwargs)

{lixinger_python-0.3.1 → lixinger_python-0.3.2}/lixinger/client.py

@@ -32,6 +32,7 @@ from lixinger.api.cn.index import (
     IndexFundamentalAPI,
     TrackingFundAPI,
 )
+from lixinger.api.cn.index.namespace import IndexNamespace
 from lixinger.config import get_config_from_env
 from lixinger.utils.rate_limiter import AsyncRateLimiter
 
@@ -156,15 +157,36 @@ class AsyncLixingerClient:
         self.cn_company_indices = cn_company_indices
         self.cn_company_dividend = cn_company_dividend
         self.cn_company_announcement = cn_company_announcement
-        self.cn_index = IndexAPI(self._http_client, self.config, self._rate_limiter)
-        self.cn_index_constituents = ConstituentsAPI(self._http_client, self.config, self._rate_limiter)
-        self.cn_index_constituent_weightings = ConstituentWeightingsAPI(
-            self._http_client, self.config, self._rate_limiter
+
+        # Index APIs
+        cn_index = IndexAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_constituents = ConstituentsAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_constituent_weightings = ConstituentWeightingsAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_candlestick = IndexCandlestickAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_drawdown = DrawdownAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_fundamental = IndexFundamentalAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_tracking_fund = TrackingFundAPI(self._http_client, self.config, self._rate_limiter)
+
+        # Index namespace (groups all index APIs)
+        self.cn_index = IndexNamespace(
+            index=cn_index,
+            constituents=cn_index_constituents,
+            constituent_weightings=cn_index_constituent_weightings,
+            fundamental=cn_index_fundamental,
+            candlestick=cn_index_candlestick,
+            drawdown=cn_index_drawdown,
+            tracking_fund=cn_index_tracking_fund,
         )
-        self.cn_index_candlestick = IndexCandlestickAPI(self._http_client, self.config, self._rate_limiter)
-        self.cn_index_drawdown = DrawdownAPI(self._http_client, self.config, self._rate_limiter)
-        self.cn_index_fundamental = IndexFundamentalAPI(self._http_client, self.config, self._rate_limiter)
-        self.cn_index_tracking_fund = TrackingFundAPI(self._http_client, self.config, self._rate_limiter)
+
+        # Legacy flat access for index APIs (deprecated, for backward compatibility)
+        self.cn_index_constituents = cn_index_constituents
+        self.cn_index_constituent_weightings = cn_index_constituent_weightings
+        self.cn_index_candlestick = cn_index_candlestick
+        self.cn_index_drawdown = cn_index_drawdown
+        self.cn_index_fundamental = cn_index_fundamental
+        self.cn_index_tracking_fund = cn_index_tracking_fund
+
+        # Fund APIs
         self.cn_fund = FundAPI(self._http_client, self.config, self._rate_limiter)
         self.cn_fund_profile = FundProfileAPI(self._http_client, self.config, self._rate_limiter)
         self.cn_fund_candlestick = FundCandlestickAPI(self._http_client, self.config, self._rate_limiter)
@@ -190,6 +212,11 @@ class AsyncLixingerClient:
         """Alias for cn_company."""
         return self.cn_company
 
+    @property
+    def index(self) -> IndexNamespace:
+        """Alias for cn_index."""
+        return self.cn_index
+
     @property
     def candlestick(self) -> CandlestickAPI:
         """Alias for cn_company_candlestick."""

{lixinger_python-0.3.1 → lixinger_python-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lixinger-python"
-version = "0.3.1"
+version = "0.3.2"
 description = "Python SDK for Lixinger Financial Data API"
 readme = "README.md"
 requires-python = ">=3.11"