镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content

There is no auto-generated docs #1030

Closed

Description

@homm

Auto-generated class docs are disappear from documentation. At least for Image.

Activity

  1. hugovk commented on Nov 29, 2014

    @hugovk
    Member

    The latest ReadTheDocs build passed but shows some import errors:

    https://readthedocs.org/builds/pillow/1906522/

    Last "good" build was 1 week, 2 days ago:

    https://readthedocs.org/builds/pillow/1879312/

    The following "bad" build was 1 day, 15 hours ago:

    https://readthedocs.org/builds/pillow/1903282/

    That last "bad" build was from this commit: 8a3302b

  2. homm commented on Nov 29, 2014

    @homm
    MemberAuthor

    I don't understand. This is last extension build: https://readthedocs.org/builds/pillow/1903313/ (building 'PIL._imaging' extension)
    Looks like extension are builded successfully, but still can't be imported. Also there is a warning about always_inline, but I think this can be a root of the problem.

    @hugovk Thanks for pointing where logs can be found. Can you replace full logs with just a links? They are too long.

  3. hugovk commented on Nov 29, 2014

    @hugovk
    Member

    @homm I've replaced the long logs replaced with links. I didn't realise they're publicly viewable, good that they are.

    I also don't see why it should be failing. @aclark4life @irskep Any ideas?

  4. aclark4life commented on Nov 29, 2014

    @aclark4life
    Member

    Looks like 8a3302b broke import _imaging.

  5. hugovk commented on Nov 30, 2014

    @hugovk
    Member

    So, the last "good" build was commit b8d2a55:
    https://readthedocs.org/builds/pillow/1879312/

    b8d2a55 is a parent of 8a3302b, and 8a3302b was the first "bad" build:
    https://readthedocs.org/builds/pillow/1903282/

    I checked the "good" 8a3302b into a new branch in my repo and created an RTD project for my own repo.

    Unsurprisingly the latest one failed:
    https://readthedocs.org/builds/hugovk-pillow/1909066/

    But the "good" b8d2a55 commit also failed:
    https://readthedocs.org/builds/hugovk-pillow/1909067/

    Perhaps an RTD environment change?

  6. wiredfool commented on Dec 1, 2014

    @wiredfool
    Member

    Can we split the docs so that pillow.readthedocs.org goes to the latest released docs, for now 2.6.1?

  7. hugovk commented on Dec 2, 2014

    @hugovk
    Member

    We can build docs for any branch.

    I just added 2.6.1, but not as pillow.readthedocs.org because it completely fails (unlike the other passes with ImportError):
    https://readthedocs.org/builds/pillow/1913609/

  8. wiredfool commented on Dec 2, 2014

    @wiredfool
    Member

    I just upgraded my sphinx (which downloaded some new dependencies as well) and broke it OMM. Reverting to the old sphinx I had (1.2.2) didn't help.

  9. wiredfool commented on Dec 2, 2014

    @wiredfool
    Member

    So, make inplace && make docs works, but not make install && make docs.

  10. aclark4life commented on Dec 2, 2014

    @aclark4life
    Member

    This sounds like an installation issue we worked on a while back.

  11. wiredfool commented on Dec 2, 2014

    @wiredfool
    Member

    The thing that I don't understand is that it's importing Image from within the docs directory, so it should be looking at the installed version, not the version that's in the Pillow source directory.

    I'm pretty sure that it's something with a sphinx (or a dependency) upgrade, since I was working on docs last week in this install, and the version on the site was similarly working at that point.

  12. wiredfool commented on Dec 2, 2014

    @wiredfool
    Member

    Ah, I just realized that the docs I was building last week were in a copy of my usual vm, which I still have hanging around. So I can probably track down the specific change, once I plug that drive in again.

  13. hugovk commented on Dec 2, 2014

    @hugovk
    Member

    If you diff the "good" and "bad" builds above, you can see what's changed in Sphinx and dependencies' upgrades.

  14. wiredfool commented on Dec 2, 2014

    @wiredfool
    Member

    FWIW, this is what I'm getting to the first error:

    (vpy27)erics@builder-1204-x64:~/Pillow$ make docs 2>&1 | more
    make -C docs html
    make[1]: Entering directory `/home/erics/Pillow/docs'
    sphinx-build -b html -d _build/doctrees   . _build/html
    Running Sphinx v1.2.1
    loading pickled environment... not yet created
    loading intersphinx inventory from http://docs.python.org/2/objects.inv...
    building [html]: targets for 40 source files that are out of date
    updating environment: 40 added, 0 changed, 0 removed
    reading sources... [  2%] PIL
    reading sources... [  5%] about
    reading sources... [  7%] developer
    reading sources... [ 10%] guides
    reading sources... [ 12%] handbook/appendices
    reading sources... [ 15%] handbook/concepts
    reading sources... [ 17%] handbook/image-file-formats
    reading sources... [ 20%] handbook/overview
    reading sources... [ 22%] handbook/tutorial
    reading sources... [ 25%] handbook/writing-your-own-file-decoder
    reading sources... [ 27%] index
    reading sources... [ 30%] installation
    reading sources... [ 32%] original-readme
    reading sources... [ 35%] porting-pil-to-pillow
    reading sources... [ 37%] reference/ExifTags
    reading sources... [ 40%] reference/Image
    reading sources... [ 42%] reference/ImageChops
    reading sources... [ 45%] reference/ImageCms
    reading sources... [ 47%] reference/ImageColor
    reading sources... [ 50%] reference/ImageDraw
    reading sources... [ 52%] reference/ImageEnhance
    reading sources... [ 55%] reference/ImageFile
    reading sources... [ 57%] reference/ImageFilter
    reading sources... [ 60%] reference/ImageFont
    reading sources... [ 62%] reference/ImageGrab
    reading sources... [ 65%] reference/ImageMath
    reading sources... [ 67%] reference/ImageMorph
    reading sources... [ 70%] reference/ImageOps
    reading sources... [ 72%] reference/ImagePalette
    reading sources... [ 75%] reference/ImagePath
    reading sources... [ 77%] reference/ImageQt
    reading sources... [ 80%] reference/ImageSequence
    reading sources... [ 82%] reference/ImageStat
    reading sources... [ 85%] reference/ImageTk
    reading sources... [ 87%] reference/ImageWin
    reading sources... [ 90%] reference/OleFileIO
    reading sources... [ 92%] reference/PSDraw
    reading sources... [ 95%] reference/PixelAccess
    reading sources... [ 97%] reference/PyAccess
    reading sources... [100%] reference/index
    
    /home/erics/Pillow/docs/PIL.rst:10: WARNING: autodoc: failed to import module u'PIL.BdfFontFile'; the following exception was raised:
    Traceback (most recent call last):
      File "/home/erics/vpy27/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 335, in import_object
        __import__(self.modname)
      File "/home/erics/Pillow/PIL/BdfFontFile.py", line 20, in <module>
        from PIL import Image
      File "/home/erics/Pillow/PIL/Image.py", line 63, in <module>
        from PIL import _imaging as core
    ImportError: cannot import name _imaging
    
  15. wiredfool commented on Dec 2, 2014

    @wiredfool
    Member

    The diff shows that the working one (https://readthedocs.org/builds/pillow/1879312/) already had Jinja2>=2.7.1, and the non-working one (https://readthedocs.org/builds/pillow/1903282/) had to download and build the whole sphinx package, including Downloading/unpacking Jinja2>=2.3 (from sphinx==1.2.2).

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions