# Flask-MongoEngine
[![PyPI version](https://badge.fury.io/py/flask-mongoengine-3.svg)](https://badge.fury.io/py/flask-mongoengine-3)
[![CI Tests](https://github.com/idoshr/flask-mongoengine/actions/workflows/tests.yml/badge.svg)](https://github.com/flask/flask-mongoengine/actions/workflows/tests.yml)
[![Documentation Status](https://readthedocs.org/projects/flask-mongoengine-3/badge/?version=latest)](https://flask-mongoengine-3.readthedocs.io/en/latest/en/latest/?badge=latest)
[![Maintainability](https://api.codeclimate.com/v1/badges/6fb8ae00b1008f5f1b20/maintainability)](https://codeclimate.com/github/idoshr/flask-mongoengine/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/6fb8ae00b1008f5f1b20/test_coverage)](https://codeclimate.com/github/idoshr/flask-mongoengine/test_coverage)
![PyPI - Downloads](https://img.shields.io/pypi/dm/flask-mongoengine-3)
Flask-MongoEngine is a Flask extension that provides integration with [MongoEngine],
[WtfForms] and [FlaskDebugToolbar].
## Installation
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
```bash
# For Flask >= 2.0.0
pip install flask-mongoengine-3
```
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.
```bash
# With Flask 1.1.4 dependencies
pip install flask-mongoengine-3[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.
```bash
# With Flask-WTF and WTFForms dependencies
pip install flask-mongoengine-3[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:
```bash
# With FlaskDebugToolbar dependencies
pip install flask-mongoengine-3[toolbar]
```
### Installation with all features together
```bash
# With Flask-WTF, WTFForms and FlaskDebugToolbar dependencies
pip install flask-mongoengine-3[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].
## License
Flask-MongoEngine is distributed under [BSD 3-Clause License].
[MongoEngine]: https://github.com/MongoEngine/mongoengine
[WTFForms]: https://github.com/wtforms/wtforms
[Flask-WTF]: https://github.com/wtforms/flask-wtf
[FlaskDebugToolbar]: https://github.com/flask-debugtoolbar/flask-debugtoolbar
[read the docs]: https://flask-mongoengine-3.readthedocs.io/en/latest/
[Flask]: https://github.com/pallets/flask
[BSD 3-Clause License]: LICENSE.md
[Contribution guidelines]: CONTRIBUTING.md
[complete connection settings description]: https://flask-mongoengine-3.readthedocs.io/en/latest/flask_config.html
Raw data
{
"_id": null,
"home_page": null,
"name": "flask-mongoengine-3",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Ido Shraga <idoshraga@gmail.com>, Andrey Shpak <ashpak@ashpak.ru>",
"keywords": "flask, wtf, wtf-forms, forms, mongo, pymongo, mongoengine, extension",
"author": null,
"author_email": "Ross Lawley <ross.lawley@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/ad/c0/ddcbf1998a63770793034c0c3e9ca7d90993f222e899a9b00c930e55a6d0/flask-mongoengine-3-1.0.9.tar.gz",
"platform": "any",
"description": "# Flask-MongoEngine\n\n[![PyPI version](https://badge.fury.io/py/flask-mongoengine-3.svg)](https://badge.fury.io/py/flask-mongoengine-3)\n[![CI Tests](https://github.com/idoshr/flask-mongoengine/actions/workflows/tests.yml/badge.svg)](https://github.com/flask/flask-mongoengine/actions/workflows/tests.yml)\n[![Documentation Status](https://readthedocs.org/projects/flask-mongoengine-3/badge/?version=latest)](https://flask-mongoengine-3.readthedocs.io/en/latest/en/latest/?badge=latest)\n[![Maintainability](https://api.codeclimate.com/v1/badges/6fb8ae00b1008f5f1b20/maintainability)](https://codeclimate.com/github/idoshr/flask-mongoengine/maintainability)\n[![Test Coverage](https://api.codeclimate.com/v1/badges/6fb8ae00b1008f5f1b20/test_coverage)](https://codeclimate.com/github/idoshr/flask-mongoengine/test_coverage)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/flask-mongoengine-3)\n\nFlask-MongoEngine is a Flask extension that provides integration with [MongoEngine],\n[WtfForms] and [FlaskDebugToolbar].\n\n## Installation\n\nBy default, Flask-MongoEngine will install integration only between [Flask] and\n[MongoEngine]. Integration with [WTFForms] and [FlaskDebugToolbar] are optional and\nshould be selected as extra option, if required. This is done by users request, to\nlimit amount of external dependencies in different production setup environments.\n\nAll methods end extras described below are compatible between each other and can be\nused together.\n\n### Installation with MongoEngine only support\n\n```bash\n# For Flask >= 2.0.0\npip install flask-mongoengine-3\n```\n\nWe still maintain special case for [Flask] = 1.1.4 support (the latest version in 1.x.x\nbranch). To install flask-mongoengine with required dependencies use ``legacy``\nextra option.\n\n```bash\n# With Flask 1.1.4 dependencies\npip install flask-mongoengine-3[legacy]\n```\n\n### Installation with WTFForms and Flask-WTF support\n\nFlask-mongoengine can be installed with [Flask-WTF] and [WTFForms] support. This\nwill extend project dependencies with [Flask-WTF], [WTFForms] and related packages.\n\n```bash\n# With Flask-WTF and WTFForms dependencies\npip install flask-mongoengine-3[wtf]\n```\n\n### Installation with Flask Debug Toolbar support\n\nFlask-mongoengine provide beautiful extension to [FlaskDebugToolbar] allowing to monitor\nall database requests. To use this extension [FlaskDebugToolbar] itself required. If\nyou need to install flask-mongoengine with related support, use:\n\n```bash\n# With FlaskDebugToolbar dependencies\npip install flask-mongoengine-3[toolbar]\n```\n\n### Installation with all features together\n\n```bash\n# With Flask-WTF, WTFForms and FlaskDebugToolbar dependencies\npip install flask-mongoengine-3[wtf,toolbar]\n```\n\n## Flask configuration\n\nFlask-mongoengine does not provide any configuration defaults. User is responsible\nfor setting up correct database settings, to exclude any possible misconfiguration\nand data corruption.\n\nThere are several options to set connection. Please note, that all except\nrecommended are deprecated and may be removed in future versions, to lower code base\ncomplexity and bugs. If you use any deprecated connection settings approach, you should\nupdate your application configuration.\n\nPlease refer to [complete connection settings description] for more info.\n\n## Usage and API documentation\n\nFull project documentation available on [read the docs].\n\n## Contributing and testing\n\nWe are welcome for contributors and testers! Check [Contribution guidelines].\n\n## License\n\nFlask-MongoEngine is distributed under [BSD 3-Clause License].\n\n[MongoEngine]: https://github.com/MongoEngine/mongoengine\n\n[WTFForms]: https://github.com/wtforms/wtforms\n\n[Flask-WTF]: https://github.com/wtforms/flask-wtf\n\n[FlaskDebugToolbar]: https://github.com/flask-debugtoolbar/flask-debugtoolbar\n\n[read the docs]: https://flask-mongoengine-3.readthedocs.io/en/latest/\n\n[Flask]: https://github.com/pallets/flask\n\n[BSD 3-Clause License]: LICENSE.md\n\n[Contribution guidelines]: CONTRIBUTING.md\n\n[complete connection settings description]: https://flask-mongoengine-3.readthedocs.io/en/latest/flask_config.html\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "Flask extension that provides integration with MongoEngine and WTF model forms.",
"version": "1.0.9",
"project_urls": {
"Changelog": "https://github.com/idoshr/flask-mongoengine/releases",
"Documentation": "https://flask-mongoengine-3.readthedocs.io/en/latest/",
"Homepage": "https://github.com/idoshr/flask-mongoengine",
"Repository": "https://github.com/idoshr/flask-mongoengine"
},
"split_keywords": [
"flask",
" wtf",
" wtf-forms",
" forms",
" mongo",
" pymongo",
" mongoengine",
" extension"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "03b2aa562c8aa8b114187dbdd010e2a12263ab806ba80891ae053096d3de3ba4",
"md5": "d648eb6218332dd3d8693da196a49280",
"sha256": "379c8a7b4e3593cff7ac86714f373c2bee1f2d2cd4258d8846347b4d0f437c12"
},
"downloads": -1,
"filename": "flask_mongoengine_3-1.0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d648eb6218332dd3d8693da196a49280",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 36751,
"upload_time": "2024-03-30T15:27:21",
"upload_time_iso_8601": "2024-03-30T15:27:21.063687Z",
"url": "https://files.pythonhosted.org/packages/03/b2/aa562c8aa8b114187dbdd010e2a12263ab806ba80891ae053096d3de3ba4/flask_mongoengine_3-1.0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "adc0ddcbf1998a63770793034c0c3e9ca7d90993f222e899a9b00c930e55a6d0",
"md5": "82a381b80d4e8b296d80b076cd3ad5a6",
"sha256": "d05c590c1e8f3f4d179d1c09be7c5cbf0c2ba017aa893c460751d27b674bc910"
},
"downloads": -1,
"filename": "flask-mongoengine-3-1.0.9.tar.gz",
"has_sig": false,
"md5_digest": "82a381b80d4e8b296d80b076cd3ad5a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 239333,
"upload_time": "2024-03-30T15:27:22",
"upload_time_iso_8601": "2024-03-30T15:27:22.570670Z",
"url": "https://files.pythonhosted.org/packages/ad/c0/ddcbf1998a63770793034c0c3e9ca7d90993f222e899a9b00c930e55a6d0/flask-mongoengine-3-1.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-30 15:27:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "idoshr",
"github_project": "flask-mongoengine",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "flask-mongoengine-3"
}