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
Avoid duplicated data (mainly headers and footers for table files).
Also reformat the generated output to avoid having too much white
spaces.
Change-Id: Ib7ff29ae6d3180a401c5cac482e82a56997751a7
- generate the tables in the doc/common/tables dir by default
- make the -i switch optional, and assume that git git repositories are
in a ./sources/ dir
- use elif's instead of multiple return statements in the subcommand
test
Change-Id: If96ac9df247cea5061c056328307ec88ab74a4f3
The common.py file is only used by autohelp.py, so is not really a
common file. Include its content in autohelp.py.
Also remove the unused _() definition.
Change-Id: I4e228637e3f6287fd2770ba386dd0fdba6977a81
There's nothing introspectable in the projects or oslo.rootwrap, but all
projects that use rootwrap have a sample etc/($project/)?rootwrap.conf
file. This file is relatively simple to parse for allowed options and
comments. It's not the best solution, but it's a solution.
Closes-Bug: #1253690
Change-Id: I51973a4b8f0ac6ea047c4ffc07647a10bdea92ee
We don't use the information about defining module anywhere. Using
that routine just makes the code slower and causes crashes in Neutron
and possibly elsewhere whenever an option is defined in the top level
but not registered.
Change-Id: I946c740cd0ce6fa5d969964d79a75a406e8453ab
By default xml files are generated in the working directory, this patch provides
an option to choose a target directory for xml files.
Change-Id: I65d78df8d70d82e5f14e9a175710468ac85b3796
