Archives/wting_autojump
1
0
Fork 0
mirror of https://github.com/wting/autojump synced 2024-10-27 20:34:07 +00:00
Code Issues Releases Wiki Activity
405 Commits 2 Branches 53 Tags 1.6 MiB
Python 90.9%
Shell 6.6%
Makefile 1.1%
Batchfile 0.8%
Lua 0.6%
4382116b55
Go to file
Daniel Hahler 4382116b55 Vendorize argparse 
This adds the argparse library [1] as autojump_argparse and imports it
via sys.path mangling in case argparse does not exist (Python 2.6 or
below without argparse installed).

This makes autojump effectively work with Python 2.6 again by default.

I have not verified license compatibility, but given the intention of
the (backport) project this is likely OK (it is licensed under the
Python license).

1: http://code.google.com/p/argparse/

Fixes issue #121.
2012-09-26 22:04:45 +02:00
bin Vendorize argparse 2012-09-26 22:04:45 +02:00
docs Remove loading compinit module from autojump.zsh. 2012-07-02 17:36:27 -10:00
tests Remove database migration code support for v17 and older. 2012-06-23 13:21:24 -10:00
tools add purge option to clear database of missing entries 2012-05-06 20:50:40 -10:00
.gitignore tweak docs regarding minimum requirements 2012-05-08 09:18:43 -10:00
AUTHORS Add name(s) to AUTHORS 2012-05-12 03:22:41 -10:00
ChangeLog merging rc branch 2012-07-02 17:46:01 -10:00
install.sh Vendorize argparse 2012-09-26 22:04:45 +02:00
LICENSE Remove license from individual files, consolidate information into AUTHORS and LICENSE 2012-05-06 12:56:01 -10:00
Makefile tweak release target to build docs and test first 2012-05-28 09:18:28 -10:00
README.md Remove loading compinit module from autojump.zsh. 2012-07-02 17:36:27 -10:00
uninstall.sh Remove license from individual files, consolidate information into AUTHORS and LICENSE 2012-05-06 12:56:01 -10:00

README.md

NAME

autojump - a faster way to navigate your filesystem

SYNOPSIS

Jump to a previously visited directory 'foobar':

j foo

Show all database entries and their respective key weights:

j --stat

DESCRIPTION

autojump is a faster way to navigate your filesystem. It works by maintaining a database of the directories you use the most from the command line. The j --stat command shows you the current contents of the database. Directories must be visited first before they can be jumped to.

INSTALLATION

REQUIREMENTS

  • Python v2.7, 3.0, or 2.6 with argparse
  • Bash v4.0 for tab completion

If you are unable to update Python to a supported version, older versions of autojump can be downloaded and installed manually.

AUTOMATIC INSTALLATION

Linux

autojump is included in the following distro repositories, please use relevant package management utilities to install (e.g. yum, apt-get, etc):

  • Debian* testing/unstable, Ubuntu, Linux Mint
  • RedHat, Fedora, CentOS
  • ArchLinux
  • Gentoo
  • Frugalware
  • Slackware

* Requires manual activation for policy reasons, please see /usr/share/doc/autojump/README.Debian.

Mac

Homebrew is the recommended installation method for Mac OS X:

brew install autojump

MacPorts also available:

port install autojump

Other

Please check the Wiki for an up to date listing of installation methods.

MANUAL INSTALLATION

Grab a copy of autojump:

git clone git://github.com/joelthelion/autojump.git

Run the installation script:

cd autojump
./install.sh [ --local ] [ --zsh ]

and follow on screen instructions.

MANUAL UNINSTALLATION

It is recommended to use your distribution's relevant package management utilities, unless you installed manually or ran into uninstallation issues.

Grab a copy of autojump:

git clone git://github.com/joelthelion/autojump.git

Run the uninstallation script:

cd autojump
./uninstall.sh

and follow on screen instructions.

If you keep getting autojump: command not found at the prompt, do:unset PROMPT_COMMAND. You can also restart your shell.

DEVELOPMENT

The source code is primarily in ./bin/autojump. Various shell wrapper scripts are also available in ./bin/.

Documentation is in various files under ./docs/. Build documentation with the command:

make docs

Unit tests are available in ./tests/. Run unit tests with the command:

make test

OPTIONS

Options must be passed to 'autojump' and not the 'j' wrapper function.

-a, --add DIR       manually add path to database

--purge             deletes database entries that no longer exist on system

-s, --stat              show database entries and their key weights

--version           show version information and exit

INTERNAL OPTIONS

-b, --bash          enclose directory with quotes to prevent errors

--complete          used for tab completion

ADDITIONAL CONFIGURATION

  • Enable ZSH Tab Completion

    ZSH tab completion requires the compinit module to be loaded. Please add the following line to your ~/.zshrc:

    autoload -U compinit; compinit

  • Always Ignore Case

    Default behavior is to prioritize exact matches over all else. For example, j foo will prefer /foobar over /FooBar even if the latter has a higher weight. To change this behavior and ignore case, add the following environmental variable in your ~/.bashrc:

    export AUTOJUMP_IGNORE_CASE=1

  • Prevent Database Entries' Decay

    Default behavior is to decay unused database entries slowly over time. Eventually when database limits are hit and maintenance is run, autojump will purge older less used entries. To prevent decay, add the following variable in your ~/.bashrc:

    export AUTOJUMP_KEEP_ALL_ENTRIES=1

  • Prefer Symbolic Links

    Default behavior is to evaluate symbolic links into full paths as to reduce duplicate entries in the database. However, some users prefer a shorter working directory path in their shell prompt. To switch behavior to prefer symbolic links, add the following environmental variable in your ~/.bashrc:

    export AUTOJUMP_KEEP_SYMLINKS=1

ADVANCED USAGE

  • Using Multiple Arguments

    Let's assume the following database:

    30   /home/user/mail/inbox
10   /home/user/work/inbox

    j in would jump into /home/user/mail/inbox as the higher weighted entry. However you can pass multiple arguments to autojump to prefer a different entry. In the above example, j w in would then jump you into /home/user/work/inbox.

  • ZSH Tab Completion

    Tab completion requires two tabs before autojump will display the completion menu. However if setopt nolistambiguous is enabled, then only one tab is required.

  • Change Directory Weight

    To manually change a directory's key weight, you can edit the file $XDG_DATA_HOME/autojump/autojump.txt. Each entry has two columns. The first is the key weight and the second is the path:

    29.3383211216   /home/user/downloads

    All negative key weights are purged automatically.

KNOWN ISSUES

  • The jump function j does not support directories that begin with -. If you want to jump a directory called --music, try using j music instead of j --music.

  • jumpapplet (bug #59)

    Does not work in Gnome 3 shell or LDXE.

FILES

If installed locally, autojump is self-contained in ~/.autojump/.

The database is stored in $XDG_DATA_HOME/autojump/autojump.txt.

REPORTING BUGS

For any usage related issues or feature requests please visit:

https://github.com/joelthelion/autojump/issues

MAILING LIST

For release announcements and development related discussion please visit:

https://groups.google.com/forum/?fromgroups#!forum/autojump

THANKS

Special thanks goes out to: Pierre Gueth, Simon Marache-Francisco, Daniel Jackoway, and many others.

AUTHORS

autojump was originally written by Joël Schaerer, and currently maintained by William Ting.

COPYRIGHT

Copyright © 2012 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.