(original) (raw)

changeset: 96213:621e98bfc74b user: Yury Selivanov yselivanov@sprymix.com date: Fri May 22 16:28:05 2015 -0400 files: Doc/library/inspect.rst Doc/whatsnew/3.5.rst description: Issue 20438: Add a note about deprecating old inspect APIs to whatsnew. Also, deprecate formatargspec, formatargvalues, and getargvalues functions. Since we are deprecating 'getfullargspec' function in 3.5 (documentation only, no DeprecationWarning), it makes sense to also deprecate functions designed to be directly used with it. In 3.6 we will remove 'getargsspec' function (was deprecated since Python 3.0), and start raising DeprecationWarnings in other 'getarg*' family of functions. We can remove them in 3.7 or later. Also, it is worth noting, that Signature API does not provide 100% of functionality that deprecated APIs have. It is important to do a soft deprecation of outdated APIs in 3.5 to gather users feedback, and improve Signature object. diff -r 666e5b554f32 -r 621e98bfc74b Doc/library/inspect.rst --- a/Doc/library/inspect.rst Fri May 22 16:09:44 2015 -0400 +++ b/Doc/library/inspect.rst Fri May 22 16:28:05 2015 -0400 @@ -793,8 +793,10 @@ *n* elements listed in *args*. .. deprecated:: 3.0 - Use :func:`getfullargspec` instead, which provides information about - keyword-only arguments and annotations. + Use :func:`signature` and + :ref:`Signature Object `, which provide a + better introspecting API for callables. This function will be removed + in Python 3.6. .. function:: getfullargspec(func) @@ -834,6 +836,11 @@ are the names of the ``*`` and ``**`` arguments or ``None``. *locals* is the locals dictionary of the given frame. + .. deprecated:: 3.5 + Use :func:`signature` and + :ref:`Signature Object `, which provide a + better introspecting API for callables. + .. function:: formatargspec(args[, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, annotations[, formatarg, formatvarargs, formatvarkw, formatvalue, formatreturns, formatannotations]]) @@ -856,6 +863,11 @@ >>> formatargspec(*getfullargspec(f)) '(a: int, b: float)' + .. deprecated:: 3.5 + Use :func:`signature` and + :ref:`Signature Object `, which provide a + better introspecting API for callables. + .. function:: formatargvalues(args[, varargs, varkw, locals, formatarg, formatvarargs, formatvarkw, formatvalue]) @@ -863,6 +875,11 @@ :func:`getargvalues`. The format\* arguments are the corresponding optional formatting functions that are called to turn names and values into strings. + .. deprecated:: 3.5 + Use :func:`signature` and + :ref:`Signature Object `, which provide a + better introspecting API for callables. + .. function:: getmro(cls) diff -r 666e5b554f32 -r 621e98bfc74b Doc/whatsnew/3.5.rst --- a/Doc/whatsnew/3.5.rst Fri May 22 16:09:44 2015 -0400 +++ b/Doc/whatsnew/3.5.rst Fri May 22 16:28:05 2015 -0400 @@ -815,6 +815,16 @@ :meth:`inspect.Signature.from_callable` instead. (Contributed by Yury Selivanov in :issue:`24248`.) +* :func:`inspect.getargspec` is deprecated and scheduled to be removed in + Python 3.6. (See :issue:`20438` for details.) + +* :func:`~inspect.getfullargspec`, :func:`~inspect.getargvalues`, + :func:`~inspect.getcallargs`, :func:`~inspect.getargvalues`, + :func:`~inspect.formatargspec`, and :func:`~inspect.formatargvalues` are + deprecated in favor of :func:`inspect.signature` API. (See :issue:`20438` + for details.) + + Deprecated functions and types of the C API -------------------------------------------/yselivanov@sprymix.com