Merge pull request #65 from NelleV/64_section_twice

Raise an error when a section is present twice

Author: stefanv

.gitignore

@@ -4,5 +4,7 @@
 *.pyc
 *.pyo
 *.egg-info
+*.swp
+*.swo
 build
 dist

numpydoc/docscrape.py

@@ -327,6 +327,11 @@ def _parse(self):
             if not section.startswith('..'):
                 section = (s.capitalize() for s in section.split(' '))
                 section = ' '.join(section)
+                if self.get(section):
+                    msg = ("The section %s appears twice in the docstring." %
+                           section)
+                    raise ValueError(msg)
+
             if section in ('Parameters', 'Returns', 'Yields', 'Raises',
                            'Warns', 'Other Parameters', 'Attributes',
                            'Methods'):

numpydoc/tests/test_docscrape.py

@@ -209,6 +209,22 @@ def test_returnyield():
 """
     assert_raises(ValueError, NumpyDocString, doc_text)
 
+
+def test_section_twice():
+    doc_text = """
+Test having a section Notes twice
+
+Notes
+-----
+See the next note for more information
+
+Notes
+-----
+That should break...
+"""
+    assert_raises(ValueError, NumpyDocString, doc_text)
+
+
 def test_notes():
     assert doc['Notes'][0].startswith('Instead')
     assert doc['Notes'][-1].endswith('definite.')