<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Dec 28, 2014 at 9:02 AM, Marius Gedminas <span dir="ltr"><<a href="mailto:marius@gedmin.as" target="_blank">marius@gedmin.as</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span class="">On Sat, Dec 27, 2014 at 08:26:50PM -0800, John Anderson wrote:<br>
> Hey, I'm trying to get my README to render properly on pypi but I haven't<br>
> found a way to detect the errors pypi is experiencing.<br>
><br>
> The package I'm trying to upload is here:<br>
> <a href="https://pypi.python.org/pypi/pyramid_celery" target="_blank">https://pypi.python.org/pypi/pyramid_celery</a><br>
<br>
</span>Are you talking about<br>
<a href="https://pypi.python.org/pypi/pyramid_celery/2.0.0-rc2" target="_blank">https://pypi.python.org/pypi/pyramid_celery/2.0.0-rc2</a> or<br>
<a href="https://pypi.python.org/pypi/pyramid_celery/1.4" target="_blank">https://pypi.python.org/pypi/pyramid_celery/1.4</a>?<br>
<br>
The first looks fine now (have you found the error and fixed it<br>
already?) while the second looks like it uses some kind of Markdown<br>
instead of ReStructuredText:<br>
<br>
``` python<br>
    pyramid.includes = pyramid_celery<br>
```<br>
<span class=""><br>
> I've checked the README.rst with restview, rst2html, and<br>
> collective.showdocs and they all render the RST just fine.<br>
<br>
</span>Just to be sure, did you try restview's --pypi-strict mode?<br>
<span class=""><br>
> It seems like I'm not the only one having this issue:<br>
> <a href="https://bitbucket.org/pypa/pypi/issue/161/rest-formatting-fails-and-there-is-no-way" target="_blank">https://bitbucket.org/pypa/pypi/issue/161/rest-formatting-fails-and-there-is-no-way</a><br>
><br>
> So what is the recommended route for debugging the problem?  I would really<br>
> like to fix it but without know the problem I would just to make random<br>
> guesses.<br>
<br>
</span>restview --long-description is what I use (in the source tree with a<br>
setup.py: this runs setup.py --long-description and parses the output in<br>
--pypi-strict mode).<br>
<br>
If that fails to find the error, I try to copy & paste the<br>
long_description text from PyPI into a text file and use restview<br>
--pypi-strict directly.<br>
<br>
If that fails, I end up bisecting the long_description text in the web<br>
form, to see where it starts failing.<br>
<br>
If it's not my package and I can't edit the long_description on the web,<br>
I tend to give up.<br></blockquote><div><br></div><div>I found the error was a .. code-block::  with no language, I fixed the README with this commit:</div><div><br></div><div><a href="https://github.com/sontek/pyramid_celery/commit/fb69dd44143a5b030b48346e6322845194a690fe">https://github.com/sontek/pyramid_celery/commit/fb69dd44143a5b030b48346e6322845194a690fe</a></div><div><br></div><div> </div></div>restview with --pypi-strict doesn't detect this (but maybe it should?).   I even tried ripping the source code from pypi directly to catch the error:</div><div class="gmail_extra"><br></div><div class="gmail_extra"><a href="https://gist.github.com/sontek/e58c1cf82931e1478cd2">https://gist.github.com/sontek/e58c1cf82931e1478cd2</a><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">Using it:</div><div class="gmail_extra"><br></div><div class="gmail_extra">python setup.py --long-description | python check_readme.py</div><div class="gmail_extra"><br></div><div class="gmail_extra">but even that didn't cause the error, I assume because I have a more modern version of pygments.</div></div>