欢迎使用longan-sqlite3 v1.0
我们理解您需要更便捷更高效更轻量级的工具记录数据，并将其中承载的价值传播给他人，longan-sqlite3 是我们给出的答案 ———— 让您的CURD从没有如此随心所欲。
github地址： https://github.com/myemperor/longan-sqlite3
什么是 longan
longan 是一种水果，很甜，喜欢的人吃很多，不喜欢的人一吃就上火！
1. 以下是我们的行为守恒公式
longan=mc^2
2. 使用方法
- 安装
pip install longan_sqlite
- 导入longan
from longan_sqlite import Longan, Flesh
- 初始化longan
Longan.init('test.db', True)
- 实例化longan
longan = Longan('company')
- 导入数据库
longan.execute_file('company.sql')
- 其中的表结构 company.sql
CREATE TABLE IF NOT EXISTS COMPANY(
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
age INT NOT NULL,
address CHAR(50),
salary REAL
);
- Create
flesh = Flesh(name='emperor', age=23, address='北京', salary=10)
longan.insert_or_update(flesh)
- Update
flesh.age += 1
flesh.salary += 5
longan.insert_or_update(flesh)
- Query
ret = longan.where(age_gt=18, salary_elt=100, salary_gt=0).query()
for r in ret:
print(r)
- Delete
# 查询
ret = longan.where(age_gt=18, salary_elt=100, salary_gt=0).query()
for r in ret:
print(r)
if r.name == 'jobs':
# 通过对象进行删除
longan.delete(r)
# 通过条件进行删除
longan.where(id_gt=0).delete()
- 0.3新增分组聚合查询
longan.aggregate(age_max="maxAge", salary_min="minSalary")
longan.where(age_gt=5)
longan.group_by('address')
ret = longan.query()
for r in ret:
print(r)
3. API文档
| 接口 | 参数 | 说明 |
|---|---|---|
| init | db_path, debug | 初始化数据库文件，开启debug模式后，将会打印sql语句 |
| select | - | 未开放，当前版本默认为选择全部字段，除非使用聚合函数 |
| from_table | table_name | 指定查询表 |
| where | **field_condition | 借鉴了Django中查询的操作，"_"前为字段名，后为表达式，需要传递值 |
| insert_or_update | *field_obj | 将一个或多个Flesh对象插入或更新到表中，会自动为对象添加主键 |
| delete | *field_obj | 可以通过where方法来根据条件来进行删除，也可以对一个或多个Flesh对象直接删除，前提是对象拥有主键 |
| group_by | field | 对指定字段进行分组 |
| aggregate | **field_condition | 可以参考where语句：字段名_聚合函数名="别名" |
| query | - | 查询，需要组合使用 |
| primary_key | - | 主键 |
| ignore_case | ignore | 是否忽略大小写 |
| limit | num, offset | 分页 |
| order_by | field, desc | 根据字段进行排序 |
4. Where子句操作表达式
| 操作符 | 运算符 | 说明 |
|---|---|---|
| gt | > | 大于 |
| lt | < | 小于 |
| eq | = | 等于 |
| neq | != | 不等于 |
| egt | >= | 不小于 |
| elt | <= | 不大于 |
| like | LIKE | 字符串模糊查询 |
| in | IN | 集合查询，参数传值为tuple，如: age_in=(28, 29, 30) |
| between | BETWEEN | 介于两值之间，参数传值为两个元素的tuple,如有多个则取第一个和最后一个，如：age_between=(28, 30) |