pytola 0.2.1

Pytola: Python Tools and Applications Collection - A comprehensive suite of Python utilities and applications

Pytola: Python Tools and Applications Collection

• Free software: MIT license

• Documentation: https://pytola.readthedocs.io/zh-cn/stable/

项目概述

Pytola 是一个多功能 Python工具集合，包含开发工具、办公应用、系统工具等多个模块。

主要功能模块

• 开发工具 (dev):包管理、版本控制、代码检查等开发辅助工具

• 办公应用 (office): PDF处理、图像转换、文档扫描等办公工具

• 系统工具 (system): 文件管理、系统信息、进程控制等系统工具

• 安全工具 (security): 输入验证、文件路径安全检查等安全工具

• 多媒体工具 (multimedia):音播放、媒体处理等多媒体工具

• 仿真工具 (simulation):科计算、模拟仿真等专业工具

安装方式

从 PyPI安装:

pip install pytola

或者使用 uv工具安装:

uv install pytola

或者从源码安装:

git clone https://gitee.com/gooker_young/pytola.git
cd pytola
pip install .

开发安装:

git clone https://gitee.com/gooker_young/pytola.git
cd pytola
pip install -e .

使用示例

基础导入:

import pytola
from pytola.core.logger import get_logger, ThemeManager

logger = get_logger(__name__)

# 获取版本信息
print(f"Pytola version: {pytola.__version__}")

# 使用日志功能
logger.info("Pytola initialized successfully")

# 使用主题管理器
theme_manager = ThemeManager()
print(f"Available themes: {theme_manager.list_themes()}")

模块使用示例:

# 开发工具示例
from pytola_dev.pypack import main as pypack_main
from pytola_dev.checksum import main as checksum_main

#办工具示例
from pytola.office.img2ico import main as img2ico_main
from pytola.office.pdfcrypt import main as pdfcrypt_main

#系统工具示例
from pytola.system.filedate import main as filedate_main

#安工具工具示例
from pytola.security import InputValidator
validator = InputValidator()
print(f"Valid email: {validator.validate_email('[e-mail]')}")

命令行工具

Pytola 提供多个命令行工具：

• pypack - Python包管理工具

• checksum - 文件校验工具

• img2ico - 图像转ICO工具

• pdfcrypt - PDF加密工具

• filedate - 文件时间管理工具

• llmcli - LLM客户端工具

完整工具列表请查看 pyproject.toml 中的 [project.scripts]。

项目结构

项目采用模块化设计，主要目录结构：

• pytola/ -核心模块

• pytola/dev/ - 开发工具

• pytola/office/ -办工具

• pytola/system/ -系统工具

• pytola/security.py -安全工具

• docs/ - 文档

• scripts/ -辅脚助脚本

构建要求

要求: - Python >= 3.8 - pip - uv

开发流程

使用 uv工具:

# 开发模式安装
uv sync

#运行测试
pytest

#检查代码风格
uvx prek