fix spliting of parameter lines.

if ' : ' is present twice in the line this drops any test after the second
' : ', which happens in some docstring that have the `default : stuff` idiom

Author: Carreau

numpydoc/docscrape.py

@@ -220,7 +220,7 @@ def _parse_param_list(self, content, single_element_is_type=False):
         while not r.eof():
             header = r.read().strip()
             if ' : ' in header:
-                arg_name, arg_type = header.split(' : ')[:2]
+                arg_name, arg_type = header.split(' : ', maxsplit=1)
             else:
                 if single_element_is_type:
                     arg_name, arg_type = '', header

numpydoc/tests/test_docscrape.py

@@ -55,6 +55,8 @@
 
       In other words, each entry ``out[i,j,...,:]`` is an N-dimensional
       value drawn from the distribution.
+  dtype : data type object, optional (default : float)
+      The type and size of the data to be returned.
   list of str
       This is not a real return value.  It exists to test
       anonymous return values.
@@ -199,20 +201,25 @@ def test_other_parameters():
 
 
 def test_returns():
-    assert len(doc['Returns']) == 3
+    assert len(doc['Returns']) == 4
     arg, arg_type, desc = doc['Returns'][0]
     assert arg == 'out'
     assert arg_type == 'ndarray'
     assert desc[0].startswith('The drawn samples')
     assert desc[-1].endswith('distribution.')
-
+    
     arg, arg_type, desc = doc['Returns'][1]
+    assert arg == 'dtype'
+    assert arg_type == 'data type object, optional (default : float)'
+    assert desc[0].startswith('The type and size')
+    
+    arg, arg_type, desc = doc['Returns'][2]
     assert arg == ''
     assert arg_type == 'list of str'
     assert desc[0].startswith('This is not a real')
     assert desc[-1].endswith('anonymous return values.')
 
-    arg, arg_type, desc = doc['Returns'][2]
+    arg, arg_type, desc = doc['Returns'][3]
     assert arg == ''
     assert arg_type == 'no_description'
     assert not ''.join(desc).strip()
@@ -404,6 +411,8 @@ def test_str():
 
     In other words, each entry ``out[i,j,...,:]`` is an N-dimensional
     value drawn from the distribution.
+dtype : data type object, optional (default : float)
+    The type and size of the data to be returned.
 list of str
     This is not a real return value.  It exists to test
     anonymous return values.
@@ -570,6 +579,9 @@ def test_sphinx_str():
         In other words, each entry ``out[i,j,...,:]`` is an N-dimensional
         value drawn from the distribution.
 
+    **dtype** : data type object, optional (default : float)
+        The type and size of the data to be returned.
+
     list of str
         This is not a real return value.  It exists to test
         anonymous return values.