`sphinx.util.compat.Directive` class is now deprecated.

CHANGES

@@ -4,6 +4,9 @@ Release 1.6 (in development)
 Incompatible changes
 --------------------
 
+* ``sphinx.util.compat.Directive`` class is now deprecated. Please use instead
+  ``docutils.parsers.rsr.Directive``
+
 Features added
 --------------
 

sphinx/domains/cpp.py

@@ -15,6 +15,7 @@ from copy import deepcopy
 from six import iteritems, text_type
 
 from docutils import nodes
+from docutils.parsers.rst import Directive
 
 from sphinx import addnodes
 from sphinx.roles import XRefRole
@@ -22,7 +23,6 @@ from sphinx.locale import l_, _
 from sphinx.domains import Domain, ObjType
 from sphinx.directives import ObjectDescription
 from sphinx.util.nodes import make_refnode
-from sphinx.util.compat import Directive
 from sphinx.util.pycompat import UnicodeMixin
 from sphinx.util.docfields import Field, GroupedField
 

sphinx/domains/python.py

@@ -14,7 +14,7 @@ import re
 from six import iteritems
 
 from docutils import nodes
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 
 from sphinx import addnodes
 from sphinx.roles import XRefRole
@@ -22,7 +22,6 @@ from sphinx.locale import l_, _
 from sphinx.domains import Domain, ObjType, Index
 from sphinx.directives import ObjectDescription
 from sphinx.util.nodes import make_refnode
-from sphinx.util.compat import Directive
 from sphinx.util.docfields import Field, GroupedField, TypedField
 
 if False:

sphinx/domains/std.py

@@ -15,7 +15,7 @@ import unicodedata
 from six import PY3, iteritems
 
 from docutils import nodes
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 from docutils.statemachine import ViewList
 
 from sphinx import addnodes
@@ -25,7 +25,6 @@ from sphinx.domains import Domain, ObjType
 from sphinx.directives import ObjectDescription
 from sphinx.util import ws_re
 from sphinx.util.nodes import clean_astext, make_refnode
-from sphinx.util.compat import Directive
 
 if False:
     # For type annotation

sphinx/ext/autodoc.py

@@ -22,6 +22,7 @@ from six import PY2, iterkeys, iteritems, itervalues, text_type, class_types, \
 
 from docutils import nodes
 from docutils.utils import assemble_option_dict
+from docutils.parsers.rst import Directive
 from docutils.statemachine import ViewList
 
 import sphinx
@@ -30,7 +31,6 @@ from sphinx.locale import _
 from sphinx.pycode import ModuleAnalyzer, PycodeError
 from sphinx.application import ExtensionError
 from sphinx.util.nodes import nested_parse_with_titles
-from sphinx.util.compat import Directive
 from sphinx.util.inspect import getargspec, isdescriptor, safe_getmembers, \
     safe_getattr, object_description, is_builtin_class_method, isenumattribute
 from sphinx.util.docstrings import prepare_docstring

sphinx/ext/autosummary/__init__.py

@@ -63,14 +63,13 @@ from types import ModuleType
 
 from six import text_type
 
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 from docutils.statemachine import ViewList
 from docutils import nodes
 
 import sphinx
 from sphinx import addnodes
 from sphinx.util import import_object, rst
-from sphinx.util.compat import Directive
 from sphinx.pycode import ModuleAnalyzer, PycodeError
 from sphinx.ext.autodoc import Options
 

sphinx/ext/doctest.py

@@ -21,13 +21,12 @@ import doctest
 from six import itervalues, StringIO, binary_type, text_type, PY2
 
 from docutils import nodes
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 
 import sphinx
 from sphinx.builders import Builder
 from sphinx.util import force_decode
 from sphinx.util.nodes import set_source_info
-from sphinx.util.compat import Directive
 from sphinx.util.console import bold  # type: ignore
 from sphinx.util.osutil import fs_encoding
 

sphinx/ext/graphviz.py

@@ -20,7 +20,7 @@ from hashlib import sha1
 from six import text_type
 
 from docutils import nodes
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 from docutils.statemachine import ViewList
 
 import sphinx
@@ -28,7 +28,6 @@ from sphinx.errors import SphinxError
 from sphinx.locale import _
 from sphinx.util.i18n import search_image_for_language
 from sphinx.util.osutil import ensuredir, ENOENT, EPIPE, EINVAL
-from sphinx.util.compat import Directive
 
 if False:
     # For type annotation

sphinx/ext/ifconfig.py

@@ -21,10 +21,10 @@
 """
 
 from docutils import nodes
+from docutils.parsers.rst import Directive
 
 import sphinx
 from sphinx.util.nodes import set_source_info
-from sphinx.util.compat import Directive
 
 if False:
     # For type annotation

sphinx/ext/inheritance_diagram.py

@@ -48,14 +48,13 @@ from six import text_type
 from six.moves import builtins  # type: ignore
 
 from docutils import nodes
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 
 import sphinx
 from sphinx.ext.graphviz import render_dot_html, render_dot_latex, \
     render_dot_texinfo, figure_wrapper
 from sphinx.pycode import ModuleAnalyzer
 from sphinx.util import force_decode
-from sphinx.util.compat import Directive
 
 if False:
     # For type annotation

sphinx/ext/mathbase.py

@@ -10,13 +10,12 @@
 """
 
 from docutils import nodes, utils
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 
 from sphinx.roles import XRefRole
 from sphinx.locale import _
 from sphinx.domains import Domain
 from sphinx.util.nodes import make_refnode, set_source_info
-from sphinx.util.compat import Directive
 
 if False:
     # For type annotation

sphinx/util/compat.py

@@ -10,12 +10,17 @@
 """
 from __future__ import absolute_import
 
+import sys
 import warnings
 
 from docutils import nodes
 from docutils.parsers.rst import Directive  # noqa
 
+from docutils.parsers.rst import Directive  # noqa
 from docutils import __version__ as _du_version
+
+from sphinx.deprecation import RemovedInSphinx17Warning
+
 docutils_version = tuple(int(x) for x in _du_version.split('.')[:2])
 
 
@@ -38,3 +43,25 @@ def make_admonition(node_class, name, arguments, options, content, lineno,
         admonition_node['classes'] += classes
     state.nested_parse(content, content_offset, admonition_node)
     return [admonition_node]
+
+
+class _DeprecationWrapper(object):
+    def __init__(self, mod, deprecated):
+        # type: (Any, Dict) -> None
+        self._mod = mod
+        self._deprecated = deprecated
+
+    def __getattr__(self, attr):
+        if attr in self._deprecated:
+            warnings.warn("sphinx.util.compat.%s is deprecated and will be "
+                          "removed in Sphinx 1.7, please use the standard "
+                          "library version instead." % attr,
+                          RemovedInSphinx17Warning, stacklevel=2)
+            return self._deprecated[attr]
+        return getattr(self._mod, attr)
+
+
+sys.modules[__name__] = _DeprecationWrapper(sys.modules[__name__], dict(  # type: ignore
+    docutils_version = docutils_version,
+    Directive = Directive,
+))