项目简介
把一些常用的功能写成函数
函数大全
XiaoKang/
# 常用指令
├── xk() # 彩蛋(神秘暗号,详见 1.1)
├── 报错信息() # 发生报错时调用,可以格式化报错信息方便查看
├── 时间_文件_天() # 用于文件命名【2026-03-16】
├── 时间_文件_时() # 用于文件命名【2026-03-16_10】
├── 时间_文件_分() # 用于文件命名【2026-03-16_10-55】
├── 时间_文件_秒() # 用于文件命名【2026-03-16_10-55-28】
├── 时间_正常() # 不能命名文件,只能打印【2026-03-16 10:55:28】
├── 时间_日志() # 用于记录日志【2026-03-16 10:55:28.724013】
├── sqlite数据库操作 # sqlite数据库的操作
│ ├── 连接() # 连接指定文件的数据库
│ ├── 创建表() # 创建新表格在数据库
│ ├── 新增数据() # 新增的数据写入数据库,不会自动提交
│ ├── 读取数据() # 读取数据库数据
│ ├── 修改数据() # 修改数据库数据
│ ├── 执行SQL() # 直接执行sqlite
│ ├── 删除数据() # 删除数据库数据【懒狗还没写】
│ ├── 提交() # 保存到本地文件数据库
│ └── 断开() # 断开连接,结束操作
├── mysql数据库操作 # mysql数据库的操作
│ ├── 连接() # 连接mysql数据库(连接参数在构造时传入)
│ ├── 创建表() # 创建新表格在数据库(内部会自动提交)
│ ├── 新增数据() # 新增的数据写入数据库,不会自动提交
│ ├── 读取数据() # 读取数据库数据
│ ├── 修改数据() # 修改数据库数据
│ ├── 执行SQL() # 直接执行sql
│ ├── 删除数据() # 删除数据库数据【懒狗还没写】
│ ├── 提交() # 保存事务
│ ├── 断开() # 断开连接(断开前会自动提交)
│ ├── 判断连接() # 查看当前是否已连接
│ └── 标识符() # 静态方法,名称转反引号【一般无需手动调用】
├── 多线程() # 多线程并发执行任务,按输入顺序返回结果
# 一些小工具
├── 截图() # 截取屏幕
├── 解析ip() # 输入域名列表,解析出多个ip
├── 查归属() # 输入ip列表,解析出归属
├── 获取title() # 输入url,获取title 和 状态码
├── 发送邮件() # 发送邮件到指定邮箱
├── 批量发送邮件() # 批量发送邮件到指定邮箱
# 实用功能
└── 批量docx() # 从表格里面获取数据批量生成docx文件
函数使用方法
1.常用指令
1.1 彩蛋 xk()
讲解功能:没啥用,就是作者埋的一个彩蛋,调用看看?
示例代码:
from xiaokang import xk
xk()
输出:
彩蛋:
586339dfafa5608c
┌──────────────────────────────────────────┐
│ 恭喜你找到了隐藏彩蛋! │
│ 586339dfafa5608c 是小康留下的神秘暗号。 │
│ 当你集齐足够多的暗号,就能打开新世界。 │
└──────────────────────────────────────────┘
【彩蛋通关提示】暗号 586339dfafa5608c 其实是一个隐藏的线索,你可以试试把它当作 16 进制/密钥/哈希,去代码里找找它的来源……找到算你厉害!
1.2 报错信息()
讲解功能:在代码执行的时候,如果报错可以执行这个,查看详细的报错信息
参数:
报错信息(返回类型: str = "str", 保存到文件: str = "")
返回类型:输入返回结果的数据类型【str、dict、json】,默认 str
保存到文件:输入报错信息保存的文件名,若为空则不保存【python错误日志.txt】
示例代码:
try:
print('1'+1)
except:
print(报错信息('json'))
输出:
{
"报错类型":"<class 'TypeError'>",
"报错信息":"can only concatenate str (not \"int\") to str",
"报错文件":"C:\\xxx\\xxxx\\xxxxx\\test_1.py",
"报错行数":6
}
1.3 时间系列
讲解功能:返回各种格式的时间字符串,用于文件命名 / 打印 / 记录日志
| 函数 | 输出示例 | 用途 |
|---|---|---|
| 时间_文件_天() | 2026-03-16 | 文件命名 |
| 时间_文件_时() | 2026-03-16_10 | 文件命名 |
| 时间_文件_分() | 2026-03-16_10-55 | 文件命名 |
| 时间_文件_秒() | 2026-03-16_10-55-28 | 文件命名 |
| 时间_正常() | 2026-03-16 10:55:28 | 只能打印,不能命名文件(含冒号) |
| 时间_日志() | 2026-03-16 10:55:28.724013 | 记录日志(带毫秒时间戳) |
示例代码:
from xiaokang import 时间_文件_天
print(时间_文件_天())
2.sqlite数据库操作
2.1 连接()
用于连接指定数据库文件,连接后在操作,文件可以不存在,不存在的文件会自动创建
输入格式:(sqlite 的 db文件 位置)
返回格式:(是否成功,提示信息)
列子:
from xiaokang import sqlite数据库操作
a = sqlite数据库操作('xk.db')
b=a.连接()
print(b)
输出格式:(是否成功,提示信息)
(True, '数据库连接成功')
2.2 创建表()
在数据库中创建表格,设置字段格式,默认字段类型是“TEXT”
输入格式:
创建表(self, 表名: str, 字段: list, 字段类型: dict = {}, 字段默认值="TEXT")
表名:创建的数据库表名
字段:需要创建的字段列表,['A', 'b', 'c', 'D']
字段类型:字段类型字典,{'A': 'integer', 'c': 'real', 'D': 'bolo'},默认值TEXT
字段默认值:字段默认值,默认TEXT
返回格式:(是否成功,提示信息)
列子:
b=a.创建表(表名='Information', 字段=['A', 'b', 'c', 'D'], 字段类型={'A': 'integer', 'c': 'real', 'D': 'bolo'}, 字段默认值="TEXT")
print(b)
输出格式:(是否成功,提示信息)
(True, '创建成功')
2.3 新增数据()
新增数据可以快速循环写入多个数据。【需要提交才会保存】
输入格式:
新增数据(self, 表名: str, 数据: dict)
表名:新增数据的数据库表名
数据:新增的数据字典
返回格式:(是否成功,新增数据的序号)
列子:
b=a.新增数据(表名='Information', 数据={'A': 1, 'b': 'b', 'c': 3.1415926, 'D': True})
print(b)
b=a.提交()
print(b)
输出格式:(是否成功,新增数据的序号【即该行的 rowid,从 1 开始】)
(True, 1)
(True, '事务提交成功')
2.4 读取数据()
读取数据库数据,设置查看的字段,匹配条件,显示多少行数据
输入格式:
读取数据(self, 表名: str, 查看字段: list = ["*"], 判断匹配: list = [], 显示行数: list = [])
表名:查询的数据库表名
查看字段:需要查看的字段,默认['*'],表示全部字段,['A', 'b', 'c', 'D'],表示只查看A、b、c、D字段
判断匹配:需要匹配的条件,默认[],表示不匹配,['A=1', 'and', 'b="2b"'],表示匹配A=1且b="2b",分隔是空格
显示行数:需要显示的行数,默认[],表示全部行,[0,10],表示显示从第0行后显示10行
返回格式:(是否成功,读取的数据[tuple,...])
列子:
b=a.读取数据(表名='Information', 查看字段=['A', 'b', 'c', 'D'], 判断匹配=['A=1', 'and', 'b="b"'], 显示行数=[0, 1])
print(b)
输出格式:(是否成功,读取的数据,True/False 存为 1/0)
(True, [(1, 'b', 3.1415926, 1)])
2.5 修改数据()
修改已经存在的数据,设置匹配条件,和修改的数据。【需要提交才会保存】
输入格式:
修改数据(self, 表名: str, 查数据: list, 写数据: dict)
表名:修改数据的数据库表名
查数据:需要匹配的条件列表,元素是 ('字段', '比较符', 值) 元组,用 'and'/'or' 字符串连接;例如 [('A', '=', 1), 'and', ('b', '=', 'b')] 表示匹配 A=1 且 b="b"
写数据:需要修改的字段字典,{'c': 21.45116, 'D': False}
返回格式:(是否成功,提示信息)
列子:
b=a.修改数据(表名='Information', 查数据=[('A', '=', 1), 'and', ('b', '=', 'b')], 写数据={'c': 21.45116, 'D': False})
print(b)
b=a.提交()
print(b)
输出格式:(是否成功,提示信息)
(True, '修改成功')
(True, '事务提交成功')
2.6 执行SQL()
直接执行复杂或者固定的sql语句
输入格式:(sql语句)
返回格式:(是否成功,提示信息)
列子:
b=a.执行SQL('SELECT *,rowid "NAVICAT_ROWID" FROM "main"."Information" LIMIT 0,1000')
print(b)
输出格式:(是否成功,查询结果[tuple,...],末尾附 rowid)
(True, [(1, 'b', 21.45116, 0, 1), (1, '2b', 3.1415926, 1, 2)])
2.7 删除数据()【懒狗还没写】
输入格式:
返回格式:(是否成功,提示信息)
列子:
输出格式:(是否成功,提示信息)
2.8 提交()
提交存在变化的数据,比如:新增、修改、删除
输入格式:无输入数据
返回格式:(是否成功,提示信息)
列子:
b=a.提交()
print(b)
输出格式:(是否成功,提示信息)
(True, '事务提交成功')
2.9 断开()
断开数据库连接,防止抱死
输入格式:无输入数据
返回格式:(是否成功,提示信息)
列子:
b=a.断开()
print(b)
输出格式:(是否成功,提示信息)
(True, '数据库连接断开')
3.mysql数据库操作
操作远程/本机 MySQL 数据库,方法命名、参数习惯与第 2 章 sqlite 基本一致,同样遵循「(是否成功,结果/提示)」的返回约定。
与 sqlite 的主要区别:
- 连接参数不同:MySQL 需要地址、账号、密码,可指定库名/端口/编码,没有"数据库文件"的概念
- 需要先装好 MySQL 服务,且目标库/账号要有权限,否则连接会失败
- 字段类型必须用 MySQL 类型:
INT、VARCHAR(255)、DOUBLE、TINYINT、TEXT、DATETIME等。与 sqlite 不同,MySQL 不认integer/real这类 sqlite 习惯写法(REAL是 DOUBLE 的别名可用),写未知类型会直接报语法错误;最稳妥是INT+VARCHAR(255)+DOUBLE+TINYINT - 表名/字段名用反引号包裹,带库名时写成
库.表,内部自动转成`库`.`表` - 新增数据返回的是自增序号(依赖表的主键自增,无自增主键时返回 0)
- 创建表/断开连接会自动提交,其余写操作仍需手动
提交() - 布尔值
True/False存成1/0,读出来也是整数 1/0(建议字段用TINYINT(1))
3.1 连接()
初始化连接参数并连接 MySQL 数据库。
输入格式:(类构造时传入连接参数)
mysql数据库操作(数据库地址, 账号, 密码, 数据库='', 端口=3306, 编码='utf8mb4', 操作日志='', 报错日志='')
数据库地址:MySQL 服务器地址,例如 '127.0.0.1'(远程就填服务器 IP/域名)
账号/密码:MySQL 登录账号和密码
数据库:要连接的库名,为空则不预选库(连上后再用 执行SQL 建库或操作)
端口:MySQL 端口,默认 3306
编码:连接编码,默认 utf8mb4(中文推荐)
操作日志:操作日志文件路径,为空则不写日志;建议写完整路径(如 'logs/操作.log'),带目录时请保证目录已存在
报错日志:报错日志文件路径,为空则不写日志;带目录时目录不存在会自动创建
⚠ 注意:报错日志目前不支持纯文件名(不带目录),请传完整路径,否则初始化会报错。
返回格式:(是否成功,提示信息);已连接时再次调用会直接返回 (True, '数据库已连接') 跳过
列子:
from xiaokang import mysql数据库操作
a = mysql数据库操作('127.0.0.1', 'root', 'root', 数据库='test')
b = a.连接()
print(b)
输出格式:(是否成功,提示信息)
(True, '数据库连接成功')
连接失败时返回 (False, 报错信息),例如账号密码错:
(False, "{'报错类型': \"<class 'pymysql.err.OperationalError'>\", ...}")
小贴士:如果还没建库,可以先不传
数据库参数连上服务器,然后a.执行SQL("CREATE DATABASE IF NOT EXISTS test")建库(MySQL 的 DDL 建库语句会自动生效,无需提交),最后用带库名的表名(如test.用户表)操作。
3.2 创建表()
在数据库中创建表格,设置字段及类型,未指定的字段默认用 字段默认值 指定的类型。内部会自动提交,无需再手动提交。
输入格式:
创建表(self, 表名: str, 字段: list, 字段类型: dict = {}, 字段默认值="TEXT")
表名:要创建的表名,可用 '库.表' 写法,例如 'test.用户表'
字段:字段名列表,例如 ['A', 'b', 'c', 'D']
字段类型:字段类型字典,{'A': 'INT', 'b': 'VARCHAR(255)', 'c': 'DOUBLE', 'D': 'TINYINT'},只写想指定的字段即可
字段默认值:未在 字段类型 中指定的字段统一用的类型,默认 "TEXT"
返回格式:(是否成功,提示信息)
列子:
b = a.创建表(表名='Information', 字段=['A', 'b', 'c', 'D'], 字段类型={'A': 'INT', 'b': 'VARCHAR(255)', 'c': 'DOUBLE', 'D': 'TINYINT'})
print(b)
输出格式:(是否成功,提示信息)
(True, '创建成功')
3.3 新增数据()
向表中插入一条数据,数据用字典表示(键=字段名,值=要存的值)。需要提交才会真正保存。
输入格式:
新增数据(self, 表名: str, 数据: dict)
表名:要写入的数据库表名
数据:一条记录的字典,{'A': 1, 'b': '小明', 'c': 3.1415926, 'D': True}
返回格式:(是否成功,新增数据的自增序号【依赖表有自增主键,无则返回 0】)
列子:
b = a.新增数据(表名='Information', 数据={'A': 1, 'b': '小明', 'c': 3.1415926, 'D': True})
print(b)
b = a.提交()
print(b)
输出格式:(是否成功,自增序号)然后(是否成功,提示信息)
(True, 1)
(True, '事务提交成功')
3.4 读取数据()
按条件查询数据,可指定查看字段、匹配条件和分页范围。
输入格式:
读取数据(self, 表名: str, 查看字段: list = ["*"], 判断匹配: list = [], 显示行数: list = [])
表名:查询的数据库表名,可写 '库.表'
查看字段:要查的字段列表,默认 ['*'] 查全部;['A', 'b'] 表示只查这两列
判断匹配:查询条件,默认 [] 表示不带条件查全部;写法是字符串列表,['A=1', 'and', 'b="小明"'] 表示 A=1 且 b="小明"。注意:字符串值要自己加引号(建议用单引号 '小明' 更稳,双引号在 MySQL 默认模式下也当字符串,但如果服务器开了 ANSI_QUOTES 模式双引号会被当成字段名),数字不用加引号
显示行数:分页,默认 [] 表示全部;[0, 10] 表示从第 0 行开始取 10 行(对应 SQL 的 LIMIT 0,10)
返回格式:(是否成功,查询结果[tuple,...],每行是一个元组,列顺序与 查看字段 一致)
列子:
b = a.读取数据(表名='Information', 查看字段=['A', 'b', 'c', 'D'], 判断匹配=['A=1', 'and', 'b="小明"'], 显示行数=[0, 10])
print(b)
输出格式:(是否成功,查询结果,True/False 读出为 1/0)
(True, [(1, '小明', 3.1415926, 1)])
不带条件的例子(全表查询):
b = a.读取数据(表名='Information')
print(b)
输出:
(True, [(1, '小明', 3.1415926, 1), (2, '小红', 2.718, 0)])
3.5 修改数据()
按条件修改已有数据。需要提交才会真正保存。
输入格式:
修改数据(self, 表名: str, 查数据: list, 写数据: dict)
表名:要修改的数据库表名
查数据:匹配条件列表,元素是 ('字段', '比较符', 值) 元组,条件之间用 'and'/'or' 字符串连接;例如 [('A', '=', 1), 'and', ('b', '=', '小明')] 表示 匹配 A=1 且 b="小明"
写数据:要改成什么,字典,键=字段名,值=新值;{'c': 21.45116, 'D': False}
返回格式:(是否成功,提示信息)
列子:
b = a.修改数据(表名='Information', 查数据=[('A', '=', 1), 'and', ('b', '=', '小明')], 写数据={'c': 21.45116, 'D': False})
print(b)
b = a.提交()
print(b)
输出格式:(是否成功,提示信息)
(True, '修改成功')
(True, '事务提交成功')
3.6 执行SQL()
直接执行任意 SQL 语句(建库、建表、增删改查都可以),适合本库没封装或比较复杂的语句。
输入格式:(sql语句字符串)
返回格式:(是否成功,查询结果[tuple,...];SELECT 等查询语句返回行数据,非查询语句结果为空)
列子:
b = a.执行SQL('SELECT * FROM Information LIMIT 0,1000')
print(b)
输出格式:(是否成功,查询结果)
(True, [(1, '小明', 21.45116, 0), (2, '小红', 2.718, 1)])
执行建库/建表等 DDL 或 UPDATE 后,请记得 提交():
b = a.执行SQL("CREATE DATABASE IF NOT EXISTS test")
print(b)
b = a.提交()
print(b)
3.7 删除数据()【懒狗还没写】
与 sqlite 一样还没实现,需要删除时先用 执行SQL("DELETE FROM 表名 WHERE ...") 代替,之后记得 提交()。
3.8 提交()
把新增/修改/执行SQL 产生的变更真正保存到数据库(MySQL 默认自动提交是关的,不提交不生效)。
输入格式:无输入数据
返回格式:(是否成功,提示信息)
列子:
b = a.提交()
print(b)
输出格式:(是否成功,提示信息)
(True, '事务提交成功')
3.9 断开()
断开数据库连接。断开前会自动提交一次未保存的变更(防丢数据),然后关闭连接。
输入格式:无输入数据
返回格式:(是否成功,提示信息)
列子:
b = a.断开()
print(b)
输出格式:(是否成功,提示信息)
(True, '数据库连接断开')
未连接时调用不会报错,返回:
(False, '未连接,已跳过断开')
3.10 判断连接()
查看当前对象是否处于已连接状态。
输入格式:无输入数据
返回格式:(是否已连接[True/False],'已连接'/'未连接')
列子:
b = a.判断连接()
print(b)
输出格式:
(True, '已连接')
3.11 标识符()【静态方法】
类自带的方法,不需要实例就能调用。作用:把表名/字段名转成带反引号的 MySQL 标识符,名称含 . 时按 `库`.`表` 分段处理;名称里含反引号会转义。一般由内部方法自动调用,手动拼 SQL 时才需要它。
输入格式:(名称字符串)
返回格式:(反引号包裹后的字符串)
列子:
from xiaokang import mysql数据库操作
print(mysql数据库操作.标识符('Information'))
print(mysql数据库操作.标识符('test.Information'))
print(mysql数据库操作.标识符('a`b'))
输出格式:
`Information`
`test`.`Information`
`a``b`
4.d多线程
4.1 多线程()
讲解功能:用指定数量的线程并发处理一批任务,结果按输入顺序返回;某个任务抛异常时,该位置返回 None,不影响其他任务
参数:
多线程(列表: list, 函数, 线程数: int, 提示进度: bool = True)
列表:任务列表,每个元素会作为 函数 的一个入参
函数:处理单个任务的函数(只接收一个参数)
线程数:同时启动多少个线程
提示进度:是否在终端打印进度条,默认 True
返回格式:(与输入顺序一致的结果列表)
列子:
from xiaokang import 多线程
def 平方(n):
return n * n
结果 = 多线程([1, 2, 3, 4, 5, 6], 平方, 线程数=3, 提示进度=False)
print(结果)
输出格式:
[1, 4, 9, 16, 25, 36]
提示进度开启时的输出格式:
启动 3 个线程处理 6 个任务
[████████████████████████████████████████] 100.0% (6/6)
多线程处理完成
5.小工具
5.1 截图()
会直接显示你当前屏幕截图,全屏,自动适应分辨率
参数:
截图(save_path=None, start_x=0, start_y=0, width=None, height=None)
save_path (str|None): 保存路径,例如 C:\test.png,为None则不保存
width (int|None): 截图宽度,为None则全屏
height (int|None): 截图高度,为None则全屏
start_x (int): 起始X坐标
start_y (int): 起始Y坐标
from xiaokang import 截图
a = 截图()
a.show()
5.2 解析ip()
输入域名,多线程调用多个DNS服务器解析域名ip
参数:
解析ip(域名列表: list, DNS: list = None, 返回类型: str = 'list')
域名列表:每个域名一个元素,例如 ['www.baidu.com', 'www.sina.com.cn']
DNS:DNS服务器列表,默认使用内置的常用DNS服务器列表
返回类型:默认 'list',返回 {域名: [[IPv4列表], [IPv6(AAAA)列表]]} 字典
⚠ 注意:当前实现的返回结构与参数名相反——传 'list' 时返回的是字典,传 'dict' 时反而返回 [(域名, [[IPv4], [IPv6]])] 列表。文档按实际行为描述,后续版本会修正参数语义。
列子:
a = 解析ip(['www.baidu.com', 'www.sina.com.cn'])
print(a)
输出格式(结构示意):
{'www.baidu.com': [['110.242.68.3', '39.156.66.10'], ['2408:8752:...']], 'www.sina.com.cn': [['...'], []]}
解析失败的记录类型会得到空列表。
5.3 查归属()
查询ip的归属地,按顺序输出,记得自己去重
参数:[ip,ip,ip]
列子:
a = 查归属(['103.235.46.102', '103.235.46.115', '183.2.172.177', '110.242.70.57', '45.113.192.101'])
print(a)
输出:
[['103.235.46.102', '中国香港香港 百度云'], ['103.235.46.115', '中国香港香港 百度云'], ['183.2.172.177', '中国广东广州 电信'], ['110.242.70.57', '中国河北保定 联通'], ['45.113.192.101', '新加坡 百度云']]
5.4 获取title()
讲解功能:获取网页的 title 和状态码,结果写入 x小工具1.结果 字典
参数:
获取title(url: str, ssl: bool = True, timeout: int = 10, 进程锁=None)
url:要访问的域名,例如 'www.baidu.com'
ssl:True 用 https 访问,False 用 http
timeout:超时秒数
进程锁:多线程调用时传入线程锁,避免并发写冲突;单线程可不传
⚠ 注意:函数把结果写入模块级字典
x小工具1.结果(函数本身不会创建它),所以调用前要先初始化这个字典,格式为 {域名: {'https': [], 'http': []}};否则会报 结果 未定义。解析失败/连接失败会在对应位置写入 '报xk错:…' 标记,状态码记 -1。
列子:
import threading
from xiaokang import x小工具1
# 第 1 步:初始化结果容器
x小工具1.结果 = {'www.baidu.com': {'https': [], 'http': []}}
# 第 2 步:调用(单线程可不传 进程锁)
x小工具1.获取title('www.baidu.com', 进程锁=threading.Lock())
print(x小工具1.结果)
输出(结构示意):
{'www.baidu.com': {'https': ['百度一下,你就知道\t200'], 'http': []}}
网页没有 title 时,会记录网页大小,例如 '网页大小:123456\t200'。
5.5 发送邮件()
发送一封邮件
参数:
发送邮件(发送者: str, 接收者: str, POP3: str, 邮件主题: str, 邮件内容: str)
发送者:你的 QQ 邮箱地址(当前只支持 QQ 邮箱)
接收者:收件人邮箱地址
POP3:QQ 邮箱的 POP3/SMTP 授权码(在 QQ 邮箱设置里开启服务后获取)
邮件主题/邮件内容:要发送的主题和正文(文本)
返回格式:成功 True,失败 False
a = 发送邮件('XX@qq.com', 'XX@qq.com', 'POP3-KEY', '测试邮件标题', '测试邮件内容')
print(a)
5.6 批量发送邮件()
发送一堆邮件(同一封内容发给多个收件人)
参数:
批量发送邮件(发送者: str, 接收者: list, POP3: str, 邮件主题: str, 邮件内容: str)
接收者:收件人邮箱地址的列表 ['XX1@qq.com', 'XX2@qq.com']
其余参数同 5.5 发送邮件
返回格式:全部发送成功 True,任一失败 False
a = 批量发送邮件('XX@qq.com', ['XX1@qq.com', 'XX2@qq.com'], 'POP3-KEY', '测试邮件标题', '测试邮件内容')
print(a)
6.实用工具
6.1 批量docx()
把表格里面的数据直接变成docx,实现批量自动修改,欢迎反馈bug
from xiaokang import 批量docx
docx模板路径 = "批量word报告\\{ceshi}.docx"
xlsx表格路径 = "批量word报告\\1.xlsx"
输出目录='批量word报告\\cs\\'
批量docx(docx模板路径, xlsx表格路径, 输出目录)
docx模板格式如下,每个变量都要用"{}"符号括起来
xlsx文件格式
每个表的表头就是docx里面的变量,文件名也是变量,可以自定义文件名
文件生成如下
文件内容如下
安装方法
pip install xiaokang
本仓库是源码形式,安装前请先安装下方「依赖说明」中列出的依赖,或直接执行:
pip install -e .
使用示例
导入函数会吧,不会自己学
# 方法一:从包直接导入(顶层已导出的功能)
from xiaokang import 多线程, 批量docx, 报错信息
from xiaokang import mysql数据库操作, sqlite数据库操作 # 数据库操作类也在顶层
# 方法二:从子模块导入(需要操作模块内部对象时用)
from xiaokang import x小工具1 # 获取title 需要操作模块级结果字典,建议用这种方式
依赖说明
用到的第三方依赖及版本如下(见 pyproject.toml),请用 pip 安装对应版本:
| 依赖 | 版本 | 用途 |
|---|---|---|
| python-docx | 1.2.0 | 批量docx 读写 Word |
| pandas | 2.3.3 | 批量docx 读取 xlsx 表格数据 |
| openpyxl | 3.1.5 | xlsx 引擎(pandas 读取依赖) |
| pyautogui | 0.9.54 | 截图 |
| pillow | 12.0.0 | 图像处理(截图保存/显示) |
| dnspython | 2.8.0 | 解析ip(DNS 解析) |
| requests | 2.32.5 | 查归属 / 获取title 发 HTTP 请求 |
| bs4 | 0.0.2 | 解析网页(查归属 / 获取title / 批量docx 表格) |
| pymysql | 1.1.2 | mysql数据库操作 |
安装命令:
pip install python-docx==1.2.0 pandas==2.3.3 openpyxl==3.1.5 pyautogui==0.9.54 pillow==12.0.0 dnspython==2.8.0 requests==2.32.5 bs4==0.0.2 pymysql==1.1.2
补充:批量docx 用到的
合并样式相同块等是模块内部函数,一般无需直接调用。
作者信息
作者:小康、米汤、鲁班
Metadata
Release files for xiaokang 1.2.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| xiaokang-1.2.10.tar.gz | 49.6 kB | Without provenance | Details for xiaokang-1.2.10.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| xiaokang-1.2.10-py3-none-any.whl | Python 3 | none | any | Details for xiaokang-1.2.10-py3-none-any.whl |
Total release size: 79.7 kB
Release files / xiaokang-1.2.10.tar.gz
| Download URL | xiaokang-1.2.10.tar.gz |
|---|---|
| Size | 49.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
38fc88699f02a20cd0b4e7974866693ef0c4adc6ca97af9fde5ec7dda57e7441
|
|
BLAKE2b-256 checksum How to use checksums |
a722377bca50ec7b247a274bac872daec6273f726558f56695e37946842c66ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Release files / xiaokang-1.2.10-py3-none-any.whl
| Download URL | xiaokang-1.2.10-py3-none-any.whl |
|---|---|
| Size | 30.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a6f132a9022497a5656cc6e44ce8e1079cc153e799ccf73df2a43269498a05f2
|
|
BLAKE2b-256 checksum How to use checksums |
dc52728d616eda6790083b5b9fb309a3d570e3c5d8abe43e98ec9d5cb703ca13
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Security for xiaokang 1.2.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.