akshare-one 0.3.6__py3-none-any.whl → 0.3.8__py3-none-any.whl

akshare_one/modules/info/eastmoney.py

@@ -1,51 +1,51 @@
-import pandas as pd
-import akshare as ak
-
-from ..cache import cache
-from .base import InfoDataProvider
-
-
-class EastmoneyInfo(InfoDataProvider):
-    _basic_info_rename_map = {
-        "最新": "price",
-        "股票代码": "symbol",
-        "股票简称": "name",
-        "总股本": "total_shares",
-        "流通股": "float_shares",
-        "总市值": "total_market_cap",
-        "流通市值": "float_market_cap",
-        "行业": "industry",
-        "上市时间": "listing_date",
-    }
-
-    @cache(
-        "info_cache",
-        key=lambda self, symbol=None: f"eastmoney_{symbol}",
-    )
-    def get_basic_info(self) -> pd.DataFrame:
-        """获取东方财富个股信息"""
-        info_df = ak.stock_individual_info_em(symbol=self.symbol)
-        info_df = info_df.set_index("item").T
-        info_df.reset_index(drop=True, inplace=True)
-        info_df.rename(columns=self._basic_info_rename_map, inplace=True)
-
-        if "symbol" in info_df.columns:
-            info_df["symbol"] = info_df["symbol"].astype(str)
-
-        if "listing_date" in info_df.columns:
-            info_df["listing_date"] = pd.to_datetime(
-                info_df["listing_date"], format="%Y%m%d"
-            )
-
-        numeric_cols = [
-            "price",
-            "total_shares",
-            "float_shares",
-            "total_market_cap",
-            "float_market_cap",
-        ]
-        for col in numeric_cols:
-            if col in info_df.columns:
-                info_df[col] = pd.to_numeric(info_df[col], errors="coerce")
-
-        return info_df
+import pandas as pd
+import akshare as ak
+
+from ..cache import cache
+from .base import InfoDataProvider
+
+
+class EastmoneyInfo(InfoDataProvider):
+    _basic_info_rename_map = {
+        "最新": "price",
+        "股票代码": "symbol",
+        "股票简称": "name",
+        "总股本": "total_shares",
+        "流通股": "float_shares",
+        "总市值": "total_market_cap",
+        "流通市值": "float_market_cap",
+        "行业": "industry",
+        "上市时间": "listing_date",
+    }
+
+    @cache(
+        "info_cache",
+        key=lambda self, symbol=None: f"eastmoney_{symbol}",
+    )
+    def get_basic_info(self) -> pd.DataFrame:
+        """获取东方财富个股信息"""
+        info_df = ak.stock_individual_info_em(symbol=self.symbol)
+        info_df = info_df.set_index("item").T
+        info_df.reset_index(drop=True, inplace=True)
+        info_df.rename(columns=self._basic_info_rename_map, inplace=True)
+
+        if "symbol" in info_df.columns:
+            info_df["symbol"] = info_df["symbol"].astype(str)
+
+        if "listing_date" in info_df.columns:
+            info_df["listing_date"] = pd.to_datetime(
+                info_df["listing_date"], format="%Y%m%d"
+            )
+
+        numeric_cols = [
+            "price",
+            "total_shares",
+            "float_shares",
+            "total_market_cap",
+            "float_market_cap",
+        ]
+        for col in numeric_cols:
+            if col in info_df.columns:
+                info_df[col] = pd.to_numeric(info_df[col], errors="coerce")
+
+        return info_df

akshare_one/modules/info/factory.py

@@ -1,44 +1,44 @@
-from .eastmoney import EastmoneyInfo
-from .base import InfoDataProvider
-
-
-class InfoDataFactory:
-    """
-    Factory class for creating info data providers
-    """
-
-    _providers = {
-        "eastmoney": EastmoneyInfo,
-    }
-
-    @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> InfoDataProvider:
-        """
-        Get a info 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:
-            InfoDataProvider: 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 info data provider: {provider_name}")
-
-        return provider_class(**kwargs)
-
-    @classmethod
-    def register_provider(cls, name: str, provider_class: type):
-        """
-        Register a new info data provider
-
-        Args:
-            name: Name to associate with this provider
-            provider_class: The provider class to register
-        """
-        cls._providers[name.lower()] = provider_class
+from .eastmoney import EastmoneyInfo
+from .base import InfoDataProvider
+
+
+class InfoDataFactory:
+    """
+    Factory class for creating info data providers
+    """
+
+    _providers = {
+        "eastmoney": EastmoneyInfo,
+    }
+
+    @classmethod
+    def get_provider(cls, provider_name: str, **kwargs) -> InfoDataProvider:
+        """
+        Get a info 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:
+            InfoDataProvider: 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 info data provider: {provider_name}")
+
+        return provider_class(**kwargs)
+
+    @classmethod
+    def register_provider(cls, name: str, provider_class: type):
+        """
+        Register a new info data provider
+
+        Args:
+            name: Name to associate with this provider
+            provider_class: The provider class to register
+        """
+        cls._providers[name.lower()] = provider_class

