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

[Tarek Ziadé]

On Sat, Mar 1, 2008 at 4:26 PM, Jim Fulton <jim at zope.com> wrote:

>
> 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.
>

Yes I wish Pypi would return some kind of warning when the reST compiling
fails
(see my previous message on this)...

A simple check on client side I do with docutils is :

python setup.py --long-description | rst2html.py > /dev/null




> Jim
>
> --
> Jim Fulton
> Zope Corporation
>
>
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> http://mail.python.org/mailman/listinfo/distutils-sig
>



-- 
Tarek Ziadé | Association AfPy | www.afpy.org
Blog FR | http://programmation-python.org
Blog EN | http://tarekziade.wordpress.com/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.python.org/pipermail/distutils-sig/attachments/20080301/9fc5fd92/attachment.htm