Improve getting signatures from text

- Discard IPython default signatures in case we're able to find others.
- Get signatures written in multiple lines at the beginning of
docstrings.

spyder_kernels/utils/dochelpers.py

@@ -207,12 +207,29 @@ def getsignaturefromtext(text, objname):
             # first match.
             sig = sigs[0] if objname else sigs[0][1]
         else:
+            # Default signatures returned by IPython. These are not real
+            # signatures but only used to provide a placeholder.
+            default_sigs = ['(*args, **kwargs)', '(self, /, *args, **kwargs)']
+
             if objname:
-                sig = sigs[0]
+                real_sigs = [s for s in sigs if s not in default_sigs]
+
+                if real_sigs:
+                    sig = real_sigs[0]
+                else:
+                    sig = sigs[0]
             else:
                 valid_sigs = [s for s in sigs if s[0].isidentifier()]
+
                 if valid_sigs:
-                    sig = valid_sigs[0][1]
+                    real_sigs = [
+                        s for s in valid_sigs if s[1] not in default_sigs
+                    ]
+
+                    if real_sigs:
+                        sig = real_sigs[0][1]
+                    else:
+                        sig = valid_sigs[0][1]
 
     return sig
 
@@ -225,7 +242,7 @@ def getargspecfromtext(text):
     This will return something like `(x, y, k=1)`.
     """
     blocks = text.split("\n\n")
-    first_block = blocks[0].strip()
+    first_block = blocks[0].strip().replace('\n', '')
     return getsignaturefromtext(first_block, '')
 
 

spyder_kernels/utils/tests/test_dochelpers.py

@@ -139,5 +139,21 @@ def foo():
     assert signature == "(x, y)"
 
 
+def test_multiline_signature():
+    """
+    Test that we can get signatures splitted in multiple lines in a docstring.
+    """
+    def foo():
+        """
+        foo(x,
+            y)
+
+        This is a docstring.
+        """
+
+    signature = getargspecfromtext(foo.__doc__)
+    assert signature.startswith("(x, ")
+
+
 if __name__ == "__main__":
     pytest.main()