[Distutils] PEP 345 - 3 new fields
ziade.tarek at gmail.com
Tue Dec 1 16:11:32 CET 2009
On Tue, Dec 1, 2009 at 4:19 AM, Ian Bicking <ianb at colorstudy.com> wrote:
> If something more like that was added (more like Trunk-URL), that would be
> genuinely useful. Barring that, I'd recommend removing the Repository-URL
> field from the recommendation until we have a clearer use case. Right now,
> the better use case would be a field giving the checkout command, e.g.,:
> Repository-Checkout: hg clone http://bitbucket.org/ianb/webob
> But I don't think that is particularly useful, only that it is more useful
> than Repository-URL.
Here's a proposal then, that seems to synthetize what people have been saying:
Let's drop "Repository-Browse-URL" and keep a single "Repository-URL"
field, which is a free
URL that can take any URL form. e.g. a browsable url, or a git/hg url etc.
Now for "Change-Log" vs "Change-Log-URL", I think the first one is
that's what people are already doing in their packages (when they add
their changelog at the
end of their long_description option), and it's not hard for PyPI to
store it and display it, besides
The value I see in that field is that:
- it helps developers structurize a bit their project description.
e.g. letting them separate
the Description of the package from the changelog if any.
- it will let PyPI separate the front page of the project from its
changelog, e.g. in this page:
http://pypi.python.org/pypi/zc.buildout, instead of having the
changelog here, it could be a link
to another page for the project.
How does that sounds ?
More information about the Distutils-SIG