# tushare项目byWoo

**Repository Path**: josewu2007/tushare-project-by-woo

## Basic Information

- **Project Name**: tushare项目byWoo
- **Description**: 基于tushare接口的股票信息python操作，借助TRAE环境和其AI智能体
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-02
- **Last Updated**: 2025-12-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# A股上市公司信息获取工具集

这是一个基于Tushare Pro API的A股上市公司信息获取工具集，提供了一系列功能模块用于获取和保存A股上市公司的各类信息。通过面向对象设计，代码结构清晰，易于扩展和维护。

## 🌟 功能特性

- **多模块设计**：包含8个功能模块，覆盖上市公司基本信息、十大流通股东、龙虎榜、涨停板块等多个维度
- **高效数据获取**：基于Tushare Pro API，获取最新的A股市场数据
- **专业代码设计**：采用面向对象编程思想，代码结构清晰，易于扩展
- **自动化处理**：自动创建数据目录，生成带时间戳的数据文件
- **安全密钥管理**：支持从文件中读取API密钥，避免硬编码风险
- **完善的错误处理**：包含详细的异常处理机制，提高程序稳定性
- **数据库支持**：部分模块支持将数据保存到MySQL数据库
- **丰富的文档**：每个模块都提供完整的技术文档和使用说明
- **支持多交易所**：覆盖SSE、SZSE、BSE等多个交易所
- **分批次处理**：支持大数据量的分批次处理和保存

## 📁 项目结构

```
股票项目/
├── src/                   # 源代码目录
│   ├── 00_用tushare实现大A所有上市公司列表.py               # 上市公司列表获取（基础版）
│   ├── 00_用Class思想通过tushare接口实现大A所有上市公司列表.py   # 上市公司列表获取（面向对象版）
│   ├── 01-大A十大流通股东列表.py                          # 十大流通股东查询（基础版）
│   ├── 01-面向对象重构版查询股票十大流通股东.py                # 十大流通股东查询（面向对象版）
│   ├── 02-用class思想实现交互式查询股票十大流通股东.py          # 交互式十大流通股东查询
│   ├── 03-大A所有股票列表.py                           # 所有股票列表获取
│   ├── 04_面向对象重构版查询股票十大流通股东.py               # 十大流通股东查询（重构版）
│   ├── 05_龙虎榜每日明细.py                           # 龙虎榜每日明细数据获取
│   ├── 06_涨停最强板块统计.py                          # 涨停板块统计分析
│   ├── 07-游资名录.py                               # 游资名录数据获取
│   ├── 08-上市公司基本信息提取.py                         # 上市公司基本信息提取（多交易所）
│   ├── interfaces/                                  # 接口定义目录
│   └── utils/                                       # 工具类目录
│       └── common_utils.py                          # 通用工具类（包含ConfigManager）
├── doc/                   # 技术文档目录
│   ├── 00-大A所有上市公司列表工具说明文档.md
│   ├── 00_用tushare实现大A所有上市公司列表技术文档.md
│   ├── 01-面向对象重构版查询股票十大流通股东技术文档.md
│   ├── 02-股票十大流通股东查询工具说明文档.md
│   ├── 04-面向对象重构版查询股票十大流通股东.md
│   ├── 05-龙虎榜每日明细_快速使用说明.md
│   ├── 05-龙虎榜每日明细文档.md
│   ├── 06-涨停最强板块统计_快速使用说明.md
│   ├── 06-涨停最强板块统计文档.md
│   ├── 07-游资名录_快速使用说明.md
│   ├── 07-游资名录文档.md
│   └── 08-上市公司基本信息提取技术文档.md
├── data/                  # 数据保存目录（自动创建）
├── requirements.txt       # 项目依赖文件
├── tushare_token.txt      # Tushare API密钥文件
├── databaseConfig.txt     # 数据库连接配置文件
├── .gitignore             # Git忽略文件
└── README.md              # 项目说明文档
```

## �️ 技术栈

- **Python 3.7+**：主要开发语言
- **Tushare Pro**：数据来源API
- **Pandas**：数据处理和CSV文件操作
- **PyMySQL**：MySQL数据库连接
- **Socket**：网络连接测试
- **OS**：文件和目录操作
- **Datetime**：时间戳生成
- **Logging**：日志记录

## �🚀 快速开始

### 1. 环境准备

确保您的系统已安装Python 3.7或更高版本。

### 2. 安装依赖

使用pip安装项目所需的依赖：

```bash
pip install -r requirements.txt
```

### 3. 配置文件

#### 3.1 Tushare API密钥

在项目根目录创建`tushare_token.txt`文件，写入您的Tushare Pro API密钥：

