[Distutils] Creating distribution for Python *module*, not package

Michael Merickel mmericke at gmail.com
Tue Apr 1 22:16:51 CEST 2014


Yeah, setuptools is a bw-compat wrapper around distutils, so it tends to
only document its new features. This approach to documentation makes it
very difficult to understand for newcomers that are not familiar with
distutils. Especially now that setuptools is the de facto standard that
everyone is learning how to use.

https://docs.python.org/2/distutils/examples.html#pure-python-distribution-by-module


On Tue, Apr 1, 2014 at 2:46 PM, Paul Sokolovsky <pmiscml at gmail.com> wrote:

> Hello,
>
> On Tue, 1 Apr 2014 22:25:09 +0300
> Paul Sokolovsky <pmiscml at gmail.com> wrote:
>
> > Hello,
> >
> > I would like to create a PyPIable packaged disribution for a
> > single-file python module (say, foo.py). How to achieve that? There
> > doesn't seem to be "modules" param to setup() (as a mirror of
> > "packages" param).
>
> Ah, pure magic: google it, search stackoverflow - find nothing. Post a
> question to mailing list, and next step find the answer - the param is
> called "py_modules".
>
> Let's analyze: I would expect a complete reference of setup() params on
> https://pythonhosted.org/setuptools/ , and/or explicit and very visible
> mentioning that setuptools is extension to distutils and its docs
> should be read first.
>
> Instead I get:
>
> Confusing TOC, first entry is called "Roadmap", which doesn't
> provide any roadmap, but instead status. Next one "Supporting both
> Python 2 and Python 3 with Setuptools" - oh, sure that's first thing I
> want to know about setuptools. Or maybe no, first thing I want to know
> what the heck it is. So, the section with which manual should start,
> "Building and Distributing Packages with Setuptools" is #4 in TOC, no
> wonder it takes a while for people to get to it. Searching for
> "py_modules" returns 0 hits.
>
> And kind suggestion for packaging tutorials writers - please start from
> the start, by describing how to package a *module*, there's no need to
> force package bloat on everyone. And the latter is exactly what 3
> google-top tutorials I read did.
>
>
> Keep up the great work!
>
> --
> Best regards,
>  Paul                          mailto:pmiscml at gmail.com
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> https://mail.python.org/mailman/listinfo/distutils-sig
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20140401/1e426bde/attachment.html>


More information about the Distutils-SIG mailing list