akshare_one/modules/insider/base.py

@@ -1,28 +1,28 @@
-from abc import ABC, abstractmethod
-import pandas as pd
-
-
-class InsiderDataProvider(ABC):
-    def __init__(self, symbol: str) -> None:
-        self.symbol = symbol
-
-    @abstractmethod
-    def get_inner_trade_data(self) -> pd.DataFrame:
-        """Fetches insider trade data
-
-        Returns:
-            pd.DataFrame:
-            - symbol: 股票代码
-            - issuer: 股票名称
-            - name: 变动人
-            - title: 董监高职务
-            - transaction_date: 变动日期
-            - transaction_shares: 变动股数
-            - transaction_price_per_share: 成交均价
-            - shares_owned_after_transaction: 变动后持股数
-            - relationship: 与董监高关系
-            - is_board_director: 是否为董事会成员
-            - transaction_value: 交易金额(变动股数*成交均价)
-            - shares_owned_before_transaction: 变动前持股数
-        """
-        pass
+from abc import ABC, abstractmethod
+import pandas as pd
+
+
+class InsiderDataProvider(ABC):
+    def __init__(self, symbol: str) -> None:
+        self.symbol = symbol
+
+    @abstractmethod
+    def get_inner_trade_data(self) -> pd.DataFrame:
+        """Fetches insider trade data
+
+        Returns:
+            pd.DataFrame:
+            - symbol: 股票代码
+            - issuer: 股票名称
+            - name: 变动人
+            - title: 董监高职务
+            - transaction_date: 变动日期
+            - transaction_shares: 变动股数
+            - transaction_price_per_share: 成交均价
+            - shares_owned_after_transaction: 变动后持股数
+            - relationship: 与董监高关系
+            - is_board_director: 是否为董事会成员
+            - transaction_value: 交易金额(变动股数*成交均价)
+            - shares_owned_before_transaction: 变动前持股数
+        """
+        pass

akshare_one/modules/insider/factory.py

@@ -1,44 +1,44 @@
-from .xueqiu import XueQiuInsider
-from .base import InsiderDataProvider
-
-
-class InsiderDataFactory:
-    """
-    Factory class for creating insider data providers
-    """
-
-    _providers = {
-        "xueqiu": XueQiuInsider,
-    }
-
-    @classmethod
-    def get_provider(cls, provider_name: str, **kwargs) -> InsiderDataProvider:
-        """
-        Get an insider data provider by name
-
-        Args:
-            provider_name: Name of the provider (e.g., 'xueqiu')
-            **kwargs: Additional arguments to pass to the provider's constructor
-
-        Returns:
-            InsiderDataProvider: 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 insider data provider: {provider_name}")
-
-        return provider_class(**kwargs)
-
-    @classmethod
-    def register_provider(cls, name: str, provider_class: type):
-        """
-        Register a new insider data provider
-
-        Args:
-            name: Name to associate with this provider
-            provider_class: The provider class to register
-        """
-        cls._providers[name.lower()] = provider_class
+from .xueqiu import XueQiuInsider
+from .base import InsiderDataProvider
+
+
+class InsiderDataFactory:
+    """
+    Factory class for creating insider data providers
+    """
+
+    _providers = {
+        "xueqiu": XueQiuInsider,
+    }
+
+    @classmethod
+    def get_provider(cls, provider_name: str, **kwargs) -> InsiderDataProvider:
+        """
+        Get an insider data provider by name
+
+        Args:
+            provider_name: Name of the provider (e.g., 'xueqiu')
+            **kwargs: Additional arguments to pass to the provider's constructor
+
+        Returns:
+            InsiderDataProvider: 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 insider data provider: {provider_name}")
+
+        return provider_class(**kwargs)
+
+    @classmethod
+    def register_provider(cls, name: str, provider_class: type):
+        """
+        Register a new insider data provider
+
+        Args:
+            name: Name to associate with this provider
+            provider_class: The provider class to register
+        """
+        cls._providers[name.lower()] = provider_class