```
YOUR_TUSHARE_TOKEN_HERE
```

#### 3.2 数据库配置（可选）

对于支持数据库保存的模块，在项目根目录创建`databaseConfig.txt`文件，配置数据库连接信息：

```
host=192.168.28.29
port=3306
user=root
password=asAS123456!
charset=utf8mb4
```

### 4. 运行程序

执行各个功能模块的Python脚本：

```bash
# 示例：运行上市公司基本信息提取模块
python src/08-上市公司基本信息提取.py
```

## 📊 功能模块说明

### 00. 上市公司列表获取
- **功能**：获取所有A股上市公司的基本信息
- **文件**：`src/00_用tushare实现大A所有上市公司列表.py`（基础版）和`src/00_用Class思想通过tushare接口实现大A所有上市公司列表.py`（面向对象版）
- **输出**：CSV文件

### 01-02. 十大流通股东查询
- **功能**：查询指定股票的十大流通股东信息
- **文件**：包含多个版本，支持面向对象和交互式查询
- **输出**：CSV文件

### 03. 所有股票列表获取
- **功能**：获取所有A股股票的列表信息
- **文件**：`src/03-大A所有股票列表.py`
- **输出**：CSV文件

### 04. 十大流通股东查询（重构版）
- **功能**：重构版的十大流通股东查询功能
- **文件**：`src/04_面向对象重构版查询股票十大流通股东.py`
- **输出**：CSV文件

### 05. 龙虎榜每日明细
- **功能**：获取龙虎榜每日明细数据
- **文件**：`src/05_龙虎榜每日明细.py`
- **输出**：CSV文件

### 06. 涨停最强板块统计
- **功能**：统计每日涨停最强板块
- **文件**：`src/06_涨停最强板块统计.py`
- **输出**：CSV文件

### 07. 游资名录
- **功能**：获取游资名录数据
- **文件**：`src/07-游资名录.py`
- **输出**：CSV文件

### 08. 上市公司基本信息提取（多交易所）
- **功能**：获取所有交易所上市公司的详细基本信息
- **文件**：`src/08-上市公司基本信息提取.py`
- **输出**：CSV文件和MySQL数据库
- **支持交易所**：SSE、SZSE、BSE

## ⚙️ 核心工具类

### ConfigManager
- **功能**：负责配置文件的读取和管理
- **位置**：`src/utils/common_utils.py`
- **主要方法**：
  - `get_tushare_token()`：获取Tushare API令牌
  - `get_database_config()`：获取数据库连接配置
  - `get_project_root()`：获取项目根目录路径

## 📖 文档说明

每个功能模块都提供了详细的技术文档和使用说明，存放在`doc/`目录下：

- **技术文档**：详细说明模块的设计思路、代码结构、类和方法等
- **使用说明**：提供快速入门指南和使用示例

## ⚠️ 注意事项

1. **API访问限制**：Tushare免费版API有访问次数限制，请合理使用
2. **目录权限**：确保程序对`data/`目录有写入权限
3. **密钥安全**：API密钥文件`tushare_token.txt`已被添加到`.gitignore`中，不会被提交到版本控制系统
4. **依赖版本**：请使用`requirements.txt`中指定的依赖版本，以确保兼容性
5. **数据库配置**：使用数据库功能时，请确保配置文件正确且数据库服务正常运行
6. **网络连接**：部分模块包含网络连接测试，请确保网络连接正常

## � 更新日志

### v1.6 (2025-12-05)
- 新增08-上市公司基本信息提取模块
- 支持多交易所数据获取
- 优化数据库保存逻辑
- 更新所有模块技术文档

### v1.5 (2025-12-04)
- 新增十大流通股东查询重构版
- 完善异常处理机制
- 优化数据处理逻辑

### v1.4 (2025-12-02)
- 新增龙虎榜每日明细模块
- 新增涨停最强板块统计模块
- 优化代码结构

### v1.3 (2025-11-28)
- 新增十大流通股东交互式查询功能
- 完善文档说明

### v1.2 (2025-11-25)
- 重构十大流通股东查询模块
- 优化数据保存策略

### v1.1 (2025-11-22)
- 新增多个功能模块
- 支持面向对象设计

### v1.0 (2025-11-20)
- 初始版本发布
- 实现上市公司列表获取功能

## 📄 许可证

本项目采用MIT许可证，可自由使用和修改。

## 🤝 贡献

欢迎提交Issue和Pull Request来改进这个项目！

## 📞 联系方式

如有问题或建议，欢迎通过以下方式联系：
- GitHub/Gitee: josewu2007

---

✨ 感谢您使用A股上市公司信息获取工具集！