diff --git a/Lib/inspect.py b/Lib/inspect.py index 857892bc814..3edf97d389e 100644 --- a/Lib/inspect.py +++ b/Lib/inspect.py @@ -1070,8 +1070,10 @@ def getargspec(func): Alternatively, use getfullargspec() for an API with a similar namedtuple based interface, but full support for annotations and keyword-only parameters. + + Deprecated since Python 3.5, use `inspect.getfullargspec()`. """ - warnings.warn("inspect.getargspec() is deprecated, " + warnings.warn("inspect.getargspec() is deprecated since Python 3.0, " "use inspect.signature() or inspect.getfullargspec()", DeprecationWarning, stacklevel=2) args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, ann = \ @@ -2797,19 +2799,25 @@ class Signature: @classmethod def from_function(cls, func): - """Constructs Signature for the given python function.""" + """Constructs Signature for the given python function. - warnings.warn("inspect.Signature.from_function() is deprecated, " - "use Signature.from_callable()", + Deprecated since Python 3.5, use `Signature.from_callable()`. + """ + + warnings.warn("inspect.Signature.from_function() is deprecated since " + "Python 3.5, use Signature.from_callable()", DeprecationWarning, stacklevel=2) return _signature_from_function(cls, func) @classmethod def from_builtin(cls, func): - """Constructs Signature for the given builtin function.""" + """Constructs Signature for the given builtin function. - warnings.warn("inspect.Signature.from_builtin() is deprecated, " - "use Signature.from_callable()", + Deprecated since Python 3.5, use `Signature.from_callable()`. + """ + + warnings.warn("inspect.Signature.from_builtin() is deprecated since " + "Python 3.5, use Signature.from_callable()", DeprecationWarning, stacklevel=2) return _signature_from_builtin(cls, func) diff --git a/Misc/NEWS.d/next/Documentation/2018-05-21-14-36-12.bpo-33594.-HRcyX.rst b/Misc/NEWS.d/next/Documentation/2018-05-21-14-36-12.bpo-33594.-HRcyX.rst new file mode 100644 index 00000000000..a63c4a5004c --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2018-05-21-14-36-12.bpo-33594.-HRcyX.rst @@ -0,0 +1,3 @@ +Document ``getargspec``, ``from_function`` and ``from_builtin`` as +deprecated in their respective docstring, and include version since +deprecation in DeprecationWarning message.