Per the comment on change 'If0cf66aa9', we no longer track swift config
files as part of openstack-manuals. As such, we can remove the special
casing for this project.
Change-Id: I135caa57e1dcdd4114033276d89fc87c28a71aac
I already have a (sizable) openstack-manuals repo cloned locally and it
would appear tox does not work in a nested repo. Provide a way to
override this option.
Change-Id: I4ef80825598cc7d98a4046afd5b131484e5a3469
Companies may have VPN, and in China, there is a firewall named
G.F.W., they both may block some protocols or ports, so if I run
autohelp-wrapper, it will fail like this:
/opt/stack/openstack-doc-tools/autogenerate_config_docs$ ./autohelp-wrapper update ceilometer
Cloning into '/opt/stack/openstack-doc-tools/autogenerate_config_docs/sources/openstack-manuals'...
fatal: unable to connect to git.openstack.org:
git.openstack.org[0: 104.130.246.128]: errno=Connection timed out
git.openstack.org[1: 2001:4800:7819:103:be76:4eff:fe06:63c]: errno=Network is unreachable
Now we have -g option, which can set GITPROJ, but GITBASE still
use git://git.openstack.org/openstack, so it still fail:
/opt/stack/openstack-doc-tools/autogenerate_config_docs$ ./autohelp-wrapper -g https://github.com/openstack update ceilometer
Here I proposal to use environment variable value for GITPROJ and
GITBASE if they exist, so some devs, like me, can get rid of
hacking autohelp-wrapper to work then restore it when commit.
Change-Id: If7dc3ebe398c71d6461a5983d4aab1bc87984697
Closes-Bug: #1574224
Changes to autohelp.py have broken the diff_branches.py script. This
patch fixes the script:
- add a ``dump`` subcommand and a ``-q`` (quiet) option to
autohelp-wrapprt
- use these options in diff_branches.py
- remove the dependency on python-git as it is not needed anymore.
Change-Id: I5d5a7e7141e1a0df1c86d52daae35fe5f33f239b
Modifying configuration options (ignored modules, extra repositories,
hooks) for autohelp requires an update of the doc-tools repository,
which doesn't make much sense since the goal is to update the manuals
repository.
This patch removes the configuration options from the repository and
updates the scripts to use the configuration items in openstack-manuals.
Change-Id: I630d2a2fea690f6360039aa100331678468d18dc
If the flagmappings file doesn't exist the function will create it,
with all the sections set to Unknown. This mimics the behavior of the
`create`, not needed anymore.
Change-Id: I7a920300b784aa8fca6412c292d807beb4d5c8e5
* Only keep the core projects (neutron and neutron-*aas)
* Fix the installation of addition packages
Change-Id: If98405b17fe94c428812047a406c21dcf54394c3
- wrapper: upgrade setuptools in the generated venvs
- swift: read from docbook on liberty
- swift: ignore :ref: directives
- swift: remove a bogus sys.exit(0)
Change-Id: If983da606e51f39c9e331aa27c3e3598abc695fe
As a workaround, networking-zvm can generate config reference
by directory copying to neutron tree in source directory.
This patch will be reverted after name space fixation
in networking-zvm.
currently name space header uses "neutron",
This causes conflict with neutron itself.
Change-Id: Ia86eabf8c982431dbf6af727373349d3c2add1a9
Related-Bug: #1503967
sorting
in requirements/neutron-master.txt
removing stackforge/networking-bigswitch
in requirements/neutron-master.txt
autohelp-wrapper (name space conversion)
Change-Id: I29d0465f03b21f31f76c2a81abc4db4e1ccc3e52
Related-Bug: #1503967
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
Item 1 in #1503967)
Add extra_repos/neutron-master for many plugins
Add extra_repos/neutron-master-stackforge for stackforge plugins
also edit autohelp-wrapper to handle stackforge url
Item 3 in #1503967)
Add object name re-mapping for
networking-midonet
networking-hyperv
networking-bigswitch
networking-edge-vpn
networking-zvm
on autohelp-wrapper
Change-Id: Ib247fed088446c79b7d9e6a9e1adbbc931108a3b
Partial-Bug: #1503967
This includes:
* update on requirements/neutron-kilo.txt
* update of autohelp-wrapper to make sure that dependencies are properly
installed
* update of diff_branches.py itself (to handle the multiple -i arguments passed
to autohelp.py
Change-Id: I099fba5d09a5e964c93d7e8c677d5556b4fa62eb
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
The autohelp_wrapper uses as git URL for the projects the URL
git://git.openstack.org/openstack. This is not configurable.
Because of that, the build of guides (e.g. the configuration
reference) based on local (not yet commited) branches was not
possible.
This change set offers a new parameter for the script to use
another URL for the projects (e.g. to a local one).
Example:
The command to build the config options table of a local nova branch
(with the name "docs_serial_console") which is in the local folder
"~/git" would look like this:
./autohelp-wrapper -g ~/git -b docs_serial_console docbook nova
Change-Id: I03e5491221ac03be596b243183bdeb98c63dd03e
The latest patches have broken the diff_branches script because we lost
compatibility with pre-kilo releases. This patch restores support for
juno.
Change-Id: I8b4067ca925fe4ef39d9853020f28b100054e2db
This patch moves the explicit dependencies for projects in their own
requirement file.
Install a bunch of new neutron dependencies (drivers moved to their own
dependencies).
Change-Id: I8cab9861a5546f270499f626b06e44ad0185477d
To make sure that projects don't import and expose configuration options
that belong to other project we now build a virtual environment for each
project.
The script execution takes more time but the result is more accurate.
Change-Id: Ied1524de7282bca560883c3503d36a86098309b8
Git doesn't clear folders containing untracked files when switching to
another branch. The autohelp script uses invalid .pyc files when such
switches happen in the diff_branches.py script. This change removes all
the .pyc files before a checkout to avoid this problem.
Change-Id: I0acd0308a3651b27d158546036de5cb0b42d974c
If the branch does not exist locally, create it properly.
Otherwise the script will abort with freshly checkout sources.
Change-Id: I05960ed862fa61f3c9435f6749d941128812887b
The shift should happen after the final processing, otherwise
getopts aborts if more than one parameter is given.
Change-Id: I47e9f390cfe08404e71b26c49b02871b3b34f303
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
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
This wrapper handles the setup of a virtual env, installs the
dependencies, clones the repositories and runs the autohelp.py script.
Change-Id: I7cc65b8d458dd62ef97c8f77c9a24812d7ace374