peewee Documentation Release 3.6.0

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

摘要

The document introduces the features and updates of Peewee ORM version 3.6.0. It highlights the rewritten query-builder for flexibility and power, integration of SQLite-specific features into the core Peewee, support for various database drivers, and numerous extensions including virtual-table implementation, user-defined functions, and more. The document also provides instructions for installation, testing, and contributing to the project.

AI总结

# Peewee 3.6.0 版本文档总结

## 核心功能
1. **查询功能**
- 支持增删改查操作，包括更新查询、删除查询和查询对象。
- 提供灵活强大的查询构建器，支持自定义函数和优化锁机制。

2. **SQLite 扩展**
- 将 SQLite 特定功能整合到核心库，包括用户自定义函数、聚合函数、排序规则、扩展加载和pragma 指令。
- 支持 SQLite 在线备份 API 和多种用户定义的哈希和排名函数。
- 支持增量 Blob I/O 和回滚钩子。

3. **新功能**
- 查询构建器底层重构，提供更灵活的 API。
- 整合了 SQLite 的虚拟表实现（来自 `sqlite-vtfunc`），支持 LSM 表和 Bloom 过滤器。

4. **模型定义**
- 模型类、字段和实例分别对应数据库表、列和行。
- 通过 `Meta` 类配置模型，指定数据库和表结构。

5. **错误处理**
- 提供多种错误类（如 `DataError`、`IntegrityError` 等），均继承自 `PeeWeeException`。

6. **日志记录**
- 所有查询记录在 `peewee` 命名空间中，使用标准库的 `logging` 模块以 DEBUG 级别输出。

7. **扩展支持**
- 支持主流数据库（SQLite、MySQL、PostgreSQL）以及通过 DB-API 2.0 扩展其他数据库。

## 安装与测试
- **安装**：通过 PyPI 安装最新版本：`pip install peewee`。
- **开发安装**：使用 Git 克隆代码仓库：`git clone https://github.com/coleifer/peewee.git`，然后运行 `python setup.py install`。
- **测试**：运行测试套件：`python runtests.py`。

## 贡献与反馈
- **报告问题**：在 GitHub 仓库 [https://github.com/coleifer/peewee/issues](https://github.com/coleifer/peewee/issues) 提交问题，尽量提供详细信息（如错误信息、代码片段、Peewee 版本等）。
- **提交补丁**：在提交代码前，先在 GitHub 上创建一个新问题描述拟议的更改，然后提交 Pull Request。
- **社区支持**：参与贡献、提问或分享使用经验，帮助改进库。

## 示例与文档
- 提供快速入门指南和示例项目（如 Twitter 风格的 Web 应用和博客应用）。
- 文档涵盖模型定义、数据存储与检索、关系与连接等内容。

## 总结
Peewee 是一个简单而强大的 ORM，支持多种数据库，提供灵活的查询构建和丰富的扩展功能。3.6.0 版本在查询性能、SQLite 支持和新功能开发方面有显著提升，适合快速开发和部署数据库驱动的应用程序。