akshare-one 0.2.3__tar.gz → 0.3.0__tar.gz

{akshare_one-0.2.3 → akshare_one-0.3.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 zwldarren
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 zwldarren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{akshare_one-0.2.3 → akshare_one-0.3.0}/PKG-INFO

@@ -1,66 +1,70 @@
-Metadata-Version: 2.4
-Name: akshare-one
-Version: 0.2.3
-Summary: Standardized interface for Chinese financial market data, built on AKShare with unified data formats and simplified APIs
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/zwldarren/akshare-one
-Project-URL: Repository, https://github.com/zwldarren/akshare-one.git
-Keywords: akshare,financial-data,stock-data,quant
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: akshare>=1.17.5
-Requires-Dist: cachetools>=6.1.0
-Dynamic: license-file
-
-<div align="center">
-  <h1>AKShare One</h1>
-  <div>
-    <a href="README_zh.md">中文</a> | <strong>English</strong>
-  </div>
-</div>
-
-**AKShare One** is a data interface for obtaining Chinese A-shares, based on [AKShare](https://github.com/akfamily/akshare). It aims to simplify AKShare's usage and unify input/output formats from different data sources, making it easier to pass data to LLM.
-
-## ✨ Features
-
-- 📊 Unified stock code formats across data sources
-- 🏗️ Standardized return data structures
-- 🛠️ Simplified API parameter design
-- ⏱️ Automatic timestamp and adjustment handling
-
-## 🚀 Core Features
-
-| Function | Interface |
-|------|------|
-| Historical data | `get_hist_data` |
-| Real-time quotes | `get_realtime_data` |
-| Stock news | `get_news_data` |
-| Financial data | `get_balance_sheet`/`get_income_statement`/`get_cash_flow` |
-| Internal transactions | `get_inner_trade_data` |
-
-## 📦 Quick Installation
-
-```bash
-pip install akshare-one
-```
-
-## 💻 Usage Example
-
-```python
-from akshare_one import get_hist_data, get_realtime_data
-
-# Get historical data
-df_hist = get_hist_data(
-    symbol="600000",
-    interval="day",
-    adjust="hfq"
-)
-
-# Get real-time data
-df_realtime = get_realtime_data(symbol="600000")
-```
-
-## 📚 Documentation
-
-Detailed API reference: [docs/api.md](docs/api.md)
+Metadata-Version: 2.4
+Name: akshare-one
+Version: 0.3.0
+Summary: Standardized interface for Chinese financial market data, built on AKShare with unified data formats and simplified APIs
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/zwldarren/akshare-one
+Project-URL: Repository, https://github.com/zwldarren/akshare-one.git
+Keywords: akshare,financial-data,stock-data,quant
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: akshare>=1.17.8
+Requires-Dist: cachetools>=6.1.0
+Provides-Extra: talib
+Requires-Dist: ta-lib>=0.6.4; extra == "talib"
+Dynamic: license-file
+
+<div align="center">
+  <h1>AKShare One</h1>
+  <div>
+    <a href="README_zh.md">中文</a> | <strong>English</strong>
+  </div>
+</div>
+
+**AKShare One** is a data interface for obtaining Chinese A-shares, based on [AKShare](https://github.com/akfamily/akshare). It aims to simplify AKShare's usage and unify input/output formats from different data sources, making it easier to pass data to LLM.
+
+## ✨ Features
+
+- 📊 Unified stock code formats across data sources
+- 🏗️ Standardized return data structures
+- 🛠️ Simplified API parameter design
+- ⏱️ Automatic timestamp and adjustment handling
+
+## 🚀 Core Features
+
+| Function | Interface |
+|------|------|
+| Historical data | `get_hist_data` |
+| Real-time quotes | `get_realtime_data` |
+| Stock news | `get_news_data` |
+| Financial data | `get_balance_sheet`/`get_income_statement`/`get_cash_flow` |
+| Internal transactions | `get_inner_trade_data` |
+| Technical indicators | See [indicators.py](akshare_one/indicators.py) |
+
+## 📦 Quick Installation
+
+```bash
+pip install akshare-one
+```
+
+## 💻 Usage Example
+
+```python
+from akshare_one import get_hist_data
+from akshare_one.indicators import get_sma
+
+# Get historical data
+df = get_hist_data(
+    symbol="600000",
+    interval="day",
+    adjust="hfq"
+)
+
+# Calculate 20-day Simple Moving Average
+df_sma = get_sma(df, window=20)
+```
+
+## 📚 Documentation
+
+Detailed API reference: [docs/api.md](docs/api.md)

{akshare_one-0.2.3 → akshare_one-0.3.0}/README.md

@@ -1,51 +1,53 @@
-<div align="center">
-  <h1>AKShare One</h1>
-  <div>
-    <a href="README_zh.md">中文</a> | <strong>English</strong>
-  </div>
-</div>
-
-**AKShare One** is a data interface for obtaining Chinese A-shares, based on [AKShare](https://github.com/akfamily/akshare). It aims to simplify AKShare's usage and unify input/output formats from different data sources, making it easier to pass data to LLM.
-
-## ✨ Features
-
-- 📊 Unified stock code formats across data sources
-- 🏗️ Standardized return data structures
-- 🛠️ Simplified API parameter design
-- ⏱️ Automatic timestamp and adjustment handling
-
-## 🚀 Core Features
-
-| Function | Interface |
-|------|------|
-| Historical data | `get_hist_data` |
-| Real-time quotes | `get_realtime_data` |
-| Stock news | `get_news_data` |
-| Financial data | `get_balance_sheet`/`get_income_statement`/`get_cash_flow` |
-| Internal transactions | `get_inner_trade_data` |
-
-## 📦 Quick Installation
-
-```bash
-pip install akshare-one
-```
-
-## 💻 Usage Example
-
-```python
-from akshare_one import get_hist_data, get_realtime_data
-
-# Get historical data
-df_hist = get_hist_data(
-    symbol="600000",
-    interval="day",
-    adjust="hfq"
-)
-
-# Get real-time data
-df_realtime = get_realtime_data(symbol="600000")
-```
-
-## 📚 Documentation
-
-Detailed API reference: [docs/api.md](docs/api.md)
+<div align="center">
+  <h1>AKShare One</h1>
+  <div>
+    <a href="README_zh.md">中文</a> | <strong>English</strong>
+  </div>
+</div>
+
+**AKShare One** is a data interface for obtaining Chinese A-shares, based on [AKShare](https://github.com/akfamily/akshare). It aims to simplify AKShare's usage and unify input/output formats from different data sources, making it easier to pass data to LLM.
+
+## ✨ Features
+
+- 📊 Unified stock code formats across data sources
+- 🏗️ Standardized return data structures
+- 🛠️ Simplified API parameter design
+- ⏱️ Automatic timestamp and adjustment handling
+
+## 🚀 Core Features
+
+| Function | Interface |
+|------|------|
+| Historical data | `get_hist_data` |
+| Real-time quotes | `get_realtime_data` |
+| Stock news | `get_news_data` |
+| Financial data | `get_balance_sheet`/`get_income_statement`/`get_cash_flow` |
+| Internal transactions | `get_inner_trade_data` |
+| Technical indicators | See [indicators.py](akshare_one/indicators.py) |
+
+## 📦 Quick Installation
+
+```bash
+pip install akshare-one
+```
+
+## 💻 Usage Example
+
+```python
+from akshare_one import get_hist_data
+from akshare_one.indicators import get_sma
+
+# Get historical data
+df = get_hist_data(
+    symbol="600000",
+    interval="day",
+    adjust="hfq"
+)
+
+# Calculate 20-day Simple Moving Average
+df_sma = get_sma(df, window=20)
+```
+
+## 📚 Documentation
+
+Detailed API reference: [docs/api.md](docs/api.md)

{akshare_one-0.2.3 → akshare_one-0.3.0}/akshare_one/__init__.py

@@ -1,31 +1,31 @@
-"""Akshare One - Unified interface for Chinese market data
-
-Provides standardized access to various financial data sources with:
-- Consistent symbol formats
-- Unified data schemas
-- Cleaned and normalized outputs
-
-Example:
-    >>> from akshare_one import get_hist_data, get_realtime_data
-    >>> # 获取股票历史数据
-    >>> df = get_hist_data("600000", interval="day")
-    >>> print(df.head())
-    >>> # 获取股票实时数据
-    >>> df = get_realtime_data(symbol="600000")
-"""
-
-from .stock import get_hist_data, get_realtime_data
-from .news import get_news_data
-from .insider import get_inner_trade_data
-from .financial import get_balance_sheet, get_income_statement, get_cash_flow
-
-
-__all__ = [
-    "get_hist_data",
-    "get_realtime_data",
-    "get_news_data",
-    "get_inner_trade_data",
-    "get_balance_sheet",
-    "get_income_statement",
-    "get_cash_flow",
-]
+"""Akshare One - Unified interface for Chinese market data
+
+Provides standardized access to various financial data sources with:
+- Consistent symbol formats
+- Unified data schemas
+- Cleaned and normalized outputs
+
+Example:
+    >>> from akshare_one import get_hist_data, get_realtime_data
+    >>> # 获取股票历史数据
+    >>> df = get_hist_data("600000", interval="day")
+    >>> print(df.head())
+    >>> # 获取股票实时数据
+    >>> df = get_realtime_data(symbol="600000")
+"""
+
+from .stock import get_hist_data, get_realtime_data
+from .news import get_news_data
+from .insider import get_inner_trade_data
+from .financial import get_balance_sheet, get_income_statement, get_cash_flow
+
+
+__all__ = [
+    "get_hist_data",
+    "get_realtime_data",
+    "get_news_data",
+    "get_inner_trade_data",
+    "get_balance_sheet",
+    "get_income_statement",
+    "get_cash_flow",
+]

{akshare_one-0.2.3 → akshare_one-0.3.0}/akshare_one/financial.py

@@ -1,46 +1,46 @@
-"""财务报表数据模块
-
-包含资产负债表、利润表和现金流量表相关功能
-"""
-
-import pandas as pd
-from akshare_one.modules.financial.factory import FinancialDataFactory
-
-
-def get_balance_sheet(symbol: str, source: str = "sina") -> "pd.DataFrame":
-    """获取资产负债表数据
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ("sina")
-    """
-    if source == "sina":
-        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
-        return provider.get_balance_sheet()
-    raise ValueError(f"Unsupported data source: {source}")
-
-
-def get_income_statement(symbol: str, source: str = "sina") -> "pd.DataFrame":
-    """获取利润表数据
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ("sina")
-    """
-    if source == "sina":
-        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
-        return provider.get_income_statement()
-    raise ValueError(f"Unsupported data source: {source}")
-
-
-def get_cash_flow(symbol: str, source: str = "sina") -> "pd.DataFrame":
-    """获取现金流量表数据
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ("sina")
-    """
-    if source == "sina":
-        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
-        return provider.get_cash_flow()
-    raise ValueError(f"Unsupported data source: {source}")
+"""财务报表数据模块
+
+包含资产负债表、利润表和现金流量表相关功能
+"""
+
+import pandas as pd
+from akshare_one.modules.financial.factory import FinancialDataFactory
+
+
+def get_balance_sheet(symbol: str, source: str = "sina") -> "pd.DataFrame":
+    """获取资产负债表数据
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ("sina")
+    """
+    if source == "sina":
+        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+        return provider.get_balance_sheet()
+    raise ValueError(f"Unsupported data source: {source}")
+
+
+def get_income_statement(symbol: str, source: str = "sina") -> "pd.DataFrame":
+    """获取利润表数据
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ("sina")
+    """
+    if source == "sina":
+        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+        return provider.get_income_statement()
+    raise ValueError(f"Unsupported data source: {source}")
+
+
+def get_cash_flow(symbol: str, source: str = "sina") -> "pd.DataFrame":
+    """获取现金流量表数据
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ("sina")
+    """
+    if source == "sina":
+        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+        return provider.get_cash_flow()
+    raise ValueError(f"Unsupported data source: {source}")