quokka-flask-admin 1.4.2.1

简介

Flask-Admin是一个电池包含的、易于使用的 Flask 扩展，允许您为Flask应用程序添加管理界面。它受 django-admin 包的启发，但以这种方式实现，使得开发者可以完全控制最终应用程序的外观、感觉和功能。

开箱即用，Flask-Admin与各种ORM很好地配合，包括

• SQLAlchemy,

• MongoEngine,

• pymongo 和

• Peewee.

它还提供了一个简单的文件管理界面和一个 redis客户端 控制台。

Flask-Admin最大的特点是灵活性。它旨在提供一套简单工具，可用于构建任何复杂性的管理界面。因此，您可以在很短的时间内创建一个非常简单的应用程序，为每个模型自动生成CRUD视图。但随后您可以进一步自定义这些视图和表单，以满足需求。

Flask-Admin是一个活跃的项目，经过充分测试，适用于生产环境。

示例

在 /examples 文件夹中包含了一些使用示例。请随时添加您自己的示例，或者改进现有的示例，然后通过 GitHub 以 pull-request 的形式提交。

您可以在 http://examples.flask-admin.org 上看到一些示例的实际运行情况。要在本地环境中逐个运行示例，您可以这样做：

cd flask-admin
python examples/simple/app.py

文档

Flask-Admin 有详细的文档，您可以在 https://flask-admin.readthedocs.io/en/latest/ 找到所有文档。

文档是从 /doc 文件夹中的 .rst 文件自动生成的。因此，如果您发现任何错误，或者认为应该包含其他内容，请进行更改，并以 pull-request 的形式提交。

要在本地环境中构建文档，请从项目目录执行以下操作：

pip install -r requirements-dev.txt
sudo make html

如果您想预览您可能想要贡献的任何 .rst 片段，请访问 http://rst.ninjs.org/。

安装

要安装 Flask-Admin，只需这样做：

pip install flask-admin

或者，您也可以下载仓库并手动安装，操作如下：

git clone git@github.com:flask-admin/flask-admin.git
cd flask-admin
python setup.py install

测试

测试是用 nose 运行的。如果您不熟悉这个包，可以从其网站获得更多信息：他们的网站。

要从项目目录运行测试，请这样做：

pip install -r requirements-dev.txt
nosetests

您应该看到类似的输出：

.............................................
----------------------------------------------------------------------
Ran 102 tests in 13.132s

OK

为了使所有测试都成功通过，您需要在本地运行 Postgres 和 MongoDB。对于 Postgres

CREATE DATABASE flask_admin_test;
CREATE EXTENSION postgis;

第三方内容

Flask-Admin 是在 Bootstrap 和 Select2 的帮助下构建的。

如果您想本地化应用程序，请安装 Flask-BabelEx 包：Flask-BabelEx。

您可以通过 Crowdin 帮助改进 Flask-Admin 的翻译：https://crowdin.com/project/flask-admin

1.4.2

• 小错误修复版本。修复了阻止使用自定义格式器的“虚拟”列的问题。

1.4.1

• 官方 Python 3.5 支持

• 可自定义行操作

• Tablib 支持（导出到 XLS、XLSX、CSV 等）

• 更新外部依赖项（jQuery、x-editable 等）

• 添加设置，允许在视图错误上引发异常

• 错误修复

1.4.0

• 更新和重构文档

• FileAdmin 进行了轻微重构，现在支持远程文件系统。附带新的、可选的 AWS S3 文件管理界面

• 为模型视图配置可导出的 CSV

• 添加了可覆盖的 URL 生成逻辑。允许在管理视图中使用带有参数的自定义 URL

• 添加 column_display_actions 到 ModelView，以在不覆盖模板的情况下控制动作列的可见性

• 添加了对最新 MongoEngine 的支持

• 新的 SecureForm 基类，以便更容易进行 CSRF 验证

• 许多与翻译相关的问题修复和更新翻译

• 错误修复

1.3.0

• 新功能：在列表视图中通过弹出窗口编辑模型

• 新功能：只读模型详细信息视图

• 修复了 column_editable_list 值中的 XSS

• 改进了模型创建和编辑视图中的导航一致性

• 在模型列表视图中选择页面大小

• 更新客户端依赖项（jQuery、Select2 等）

• 更新文档和示例

• 更新翻译

• 错误修复