From: Andrew Svetlov Date: Fri, 26 Oct 2012 21:28:20 +0000 (+0300) Subject: Issue #16243: add example for inspect.formatargspec X-Git-Tag: v3.3.1rc1~743 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=735d31723fb348f08be8fc2677dbb26beac5394a;p=python Issue #16243: add example for inspect.formatargspec Patch by Berker Peksag. --- diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst index 4050ab3a14..01bbce8f50 100644 --- a/Doc/library/inspect.rst +++ b/Doc/library/inspect.rst @@ -716,7 +716,7 @@ Classes and functions locals dictionary of the given frame. -.. function:: formatargspec(args[, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, annotations, formatarg, formatvarargs, formatvarkw, formatvalue, formatreturns, formatannotations]) +.. function:: formatargspec(args[, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, annotations[, formatarg, formatvarargs, formatvarkw, formatvalue, formatreturns, formatannotations]]) Format a pretty argument spec from the values returned by :func:`getargspec` or :func:`getfullargspec`. @@ -725,7 +725,14 @@ Classes and functions ``defaults``, ``kwonlyargs``, ``kwonlydefaults``, ``annotations``). The other five arguments are the corresponding optional formatting functions that are called to turn names and values into strings. The last argument - is an optional function to format the sequence of arguments. + is an optional function to format the sequence of arguments. For example:: + + >>> from inspect import formatargspec, getfullargspec + >>> def f(a: int, b: float): + ... pass + ... + >>> formatargspec(*getfullargspec(f)) + '(a: int, b: float)' .. function:: formatargvalues(args[, varargs, varkw, locals, formatarg, formatvarargs, formatvarkw, formatvalue])