requirements/tools
Tony Breeds 351b878093 tools: Simplify grep_all.sh
Branches and tags are really just refs in git so rather than
open-codeing that and having 2 for loops just call everything a ref.

While we're there sort tags in reverse order this has the cosmetic
advantage that series are chronological order ie:

    1.1.0-1215-g8dc48120  : openstackdocstheme===1.18.1
    origin/master         : openstackdocstheme===1.18.1
    origin/stable/newton  : openstackdocstheme===1.5.0
    origin/stable/ocata   : openstackdocstheme===1.6.1
    origin/stable/pike    : openstackdocstheme===1.16.1
    folsom-eol            :
    grizzly-eol           :
    havana-eol            :
    icehouse-eol          :
    juno-eol              :
    kilo-eol              : openstackdocstheme===1.1.0
    liberty-eol           : openstackdocstheme===1.2.6
    mitaka-eol            : openstackdocstheme===1.3.0
becomes:
    1.1.0-1215-g8dc48120  : openstackdocstheme===1.18.1
    origin/master         : openstackdocstheme===1.18.1
    origin/stable/newton  : openstackdocstheme===1.5.0
    origin/stable/ocata   : openstackdocstheme===1.6.1
    origin/stable/pike    : openstackdocstheme===1.16.1
    mitaka-eol            : openstackdocstheme===1.3.0
    liberty-eol           : openstackdocstheme===1.2.6
    kilo-eol              : openstackdocstheme===1.1.0
    juno-eol              :
    icehouse-eol          :
    havana-eol            :
    grizzly-eol           :
    folsom-eol            :

Change-Id: If32cb11f1bcd3aefdc3717d3e943b0fa15a42002
2018-01-24 16:07:20 +11:00
..
README.txt [tools] Add a tool to grep local repos 2018-01-10 11:59:08 +11:00
babel-test.sh Babel Integration tests 2016-04-24 17:21:18 -05:00
build_wheels.sh Add a bashate tox environment and address errors 2017-09-28 12:09:04 +10:00
cap.py Fix "wrap functions with 2 blank lines" pep8 check 2016-11-16 18:52:03 +08:00
check-install.py Fix "wrap functions with 2 blank lines" pep8 check 2016-11-16 18:52:03 +08:00
code-search.sh [tools] Add a tool to grep local repos 2018-01-10 11:59:08 +11:00
cruft.sh Handle doc/requirements.txt 2017-11-23 20:09:01 +01:00
grep-all.sh tools: Simplify grep_all.sh 2018-01-24 16:07:20 +11:00
integration.sh Use python3 to calculate freezes 2016-09-06 03:34:23 +00:00
noop-change.sh [tools] Add a tool to make a no-op change 2017-10-12 13:42:59 +11:00
publish_constraints.sh Add a bashate tox environment and address errors 2017-09-28 12:09:04 +10:00
what-broke.py Fix typo in what-broke.py 2016-12-19 07:13:35 +00:00

README.txt

OpenStack Requirements tools.

This directory contains a number of tools that are useful to the requirements core team and OpenStack
developers.

babel-test.sh
-------------
A tool check for regressions with new Babel releases.

build_wheels.sh
---------------

Generate wheels for all of the requirements, ignoring any packages
that won't build wheels so we get as many as possible. This is meant
to be used on a development box combined with devpi and a wheelhouse
configuration setting for pip, such as described in
https://www.berrange.com/posts/2014/11/14/faster-rebuilds-for-python-virtualenv-trees/

cap.py
------

Take the output of 'pip freeze' and use the installed versions to caps requirements.

check-install.py
----------------

Used in tox environment pip-install.  Only installs requirements (as opposed to
test-requirements and verifies that all console-scripts have all modules
needed.

code-search.sh
--------------
Assuming you have a set of local git repos grep them all for interesting things.

cruft.sh
--------

This script, when run from the root directory of this repository, will search
the default and feature branches of all projects listed in the projects.txt
file for declared dependencies, then output a list of any entries in the
global-requirements.txt file which are not actual dependencies of those
projects. Old dependencies which were removed from projects or which were used
only for projects which have since been removed should be cleaned up, but many
entries likely represent recent additions which still have pending changes to
add them to one or more projects. In most cases, git pickaxe will yield the
answer.

grep-all.sh
-----------

List a requirements specification and constratint for a given libarary

integration.sh
--------------

Used in the gate!  Install all the "$PROJECTS" to verify that g-r and the each project are compatible

noop-change.sh
--------------

Generate a bulk no-op changes in supplied projects.  Useful if we have a risky
change in global-requirements or upper-constraints and we want to test impacted
projects.

publish_constraints.sh
----------------------
Used in the gate!  Generate the constraints files from git for publishing to a
static server.

what-broke.py
-------------
figure out what requirements change likely broke us.