summaryrefslogtreecommitdiff
path: root/sphinx/ext/autodoc.py
diff options
context:
space:
mode:
authorJohannes Dewender <bitbucket@JonnyJD.net>2013-01-22 17:58:45 +0100
committerJohannes Dewender <bitbucket@JonnyJD.net>2013-01-22 17:58:45 +0100
commit6b9f35455ddadfe519289ed6867a9798ba40918a (patch)
tree91d8641859084cde845a62ff31e11f5cc5beaa9a /sphinx/ext/autodoc.py
parentde1f19da362fc9d629382d9b8f54bbd9b10eb6d4 (diff)
downloadsphinx-git-6b9f35455ddadfe519289ed6867a9798ba40918a.tar.gz
autodoc: novalue option for autodata and autoattribute
This adds a ":novalue:" option to "autodata" and "autoattribute" from the autodoc extension. When the option is set, no value will be in the output.
Diffstat (limited to 'sphinx/ext/autodoc.py')
-rw-r--r--sphinx/ext/autodoc.py19
1 files changed, 12 insertions, 7 deletions
diff --git a/sphinx/ext/autodoc.py b/sphinx/ext/autodoc.py
index 45dbdcdb4..4181818bc 100644
--- a/sphinx/ext/autodoc.py
+++ b/sphinx/ext/autodoc.py
@@ -1097,6 +1097,8 @@ class DataDocumenter(ModuleLevelDocumenter):
objtype = 'data'
member_order = 40
priority = -10
+ option_spec = ModuleLevelDocumenter.option_spec
+ option_spec["novalue"] = bool_option
@classmethod
def can_document_member(cls, member, membername, isattr, parent):
@@ -1104,12 +1106,13 @@ class DataDocumenter(ModuleLevelDocumenter):
def add_directive_header(self, sig):
ModuleLevelDocumenter.add_directive_header(self, sig)
- try:
- objrepr = safe_repr(self.object)
- except ValueError:
- pass
- else:
- self.add_line(u' :annotation: = ' + objrepr, '<autodoc>')
+ if not "novalue" in self.options:
+ try:
+ objrepr = safe_repr(self.object)
+ except ValueError:
+ pass
+ else:
+ self.add_line(u' :annotation: = ' + objrepr, '<autodoc>')
def document_members(self, all_members=False):
pass
@@ -1181,6 +1184,8 @@ class AttributeDocumenter(ClassLevelDocumenter):
"""
objtype = 'attribute'
member_order = 60
+ option_spec = ModuleLevelDocumenter.option_spec
+ option_spec["novalue"] = bool_option
# must be higher than the MethodDocumenter, else it will recognize
# some non-data descriptors as methods
@@ -1216,7 +1221,7 @@ class AttributeDocumenter(ClassLevelDocumenter):
def add_directive_header(self, sig):
ClassLevelDocumenter.add_directive_header(self, sig)
- if not self._datadescriptor:
+ if not self._datadescriptor or "novalue" in self.options:
try:
objrepr = safe_repr(self.object)
except ValueError: