Path: csiph.com!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod From: Dmitry Shachnev Newsgroups: linux.debian.maint.python Subject: Re: how to build sphinx doc when there is extension Date: Wed, 31 Aug 2016 20:10:01 +0200 Message-ID: References: X-Original-To: debian-python@lists.debian.org X-Mailbox-Line: From debian-python-request@lists.debian.org Wed Aug 31 18:08:00 2016 Old-Return-Path: X-Amavis-Spam-Status: No, score=-12.367 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, FOURLA=0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FORGED_FROMDOMAIN=0.001, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.001, LDO_WHITELIST=-5, PGPSIGNATURE=-5, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01] autolearn=ham autolearn_force=no X-Policyd-Weight: NOT_IN_SBL_XBL_SPAMHAUS=-1.5 NOT_IN_BL_NJABL=-1.5 CL_IP_EQ_HELO_IP=-2 (check from: .gmail. - helo: .mail-lf0-f46.google. - helo-domain: .google.) FROM/MX_MATCHES_HELO(DOMAIN)=-2; rate: -7 X-Google-Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:date:from:to:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=i6BrW9hlhijzhtKvSTY1t+SLyr4SaJ6Ltq+Bah4b7xU=; b=eK0XrUEJjKYGNIzy+hAWSMD7FhKVvV+Y3kKDwSp5TXYSEd6eCxi4lfDHYKJg8r4jop do9x9AvYZHnjjKByUEHE31GrqKTt2lj4UAz97UInSUOO/lHcJrcK5J7/OiL7Q+E/J7eW YTAEeU0wZQF0GQ9ubFkwxVd+FV5zcmos5P/zu3VPGJoe10kZ9ny0RjERzdy74a8YxuLK n4Sozr+TI7W6LRQDZyRiZG88IedsZMkKRPtw5tMc8d8ZZ1I1lj29UJrsQeH7yNoNjoMY IvAPiHDeRDs6LNMyoOdXFRJTSlTuxZzd6qOrj2mBxv++YtaPhVLjoLo107EzVhEqokOP mT/Q== X-Gm-Message-State: AE9vXwOmH8v4ruspitEWqCaTGKIVZgR4Mz+0AJYss0L319RfAIX27xh3oTbK3veT80sZRw== X-Received: by 10.25.213.19 with SMTP id m19mr3202890lfg.62.1472666864873; Wed, 31 Aug 2016 11:07:44 -0700 (PDT) MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="fhzn5ezdfezsslj2" Content-Disposition: inline User-Agent: NeoMutt/ (1.7.0) X-Mailing-List: archive/latest/14173 List-ID: List-URL: List-Archive: https://lists.debian.org/msgid-search/20160831180741.z54w5moabb6pgozc@mitya57.me Approved: robomod@news.nic.it Lines: 61 Organization: linux.* mail to news gateway Sender: robomod@news.nic.it X-Original-Date: Wed, 31 Aug 2016 21:07:41 +0300 X-Original-Message-ID: <20160831180741.z54w5moabb6pgozc@mitya57.me> X-Original-References: Xref: csiph.com linux.debian.maint.python:8832 --fhzn5ezdfezsslj2 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi, On Tue, Aug 30, 2016 at 07:14:53AM +0000, PICCA Frederic-Emmanuel wrote: > I am using this snipset when I want to build the sphinx documentation for= all python available. (this is a sort of unit test). > Usually the sphinx doc use auto-doc and then it allows to check that all = modules can be imported.=20 > > override_dh_sphinxdoc: > ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS))) > PYBUILD_SYSTEM=3Dcustom \ > PYBUILD_BUILD_ARGS=3D"cd doc && PYTHONPATH=3D{build_dir} http_proxy=3D'1= 27.0.0.1:9' {interpreter} -c \"import sys;from sphinx import main;sys.exit(= main(sys.argv))\" -N -bhtml source build/html" dh_auto_build # HTML genera= tor > dh_installdocs "doc/build/html" -p python-pyfai-doc > dh_sphinxdoc -O--buildsystem=3Dpybuild > endif >=20 > I would like your opinion about this and if there is better way to do thi= s ? I agree with Ben that you shouldn=E2=80=99t really be using Sphinx for test= ing your source. But I also want to add that your command line is a too complicated way of doing a simple thing. You could simply use =E2=80=9C{interpreter} -m sphinx= [args]=E2=80=9D instead. --=20 Dmitry Shachnev --fhzn5ezdfezsslj2 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIcBAEBCAAGBQJXxxzpAAoJENb+cQNj+F3T38AP/3r2/JgTJL0wDvXTIPSNw1jR xZ9TeHHesEJCch0Blcqhk1MeiicaF/Uk90pj8rdkjkp35HAWCAKjPCBtBT7VyYHb Rl/eLeX22AHd/kwmm4N5v8A+/eXCZ4yIta77qK0BRhURV0WrV3yGwYq9iQ0fiXf/ prho7xklFhGGF3apbj3PvynatsxvOG/wX05Fupp9c1bh7PqSdPHjdYCyE0C0QqBn WHhiWjOkhNmgHy0l8qmvlmG+bWzjWl61zU+0uULs9CrUD2aOg44OshxHJIHPJzq8 m9ih0n2nq+0gbMatyDrhVo6jg6BiAhhGoUMuPVre8MakH607fboQif0oWlMQwj/l jB7TonUYELqK6MGDkD4tCFHp5WruLN38e7yCF4pPAx41eGwx7G9DLs8i0Z2B6uhy EAhl/P9L2oU3Nj3cpqgJlsLADGhBs33Ul6yxqYHz1hq5aTnhuVjp4NsffyVlo41i UDMDLZQ21PcBM/mvUCNJUJc0e33nEikn3i3KEnfeFf/svUFc36o6f4h4TGAs5DKX ssnfNyhdjvkqB31Vyers9vMpO28/rmqiN31sdxe8+8zlm76aHzIjt5DOicSTFLjh cid674lTYfl7Kry4OTMH8rMVJnB84kCJlhLdFOvQbStJPmoieNCKVEO3PFuUBcX+ qeeD2oz7WOdHuiIhRyqQ =PWzY -----END PGP SIGNATURE----- --fhzn5ezdfezsslj2--