[Distutils] [PyPI] Checking reST compliance of long description

Jim Fulton jim at zope.com
Sat Mar 1 16:26:01 CET 2008

On Mar 1, 2008, at 9:58 AM, Andreas Jung wrote:

> Hi,
> I just tried to upload a new package with a pretty long  
> long_description.
> After uploading PyPI showed the text as plain/text...obviously an  
> error
> within the reST structure. Because of the length it took me half an  
> hour for figuring out the error. My local rst2html script did not  
> report any errors.

That's very odd.

> So what is the recommended approach for checking a reST file for  
> PyPI compliance instead doing fixing-and-re-registering the package?

I have my setup file write the long description to a file and then I  
test it with rest2html (actually the rst2 script from zc.rst2) before  
uploading it. It's puzzling to me that rest2html didn't give you an  
error when PyPI didn't like the text.


Jim Fulton
Zope Corporation

More information about the Distutils-SIG mailing list