tanimon / enhancd Goto Github PK

When enhancd takes a hyphen (-) string as an argument, it searchs from the last 10 directory items in the log. With it, you can search easily the directory you used last.

$ cd -
  /home/lisa/Dropbox/etc/dotfiles
  /home/lisa/Dropbox
  /home/lisa/src/github.com
  /home/lisa/src/github.com/b4b4r07/cli
  /home
  /home/lisa/src
  /home/lisa/src/github.com/b4b4r07/enhancd
  /home/lisa/src/github.com/b4b4r07/gotcha
  /home/lisa/src/github.com/b4b4r07
> /home/lisa/src/github.com/b4b4r07/portfolio
  10/10
> _	

Then, since the current directory will be delete from the candidate, you just press Enter key to return to the previous directory after type cd - ($PWD is /home/lisa, $OLDPWD is /home/lisa/src/github.com/b4b4r07/portfolio).

From the beginning, .. means the directory's parent directory, that is, the directory that contains it. When enhancd takes a double-dot (..) string as an argument, it behaves like a zsh-bd plugin. In short, you can jump back to a specific directory, without doing cd ../../...

For example, when you are in /home/lisa/src/github.com/b4b4r07/enhancd, type cd .. in your terminal:

$ cd ..
  /
  home
  lisa
  src
  github.com
> b4b4r07
  6/6
> _

When moving to the parent directory, the current directory is removed from the candidate.

The ENHANCD_DIR variable is a base directory path. It defaults to ~/.enhancd.

1. What is ENHANCD_FILTER?

   The ENHANCD_FILTER is an environment variable. It looks exactly like the PATH variable containing with many different filters such as peco concatenated using ':'.

2. How to set the ENHANCD_FILTER variable?

   Setting the ENHANCD_FILTER variable is exactly like setting the PATH variable. For example:

   $ export ENHANCD_FILTER="/usr/local/bin/peco:fzf:non-existing-filter"

   This above command will hold good till the session is closed. In order to make this change permanent, we need to put this command in the appropriate profile file. The ENHANCD_FILTER command in this example is set with 3 components: /usr/local/bin/peco followed by fzf and the not-existing-filter.

   enhancd narrows the ENHANCD_FILTER variable down to one. However, the command does not exist can not be the candidate.

   Let us try to test this ENHANCD_FILTER variable.

   $ cd

   If cd command does not return error, the settings of ENHANCD_FILTER is success.

3. How to find the value of the ENHANCD_FILTER variable?

   $ echo $ENHANCD_FILTER
   /usr/local/bin/peco:fzf:non-existing-filter

The ENHANCD_COMMAND environment variable is to change the command name of enhancd cd. It defaults to cd.

When the command name is changed, you should set new command name to ENHANCD_COMMAND, export it and restart your shell (reload init.sh).

$ echo $ENHANCD_COMMAND
cd
$ export ENHANCD_COMMAND=ecd
$ source /path/to/init.sh

The ENHANCD_COMMAND may only hold one command name. Thus, in the previous example, it is true that enhancd cd command name is ecd, but it is not cd (cd is turned into original builtin cd).

Besides putting a setting such as this one in your ~/.bash_profile or .zshenv would be a good idea:

ENHANCD_COMMAND=ecd; export ENHANCD_COMMAND

The ENHANCD_DOT_SHOW_FULLPATH environment variable is to set whether to show the full path or not when executing Double-dot. It defaults to 0.

$ export ENHANCD_DOT_SHOW_FULLPATH=1
$ cd ..
  /
  /home
  /home/lisa
  /home/lisa/src
  /home/lisa/src/github.com
> /home/lisa/src/github.com/b4b4r07
  6/6
> _

If you don't want to use the interactive filter, when specifing a double dot (..), you should set not zero value to $ENHANCD_DISABLE_DOT. Defaults to 0.

This option is similar to ENHANCD_DISABLE_DOT. Defaults to 0.

If you don't want to use the interactive filter when you call cd without an argument, you can set any value but 0 for $ENHANCD_DISABLE_HOME. Defaults to 0.

You can customize the double-dot (..) argument for enhancd by this environment variable.
Default is ...

If you set this variable any but .., it gives you the double-dot behavior with that argument; i.e. upward search of directory hierarchy. Then cd .. changes current directory to parent directory without interactive filter.

In other words, you can keep original cd .. behavior by this option.

You can customize the hyphen (-) argument for enhancd by this environment variable.
Default is -.

If you set this variable any but -, it gives you the hyphen behavior with that argument; i.e. backward search of directory-change history. Then cd - changes current directory to $OLDPWD without interactive filter.

In other words, you can keep original cd - behavior by this option.

You can customize the number of rows by "cd -" Default is 10.

This is passed to head comand as -n option.

You can customize to trigger the argumentless cd behavior by giving the string specified by this environment variable as an argument. Default is empty string.

If you set this variable any but empty string, it gives you the behavior of cd with no argument; i.e. backward search of the whole directory-change history. Then cd with no argument changes current directory to $HOME without interactive filter.

In other words, you can keep original behavior of cd with no argument by this option.

Default is empty. You can run any commands after changing directory with enhancd (e.g. ls: like cd && ls).

Default is 1 (enable). See #33.