Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.maint.python > #8828

RE:how to build sphinx doc when there is extension

Path csiph.com!aioe.org!bofh.it!news.nic.it!robomod
From PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr>
Newsgroups linux.debian.maint.python
Subject RE:how to build sphinx doc when there is extension
Date Tue, 30 Aug 2016 10:40:01 +0200
Message-ID <sbMKl-2qE-9@gated-at.bofh.it> (permalink)
References <sbMKl-2qE-11@gated-at.bofh.it> <sbMqZ-2gM-1@gated-at.bofh.it>
X-Original-To Piotr Ożarowski <piotr@debian.org>, "debian-python@lists.debian.org" <debian-python@lists.debian.org>
X-Mailbox-Line From debian-python-request@lists.debian.org Tue Aug 30 08:39:13 2016
Old-Return-Path <frederic-emmanuel.picca@synchrotron-soleil.fr>
X-Amavis-Spam-Status No, score=-0.648 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RP_MATCHES_RCVD=-0.548, THREADTOPIC=2] autolearn=no autolearn_force=no
X-Policyd-Weight using cached result; rate: -6.1
Dkim-Filter OpenDKIM Filter v2.10.3 poussette.synchrotron-soleil.fr 4C0AB600BB
Dkim-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=synchrotron-soleil.fr; s=email; t=1472545432; bh=Yfkmmf307RUklMB4/qoac55cxKpBmLXavQuSKsg9on0=; h=From:To:Subject:Date:References:In-Reply-To:From; b=qh+KHdOAsR+x1dO1QpRINuKfEtMNOu7J90euGI4BtWW3wLvA9gwj99zjSMH5BEtEX 02SO1E3s1fB5U7dmDaE1bcC66CJGsI54V+sbCnhfJTBp0mzT+snCxS6SVumQap6UUI /CNgdcwSr8EGPD2bu4PzBBy7kDBVIkH5eYJy737A=
Dkim-Filter OpenDKIM Filter v2.10.3 poussette.synchrotron-soleil.fr 9173B6007D
Dkim-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=synchrotron-soleil.fr; s=email; t=1472545431; bh=Yfkmmf307RUklMB4/qoac55cxKpBmLXavQuSKsg9on0=; h=From:To:Subject:Date:References:In-Reply-To:From; b=SeHP6C3+k9GgcpmhrBb9pWg852RYaWdiY6jlIS1YYPmjgLiuIuXEpQ93kDVTQcoOT 7vTERxI6Vja52usQm+gjBvkTKMQUl5WXs35cwrseaLHxSowpHd9Kvn4NjYIgs10Tlh yCanpW8MyJj0vvfM3rCVoq/D/X9IpN0anIhpxVQI=
Thread-Topic how to build sphinx doc when there is extension
Thread-Index AdICjjSie4mBbJQMSH6CcC2KCwA2rP//7y2AgAAiecw=
Accept-Language fr-FR, en-US
Content-Language fr-FR
X-Originating-IP [195.221.0.171]
Content-Type text/plain; charset="iso-8859-2"
Content-Transfer-Encoding quoted-printable
MIME-Version 1.0
X-Mailing-List <debian-python@lists.debian.org> archive/latest/14169
List-ID <debian-python.lists.debian.org>
List-URL <https://lists.debian.org/debian-python/>
List-Archive https://lists.debian.org/msgid-search/A2A20EC3B8560D408356CAC2FC148E53BB2C855D@SUN-DAG3.synchrotron-soleil.fr
Approved robomod@news.nic.it
Lines 36
Organization linux.* mail to news gateway
Sender robomod@news.nic.it
X-Original-Date Tue, 30 Aug 2016 08:23:50 +0000
X-Original-Message-ID <A2A20EC3B8560D408356CAC2FC148E53BB2C855D@SUN-DAG3.synchrotron-soleil.fr>
X-Original-References <A2A20EC3B8560D408356CAC2FC148E53BB2C8491@SUN-DAG3.synchrotron-soleil.fr>,<20160830081441.7qi5at5jps52qga7@sar0.p1otr.com> <20160830081441.7qi5at5jps52qga7@sar0.p1otr.com>
Xref csiph.com linux.debian.maint.python:8828

Show key headers only | View raw


> how about doing it outside pybuild? Do you really need to build it for
> each interpreter / version?


It is a sort of unit test during the build that auto-doc works for all versions of the interpreter.
th eunit test is

try to import all the modules provided by a packages.

Is there something whcih can be automatise at the autodep8 level for python ?


> If you need the build dir:

> override_dh_sphinxdoc:
> ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS)))
>         PYTHONPATH=$(pybuild --system=custom -i python3 --build --build-args="echo {build_dir}") \
>        cd doc && http_proxy='127.0.0.1:9' sphinx-build -N -bhtml source build/html

the problem with sphinx-build is that it use python2

#!/usr/bin/python

this is why I extract the content of sphinx-build directly nthe rules file.

but this is ugly since I have no garantie that this snipset willnot chang ein the near futur.


cheers

Frederic

Back to linux.debian.maint.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


Thread

how to build sphinx doc when there is extension PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2016-08-30 09:40 +0200
  Re: how to build sphinx doc when there is extension Piotr Ożarowski <piotr@debian.org> - 2016-08-30 10:20 +0200
    RE:how to build sphinx doc when there is extension PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2016-08-30 10:40 +0200
      Re: how to build sphinx doc when there is extension Ben Finney <ben+debian@benfinney.id.au> - 2016-08-30 23:10 +0200
  Re: how to build sphinx doc when there is extension Dmitry Shachnev <mitya57@debian.org> - 2016-08-31 20:10 +0200
    RE:how to build sphinx doc when there is extension PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2016-08-31 21:00 +0200

csiph-web