peewee
Peewee 是一个简单而小巧的 ORM。它的概念很少（但很有表现力），因此它很容易学习和直观使用。
- 一个小型的、有表现力的 ORM
- python 2.7+ 和 3.4+ (用 3.6 开发)
- 支持 sqlite、mysql、postgresql 和 cockroachdb。
- 大量的扩展
新手接触 peewee？这些可能会有帮助：
例子
定义模型类似于 Django 或 SQLAlchemy：
from peewee import *
import datetime
db = SqliteDatabase('my_database.db')
class BaseModel(Model):
class Meta:
database = db
class User(BaseModel):
username = CharField(unique=True)
class Tweet(BaseModel):
user = ForeignKeyField(User, backref='tweets')
message = TextField()
created_date = DateTimeField(default=datetime.datetime.now)
is_published = BooleanField(default=True)
连接到数据库并创建表：
db.connect() db.create_tables([User, Tweet])
创建几行：
charlie = User.create(username='charlie')
huey = User(username='huey')
huey.save()
# No need to set `is_published` or `created_date` since they
# will just use the default values we specified.
Tweet.create(user=charlie, message='My first tweet')
Queries are expressive and composable:
# A simple query selecting a user.
User.get(User.username == 'charlie')
# Get tweets created by one of several users.
usernames = ['charlie', 'huey', 'mickey']
users = User.select().where(User.username.in_(usernames))
tweets = Tweet.select().where(Tweet.user.in_(users))
# We could accomplish the same using a JOIN:
tweets = (Tweet
.select()
.join(User)
.where(User.username.in_(usernames)))
# How many tweets were published today?
tweets_today = (Tweet
.select()
.where(
(Tweet.created_date >= datetime.date.today()) &
(Tweet.is_published == True))
.count())
# Paginate the user table and show me page 3 (users 41-60).
User.select().order_by(User.username).paginate(3, 20)
# Order users by the number of tweets they've created:
tweet_ct = fn.Count(Tweet.id)
users = (User
.select(User, tweet_ct.alias('ct'))
.join(Tweet, JOIN.LEFT_OUTER)
.group_by(User)
.order_by(tweet_ct.desc()))
# Do an atomic update
Counter.update(count=Counter.count + 1).where(Counter.url == request.url)
查看 twitter 应用示例。
学习更多
查看文档，了解更多的例子。
具体问题？来 irc.freenode.net 上的 #peewee 频道闲逛，或者发帖到邮件列表，http://groups.google.com/group/peewee-orm 。如果你想报告一个 bug，请在 GitHub 上创建一个新问题。
还想了解更多信息？
我已经写了很多关于使用 peewee（通常是 Flask）构建应用程序和 Web 服务的博客文章。如果你想看一些使用 peewee 的实际应用，下面的资源可能会很有用。
- 使用 Flask 和 Peewee 构建一个记事应用 以及 第二部分 和 第三部分。
- 使用 Flask 和 Peewee 构建的分析 web 服务。
- 个性化的新闻摘要（带有布尔查询解析器！）。
- 用 Peewee 构建 Flask 应用。
- 使用 Flask 和 Peewee 创建一个 lastpass 克隆。
- 创建一个书签 web 服务，对你的书签进行截图。。
- 使用 Flask 和 Peewee 创建一个 pastebin、wiki 和书签服务。
- 用 Python 和 SQLCipher 加密数据库。
- 亲爱的日记：使用 Peewee 加密的命令行日记。
- 使用 Peewee 和 Transitive Closure 扩展在 SQLite 中查询树结构。。
（The first version translated by vz on 2020.09.13）
