[Python-modules-team] Bug#961741: python3-sphinx: new release broke sphinx-build OUTPUTDIR

2020-05-28 Thread Drew Parsons

Control: reassign -1 src:numba

On 2020-05-29 00:36, Simon McVittie wrote:

On Fri, 29 May 2020 at 00:02:46 +0800, Drew Parsons wrote:
  http_proxy='127.0.0.1:9' 
/usr/share/sphinx/scripts/python3/sphinx-build /usr/bin/sphinx-build 
-N -bhtml \

   .pybuild/cpython3_3.8_numba/build/docs/source/ \
   debian/numba-doc/usr/share/doc/numba-doc/html/


This looks wrong? It seems like it's running
/usr/share/sphinx/scripts/python3/sphinx-build with first argument set
to /usr/bin/sphinx-build. The argument parser will probably think
/usr/bin/sphinx-build is the SOURCEDIR,
.pybuild/cpython3_3.8_numba/build/docs/source/ is the OUTPUTDIR
and debian/numba-doc/usr/share/doc/numba-doc/html/ is in FILENAMES.

From numba's d/rules:


SPHINX_BUILD = $(shell dpkg -L python3-sphinx | grep "sphinx-build$$")


I think this is why. In previous versions this would have only found
one result, but that's really fragile: the fact that there was only one
filename ending with sphinx-build in the package was an implementation
detail that you can't rely on, and in the new version it isn't true
any more.

If what you want is to run "the version of sphinx that is packaged as
python3-sphinx, whatever that might be", use:

SPHINX_BUILD = python3 -m sphinx

But you might be better off using Depends: sphinx
and "SPHINX_BUILD = sphinx-build" in future: see
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=961206 for details.

I think this should probably be reassigned to numba, and any other
packages that were finding sphinx-build in the same fragile way.



I see, the numba build is pulling out both
/usr/share/sphinx/scripts/python3/sphinx-build and
/usr/bin/sphinx-build now.

I'll reassign and apply those changes in numba.

Thanks for the swift analysis, Simon.

Drew

___
Python-modules-team mailing list
Python-modules-team@alioth-lists.debian.net
https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/python-modules-team

[Python-modules-team] Bug#961741: python3-sphinx: new release broke sphinx-build OUTPUTDIR

2020-05-28 Thread Simon McVittie
On Fri, 29 May 2020 at 00:02:46 +0800, Drew Parsons wrote:
>   http_proxy='127.0.0.1:9' /usr/share/sphinx/scripts/python3/sphinx-build 
> /usr/bin/sphinx-build -N -bhtml \
>  .pybuild/cpython3_3.8_numba/build/docs/source/ \
>  debian/numba-doc/usr/share/doc/numba-doc/html/

This looks wrong? It seems like it's running
/usr/share/sphinx/scripts/python3/sphinx-build with first argument set
to /usr/bin/sphinx-build. The argument parser will probably think
/usr/bin/sphinx-build is the SOURCEDIR,
.pybuild/cpython3_3.8_numba/build/docs/source/ is the OUTPUTDIR
and debian/numba-doc/usr/share/doc/numba-doc/html/ is in FILENAMES.

From numba's d/rules:

> SPHINX_BUILD = $(shell dpkg -L python3-sphinx | grep "sphinx-build$$")

I think this is why. In previous versions this would have only found
one result, but that's really fragile: the fact that there was only one
filename ending with sphinx-build in the package was an implementation
detail that you can't rely on, and in the new version it isn't true
any more.

If what you want is to run "the version of sphinx that is packaged as
python3-sphinx, whatever that might be", use:

SPHINX_BUILD = python3 -m sphinx

But you might be better off using Depends: sphinx
and "SPHINX_BUILD = sphinx-build" in future: see
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=961206 for details.

I think this should probably be reassigned to numba, and any other
packages that were finding sphinx-build in the same fragile way.

smcv

___
Python-modules-team mailing list
Python-modules-team@alioth-lists.debian.net
https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/python-modules-team

[Python-modules-team] Bug#961741: python3-sphinx: new release broke sphinx-build OUTPUTDIR

2020-05-28 Thread Drew Parsons
Package: python3-sphinx
Version: 2.4.3-3
Severity: grave
Justification: renders package unusable

The new release 2.4.3-3 appears to have broken sphinx-build. It no
longer recognises the OUTPUTDIR argument.

This causes numba to FTBFS (OUTPUTDIR here is
debian/numba-doc/usr/share/doc/numba-doc/html/):

 dh_install -i -O--buildsystem=pybuild
 debian/rules override_dh_installdocs
  make[1]: Entering directory '/home/projects/python/build/numba'
  dh_installdocs -A README.rst
  dh_installdocs: warning: Cannot auto-detect main package for numba-doc.  If 
the default is wrong, please use --doc-main-package
  cp -a docs CHANGE_LOG examples .pybuild/cpython3_3.8_numba/build
  http_proxy='127.0.0.1:9' /usr/share/sphinx/scripts/python3/sphinx-build 
/usr/bin/sphinx-build -N -bhtml \
   .pybuild/cpython3_3.8_numba/build/docs/source/ \
   debian/numba-doc/usr/share/doc/numba-doc/html/
  usage: sphinx-build [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]
  sphinx-build: error: cannot find files 
['debian/numba-doc/usr/share/doc/numba-doc/html/']
  make[1]: *** [debian/rules:27: override_dh_installdocs] Error 2


numba was building successfully with sphinx 2.4.3-2

Marking severity grave since it means other packages can't use sphinx
(via sphinx-build at least). It should be prevented from migration to
testing if that's the case.


-- System Information:
Debian Release: bullseye/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.6.0-1-amd64 (SMP w/8 CPU cores)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_AU.UTF-8, LC_CTYPE=en_AU.UTF-8 (charmap=UTF-8), 
LANGUAGE=en_AU:en (charmap=UTF-8)
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages python3-sphinx depends on:
ii  python33.8.2-3
ii  python3-alabaster  0.7.8-1.1
ii  python3-babel  2.8.0+dfsg.1-3
ii  python3-distutils  3.8.3-2
ii  python3-docutils   0.16+dfsg-2
ii  python3-imagesize  1.2.0-2
ii  python3-jinja2 2.11.1-1
ii  python3-packaging  20.3-1.2
ii  python3-pygments   2.3.1+dfsg-3
ii  python3-requests   2.23.0+dfsg-2
ii  sphinx-common  2.4.3-3

Versions of packages python3-sphinx recommends:
ii  make 4.3-1
ii  python3-pil  7.0.0-4+b1

Versions of packages python3-sphinx suggests:
ii  dvipng 1.15-1.1+b1
ii  fonts-freefont-otf 20120503-10
ii  imagemagick-6.q16  8:6.9.10.23+dfsg-2.1+b2
ii  latexmk1:4.69a-0.1
ii  libjs-mathjax  2.7.8+dfsg-1
ii  python3-lib2to33.8.3-2
ii  python3-sphinx-rtd-theme   0.4.3+dfsg-3
pn  python3-stemmer
pn  sphinx-doc 
ii  texlive-fonts-recommended  2020.20200522-1
ii  texlive-latex-extra2020.20200522-1
ii  texlive-latex-recommended  2020.20200522-1
ii  texlive-plain-generic  2020.20200522-1

-- no debconf information

___
Python-modules-team mailing list
Python-modules-team@alioth-lists.debian.net
https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/python-modules-team