Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 724584 - dev-python/sqlalchemy-1.3.17 with USE=doc: doc/ not found, distutils_enable_sphinx call wrong
Summary: dev-python/sqlalchemy-1.3.17 with USE=doc: doc/ not found, distutils_e...
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Python Gentoo Team
Keywords: PATCH
Depends on:
Reported: 2020-05-22 19:21 UTC by Bernd Feige
Modified: 2020-07-29 07:56 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---

Updated ebuild file also applying zzzeeksphinx_version.patch (sqlalchemy-1.3.17.ebuild,1.61 KB, text/plain)
2020-05-23 10:07 UTC, Bernd Feige
Patch required version of zzzeeksphinx from 1.1.5 to 1.1.4 (zzzeeksphinx_version.patch,497 bytes, patch)
2020-05-23 10:08 UTC, Bernd Feige
Details | Diff
Ebuild for dev-python/sphinx-paramlinks (sphinx-paramlinks-0.4.1.ebuild,536 bytes, text/plain)
2020-05-23 10:10 UTC, Bernd Feige
Ebuild for dev-python/zzzeeksphinx (zzzeeksphinx-1.1.4.ebuild,685 bytes, text/plain)
2020-05-23 10:10 UTC, Bernd Feige
Ebuild for dev-python/pyScss needed by dev-python/zzzeeksphinx (pyScss-1.3.7.ebuild,877 bytes, text/plain)
2020-05-23 10:15 UTC, Bernd Feige
Updated ebuild (sqlalchemy-1.3.18.ebuild,1.55 KB, text/plain)
2020-07-29 07:55 UTC, Bernd Feige
Updated ebuild for dev-python/zzzeeksphinx (zzzeeksphinx-1.1.5.ebuild,685 bytes, text/plain)
2020-07-29 07:56 UTC, Bernd Feige

Note You need to log in before you can comment on or make changes to this bug.
Description Bernd Feige 2020-05-22 19:21:50 UTC
With USE=doc, emerge fails with error message:
 ERROR: dev-python/sqlalchemy-1.3.17::gentoo failed (compile phase):
   doc/ not found, distutils_enable_sphinx call wrong

Reproducible: Always
Comment 1 Jonas Stein gentoo-dev 2020-05-22 20:22:35 UTC
Thank you for the report. We need to have all information at hand before ticket assignment. That is why I ask you to 
* attach the logs and 
* paste the emerge info 
as described on
Please reopen this ticket (Status:UNCONFIRMED) afterwards.
Comment 2 Bernd Feige 2020-05-23 08:00:59 UTC
I now verified that the ebuild line:

distutils_enable_sphinx doc

should be changed to:

distutils_enable_sphinx doc/build

After this is done, sphinx starts but the special sphinx extension used by SQLAlchemy is missing:

"Running Sphinx v2.4.4

Extension error:
Could not import extension zzzeeksphinx (exception: No module named 'zzzeeksphinx')"

So this module should be loaded, probably via a required package?

emerge --info:
Portage 2.3.99 (python 3.8.3-final-0, default/linux/amd64/17.1/systemd, gcc-10.1.0, glibc-2.31-r3, 5.6.14-gentoo x86_64)
                         System Settings
System uname: Linux-5.6.14-gentoo-x86_64-AMD_Ryzen_7_1700_Eight-Core_Processor-with-glibc2.2.5
KiB Mem:    32889648 total,  27705512 free
KiB Swap:    9214972 total,   9214972 free
Timestamp of repository gentoo: Sat, 23 May 2020 06:45:01 +0000
Head commit of repository gentoo: f3a26fd5abb287f89b0081d14814e392b883b125
Head commit of repository flatpak-overlay: 2bcc4b030ff8288683533a84f15777680c8c883e

sh bash 5.0_p17
ld GNU ld (Gentoo 2.34 p4) 2.34.0
distcc 3.3.3 x86_64-pc-linux-gnu [disabled]
ccache version 3.7.9 [enabled]
app-shells/bash:          5.0_p17::gentoo
dev-java/java-config:     2.2.0-r4::bfown
dev-lang/perl:            5.30.2-r2::gentoo
dev-lang/python:          2.7.18::gentoo, 3.8.3::gentoo
dev-util/ccache:          3.7.9::gentoo
dev-util/cmake:           3.17.2::gentoo
dev-util/pkgconfig:       0.29.2::gentoo
sys-apps/baselayout:      2.7::gentoo
sys-apps/sandbox:         2.18::gentoo
sys-devel/autoconf:       2.13-r1::gentoo, 2.69-r5::gentoo
sys-devel/automake:       1.13.4-r2::gentoo, 1.16.2::gentoo
sys-devel/binutils:       2.34-r1::gentoo
sys-devel/gcc:            10.1.0::gentoo
sys-devel/gcc-config:     2.2.1::gentoo
sys-devel/libtool:        2.4.6-r6::gentoo
sys-devel/make:           4.3::gentoo
sys-kernel/linux-headers: 5.6::gentoo (virtual/os-headers)
sys-libs/glibc:           2.31-r3::gentoo

    location: /usr/portage
    sync-type: rsync
    sync-uri: rsync://
    priority: -1000
    sync-rsync-verify-max-age: 24
    sync-rsync-verify-metamanifest: yes
    sync-rsync-verify-jobs: 1

    location: /gentoo/local/flatpak-overlay
    sync-type: git
    masters: gentoo
    priority: 50

    location: /gentoo/local/layman/haskell
    sync-type: laymansync
    masters: gentoo
    priority: 50

    location: /gentoo/local/layman/science
    masters: gentoo
    priority: 50

    location: /gentoo/overlay
    masters: gentoo science haskell
    priority: 100

Installed sets: @system
ACCEPT_KEYWORDS="amd64 ~amd64"
CFLAGS="-march=znver1 -O2 -pipe"
CONFIG_PROTECT="/etc /usr/lib64/libreoffice/program/sofficerc /usr/share/config /usr/share/gnupg/qualified.txt"
CONFIG_PROTECT_MASK="/etc/ca-certificates.conf /etc/dconf /etc/env.d /etc/fonts/fonts.conf /etc/gconf /etc/gentoo-release /etc/revdep-rebuild /etc/sandbox.d /etc/terminfo /etc/texmf/language.dat.d /etc/texmf/language.def.d /etc/texmf/updmap.d /etc/texmf/web2c"
CXXFLAGS="-march=znver1 -O2 -pipe"
FCFLAGS="-O2 -pipe"
FEATURES="assume-digests binpkg-docompress binpkg-dostrip binpkg-logs ccache config-protect-if-modified distlocks ebuild-locks fixlafiles ipc-sandbox merge-sync multilib-strict network-sandbox news parallel-fetch pid-sandbox preserve-libs protect-owned qa-unresolved-soname-deps sandbox sfperms strict unknown-features-warn unmerge-logs unmerge-orphans userfetch userpriv usersandbox usersync xattr"
FFLAGS="-O2 -pipe"
LDFLAGS="-Wl,-O1 -Wl,--as-needed"
LINGUAS="de en"
PORTAGE_RSYNC_OPTS="--recursive --links --safe-links --perms --times --omit-dir-times --compress --force --whole-file --delete --stats --human-readable --timeout=180 --exclude=/distfiles --exclude=/local --exclude=/packages --exclude=/.git"
USE="R X a52 aac aacs acl acpi afs alsa amd64 audit bacula-clientonly bdplus berkdb blas bluetooth bluray btrfs bzip2 cairo caps cddb cdparanoia cdr cli clutter colord colorio cpudetection crypt cscope cups dbus dga djvu dri dri3 dv dvd dvdr dvdread dvi eds enblend encode eselect-ldso evo exif ext4 extrafilters faac ffmpeg fftw flac fluidsynth fontconfig fortran fuse g3dvl gdbm gegl gif gimp gles2 gmp gnome gnome-keyring gnome-shell gnutls graphics graphviz gs gstreamer gtk gtk3 hddtemp hdri heif iconv icu id3tag imagemagick introspection ipv6 ipython jack java jbig jingle jpeg jpeg2k kerberos kpathsea ladspa lame lapack latex lcms ldap lensfun libdrm libnotify libtirpc lm_sensors lv2 lyx lzma lzo mad matplotlib matroska md5sum midi mjpeg mng mp2 mp3 mpeg mtp multilib musepack nautilus ncurses nfs nls nptl numpy office ofx ogg openal opencl opencv openexr opengl openh264 openmp opus otr pam pcre pda pdf pep8 playlist plotutils plugins png pnm policykit postgres postscript pulseaudio pylint python qt3support quicktime radio rar raw readline real rtc rtmp rubberband sbsms scanner science scipy seccomp sendto sift sndfile sound soundtouch speex spell split-usr sqlite srt ssh ssl svg systemd t1lib taglib tcpd telepathy theora threads tiff tivo tracker truetype twolame udev udisks umfpack unicode upnp user-session v4l vaapi vamp vdpau vim-syntax vorbis vpx vulkan wayland webengine webp win32codecs wmf x264 xattr xcomposite xetex xinerama xml xmp xmpp xps xv xvid xvmc zeromq zlib zoran" ABI_X86="64" ADA_TARGET="gnat_2018" ALSA_CARDS="ali5451 als4000 atiixp atiixp-modem bt87x ca0106 cmipci emu10k1x ens1370 ens1371 es1938 es1968 fm801 hda-intel intel8x0 intel8x0m maestro3 trident usb-audio via82xx via82xx-modem ymfpci" APACHE2_MODULES="authn_core authz_core socache_shmcb unixd actions alias auth_basic authn_alias authn_anon authn_dbm authn_default authn_file authz_dbm authz_default authz_groupfile authz_host authz_owner authz_user autoindex cache cgi cgid dav dav_fs dav_lock deflate dir disk_cache env expires ext_filter file_cache filter headers include info log_config logio mem_cache mime mime_magic negotiation rewrite setenvif speling status unique_id userdir usertrack vhost_alias" CALLIGRA_FEATURES="karbon sheets words" CAMERAS="canon ptp2 samsung" COLLECTD_PLUGINS="df interface irq load memory rrdtool swap syslog" CPU_FLAGS_X86="mmx mmxext sse sse2 aes avx avx2 f16c fma3 pclmul popcnt sse3 sse4_1 sse4_2 sse4a ssse3" ELIBC="glibc" GPSD_PROTOCOLS="ashtech aivdm earthmate evermore fv18 garmin garmintxt gpsclock greis isync itrax mtk3301 nmea ntrip navcom oceanserver oldstyle oncore rtcm104v2 rtcm104v3 sirf skytraq superstar2 timing tsip tripmate tnt ublox ubx" INPUT_DEVICES="libinput" KERNEL="linux" L10N="de en" LCD_DEVICES="bayrad cfontz cfontz633 glk hd44780 lb216 lcdm001 mtxorb ncurses text" LIBREOFFICE_EXTENSIONS="presenter-console presenter-minimizer nlpsolver pdfimport" OFFICE_IMPLEMENTATION="libreoffice" PHP_TARGETS="php7-2" POSTGRES_TARGETS="postgres10 postgres11" PYTHON_SINGLE_TARGET="python3_8" PYTHON_TARGETS="python3_8" QEMU_SOFTMMU_TARGETS="x86_64 i386 arm aarch64" QEMU_USER_TARGETS="x86_64 i386 arm aarch64" RUBY_TARGETS="ruby27" SANE_BACKENDS="hp5590 mustek" USERLAND="GNU" VIDEO_CARDS="radeon radeonsi amdgpu" XTABLES_ADDONS="quota2 psd pknock lscan length2 ipv4options ipset ipp2p iface geoip fuzzy condition tee tarpit sysrq steal rawnat logmark ipmark dhcpmac delude chaos account"

                        Package Settings

dev-python/sqlalchemy-1.3.11::gentoo was built with the following:
USE="doc examples sqlite -test" ABI_X86="(64)" PYTHON_TARGETS="python3_8 -pypy3 -python2_7 -python3_6 -python3_7"
FEATURES="unmerge-logs unmerge-orphans sfperms unknown-features-warn usersandbox sandbox config-protect-if-modified multilib-strict userfetch assume-digests ipc-sandbox binpkg-logs protect-owned network-sandbox qa-unresolved-soname-deps userpriv fixlafiles merge-sync xattr preserve-libs ebuild-locks binpkg-docompress news parallel-fetch usersync distlocks pid-sandbox strict binpkg-dostrip ccache"
Comment 3 Bernd Feige 2020-05-23 10:07:59 UTC
Created attachment 641010 [details]
Updated ebuild file also applying zzzeeksphinx_version.patch
Comment 4 Bernd Feige 2020-05-23 10:08:53 UTC
Created attachment 641012 [details, diff]
Patch required version of zzzeeksphinx from 1.1.5 to 1.1.4
Comment 5 Bernd Feige 2020-05-23 10:10:13 UTC
Created attachment 641014 [details]
Ebuild for dev-python/sphinx-paramlinks
Comment 6 Bernd Feige 2020-05-23 10:10:48 UTC
Created attachment 641016 [details]
Ebuild for dev-python/zzzeeksphinx
Comment 7 Bernd Feige 2020-05-23 10:15:47 UTC
Created attachment 641018 [details]
Ebuild for dev-python/pyScss needed by dev-python/zzzeeksphinx

Now managed to emerge the sqlalchemy docs.
In addition to the ebuild fix mentioned before, we need *three* packages not currently in the tree, all provided as attachments.
At least pyScss may be useful in other contexts as well.
Alternative would probably be to drop/disable the "doc" use flag, but I, for one, need local docs for this package.
Comment 8 Bernd Feige 2020-05-23 10:19:11 UTC
(In reply to Bernd Feige from comment #4)
> Created attachment 641012 [details, diff] [details, diff]
> Patch required version of zzzeeksphinx from 1.1.5 to 1.1.4

Sorry, I didn't write why this patch is necessary: doc/build/ requires 1.1.5 but pypi provides only 1.1.4 presently. It "works" with 1.1.4 as well, could be that formatting somewhere is suboptimal somewhere...
Comment 9 Erik 2020-07-13 14:30:48 UTC
Comment 10 Bernd Feige 2020-07-29 07:54:15 UTC
zzzeeksphinx-1.1.5 was now officially released (cf. so we don't need to patch sqlalchemy requirements any more.
Also, current version of sqlalchemy is 1.3.18 so my ebuild with USE=doc support has this version.
Note that changes in sphinx 3.1.2 make building the documentation fail; masking that and using 3.0.4 works (cf the debian bug:
Comment 11 Bernd Feige 2020-07-29 07:55:45 UTC
Created attachment 651376 [details]
Updated ebuild
Comment 12 Bernd Feige 2020-07-29 07:56:42 UTC
Created attachment 651378 [details]
Updated ebuild for dev-python/zzzeeksphinx