歡迎使用longan-sqlite3 v1.0
我們理解您需要更便捷更高效更輕量級(jí)的工具記錄數(shù)據(jù)，并將其中承載的價(jià)值傳播給他人籍茧，longan-sqlite3 是我們給出的答案 ———— 讓您的CURD從沒有如此隨心所欲版述。
github地址： https://github.com/myemperor/longan-sqlite3
什么是 longan
longan 是一種水果，很甜寞冯，喜歡的人吃很多渴析，不喜歡的人一吃就上火！
1. 以下是我們的行為守恒公式
longan=mc^2
2. 使用方法
- 安裝
pip install longan_sqlite
- 導(dǎo)入longan
from longan_sqlite import Longan, Flesh
- 初始化longan
Longan.init('test.db', True)
- 實(shí)例化longan
longan = Longan('company')
- 導(dǎo)入數(shù)據(jù)庫
longan.execute_file('company.sql')
- 其中的表結(jié)構(gòu) 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':
# 通過對(duì)象進(jìn)行刪除
longan.delete(r)
# 通過條件進(jìn)行刪除
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文檔
| 接口 | 參數(shù) | 說明 |
|---|---|---|
| init | db_path, debug | 初始化數(shù)據(jù)庫文件吮龄，開啟debug模式后檬某，將會(huì)打印sql語句 |
| select | - | 未開放，當(dāng)前版本默認(rèn)為選擇全部字段螟蝙，除非使用聚合函數(shù) |
| from_table | table_name | 指定查詢表 |
| where | **field_condition | 借鑒了Django中查詢的操作恢恼，"_"前為字段名，后為表達(dá)式胰默，需要傳遞值 |
| insert_or_update | *field_obj | 將一個(gè)或多個(gè)Flesh對(duì)象插入或更新到表中场斑，會(huì)自動(dòng)為對(duì)象添加主鍵 |
| delete | *field_obj | 可以通過where方法來根據(jù)條件來進(jìn)行刪除漓踢，也可以對(duì)一個(gè)或多個(gè)Flesh對(duì)象直接刪除，前提是對(duì)象擁有主鍵 |
| group_by | field | 對(duì)指定字段進(jìn)行分組 |
| aggregate | **field_condition | 可以參考where語句：字段名_聚合函數(shù)名="別名" |
| query | - | 查詢漏隐，需要組合使用 |
| primary_key | - | 主鍵 |
| ignore_case | ignore | 是否忽略大小寫 |
| limit | num, offset | 分頁 |
| order_by | field, desc | 根據(jù)字段進(jìn)行排序 |
4. Where子句操作表達(dá)式
| 操作符 | 運(yùn)算符 | 說明 |
|---|---|---|
| gt | > | 大于 |
| lt | < | 小于 |
| eq | = | 等于 |
| neq | != | 不等于 |
| egt | >= | 不小于 |
| elt | <= | 不大于 |
| like | LIKE | 字符串模糊查詢 |
| in | IN | 集合查詢喧半，參數(shù)傳值為tuple，如: age_in=(28, 29, 30) |
| between | BETWEEN | 介于兩值之間青责，參數(shù)傳值為兩個(gè)元素的tuple,如有多個(gè)則取第一個(gè)和最后一個(gè)挺据，如：age_between=(28, 30) |
