Bash directory traversal for easy navigation between directories.

During programming and system administration one should navigate between different and "far-away" directories. Typically you have two options to navigate from one place to another: use absolute path or relative starting where you are now.

But this is cumbersome if target directory is both very far from root and starting directory.

dirjumper tries to help in this situation.

Python 2

1. Put dirjumper to a directory which is on the search path (eg. ~/bin)
2. Add dirjumper.sh to your bash startup script or run ''source dirjumper.sh''. This will create dj command.

It provider three commands:

• dj to replace command cd
• ldj to replace command ls `dj...
• lldj to replace command ls -lat `dj...

Where dj... means the same parametrisation as dj.

All of these are commands rely on dirjumper They call dirjumper with dirjumper propose <params>

dirjumper <command name> <optional parameters>*

possible commands:

Prefix match algorithm:

• ? is a special prefix which means: return the shortest matching path
• if prefix ends with double colon than prefix should match a part of path, otherwise prefix should match to the beginning of a dirname of the path
• if more prefix is given, consecutive prefixes should match the path starting from the last match's subdirectory.

To start using dirjumper you should initialize dirjumper cache file with command

dirjumper init

This will create a file named .dirjumper.

Then in directories issue

dirjumper scan

After that you can navigate between scanned directories by using directory names along the scanned directory paths. For examples suppose you scanned ''/var'', then you can jump to ''/var/log/audit'' by typing ''dj var audit''. dj supports bash completion for directory names. If you add more than one directory name to dj then each prefix narrows the list of candidate directories to those of which path end with matching directory path plus their subdirectories.

If there are more than one candidate dj shows the options.

Dash has a special meaning as prefix: it will jump to the shortest matching candidate.

scanned directories (showed only leafs):
/root/aaa/bb/cc/dd
/root/aaa/bbb/cc/dd
/root/aaa/bbb/ccc/dd
/root/eee/bb/cc/dd
/root/eee/bbb/cc/dd
/root/eee/bbb/ccc/dd

dj dd -> shows 6 candidates
dj ccc -> shows 2 candidates
dd aaa ccc -> jumps to /root/aaa/bbb/ccc
dj dd - -> will jump to /root/aaa/bb/cc/dd 

Copyright © 2017 József Tiborcz

Distributed under the Apache 2.0 license. See the file LICENSE.