ppputils 0.0.3

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

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等信息

快速开始

安装

pip install ppputils

使用示例

format_utils - 增强的print

# 简单版本（推荐）
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

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

许可证

MIT License

作者

Peter Puff

项目地址

https://github.com/puffhub/ppputils