IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Fix Google Docstring argument regex in Napoleon. Argument type matching is now more permissive

Browse Source
This commit is contained in:
Rob Ruana 2015-02-15 18:51:29 -05:00
parent 5b0bb8c1e1
commit e968a6c1a1
1 changed files with 18 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
sphinx/ext/napoleon/docstring.py
View File

@ -23,9 +23,8 @@ from sphinx.util.pycompat import UnicodeMixin
_directive_regex = re.compile(r'\.\. \S+::')
_google_untyped_arg_regex = re.compile(r'\s*(\*?\*?\w+)\s*:\s*(.*)')
_google_typed_arg_regex = re.compile(r'\s*(\*?\*?\w+)\s*\(\s*(.+?)\s*\)\s*:'
r'\s*(.*)')
_google_untyped_arg_regex = re.compile(r'\s*(.+?)\s*:\s*(.*)')
_google_typed_arg_regex = re.compile(r'\s*(.+?)\s*\(\s*(.+?)\s*\)\s*:\s*(.*)')
class GoogleDocstring(UnicodeMixin):
@ -178,17 +177,17 @@ class GoogleDocstring(UnicodeMixin):
def _consume_indented_block(self, indent=1):
lines = []
line = self._line_iter.peek()
while(not self._is_section_break()
and (not line or self._is_indented(line, indent))):
while(not self._is_section_break() and
(not line or self._is_indented(line, indent))):
lines.append(next(self._line_iter))
line = self._line_iter.peek()
return lines
def _consume_contiguous(self):
lines = []
while (self._line_iter.has_next()
and self._line_iter.peek()
and not self._is_section_header()):
while (self._line_iter.has_next() and
self._line_iter.peek() and
not self._is_section_header()):
lines.append(next(self._line_iter))
return lines
@ -400,11 +399,11 @@ class GoogleDocstring(UnicodeMixin):
def _is_section_break(self):
line = self._line_iter.peek()
return (not self._line_iter.has_next()
or self._is_section_header()
or (self._is_in_section
and line
and not self._is_indented(line, self._section_indent)))
return (not self._line_iter.has_next() or
self._is_section_header() or
(self._is_in_section and
line and
not self._is_indented(line, self._section_indent)))
def _parse(self):
self._parsed_lines = self._consume_empty()
@ -743,12 +742,12 @@ class NumpyDocstring(GoogleDocstring):
def _is_section_break(self):
line1, line2 = self._line_iter.peek(2)
return (not self._line_iter.has_next()
or self._is_section_header()
or ['', ''] == [line1, line2]
or (self._is_in_section
and line1
and not self._is_indented(line1, self._section_indent)))
return (not self._line_iter.has_next() or
self._is_section_header() or
['', ''] == [line1, line2] or
(self._is_in_section and
line1 and
not self._is_indented(line1, self._section_indent)))
def _is_section_header(self):
section, underline = self._line_iter.peek(2)