[Distutils] Provide separate development and documentation URLs in PyPI metadata?

Brett Cannon brett at python.org
Sat Jun 24 15:59:42 EDT 2017


On Sat, Jun 24, 2017, 10:49 Thomas Kluyver, <thomas at kluyver.me.uk> wrote:

> On Sat, Jun 24, 2017, at 06:34 PM, Brett Cannon wrote:
>
> Anyway, just an idea I had based on my flit experience yesterday plus a
> tweet sent to me. (And if PyPI already supports this somehow then Thomas
> should brace for the feature request from me 😉.)
>
>
> This prompted me to go and look at the metadata PEPs. I thought the URL
> fields were only 'Home-Page' and 'Download-URL', but in fact PEP 345 added
> a multi-use 'Project-URL' field:
>
> https://www.python.org/dev/peps/pep-0345/#project-url-multiple-use
>
> I quite like this idea - rather than prescribing a couple of specific
> kinds of URL, it lets the project author list as many as make sense.
> Perhaps we should recommend a set of common labels for URLs in this field,
> e.g. 'Documentation', 'Bug tracker', 'Source repository'.
>

In flit's case it could have some reasonable set of defaults supported in
the metadata section and then have a more general "URLs" section that's
more free-form.

-brett


> This does leave open the question of which one to put in the mandatory
> 'Home-Page' field (I usually use the address of the repo), and whether to
> duplicate it in a 'Project-URL'.
>
> Thomas
> _______________________________________________
> 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/20170624/384f8194/attachment.html>


More information about the Distutils-SIG mailing list