# centaurus

**Repository Path**: qq1263632494/centaurus

## Basic Information

- **Project Name**: centaurus
- **Description**: No description available
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-15
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Centaurus

## 介绍
Centaurus 是一个多功能 Python 库，旨在简化数据处理、配置管理、并行计算和网络请求等任务。它提供了丰富的工具和抽象类，使得开发者可以更高效地构建复杂的应用程序。

该项目主要包含以下功能模块：
- 数据输入输出（IO）：支持多种格式（JSON、YAML、CSV、Excel、SQL 等）的读写操作。
- 并行处理：提供基于进程和线程的并行映射函数，以提高大规模数据处理效率。
- 网络请求：封装了 HTTP POST 请求的同步与异步处理逻辑。
- 工具集：包括文件操作、数据格式转换、集合操作等实用函数。

## 软件架构
Centaurus 的代码结构清晰，主要分为以下几个部分：

- `src/centaurus/base.py`: 定义了基础类 `CommonSample` 和 `CommonConfiguration`，分别用于数据样本和配置参数的管理。
- `src/centaurus/io/`: 提供多种数据格式的 IO 操作，如 JSON、YAML、CSV、Excel、SQL 等。
- `src/centaurus/parallel/`: 包含基于进程和线程的并行处理函数。
- `src/centaurus/request.py`: 封装了 HTTP POST 请求的处理逻辑。
- `src/centaurus/tools/`: 提供一系列实用工具函数，如文件操作、数据格式转换、集合操作等。

## 安装教程
1. 确保你已经安装了 Python 3.x。
2. 安装依赖包：
   ```bash
   pip install -r requirements.txt
   ```
3. 安装项目：
   ```bash
   pip install .
   ```

## 使用说明
### 数据 IO 操作
你可以使用 `CommonSample` 类来读写多种格式的数据。例如：

```python
from centaurus.base import CommonSample

# 从 CSV 文件读取数据
data = CommonSample.from_csv("data.csv")

# 将数据写入 JSON 文件
CommonSample.to_json(data, "output.json")
```

### 并行处理
你可以使用 `auto_parallel_map` 函数来进行自动并行处理。例如：

```python
from centaurus.parallel.process import auto_parallel_map

def process_data(item, args):
    # 处理逻辑
    return processed_item

results = auto_parallel_map(process_data, data_list, args, tqdm_config, n_jobs=4)
```

### 网络请求
你可以使用 `PostManager` 类来进行同步或异步的 HTTP POST 请求。例如：

```python
from centaurus.request import PostManager

manager = PostManager(urls=["http://example.com/api"], workers=4)
response = manager.do_batch_post_json(data)
```

## 参与贡献
欢迎贡献代码！请遵循以下步骤：
1. Fork 项目。
2. 创建新分支 (`git checkout -b feature/new-feature`)。
3. 提交更改 (`git commit -am 'Add some feature'`)。
4. 推送分支 (`git push origin feature/new-feature`)。
5. 创建 Pull Request。

## 特技
- **多格式支持**：轻松读写多种数据格式。
- **高效并行**：利用多核 CPU 或线程池加速数据处理。
- **灵活请求**：支持同步与异步的 HTTP 请求处理。
- **丰富工具**：提供多种实用工具函数，简化开发流程。

如果你有任何问题或建议，请随时提交 Issue 或 Pull Request。