Flask-Admix 1.6.1.2

介绍

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

Flask-Admin默认与各种ORM协同工作，包括

• SQLAlchemy,

• pymongo和

• Peewee.

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

Flask-Admin的最大特点是灵活性。它的目标是提供一套简单的工具，可用于构建任何复杂性的管理界面。因此，您可以轻松创建一个非常简单的应用程序，并为每个模型自动生成CRUD视图。但之后，您可以根据需要进一步自定义这些视图和表单。

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

示例

在/examples文件夹中包含了一些使用示例。请添加您自己的示例，或改进现有示例，并提交一个pull-request。

在本地环境中运行示例

1. Clone the repository::

      git clone https://github.com/flask-admin/flask-admin.git
      cd flask-admin

2. Create and activate a virtual environment::

      virtualenv env -p python3
      source env/Scripts/activate

3. Install requirements::

      pip install -r examples/sqla/requirements.txt

4. Run the application::

      python examples/sqla/run_server.py

文档

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

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

在本地环境中构建文档，从项目目录下执行

tox -e docs-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

测试

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

要运行测试，从项目目录下执行

pip install -r requirements-dev.txt
pytest

您应该看到类似以下输出

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

OK

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

> psql postgres
CREATE DATABASE flask_admin_test;
\q

> psql flask_admin_test
CREATE EXTENSION postgis;
CREATE EXTENSION hstore;

如果您在MacOS上使用Homebrew，可能需要这个

# install postgis
> brew install postgis

# set up postgresql user
> createuser -s postgresql
> brew services restart postgresql

您还可以使用tox在多个环境中运行测试。

第三方内容

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

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

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