René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Support __text_signature__ generation for C extensions","articleBody":"The CPython has no \"official\" way to specify signatures in extension modules.  I did (unsuccessful) attempt to address this issue in https://discuss.python.org/t/43914.\n\nOne approach (e.g. sphinx-doc) is using the [PEP 7](https://peps.python.org/pep-0007/#documentation-strings)-style docstrings:\n\u003e The first line of each function docstring should be a “signature line” that gives a brief synopsis of the arguments and return value.\n\nAnother one, used by CPython's builtin's and stdlib - fill the `__text_signature__` attribute for callables like:\n```\nfunction_name(arguments)\n--\n\nactual docstring, *without* PEP 7 \"signature line\".\n```\nThe ``function_name(arguments)`` line (with some specific syntax for the first function argument, you shouldn't care about) literally goes to the ``__text_signature__`` attribute.  While it's not a public API, hardly this interface will disappear soon.  Thus, some alternative Python implementation sometimes offer support for this way (though, incomplete, see e.g. pypy/pypy#5368).  Maybe GraalPy can too?\n\nIf no, maybe you could cut off all leading text from docstrings, before and including of the ``\\n--\\n\\n`` separator?  So, it will not appear in the help() output as now (using the python-gmp package as an example):\n```pycon\nPython 3.12.8 (Thu Oct 09 17:26:36 UTC 2025)\n[Graal, Oracle GraalVM, Java 25.0.1 (amd64)] on linux\nType \"help\", \"copyright\", \"credits\" or \"license\" for more information.\n\u003e\u003e\u003e from gmp import isqrt\n\u003e\u003e\u003e print(isqrt.__doc__)\nisqrt($module, n, /)\n--\n\nReturn the integer part of the square root of n.\n\u003e\u003e\u003e help(isqrt)\nHelp on built-in function isqrt in module gmp:\n\nisqrt(...)\n    isqrt($module, n, /)\n    --\n\n    Return the integer part of the square root of n.\n\n```","author":{"url":"https://github.com/skirpichev","@type":"Person","name":"skirpichev"},"datePublished":"2026-01-15T06:42:21.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/593/graalpython/issues/593"}