build the docs, what's needed and what's not??? #84

Open
idella opened this Issue Apr 18, 2013 · 0 comments

Comments

Projects
None yet
1 participant

idella commented Apr 18, 2013

It's not that the docs don't build. They get there, but the output of warnings and msgs of what's deprecated and should have could have been re-written to the newer form and failed imports, I just can't keep up with them all.

https://gist.github.com/idella/0d37681db173995a3886

Now I can't say all of the output from the link above ought go, but it makes for tough reading to sort what's trivial and what ought be found a fix.

RuntimeError: Importing from wx backend after selecting qt4 backend!

these it seems are harmless, but really one would be enough

WARNING:root:DEPRECATED: pyface.grid, use pyface.ui.wx.grid instead.

Well, you're the authors. Can you do just that??? many times???

from pyface.api import HeadingText, LayeredPanel, SplitDialog
ImportError: cannot import name LayeredPanel

What is going on here? pyface can't recognise and import its own modules???

tilt

Now this one really REALLY needs some sorting

 File "/usr/lib64/python2.7/site-packages/pyface/tasks/enaml_dock_pane.py", line 3, in <module>
from enaml.components.constraints_widget import ConstraintsWidget
ImportError: No module named enaml.components.constraints_widget

dev-python/pyface $ find /mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0 -name enaml

yields

/mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0/examples/tasks/enaml

Now let's attempt an objective observation here
The building of the docs is importing from enaml found under the top level folder 'examples', and it can't find the modules constraints_widget from enaml anyways.

eeer

tilt

The above was
pyface # USE="script sql webkit xmlpatterns" emerge pyside
which in gentoo speak means pyface can be installed with or without a number of modules which use flags make optional. So when I get a

" from PySide.QtWebKit import *
ImportError: No module named QtWebKit"

It's a gentoo 'thing' because basically the installed form of pyside is a cut down form of the full monty. DO you care? Well the point here is,
If you find something that hints of the full package appears to be missing something,
then you can say that looks a gentoo made issue.

HOWEVER

the main example here

from pyface.api import HeadingText, LayeredPanel, SplitDialog
ImportError: cannot import name LayeredPanel

is pyface building docs from pyface's own source in

dev-python/pyface $ ls /mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0 
docs  examples  pyface  pyface.egg-info  README.rst  setup.py  TODO.txt

pyface $ find /mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0  -name api/mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0/docs/source/api
/mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0/docs/build/html/api
/mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0/docs/build/html/_sources/api
/mnt/gen2/TmpDir/portage/dev-python/pyface-4.3.0-r1/work/pyface-4.3.0/docs/build/doctrees/api

This one I am 99% sure is not a gentoo induced issue, but I have to leave that 1% in case I have really missed something.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment