add docs and up version

dev_requirements.txt

-pyldap==2.4.25.1
+-r requirements.txt
+Sphinx==1.4.3
+

docs/conf.py

@@ -63,9 +63,9 @@ copyright = u'2016, Alexandre Ferland'
 # built documents.
 #
 # The short X.Y version.
-version = '1.0.0'
+version = '1.1.0'
 # The full version, including alpha/beta/rc tags.
-release = '1.0.0'
+release = '1.1.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/index.rst

@@ -96,6 +96,8 @@ directives:
                                    Default: '*'
 ``LDAP_GROUP_MEMBER_FILTER_FIELD`` The group member filter field to use when using OpenLDAP.
                                    Default: '*'
+``LDAP_CUSTOM_OPTIONS``            ``dict`` of ldap options you want to set in this format: {option: value}.
+                                   Default: ``None``
 ================================== ================================================================
 
 
@@ -114,6 +116,10 @@ History
 
 Changes:
 
+- 1.1.0 June 7, 2016
+
+  - Add the ability the pass any valid pyldap config options via the LDAP_CUSTOM_OPTIONS configuration directive.
+
 - 1.0.1 June 5, 2016
 
   - Fix ldap filter import.

examples/blueprints/blueprints/config.py

+import ldap
+
+
 class BaseConfig(object):
     PROJECT = 'foo'
     SECRET_KEY = 'dev key'
@@ -9,3 +12,4 @@ class BaseConfig(object):
     LDAP_USERNAME = 'CN=user,OU=Users,DC=example,DC=org'
     LDAP_PASSWORD = 'password'
     LDAP_LOGIN_VIEW = 'core.login'
+    LDAP_CUSTOM_OPTIONS = {ldap.OPT_REFERRALS: 0}

examples/groups/app.py

+import ldap as l
 from flask import Flask, g, request, session, redirect, url_for
 from flask_simpleldap import LDAP
 
@@ -9,6 +10,7 @@ app.config['LDAP_HOST'] = 'ldap.example.org'
 app.config['LDAP_BASE_DN'] = 'OU=users,dc=example,dc=org'
 app.config['LDAP_USERNAME'] = 'CN=user,OU=Users,DC=example,DC=org'
 app.config['LDAP_PASSWORD'] = 'password'
+app.config['LDAP_CUSTOM_OPTIONS'] = {l.OPT_REFERRALS: 0}
 
 ldap = LDAP(app)
 

flask_simpleldap/__init__.py

@@ -59,7 +59,7 @@ class LDAP(object):
         app.config.setdefault('LDAP_OPENLDAP', False)
         app.config.setdefault('LDAP_GROUP_MEMBER_FILTER', '*')
         app.config.setdefault('LDAP_GROUP_MEMBER_FILTER_FIELD', '*')
-        app.config.setdefault('LDAP_CUSTOM_OPTIONS', {})
+        app.config.setdefault('LDAP_CUSTOM_OPTIONS', None)
 
         if app.config['LDAP_USE_SSL'] or app.config['LDAP_USE_TLS']:
             ldap.set_option(ldap.OPT_X_TLS_REQUIRE_CERT,
@@ -77,9 +77,9 @@ class LDAP(object):
 
     @staticmethod
     def _set_custom_options(conn):
-        options = current_app.config['LDAP_OPTIONS']
+        options = current_app.config['LDAP_CUSTOM_OPTIONS']
         if options:
-            for k, v in options.values():
+            for k, v in options.items():
                 conn.set_option(k, v)
         return conn
 

requirements.txt

 Flask==0.11
-mock==2.0.0
+mock==2.0.0  # for ci
+pyldap==2.4.25.1
+

setup.py

@@ -9,7 +9,7 @@ from setuptools import setup
 
 setup(
     name='Flask-SimpleLDAP',
-    version='1.0.1',
+    version='1.1.0',
     url='https://github.com/admiralobvious/flask-simpleldap',
     license='MIT',
     author='Alexandre Ferland',