Repository navigation
[doc] replace 'distutils' examples with 'setuptools' #90163
Description
| BPO | 46005 |
|---|---|
| Nosy | @taleinat, @merwok, @sobolevn, @elmjag |
| PRs |
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 = None
created_at = <Date 2021-12-07.08:08:57.511>
labels = ['3.11', 'type-feature', '3.10', 'docs']
title = "[doc] replace 'distutils' examples with 'setuptools'"
updated_at = <Date 2022-02-02.07:53:49.787>
user = 'https://github.com/elmjag'bugs.python.org fields:
activity = <Date 2022-02-02.07:53:49.787>
actor = 'elmjag'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2021-12-07.08:08:57.511>
creator = 'elmjag'
dependencies = []
files = []
hgrepos = []
issue_num = 46005
keywords = ['patch']
message_count = 6.0
messages = ['407896', '408333', '408428', '409512', '410844', '412341']
nosy_count = 5.0
nosy_names = ['taleinat', 'eric.araujo', 'docs@python', 'sobolevn', 'elmjag']
pr_nums = ['30062']
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue46005'
versions = ['Python 3.10', 'Python 3.11']
Activity
elmjag commentedon Feb 2, 2022
I agree that documenting third-party tools in CPython docs is a bit weird. I guess this is more an issue with setuptools docs. IMHO here is no clear explanation on how to build extension modules there.
As a temporary work around, I wrote an example of building extension module with setuptools here:
https://elmjag.github.io/setuptools.html
jacalata commentedon Jun 25, 2022
This is the setuptools doc page: https://setuptools.pypa.io/en/latest/userguide/ext_modules.html, which is probably what needs to be updated
aisk commentedon Sep 18, 2023
Currently, distutil has been removed. Should we remove this section and only refer to other third-party tools, especially setuptools?
hugovk commentedon Sep 18, 2023
This is how the pages looks now for 3.12 (will become
/3/when 3.12 is released): https://docs.python.org/3.12/extending/building.htmlCompare with 3.11 (the current
/3/docs version): https://docs.python.org/3.11/extending/building.htmlFor 3.12 the distutils section has been removed, and replaced with a a reference to the setuptools page (in PR #95239).
Is there anything else that needs doing for this issue or can we close it?
merwok commentedon Sep 18, 2023
OK to close for me. @taleinat ?
AA-Turner commentedon Sep 19, 2023
#108030 addresses one final part (extending/windows).
A
StanFromIreland commentedon Aug 10, 2025
This is now under a new issue, I think this is complete then?