Move sphinx callback to a separate sphinx submodule

configurations/__init__.py

@@ -25,11 +25,5 @@ def load_ipython_extension(ipython):
 
 
 def setup(app=None):
-    """
-    The callback for Sphinx that acts as a Sphinx extension.
-
-    Add ``'configurations'`` to the ``extensions`` config variable
-    in your docs' ``conf.py``.
-    """
+    """Function used to initialize configurations similar to :func:`.django.setup`."""
     _setup()
-    return {'version': __version__, 'parallel_read_safe': True}

configurations/sphinx.py

@@ -0,0 +1,12 @@
+from . import _setup, __version__
+
+
+def setup(app=None):
+    """
+    The callback for Sphinx that acts as a Sphinx extension.
+
+    Add ``'configurations'`` to the ``extensions`` config variable
+    in your docs' ``conf.py``.
+    """
+    _setup()
+    return {'version': __version__, 'parallel_read_safe': True}

docs/cookbook.rst

@@ -224,8 +224,6 @@ As you can see django-configurations provides a helper module
 Sphinx
 ------
 
-.. versionadded: 0.9
-
 In case you would like to user the amazing `autodoc` feature of the
 documentation tool `Sphinx <http://sphinx-doc.org/>`_, you need add
 django-configurations to your ``extensions`` config variable and set
@@ -245,7 +243,11 @@ the environment variable accordingly:
         'sphinx.ext.intersphinx',
         'sphinx.ext.viewcode',
         # ...
-        'configurations',
+        'configurations.sphinx',
     ]
 
     # ...
+
+.. versionchanged:: 2.0
+
+Please note that the sphinx callable has been moved from `configurations` to `configurations.sphinx`.

tests/docs/conf.py

@@ -9,7 +9,7 @@
 os.environ.setdefault('DJANGO_CONFIGURATION', 'Test')
 
 extensions = [
-    'configurations',
+    'configurations.sphinx',
 ]
 
 # The suffix of source filenames.

tests/test_sphinx.py

@@ -6,7 +6,7 @@
 from django.conf import settings
 
 
-class ShpinxTests(TestCase):
+class SphinxTests(TestCase):
     docs_dir = os.path.join(settings.BASE_DIR, 'docs')
 
     def test_multiprocessing(self):

tox.ini

@@ -2,7 +2,7 @@
 skipsdist = True
 usedevelop = True
 minversion = 1.8
-whitelist_externals=build-sphinx
+whitelist_externals=sphinx-build
 envlist =
     flake8-py27,
     flake8-py35,