Skip to main content

Tool to change directory in workspace managed by wstool

Project description

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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for wstool_cd, version 0.16
Filename, size File type Python version Upload date Hashes
Filename, size wstool_cd-0.16.tar.gz (3.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page