From 735d31723fb348f08be8fc2677dbb26beac5394a Mon Sep 17 00:00:00 2001 From: Andrew Svetlov Date: Sat, 27 Oct 2012 00:28:20 +0300 Subject: [PATCH] Issue #16243: add example for inspect.formatargspec Patch by Berker Peksag. --- Doc/library/inspect.rst | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) 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]) -- 2.40.0