[Distutils] "Python Packaging User Guide" has moved
donald at stufft.io
Thu Jan 16 15:22:59 CET 2014
On Jan 16, 2014, at 9:20 AM, Daniel Holth <dholth at gmail.com> wrote:
> Has anyone ever written a setup.py that was *not* copy-and-pasted from
> somewhere else?
> On Thu, Jan 16, 2014 at 5:17 AM, Paul Moore <p.f.moore at gmail.com> wrote:
>> On 16 January 2014 09:40, Nick Coghlan <ncoghlan at gmail.com> wrote:
>>> Audrey Roy's "cookiecutter" project is just such a tool (although her
>>> default config is far from minimal - setup.py, GitHub, ReadTheDocs, tox,
>>> Travis, documentation skeleton, etc. It's all reasonable recommendations,
>> Agreed, I was pointed to that at one point. For me, it suffers from
>> the problem of being yet another tool, as well as the default template
>> available being very complex, as you said. But yes, it looks useful
>> for more complex projects.
>> I do think the PUG needs a "this is how you start" basic template
>> though, that includes good practices like the right classifiers, using
>> entry points for scripts, basic unit tests, a readme etc. The current
>> guide doesn't even have a "Basic Project Template" section in the
>> index :-( I'll try to find some time to add one.
>> On that note, the PUG index currently feels a little overwhelming from
>> the point of view of someone who just wants to get a job done. it's
>> got a lot of "Getting started with X" and "What is" sections, but
>> nothing like "Installing a package from PyPI" or "Starting a new
>> project". Maybe the index should be reorganised to be more
>> task-oriented, and less concerned with providing history and
>> background to the confusion that led us to where we are now? I'd be
>> tempted to actually remove a lot of what's currently in the contents,
>> and relegate it to some sort of "background" section (which would
>> probably need to be organised into subsections of its own, but that
>> level of detail doesn't need to be on the front page).
I write my setup.py’s from scratch :D
PGP: 0x6E3CBCE93372DCFA // 7C6B 7C5D 5E2B 6356 A926 F04F 6E3C BCE9 3372 DCFA
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 801 bytes
Desc: Message signed with OpenPGP using GPGMail
More information about the Distutils-SIG