akshare 1.13.46__py3-none-any.whl → 1.17.99__py3-none-any.whl

akshare/utils/func.py

@@ -1,12 +1,59 @@
 # !/usr/bin/env python
 """
-Date: 2024/4/7 15:30
+Date: 2025/3/10 18:00
 Desc: 通用帮助函数
 """
 
-from typing import List
+import math
+from typing import List, Dict
 
 import pandas as pd
+import requests
+
+from akshare.utils.tqdm import get_tqdm
+
+
+def fetch_paginated_data(url: str, base_params: Dict, timeout: int = 15):
+    """
+    东方财富-分页获取数据并合并结果
+    https://quote.eastmoney.com/f1.html?newcode=0.000001
+    :param url: 股票代码
+    :type url: str
+    :param base_params: 基础请求参数
+    :type base_params: dict
+    :param timeout: 请求超时时间
+    :type timeout: str
+    :return: 合并后的数据
+    :rtype: pandas.DataFrame
+    """
+    # 复制参数以避免修改原始参数
+    params = base_params.copy()
+    # 获取第一页数据，用于确定分页信息
+    r = requests.get(url, params=params, timeout=timeout)
+    data_json = r.json()
+    # 计算分页信息
+    per_page_num = len(data_json["data"]["diff"])
+    total_page = math.ceil(data_json["data"]["total"] / per_page_num)
+    # 存储所有页面数据
+    temp_list = []
+    # 添加第一页数据
+    temp_list.append(pd.DataFrame(data_json["data"]["diff"]))
+    # 获取进度条
+    tqdm = get_tqdm()
+    # 获取剩余页面数据
+    for page in tqdm(range(2, total_page + 1), leave=False):
+        params.update({"pn": page})
+        r = requests.get(url, params=params, timeout=timeout)
+        data_json = r.json()
+        inner_temp_df = pd.DataFrame(data_json["data"]["diff"])
+        temp_list.append(inner_temp_df)
+    # 合并所有数据
+    temp_df = pd.concat(temp_list, ignore_index=True)
+    temp_df["f3"] = pd.to_numeric(temp_df["f3"], errors="coerce")
+    temp_df.sort_values(by=["f3"], ascending=False, inplace=True, ignore_index=True)
+    temp_df.reset_index(inplace=True)
+    temp_df["index"] = temp_df["index"].astype(int) + 1
+    return temp_df
 
 
 def set_df_columns(df: pd.DataFrame, cols: List[str]) -> pd.DataFrame:

akshare/utils/multi_decrypt.py

@@ -0,0 +1,53 @@
+"""
+利用多进行执行 js 代码方案
+
+1. 未能解决 gevent 调用问题
+2. 导致 js 代码执行缓慢
+3. 该方案废弃，这里仅作参考
+
+同时发现 gevent 里面无法调用异步的接口
+"""
+
+import concurrent.futures
+
+
+# 定义在模块级别的函数
+def js_executor_function(js_code_str, method, args):
+    """在新进程中执行 JavaScript 代码的函数"""
+    from py_mini_racer import MiniRacer
+
+    js_code = MiniRacer()
+    js_code.eval(js_code_str)
+
+    if method == "call":
+        fn_name = args[0]
+        fn_args = args[1:]
+        return js_code.call(fn_name, *fn_args)
+    elif method == "eval":
+        return js_code.eval(args[0])
+    else:
+        raise ValueError(f"不支持的方法: {method}")
+
+
+def execute_js_in_executor(js_code_str, method, *args, timeout=30):
+    """
+    使用 ProcessPoolExecutor 在独立进程中执行 JavaScript
+
+    参数:
+        js_code_str: JavaScript 代码字符串
+        method: 'call' 或 'eval'
+        args: 如果 method 是 'call'，第一个参数是函数名，后续是函数参数
+              如果 method 是 'eval'，只需提供一个参数：要评估的代码
+        timeout: 超时时间（秒）
+
+    返回:
+        执行结果
+    """
+    with concurrent.futures.ProcessPoolExecutor(max_workers=1) as executor:
+        future = executor.submit(js_executor_function, js_code_str, method, args)
+        try:
+            return future.result(timeout=timeout)
+        except concurrent.futures.TimeoutError:
+            # 清理资源并抛出超时异常
+            executor.shutdown(wait=False)
+            raise TimeoutError("JavaScript 执行超时")

akshare/utils/token_process.py

