akshare 1.12.99__py3-none-any.whl → 1.15.72__py3-none-any.whl

akshare/stock_fundamental/stock_zygc.py

@@ -1,11 +1,12 @@
 # -*- coding:utf-8 -*-
 # !/usr/bin/env python
 """
-Date: 2023/11/27 16:30
+Date: 2024/9/3 16:30
 Desc: 主营构成
 https://emweb.securities.eastmoney.com/PC_HSF10/BusinessAnalysis/Index?type=web&code=SH688041#
-http://f10.emoney.cn/f10/zbyz/1000001
+https://f10.emoney.cn/f10/zbyz/1000001
 """
+
 from io import StringIO
 
 import pandas as pd
@@ -16,7 +17,7 @@ from bs4 import BeautifulSoup
 def stock_zygc_ym(symbol: str = "000001") -> pd.DataFrame:
     """
     益盟-F10-主营构成
-    http://f10.emoney.cn/f10/zbyz/1000001
+    https://f10.emoney.cn/f10/zbyz/1000001
     :param symbol: 股票代码
     :type symbol: str
     :return: 主营构成
@@ -24,12 +25,11 @@ def stock_zygc_ym(symbol: str = "000001") -> pd.DataFrame:
     """
     url = f"http://f10.emoney.cn/f10/zygc/{symbol}"
     r = requests.get(url)
-    soup = BeautifulSoup(r.text, "lxml")
+    soup = BeautifulSoup(r.text, features="lxml")
     year_list = [
         item.text.strip()
         for item in soup.find(attrs={"class": "swlab_t"}).find_all("li")
     ]
-
     big_df = pd.DataFrame()
     for i, item in enumerate(year_list, 2):
         temp_df = pd.read_html(StringIO(r.text), header=0)[i]
@@ -113,8 +113,10 @@ def stock_zygc_em(symbol: str = "SH688041") -> pd.DataFrame:
             "毛利率",
         ]
     ]
-    temp_df["报告日期"] = pd.to_datetime(temp_df["报告日期"]).dt.date
-    temp_df["分类类型"] = temp_df["分类类型"].map({"2": "按产品分类", "3": "按地区分类"})
+    temp_df["报告日期"] = pd.to_datetime(temp_df["报告日期"], errors="coerce").dt.date
+    temp_df["分类类型"] = temp_df["分类类型"].map(
+        {"2": "按产品分类", "3": "按地区分类"}
+    )
     temp_df["主营收入"] = pd.to_numeric(temp_df["主营收入"], errors="coerce")
     temp_df["收入比例"] = pd.to_numeric(temp_df["收入比例"], errors="coerce")
     temp_df["主营成本"] = pd.to_numeric(temp_df["主营成本"], errors="coerce")
@@ -126,7 +128,7 @@ def stock_zygc_em(symbol: str = "SH688041") -> pd.DataFrame:
 
 
 if __name__ == "__main__":
-    stock_zygc_ym_df = stock_zygc_ym(symbol="000001")
+    stock_zygc_ym_df = stock_zygc_ym(symbol="000338")
     print(stock_zygc_ym_df)
 
     stock_zygc_em_df = stock_zygc_em(symbol="SH688041")

akshare/stock_fundamental/stock_zyjs_ths.py

@@ -1,10 +1,11 @@
 # -*- coding:utf-8 -*-
 # !/usr/bin/env python
 """
-Date: 2023/2/2 11:30
+Date: 2024/3/29 10:30
 Desc: 同花顺-主营介绍
 https://basic.10jqka.com.cn/new/000066/operate.html
 """
+
 import pandas as pd
 import requests
 from bs4 import BeautifulSoup
@@ -19,9 +20,10 @@ def stock_zyjs_ths(symbol: str = "000066") -> pd.DataFrame:
     :return: 主营介绍
     :rtype: pandas.DataFrame
     """
-    url = f"http://basic.10jqka.com.cn/new/{symbol}/operate.html"
+    url = f"https://basic.10jqka.com.cn/new/{symbol}/operate.html"
     headers = {
-        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36"
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
+        "Chrome/109.0.0.0 Safari/537.36"
     }
     r = requests.get(url, headers=headers)
     r.encoding = "gb2312"

akshare/tool/trade_date_hist.py

@@ -1,16 +1,17 @@
 #!/usr/bin/env python
 # -*- coding:utf-8 -*-
 """
-Date: 2023/12/27 22:27
+Date: 2024/3/25 16:30
 Desc: 新浪财经-交易日历
 https://finance.sina.com.cn/realstock/company/klc_td_sh.txt
 此处可以用来更新 calendar.json 文件，注意末尾没有 "," 号
 """
+
 import datetime
 
 import pandas as pd
 import requests
-from py_mini_racer import py_mini_racer
+import py_mini_racer
 
 from akshare.stock.cons import hk_js_decode
 
@@ -32,7 +33,7 @@ def tool_trade_date_hist_sina() -> pd.DataFrame:
     temp_df["trade_date"] = pd.to_datetime(temp_df["trade_date"]).dt.date
     temp_list = temp_df["trade_date"].to_list()
     # 该日期是交易日，但是在新浪返回的交易日历缺失该日期，这里补充上
-    temp_list.append(datetime.date(1992, 5, 4))
+    temp_list.append(datetime.date(year=1992, month=5, day=4))
     temp_list.sort()
     temp_df = pd.DataFrame(temp_list, columns=["trade_date"])
     return temp_df

akshare/utils/cons.py

@@ -0,0 +1,10 @@
+# !/usr/bin/env python
+"""
+Date: 2024/4/7 15:30
+Desc: 通用变量
+"""
+
+headers = {
+    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
+    "Chrome/114.0.0.0 Safari/537.36"
+}

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/utils/demjson.py

@@ -117,7 +117,7 @@ def determine_float_limits(number_type=float):
     else:
         numeric_exceptions = (ValueError,)
 
-    if decimal and number_type == decimal.Decimal:
+    if decimal and number_type is decimal.Decimal:
         number_type = decimal.DefaultContext
 
     if decimal and isinstance(number_type, decimal.Context):
@@ -125,7 +125,7 @@ def determine_float_limits(number_type=float):
         create_num = number_type.create_decimal
         decimal_ctx = decimal.localcontext(number_type)
         is_zero_or_subnormal = lambda n: n.is_zero() or n.is_subnormal()
-    elif number_type == float:
+    elif number_type is float:
         create_num = number_type
         decimal_ctx = _dummy_context_manager
         is_zero_or_subnormal = lambda n: n == 0

akshare/utils/func.py

@@ -0,0 +1,26 @@
+# !/usr/bin/env python
+"""
+Date: 2024/4/7 15:30
+Desc: 通用帮助函数
+"""
+
+from typing import List
+
+import pandas as pd
+
+
+def set_df_columns(df: pd.DataFrame, cols: List[str]) -> pd.DataFrame:
+    """
+    设置 pandas.DataFrame 为空的情况
+    :param df: 需要设置命名的数据框
+    :type df: pandas.DataFrame
+    :param cols: 字段的列表
+    :type cols: list
+    :return: 重新设置后的数据
+    :rtype: pandas.DataFrame
+    """
+    if df.shape == (0, 0):
+        return pd.DataFrame(data=[], columns=cols)
+    else:
+        df.columns = cols
+        return df

akshare/utils/tqdm.py

@@ -1,12 +1,22 @@
-def get_tqdm():
+def get_tqdm(enable: bool = True):
     """
     返回适用于当前环境的 tqdm 对象。
+
+    Args:
+        enable (bool): 是否启用进度条。默认为 True。
+
+    Returns:
+        tqdm 对象。
     """
+    if not enable:
+        # 如果进度条被禁用，返回一个不显示进度条的 tqdm 对象
+        return lambda iterable, *args, **kwargs: iterable
+
     try:
-        # 尝试检查是否在 Jupyter notebook 环境中，有利于退出进度条
+        # 尝试检查是否在 jupyter notebook 环境中，有利于退出进度条
         # noinspection PyUnresolvedReferences
         shell = get_ipython().__class__.__name__
-        if shell == 'ZMQInteractiveShell':
+        if shell == "ZMQInteractiveShell":
             from tqdm.notebook import tqdm
         else:
             from tqdm import tqdm

{akshare-1.12.99.dist-info → akshare-1.15.72.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: akshare
-Version: 1.12.99
+Version: 1.15.72
 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
@@ -12,39 +12,56 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: beautifulsoup4 >=4.9.1
-Requires-Dist: lxml >=4.2.1
-Requires-Dist: pandas >=0.25
-Requires-Dist: requests >=2.22.0
-Requires-Dist: pypinyin >=0.35.0
-Requires-Dist: html5lib >=1.0.1
-Requires-Dist: xlrd >=1.2.0
-Requires-Dist: urllib3 >=1.25.8
-Requires-Dist: tqdm >=4.43.0
-Requires-Dist: openpyxl >=3.0.3
-Requires-Dist: jsonpath >=0.82
-Requires-Dist: tabulate >=0.8.6
-Requires-Dist: decorator >=4.4.2
-Requires-Dist: py-mini-racer >=0.6.0
-Requires-Dist: akracer >=0.0.11
-Requires-Dist: pyarrow >=15.0.0
+Requires-Dist: beautifulsoup4>=4.9.1
+Requires-Dist: lxml>=4.2.1
+Requires-Dist: pandas>=0.25
+Requires-Dist: requests>=2.22.0
+Requires-Dist: html5lib>=1.0.1
+Requires-Dist: xlrd>=1.2.0
+Requires-Dist: urllib3>=1.25.8
+Requires-Dist: tqdm>=4.43.0
+Requires-Dist: openpyxl>=3.0.3
+Requires-Dist: jsonpath>=0.82
+Requires-Dist: tabulate>=0.8.6
+Requires-Dist: decorator>=4.4.2
+Requires-Dist: mini-racer>=0.12.4; platform_system != "Linux"
+Requires-Dist: py-mini-racer>=0.6.0; platform_system == "Linux"
+Requires-Dist: akracer[py-mini-racer]>=0.0.13; platform_system == "Linux"
 Provides-Extra: full
-Requires-Dist: akqmt ; extra == 'full'
+Requires-Dist: akqmt; extra == "full"
 Provides-Extra: qmt
-Requires-Dist: akqmt ; extra == 'qmt'
-
-**AKShare VIP 交流群欢迎大家的加入，加群方式请点击[【加群】](https://zmj.xet.tech/s/28gOeh)**
-
-**相关视频教程已经发布：《AKShare-初阶-使用教学》、《AKShare-初阶-实战应用》、《AKShare-源码解析》、《开源项目巡礼》**，详情请访问[课程](https://app3rqjh1z21630.h5.xiaoeknow.com)查看更多课程信息！
+Requires-Dist: akqmt; extra == "qmt"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+**欢迎加入专注于财经数据和量化投资的知识社区，请点击[了解更多](https://akshare.akfamily.xyz/learn.html)**
+
+**量化投研视频课程：《PyBroker-入门及实战》已经上架！《PyBroker-进阶及实战》正在更新！**
+
+**更多视频教程已经发布：《AKShare-初阶-使用教学》、《AKShare-初阶-实战应用》、《AKShare-源码解析》、《开源项目巡礼》**，
+详情请关注【数据科学实战】公众号，查看更多课程信息！
 
 **AKQuant 量化教程请访问：[利用 PyBroker 进行量化投资](https://akquant.akfamily.xyz/)**
 
-**本次发布 [AKTools](https://github.com/akfamily/aktools) 作为 AKShare 的 HTTP API 版本，突破 Python 语言的限制，欢迎各位小伙伴试用并提出更好的意见或建议！ 点击 [AKTools](https://github.com/akfamily/aktools) 查看使用指南。另外提供 [awesome-data](https://github.com/akfamily/awesome-data) 方便各位小伙伴查询各种数据源。**
+**本次发布 [AKTools](https://github.com/akfamily/aktools) 作为 AKShare 的 HTTP API 版本，
+突破 Python 语言的限制，欢迎各位小伙伴试用并提出更好的意见或建议！
+点击 [AKTools](https://github.com/akfamily/aktools) 查看使用指南。另外提供 [awesome-data](https://github.com/akfamily/awesome-data) 方便各位小伙伴查询各种数据源。**
 
 ![AKShare Logo](https://github.com/akfamily/akshare/blob/main/assets/images/akshare_logo.jpg)
 
@@ -63,14 +80,13 @@ Requires-Dist: akqmt ; extra == 'qmt'
 
 ## Overview
 
-[AKShare](https://github.com/akfamily/akshare) requires Python(64 bit) 3.8 or greater, aims to make fetch financial data as convenient as possible.
+[AKShare](https://github.com/akfamily/akshare) requires Python(64 bit) 3.8 or higher and
+aims to simplify the process of fetching financial data.
 
 **Write less, get more!**
 
 - Documentation: [中文文档](https://akshare.akfamily.xyz/)
 
-![](https://github.com/akfamily/akshare/blob/main/assets/images/akshare.svg)
-
 ## Installation
 
 ### General
@@ -87,7 +103,8 @@ pip install akshare -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host=mir
 
 ### PR
 
-Please check out [documentation](https://akshare.akfamily.xyz/contributor.html) if you want to contribute to AKShare
+Please check out [Documentation](https://akshare.akfamily.xyz/contributing.html) if you
+want to contribute to AKShare
 
 ### Docker
 
@@ -151,11 +168,9 @@ import akshare as ak
 import mplfinance as mpf  # Please install mplfinance as follows: pip install mplfinance
 
 stock_us_daily_df = ak.stock_us_daily(symbol="AAPL", adjust="qfq")
-stock_us_daily_df = stock_us_daily_df[["open", "high", "low", "close", "volume"]]
-stock_us_daily_df.columns = ["Open", "High", "Low", "Close", "Volume"]
-stock_us_daily_df.index.name = "Date"
+stock_us_daily_df = stock_us_daily_df.set_index(["date"])
 stock_us_daily_df = stock_us_daily_df["2020-04-01": "2020-04-29"]
-mpf.plot(stock_us_daily_df, type='candle', mav=(3, 6, 9), volume=True, show_nontrading=False)
+mpf.plot(stock_us_daily_df, type="candle", mav=(3, 6, 9), volume=True, show_nontrading=False)
 ```
 
 Output:
@@ -164,7 +179,8 @@ Output:
 
 ## Communication
 
-Pay attention to **数据科学实战** Official Accounts to get more information about Quant, ML, DS and so on, please visit [数据科学实战](https://akshare.akfamily.xyz/introduction.html) for more information:
+Welcome to join the **数据科学实战** knowledge planet to learn more about quantitative investment,
+please visit [数据科学实战](https://akshare.akfamily.xyz/learn.html) for more information:
 
 <div>
     <img alt="data science" src="https://jfds-1252952517.cos.ap-chengdu.myqcloud.com/akshare/readme/qrcode/data_scientist.png">
@@ -176,9 +192,6 @@ Pay attention to **数据科学实战** WeChat Official Accounts to get the [AKS
     <img alt="ds" src="https://github.com/akfamily/akshare/blob/main/assets/images/ds.png">
 </div>
 
-Application to add **AKShare-VIP QQ group** and talk about [AKShare](https://github.com/akfamily/akshare) issues, please contact **AKShare-小助手 QQ**: 1254836886
-![QRCode](https://jfds-1252952517.cos.ap-chengdu.myqcloud.com/akshare/readme/qrcode/qr_code_1254836886.jpg)
-
 ## Features
 
 - **Easy of use**: Just one line code to fetch the data;
@@ -256,14 +269,10 @@ Special thanks [TuShare](https://github.com/waditu/tushare) for the opportunity
 
 Thanks for the data provided by [生意社网站](http://www.100ppi.com/);
 
-Thanks for the data provided by [奇货可查网站](https://qhkch.com/);
-
 Thanks for the data provided by [中国银行间市场交易商协会网站](http://www.nafmii.org.cn/);
 
 Thanks for the data provided by [99期货网站](http://www.99qh.com/);
 
-Thanks for the data provided by [英为财情网站](https://cn.investing.com/);
-
 Thanks for the data provided by [中国外汇交易中心暨全国银行间同业拆借中心网站](http://www.chinamoney.com.cn/chinese/);
 
 Thanks for the data provided by [金十数据网站](https://www.jin10.com/);
@@ -272,8 +281,6 @@ Thanks for the data provided by [和讯财经网站](http://www.hexun.com/);
 
 Thanks for the data provided by [新浪财经网站](https://finance.sina.com.cn/);
 
-Thanks for the data provided by [Oxford-Man Institute 网站](https://realized.oxford-man.ox.ac.uk/);
-
 Thanks for the data provided by [DACHENG-XIU 网站](https://dachxiu.chicagobooth.edu/);
 
 Thanks for the data provided by [上海证券交易所网站](http://www.sse.com.cn/assortment/options/price/);
@@ -300,12 +307,6 @@ Thanks for the data provided by [南华期货网站](http://www.nanhua.net/nhzc/
 
 Thanks for the data provided by [Economic Policy Uncertainty 网站](http://www.nanhua.net/nhzc/varietytrend.html);
 
-Thanks for the data provided by [微博指数网站](https://data.weibo.com/index/newindex);
-
-Thanks for the data provided by [百度指数网站](http://index.baidu.com/v2/main/index.html);
-
-Thanks for the data provided by [谷歌指数网站](https://trends.google.com/trends/?geo=US);
-
 Thanks for the data provided by [申万指数网站](http://www.swsindex.com/idx0120.aspx?columnid=8832);
 
 Thanks for the data provided by [真气网网站](https://www.zq12369.com/);
@@ -320,30 +321,12 @@ Thanks for the data provided by [北京市碳排放权电子交易平台网站](
 
 Thanks for the data provided by [国家金融与发展实验室网站](http://www.nifd.cn/);
 
-Thanks for the data provided by [IT桔子网站](https://www.itjuzi.com);
-
 Thanks for the data provided by [东方财富网站](http://data.eastmoney.com/jgdy/);
 
 Thanks for the data provided by [义乌小商品指数网站](http://www.ywindex.com/Home/Product/index/);
 
-Thanks for the data provided by [中国国家发展和改革委员会网站](http://jgjc.ndrc.gov.cn/dmzs.aspx?clmId=741);
-
-Thanks for the data provided by [163网站](https://news.163.com/special/epidemic/);
-
-Thanks for the data provided by [丁香园网站](http://3g.dxy.cn/newh5/view/pneumonia?scene=2&clicktime=1579615030&enterid=1579615030&from=groupmessage&isappinstalled=0);
-
-Thanks for the data provided by [百度新型肺炎网站](https://voice.baidu.com/act/newpneumonia/newpneumonia/?from=osari_pc_1);
-
 Thanks for the data provided by [百度迁徙网站](https://qianxi.baidu.com/?from=shoubai#city=0);
 
-Thanks for the data provided by [新型肺炎-相同行程查询工具网站](https://rl.inews.qq.com/h5/trip?from=newsapp&ADTAG=tgi.wx.share.message);
-
-Thanks for the data provided by [新型肺炎-小区查询网站](https://ncov.html5.qq.com/community?channelid=1&from=singlemessage&isappinstalled=0);
-
-Thanks for the data provided by [商业特许经营信息管理网站](http://txjy.syggs.mofcom.gov.cn/);
-
-Thanks for the data provided by [慈善中国网站](http://cishan.chinanpo.gov.cn/platform/login.html);
-
 Thanks for the data provided by [思知网站](https://www.ownthink.com/);
 
 Thanks for the data provided by [Currencyscoop 网站](https://currencyscoop.com/);
@@ -354,6 +337,6 @@ Thanks for the tutorials provided by [微信公众号: Python大咖谈](https://
 
 ## Backer and Sponsor
 
-<a href="https://www.jetbrains.com/?from=jindaxiang/akshare" target="_blank">
-<img alt="jetbrains" src="https://github.com/akfamily/akshare/blob/main/assets/images/jetbrains.svg" width="100px" height="100px">
+<a href="https://www.jetbrains.com/?from=albertandking/akshare" target="_blank">
+<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.png" alt="JetBrains logo.">
 </a>