Merge pull request #321 from noirbizarre/connect-parameter

Connect parameter

Author: itsnauman

docs/index.rst

@@ -74,6 +74,16 @@ Connection settings may also be provided individually by prefixing the setting w
     app.config['MONGODB_USERNAME'] = 'webapp'
     app.config['MONGODB_PASSWORD'] = 'pwd123'
 
+By default flask-mongoengine open the connection when extension is instanciated but you can configure it
+to open connection only on first database access by setting the ``MONGODB_SETTINGS['connect']`` parameter
+or its ``MONGODB_CONNECT`` flat equivalent to ``False``::
+
+    app.config['MONGODB_SETTINGS'] = {
+        'host': 'mongodb://localhost/database_name',
+        'connect': False,
+    }
+    # or
+    app.config['MONGODB_CONNECT'] = False
 
 Custom Queryset
 ===============

flask_mongoengine/connection.py

@@ -8,7 +8,7 @@
 
 
 MONGODB_CONF_VARS = ('MONGODB_ALIAS', 'MONGODB_DB', 'MONGODB_HOST', 'MONGODB_IS_MOCK',
-                     'MONGODB_PASSWORD', 'MONGODB_PORT', 'MONGODB_USERNAME')
+                     'MONGODB_PASSWORD', 'MONGODB_PORT', 'MONGODB_USERNAME', 'MONGODB_CONNECT')
 
 
 class InvalidSettingsError(Exception):