Quick Start¶
terrarium [options] COMMAND [requirements files...]
See terrarium --help
for a complete list of options and commands.
Creating a new environment¶
The following example will create a new virtual environment named env
that
includes the packages defined in requirements.txt
$ terrarium --target env install requirements.txt
Replacing an existing environment¶
The following example demonstrates how terrarium can be used to replace an existing activated virtual environment with a different set of packages.
$ terrarium --target env install requirements.txt
$ source env/bin/activate
$ terrarium install other_requirements.txt
Note
The environment that was replaced is renamed to env.bak
,
and can be restored using terrarium revert
.
Note
After installing the other_requirements
,
it is not necessary to run deactivate
or activate
to begin using the new environment.