This is just for update package list changes.
Not solved config reference autogeneration problem.
Remove stackforge package handling in autohelp-wrapper
Remove modules
networking-ibm (SDNVE) (It seems no maintained)
networking-bigswitch (It seems no maintained)
networking-portforwarding (It seems no maintained)
Changes from stackforge to openstack
networking-bagpipe-l2, networking-brocade,
networking-edge-vpn, networking-hyperv,
networking-mlnx, networking-nec, networking-ovs-dpdk,
networking-zvm, networking-6wind
Add
octavia
Change-Id: I5ba3b26e110f55b2cc76f37b903a1b07dd6a1202
Related-Bug: #1503967
Autogenerate-config-docs creates files that live in the
openstack-manuals repository, but are automatically generated
and should not be edited.
On occasion, contributors miss the warning not to edit the files.
This patch increases the previous warning so that it should take up
enough screen real-estate in a text editor that it would be less
easily skipped, and adds some additional information on what to do
instead.
Change-Id: I800e1ed19427e00f903046731fe8f22f22e4c6db
With this patch, it can run on
designate
manila
zaqar
Related-Bug: #1407581
How to add
see the Trace back and add last item. like follows
For addin designate.api.v1.extensions.sync case,
====log===
Traceback (most recent call last):
snip
File "/home/sakaia/work/openstack-doc-tools/autogenerate_config_docs/autohelp.py", line 138, in import_modules
module = importlib.import_module(modname)
File "/usr/lib/python2.7/importlib/__init__.py", line 37, in import_module
__import__(name)
File "/home/sakaia/work/openstack-doc-tools/autogenerate_config_docs/sources/designate/designate/api/v1/extensions/sync.py", line 23, in <module>
central_api = central_rpcapi.CentralAPI()
=====
Change-Id: I76101cba32c4dd09a303a878719db5f544eb3ebf
This change modifies the -i option behavior of autohelp.py to add the
possibility to find configuration options in multiple repositories. The
change implies a few related modifications:
- do not check if the source repository is a git repository
- update autohelp-wrapper to clone and use the additional repositories
(only for neutron at the moment)
Note: diff_branches.py will not work with this change, it'll be fixed in
another patch.
Closes-Bug: #1448107
Change-Id: I4999aca4f7926e19513acdf38f1e2828b52cee13
All the projects use oslo.i18n in kilo and liberty, the workaround for
projects non using this module is not needed anymore.
Change-Id: I7a096c11eef2ae2f3e9006fa0379f49f18a1cc81
autohelp's OptionsCache.load_extension_options() loads options from
libraries. An oslo_config.cfg.Opt object has a 'name' attribute and
a 'dest' attribute. The option name that we're interested in (that
the user sets) is the 'dest' value, not the 'name' value. The
load_extension_options() method was incorrectly using the option's
'name' attribute.
This fixes it so that the option's 'dest' attribute is used instead.
Eg, from oslo_log library, it now correctly uses 'log_config_append'
instead of 'log-config-append'.
Change-Id: I01422bf33be286cc0176a3e1e4ac1c348c6821ef
Closes-Bug: #1464058
We are mmoving the guides to RST, so we need config-reference tables in
this format. This patch adds a `rst` subcommand to autohelp.py to handle
this new requirement.
RST has limited tables-related features, and openstackdocstheme will
need an update to improve the output.
Change-Id: I5e58d60e2308d208e850f903559da5f5a6a949e3
The Oslo libraries have moved all of their code out of the 'oslo'
namespace package into per-library packages. The namespace package was
retained during kilo for backwards compatibility, but will be removed by
the liberty-2 milestone. This change removes the use of the namespace
package, replacing it with the new package names.
The patches in the libraries will be put on hold until application
patches have landed, or L2, whichever comes first. At that point, new
versions of the libraries without namespace packages will be released as
a major version update.
Please merge this patch, or an equivalent, before L2 to avoid problems
with those library releases.
Blueprint: remove-namespace-packages
https://blueprints.launchpad.net/oslo-incubator/+spec/remove-namespace-packages
Change-Id: Ib17a74ada3122ce45c52fdd7dcf8d27fafbb1d70
Using oslo.config objects in pickle leads to multiple import problems on
deserialization. Since we don't actually need oslo objects, we convert
them into dicts before dumping them.
Change-Id: Icbd1a3957e4d4ae05fe6227fbdd1cb58e5a3a98d
These folders used to bring command line options that we don't want to
have in the generated tables, but the behavior has changed. This patch
restores the import of files in the cmd/ folders, and handles special
cases where the import is problematic.
Change-Id: I0779e0f689d2f6f64149c3d111a8dd1ecd6cfc20
Partial-Bug: #1363954
Specifying the encoding and working with unicode strings in not
supported in lxml. The BASE_XML string is only used to init the XML tree
and does not need a specific encoding. The utf-8 encoding is explicitely
added when the final XML is written to file.
Change-Id: I74e0a316cf718ad9768a690f8ccc4a1cc9a9fc7e
We use trickery to import the keystone middleware options, which might
result in duplicated opts errors. This patch ignore such errors on the
middleware import.
Also use keystonemiddleware instead of keystoneclient.middleware.
Change-Id: I4e003ec9f4a7a706a2bbdeea5f874624fc59ea40
A previous patch attempted to introduce semantic tagging for
options and their default values in the automatically
generated configuration reference tables.
While this worked well for swift, incorrect code was used
for the XML generation of the main autohelp.py method.
This patch fixes the string based code to use XML subElements
as was already done for extract_swift_flags.
Change-Id: I93a89b726d66acd0778e8365f47d5ee2f2e0b3c5
By marking options as <option>option_name</option>, we get
more flexibility in how to handle them.
In particular, currently these thousands of automatically generated
options are polluting the translation's common resource.
Marking these strings as <option> might allow us to
say "don't translate this".
Change-Id: I0282545d1a2c3ca3d14a5c411c2f5457fbd09780
Most of the default value sanitization happened during the docbook
writting, and not during the 'dump' of the options. This resulted in
invalid values in the xml files produced by diff_branches.py.
This patch moves all the sanitization code to the same function,
ensuring that the sanitization happens during options discovery.
Change-Id: I4d7e5d601baac5294937525ede8655da6b25e6cf
Some help strings have a trailing space that make our tests fail. These
spaces should be removed from the help strings in the projects, but it
takes time and we often end up editing manually.
Help strings from the oslo incubator might already have been fixed but
not yet imported in the projects, so no proper solution exists in this
case.
Change-Id: I606f46b23a4c5a5114bb5577273657fdf4fa5295
To avoid duplication of entries, use a shared headers file as fall back.
Co-Authored-By: Gauvain Pocentek <gauvain.pocentek@objectif-libre.com>
Change-Id: I639a299d5b1d1e91b81ab15fc6ba2a93f35017a9
wrapper:
- Don't modify the openstack-manuals repo if it exists, keep it as is
git wise (no branch change, no pull)
- Install oslo.i18n and hplefthandclient
- First setup the environment, then do the update/docbook work
autohelp.py:
- Handle projects not using oslo.i18n (mostly for havana)
diff_branches.py:
- Update the output format
- Setup the venv for the requested projects only
Change-Id: I48c45a56f4b7b7298fef0b7595d62e445c92df39
Some module imports fail without a proper setup of oslo.i18n, so make
sure that it is the case for projects using this package.
Change-Id: I7082cb893ccb52fa7bf065a01655efb9a5bbd4e2
This patch also reworks the autohelp _sanitize_default to wotk on an Opt
object instead of its name and default value.
Change-Id: I2b1b0dd44f64a49b6e41c9922555cd968822d144
This method disappeared from oslo, so provide our own sanitizer. This is
needed for now but can be removed as soon as projects provide
Opts.sample_default values.
Change-Id: I13e76c75a74667fa9bd3c779a6cf45d0281ed680
Closes-Bug: #1341250
Oslo modules are not used by all the components, so configuration
options might be invalid if these modules are unconditionaly loaded.
This change uses the requirements.txt file of a project to detect if
oslo modules have to be imported.
Change-Id: I7cd81d0c9a5ae43f0a628e2d2a6f664507e54122
We always explicitely pass a target argument to the write_docbook*
functions, so we can't use a default value for it. This patch makes the
target argument mandatory.
Change-Id: I4a193abe2634f21b52ba61c5692fe03061ac7fd3
Require at least 0.9.1 because 0.9.0. had a minor bug.
This change also fixes all found issues.
Rewrote some docstrings to fit H405.
Change-Id: Ifeef11b783dbe70b2652d2b9ea29d5b20f69f2ce
diff_branches.py generates a listing of the configuration options
changes that occured between 2 openstack releases.
This involves a few changes in other tools:
- the 'dump' subcommand for autohelp.py generates the serialized dict of
options
- add a special case for the 'bindir' option to avoid getting different
default values in different virtual environments
- the autohelp-wrapper -e switch builds the needed venv without
running autohelp.py commands
Change-Id: I80da172b91b8d2f0a15f89f4c812864da2fea471
