add deprecation since 3.5 for a few methods of inspect.

[Carreau]

BPO	33594
Nosy	@terryjreedy, @vstinner, @1st1, @Carreau, @miss-islington
PRs	bpo-33594: Add deprecation info in inspect.py module. #7036 [3.6] bpo-33594: Add deprecation info in inspect.py module (GH-7036) #9982 [3.7] bpo-33594: Add deprecation info in inspect.py module (GH-7036) #9983

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2018-10-20.00:08:16.242>
created_at = <Date 2018-05-21.21:34:32.524>
labels = ['3.7', '3.8', 'docs']
title = 'add deprecation since 3.5 for a few methods of inspect.'
updated_at = <Date 2018-10-20.00:08:16.241>
user = 'https://github.com/Carreau'

bugs.python.org fields:

activity = <Date 2018-10-20.00:08:16.241>
actor = 'vstinner'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-10-20.00:08:16.242>
closer = 'vstinner'
components = ['Documentation']
creation = <Date 2018-05-21.21:34:32.524>
creator = 'mbussonn'
dependencies = []
files = []
hgrepos = []
issue_num = 33594
keywords = ['patch']
message_count = 6.0
messages = ['317252', '317695', '328085', '328092', '328095', '328096']
nosy_count = 6.0
nosy_names = ['terry.reedy', 'vstinner', 'docs@python', 'yselivanov', 'mbussonn', 'miss-islington']
pr_nums = ['7036', '9982', '9983']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue33594'
versions = ['Python 3.6', 'Python 3.7', 'Python 3.8']

[Carreau]

inspect's getargspec, as well as Signature's from_function, and from_builtin are deprecated.

They all emits DeprecationWarning but:

The deprecation warning does not say since which version since are deprecated.
For the two Signature's methods, there is no documentation available, so finding this information is difficult.

Many tool rely on introspection to provide object help via docstring, which also did not include this deprecation notice.

Adding the deprecation informations to these 3 function/methods would be good to foster migration to newer ways.

[terryjreedy]

See also bpo-33582 for 'formatargspec'.

[vstinner]

New changeset ded87d8 by Victor Stinner (Matthias Bussonnier) in branch 'master':
bpo-33594: Add deprecation info in inspect.py module (GH-7036)
ded87d8

[miss-islington]

New changeset 932ebc1 by Miss Islington (bot) in branch '3.6':
bpo-33594: Add deprecation info in inspect.py module (GH-7036)
932ebc1

[miss-islington]

New changeset c8348fb by Miss Islington (bot) in branch '3.7':
bpo-33594: Add deprecation info in inspect.py module (GH-7036)
c8348fb

[vstinner]

Thanks Matthias Bussonnier!