Metadata-Version: 2.4
Name: pboot-mongoengine
Version: 1.0.0
Summary: Pboot extension that provides integration with MongoEngine and WTF model forms.
Author-email: Ross Lawley <ross.lawley@gmail.com>
Maintainer: pboot-org
License: BSD 3-Clause License
Project-URL: Homepage, https://gitee.com/pboot-org/pboot-mongoengine
Project-URL: Documentation, http://docs.mongoengine.org/projects/flask-mongoengine/en/latest/
Project-URL: Repository, https://gitee.com/pboot-org/pboot-mongoengine
Project-URL: Changelog, https://gitee.com/pboot-org/pboot-mongoengine/blob/main/CHANGES.md
Keywords: pboot,wtf,wtf-forms,forms,mongo,pymongo,mongoengine,extension
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md
License-File: AUTHORS.md
Requires-Dist: pboot>=3.2.0
Requires-Dist: mongoengine>=0.21
Requires-Dist: importlib-metadata; python_version < "3.8"
Provides-Extra: wtf
Requires-Dist: WTForms[email]>=3.0.0; extra == "wtf"
Requires-Dist: Flask-WTF>=0.14.3; extra == "wtf"
Provides-Extra: toolbar
Requires-Dist: Flask-DebugToolbar>=0.11.0; extra == "toolbar"
Provides-Extra: dev
Requires-Dist: black==22.6.0; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-mock; extra == "dev"
Requires-Dist: nox; extra == "dev"
Requires-Dist: Pillow>=7.0.0; extra == "dev"
Requires-Dist: blinker; extra == "dev"
Provides-Extra: legacy
Requires-Dist: MarkupSafe==2.0.1; extra == "legacy"
Provides-Extra: legacy-dev
Requires-Dist: pytest; extra == "legacy-dev"
Requires-Dist: pytest-cov; extra == "legacy-dev"
Requires-Dist: pytest-mock; extra == "legacy-dev"
Requires-Dist: Pillow>=7.0.0; extra == "legacy-dev"
Requires-Dist: blinker; extra == "legacy-dev"
Dynamic: license-file

# Pboot-MongoEngine

[![PyPI version](https://badge.fury.io/py/pboot-mongoengine.svg)](https://badge.fury.io/py/pboot-mongoengine)
[![CI Tests](https://github.com/MongoEngine/flask-mongoengine/actions/workflows/tests.yml/badge.svg)](https://github.com/MongoEngine/flask-mongoengine/actions/workflows/tests.yml)
[![Documentation Status](https://readthedocs.org/projects/pboot-mongoengine/badge/?version=latest)](http://docs.mongoengine.org/projects/pboot-mongoengine/en/latest/?badge=latest)
[![Maintainability](https://api.codeclimate.com/v1/badges/6fb8ae00b1008f5f1b20/maintainability)](https://codeclimate.com/github/MongoEngine/pboot-mongoengine/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/6fb8ae00b1008f5f1b20/test_coverage)](https://codeclimate.com/github/MongoEngine/pboot-mongoengine/test_coverage)
![PyPI - Downloads](https://img.shields.io/pypi/dm/pboot-mongoengine)

Pboot-MongoEngine is a Pboot extension that provides integration with [MongoEngine],
[WtfForms] and [PbootDebugToolbar].

## Installation

By default, Pboot-MongoEngine will install integration only between [Pboot] and
[MongoEngine]. Integration with [WTFForms] and [PbootDebugToolbar] 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 Pboot >= 2.0.0
pip install pboot-mongoengine
```

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

```bash
# With Pboot 1.1.4 dependencies
pip install pboot-mongoengine[legacy]
```

### Installation with WTFForms and Flask-WTF support

Pboot-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 pboot-mongoengine[wtf]
```

### Installation with Pboot Debug Toolbar support

Pboot-mongoengine provide beautiful extension to [PbootDebugToolbar] allowing to monitor
all database requests. To use this extension [PbootDebugToolbar] itself required. If
you need to install pboot-mongoengine with related support, use:

```bash
# With PbootDebugToolbar dependencies
pip install pboot-mongoengine[toolbar]
```

### Installation with all features together

```bash
# With Flask-WTF, WTFForms and PbootDebugToolbar dependencies
pip install pboot-mongoengine[wtf,toolbar]
```

## Pboot configuration

Pboot-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

Pboot-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

[PbootDebugToolbar]: https://github.com/flask-debugtoolbar/flask-debugtoolbar

[read the docs]: http://docs.mongoengine.org/projects/pboot-mongoengine/

[Pboot]: https://github.com/pallets/pboot

[BSD 3-Clause License]: LICENSE.md

[Contribution guidelines]: CONTRIBUTING.md

[nox]: https://nox.thea.codes/en/stable/usage.html

[complete connection settings description]: http://docs.mongoengine.org/projects/pboot-mongoengine/pboot_config.html
