Python Utils 项目

项目简介

目的是为了方便开发使用，因为在开发中有部分操作是完全重复的。

这是一个包含多个Python 实用函数的项目，提供了一些常用的工具类和函数，可以在多个项目中使用。

项目组织

目前工具库的各种工具如下所示，当然，我将继续维护和更新我的Python工具库集合，以提供更多功能和改进现有功能。

工具库的功能如下所示，基本上看文件 utils文件的名称，就可以知道该文件有什么功能。

python-utils/
├── utils/
│   ├── __init__.py
│   ├── config_utils.py
│   ├── date_utils.py
│   ├── docx_utils.py
│   ├── excel_utils.py
│   ├── file_utils.py
│   ├── html_utils.py
│   ├── json_utils.py
│   ├── network_utils.py
│   ├── os_utils.py
│   ├── pdf_utils.py
│   ├── photo_utils.py
│   ├── string_utils.py
│   ├── window_utils.py
│   └── more_utils.py
├── installer.py
├── main.py
├── LICENSE
├── README.md
└── requirements.txt

说明：

python-utils/ 是项目的根目录。
utils/ 是存放工具模块的目录。
__init__.py 是一个空文件，用于将 utils 目录标记为 Python 包。
其他的 utils 模块文件包括了各种功能的工具函数。
installer.py 是自动安装模块，可以用于为工具自动安装依赖模块。
main.py 是项目的入口文件，可以用于演示和测试工具模块的功能。
LICENSE 是项目的许可证文件，用于声明代码的使用许可。
README.md 是项目的说明文件，可以在其中提供有关项目的详细信息、使用说明等。
requirements.txt 是项目的依赖文件，列出了项目所需的第三方库和版本信息。

安装依赖

这里有两种方法

pip install -r requirements.txt

或者

啥都不用做

因为使用了 installer.py，默认是会安装相关的依赖模块！

使用方法

示例：获取日期范围 (date_utils.py)

在 Python 项目中导入需要使用的模块，例如：

from utils import date_utils

调用模块中提供的函数或类，例如：

获取 '2020-01-01' ~ '2022-01-01' 获取日期范围

date_list = date_utils.get_date_range('2020-01-01', '2022-01-01')

# 输出
[
    datetime.datetime(2020, 1, 1, 0, 0), 
    datetime.datetime(2020, 1, 2, 0, 0), 
    datetime.datetime(2020, 1, 3, 0, 0), 
    datetime.datetime(2020, 1, 4, 0, 0),
    ...
    datetime.datetime(2021, 12, 31, 0, 0), 
    datetime.datetime(2022, 1, 1, 0, 0)
]

示例：处理Excel文件 (excel_utils.py)

传入对应的Python的dict与保存的excel文件路径，就可以保存为excel文件啦。

# -*- coding: utf-8 -*-


from utils import dict_to_excel

if __name__ == '__main__':
    dict_to_excel(
        data_dict={'name': ['张三', '李四', '王五'], 'age': [18, 19, 20]},
        file_path='./demo.xlsx'
    )

功能列表

此项目目前包含以下Python实用功能：

config_utils.py：用于加载和解析配置文件的实用程序函数。
date_utils.py：处理日期的工具类，如 获取日期区间、获取日期差异、格式化时间 等；
html_utils.py：处理 HTML 内容的工具类，如 获取标题、提取所有href链接、获取xpath标签节点 等；
json_utils.py：处理 JSON 数据的工具类，如 读取、写入、添加、删除等；
network_utils.py：处理网络请求的工具类，如 构建url、网络请求、上传文件、下载文件 等；
string_utils.py：处理字符串的工具类，如 批量替换字符串 等；

TODO List

docx_utils.py： word文档处理工具类，提取文档内容 等；
file_utils.py：文件处理工具类，如 复制文件、复制文件内容、移动文件 等；
pdf_utils.py： pdf处理工具类，如 pdf转图片、提取pdf内容 等；
photo_utils.py：图片处理工具类，如 图片二值化、调整对比度、图片合成pdf 等；
window_utils.py：窗口处理工具类，最大最小化窗口、窗口指定、获取缩放比例 等；
...

未来计划

我们计划继续添加新的实用程序函数和功能，以进一步增强此项目。

贡献

如果您想贡献代码或报告错误，请随时在GitHub上提交请求或问题。我们欢迎您的贡献！

chanjetkai / python-utils