Metadata-Version: 2.4
Name: ppputils
Version: 0.0.3
Summary: Peter Puff Private Utils - 实用的Python工具库
Home-page: https://github.com/puffhub/ppputils
Author: Peter Puff
Author-email: peter@puffhub.com
License: MIT
Keywords: utils print ip format logging
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
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 :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ppputils

Peter Puff Private Utils - 实用的Python工具库

## 功能特性

### format_utils - 增强的print功能

- ✅ **自动替换全局print**：一次导入，全局生效
- ✅ **带时间戳和文件名行号**：自动记录打印位置
- ✅ **支持set_args**：自定义参数显示
- ✅ **多种print函数**：debug、error、warning等快捷函数

### ip_utils - 全球最快获取公网IP

- ✅ **全球CDN优化**：使用最快的全球CDN服务
- ✅ **自动过滤私有IP**：过滤127.0.0.1等无效IP
- ✅ **多种获取方式**：HTTP、DNS、STUN、UPnP等
- ✅ **详细信息支持**：获取地理位置、ISP等信息

## 快速开始

### 安装

```bash
pip install ppputils
```

### 使用示例

#### format_utils - 增强的print

```python
# 简单版本（推荐）
from ppputils import print

print("Hello World")
# 输出: [2026-01-23 14:50:00.123] [example.py:3] Hello World

# 自定义版本（支持set_args）
from ppputils.format_utils import print
print.set_args(user_id=123, request_id="req-001")
print("处理请求")
# 输出: [2026-01-23 14:50:00.123] [example.py:6] [user_id:123] [request_id:req-001] 处理请求
```

#### ip_utils - 获取公网IP

```python
from ppputils.ip_utils import get_pub_ip_fast

# 全球最快获取IP（推荐）
ip = get_pub_ip_fast()
print(f"我的公网IP: {ip}")

# 获取详细信息
from ppputils.ip_utils import get_pub_ip_with_detail
details = get_pub_ip_with_detail()
if details:
    print(f"IP: {details.get('ip')}")
    print(f"位置: {details.get('city')}, {details.get('country')}")
```

## 详细文档

更多使用说明请查看 [USAGE.md](USAGE.md)

## 许可证

MIT License

## 作者

Peter Puff

## 项目地址

https://github.com/puffhub/ppputils
