This utility allows a user to create a new MAT distribution with
a new or updated task in it, based on an existing MAT
distribution.
This utility can only be run on Unix, due to its internal use of
Unix command-line operations. It will not work in Cygwin, since
MAT is no longer supported on Cygwin.
% python $MAT_PKG_HOME/build/redistribute.py
Usage: redistribute.py [ --remove_task <task_dir> ]+ [ --task_dir <dir>[:<cvs_version>[:<dist_settings>]] ]+ orig_dist_zip outdir bundle_name
| --task_dir
<dir>[:<cvs_version>[:<dist_settings>]] |
The directory containing a
well-structured MAT task, plus other possible control
options (see below). May be repeated. If there is already a
task directory in the existing distribution named
<dir>, it will be removed and replaced with this one. |
| --remove_task
<task_dir> |
The <task_dir> is a
directory within src/tasks in the zip file. May be repeated.
If you provide this argument, this directory, and the task
it corresponds to, will be removed from the output
distribution. |
| orig_dist_zip |
A path to the original MAT
zip file which you received |
| outdir |
The directory in which to
deposit the new distribution |
| bundle_name |
The name of the new
distribution (the actual zip file will be
<bundle_name>.zip, and the name of the toplevel
directory in the zip file will be bundle_name. |
The additional decorations to the --task_dir option are as
follows:
| <cvs_version> |
If you maintain the task you
want to add or update under CVS version control, this is the
CVS tag you want. This facility is not available for any
other version control system. If you provide this option,
the tool will check out this version from the CVS repository
using the CVS information in the task directory, rather than
using the code in the directory. |
| <dist_settings> |
A comma-separated sequence of
<key>=<val> settings, which are passed to the
distribute function in the dist.py file in your task, if
such a file and function exist. We provide this information
for completeness; we do not provide any further details as
of right now about how to customize your distribution using
this facility. See the source code for redistribute.py. |
Let's say you received the distribution
/my/downloads/MAT_2_0.zip, and you want to add the /path/to/myTask
directory, creating the distribution
/my/dist/MAT_2_0_plus_myTask.zip:
% python $MAT_PKG_HOME/build/redistribute.py --task_dir /path/to/myTask \
/my/downloads/MAT_2_0.zip /my/dist MAT_2_0_plus_myTask
Let's say you received /my/downloads/MAT_2_0_plus_myTask.zip, and
you want to remove myTask from the package you create:
% python $MAT_PKG_HOME/build/redistribute.py --remove_task myTask \
/my/downloads/MAT_2_0_plus_myTask.zip /my/dist MAT_2_0_without_myTask