akshare 1.15.5__py3-none-any.whl → 1.15.6__py3-none-any.whl

akshare/__init__.py

@@ -2915,9 +2915,10 @@ amac_manager_cancelled_info # 中国证券投资基金业协会-信息公示-诚
 1.15.3 fix: fix stock_share_change_cninfo interface
 1.15.4 fix: fix stock_allotment_cninfo interface
 1.15.5 fix: fix stock_individual_spot_xq interface
+1.15.6 fix: fix qdii_e_index_jsl interface
 """
 
-__version__ = "1.15.5"
+__version__ = "1.15.6"
 __author__ = "AKFamily"
 
 import sys
@@ -5381,6 +5382,18 @@ from akshare.fund.fund_xq import (
     fund_individual_detail_hold_xq,
 )
 
+"""
+异常处理模块
+"""
+from .exceptions import (
+    AkshareException,
+    APIError,
+    DataParsingError,
+    InvalidParameterError,
+    NetworkError,
+    RateLimitError,
+)
+
 """
 Pro API 设置
 """

akshare/exceptions.py

@@ -0,0 +1,43 @@
+"""
+AKShare 异常处理模块
+"""
+
+
+class AkshareException(Exception):
+    """Base exception for akshare library"""
+
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)
+
+
+class APIError(AkshareException):
+    """Raised when API request fails"""
+
+    def __init__(self, message, status_code=None):
+        self.status_code = status_code
+        super().__init__(f"API Error: {message} (Status code: {status_code})")
+
+
+class DataParsingError(AkshareException):
+    """Raised when data parsing fails"""
+
+    pass
+
+
+class InvalidParameterError(AkshareException):
+    """Raised when an invalid parameter is provided"""
+
+    pass
+
+
+class NetworkError(AkshareException):
+    """Raised when network-related issues occur"""
+
+    pass
+
+
+class RateLimitError(AkshareException):
+    """Raised when API rate limit is exceeded"""
+
+    pass

akshare/qdii/qdii_jsl.py

@@ -7,7 +7,8 @@ Desc: 集思录-T+0 QDII
 """
 
 import pandas as pd
-import requests
+
+from akshare.request import make_request_with_retry_json
 
 
 def qdii_e_index_jsl() -> pd.DataFrame:
@@ -22,8 +23,7 @@ def qdii_e_index_jsl() -> pd.DataFrame:
         "___jsl": "LST___t=1728207798534",
         "rp": "22",
     }
