|Ned Batchelder : Blog | Code | Text | Site|
» Home : Code : Shell Utils
Created 31 May 2002
I use the command line to do a lot of work instead of using GUI tools, because I find typing faster than clicking, and because I can extend my command line with simple scripts more easily than I can create new GUI tools. But I like to type as little as possible, both for speed and to reduce the strain on my poor hands and wrists.
Working with large projects from the command line means changing directories a lot. I like tab-completion, because it saves me typing, but there's a problem with it: it's stupid. It will only consider file names right in front of its face.
Let's say I have this directory structure:
To get from the top to the util directory using cd, I would type
Why do I have to keep track of all the intermediate levels? With a tree like this (and real ones have more noise between where you are and where you want to go), I don't think in terms of each level in the tree, I think "I want to go to the util directory".
xdir is a replacement for cd that works like tab completion, but with more intelligence. In our example above, I could have typed
To xdir, all directory names are prefixes of directory names, as if tab completion were being applied, but without having to type the tab. Also notice I didn't have to worry about the two directories starting with 's'. In the tab completion example, I had to type two tabs to get it to choose 'stellated' rather than 'sarai'. In the xdir example, it knew I meant 'stellated' because there is no directory starting with 'u' under the 'sarai' directory. The entire string 'd\c\s\u' is unambiguous.
Even better, I could have typed
This means "change to a subdirectory named ut* anywhere below me". In this case, there is only one, so xdir knows what to do, and takes me there. This exactly matches my mental model of the tree, and keeps me from having to worry about intermediate levels at all.Download: xdir.py
xdir performs a number of functions relating to moving among directories. The first argument to xdir is the operation to perform:
When specifying a new directory (for 'cd' or 'push'), the arguments work as follows:
In the argument list, spaces and slashes are equivalent. These both do the same thing:
If the arguments are ambiguous (because they specify more than one destination directory), the list of possible destinations are printed and the directory is not changed. You can add a last argument of .3 (for example) to choose the third choice in the list, or .-1 (for example) to choose the last choice in the list.
Unfortunately, a python script (or any executed program) cannot change the directory in the command window. So xdir.py actually writes DOS commands to stdout, and a separate helper, xdir.cmd, collects those commands and executes them as a shell script.
To reduce typing, the script can be supported by shell aliases (in Windows, doskey macros). I use these: