z3c.repoexternals 0.3

Generate externals from a repository

Use the --help option for usage details:

usage: repoexternals [options] url_or_path

Recursively retrieves subversion directory listings from the url or path and matches directories against a previous set of svn:externals if provided then against regular expressions and generates qualifying svn:externals lines. The defaults generate a set of svn:externals for all the trunks in a repository and keeps them up to date with the repository as new trunks are added when the previous externals are provided thereafter.

options: -h, --help show this help message and exit -v, --verbose Output logging to standard error. Set twice to log debugging messages. -p FILE, --previous=FILE If provided, only URLs in the repository not included in the previous externals will be included. If the filename is '-', use standard input. Valid svn:externals lines beginning with one comment character, '#', will also affect output. This is useful, for example, to prevent lengthy recursions into directories that are known not to contain any desired matches. The file is read completely and closed before anything is output, so it is safe to append output to the previous file: "repoexternals -p EXTERNALS.txt http://svn.foo.org/repos/main >>EXTERNALS.txt". -i REGEXP, --include=REGEXP Directory names matching this python regular expression will be included in output and will not be descended into. [default: (?i)^((.*)/.+?|.*)/trunk$] -e REGEXP, --exclude=REGEXP Directory names matching this python regular expression will be excluded from output and will not be descended into. Include overrides exclude. [default: (?i)^.*/(branch(es)?|tags?|releases?|vendor|bundles?|sandbox|build|dist)$] -m TEMPLATE, --matched-template=TEMPLATE The result of expanding previous file URL matches with the include regular expression through this template is added to the set of previous URLs excluded from output and descending. The default will add the parents of trunks to the set of previous URLs excluded. [default: 1] -t TEMPLATE, --parent-template=TEMPLATE The result of expanding previous file URL matches with the include regular expression through this template is removed from the set of matched previous URLs excluded from output and descending. The default ensures that directories containing trunks within a directory that contains a trunk are not excluded. [default: 2] -d INT, --depth=INT The maximum directory depth to descend to. WARNING: large values can greatly increase run time. [default: 5] -s INT, --pool-size=INT The number of concurrent svn clients. WARNING: large values can DOS the repository. [default: 5]

The source distribution is also a zc.buildout that installs the script locally for use without affecting the system python installation:

$ easy_install --editable --build-directory=foo z3c.repoexternals
$ cd foo
$ python bootstrap/bootstrap.py -v
$ ./bin/buildout -v
$ ./bin/repoexternals --help