skip to navigation
skip to content

wstool_cd 0.16

Tool to change directory in workspace managed by wstool

cd to repositories in workspace which is managed by vcstools/wstool.


install via pypi:

$ pip install wstool_cd

add following to your .bashrc or .zshrc:

source `which`


maybe this alias is good:

$ alias wlcd='wstool_cd'

in workspace which is managed by wstool:

$ wstool_cd  # cd to workspace's root
$ wstool_cd repo0  # cd to a repo0

you can set WSTOOL_DEFAULT_WORKSPACE to cd from anywhere:

$ export WSTOOL_DEFAULT_WORKSPACE=$HOME/ros/indigo/src
$ pwd  # not in workspace
$ wstool_cd ros_comm && pwd # if actually not in workspace, cd to default workspace


this is sometimes dangerous, but useful:

$ source `which`
$ wstool cd repo0  # use cd as sub-command of wstool

this works because:

wstool () {
  case "$1" in
    (cd) shift
     wstool_cd $@ ;;
    (*) command wstool $@ ;;


This is demo of using wstool_cd:


Copyright (C) 2015 Kentaro Wada
Released under the MIT license
File Type Py Version Uploaded on Size
wstool_cd-0.16.tar.gz (md5) Source 2015-09-24 3KB