travis-ci/dpl

pypi's upload_docs crashes

akuzminsky opened this issue · 3 comments

when dpl uploads a python package to pypi it crashes on upload_docs step

running upload_docs
Upload_docs command is deprecated. Use RTD instead.
creating /home/travis/build/twindb/proxysql-tools/build
creating /home/travis/build/twindb/proxysql-tools/build/sphinx
creating /home/travis/build/twindb/proxysql-tools/build/sphinx/doctrees
creating /home/travis/build/twindb/proxysql-tools/build/sphinx/html
Traceback (most recent call last):
  File "setup.py", line 54, in <module>
    tests_require=test_requirements
  File "/opt/python/2.7.13/lib/python2.7/distutils/core.py", line 151, in setup
    dist.run_commands()
  File "/opt/python/2.7.13/lib/python2.7/distutils/dist.py", line 953, in run_commands
    self.run_command(cmd)
  File "/opt/python/2.7.13/lib/python2.7/distutils/dist.py", line 971, in run_command
    cmd_obj.ensure_finalized()
  File "/opt/python/2.7.13/lib/python2.7/distutils/cmd.py", line 109, in ensure_finalized
    self.finalize_options()
  File "/home/travis/virtualenv/python2.7.13/lib/python2.7/site-packages/setuptools/command/upload_docs.py", line 65, in finalize_options
    self.target_dir = build_sphinx.builder_target_dir
  File "/opt/python/2.7.13/lib/python2.7/distutils/cmd.py", line 105, in __getattr__
    raise AttributeError, attr
AttributeError: builder_target_dir

full log https://travis-ci.org/twindb/proxysql-tools/jobs/248653364#L1124

@dstufft May we have your advice, please?

PyPI deprecated and has removed the upload_docs API endpoint. You can see in the error message:

Upload_docs command is deprecated. Use RTD instead.

The suggested replacement is ReadTheDocs for these projects, but projects may of course choose elsewhere.

Yep, I use RTD.
That error however prevented successful package upload. skip_upload_docs: true fixed that.