@@ -4,6 +4,7 @@
 Date: 2020/2/13 21:22
 Desc: 存储和读取 Token 文件
 """
+
 import os
 
 import pandas as pd
@@ -12,22 +13,22 @@ from akshare.pro import cons
 
 
 def set_token(token):
-    df = pd.DataFrame([token], columns=['token'])
-    user_home = os.path.expanduser('~')
+    df = pd.DataFrame([token], columns=["token"])
+    user_home = os.path.expanduser("~")
     fp = os.path.join(user_home, cons.TOKEN_F_P)
     df.to_csv(fp, index=False)
 
 
 def get_token():
-    user_home = os.path.expanduser('~')
+    user_home = os.path.expanduser("~")
     fp = os.path.join(user_home, cons.TOKEN_F_P)
     if os.path.exists(fp):
         df = pd.read_csv(fp)
-        return str(df.iloc[0]['token'])
+        return str(df.iloc[0]["token"])
     else:
         print(cons.TOKEN_ERR_MSG)
         return
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     pass

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.13.46.dist-info → akshare-1.17.99.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: akshare
-Version: 1.13.46
+Version: 1.17.99
 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,46 +12,61 @@ 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: Programming Language :: Python :: 3.14
 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: aiohttp>=3.11.13
+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: curl_cffi>=0.13.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: nest_asyncio>=1.6.0
+Requires-Dist: mini-racer>=0.12.4; platform_system != "Linux"
+Requires-Dist: py-mini-racer>=0.6.0; platform_system == "Linux"
+Requires-Dist: akracer>=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'
-
-**欢迎加入专注于财经数据和量化投资的知识社区，请点击[了解更多](https://akshare.akfamily.xyz/learn.html)**
-
-**相关视频教程已经发布：《AKShare-初阶-使用教学》、《AKShare-初阶-实战应用》、《AKShare-源码解析》、《开源项目巡礼》**，详情请访问[课程](https://app3rqjh1z21630.h5.xiaoeknow.com)查看更多课程信息！
-
-**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) 方便各位小伙伴查询各种数据源。**
+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: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+**资源分享**：对于想了解更多财经数据与量化投研的小伙伴，推荐一个专注于财经数据和量化研究的知识社区。
+该社区提供相关文档和视频学习资源，汇集了各类财经数据源和量化投研工具的使用经验。
+有兴趣深入学习的朋友可点此[了解更多](https://t.zsxq.com/ZCxUG)，也推荐大家关注微信公众号【数据科学实战】。
+
+**工具推荐**：期魔方是一款本地化期货量化分析工具，适合数据分析爱好者使用。无需复杂部署，支持数据分析和机器学习功能，研究功能免费开放。
+如需了解更多信息可访问[期魔方](https://qmfquant.com/)。
 
 ![AKShare Logo](https://github.com/akfamily/akshare/blob/main/assets/images/akshare_logo.jpg)
 
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/akshare.svg)](https://pypi.org/project/akshare/)
 [![PyPI](https://img.shields.io/pypi/v/akshare.svg)](https://pypi.org/project/akshare/)
-[![Downloads](https://pepy.tech/badge/akshare)](https://pepy.tech/project/akshare)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/akshare?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/akshare)
 [![Documentation Status](https://readthedocs.org/projects/akshare/badge/?version=latest)](https://akshare.readthedocs.io/?badge=latest)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![akshare](https://img.shields.io/badge/Data%20Science-AKShare-green)](https://github.com/akfamily/akshare)
@@ -64,7 +79,7 @@ Requires-Dist: akqmt ; extra == 'qmt'
 
 ## Overview
 
-[AKShare](https://github.com/akfamily/akshare) requires Python(64 bit) 3.8 or higher and
+[AKShare](https://github.com/akfamily/akshare) requires Python(64 bit) 3.9 or higher and
 aims to simplify the process of fetching financial data.
 
 **Write less, get more!**
@@ -152,32 +167,15 @@ 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:
 
 ![KLine](https://jfds-1252952517.cos.ap-chengdu.myqcloud.com/akshare/readme/home/AAPL_candle.png)
 
-## Communication
-
-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">
-</div>
-
-Pay attention to **数据科学实战** WeChat Official Accounts to get the [AKShare](https://github.com/akfamily/akshare) updated info:
-
-<div>
-    <img alt="ds" src="https://github.com/akfamily/akshare/blob/main/assets/images/ds.png">
-</div>
-
 ## Features
 
 - **Easy of use**: Just one line code to fetch the data;
@@ -238,9 +236,9 @@ Please use this **bibtex** if you want to cite this repository in your publicati
 
 ```markdown
 @misc{akshare,
-    author = {Albert King},
+    author = {Albert King and Yaojie Zhang},
     title = {AKShare},
-    year = {2019},
+    year = {2022},
     publisher = {GitHub},
     journal = {GitHub repository},
     howpublished = {\url{https://github.com/akfamily/akshare}},
@@ -253,26 +251,22 @@ Special thanks [FuShare](https://github.com/LowinLi/fushare) for the opportunity
 
 Special thanks [TuShare](https://github.com/waditu/tushare) for the opportunity of learning from the project;
 
-Thanks for the data provided by [生意社网站](http://www.100ppi.com/);
+Thanks for the data provided by [东方财富网站](http://data.eastmoney.com);
 
-Thanks for the data provided by [奇货可查网站](https://qhkch.com/);
+Thanks for the data provided by [新浪财经网站](https://finance.sina.com.cn);
+
+Thanks for the data provided by [金十数据网站](https://www.jin10.com/);
+
+Thanks for the data provided by [生意社网站](http://www.100ppi.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/);
-
 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/);
@@ -295,16 +289,8 @@ Thanks for the data provided by [Timeanddate 网站](https://www.timeanddate.com
 
 Thanks for the data provided by [河北省空气质量预报信息发布系统网站](http://110.249.223.67/publish/);
 
-Thanks for the data provided by [南华期货网站](http://www.nanhua.net/nhzc/varietytrend.html);
-
 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/);
@@ -319,28 +305,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 [百度迁徙网站](https://qianxi.baidu.com/?from=shoubai#city=0);
 
-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/);
 
 Thanks for the data provided by [新加坡交易所网站](https://www.sgx.com/zh-hans/research-education/derivatives);
-
-Thanks for the tutorials provided by [微信公众号: Python大咖谈](https://upload-images.jianshu.io/upload_images/3240514-61004f2c71be4a0b.png).
-
-## 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>