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

Re: building manpages via setup.py

Path	csiph.com!eternal-september.org!feeder.eternal-september.org!aioe.org!news.servidellagleba.it!bofh.it!news.nic.it!robomod
From	Ghislain Vaillant <ghisvail@gmail.com>
Newsgroups	linux.debian.maint.python
Subject	Re: building manpages via setup.py
Date	Wed, 02 Aug 2017 10:40:03 +0200
Message-ID	<u9Xmb-7tc-37@gated-at.bofh.it> (permalink)
References	<u9GEH-5cQ-19@gated-at.bofh.it> <u9Hr4-5Jr-23@gated-at.bofh.it> <u9W6J-6Ni-3@gated-at.bofh.it> <u9Wgq-6Qo-9@gated-at.bofh.it> <u9WzL-6Xn-9@gated-at.bofh.it> <u9WzL-6Xn-7@gated-at.bofh.it> <u9WzM-6Xn-25@gated-at.bofh.it> <u9X2O-7mD-23@gated-at.bofh.it> <u9X2O-7mD-21@gated-at.bofh.it> <u9Xmb-7tc-27@gated-at.bofh.it>
X-Original-To	"debian-python@lists.debian.org" <debian-python@lists.debian.org>
X-Mailbox-Line	From debian-python-request@lists.debian.org Wed Aug 2 08:34:17 2017
Old-Return-Path	<ghisvail@gmail.com>
X-Amavis-Spam-Status	No, score=-6.999 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FOURLA=0.1, FREEMAIL_FROM=0.001, LDO_WHITELIST=-5, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=ham autolearn_force=no
X-Policyd-Weight	using cached result; rate: -7
Dkim-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=uU3edTw94QGmWJaYcJ8bJwyyzVa7nxL1ykZkPLARXx0=; b=a8VH51L80vmDEIAZJaKLCopMJuJMbKhQyzHCrgD+tMkSidgTt1nuVjnaK6J64sup3p me0OaQMYUpBm4lBV1RrthOy+TA5ycR13jJGiMnrFTnRI/azkt2kLHKg+8Mx0T+gxc8/m bf1sccXzSKjCjjBKL62Pj0zb3mRZOuXZVkLrcM8wYW0UEPvgwKHaDoCyH/ahfkLcVsvn vxs2//GH/Bu/Kx85/tpcPaH0dDhNry6WuKXnqrx27UDCxYdOGv9F44FEaGlOKZytHEkf oIExz3mhzuFp34xHoOgJZHDY/Fp7sXo3McZ8Z9JT9/k77ed3NSfNpK3zaQ2iMrEx6IZq ALsQ==
X-Google-Dkim-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=uU3edTw94QGmWJaYcJ8bJwyyzVa7nxL1ykZkPLARXx0=; b=XBajc742frsy6VtOpZcf9zwtmQWUHoikdX3s6Pcec4Mh4kCmUyXy7xlc1gGX/IjHdh y2AYe8gcVZIbWSqoY8y8ojZmhHcTCcuYbNbTQgoSYP4Un8OG5aJwagoMprp/Xpn7LCps O1CD9CIUQc3C//65UJoRdNtcwUw460iT6gsRAFF2CCKbJIKlhXgjSwuUOpCK2B/XhBtR lm8u4KYAJEvmYf3Izd7KTFLEA/eRB6gBQYyr9kDLpAx8Mm0f3Qfh+TsQq5dSyqvL8B8k bKgCmWk+qoynNSaOEKPECBAOGpZ/Ec1TSV6kc6/P0IikXFjJAM+zBg+iaYYW4zKAhMM0 nMmw==
X-Gm-Message-State	AIVw1101trIdHpfAGKv3EpwT8NCb1fEoaQ5i8kmFjyyG65QPxuQyVIFg ZA9kfLcJM4ZcvHWH79s=
X-Received	by 10.223.137.137 with SMTP id x9mr16136598wrx.242.1501662841725; Wed, 02 Aug 2017 01:34:01 -0700 (PDT)
User-Agent	Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1
MIME-Version	1.0
Content-Type	text/plain; charset=utf-8; format=flowed
Content-Language	en-GB
Content-Transfer-Encoding	7bit
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/15053
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/d296913d-ed6f-4836-9fc1-e5db693b690d@gmail.com
Approved	robomod@news.nic.it
Lines	34
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Wed, 2 Aug 2017 09:34:00 +0100
X-Original-Message-ID	<d296913d-ed6f-4836-9fc1-e5db693b690d@gmail.com>
X-Original-References	<A2A20EC3B8560D408356CAC2FC148E53BB3F8A26@SUN-DAG3.synchrotron-soleil.fr> <20170801153401.6aqaw4syh3pvzchb@sar0.p1otr.com> <A2A20EC3B8560D408356CAC2FC148E53BB3F9C43@SUN-DAG3.synchrotron-soleil.fr> <20170802072020.3nwvcsvoly4vycit@sar0.p1otr.com> <A2A20EC3B8560D408356CAC2FC148E53BB3F9C98@SUN-DAG3.synchrotron-soleil.fr> <20170802074408.rpzxgjnd2k52upju@sar0.p1otr.com> <9811c4b7-22a8-b913-86b7-70d61b2ad1ef@gmail.com> <A2A20EC3B8560D408356CAC2FC148E53BB3F9CDD@SUN-DAG3.synchrotron-soleil.fr> <3ee0f234-2668-afb3-8c4b-569b7de1989b@gmail.com> <A2A20EC3B8560D408356CAC2FC148E53BB3F9CF8@SUN-DAG3.synchrotron-soleil.fr>
Xref	csiph.com linux.debian.maint.python:9673

