<div dir="ltr">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.<div>

<br></div><div><a href="https://docs.python.org/2/distutils/examples.html#pure-python-distribution-by-module">https://docs.python.org/2/distutils/examples.html#pure-python-distribution-by-module</a><br></div></div><div class="gmail_extra">

<br><br><div class="gmail_quote">On Tue, Apr 1, 2014 at 2:46 PM, Paul Sokolovsky <span dir="ltr"><<a href="mailto:pmiscml@gmail.com" target="_blank">pmiscml@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

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