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

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page