[Distutils] Re: proposing Python package index upload API spec (potential PEP)

2018-05-09 Thread Nick Coghlan
On 9 May 2018 at 04:09, Sumana Harihareswara wrote: > As a new Twine maintainer I've been running into questions like: > > * Now that Warehouse doesn't use "register" anymore, can we deprecate it > from distutils, setuptools, and twine? Are any other package indexes or > upload tools using it? ht

[Distutils] Re: proposing Python package index upload API spec (potential PEP)

2018-05-09 Thread Wes Turner
I move to define PyPA and Warehouse HTTP APIs with OpenAPI definitions. https://swagger.io/specification/ https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.0.md > OPENAPI SPECIFICATION > > The OpenAPI specification (formerly known as the Swagger Specification) is a power

[Distutils] Re: org-mode README file formats

2018-05-09 Thread Diane Trout
On Tue, 2018-05-08 at 19:32 -0300, Leonardo Rochael Almeida wrote: > Maybe you can use pandoc as a `setup_depends` and convert it to an > acceptable format at build time? > I had been wondering how the readme's get used by setuptools. Does the warehouse actually read the readme file directly? o

[Distutils] Re: org-mode README file formats

2018-05-09 Thread Thomas Kluyver
On Wed, May 9, 2018, at 7:22 PM, Diane Trout wrote: > Does the warehouse actually read the readme file directly? or does it > preferentially look at long_description metadata? I think it only looks at the long_description metadata; as far as I know README is just another file in the archive. If you

[Distutils] Re: org-mode README file formats

2018-05-09 Thread Wes Turner
Pypa/readme is what Warehouse uses to render rst and markdown long_descriptions to safe HTML. https://github.com/pypa/readme_renderer There are a number of org-mode implementations; even for a few for Vim and Sublime. https://en.m.wikipedia.org/wiki/Org-mode#Integration ``conda install pandoc`` i