欢迎使用Longan-sqlite3，给予Python3对sqlite抽象封装的功能

欢迎使用longan-sqlite3 v0.6

---

我们理解您需要更便捷更高效更轻量级的工具记录数据，并将其中承载的价值传播给他人，longan-sqlite3 是我们给出的答案 ———— 让您随心所欲的完成如下功能

• Create
• Research
• Update
• Delete

您现在看到的这个 longan-sqlite3 版本，仅为开发版，功能将陆续增加

0.6 新增排序和分页的函数，支持了几乎所有聚合函数

0.5 where子句
1.新增 between 和 in 的支持, 新增方法；
2.提供like表达式忽略大小写的功能
init方法提供debug模式，可以打印sql语句

0.4 新增API文档

0.3 新增分组聚合函数
0.2 修复了主键判断，修复了handler接口

---

什么是 longan

longan 是一种水果，很甜，喜欢的人吃很多，不喜欢的人一吃就上火！

1. 以下是我们计划中的功能

• [x] 支持 CRUD
• [x] 支持 分组聚合函数
• [x] 修复 API文档
• [x] 新增 where 语句支持

2. 以下是我们的行为守恒公式

longan=mc^2

3. 使用方法

• 导入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)

4. 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	根据字段进行排序