Skip to main content

Flask extension that provides integration with MongoEngine and WTF model forms.

Project description


PyPI version CI Tests Documentation Status Maintainability Test Coverage PyPI - Downloads

Flask-MongoEngine is a Flask extension that provides integration with MongoEngine, WtfForms and FlaskDebugToolbar.


By default, Flask-MongoEngine will install integration only between Flask and MongoEngine. Integration with WTFForms and FlaskDebugToolbar are optional and should be selected as extra option, if required. This is done by users request, to limit amount of external dependencies in different production setup environments.

All methods end extras described below are compatible between each other and can be used together.

Installation with MongoEngine only support

# For Flask >= 2.0.0
pip install flask-mongoengine

We still maintain special case for Flask = 1.1.4 support (the latest version in 1.x.x branch). To install flask-mongoengine with required dependencies use legacy extra option.

# With Flask 1.1.4 dependencies
pip install flask-mongoengine[legacy]

Installation with WTFForms and Flask-WTF support

Flask-mongoengine can be installed with Flask-WTF and WTFForms support. This will extend project dependencies with Flask-WTF, WTFForms and related packages.

# With Flask-WTF and WTFForms dependencies
pip install flask-mongoengine[wtf]

Installation with Flask Debug Toolbar support

Flask-mongoengine provide beautiful extension to FlaskDebugToolbar allowing to monitor all database requests. To use this extension FlaskDebugToolbar itself required. If you need to install flask-mongoengine with related support, use:

# With FlaskDebugToolbar dependencies
pip install flask-mongoengine[toolbar]

Installation with all features together

# With Flask-WTF, WTFForms and FlaskDebugToolbar dependencies
pip install flask-mongoengine[wtf,toolbar]

Flask configuration

Flask-mongoengine does not provide any configuration defaults. User is responsible for setting up correct database settings, to exclude any possible misconfiguration and data corruption.

There are several options to set connection. Please note, that all except recommended are deprecated and may be removed in future versions, to lower code base complexity and bugs. If you use any deprecated connection settings approach, you should update your application configuration.

Please refer to complete connection settings description for more info.

Usage and API documentation

Full project documentation available on read the docs.

Contributing and testing

We are welcome for contributors and testers! Check Contribution guidelines.


Flask-MongoEngine is distributed under BSD 3-Clause License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flask-mongoengine-tschaume-1.1.0.tar.gz (235.2 kB view hashes)

Uploaded Source

Built Distribution

flask_mongoengine_tschaume-1.1.0-py3-none-any.whl (33.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page