finshare 0.1.1__tar.gz

finshare-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Meepo Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

finshare-0.1.1/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: finshare
+Version: 0.1.1
+Summary: A professional financial data fetching toolkit for Python
+Author-email: Meepo Team <support@meepoquant.com>
+License: MIT
+Project-URL: Homepage, https://meepoquant.com
+Project-URL: Repository, https://github.com/finvfamily/finshare
+Project-URL: Bug Tracker, https://github.com/finvfamily/finshare/issues
+Keywords: quantitative,trading,data,finance,stock,quant
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: baostock>=0.8.9
+Requires-Dist: pytdx>=1.72
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# finshare
+
+<div align="center">
+  <h3>专业的金融数据获取工具库</h3>
+  <p>A Professional Financial Data Fetching Toolkit for Python</p>
+
+  <p>
+    <a href="https://meepoquant.com">官网</a> •
+    <a href="https://github.com/finvfamily/finshare">GitHub</a> •
+    <a href="https://github.com/finvfamily/finshare/issues">问题反馈</a>
+  </p>
+
+  <p>
+    <img src="https://img.shields.io/pypi/v/finshare" alt="PyPI"/>
+    <img src="https://img.shields.io/github/stars/finvfamily/finshare" alt="Stars"/>
+    <img src="https://img.shields.io/pypi/dm/finshare" alt="Downloads"/>
+    <img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="Python"/>
+    <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"/>
+  </p>
+</div>
+
+---
+
+## 🚀 快速开始
+
+```python
+from finshare import get_data_manager
+
+# 获取数据管理器
+manager = get_data_manager()
+
+# 获取 K线数据（只需传入股票代码，无需市场后缀）
+data = manager.get_kline('000001', start='2024-01-01', end='2024-01-31')
+print(data.head())
+
+# 获取实时快照
+snapshot = manager.get_snapshot('000001')
+print(f"最新价: {snapshot.last_price}")
+```
+
+## ✨ 核心特性
+
+- 📊 **多数据源支持** - 东方财富、腾讯、新浪、通达信、BaoStock
+- 🔄 **自动故障切换** - 数据源失败时自动切换到备用源
+- 📈 **统一数据格式** - 所有数据源返回统一的 DataFrame 格式
+- ⚡ **高性能获取** - 优化的数据获取和解析性能
+- 🔧 **简单易用** - 简洁的 API 设计，开箱即用
+- 🤖 **AI 驱动开发** - 完全由 Claude AI 实现，代码质量有保障
+
+## 📦 安装
+
+```bash
+pip install finshare
+```
+
+**注意**: 包名为 `finshare`，但导入时使用 `finshare`：
+
+```python
+import finshare
+from finshare import get_data_manager
+```
+
+## 📚 支持的数据源
+
+| 数据源 | K线数据 | 实时快照 | 复权数据 |
+|--------|---------|----------|----------|
+| 东方财富 | ✅ | ✅ | ✅ |
+| 腾讯财经 | ✅ | ✅ | ✅ |
+| 新浪财经 | ❌ | ✅ | ❌ |
+| 通达信 | ✅ | ✅ | ✅ |
+| BaoStock | ✅ | ✅ | ✅ |
+
+## 💡 使用示例
+
+### 基础用法
+
+```python
+from finshare import get_data_manager
+
+manager = get_data_manager()
+
+# 获取日线数据（只需传入6位股票代码）
+data = manager.get_kline(
+    code='000001',  # 平安银行
+    start='2024-01-01',
+    end='2024-01-31',
+    adjust='qfq'  # 前复权
+)
+
+# 获取实时快照
+snapshot = manager.get_snapshot('000001')
+```
+
+### 批量获取
+
+```python
+from finshare import get_data_manager
+
+manager = get_data_manager()
+
+# 批量获取多只股票（使用6位代码）
+codes = ['000001', '000002', '600000']
+data_dict = manager.batch_get_kline(codes, start='2024-01-01')
+
+for code, data in data_dict.items():
+    print(f"{code}: {len(data)} 条数据")
+```
+
+### 使用特定数据源
+
+```python
+from finshare import EastMoneyDataSource, TencentDataSource
+
+# 使用东方财富
+eastmoney = EastMoneyDataSource()
+data = eastmoney.get_kline('000001', start='2024-01-01')
+
+# 使用腾讯财经
+tencent = TencentDataSource()
+data = tencent.get_kline('000001', start='2024-01-01')
+```
+
+## 🌟 为什么选择 finshare？
+
+finshare 是 [米波量化平台](https://meepoquant.com) 的数据层，经过生产环境验证，稳定可靠。
+
+### 完整的量化交易解决方案
+
+如果你需要更强大的功能，可以使用米波平台：
+
+| 功能 | finshare | 米波平台 |
+|------|-----------|----------|
+| 数据获取 | ✅ 免费 | ✅ |
+| 策略回测 | ❌ | ✅ |
+| 实时监控 | ❌ | ✅ |
+| 策略市场 | ❌ | ✅ |
+| 实盘交易 | ❌ | ✅ |
+| 移动端 | ❌ | ✅ |
+
+👉 [立即体验米波平台](https://meepoquant.com/signup?from=github)
+
+## 📖 文档
+
+- [快速开始](https://github.com/finvfamily/finshare#-快速开始)
+- [使用示例](https://github.com/finvfamily/finshare#-使用示例)
+- [数据源说明](https://github.com/finvfamily/finshare#-支持的数据源)
+- [示例代码](https://github.com/finvfamily/finshare/tree/main/examples)
+
+## 🤝 贡献
+
+欢迎贡献代码！查看 [贡献指南](CONTRIBUTING.md)。
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE)
+
+## 🔗 相关链接
+
+- **官方网站**: https://meepoquant.com
+- **GitHub**: https://github.com/finvfamily/finshare
+- **PyPI**: https://pypi.org/project/finshare
+- **问题反馈**: https://github.com/finvfamily/finshare/issues
+
+---
+
+<div align="center">
+  <p>
+    <strong>由 <a href="https://meepoquant.com">米波量化</a> 团队开发和维护</strong>
+  </p>
+  <p>
+    🤖 本项目完全由 AI (Claude) 实现，展示了 AI 在软件工程领域的强大能力
+  </p>
+  <p>
+    ⭐ 如果这个项目对你有帮助，请给我们一个 Star！
+  </p>
+  <p>
+    💡 需要完整的量化交易平台？访问 <a href="https://meepoquant.com">米波量化</a>
+  </p>
+</div>

finshare-0.1.1/README.md

@@ -0,0 +1,179 @@
+# finshare
+
+<div align="center">
+  <h3>专业的金融数据获取工具库</h3>
+  <p>A Professional Financial Data Fetching Toolkit for Python</p>
+
+  <p>
+    <a href="https://meepoquant.com">官网</a> •
+    <a href="https://github.com/finvfamily/finshare">GitHub</a> •
+    <a href="https://github.com/finvfamily/finshare/issues">问题反馈</a>
+  </p>
+
+  <p>
+    <img src="https://img.shields.io/pypi/v/finshare" alt="PyPI"/>
+    <img src="https://img.shields.io/github/stars/finvfamily/finshare" alt="Stars"/>
+    <img src="https://img.shields.io/pypi/dm/finshare" alt="Downloads"/>
+    <img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="Python"/>
+    <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"/>
+  </p>
+</div>
+
+---
+
+## 🚀 快速开始
+
+```python
+from finshare import get_data_manager
+
+# 获取数据管理器
+manager = get_data_manager()
+
+# 获取 K线数据（只需传入股票代码，无需市场后缀）
+data = manager.get_kline('000001', start='2024-01-01', end='2024-01-31')
+print(data.head())
+
+# 获取实时快照
+snapshot = manager.get_snapshot('000001')
+print(f"最新价: {snapshot.last_price}")
+```
+
+## ✨ 核心特性
+
+- 📊 **多数据源支持** - 东方财富、腾讯、新浪、通达信、BaoStock
+- 🔄 **自动故障切换** - 数据源失败时自动切换到备用源
+- 📈 **统一数据格式** - 所有数据源返回统一的 DataFrame 格式
+- ⚡ **高性能获取** - 优化的数据获取和解析性能
+- 🔧 **简单易用** - 简洁的 API 设计，开箱即用
+- 🤖 **AI 驱动开发** - 完全由 Claude AI 实现，代码质量有保障
+
+## 📦 安装
+
+```bash
+pip install finshare
+```
+
+**注意**: 包名为 `finshare`，但导入时使用 `finshare`：
+
+```python
+import finshare
+from finshare import get_data_manager
+```
+
+## 📚 支持的数据源
+
+| 数据源 | K线数据 | 实时快照 | 复权数据 |
+|--------|---------|----------|----------|
+| 东方财富 | ✅ | ✅ | ✅ |
+| 腾讯财经 | ✅ | ✅ | ✅ |
+| 新浪财经 | ❌ | ✅ | ❌ |
+| 通达信 | ✅ | ✅ | ✅ |
+| BaoStock | ✅ | ✅ | ✅ |
+
+## 💡 使用示例
+
+### 基础用法
+
+```python
+from finshare import get_data_manager
+
+manager = get_data_manager()
+
+# 获取日线数据（只需传入6位股票代码）
+data = manager.get_kline(
+    code='000001',  # 平安银行
+    start='2024-01-01',
+    end='2024-01-31',
+    adjust='qfq'  # 前复权
+)
+
+# 获取实时快照
+snapshot = manager.get_snapshot('000001')
+```
+
+### 批量获取
+
+```python
+from finshare import get_data_manager
+
+manager = get_data_manager()
+
+# 批量获取多只股票（使用6位代码）
+codes = ['000001', '000002', '600000']
+data_dict = manager.batch_get_kline(codes, start='2024-01-01')
+
+for code, data in data_dict.items():
+    print(f"{code}: {len(data)} 条数据")
+```
+
+### 使用特定数据源
+
+```python
+from finshare import EastMoneyDataSource, TencentDataSource
+
+# 使用东方财富
+eastmoney = EastMoneyDataSource()
+data = eastmoney.get_kline('000001', start='2024-01-01')
+
+# 使用腾讯财经
+tencent = TencentDataSource()
+data = tencent.get_kline('000001', start='2024-01-01')
+```
+
+## 🌟 为什么选择 finshare？
+
+finshare 是 [米波量化平台](https://meepoquant.com) 的数据层，经过生产环境验证，稳定可靠。
+
+### 完整的量化交易解决方案
+
+如果你需要更强大的功能，可以使用米波平台：
+
+| 功能 | finshare | 米波平台 |
+|------|-----------|----------|
+| 数据获取 | ✅ 免费 | ✅ |
+| 策略回测 | ❌ | ✅ |
+| 实时监控 | ❌ | ✅ |
+| 策略市场 | ❌ | ✅ |
+| 实盘交易 | ❌ | ✅ |
+| 移动端 | ❌ | ✅ |
+
+👉 [立即体验米波平台](https://meepoquant.com/signup?from=github)
+
+## 📖 文档
+
+- [快速开始](https://github.com/finvfamily/finshare#-快速开始)
+- [使用示例](https://github.com/finvfamily/finshare#-使用示例)
+- [数据源说明](https://github.com/finvfamily/finshare#-支持的数据源)
+- [示例代码](https://github.com/finvfamily/finshare/tree/main/examples)
+
+## 🤝 贡献
+
+欢迎贡献代码！查看 [贡献指南](CONTRIBUTING.md)。
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE)
+
+## 🔗 相关链接
+
+- **官方网站**: https://meepoquant.com
+- **GitHub**: https://github.com/finvfamily/finshare
+- **PyPI**: https://pypi.org/project/finshare
+- **问题反馈**: https://github.com/finvfamily/finshare/issues
+
+---
+
+<div align="center">
+  <p>
+    <strong>由 <a href="https://meepoquant.com">米波量化</a> 团队开发和维护</strong>
+  </p>
+  <p>
+    🤖 本项目完全由 AI (Claude) 实现，展示了 AI 在软件工程领域的强大能力
+  </p>
+  <p>
+    ⭐ 如果这个项目对你有帮助，请给我们一个 Star！
+  </p>
+  <p>
+    💡 需要完整的量化交易平台？访问 <a href="https://meepoquant.com">米波量化</a>
+  </p>
+</div>

finshare-0.1.1/finshare/__init__.py

@@ -0,0 +1,85 @@
+"""
+finshare - 专业的金融数据获取工具库
+
+finshare 提供稳定、高效的金融数据获取服务，支持多数据源、
+自动故障切换、统一的数据格式。
+
+官方网站: https://meepoquant.com
+文档: https://finshare.readthedocs.io
+GitHub: https://github.com/meepo-quant/finshare
+
+获取数据后，您可以：
+- 使用 pandas 进行数据分析
+- 使用 米波平台 进行策略回测: https://meepoquant.com
+- 开发自己的量化策略
+
+完整的量化交易平台: https://meepoquant.com
+
+主要功能：
+- 多数据源支持（东方财富、腾讯、新浪、通达信、BaoStock）
+- 自动故障切换
+- 统一的数据格式
+- 高性能数据获取
+
+快速开始：
+    >>> from finshare import get_data_manager
+    >>>
+    >>> # 获取数据管理器
+    >>> manager = get_data_manager()
+    >>>
+    >>> # 获取 K线数据
+    >>> data = manager.get_kline('000001.SZ', start='2024-01-01')
+"""
+
+from finshare.__version__ import __version__, __author__, __website__
+
+# 数据源
+from finshare.sources import (
+    BaseDataSource,
+    EastMoneyDataSource,
+    TencentDataSource,
+    SinaDataSource,
+    get_data_manager,
+    get_baostock_source,
+    get_tdx_source,
+)
+
+# 数据模型
+from finshare.models import (
+    KLineData,
+    SnapshotData,
+    StockInfo,
+)
+
+# 工具函数
+from finshare.utils import (
+    validate_stock_code,
+    validate_date,
+)
+
+# 日志
+from finshare.logger import logger
+
+__all__ = [
+    # 版本信息
+    "__version__",
+    "__author__",
+    "__website__",
+    # 数据源
+    "BaseDataSource",
+    "EastMoneyDataSource",
+    "TencentDataSource",
+    "SinaDataSource",
+    "get_data_manager",
+    "get_baostock_source",
+    "get_tdx_source",
+    # 数据模型
+    "KLineData",
+    "SnapshotData",
+    "StockInfo",
+    # 工具函数
+    "validate_stock_code",
+    "validate_date",
+    # 日志
+    "logger",
+]

finshare-0.1.1/finshare/__version__.py

@@ -0,0 +1,4 @@
+__version__ = "0.1.0"
+__author__ = "Meepo Team"
+__email__ = "support@meepoquant.com"
+__website__ = "https://meepoquant.com"

finshare-0.1.1/finshare/config/__init__.py

@@ -0,0 +1,9 @@
+"""
+finshare Config Module
+
+配置管理模块
+"""
+
+from finshare.config.settings import Config, config
+
+__all__ = ["Config", "config"]

finshare-0.1.1/finshare/config/settings.py

@@ -0,0 +1,57 @@
+"""
+finshare Config Module
+
+配置管理模块
+"""
+
+import os
+
+
+class LoggingConfig:
+    """日志配置"""
+
+    def __init__(self):
+        self.log_dir = os.path.join(os.path.expanduser("~"), ".finshare", "logs")
+        self.log_level = "INFO"
+        self.log_format = (
+            "<green>{time:YYYY-MM-DD HH:mm:ss}</green> | "
+            "<level>{level: <8}</level> | "
+            "<cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - "
+            "<level>{message}</level>"
+        )
+        self.rotation = "10 MB"
+        self.retention = "30 days"
+        self.enable_remote_logging = False
+        self.remote_log_url = None
+
+
+class DataSourceConfig:
+    """数据源配置"""
+
+    def __init__(self):
+        self.source_priority = ["eastmoney", "tencent", "sina", "tdx", "baostock"]
+        self.timeout = 30
+        self.request_timeout = 30  # 请求超时时间（秒）
+        self.retry_times = 3
+        self.request_interval = 0.1  # 请求间隔（秒）
+        self.max_workers = 5  # 最大并发数
+        self.failure_cooldown_hours = 24  # 数据源失败后的冷却时间（小时）
+
+
+class Config:
+    """全局配置"""
+
+    def __init__(self):
+        self.timeout = 30
+        self.logging = LoggingConfig()
+        self.data_source = DataSourceConfig()
+
+    def get(self, key, default=None):
+        """获取配置项"""
+        return getattr(self, key, default)
+
+
+# 全局配置实例
+config = Config()
+
+__all__ = ["Config", "config"]