akshare-one 0.3.8__tar.gz → 0.3.9__tar.gz

{akshare_one-0.3.8 → akshare_one-0.3.9}/PKG-INFO

@@ -1,19 +1,17 @@
 Metadata-Version: 2.4
 Name: akshare-one
-Version: 0.3.8
+Version: 0.3.9
 Summary: Standardized interface for Chinese financial market data, built on AKShare with unified data formats and simplified APIs
+Keywords: akshare,financial-data,stock-data,quant
 License-Expression: MIT
+Requires-Dist: akshare>=1.17.38
+Requires-Dist: cachetools>=5.5.2
+Requires-Dist: ta-lib>=0.6.4 ; extra == 'talib'
+Requires-Python: >=3.10
 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.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: akshare>=1.17.31
-Requires-Dist: cachetools>=5.5.2
 Provides-Extra: talib
-Requires-Dist: ta-lib>=0.6.4; extra == "talib"
-Dynamic: license-file
+Description-Content-Type: text/markdown
 
 <div align="center">
   <h1>AKShare One</h1>

{akshare_one-0.3.8 → akshare_one-0.3.9}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "akshare-one"
-version = "0.3.8"
+version = "0.3.9"
 description = "Standardized interface for Chinese financial market data, built on AKShare with unified data formats and simplified APIs"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "akshare>=1.17.31",
+    "akshare>=1.17.38",
     "cachetools>=5.5.2",
 ]
 license = "MIT"
@@ -23,17 +23,28 @@ talib = [
 [dependency-groups]
 dev = [
     "mkdocs-material>=9.6.15",
+    "mypy>=1.17.1",
+    "pandas-stubs>=2.3.0.250703",
     "pre-commit>=4.2.0",
     "pytest>=8.4.1",
     "pytest-cov>=6.2.1",
     "ruff>=0.12.1",
+    "types-cachetools>=6.1.0.20250717",
+    "types-requests>=2.32.4.20250809",
 ]
 
+[build-system]
+requires = ["uv_build>=0.8.12,<0.9.0"]
+build-backend = "uv_build"
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 python_files = "test_*.py"
 python_functions = "test_*"
 addopts = "-v --cov=akshare_one --cov-report=term-missing"
 
-[tool.setuptools.packages.find]
-include = ["akshare_one", "akshare_one.*"]
+[tool.ruff]
+line-length = 88
+
+[tool.mypy]
+strict = true

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/eastmoney/client.py

@@ -8,7 +8,7 @@ class EastMoneyClient:
     This class handles session management, request signing, and API calls.
     """
 
-    def __init__(self):
+    def __init__(self) -> None:
         self.session = requests.Session()
 
     def _get_security_id(self, symbol: str) -> str:
@@ -61,7 +61,7 @@ class EastMoneyClient:
         }
         response = self.session.get(url, params=params)
         response.raise_for_status()
-        return response.json()
+        return response.json()  # type: ignore
 
     def fetch_realtime_quote(self, symbol: str) -> Dict[str, Any]:
         """
@@ -77,4 +77,4 @@ class EastMoneyClient:
         }
         response = self.session.get(url, params=params)
         response.raise_for_status()
-        return response.json()
+        return response.json()  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/cache.py

@@ -1,8 +1,11 @@
 from cachetools import TTLCache, cached
 import os
+from typing import Any, Callable, TypeVar, Optional
+
+F = TypeVar('F', bound=Callable[..., Any])
 
 # 缓存配置
-CACHE_CONFIG = {
+CACHE_CONFIG: dict[str, TTLCache[Any, Any]] = {
     "hist_data_cache": TTLCache(maxsize=1000, ttl=3600),  # 历史数据缓存1小时
     "realtime_cache": TTLCache(maxsize=500, ttl=60),  # 实时数据缓存1分钟
     "news_cache": TTLCache(maxsize=500, ttl=3600),  # 新闻数据缓存1小时
@@ -11,7 +14,7 @@ CACHE_CONFIG = {
 }
 
 
-def cache(cache_key, key=None):
+def cache(cache_key: str, key: Optional[Callable[..., Any]] = None) -> Callable[[F], F]:
     cache_enabled = os.getenv("AKSHARE_ONE_CACHE_ENABLED", "true").lower() in (
         "1",
         "true",
@@ -19,9 +22,9 @@ def cache(cache_key, key=None):
         "on",
     )
 
-    def decorator(func):
+    def decorator(func: F) -> F:
         if cache_enabled:
-            return cached(CACHE_CONFIG[cache_key], key=key)(func)
+            return cached(CACHE_CONFIG[cache_key], key=key)(func)  # type: ignore
         return func
 
     return decorator

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/financial/eastmoney_direct.py

@@ -35,17 +35,17 @@ class EastMoneyDirectFinancialReport(FinancialDataProvider):
         "CCE_ADD": "change_in_cash_and_equivalents",
     }
 
-    def __init__(self, symbol):
+    def __init__(self, symbol: str) -> None:
         super().__init__(symbol)
 
-    def get_income_statement(self):
-        pass
+    def get_income_statement(self) -> pd.DataFrame:
+        return pd.DataFrame()
 
-    def get_balance_sheet(self):
-        pass
+    def get_balance_sheet(self) -> pd.DataFrame:
+        return pd.DataFrame()
 
-    def get_cash_flow(self):
-        pass
+    def get_cash_flow(self) -> pd.DataFrame:
+        return pd.DataFrame()
 
     @cache(
         "financial_cache",

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/financial/factory.py

@@ -14,7 +14,7 @@ class FinancialDataFactory:
     }
 
     @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> FinancialDataProvider:
+    def get_provider(cls, provider_name: str, **kwargs) -> FinancialDataProvider:  # type: ignore
         """
         Get a financial data provider by name
 
@@ -35,7 +35,7 @@ class FinancialDataFactory:
         return provider_class(**kwargs)
 
     @classmethod
-    def register_provider(cls, name: str, provider_class: type):
+    def register_provider(cls, name: str, provider_class: type) -> None:
         """
         Register a new financial data provider
 
@@ -43,4 +43,4 @@ class FinancialDataFactory:
             name: Name to associate with this provider
             provider_class: The provider class to register
         """
-        cls._providers[name.lower()] = provider_class
+        cls._providers[name.lower()] = provider_class  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/financial/sina.py

@@ -1,5 +1,5 @@
 import pandas as pd
-import akshare as ak
+import akshare as ak # type: ignore
 
 from ..cache import cache
 from .base import FinancialDataProvider
@@ -288,5 +288,5 @@ class SinaFinancialReport(FinancialDataProvider):
         required_columns = ["report_date"] + list(column_mapping.values())
         return raw_df.rename(columns=column_mapping).reindex(columns=required_columns)
 
-    def get_financial_metrics(self):
-        pass
+    def get_financial_metrics(self) -> pd.DataFrame:
+        return pd.DataFrame()

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/historical/base.py

@@ -20,7 +20,7 @@ class HistoricalDataProvider(ABC):
         self.adjust = adjust
         self._validate_dates()
 
-    def _validate_dates(self):
+    def _validate_dates(self) -> None:
         try:
             pd.to_datetime(self.start_date)
             pd.to_datetime(self.end_date)
@@ -28,7 +28,7 @@ class HistoricalDataProvider(ABC):
             raise ValueError("Invalid date format. Please use YYYY-MM-DD.")
 
     @classmethod
-    def get_supported_intervals(cls):
+    def get_supported_intervals(cls) -> list[str]:
         return ["minute", "hour", "day", "week", "month", "year"]
 
     @abstractmethod

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/historical/eastmoney.py

@@ -1,5 +1,5 @@
 from .base import HistoricalDataProvider
-import akshare as ak
+import akshare as ak # type: ignore
 import pandas as pd
 from ..cache import cache
 

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/historical/eastmoney_direct.py

@@ -1,4 +1,5 @@
 import pandas as pd
+from typing import Any
 from .base import HistoricalDataProvider
 from ..cache import cache
 from akshare_one.eastmoney.client import EastMoneyClient
@@ -8,7 +9,7 @@ from akshare_one.eastmoney.utils import parse_kline_data, resample_historical_da
 class EastMoneyDirectHistorical(HistoricalDataProvider):
     """Direct implementation for EastMoney historical stock data API"""
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
         self.client = EastMoneyClient()
 

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/historical/factory.py

@@ -16,7 +16,7 @@ class HistoricalDataFactory:
     }
 
     @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> HistoricalDataProvider:
+    def get_provider(cls, provider_name: str, **kwargs) -> HistoricalDataProvider:  # type: ignore
         """
         Get a historical data provider by name
 
@@ -34,10 +34,10 @@ class HistoricalDataFactory:
         if not provider_class:
             raise ValueError(f"Unknown historical data provider: {provider_name}")
 
-        return provider_class(**kwargs)
+        return provider_class(**kwargs)  # type: ignore
 
     @classmethod
-    def register_provider(cls, name: str, provider_class: type):
+    def register_provider(cls, name: str, provider_class: type) -> None:
         """
         Register a new historical data provider
 
@@ -45,4 +45,4 @@ class HistoricalDataFactory:
             name: Name to associate with this provider
             provider_class: The provider class to register
         """
-        cls._providers[name.lower()] = provider_class
+        cls._providers[name.lower()] = provider_class  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/historical/sina.py

@@ -1,6 +1,6 @@
 from cachetools import cached
 from .base import HistoricalDataProvider
-import akshare as ak
+import akshare as ak  # type: ignore
 import pandas as pd
 from ..cache import CACHE_CONFIG
 
@@ -115,7 +115,7 @@ class SinaHistorical(HistoricalDataProvider):
 
             if self.interval_multiplier > 1:
                 freq = f"{self.interval_multiplier}{'min' if self.interval == 'minute' else 'h'}"
-                raw_df = self._resample_intraday_data(raw_df, freq)
+                raw_df = self._resample_data(raw_df, self.interval, self.interval_multiplier)
         else:
             raw_df = ak.stock_zh_b_daily(
                 symbol=stock,

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/indicators/factory.py

@@ -8,7 +8,7 @@ TALIB_AVAILABLE = False
 try:
     from .talib import TalibIndicatorCalculator
 
-    _calculators["talib"] = TalibIndicatorCalculator
+    _calculators["talib"] = TalibIndicatorCalculator  # type: ignore
     TALIB_AVAILABLE = True
 except ImportError:
     # talib is optional

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/indicators/simple.py

@@ -220,13 +220,14 @@ class SimpleIndicatorCalculator(BaseIndicatorCalculator):
     def calculate_tsf(self, df: pd.DataFrame, window: int) -> pd.DataFrame:
         close = df["close"]
 
-        def linear_reg_forecast(y):
+        def linear_reg_forecast(y: np.ndarray) -> float:
             x = np.arange(1, len(y) + 1)
             b_num = len(x) * np.sum(x * y) - np.sum(x) * np.sum(y)
             b_den = len(x) * np.sum(x * x) - np.sum(x) ** 2
             b = b_num / b_den if b_den != 0 else 0
             a = np.mean(y) - b * np.mean(x)
-            return a + b * len(y)
+            result = a + b * len(y)
+            return float(result)
 
         tsf = close.rolling(window=window, min_periods=window).apply(
             linear_reg_forecast, raw=True
@@ -267,8 +268,8 @@ class SimpleIndicatorCalculator(BaseIndicatorCalculator):
 
     def calculate_cmo(self, df: pd.DataFrame, window: int) -> pd.DataFrame:
         close_diff = df["close"].diff(1)
-        sum_up = close_diff.where(close_diff > 0, 0).rolling(window=window).sum()
-        sum_down = -close_diff.where(close_diff < 0, 0).rolling(window=window).sum()
+        sum_up = close_diff.where(close_diff > 0, 0).rolling(window=window).sum()  # type: ignore
+        sum_down = -close_diff.where(close_diff < 0, 0).rolling(window=window).sum()  # type: ignore
         cmo = 100 * (sum_up - sum_down) / (sum_up + sum_down).replace(0, np.nan)
         cmo = cmo.fillna(0)
         return cmo.to_frame("cmo")
@@ -284,8 +285,8 @@ class SimpleIndicatorCalculator(BaseIndicatorCalculator):
         typical_price = (df["high"] + df["low"] + df["close"]) / 3
         money_flow = typical_price * df["volume"]
         price_diff = typical_price.diff()
-        positive_mf = money_flow.where(price_diff > 0, 0)
-        negative_mf = money_flow.where(price_diff < 0, 0)
+        positive_mf = money_flow.where(price_diff > 0, 0)  # type: ignore
+        negative_mf = money_flow.where(price_diff < 0, 0)  # type: ignore
         positive_mf_sum = positive_mf.rolling(window=window).sum()
         negative_mf_sum = negative_mf.rolling(window=window).sum()
         money_ratio = positive_mf_sum / negative_mf_sum.replace(0, np.nan)
@@ -304,7 +305,7 @@ class SimpleIndicatorCalculator(BaseIndicatorCalculator):
         low = df["low"]
         up_move = high.diff()
         down_move = -low.diff()
-        minus_dm = down_move.where((down_move > up_move) & (down_move > 0), 0)
+        minus_dm = down_move.where((down_move > up_move) & (down_move > 0), 0)  # type: ignore
         smoothed_minus_dm = self._wilder_smooth(minus_dm, window)
         return smoothed_minus_dm.to_frame("minus_dm")
 
@@ -319,7 +320,7 @@ class SimpleIndicatorCalculator(BaseIndicatorCalculator):
         low = df["low"]
         up_move = high.diff()
         down_move = -low.diff()
-        plus_dm = up_move.where((up_move > down_move) & (up_move > 0), 0)
+        plus_dm = up_move.where((up_move > down_move) & (up_move > 0), 0)  # type: ignore
         smoothed_plus_dm = self._wilder_smooth(plus_dm, window)
         return smoothed_plus_dm.to_frame("plus_dm")
 

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/indicators/talib.py

@@ -1,4 +1,4 @@
-import talib
+import talib # type: ignore
 import pandas as pd
 from .base import BaseIndicatorCalculator
 
@@ -136,7 +136,7 @@ class TalibIndicatorCalculator(BaseIndicatorCalculator):
         return pd.DataFrame({"tsf": tsf}, index=df.index)
 
     def calculate_apo(
-        self, df: pd.DataFrame, fast_period: int, slow_period: int, ma_type
+        self, df: pd.DataFrame, fast_period: int, slow_period: int, ma_type: int
     ) -> pd.DataFrame:
         close = df["close"].values
         apo = talib.APO(
@@ -213,7 +213,7 @@ class TalibIndicatorCalculator(BaseIndicatorCalculator):
         return pd.DataFrame({"plus_dm": plus_dm}, index=df.index)
 
     def calculate_ppo(
-        self, df: pd.DataFrame, fast_period: int, slow_period: int, ma_type
+        self, df: pd.DataFrame, fast_period: int, slow_period: int, ma_type: int
     ) -> pd.DataFrame:
         close = df["close"].values
         ppo = talib.PPO(

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/info/eastmoney.py

@@ -1,5 +1,5 @@
 import pandas as pd
-import akshare as ak
+import akshare as ak # type: ignore
 
 from ..cache import cache
 from .base import InfoDataProvider
@@ -48,4 +48,4 @@ class EastmoneyInfo(InfoDataProvider):
             if col in info_df.columns:
                 info_df[col] = pd.to_numeric(info_df[col], errors="coerce")
 
-        return info_df
+        return info_df  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/info/factory.py

@@ -12,7 +12,7 @@ class InfoDataFactory:
     }
 
     @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> InfoDataProvider:
+    def get_provider(cls, provider_name: str, **kwargs) -> InfoDataProvider:  # type: ignore
         """
         Get a info data provider by name
 
@@ -33,7 +33,7 @@ class InfoDataFactory:
         return provider_class(**kwargs)
 
     @classmethod
-    def register_provider(cls, name: str, provider_class: type):
+    def register_provider(cls, name: str, provider_class: type) -> None:
         """
         Register a new info data provider
 
@@ -41,4 +41,4 @@ class InfoDataFactory:
             name: Name to associate with this provider
             provider_class: The provider class to register
         """
-        cls._providers[name.lower()] = provider_class
+        cls._providers[name.lower()] = provider_class  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/insider/factory.py

@@ -12,7 +12,7 @@ class InsiderDataFactory:
     }
 
     @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> InsiderDataProvider:
+    def get_provider(cls, provider_name: str, **kwargs) -> InsiderDataProvider:  # type: ignore
         """
         Get an insider data provider by name
 
@@ -33,7 +33,7 @@ class InsiderDataFactory:
         return provider_class(**kwargs)
 
     @classmethod
-    def register_provider(cls, name: str, provider_class: type):
+    def register_provider(cls, name: str, provider_class: type) -> None:
         """
         Register a new insider data provider
 
@@ -41,4 +41,4 @@ class InsiderDataFactory:
             name: Name to associate with this provider
             provider_class: The provider class to register
         """
-        cls._providers[name.lower()] = provider_class
+        cls._providers[name.lower()] = provider_class  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/insider/xueqiu.py

@@ -1,5 +1,5 @@
 import pandas as pd
-import akshare as ak
+import akshare as ak # type: ignore
 from .base import InsiderDataProvider
 from ..utils import convert_xieqiu_symbol
 from ..cache import cache

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/news/eastmoney.py

@@ -1,5 +1,5 @@
 import pandas as pd
-import akshare as ak
+import akshare as ak  # type: ignore
 
 from ..cache import cache
 from .base import NewsDataProvider

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/news/factory.py

@@ -12,7 +12,7 @@ class NewsDataFactory:
     }
 
     @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> NewsDataProvider:
+    def get_provider(cls, provider_name: str, **kwargs) -> NewsDataProvider:  # type: ignore
         """
         Get a news data provider by name
 
@@ -33,7 +33,7 @@ class NewsDataFactory:
         return provider_class(**kwargs)
 
     @classmethod
-    def register_provider(cls, name: str, provider_class: type):
+    def register_provider(cls, name: str, provider_class: type) -> None:
         """
         Register a new news data provider
 
@@ -41,4 +41,4 @@ class NewsDataFactory:
             name: Name to associate with this provider
             provider_class: The provider class to register
         """
-        cls._providers[name.lower()] = provider_class
+        cls._providers[name.lower()] = provider_class  # type: ignore

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/realtime/eastmoney.py

@@ -1,5 +1,5 @@
 import pandas as pd
-import akshare as ak
+import akshare as ak  # type: ignore
 
 from ..cache import cache
 from .base import RealtimeDataProvider

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/realtime/factory.py

@@ -9,14 +9,37 @@ class RealtimeDataFactory:
     Factory class for creating realtime data providers
     """
 
-    _providers = {
+    _providers: dict[str, type["RealtimeDataProvider"]] = {
         "eastmoney": EastmoneyRealtime,
         "xueqiu": XueQiuRealtime,
         "eastmoney_direct": EastMoneyDirectRealtime,
     }
 
     @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> RealtimeDataProvider:
+    def get_provider(cls, provider_name: str, **kwargs: object) -> "RealtimeDataProvider":
+        """
+        Get a realtime data provider by name
+
+        Args:
+            provider_name: Name of the provider (e.g., 'eastmoney')
+            **kwargs: Additional arguments to pass to the provider's constructor
+
+        Returns:
+            RealtimeDataProvider: An instance of the requested provider
+
+        Raises:
+            ValueError: If the requested provider is not found
+        """
+        provider_class = cls._providers.get(provider_name.lower())
+        if not provider_class:
+            raise ValueError(f"Unknown realtime data provider: {provider_name}")
+
+        # Extract symbol from kwargs if present
+        symbol = kwargs.get("symbol", "")
+        if not isinstance(symbol, str):
+            raise ValueError("symbol must be a string")
+        
+        return provider_class(symbol=symbol)
         """
         Get a realtime data provider by name
 
@@ -37,7 +60,7 @@ class RealtimeDataFactory:
         return provider_class(**kwargs)
 
     @classmethod
-    def register_provider(cls, name: str, provider_class: type):
+    def register_provider(cls, name: str, provider_class: type) -> None:
         """
         Register a new realtime data provider
 

{akshare_one-0.3.8 → akshare_one-0.3.9/src}/akshare_one/modules/realtime/xueqiu.py

@@ -1,5 +1,5 @@
 import pandas as pd
-import akshare as ak
+import akshare as ak  # type: ignore
 from ..utils import convert_xieqiu_symbol
 from ..cache import cache
 from .base import RealtimeDataProvider

akshare_one-0.3.8/LICENSE

@@ -1,21 +0,0 @@
-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.3.8/akshare_one.egg-info/PKG-INFO

@@ -1,74 +0,0 @@
-Metadata-Version: 2.4
-Name: akshare-one
-Version: 0.3.8
-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.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: akshare>=1.17.31
-Requires-Dist: cachetools>=5.5.2
-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` |
-| Basic stock info | `get_basic_info` |
-| Financial metrics | `get_financial_metrics` |
-| 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
-
-Full API documentation is now available on GitHub Pages:
-
-https://zwldarren.github.io/akshare-one/