Metadata-Version: 2.4
Name: xiaokang
Version: 1.2.11
Summary: 一个简单的 Python 库
Author-email: ZhaoYuanKang <1756972525@qq.com>
License: MIT License
        
        Copyright (c) 2025 [ZhaoYuanKang or XiaoKang]
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        1. The above copyright notice and this permission notice shall be included in
           all copies or substantial portions of the Software.
        
        2. Any modifications or derivative works of this software must be distributed
           under the same MIT License and must retain the original copyright notice.
        
        3. This software is provided "as is", without warranty of any kind, express or
           implied, including but not limited to the warranties of merchantability,
           fitness for a particular purpose, and non-infringement. In no event shall
           the authors or copyright holders be liable for any claim, damages, or other
           liability, whether in an action of contract, tort, or otherwise, arising from,
           out of, or in connection with the software or the use or other dealings in the
           Software.
        
        特此许可任何人免费获取副本
        本软件和相关文档文件(“软件”)的交易
        在软件中不受限制，包括但不限于权利
        使用、复制、修改、合并、发布、分发、再许可和/或销售
        软件的副本，并允许软件的使用者
        符合以下条件:
        
        1.上述版权声明和本许可声明应包含在
        软件的所有副本或重要部分。
        
        2.本软件的任何修改或衍生作品都必须分发
        在相同的MIT许可下，必须保留原始版权声明。
        
        3.本软件按“原样”提供，没有任何形式的担保，明示或
        暗示，包括但不限于适销性保证，
        适用于特定目的，且不侵权。在任何情况下都不得
        作者或版权所有者对任何索赔、损害赔偿或其他
        责任，无论是在合同诉讼、侵权诉讼或其他诉讼中，由以下原因引起，
        出于或与本软件或本软件的使用或
        软件。
        
Project-URL: Personal website, http://121.37.247.246:200/
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-docx==1.2.0
Requires-Dist: pandas==2.3.3
Requires-Dist: openpyxl==3.1.5
Requires-Dist: pyautogui==0.9.54
Requires-Dist: pillow==12.0.0
Requires-Dist: dnspython==2.8.0
Requires-Dist: bs4==0.0.2
Requires-Dist: beautifulsoup4==4.15.0
Requires-Dist: requests==2.32.5
Requires-Dist: pymysql==1.1.2
Dynamic: license-file

# 项目简介

把一些常用的功能写成函数



---

# 函数大全

```
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列表，解析出归属
├──  发送邮件()					# 发送邮件到指定邮箱
├──  批量发送邮件()				# 批量发送邮件到指定邮箱

# 实用功能
└──  批量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.多线程

### 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 发送邮件()

发送一封邮件

参数：

```
发送邮件(发送者: 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.5 批量发送邮件()

发送一堆邮件（同一封内容发给多个收件人）

参数：

```
批量发送邮件(发送者: 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模板格式如下，每个变量都要用"{}"符号括起来

![image-20260316151956309](.\md图片\image-20260316151956309.png)



xlsx文件格式

每个表的表头就是docx里面的变量，文件名也是变量，可以自定义文件名

![image-20260316152137939](.\md图片\image-20260316152137939.png)



文件生成如下

![image-20260316152239472](.\md图片\image-20260316152239472.png)



文件内容如下

![image-20260316152333816](.\md图片\image-20260316152333816.png)

---

# 安装方法

```
pip install xiaokang
```

> 本仓库是源码形式，安装前请先安装下方「依赖说明」中列出的依赖，或直接执行：
> ```
> pip install -e .
> ```



---

# 使用示例

导入函数会吧，不会自己学

```
# 方法一：从包直接导入（顶层已导出的功能）
from xiaokang import 多线程, 批量docx, 报错信息
from xiaokang import mysql数据库操作, sqlite数据库操作   # 数据库操作类也在顶层

# 方法二：从子模块导入（需要操作模块内部对象时用）
from xiaokang.邮件 import 发送邮件   # 需要模块内部对象时，用子模块导入
```



---

# 依赖说明

用到的第三方依赖及版本如下（见 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 | 查归属 发 HTTP 请求 |
| bs4 | 0.0.2 | 解析网页（查归属 / 批量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 用到的 `合并样式相同块` 等是模块内部函数，一般无需直接调用。



---

# 作者信息

作者：小康、米汤、鲁班

---