akshare_one/modules/insider/xueqiu.py

@@ -1,110 +1,110 @@
-import pandas as pd
-import akshare as ak
-from .base import InsiderDataProvider
-from ..utils import convert_xieqiu_symbol
-from ..cache import cache
-
-
-class XueQiuInsider(InsiderDataProvider):
-    """Provider for XueQiu insider trading data"""
-
-    @cache(
-        "financial_cache",
-        key=lambda self, symbol=None: f"xueqiu_insider_{symbol if symbol else 'all'}",
-    )
-    def get_inner_trade_data(self) -> pd.DataFrame:
-        """获取雪球内部交易数据
-
-        Args:
-            symbol: 可选股票代码，如"600000"，不传则返回所有数据
-
-        Returns:
-            Standardized DataFrame with insider trading data:
-            - symbol: 股票代码
-            - name: 股票名称
-            - change_date: 变动日期
-            - insider: 变动人
-            - shares_changed: 变动股数
-            - avg_price: 成交均价
-            - shares_after: 变动后持股数
-            - relationship: 与董监高关系
-            - position: 董监高职务
-        """
-        raw_df = ak.stock_inner_trade_xq()
-        if self.symbol:
-            xueqiu_symbol = convert_xieqiu_symbol(self.symbol)
-            raw_df = raw_df[raw_df["股票代码"] == xueqiu_symbol]
-        return self._clean_insider_data(raw_df)
-
-    def _clean_insider_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
-        """清理和标准化内部交易数据
-
-        Args:
-            raw_df: Raw DataFrame from XueQiu API
-
-        Returns:
-            Standardized DataFrame with consistent columns
-        """
-        column_mapping = {
-            "股票代码": "symbol",
-            "股票名称": "issuer",
-            "变动人": "name",
-            "董监高职务": "title",
-            "变动日期": "transaction_date",
-            "变动股数": "transaction_shares",
-            "成交均价": "transaction_price_per_share",
-            "变动后持股数": "shares_owned_after_transaction",
-            "与董监高关系": "relationship",
-        }
-
-        df = raw_df.rename(columns=column_mapping)
-
-        # Convert symbol back to original format (remove SH/SZ prefix)
-        if "symbol" in df.columns:
-            df["symbol"] = df["symbol"].str.replace(r"^[A-Z]{2}", "", regex=True)
-
-        # Add is_board_director column
-        df["is_board_director"] = df["title"].str.contains("董事")
-
-        # Calculate transaction_value
-        if (
-            "transaction_shares" in df.columns
-            and "transaction_price_per_share" in df.columns
-        ):
-            df["transaction_value"] = (
-                df["transaction_shares"] * df["transaction_price_per_share"]
-            )
-
-        # Add shares_owned_before_transaction if possible
-        if (
-            "shares_owned_after_transaction" in df.columns
-            and "transaction_shares" in df.columns
-        ):
-            df["shares_owned_before_transaction"] = (
-                df["shares_owned_after_transaction"] - df["transaction_shares"]
-            )
-
-        # Convert date format
-        if "transaction_date" in df.columns:
-            df["transaction_date"] = pd.to_datetime(
-                df["transaction_date"]
-            ).dt.tz_localize("Asia/Shanghai")
-
-        if "filing_date" in df.columns:
-            df["filing_date"] = pd.to_datetime(df["filing_date"]).dt.tz_localize(
-                "Asia/Shanghai"
-            )
-
-        # Convert numeric columns
-        numeric_cols = [
-            "transaction_shares",
-            "transaction_price_per_share",
-            "transaction_value",
-            "shares_owned_before_transaction",
-            "shares_owned_after_transaction",
-        ]
-        for col in numeric_cols:
-            if col in df.columns:
-                df[col] = pd.to_numeric(df[col], errors="coerce")
-
-        return df.reset_index(drop=True)
+import pandas as pd
+import akshare as ak
+from .base import InsiderDataProvider
+from ..utils import convert_xieqiu_symbol
+from ..cache import cache
+
+
+class XueQiuInsider(InsiderDataProvider):
+    """Provider for XueQiu insider trading data"""
+
+    @cache(
+        "financial_cache",
+        key=lambda self, symbol=None: f"xueqiu_insider_{symbol if symbol else 'all'}",
+    )
+    def get_inner_trade_data(self) -> pd.DataFrame:
+        """获取雪球内部交易数据
+
+        Args:
+            symbol: 可选股票代码，如"600000"，不传则返回所有数据
+
+        Returns:
+            Standardized DataFrame with insider trading data:
+            - symbol: 股票代码
+            - name: 股票名称
+            - change_date: 变动日期
+            - insider: 变动人
+            - shares_changed: 变动股数
+            - avg_price: 成交均价
+            - shares_after: 变动后持股数
+            - relationship: 与董监高关系
+            - position: 董监高职务
+        """
+        raw_df = ak.stock_inner_trade_xq()
+        if self.symbol:
+            xueqiu_symbol = convert_xieqiu_symbol(self.symbol)
+            raw_df = raw_df[raw_df["股票代码"] == xueqiu_symbol]
+        return self._clean_insider_data(raw_df)
+
+    def _clean_insider_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
+        """清理和标准化内部交易数据
+
+        Args:
+            raw_df: Raw DataFrame from XueQiu API
+
+        Returns:
+            Standardized DataFrame with consistent columns
+        """
+        column_mapping = {
+            "股票代码": "symbol",
+            "股票名称": "issuer",
+            "变动人": "name",
+            "董监高职务": "title",
+            "变动日期": "transaction_date",
+            "变动股数": "transaction_shares",
+            "成交均价": "transaction_price_per_share",
+            "变动后持股数": "shares_owned_after_transaction",
+            "与董监高关系": "relationship",
+        }
+
+        df = raw_df.rename(columns=column_mapping)
+
+        # Convert symbol back to original format (remove SH/SZ prefix)
+        if "symbol" in df.columns:
+            df["symbol"] = df["symbol"].str.replace(r"^[A-Z]{2}", "", regex=True)
+
+        # Add is_board_director column
+        df["is_board_director"] = df["title"].str.contains("董事")
+
+        # Calculate transaction_value
+        if (
+            "transaction_shares" in df.columns
+            and "transaction_price_per_share" in df.columns
+        ):
+            df["transaction_value"] = (
+                df["transaction_shares"] * df["transaction_price_per_share"]
+            )
+
+        # Add shares_owned_before_transaction if possible
+        if (
+            "shares_owned_after_transaction" in df.columns
+            and "transaction_shares" in df.columns
+        ):
+            df["shares_owned_before_transaction"] = (
+                df["shares_owned_after_transaction"] - df["transaction_shares"]
+            )
+
+        # Convert date format
+        if "transaction_date" in df.columns:
+            df["transaction_date"] = pd.to_datetime(
+                df["transaction_date"]
+            ).dt.tz_localize("Asia/Shanghai")
+
+        if "filing_date" in df.columns:
+            df["filing_date"] = pd.to_datetime(df["filing_date"]).dt.tz_localize(
+                "Asia/Shanghai"
+            )
+
+        # Convert numeric columns
+        numeric_cols = [
+            "transaction_shares",
+            "transaction_price_per_share",
+            "transaction_value",
+            "shares_owned_before_transaction",
+            "shares_owned_after_transaction",
+        ]
+        for col in numeric_cols:
+            if col in df.columns:
+                df[col] = pd.to_numeric(df[col], errors="coerce")
+
+        return df.reset_index(drop=True)

akshare_one/modules/news/base.py

@@ -1,22 +1,22 @@
-from abc import ABC, abstractmethod
-import pandas as pd
-
-
-class NewsDataProvider(ABC):
-    def __init__(self, symbol: str) -> None:
-        self.symbol = symbol
-
-    @abstractmethod
-    def get_news_data(self) -> pd.DataFrame:
-        """Fetches news data for given symbol
-
-        Returns:
-            pd.DataFrame:
-            - keyword: 关键词
-            - title: 新闻标题
-            - content: 新闻内容
-            - publish_time: 发布时间
-            - source: 文章来源
-            - url: 新闻链接
-        """
-        pass
+from abc import ABC, abstractmethod
+import pandas as pd
+
+
+class NewsDataProvider(ABC):
+    def __init__(self, symbol: str) -> None:
+        self.symbol = symbol
+
+    @abstractmethod
+    def get_news_data(self) -> pd.DataFrame:
+        """Fetches news data for given symbol
+
+        Returns:
+            pd.DataFrame:
+            - keyword: 关键词
+            - title: 新闻标题
+            - content: 新闻内容
+            - publish_time: 发布时间
+            - source: 文章来源
+            - url: 新闻链接
+        """
+        pass