-    r = requests.get(url, params=params)
-    data_json = r.json()
+    data_json = make_request_with_retry_json(url, params)
     temp_df = pd.DataFrame([item["cell"] for item in data_json["rows"]])
     temp_df.rename(
         columns={
@@ -94,8 +94,7 @@ def qdii_e_comm_jsl() -> pd.DataFrame:
         "___jsl": "LST___t=1728207798534",
         "rp": "22",
     }
-    r = requests.get(url, params=params)
-    data_json = r.json()
+    data_json = make_request_with_retry_json(url, params=params)
     temp_df = pd.DataFrame([item["cell"] for item in data_json["rows"]])
     temp_df.rename(
         columns={
@@ -166,8 +165,7 @@ def qdii_a_index_jsl() -> pd.DataFrame:
         "___jsl": "LST___t=1728206439242",
         "rp": "22",
     }
-    r = requests.get(url, params=params)
-    data_json = r.json()
+    data_json = make_request_with_retry_json(url, params=params)
     temp_df = pd.DataFrame([item["cell"] for item in data_json["rows"]])
     temp_df.rename(
         columns={

akshare/request.py

@@ -0,0 +1,117 @@
+import time
+
+import requests
+from requests.exceptions import RequestException
+
+from akshare.exceptions import NetworkError, APIError, RateLimitError, DataParsingError
+from akshare.utils.context import config
+
+
+def make_request_with_retry_json(
+    url, params=None, headers=None, proxies=None, max_retries=3, retry_delay=1
+):
+    """
+    发送 HTTP GET 请求，支持重试机制和代理设置。
+
+    :param url: 请求的 URL
+    :param params: URL 参数 (可选)
+    :param headers: 请求头 (可选)
+    :param proxies: 代理设置 (可选)
+    :param max_retries: 最大重试次数
+    :param retry_delay: 初始重试延迟（秒）
+    :return: 解析后的 JSON 数据
+    """
+    if proxies is None:
+        proxies = config.proxies
+    for attempt in range(max_retries):
+        try:
+            response = requests.get(
+                url, params=params, headers=headers, proxies=proxies
+            )
+            if response.status_code == 200:
+                try:
+                    data = response.json()
+                    if not data:
+                        raise DataParsingError("Empty response data")
+                    return data
+                except ValueError:
+                    raise DataParsingError("Failed to parse JSON response")
+            elif response.status_code == 429:
+                raise RateLimitError(
+                    f"Rate limit exceeded. Status code: {response.status_code}"
+                )
+            else:
+                raise APIError(
+                    f"API request failed. Status code: {response.status_code}"
+                )
+
+        except (RequestException, RateLimitError, APIError, DataParsingError) as e:
+            if attempt == max_retries - 1:
+                if isinstance(e, RateLimitError):
+                    raise
+                elif isinstance(e, (APIError, DataParsingError)):
+                    raise
+                else:
+                    raise NetworkError(
+                        f"Failed to connect after {max_retries} attempts: {str(e)}"
+                    )
+
+            time.sleep(retry_delay)
+            retry_delay *= 2  # 指数退避策略
+
+    raise NetworkError(f"Failed to connect after {max_retries} attempts")
+
+
+def make_request_with_retry_text(
+    url, params=None, headers=None, proxies=None, max_retries=3, retry_delay=1
+):
+    """
+    发送 HTTP GET 请求，支持重试机制和代理设置。
+
+    :param url: 请求的 URL
+    :param params: URL 参数 (可选)
+    :param headers: 请求头 (可选)
+    :param proxies: 代理设置 (可选)
+    :param max_retries: 最大重试次数
+    :param retry_delay: 初始重试延迟（秒）
+    :return: 解析后的 JSON 数据
+    """
+    if proxies is None:
+        proxies = config.proxies
+    for attempt in range(max_retries):
+        try:
+            response = requests.get(
+                url, params=params, headers=headers, proxies=proxies
+            )
+            if response.status_code == 200:
+                try:
+                    data = response.text
+                    if not data:
+                        raise DataParsingError("Empty response data")
+                    return data
+                except ValueError:
+                    raise DataParsingError("Failed to parse JSON response")
+            elif response.status_code == 429:
+                raise RateLimitError(
+                    f"Rate limit exceeded. Status code: {response.status_code}"
+                )
+            else:
+                raise APIError(
+                    f"API request failed. Status code: {response.status_code}"
+                )
+
+        except (RequestException, RateLimitError, APIError, DataParsingError) as e:
+            if attempt == max_retries - 1:
+                if isinstance(e, RateLimitError):
+                    raise
+                elif isinstance(e, (APIError, DataParsingError)):
+                    raise
+                else:
+                    raise NetworkError(
+                        f"Failed to connect after {max_retries} attempts: {str(e)}"
+                    )
+
+            time.sleep(retry_delay)
+            retry_delay *= 2  # 指数退避策略
+
+    raise NetworkError(f"Failed to connect after {max_retries} attempts")

akshare/utils/context.py

@@ -0,0 +1,43 @@
+class AkshareConfig:
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance.proxies = None
+        return cls._instance
+
+    @classmethod
+    def set_proxies(cls, proxies):
+        cls().proxies = proxies
+
+    @classmethod
+    def get_proxies(cls):
+        return cls().proxies
+
+
+config = AkshareConfig()
+
+
+# 导出 set_proxies 函数
+def set_proxies(proxies):
+    config.set_proxies(proxies)
+
+
+def get_proxies():
+    return config.get_proxies()
+
+
+class ProxyContext:
+    def __init__(self, proxies):
+        self.proxies = proxies
+        self.old_proxies = None
+
+    def __enter__(self):
+        self.old_proxies = config.get_proxies()
+        config.set_proxies(self.proxies)
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        config.set_proxies(self.old_proxies)
+        return False  # 不处理异常

{akshare-1.15.5.dist-info → akshare-1.15.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: akshare
-Version: 1.15.5
+Version: 1.15.6
 Summary: AKShare is an elegant and simple financial data interface library for Python, built for human beings!
 Home-page: https://github.com/akfamily/akshare
 Author: AKFamily

{akshare-1.15.5.dist-info → akshare-1.15.6.dist-info}/RECORD

@@ -1,5 +1,7 @@
-akshare/__init__.py,sha256=RVQQLjzfjvxNz6LMAMY_pIQKz8qCSZzedyRMtRmv7X8,182499
+akshare/__init__.py,sha256=i8uUAu291ta8SavpyTgeKrwLT1Qu3aSmxaWdO3Ca0Wo,182721
 akshare/datasets.py,sha256=-qdwaQjgBlftX84uM74KJqCYJYkQ50PV416_neA4uls,995
+akshare/exceptions.py,sha256=WEJjIhSmJ_xXNW6grwV4nufE_cfmmyuhmueVGiN1VAg,878
+akshare/request.py,sha256=HtFFf9MhfEibR-ETWe-1Tts6ELU4VKSqA-ghaXjegQM,4252
 akshare/air/__init__.py,sha256=RMTf1bT5EOE3ttWpn3hGu1LtUmsVxDoa0W7W0gXHOy8,81
 akshare/air/air_hebei.py,sha256=xIXNGLK7IGYqrkteM9fxnHAwWqk6PCQs6D9-ggZ7byY,4442
 akshare/air/air_zhenqi.py,sha256=FurRxuYyoZpTa2lsP6BgUJfbfMgOO26_VPuc-ekKZXs,9636
@@ -210,7 +212,7 @@ akshare/pro/client.py,sha256=p9r3fZYGgfMplQwGLo8oPAen8w65xennP5D1Ca89im4,2248
 akshare/pro/cons.py,sha256=xckSrLyYcd2pY822GH8BEE9DFo-eu7wIF2XFeIu-uwk,244
 akshare/pro/data_pro.py,sha256=xeuQ_fcJ8qOeleITkr-Yo0OjyCuWHE0ydq3q8AE5PAY,830
 akshare/qdii/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-akshare/qdii/qdii_jsl.py,sha256=2zkHCQKTVg31lke9b8aRvFHTBJ3v97ds6V4JmAsnX98,7888
+akshare/qdii/qdii_jsl.py,sha256=-BbTDkrevK65D3x9xSc3v8KJPT88nIuJK9K_9q3UP2A,7920
 akshare/qhkc/__init__.py,sha256=RMTf1bT5EOE3ttWpn3hGu1LtUmsVxDoa0W7W0gXHOy8,81
 akshare/qhkc/qhkc_api.py,sha256=1dGkMzxdS1p1z5aeXTeIvA2VbQzZAOP1bCZPTySkGDo,8235
 akshare/qhkc_web/__init__.py,sha256=RMTf1bT5EOE3ttWpn3hGu1LtUmsVxDoa0W7W0gXHOy8,81
@@ -372,14 +374,15 @@ akshare/tool/__init__.py,sha256=RMTf1bT5EOE3ttWpn3hGu1LtUmsVxDoa0W7W0gXHOy8,81
 akshare/tool/trade_date_hist.py,sha256=o9021QHdOEVucjynFl0jLEi1PEMlNxvDKnMsFSwRfqg,1431
 akshare/utils/__init__.py,sha256=HbKUP2vZApbeK2PTZVO_m-6kAUymfDwm2yv3Kr4R_1A,81
 akshare/utils/cons.py,sha256=PFZndkG3lMW1Qhg-wqcZmSowFXwQUsYYCLZT4s1Xkwc,225
+akshare/utils/context.py,sha256=Hl4kPUzQ1CecRzu5JvTKpTpiMLfzAzYzG7F5hktlsCQ,934
 akshare/utils/demjson.py,sha256=xW2z0UGS2zzyH_dzhd765ZveuXRbfjkM7KBiI8H5fJA,241609
 akshare/utils/func.py,sha256=PDkwpyCjZCbCLSAG9wBQt-sYNtb1XlpUBvhAfuSLf3s,586
 akshare/utils/token_process.py,sha256=K4rGXjh_tgugbRcyOK2h2x0jP3PT65IIK7nxhUKhOeQ,666
 akshare/utils/tqdm.py,sha256=MuPNwcswkOGjwWQOMWXi9ZvQ_RmW4obCWRj2i7HM7FE,847
 tests/__init__.py,sha256=gNzhlO0UPjFq6Ieb38kaVIODXv4cTDByrdohAZnDYt4,82
 tests/test_func.py,sha256=j1MGYbZI2if2j_LY1S4FLsf4qfq4NwVqD5wmRlv5Log,832
-akshare-1.15.5.dist-info/LICENSE,sha256=mmSZCPgfHiVw34LXuFArd-SUgQtBJ_QsIlh-kWlDHfs,1073
-akshare-1.15.5.dist-info/METADATA,sha256=_JK5l9jVCLzQX1T_0BpvithT4dW3YYrG__POzHYrj-c,14162
-akshare-1.15.5.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-akshare-1.15.5.dist-info/top_level.txt,sha256=jsf9ZzZPmHaISTVumQPsAw7vv7Yv-PdEVW70SMEelQQ,14
-akshare-1.15.5.dist-info/RECORD,,
+akshare-1.15.6.dist-info/LICENSE,sha256=mmSZCPgfHiVw34LXuFArd-SUgQtBJ_QsIlh-kWlDHfs,1073
+akshare-1.15.6.dist-info/METADATA,sha256=STv32lzoJVQVkspXzHNp_pJy1n5c0Vvm-jXh8WbZrMU,14162
+akshare-1.15.6.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
+akshare-1.15.6.dist-info/top_level.txt,sha256=jsf9ZzZPmHaISTVumQPsAw7vv7Yv-PdEVW70SMEelQQ,14
+akshare-1.15.6.dist-info/RECORD,,