[issue46005] [doc] replace 'distutils' examples with 'setuptools'

[Elmir]

Elmir  added the comment:

I think it would be very helpful to include an example how to build with 
setuptools as well. As it in the end boils down to two simple steps:

* install 'setuptools' package
* change import line:

"from distutils.core import setup, Extension" 

to

"from setuptools import setup, Extension"

It took me a lot of time to figure out that 'setuptools' have this 'drop-in 
replacement' API for distutils. IMHO, it's not very well documented anywhere.

I can make a PR with such addition, if you thinks it's good idea.

--

___
Python tracker 
<https://bugs.python.org/issue46005>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46005] [doc] replace 'distutils' examples with 'setuptools'

[Elmir]

Elmir  added the comment:

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

--

___
Python tracker 
<https://bugs.python.org/issue46005>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46005] [doc] replace 'distutils' examples with 'setuptools'

[Elmir]

New submission from Elmir :

As the distutils have been deprecated, the documentation on building C/C++ 
extension modules should be updated to use more future proof tool.

I guess the section:

'Building C and C++ Extensions with distutils'

should be replaced with:

'Building C and C++ Extensions with setuptools'

Here is link to the section that needs to be updated/replaced:

https://docs.python.org/3/extending/building.html#building-c-and-c-extensions-with-distutils

--
assignee: docs@python
components: Documentation
messages: 407896
nosy: docs@python, elmjag
priority: normal
severity: normal
status: open
title: [doc] replace 'distutils' examples with 'setuptools'
type: enhancement
versions: Python 3.10, Python 3.11

___
Python tracker 
<https://bugs.python.org/issue46005>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com