Show key headers only | View raw

On 02/08/17 09:19, PICCA Frederic-Emmanuel wrote:
>> At the end of the day, it is just a matter of providing an appropriate
>> PYTHONPATH, regardless of whether pybuild is used or not.
> 
> Yes but to avoid the multiplications of way to provide this PYTHONPATH.

For the vast majority of packages, the current method listed in 
LibraryStyleGuide applies, i.e.:

PYTHONPATH=. sphinx-build -N -b html <docs_dir> <build_dir>

One can also use the sphinx-generated Makefile if available:

PYTHONPATH=$(CURDIR) $(MAKE) -C <docs_dir> html

Both are simple one-liners and do not rely on pybuild.

> Is it possible to have the recommended way which works for modules and extensions.

If it does not cost much to build the extension inplace, then the 
simplest option is to prefix one of these calls above with:

python3 setup.py build_ext --inplace

If the cost is prohibitive, which arguably applies to a very limited set 
of packages (yours included) then you would use pybuild for that, as 
Piotr kindly suggested.

> once agreed, we should put this in the wiki

Considering the rarity of this use case though, I wonder whether it is 
worth adding a separate section to the style guide.

Ghis

Thread

building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-01 16:50 +0200
  Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-01 17:00 +0200
    RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-01 17:50 +0200
  Re: building manpages via setup.py Piotr Ożarowski <piotr@debian.org> - 2017-08-01 17:40 +0200
    RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 09:20 +0200
      Re: building manpages via setup.py Piotr Ożarowski <piotr@debian.org> - 2017-08-02 09:30 +0200
        Re: building manpages via setup.py Piotr Ożarowski <piotr@debian.org> - 2017-08-02 09:50 +0200
          Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 09:50 +0200
            Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 10:20 +0200
              RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 10:40 +0200
                Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 10:40 +0200
                RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 11:20 +0200
                Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 11:30 +0200
                RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 12:10 +0200
                Re: building manpages via setup.py Ghislain Vaillant <ghisvail@gmail.com> - 2017-08-02 12:50 +0200
                RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 14:30 +0200
            RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 10:30 +0200
        RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-02 09:50 +0200
        RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-03 12:20 +0200
          RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-03 15:50 +0200
            RE:building manpages via setup.py PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2017-08-03 16:20 +0200

csiph-web