yahoo-eng-team team mailing list archive

[Brant Knudson <bknudson@xxxxxxxxxx>]

** Also affects: python-keystoneclient
   Importance: Undecided
       Status: New

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Keystone.
https://bugs.launchpad.net/bugs/1260495

Title:
  Setting autodoc_tree_index_modules makes documentation builds fail

Status in OpenStack Identity (Keystone):
  Confirmed
Status in Python Build Reasonableness:
  New
Status in Python client library for Keystone:
  New

Bug description:
  The arguments originally being passed into sphinx.apidoc specified '.'
  as the path to index. Unfortunately this includes the setup.py module.
  Sphinx dies while trying to process the setup.rst likely because the
  setup.py module calls setuptools.setup() when imported causing some
  sort of recursion. The final result is something like:

    2013-12-08 21:08:12.088 | reading sources... [ 80%] api/setup
    2013-12-08 21:08:12.100 | /usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown distribution option: 'setup_requires'
    2013-12-08 21:08:12.101 |   warnings.warn(msg)
    2013-12-08 21:08:12.102 | /usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown distribution option: 'pbr'
    2013-12-08 21:08:12.102 |   warnings.warn(msg)
    2013-12-08 21:08:12.103 | usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
    2013-12-08 21:08:12.103 |    or: setup.py --help [cmd1 cmd2 ...]
    2013-12-08 21:08:12.104 |    or: setup.py --help-commands
    2013-12-08 21:08:12.104 |    or: setup.py cmd --help
    2013-12-08 21:08:12.104 | 
    2013-12-08 21:08:12.105 | error: invalid command 'build_sphinx'
    2013-12-08 21:08:12.622 | ERROR: InvocationError: '/home/jenkins/workspace/gate-keystone-docs/.tox/venv/bin/python setup.py build_sphinx'

To manage notifications about this bug go to:
https://bugs.launchpad.net/keystone/+bug/1260495/+subscriptions