Bug 507444 – =app-emulation/docker-0.10.0 USE=doc with =dev-python/sphinx-1.2.2 - Running Sphinx v1.2.2 Extension error: Could not import extension sphinxcontrib.httpdomain (exception: No module named 'sphinxcontrib')

• Status: RESOLVED DUPLICATE of bug 507048
• Product: Gentoo Linux

[Description Alex Brandt (RETIRED) 2014-04-11 19:49:18 UTC]

When building docker with the doc use flag the sphinxcontrib.httpdomain extension can't be imported even when it's installed.  Possibly due to the python versions in use.

Reproducible: Always

Steps to Reproduce:
1. USE=doc emerge -v1 \=app-emulation/docker-0.10.0
2. Extension error: Could not import extension sphinxcontrib.httpdomain (exception: No module named 'sphinxcontrib')
3.
Actual Results:  
Sphinx Extension Error

Expected Results:  
Successful build

The required extension is installed but only supports python-2.7 whereas the system python is set to python-3.3.  Not sure this is related but doesn't seem insignificant.

[Comment 1 Alex Brandt (RETIRED) 2014-04-11 19:49:42 UTC]

Created attachment 374766 [details]
environment

[Comment 2 Alex Brandt (RETIRED) 2014-04-11 19:49:57 UTC]

Created attachment 374768 [details]
build.log

[Comment 3 Alex Brandt (RETIRED) 2014-04-11 19:50:20 UTC]

Created attachment 374770 [details]
emerge -pqv '=app-emulation/docker-0.10.0::gentoo'

[Comment 4 Alex Brandt (RETIRED) 2014-04-11 19:51:00 UTC]

Created attachment 374772 [details]
emerge --info '=app-emulation/docker-0.10.0::gentoo'

[Comment 5 Jeroen Roovers (RETIRED) 2014-04-12 16:59:01 UTC]

*** This bug has been marked as a duplicate of bug 507048 ***

[Comment 6 Alex Brandt (RETIRED) 2014-04-12 17:03:52 UTC]

Hey Jeroen,

I can see why this looks like it's related to bug 507048 but it's actually a different problem.  In the bug you marked this as a duplicate of, the issue is a missing dependency.  Otherwise, the build succeeds just fine when the sphinx extension is installed.

On the other hand, this bug happens regardless of the installed state of the extension in question.  This is a deeper issue than just a missing dependency on a particular package.

[Comment 7 Tianon 2014-04-12 20:41:34 UTC]

I can confirm that this one is specifically because of the currently eselected system python (but I can't say anything for or against bug ).  Mine was set to python2.7 and was working, but setting it to python3.3 makes it stop working.  I would imagine that this is because sphinx itself supports Python 3, but sphinxcontrib.httpdomain only supports Python 2.

I'm only mildly familiar with Sphinx, so I'm not sure what the proper solution here is.  I think it is worth noting that upstream Docker is moving away from Sphinx for their docs, and that transition might be complete as soon as the next major release.

In the meantime, if someone has an idea for how to convince Sphinx that we need to use whatever version of Python is supported by the httpdomain extension, any ideas would be appreciated.

[Comment 8 Tom Wijsman (TomWij) (RETIRED) 2014-05-23 11:58:42 UTC]

Some time ago, I've commented on the duplicate to make note of this bug; if you still experience this after that duplicate gets resolved, please comment again.

[Comment 9 Alex Brandt (RETIRED) 2014-05-23 15:39:48 UTC]

Hey Tom,

Thanks for the follow up.  This is closed with the release of docker-0.11.1 as it no longer uses sphinx for documentation (thus, completely breaking the duplicate status of this bug).  I don't know if a status change is necessary but this bug is no longer open.