peewee Documentation Release 3.4.0

• 语言: 英语
• 格式: .epub
• 来源: docs.peewee-orm.com

摘要

文档介绍了Peewee ORM 3.4.0版本的功能和使用方法，包括数据库支持、查询构建、模型定义、扩展模块以及安装和测试等内容。Peewee支持SQLite、MySQL和PostgreSQL，并提供了丰富的扩展功能，如Schema Migrations、Flask工具和虚拟表实现。文档还介绍了如何贡献代码、报告问题以及快速入门指南。

AI总结

### Peewee 3.4.0 文档总结

Peewee 是一个简单且功能强大的 Python ORM，支持 SQLite、MySQL 和 PostgreSQL，并提供了丰富的扩展功能。以下是《Peewee Documentation Release 3.4.0》的核心内容总结：

---

#### 1. **新功能与特性**
- **混合属性**：支持混合类型属性。
- **键值存储**：提供键值存储功能。
- **快捷方式**：新增了多种查询和操作的快捷方式。
- **信号支持**：集成信号机制，用于监听模型事件。
- **pwiz 工具**：新增 `pwiz`，一个自动生成模型的工具。
- **模式迁移**：支持数据库模式的迁移。
- **反射**：支持从数据库表结构生成模型。
- **数据库 URL**：支持通过 URL 连接数据库。
- **连接池**：优化了数据库连接池的管理。
- **测试工具**：提供了测试数据库连接和查询的工具。
- **Flask 工具**：新增 Flask 插件，提供类似 Django 的管理界面和 RESTful API。
- **查询构建器**：增强了查询构建的灵活性。
- **声明表**：支持自定义表结构。
- **增删改查操作**：优化了 `Select`、`Insert`、`Update` 和 `Delete` 查询。
- **查询对象**：新增了更强大的查询对象功能。
- **高级功能**：
- **乐观锁定**：支持乐观并发控制。
- **每组顶部对象**：支持查询每组中的顶部对象。
- **每组顶部 N 个对象**：支持查询每组中的顶部 N 个对象。
- **自定义函数**：支持在 SQLite 中编写和使用自定义函数。

---

#### 2. **核心功能**
- **模型定义**：通过定义模型类映射到数据库表，字段实例映射到表中的列，模型实例映射到表中的行。
- **数据库支持**：
- **SQLite**：支持 SQLite 的扩展功能，如用户自定义函数、扩展加载等。
- **MySQL**：支持标准的 MySQL 配置和功能。
- **PostgreSQL**：支持扩展功能，如 `hstore`、JSON 和数组操作。
- **查询优化**：
- 移除了旧的 C 扩展，改用更简洁的查询构建方式。
- `Select.aggregate_rows()` 已移除，建议使用 `prefetch()` 替代。
- 支持更灵活的查询构造和结果处理。

---

#### 3. **安装与测试**
- **安装**：
- 通过 PyPI 安装：`pip install peewee`
- 通过 Git 克隆仓库安装：`git clone https://github.com/coleifer/peewee.git`
- **测试**：
- 运行测试套件：`python runtests.py`
- 支持针对特定功能或数据库驱动的测试。

---

#### 4. **贡献指南**
- **提交补丁**：
- 提交前，请在 GitHub 上打开一个新问题描述你的改动。
- 提交的补丁需包含单元测试和文档。
- **报告错误**：
- 检查问题是否已存在，若未存在，请提供详细的错误信息（包括回溯、代码片段、Peewee 版本和使用的数据库）。
- **参与社区**：
- 提问或回答问题，帮助改进 Peewee。

---

#### 5. **快速上手**
- **模型定义**：

  from peewee import *

  db = SQLiteDatabase('people.db')

  class Person(Model):
      name = CharField()
      age = IntegerField()

- **数据存储与查询**：

  # 存储数据
  person = Person(name='Alice', age=30)
  person.save()

  # 查询数据
  for person in Person.select():
      print(person.name, person.age)

---

#### 6. **注意**
- Peewee 3.0 已发布，文档基于 3.0 版本编写。若需要了解不兼容的更改，请查阅变更日志。
- Peewee 支持 Python 2.7+ 和 3.4+，开发主要基于 Python 3.6。

---

总结：Peewee 3.4.0 提供了丰富的功能和灵活的查询机制，适合快速开发数据库驱动的应用程序。其简洁的设计和强大的扩展性使其成为 Python 开发者的重要工具。