wting_autojump

mirror of https://github.com/wting/autojump synced 2024-10-27 20:34:07 +00:00

Go to file

Ye c8125bb531 Fix inconsisent file indexing in find_matches When user applies tab completion and gets the list of possible paths to jump to, those paths contains the deleted/invalid ones. However, in the next stage, when the user selects an path index to jump to, autojump filters out the invalid paths and causes inconsistent indexing. This PR applies a simple fix to keep the invalid paths during the index-based jump. This way, user will go to the exact path s/he sees in the terminal.		2018-11-19 13:02:26 -08:00
bin	Fix inconsisent file indexing in find_matches	2018-11-19 13:02:26 -08:00
docs	Bump to 22.5.3.	2018-09-09 09:55:27 -07:00
tests	Add match consecutive tests.	2016-06-22 18:09:36 -07:00
tools	(Running pre-commit) Use Yelp-style indentation.	2017-07-19 23:18:29 -07:00
.gitattributes	(Running pre-commit) Run end of file fixer.	2017-07-19 23:13:18 -07:00
.gitignore	Ignore .pytest_cache/	2018-09-06 22:30:13 -07:00
.pre-commit-config.yaml	Fix flake8 ignore option.	2018-09-06 22:30:13 -07:00
.travis.yml	Add tox for testing with different Python versions.	2014-06-28 18:36:52 -07:00
AUTHORS	update authors list	2013-05-25 05:32:58 -07:00
CHANGES.md	Add minor documentation fixes.	2018-09-06 22:28:21 -07:00
install.py	(Running pre-commit) Use Yelp-style indentation.	2017-07-19 23:18:29 -07:00
LICENSE	Remove license from individual files, consolidate information into AUTHORS and LICENSE	2012-05-06 12:56:01 -10:00
Makefile	Automatically update manpage header when generating docs.	2018-09-06 22:50:30 -07:00
README.md	Clarify between first class and community supported items.	2018-09-06 23:27:46 -07:00
tox.ini	Add match consecutive tests.	2016-06-22 18:09:36 -07:00
uninstall.py	(Running pre-commit) Use Yelp-style indentation.	2017-07-19 23:18:29 -07:00

README.md

NAME

autojump - a faster way to navigate your filesystem

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.

Directories must be visited first before they can be jumped to.

USAGE

j is a convenience wrapper function around autojump. Any option that can be used with autojump can be used with j and vice versa.

Jump To A Directory That Contains foo:
```
j foo
```
Jump To A Child Directory:

Sometimes it's convenient to jump to a child directory (sub-directory of current directory) rather than typing out the full name.
```
jc bar
```
Open File Manager To Directories (instead of jumping):

Instead of jumping to a directory, you can open a file explorer window (Mac Finder, Windows Explorer, GNOME Nautilus, etc.) to the directory instead.
```
jo music
```
Opening a file manager to a child directory is also supported:
```
jco images
```
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 change directory to /home/user/work/inbox.

For more options refer to help:

autojump --help

INSTALLATION

REQUIREMENTS

Python v2.6+ or Python v3.3+
Supported shells
- bash - first class support
- zsh - first class support
- fish - community supported
- tcsh - community supported
- clink - community supported
Supported platforms
- Linux - first class support
- OS X - first class support
- Windows - community supported
- BSD - community supported
Supported installation methods
- source code - first class support
- Debian and derivatives - first class support
- ArchLinux / Gentoo / openSUSE / RedHat and derivatives - community supported
- Homebrew / MacPorts - community supported

Due to limited time and resources, only "first class support" items will be maintained by the primary committers. All "community supported" items will be updated based on pull requests submitted by the general public.

Please continue opening issues and providing feedback for community supported items since consolidating information helps other users troubleshoot and submit enhancements and fixes.

MANUAL

Grab a copy of autojump:

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

Run the installation script and follow on screen instructions.

cd autojump
./install.py or ./uninstall.py

AUTOMATIC

Linux

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

Debian, Ubuntu, Linux Mint

All Debian-derived distros require manual activation for policy reasons, please see /usr/share/doc/autojump/README.Debian.
RedHat, Fedora, CentOS

Install autojump-zsh for zsh, autojump-fish for fish, etc.
ArchLinux
Gentoo
Frugalware
Slackware

OS X

Homebrew is the recommended installation method for Mac OS X:

brew install autojump

MacPorts is also available:

port install autojump

Windows

Windows support is enabled by clink which should be installed prior to installing autojump.

KNOWN ISSUES

autojump does not support directories that begin with -.
For bash users, autojump keeps track of directories by modifying $PROMPT_COMMAND. Do not overwrite $PROMPT_COMMAND:
```
export PROMPT_COMMAND="history -a"
```
Instead append to the end of the existing $PROMPT_COMMAND:
```
export PROMPT_COMMAND="${PROMPT_COMMAND:+$PROMPT_COMMAND ;} history -a"
```

REPORTING BUGS

For any questions or issues please visit:

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

AUTHORS

autojump was originally written by Joël Schaerer, and currently maintained by William Ting. More contributors can be found in AUTHORS.

COPYRIGHT

Copyright © 2016 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.