Skip to content

taojy123/nanorm

Repository files navigation

Nanorm : A simple ORM of Python

这是一个精简的Python ORM框架。旨在于用一个文件写出ORM,提供开发小型或微型项目时的一些基本功能。

为什么要使用nanorm?

当你的项目足够小,以至于不想与其他的多余库产生依赖关系,但是你又需要使用一些简单的ORM功能(SQLAlchemy对你来说过于庞大),这时你就可以选择Nanorm。它只有一个py文件,直接把它放在你的项目目录下就行,你甚至可以把它嵌入在你的源代码中。

为什么只支持sqlite3?

这个ORM的目的只在于解决一些小微项目的需求,sqlite3对于小微项目来说是很好的选择。因为在Python标准库中就有对sqlite3的支持,不需要像使用mysql时那样另外安装mysqldb库。另一方面,你也不用在你的电脑或服务器上安装数据库服务,大多数windows和unix的操作系统都自带了sqlite3的支持。我们的目的就是精简,极简。

如何使用?

安装:

pip install nanorm

下面是一个最简单的例子

from nanorm import *

set_db_name("example.db")

class User(Model):
    name = CharField()
    age = IntegerField(default=20)
    sex = BooleanField()

s1 = User()
s1.name = "Joe"
s1.age = 45
s1.sex = True
s1.save()

joe = User.get(age=45)
print(joe)

具体的高级功能和用法可参照 nanorm_example.py 文件中各场景的用例