You must have a conda installation before continuing. See Conda Intallation
Run the following command in your conda base environment (that is, you must 'deactivate' from any current environment different from 'base')
conda install ww
ww
will create new workspaces on a default location, but that location must exist. If one does not, you can either create it or tell ww
you want it to create workspaces on a different (and existent) location. The default location on Windows is the W:\
and on Linux is ~/w
.
To change the default location, set the environment variable WW_DEFAULT_PATH
:
Windows:
set WW_DEFAULT_PATH=<DIR>
Linux:
export WW_DEFAULT_PATH=<DIR>
workspace_name/
(Example: 1/)envs/
Projects/
tmp/
envs/ is used by conda to create local environment
tmp/ dir will override the common temp dir (%TMP% and %TEMP% global environment variables), so watch out for that (It shouldn't be a big deal).
Projects/ dir will contain your projects later.
Environment variables that can be previously defined (Suggestion: Define them as system variables)
WW_SHARED_DIR
: point to PATH of Shared used by aa. Default: D:\Shared
WW_PROJECTS_SUBDIR
: subdirectory of workspace where projects are clones. Default: Projects
WW_QUIET
: if defined, ww will not print normal messages (only error ones).
WW_CREATE
: if defined, ww will create every PATH it tries to access (but not the root one)
To create a workspace run:
ww -c <name>
Activating a workspace will change your current location to <workspace_default_location>/<workspace_name>/Projects
folder
On Windows
just run:
ww <workspace_name>
On Linux
you need to source
the workspace. Just run:
source ww <workspace_name>
cd <workspace-path> # Unlike Windows, in Linux you must CD into workspace manually.
It is also possible to activate a workspace from a subdir of a workspace root. If the cwd is at <workspace_name>/Projects/myproject for example, just run:
source ww .
To show detailed information about the current workspace:
ww