z-shell / zsh-eza

⚙️ Zsh plugin to replace command gnu/ls with eza-community/eza

❮ Zsh eza ❯ Zsh plugin which replace GNU/ls with eza-community/eza 《❔》Ask a Question 《💡》Search Wiki 《💜》Join 《🌐》Localize

Default settings

Sets paramters and aliases for eza to replace ls, enable auto list directories on cd with export AUTOCD=1.

Parameters

eza_params=('--git' '--icons' '--classify' '--group-directories-first' '--time-style=long-iso' '--group' '--color-scale')

Aliases

alias ls='eza $eza_params'
alias l='eza --git-ignore $eza_params'
alias ll='eza --all --header --long $eza_params'
alias llm='eza --all --header --long --sort=modified $eza_params'
alias la='eza -lbhHigUmuSa'
alias lx='eza -lbhHigUmuSa@'
alias lt='eza --tree $eza_params'
alias tree='eza --tree $eza_params'

Install

The eza should be present to use this plugin. Install eza with Zi:

zi ice from'gh-r' as'program' sbin'**/eza -> eza' atclone'cp -vf completions/eza.zsh _eza'
zi light eza-community/eza

With Zi

To install add to the .zshrc file:

zi light z-shell/zsh-eza

Install only if eza exists and enable auto list directories:

zi ice has'eza' atinit'AUTOCD=1'
zi light z-shell/zsh-eza

Install only if eza exists and enable auto list directories in turbo mode:

zi ice wait lucid has'eza' atinit'AUTOCD=1'
zi light z-shell/zsh-eza

Install only if eza exists and enable auto list directories in turbo mode with the for syntax:

zi wait lucid for \
  has'eza' atinit'AUTOCD=1' \
    z-shell/zsh-eza

With Oh My Zsh

Clone the repository and add zsh-eza to the plugins array of your zshrc file:

~/.oh-my-zsh/custom/plugins

plugins=(... zsh-eza)

With Zplug

Add zplug z-shell/zsh-eza to your ~/.zshrc and re-open your terminal session.

zsh-eza's Issues

[bug]: Adding zsh-eza without eza installed prevents zsh startup

Environment

Ubuntu 23.10

Reproduction steps

1. Do not install eza yet.
2. Add z-shell/zsh-eza to your zsh plugins. For example, with antidode: `echo "z-shell/zsh-eza" >> .zsh_plugins.txt`
3. Run zsh

Expected behavior

4. zsh-eza prints an error message, but leaves zsh running

Current behavior

4. zsh-eza prints an error message and zsh exits

Code snippet

# .zshrc
source $HOME/dotfiles-packages/antidote/antidote.zsh
antidote load $HOME/.zsh_plugins.txt

# .zsh_plugins.txt
z-shell/zsh-eza

Additional information

If exec zsh is used in step 3 above in a login shell or over ssh, this will quit the shell and prevent login/ssh without working around a user's default shell.

Self-service

• I'd be willing to address this documentation request myself.

Have you read the Contributing Guidelines?

• I have read the Contributing Guidelines.

Are you familiar with the Contributor Covenant Code of Conduct?

• I have read the Contributor Covenant Code of Conduct.

Contact Details

No response