FastOD - Fast Operation Database
从此告别 SQL 语句,直接调用方法就可以实现增删改查!
一个简单、直观、强大的 MySQL 数据库操作工具,让你无需编写 SQL 语句即可完成常见的数据库操作。
✨ 核心特性
- 🚀 零 SQL 编写:完全面向对象的 API,告别繁琐的 SQL 语句
- 🎯 直观易用:简单暴力的使用方式,上手即用
- 🔄 灵活连接:支持传统连接和 URL 连接两种方式
- 💾 智能插入:自动推导数据类型,支持单条/批量插入
- 🛡️ 冲突处理:内置三种插入模式处理数据冲突
- 🔍 强大查询:支持条件查询、随机查询、分页等多种查询方式
- 📊 批量操作:高效的批量插入、更新、删除操作
- 🎲 测试友好:一键生成测试数据表
📋 环境要求
- Python 3.10+
- MySQL 数据库
📦 安装
pip install fastod
🚀 快速开始
1️⃣ 连接数据库
方式一:传统参数连接
from fastod import MySQL
# 直接传参
db = MySQL(
host="localhost",
port=3306,
username="root",
password="your_password",
db="test"
)
# 使用配置字典
MYSQL_CONF = {
'host': 'localhost',
'port': 3306,
'username': 'root',
'password': 'your_password',
'db': 'test'
}
db = MySQL(**MYSQL_CONF)
方式二:URL 连接
MYSQL_URL = "mysql://root:your_password@localhost:3306/test"
db = MySQL.from_url(MYSQL_URL)
2️⃣ 获取表对象
# 方式1:使用索引方式
people = db['people']
# 方式2:使用方法
people = db.pick_table('people')
3️⃣ 生成测试数据(可选)
# 一键创建测试表并插入数据
# 创建 people 表,每次插入 1000 条,总共插入 10000 条测试数据
people = db.gen_test_table('people', once=1000, total=10000)
📖 使用指南
📝 插入数据
单条插入
data = {'id': 10001, 'name': '小明', 'age': 10, 'gender': '男'}
# 基本插入
people.insert_data(data)
# 模式1:数据冲突时报错(默认行为)
# 模式2:数据冲突时忽略,使用 unique 参数
people.insert_data(data, unique='id')
# 模式3:数据冲突时更新,使用 update 参数
people.insert_data(data, update='age=age+1')
批量插入
data = [
{'id': 10002, 'name': '小红', 'age': 12, 'gender': '女'},
{'id': 10003, 'name': '小强', 'age': 13, 'gender': '男'},
{'id': 10004, 'name': '小白', 'age': 14, 'gender': '男'}
]
# 自动识别为批量插入
people.insert_data(data)
🗑️ 删除数据
# 基本删除:WHERE id=1
people.delete(id=1)
# IN 条件删除:WHERE id IN (1, 2, 3)
people.delete(id=[1, 2, 3])
# 带限制的删除:WHERE age=18 LIMIT 100
people.delete(age=18, limit=100)
✏️ 更新数据
# 基本更新:UPDATE people SET name='tony', job='理发师' WHERE id=1
people.update(new={'name': 'tony', 'job': '理发师'}, id=1)
# 多条件更新:UPDATE people SET job='程序员' WHERE name='thomas' AND phone='18959176772'
people.update(new={'job': '程序员'}, name='thomas', phone='18959176772')
🔍 查询数据
# 查询所有字段:SELECT * FROM people WHERE id=1
people.query(id=1)
# 查询指定字段:SELECT name, age FROM people WHERE id=2
people.query(pick='name, age', id=2)
# IN 条件查询:SELECT * FROM people WHERE age=18 AND gender IN ('男', '女')
people.query(age=18, gender=['男', '女'])
# 复杂查询:SELECT name FROM people WHERE age=18 AND gender IN ('男', '女') LIMIT 5
people.query(pick='name', age=18, gender=['男', '女'], limit=5)
# 查询数量
count = people.query_count(age=18)
# 检查数据是否存在
exists = people.exists(name='小明')
特殊条件查询
# NULL 查询:WHERE age IS NULL
people.query(age=None)
# NOT NULL 查询:WHERE age IS NOT NULL
people.query(age=True)
# IS NULL 查询:WHERE age IS NULL
people.query(age=False)
🎲 随机数据
# 随机返回 1 条数据(返回 dict)
data = people.random()
# 随机返回 5 条数据(返回 list)
data_list = people.random(limit=5)
🔄 遍历表(大数据量扫描)
# 遍历整张表,默认每轮扫描 1000 条
people.scan()
# 自定义处理函数
def show(lines):
for idx, item in enumerate(lines, start=1):
print(f'第{idx}条 {item}')
# 限制范围遍历:id 从 101 到 222,每轮扫描 100 条
people.scan(sort_field='id', start=101, end=222, once=100, dealer=show)
# 添加额外条件:在限制范围的基础上,只查询 age=18 的数据
people.scan(
sort_field='id',
start=101,
end=222,
once=100,
dealer=show,
add_cond='age=18'
)
🔧 高级功能
SQL 构建器
from fastod.core.db import GenSQL
# 快速构建 SQL 语句
sql = GenSQL('people').select('name, age').where(age=18).limit(10).build()
# 输出: SELECT name, age FROM people WHERE age = 18 LIMIT 10
批量更新
# 更新单条数据(基于 depend 字段)
people.update_one({'id': 1, 'name': '新名字'}, depend='id')
# 批量更新多条数据
data = [
{'id': 1, 'name': '小明', 'age': 20},
{'id': 2, 'name': '小红', 'age': 21},
]
people.update_many(data, depend='id')
# 单条 SQL 批量更新(使用 CASE WHEN)
people.update_some(data, depend='id')
去重插入
# 基于指定字段去重后插入
items = [
{'phone': '13800138000', 'name': '用户1'},
{'phone': '13800138001', 'name': '用户2'},
]
# 只插入表中不存在的 phone
people.dedup_insert_data(items, dedup='phone')
获取字段范围
# 获取字段最小值
min_age = people.get_min('age')
# 获取字段最大值
max_age = people.get_max('age')
📚 API 返回值
所有操作都会返回 Feedback 对象,包含以下属性:
result = people.query(id=1)
# 属性说明
result.ok # bool: 操作是否成功
result.affect # int: 影响的行数
result.result # list/dict/None: 查询结果
result.error # str/None: 错误信息
📝 更新日志
v0.2.6 (最新)
- 🛡️ 增强安全性:动态生成的字段名统一使用反引号(
`)包裹,避免 MySQL 保留字冲突 - 🐛 修复 Bug:修正
IN条件传入空列表导致的 SQL 语法错误 - 🐛 修复 Bug:修正
None值的查询条件,从= NULL纠正为标准的IS NULL - 🛡️ 提升鲁棒性:优化了
scan在空表情况下的扫描逻辑,避免比较异常 - 🔧 增强容错处理:大幅增强内部方法的异常处理,即使 SQL 失败也能安全返回默认值而不抛出崩溃
v0.2.5 (2025-07-06)
- ✨ 新增
GenSQL对象,快速构建 SQL 语句 - 🔧 多项性能优化和代码改进
v0.2.4 (2025-06-28)
- 📦 SQLResponse 统一存在三个属性
v0.2.3 (2025-06-27)
- 🔍 kwargs 中解析的
True值为IS NOT NULL,False值为IS NULL
⚠️ 注意事项
- Python 版本:需要 Python 3.10 或更高版本
- 连接池:自动管理数据库连接池,无需手动管理连接
- 数据安全:所有操作都使用参数化查询,防止 SQL 注入
- 唯一索引:使用
unique和update参数时,确保字段有唯一索引 - 批量操作:大数据量操作建议使用
scan方法分批处理
🤝 贡献
欢迎提交 Issue 和 Pull Request!
📄 许可证
MIT License
👨💻 作者
WangTuo - markadc@126.com
⭐ 如果这个项目对你有帮助,请给一个 Star!
Metadata
Release files for fastod 0.2.7
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 |
|---|---|---|---|---|
| fastod-0.2.7.tar.gz | 16.4 kB | Without provenance | Details for fastod-0.2.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fastod-0.2.7-py3-none-any.whl | Python 3 | none | any | Details for fastod-0.2.7-py3-none-any.whl |
Total release size: 31.4 kB
Release files / fastod-0.2.7.tar.gz
| Download URL | fastod-0.2.7.tar.gz |
|---|---|
| Size | 16.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2f160d003706e06924dabdd32d22d29d1aed54c60658c29d6353a5743eca85b4
|
|
BLAKE2b-256 checksum How to use checksums |
a14b5f83f7c2c62b2f32771c6ee57f377d8e9775603d8d9d2a556cb81e43aee9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.11
|
Release files / fastod-0.2.7-py3-none-any.whl
| Download URL | fastod-0.2.7-py3-none-any.whl |
|---|---|
| Size | 14.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b5e3ad42c2de1f809a8f09697bf7eaba8517e64a116c653a85d3544e487d0bc0
|
|
BLAKE2b-256 checksum How to use checksums |
35c4ddc1dc4148e0a99992df13d4907c42a77db3c46bce99911ff6b9850feeb9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.11
|
Security for fastod 0.2.7
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.