After https://review.openstack.org/#/c/144685 merges,
the automatically generated configuration reference
tables will be marked up as
<option>option_name</option> = <replaceable>default_value</replaceable>
As none of this should be translated (option_name is the same
regardless of language), this patch updates generatepot to ignore
option_name s tagged with <option> for translation.
This should significantly reduce the number of strings required for
translation from the common directory in particular, where
many of the 8000-odd strings do not actually need translation.
Change-Id: I27a71fd00759c883833a7061186c93f11efac68a
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
The JSON formatting created by jsoncheck.py omits the file's final
newline. It claims that files with such a newline need reformatting
and removes the final newline in a file when reformatting.
This patch brings jsoncheck.py in line with the rest of the tools
which prefer text files to end with a newline.
Update release notes for pushing out the bug fix.
Closes-Bug: #1403159
Change-Id: I35eab544b183c05b167ce9917d92f0f1f919b745
Change diff_branches.py to generate the config-changes file with an
xml:id that always contains the release name instead of the name of
the new branch. This way it can be avoided that the id changes, when
stable branch is cut close to the end of a release cycle.
Change-Id: I96ef56fef7dac98f344296d1217586326740b46e
There exists URLs that are not reachable but are still valid URLs.
Those URLs should not be checked for reachability.
Change-Id: I268ef741f20200d59191a383d20a8fbeba134fb3
Replace URLs for workflow documentation to appropriate parts of the
OpenStack Project Infrastructure Manual.
Change-Id: Ib947ebfc78ed80447d0b3b8895d9e96919fb1b00
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
This patch makes doctest use jsoncheck.
It offers:
- more helpful syntax error messages (courtesy of demjson)
- additional niceness checks for standardized formatting
Change-Id: Id92c43daeb6ee17ed03052b3c9b92cbf60f3f4a5
blueprint modularize-doctest
flake8 has support for cyclomatic complexity (Mccabe) currently our
worst offender has a complexity of 28. So
set our max-complexity to 29 so that don't make things any worse.
https://github.com/flintwork/mccabe
Change-Id: Ib6db9de92b3e6e196008580318a2139976610349
Split out some functions from the large find_affected_books function to
make the flow easier to understand.
Change-Id: I3fe34d01d0a7277db51ccf5fea0852cd86b59589
The internal references were not properly created. This patches make the
:ref: inline markup create a <xref> tag when the reference is internal.
This patch also reworks the sphinx extension to handle the URLs that
will be generated in the hot-reference with the new :ref: behavior.
Closes-Bug: #1378073
Change-Id: I84bf268dc1055dc6b39f23c4415734184ec57eec
We have git to track the authorship of files. It is not necessary to use
the @author tags in the copyright statements.
Change-Id: I550dbff940c32f030192ff1eea73ad40979b0a62
The renaming of the swift-conf-changes.xml in the openstack-manual
repository broke a test in the extract_swift_flags.py script. This patch
changes the test to make the script work again.
Change-Id: I71b6960801163c2d2c52253d0c9a45ec2bf02b0d
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
The autohelp glance hook can only work starting with Juno. So ignore
import errors for other versions.
Change-Id: I40570db1cc83ba651e1eb2ba47560a6dc757e326
Universal is used to identify pure-Python module(by bdist_wheel).
For these, it is sufficient to build a wheel with _any_ Python ABI
version and publish that to PyPI (by whatever means).
Change-Id: I83c09e2d2658280fd799675e9ef290841b2cd087
The backends configuration options are now in the glance_store package
and are loaded at runtime. This patch adds a hook that calls a
glance_store function to load the options.
Change-Id: Iefd49afd578f2b5fa9318d8ed8fb9f7a76d8ba34
The glance v2 commands need to be called as:
glance -os-image-api-version 2 CMD
Implement logic for this and enhance output.
Closes-Bug: #1367430
Change-Id: Ibc81d49494a203c9c8f469a2a0f93e4c1786af7e