[OpenStack-docs] Looking for help with the openstack-doc-tools

sfinucan at redhat.com sfinucan at redhat.com
Thu Mar 16 16:14:43 UTC 2017


On Fri, 2017-03-10 at 09:51 +1000, Brian Moss wrote:
> 
> 
> On 10 March 2017 at 00:46, Chason Chan <chen.xing at 99cloud.net> wrote:
> > Hi Katomo and Berendt,
> > 
> > There is still some Newton release content in the config-ref of
> > Ocata release. I want to use the openstack-doc-tools to update it.
> > 
> > But when I use openstack-doc-tools to generate "New, updated, and
> > deprecated options" for Networking service, I failed with
> > "TypeError: 'module' object is not iterable". 
> > 
> > More output see the following:
> > 
> > Working on neutron (stable/newton)
> > Guru meditation now registers SIGUSR1 and SIGUSR2 by default for ba
> > ckward compatibility. SIGUSR1 will no longer be registered in a fut
> > ure release, so please use SIGUSR2 to generate reports.
> > Traceback (most recent call last):
> >   File "/root/openstack-doc-
> > tools/autogenerate_config_docs/autohelp.py", line 636, in <module>
> >     main()
> >   File "/root/openstack-doc-
> > tools/autogenerate_config_docs/autohelp.py", line 614, in main
> >     import_modules(base_path, package_name, verbose=args.verbose)
> >   File "/root/openstack-doc-
> > tools/autogenerate_config_docs/autohelp.py", line 143, in import_mo
> > dules
> >     _register_runtime_opts(module, abs_path, verbose)
> >   File "/root/openstack-doc-
> > tools/autogenerate_config_docs/autohelp.py", line 198, in _register
> > _runtime_opts
> >     for opt in obj:
> > TypeError: 'module' object is not iterable
> > Traceback (most recent call last):
> >   File "./diff_branches.py", line 306, in <module>
> >     sys.exit(main())
> >   File "./diff_branches.py", line 282, in main
> >     old_list = get_options(project, args.old_branch)
> >   File "./diff_branches.py", line 91, in get_options
> >     'PATH': path})
> >   File "/usr/lib/python2.7/subprocess.py", line 573, in check_outpu
> > t
> >     raise CalledProcessError(retcode, cmd, output=output)
> > subprocess.CalledProcessError: Command '['./autohelp-wrapper', '-
> > q', '-b', 'stable/newton', '-
> > e', 'venv/stable_newton', 'dump', 'neutron']' returned non-
> > zero exit status 1
> >  
> > BTW, I run the following command to generate: 
> > 
> > ./diff_branches.py stable/newton stable/ocata neutron
> > 
> > 
> > Not sure what I am missing. Could you or someone else please help
> > me?
> > 
> > ----------------
> > Thanks & regards,
> > Chason
> > 
> 
> For what it is worth, I tried running the same command as Chason and
> received the same error.
> 
> Brian

I, on the other hand, do not. I'm running Fedora 25 which defaults to
Python 3 - not 2.7. Don't know if this has any bearing on things.
Output of command on pastebin [1]. Command run below.

  $ cd autogenerate_config_docs/
  $ ./diff_branches.py stable/newton stable/ocata neutron

Stephen

[1] http://paste.openstack.org/show/602986/



More information about the OpenStack-docs mailing list