# PythonUtilitySnippets

**Repository Path**: reuac/PythonUtilitySnippets

## Basic Information

- **Project Name**: PythonUtilitySnippets
- **Description**: 一些 Python 的小工具代码库，每个文件都是独立的工具，互不关联。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: reuAC
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-15
- **Last Updated**: 2025-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## PythonUtilitySnippets

这个仓库包含了各种**独立的、单个文件**的Python实用工具。每个工具都设计为可以单独运行，互不依赖。这使得它们非常适合快速解决特定问题，例如文件批处理、网络流量辅助等。

-----

### 工具文件头部的统一说明格式

为了方便查阅和使用，每个工具文件的开头都遵循以下统一的注释格式，提供了关于该工具的基本信息：

```python
# ==============================================================================
# 工具名称: [工具的简洁名称，如：文件重命名工具]
# 作用说明: [详细描述工具的功能和用途]
#
# 适配Python版本: [例如：Python 3.6 及以上]
# 依赖模块: [列出工具运行所需的所有第三方Python模块，如：requests, openpyxl]
# ==============================================================================
```

**示例：**

一个文件批处理工具的头部可能如下所示：

```python
# ==============================================================================
# 工具名称: 图片批量重命名工具
# 作用说明: 扫描指定文件夹下的所有图片文件（.jpg, .png），
#           并按照“前缀_序号.扩展名”的格式进行重命名。
#
# 适配Python版本: Python 3.8 及以上
# 依赖模块: 无 (仅使用标准库)
# ==============================================================================

import os

def batch_rename_images(folder_path, prefix="image"):
    # 工具的具体实现
    pass

if __name__ == "__main__":
    # 执行代码
    pass
```

### 工具文件列表

| 文件名称                        | 工具概述                                                     |
| :------------------------------ | :----------------------------------------------------------- |
| `TCP_Proxy_Forwarder.py`        | 一个轻量级的TCP流量转发代理，将特定端口的入站连接和数据透明地转发到预设的目标地址和端口。适用于简单的网络调试和连接重定向。 |
| `Directory_Text_Concatenator.py` | 遍历指定目录及其子目录下的文本文件，自动跳过常见的非文本文件类型，将所有文本内容合并到一个输出文件中，并在每个文件内容前添加原始文件路径标记。  **此工具适合将整个项目（包括代码、配置、文档等）的纯文本内容进行整合，方便一次性提交给AI进行分析、理解或处理。** |