GitHubじゃ!Pythonじゃ!

GitHubからPython関係の優良リポジトリを探したかったのじゃー、でも英語は出来ないから日本語で読むのじゃー、英語社会世知辛いのじゃー

flask-admin

flask-admin – Flaskのためのシンプルで拡張可能な管理インタフェースフレームワーク

投稿日:

Flaskのためのシンプルで拡張可能な管理インタフェースフレームワーク

フラスコ管理者

このプロジェクトは最近自組織に移管されました。 git@github.comへの参照を更新してください:flask-admin / flask-admin.git

前書き

Flask-Adminは、Flaskアプリケーションに管理インターフェースを追加することができる、バッテリー内蔵の使いやすいFlask拡張機能です。 これはdjango-adminパッケージからインスピレーションを受けていますが、開発者が結果として得られるアプリケーションの外観、感触、機能を完全に制御できるように実装されています。

すぐに使えるFlask-Adminは、以下を含む様々なORMでうまくいきます。

また、シンプルなファイル管理インターフェイスとRedisクライアントコンソールを備えています

Flask-Adminの最大の特徴は柔軟性です。 複雑な管理インターフェースを構築するためのシンプルなツールセットを提供することを目指しています。 したがって、まず、各モデルのCRUDビューを自動生成して、簡単なアプリケーションを短時間で作成することができます。 しかし、必要に応じてさらに進んで、それらのビューとフォームをカスタマイズすることができます。

Flask-Adminは、十分にテストされ、プロダクションが準備されているアクティブなプロジェクトです。

いくつかの使用例が/ examplesフォルダーに含まれています。 気軽にサンプルを追加したり、既存のサンプルを改良したりして、GitHub経由でプルリクエストとして提出してください。

これらのサンプルの一部は、 http://examples.flask-admin.orgに掲載されています。 ローカル環境でサンプルを実行するには、一度に1つずつ、次のようにします。

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

ドキュメンテーション

Flask-Adminは広範に文書化されており、 https://flask-admin.readthedocs.io/en/latest/ですべての文書を見つけることができます

ドキュメントは/ docフォルダ内の.rstファイルから自動生成されます。 だから、もしあなたが何か間違いを見つけた場合、あるいは他の何かが含まれていると思ったら、変更を加えてプルリクエストとして提出してください。

あなたのローカル環境内のドキュメントをプロジェクトディレクトリからビルドするには:

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

テスト

テストはノーズで実行されます あなたがこのパッケージに慣れていないなら、 彼らのウェブサイトからいくつかの情報を得ることができます。

テストを実行するには、プロジェクトディレクトリから次のようにします。

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;
CREATE EXTENSION hstore;

toxを使用して複数の環境でテストを実行することもできます。

サードパーティのもの

Flask-Adminは、 BootstrapSelect2の助けを借りて構築されています。

アプリケーションをローカライズする場合は、 Flask-BabelExパッケージをインストールします。

Crowdinを通じてFlask-Adminの翻訳を改善できます: https ://crowdin.com/project/flask-admin







-flask-admin

執筆者: