Re: PyPI, reStructuredText and readthedocs problems

Path	csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!newsfeed.xs4all.nl!newsfeed4.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path	<giordani.leonardo@gmail.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.000
X-Spam-Evidence	'H': 1.00; 'S': 0.00; 'url:pypi': 0.03; 'interpreter': 0.05; 'output': 0.05; 'url:bitbucket': 0.05; 'duplicate': 0.07; 'importerror:': 0.07; 'pypi': 0.07; '__init__': 0.09; 'exec': 0.09; 'executable': 0.09; 'latter': 0.09; 'prefix': 0.09; 'setup.py': 0.09; 'subject:PyPI': 0.09; 'url:github': 0.09; '{},': 0.09; 'cc:addr:python-list': 0.11; 'python': 0.11; 'bug': 0.12; '<>.': 0.16; "'/usr'": 0.16; '(),': 0.16; '(use': 0.16; '105,': 0.16; '8bit%:1': 0.16; 'code?': 0.16; 'exiting': 0.16; 'feb.': 0.16; 'messy': 0.16; 'readme.rst': 0.16; 'setuptools,': 0.16; 'skip:/ 70': 0.16; 'subject:problems': 0.16; 'turn,': 0.16; 'twisted': 0.16; 'url:application': 0.16; 'url:issues': 0.16; 'url:py': 0.16; 'url:sphinx': 0.16; 'exception': 0.16; 'url:)': 0.16; 'thanks,': 0.17; 'wrote:': 0.18; 'all,': 0.19; 'module': 0.19; 'finished': 0.19; 'seems': 0.21; 'command': 0.22; 'import': 0.22; 'email addr:gmail.com>': 0.22; 'cc:addr:python.org': 0.22; 'install': 0.23; 'error': 0.23; '31,': 0.24; 'headers': 0.24; 'sorry,': 0.24; 'header': 0.24; 'mon,': 0.24; 'file.': 0.24; 'cc:20': 0.24; 'cc:no real name:20': 0.24; 'tracker': 0.26; 'code:': 0.26; 'skip:" 20': 0.27; 'header :In-Reply-To:1': 0.27; 'converting': 0.30; 'skip:@ 10': 0.30; 'specified': 0.30; 'message-id:@mail.gmail.com': 0.30; "i'm": 0.30; 'url:mailman': 0.30; 'code': 0.31; '8bit%:2': 0.31; 'developers.': 0.31; 'filed': 0.31; 'implicit': 0.31; 'file': 0.32; 'thanks!': 0.32; 'open': 0.33; 'url:python': 0.33; 'running': 0.33; '(most': 0.33; '-----': 0.33; 'ago': 0.33; 'are:': 0.33; 'skip:& 30': 0.33; 'skip:d 20': 0.34; 'message.': 0.35; 'problem': 0.35; 'convert': 0.35; 'requirement': 0.35; 'but': 0.35; 'received:google.com': 0.35; 'there': 0.35; 'installing': 0.36; 'version:': 0.36; 'url:listinfo': 0.36; 'next': 0.36; 'url:org': 0.36; 'wrong': 0.37; 'requirements': 0.37; 'skip:- 20': 0.37; 'two': 0.37; 'project': 0.37; 'skip:& 10': 0.38; 'thank': 0.38; 'configured': 0.38; 'gmail': 0.38; 'issue': 0.38; 'pm,': 0.38; 'recent': 0.39; 'skip:& 20': 0.39; '(from': 0.39; 'hosted': 0.39; 'changed': 0.39; 'url:mail': 0.40; 'how': 0.40; 'skip:\xc2 10': 0.60; 'url:about': 0.61; 'full': 0.61; 'new': 0.61; 'profile': 0.61; 'name:': 0.61; 'you.': 0.62; 'complete': 0.62; 'information': 0.63; 'name': 0.63; 'real': 0.63; '8bit%:10': 0.64; 'to:addr:gmail.com': 0.65; 'due': 0.66; 'latest': 0.67; 'mar': 0.68; 'messaging': 0.68; 'skip:w 30': 0.69; 'url:me': 0.69; 'satisfied': 0.81; '2015': 0.84; 'a.m.': 0.84; 'gone.': 0.84; 'is!': 0.84; 'leo': 0.84; 'mock': 0.84; 'outcome:': 0.84; 'url:config': 0.84; '2015.': 0.91; 'url:latest': 0.91; 'tags,': 0.95
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=VJ+Iq6r//jZzwcZ+YRJpuL2xwsEnKsWwwMlSaepmGKc=; b=OoMQ40PyM3zVEebIvVHLITG5Qo5Ucjqs3fd+9NVMqTwgJ5OM4qiLby5i4g6sO2ZLC0 q7iwcCTIkK86ioTGdn9T6Bw9JqI8iiJTIYvYaQkZTL2bmeDwpMg0z2rjbfpRSBo4PQe+ wzzuhzHKGsMef2TglpoFa64TFDFr2fsCDMTYssotv1EL9EqZpEXIed8mWohHTJGHDclT Qjpo61NFIUbksSo/K/TXWZxhDcrE939jDt2DGU1Ag+r32eu3HALRJutYeNg6I+qHU9jR xyZLB+t62HTuYIIsLpF5ggJSj2aPN/a5zgpGgWJVVCpcyb8wdTMtDOzUXlgL/M5e6GgA rWSQ==
MIME-Version	1.0
X-Received	by 10.60.38.66 with SMTP id e2mr18837375oek.38.1425296638523; Mon, 02 Mar 2015 03:43:58 -0800 (PST)
In-Reply-To	<CAEfz+TxTabR0nDNP_LSsSkxhweM2VOtN=axfS+hh_foi9tcNiQ@mail.gmail.com>
References	<CAEhE+OnKMx52Md6cg34anprAgHOkHu71ZB+o58NR_UkzweBh3w@mail.gmail.com> <CAEfz+TxTabR0nDNP_LSsSkxhweM2VOtN=axfS+hh_foi9tcNiQ@mail.gmail.com>
Date	Mon, 2 Mar 2015 12:43:58 +0100
Subject	Re: PyPI, reStructuredText and readthedocs problems
From	Leonardo Giordani <giordani.leonardo@gmail.com>
To	INADA Naoki <songofacandy@gmail.com>
Cc	python-list@python.org
Content-Type	multipart/alternative; boundary=089e0122772ed6befb05104cbbba
X-Mailman-Approved-At	Mon, 02 Mar 2015 12:44:21 +0100
X-BeenThere	python-list@python.org
X-Mailman-Version	2.1.19
Precedence	list
List-Id	General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe	<https://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list/>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<https://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.30.1425296662.13471.python-list@python.org> (permalink)
Lines	498
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1425296662 news.xs4all.nl 2843 [2001:888:2000:d::a6]:57801
X-Complaints-To	abuse@xs4all.nl
Xref	csiph.com comp.lang.python:86720

Show key headers only | View raw

[Multipart message — attachments visible in raw view] - view raw

Sorry, seems that GMail cannot understand I'm on a ML, and just answered
the single persons.

[Thread with INADA]
Thank you.

Seems that rst2html.py uses the header of a section as the id of the
corresponding HTML anchor.
Since I had two headers with the same title there was a name clash.
I just changed one of the headers and the problem is gone.

[Thread with Wolfgang]
On 03/02/2015 12:11 PM, Leonardo Giordani wrote:

> Thanks, spotted!
>
> Now readthedocs fails with this message
>
> Traceback (most recent call last):
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/cmdline.py
> <
> http://readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/cmdline.py>",
> line 253, in main
>      warningiserror, tags, verbosity, parallel)
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/application.py
> <
> http://readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/application.py>",
> line 107, in __init__
>      confoverrides or {}, self.tags)
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/config.py
> <
> http://readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/config.py>",
> line 229, in __init__
>      execfile_(filename, config)
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/util/pycompat.py
> <
> http://readthedocs.org/user_builds/postage/envs/feature-docs/local/lib/python2.7/site-packages/sphinx/util/pycompat.py>",
> line 105, in execfile_
>      exec code in _globals
>    File "conf.py", line 31, in <module>
>      import postage
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/checkouts/feature-docs/postage/__init__.py
> <
> http://readthedocs.org/user_builds/postage/checkouts/feature-docs/postage/__init__.py>",
> line 10, in <module>
>      from postage import messaging
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/checkouts/feature-docs/postage/messaging.py
> <
> http://readthedocs.org/user_builds/postage/checkouts/feature-docs/postage/messaging.py>",
> line 4, in <module>
>      import pika
> ImportError: No module named pika
>
> Exception occurred:
>    File "/home/docs/checkouts/
> readthedocs.org/user_builds/postage/checkouts/feature-docs/postage/messaging.py
> <
> http://readthedocs.org/user_builds/postage/checkouts/feature-docs/postage/messaging.py>",
> line 4, in <module>
>      import pika
> ImportError: No module named pika
> The full traceback has been saved in /tmp/sphinx-err-R4ZC2D.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at <
> https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
>
> I however configured the build to use a virtualenv and specified 'pika' in
> my requirements.txt file.
>
>
Look at the complete output from readthedocs:

Setup Output

checkout
-----

venv
-----

Using real prefix '/usr'
New python executable in /home/docs/checkouts/
readthedocs.org/user_builds/postage/envs/latest/bin/python
Installing setuptools, pip...done.
Running virtualenv with interpreter /home/docs/bin/python

doc_builder
-----

Requirement already up-to-date: sphinx==1.2.2 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: virtualenv==1.10.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: setuptools==1.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: docutils==0.11 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: mkdocs==0.11.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: mock==1.0.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: pillow==2.6.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: readthedocs-sphinx-ext==0.4.4 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
Requirement already up-to-date: Jinja2>=2.7.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from mkdocs==0.11.1)
Requirement already up-to-date: Markdown>=2.3.1,<2.5 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from mkdocs==0.11.1)
Requirement already up-to-date: PyYAML>=3.10 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from mkdocs==0.11.1)
Requirement already up-to-date: watchdog>=0.7.0 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from mkdocs==0.11.1)
Requirement already up-to-date: ghp-import>=0.4.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from mkdocs==0.11.1)
Requirement already up-to-date: argh>=0.24.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from watchdog>=0.7.0->mkdocs==0.11.1)
Requirement already up-to-date: pathtools>=0.1.1 in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from watchdog>=0.7.0->mkdocs==0.11.1)
Cleaning up...

requirements
-----

Requirement already satisfied (use --upgrade to upgrade): mock in
/var/build/user_builds/postage/envs/latest/lib/python2.7/site-packages
(from -r requirements.txt (line 1))
Downloading/unpacking pika (from -r requirements.txt (line 2))
  Running setup.py
(path:/var/build/user_builds/postage/envs/latest/build/pika/setup.py)
egg_info for package pika

Downloading/unpacking tornado (from pika->-r requirements.txt (line 2))
  Running setup.py
(path:/var/build/user_builds/postage/envs/latest/build/tornado/setup.py)
egg_info for package tornado

Downloading/unpacking twisted (from pika->-r requirements.txt (line 2))
  Running setup.py
(path:/var/build/user_builds/postage/envs/latest/build/twisted/setup.py)
egg_info for package twisted

Downloading/unpacking pyev (from pika->-r requirements.txt (line 2))
  Running setup.py
(path:/var/build/user_builds/postage/envs/latest/build/pyev/setup.py)
egg_info for package pyev
    Aborted: pyev-0.9.0 requires libev >= 4.15
    Complete output from command python setup.py egg_info:
    Aborted: pyev-0.9.0 requires libev >= 4.15

There it is! readthedocs already failed to install pika because it, in
turn, requires libev >= 4.15 .

Leonardo Giordani
@tw_lgiordani <http://twitter.com/tw_lgiordani> - lgiordani.com
My profile on About.me <http://about.me/leonardo.giordani> - My GitHub page
<https://github.com/lgiordani>

2015-03-02 11:33 GMT+01:00 INADA Naoki <songofacandy@gmail.com>:

> PyPI parses your README strictly.
>
> $ rst2html.py --strict README.rst
> README.rst:700: (INFO/1) Duplicate implicit target name: "fingerprint".
> Exiting due to level-1 (INFO) system message.
>
> But I don't know how to avoid this error when converting from markdown.
>
> On Mon, Mar 2, 2015 at 6:35 PM Leonardo Giordani <
> giordani.leonardo@gmail.com> wrote:
>
>> Hi all,
>>
>> Some time ago I open sourced a package named postage (
>> https://pypi.python.org/pypi/postage/).
>>
>> I am experiencing issues with documentation. The project is hosted on
>> GitHub (https://github.com/lgiordani/postage), where the README.md is
>> perfectly rendered. My issues are:
>>
>> 1. I use pandoc to convert README.md to README.rst. This latter is
>> rendered by GitHUb as well, but when I upload the package to PyPI I get a
>> messy result (look at the package page).
>>
>> 2. When I import the project into readthedocs.org the build fails with
>> no output. This is the only information I get
>>
>> ----------------------------- 8< -----------------------------
>>
>> Build for postage
>>
>> Built: Feb. 27, 2015. 10:41 a.m.
>>
>> State: Finished
>>
>> Outcome: Failed (Status Code: 0)
>>
>> Version: latest
>>
>> Type: html
>>
>> Build Standard Output
>>
>> ----------------------------- 8< -----------------------------
>>
>> May someone help me figuring out what's wrong in my code?
>> Thanks!
>>
>> Leo
>>
>>
>> Leonardo Giordani
>> @tw_lgiordani <http://twitter.com/tw_lgiordani> - lgiordani.com
>> My profile on About.me <http://about.me/leonardo.giordani> - My GitHub
>> page <https://github.com/lgiordani>
>>  --
>> https://mail.python.org/mailman/listinfo/python-list
>>
>

Back to comp.lang.python | Previous | Next | Find similar | Unroll thread

Thread

Re: PyPI, reStructuredText and readthedocs problems Leonardo Giordani <giordani.leonardo@gmail.com> - 2015-03-02 12:43 +0100

csiph-web