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

akshare/__init__.py

@@ -2915,9 +2915,11 @@ 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
+1.15.7 fix: fix index_hist_sw interface
 """
 
-__version__ = "1.15.5"
+__version__ = "1.15.7"
 __author__ = "AKFamily"
 
 import sys
@@ -5381,6 +5383,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/index/index_research_sw.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python
 # -*- coding:utf-8 -*-
 """
-Date: 2024/5/22 15:00
+Date: 2024/10/23 13:00
 Desc: 申万宏源研究-指数系列
-https://www.swhyresearch.com/institute_sw/allIndex/releasedIndex
+https://www.swsresearch.com/institute_sw/allIndex/releasedIndex
 """
 
 import math
@@ -17,7 +17,7 @@ from akshare.utils.tqdm import get_tqdm
 def index_hist_sw(symbol: str = "801030", period: str = "day") -> pd.DataFrame:
     """
     申万宏源研究-指数发布-指数详情-指数历史数据
-    https://www.swhyresearch.com/institute_sw/allIndex/releasedIndex/releasedetail?code=801001&name=%E7%94%B3%E4%B8%8750
+    https://www.swsresearch.com/institute_sw/allIndex/releasedIndex/releasedetail?code=801001&name=%E7%94%B3%E4%B8%8750
     :param symbol: 指数代码
     :type symbol: str
     :param period: choice of {"day", "week", "month"}
@@ -30,7 +30,7 @@ def index_hist_sw(symbol: str = "801030", period: str = "day") -> pd.DataFrame:
         "week": "WEEK",
         "month": "MONTH",
     }
-    url = "https://www.swhyresearch.com/institute-sw/api/index_publish/trend/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_publish/trend/"
     params = {
         "swindexcode": symbol,
         "period": period_map[period],
@@ -81,14 +81,14 @@ def index_hist_sw(symbol: str = "801030", period: str = "day") -> pd.DataFrame:
 def index_min_sw(symbol: str = "801001") -> pd.DataFrame:
     """
     申万宏源研究-指数发布-指数详情-指数分时数据
-    https://www.swhyresearch.com/institute_sw/allIndex/releasedIndex/releasedetail?code=801001&name=%E7%94%B3%E4%B8%8750
+    https://www.swsresearch.com/institute_sw/allIndex/releasedIndex/releasedetail?code=801001&name=%E7%94%B3%E4%B8%8750
     :param symbol: 指数代码
     :type symbol: str
     :return: 指数分时数据
     :rtype: pandas.DataFrame
     """
     url = (
-        "https://www.swhyresearch.com/institute-sw/api/index_publish/details/timelines/"
+        "https://www.swsresearch.com/institute-sw/api/index_publish/details/timelines/"
     )
     params = {
         "swindexcode": symbol,
@@ -127,13 +127,13 @@ def index_min_sw(symbol: str = "801001") -> pd.DataFrame:
 def index_component_sw(symbol: str = "801001") -> pd.DataFrame:
     """
     申万宏源研究-指数发布-指数详情-成分股
-    https://www.swhyresearch.com/institute_sw/allIndex/releasedIndex/releasedetail?code=801001&name=%E7%94%B3%E4%B8%8750
+    https://www.swsresearch.com/institute_sw/allIndex/releasedIndex/releasedetail?code=801001&name=%E7%94%B3%E4%B8%8750
     :param symbol: 指数代码
     :type symbol: str
     :return: 成分股
     :rtype: pandas.DataFrame
     """
-    url = "https://www.swhyresearch.com/institute-sw/api/index_publish/details/component_stocks/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_publish/details/component_stocks/"
     params = {"swindexcode": symbol, "page": "1", "page_size": "10000"}
     headers = {
         "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
@@ -221,7 +221,7 @@ def __index_realtime_sw(symbol: str = "大类风格指数") -> pd.DataFrame:
 def index_realtime_sw(symbol: str = "二级行业") -> pd.DataFrame:
     """
     申万宏源研究-指数系列
-    https://www.swhyresearch.com/institute_sw/allIndex/releasedIndex
+    https://www.swsresearch.com/institute_sw/allIndex/releasedIndex
     :param symbol: choice of {"市场表征", "一级行业", "二级行业", "风格指数", "大类风格指数", "金创指数"}
     :type symbol: str
     :return: 指数系列实时行情数据
@@ -230,7 +230,7 @@ def index_realtime_sw(symbol: str = "二级行业") -> pd.DataFrame:
     if symbol in {"大类风格指数", "金创指数"}:
         temp_df = __index_realtime_sw(symbol)
         return temp_df
-    url = "https://www.swhyresearch.com/institute-sw/api/index_publish/current/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_publish/current/"
     params = {"page": "1", "page_size": "50", "indextype": symbol}
     headers = {
         "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
@@ -289,7 +289,7 @@ def index_analysis_daily_sw(
 ) -> pd.DataFrame:
     """
     申万宏源研究-指数分析
-    https://www.swhyresearch.com/institute_sw/allIndex/analysisIndex
+    https://www.swsresearch.com/institute_sw/allIndex/analysisIndex
     :param symbol: choice of {"市场表征", "一级行业", "二级行业", "风格指数"}
     :type symbol: str
     :param start_date: 开始日期
@@ -299,7 +299,7 @@ def index_analysis_daily_sw(
     :return: 指数分析
     :rtype: pandas.DataFrame
     """
-    url = "https://www.swhyresearch.com/institute-sw/api/index_analysis/index_analysis_report/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_analysis/index_analysis_report/"
     params = {
         "page": "1",
         "page_size": "50",
@@ -363,13 +363,13 @@ def index_analysis_daily_sw(
 def index_analysis_week_month_sw(symbol: str = "month") -> pd.DataFrame:
     """
     申万宏源研究-周/月报表-日期序列
-    https://www.swhyresearch.com/institute_sw/allIndex/analysisIndex
+    https://www.swsresearch.com/institute_sw/allIndex/analysisIndex
     :param symbol: choice of {"week", "month"}
     :type symbol: str
     :return: 日期序列
     :rtype: pandas.DataFrame
     """
-    url = "https://www.swhyresearch.com/institute-sw/api/index_analysis/week_month_datetime/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_analysis/week_month_datetime/"
     params = {"type": symbol.upper()}
     headers = {
         "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
@@ -392,7 +392,7 @@ def index_analysis_weekly_sw(
 ) -> pd.DataFrame:
     """
     申万宏源研究-指数分析-周报告
-    https://www.swhyresearch.com/institute_sw/allIndex/analysisIndex
+    https://www.swsresearch.com/institute_sw/allIndex/analysisIndex
     :param symbol: choice of {"市场表征", "一级行业", "二级行业", "风格指数"}
     :type symbol: str
     :param date: 查询日期; 通过调用 ak.index_analysis_week_month_sw(date="20221104") 接口获取
@@ -400,7 +400,7 @@ def index_analysis_weekly_sw(
     :return: 指数分析
     :rtype: pandas.DataFrame
     """
-    url = "https://www.swhyresearch.com/institute-sw/api/index_analysis/index_analysis_reports/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_analysis/index_analysis_reports/"
     params = {
         "page": "1",
         "page_size": "50",
@@ -467,7 +467,7 @@ def index_analysis_monthly_sw(
 ) -> pd.DataFrame:
     """
     申万宏源研究-指数分析-月报告
-    https://www.swhyresearch.com/institute_sw/allIndex/analysisIndex
+    https://www.swsresearch.com/institute_sw/allIndex/analysisIndex
     :param symbol: choice of {"市场表征", "一级行业", "二级行业", "风格指数"}
     :type symbol: str
     :param date: 查询日期; 通过调用 ak.index_analysis_week_month_sw() 接口获取
@@ -475,7 +475,7 @@ def index_analysis_monthly_sw(
     :return: 指数分析
     :rtype: pandas.DataFrame
     """
-    url = "https://www.swhyresearch.com/institute-sw/api/index_analysis/index_analysis_reports/"
+    url = "https://www.swsresearch.com/institute-sw/api/index_analysis/index_analysis_reports/"
     params = {
         "page": "1",
         "page_size": "50",

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.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: akshare
-Version: 1.15.5
+Version: 1.15.7
 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.7.dist-info}/RECORD

@@ -1,5 +1,7 @@
-akshare/__init__.py,sha256=RVQQLjzfjvxNz6LMAMY_pIQKz8qCSZzedyRMtRmv7X8,182499
+akshare/__init__.py,sha256=vfCF9ySFLGxFuyhcKTsyFu6lc2fITKrzVvB8O4jO7IM,182761
 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
@@ -163,7 +165,7 @@ akshare/index/index_kq_fz.py,sha256=Y-cbxWLpRyGcFcMSDxZZQXdAuD85IuQH5xC2rhtGbRc,
 akshare/index/index_kq_ss.py,sha256=m4hAMNnzHk8JNAnKjkYYVeyG4zUC5zR5i0-u-OxmaGU,3333
 akshare/index/index_option_qvix.py,sha256=sCx0iiIetkp5ELE9sDwesVFgJNfa_1tAEWVCJI-I2u4,3270
 akshare/index/index_research_fund_sw.py,sha256=kVYjBl3vZg6CyYBCrxZiSv8taHMnqmG7PQ-LVmMNd3I,4603
-akshare/index/index_research_sw.py,sha256=HXPvT-GLPMQw67iwlxvWaDl7mxKErm6-6ScrP0S5RTk,21774
+akshare/index/index_research_sw.py,sha256=w9_weAnaUQcoW_qoK89bz3iHvkJR4VseMrHZjLSNUrc,21758
 akshare/index/index_spot.py,sha256=HrXt2QC9i1pYEh7wyJPKjtexctzSIUyMjEzk5BQq_K8,1696
 akshare/index/index_stock_hk.py,sha256=nPFzRrjyiUpRK-OSDsdi5AFCKHNKqOVji6WJcQxOvNo,9781
 akshare/index/index_stock_us_sina.py,sha256=IxOk4G49oasv7EfEQenL9-GLuelyUus6c4JPyRlaOzY,1551
@@ -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.7.dist-info/LICENSE,sha256=mmSZCPgfHiVw34LXuFArd-SUgQtBJ_QsIlh-kWlDHfs,1073
+akshare-1.15.7.dist-info/METADATA,sha256=nXpTBhzgpBffj0ByJRW5ESf-hAvSI_cbh7cQouc7mKw,14162
+akshare-1.15.7.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
+akshare-1.15.7.dist-info/top_level.txt,sha256=jsf9ZzZPmHaISTVumQPsAw7vv7Yv-PdEVW70SMEelQQ,14
+akshare-1.15.7.dist-info/RECORD,,