ohmyzsh/lib/history.zsh

## History wrapper
function omz_history {
  local clear list
  zparseopts -E c=clear l=list

  if [[ -n "$clear" ]]; then
    # if -c provided, clobber the history file
    echo -n >| "$HISTFILE"
    echo >&2 History file deleted. Reload the session to see its effects.
  elif [[ -n "$list" ]]; then
    # if -l provided, run as if calling `fc' directly
    builtin fc "$@"
  else
    # unless a number is provided, show all history events (starting from 1)
    [[ ${@[-1]-} = *[0-9]* ]] && builtin fc -l "$@" || builtin fc -l "$@" 1
  fi
}

# Timestamp format
case ${HIST_STAMPS-} in
  "mm/dd/yyyy") alias history='omz_history -f' ;;
  "dd.mm.yyyy") alias history='omz_history -E' ;;
  "yyyy-mm-dd") alias history='omz_history -i' ;;
  "") alias history='omz_history' ;;
  *) alias history="omz_history -t '$HIST_STAMPS'" ;;
esac

## History file configuration
[ -z "$HISTFILE" ] && HISTFILE="$HOME/.zsh_history"
HISTSIZE=50000
SAVEHIST=10000

## History command configuration
setopt extended_history       # record timestamp of command in HISTFILE
setopt hist_expire_dups_first # delete duplicates first when HISTFILE size exceeds HISTSIZE
setopt hist_ignore_dups       # ignore duplicated commands history list
setopt hist_ignore_space      # ignore commands that start with space
setopt hist_verify            # show command with history expansion to user before running it
setopt share_history          # share command history data
Change history alias into a function This commit changes the history alias into a function which puts the passed arguments before `-l 1`. It also provides a temporary workaround to the lack of a `history -c` command in zsh. For more information see issues 739 and 789. 2014-06-16 03:08:04 +08:00			`## History wrapper`
			`function omz_history {`
lib: fix history wrapper when passing numbers If a number is passed without explicitly passing `-l`, it will now behave as if using the history builtin, instead of throwing an error. 2018-09-16 04:56:12 +08:00			`local clear list`
Use zparseopts to get passed arguments 2014-12-19 04:56:49 +08:00			`zparseopts -E c=clear l=list`

			`if [[ -n "$clear" ]]; then`
			`# if -c provided, clobber the history file`
Change history alias into a function This commit changes the history alias into a function which puts the passed arguments before `-l 1`. It also provides a temporary workaround to the lack of a `history -c` command in zsh. For more information see issues 739 and 789. 2014-06-16 03:08:04 +08:00			`echo -n >\| "$HISTFILE"`
			`echo >&2 History file deleted. Reload the session to see its effects.`
Use zparseopts to get passed arguments 2014-12-19 04:56:49 +08:00			`elif [[ -n "$list" ]]; then`
			# if -l provided, run as if calling `fc' directly
Allow overriding -l flag in history 2014-12-19 03:36:56 +08:00			`builtin fc "$@"`
Change history alias into a function This commit changes the history alias into a function which puts the passed arguments before `-l 1`. It also provides a temporary workaround to the lack of a `history -c` command in zsh. For more information see issues 739 and 789. 2014-06-16 03:08:04 +08:00			`else`
lib: fix history wrapper when passing numbers If a number is passed without explicitly passing `-l`, it will now behave as if using the history builtin, instead of throwing an error. 2018-09-16 04:56:12 +08:00			`# unless a number is provided, show all history events (starting from 1)`
lib: fix issues with nounset and parameters used before defined (#7433) 2019-04-09 18:58:45 +08:00			`[[ ${@[-1]-} = [0-9] ]] && builtin fc -l "$@" \|\| builtin fc -l "$@" 1`
Change history alias into a function This commit changes the history alias into a function which puts the passed arguments before `-l 1`. It also provides a temporary workaround to the lack of a `history -c` command in zsh. For more information see issues 739 and 789. 2014-06-16 03:08:04 +08:00			`fi`
			`}`

			`# Timestamp format`
lib: fix issues with nounset and parameters used before defined (#7433) 2019-04-09 18:58:45 +08:00			`case ${HIST_STAMPS-} in`
Change history alias into a function This commit changes the history alias into a function which puts the passed arguments before `-l 1`. It also provides a temporary workaround to the lack of a `history -c` command in zsh. For more information see issues 739 and 789. 2014-06-16 03:08:04 +08:00			`"mm/dd/yyyy") alias history='omz_history -f' ;;`
			`"dd.mm.yyyy") alias history='omz_history -E' ;;`
			`"yyyy-mm-dd") alias history='omz_history -i' ;;`
Add support for custom timestamp format in history (#6770) 2018-07-13 19:14:15 +08:00			`"") alias history='omz_history' ;;`
			`*) alias history="omz_history -t '$HIST_STAMPS'" ;;`
Refactors history alias and moves it. More compact case statement instead of the ugly if elif... else statement. Moves it to history.zsh 2014-01-11 06:50:19 +08:00			`esac`

Organize history.zsh file and improve comments 2014-12-14 06:31:56 +08:00			`## History file configuration`
			`[ -z "$HISTFILE" ] && HISTFILE="$HOME/.zsh_history"`
Increment HISTSIZE to fix hist_expire_dups_first This fixes the old behavior which made it so all duplicates would be deleted if the command history filled up with unique events. > You should be sure to set the value of HISTSIZE to a larger number > than SAVEHIST in order to give you some room for the duplicated > events, otherwise this option will behave just like HIST_IGNORE_ALL_DUPS > once the history fills up with unique events. 2018-04-22 21:26:57 +08:00			`HISTSIZE=50000`
Organize history.zsh file and improve comments 2014-12-14 06:31:56 +08:00			`SAVEHIST=10000`

			`## History command configuration`
			`setopt extended_history # record timestamp of command in HISTFILE`
			`setopt hist_expire_dups_first # delete duplicates first when HISTFILE size exceeds HISTSIZE`
			`setopt hist_ignore_dups # ignore duplicated commands history list`
			`setopt hist_ignore_space # ignore commands that start with space`
			`setopt hist_verify # show command with history expansion to user before running it`
			`setopt share_history # share command history data`