# eza plugin

This provides aliases that invoke the [`eza`](https://github.com/eza-community/eza) utility rather than `ls`

To use it add `eza` to the plugins array in your zshrc file:

```zsh
plugins=(... eza)
```

## Configuration

All configurations are done using the `zstyle` command in the `:omz:plugins:eza` namespace.

**NOTE:** The configuring needs to be done prior to OMZ loading the plugins. When the plugin is loaded, changing the `zstyle` won't have any effect.

### `dirs-first`

```zsh
zstyle ':omz:plugins:eza' 'dirs-first' $BOOL
```

If `true`, directories will be grouped first.

Default: `false`


### `git-status`

```zsh
zstyle ':omz:plugins:eza' 'git-status' $BOOL
```

If `true`, always add `--git` flag to indicate git status (if tracked / in a git repo).

Default: `false`


### `header`

```zsh
zstyle ':omz:plugins:eza' 'header' $BOOL
```

If `true`, always add `-h` flag to add a header row for each column.

Default: `false`


### `showgroup`

```zsh
zstyle ':omz:plugins:eza' 'showgroup' $BOOL
```

If `true` (default), always add `-g` flag to show the group ownership.

Default: `true`


### `size-prefix`

```zsh
zstyle ':omz:plugins:eza' 'size-prefix' ('binary'|'none'|'si')
```

Choose the prefix to be used in displaying file size:

* `binary` -- use [binary prefixes](https://en.wikipedia.org/wiki/Binary_prefix) such as "Ki", "Mi", "Gi" and so on
* `none` -- don't use any prefix, show size in bytes
* `si` (default) -- use [Metric/S.I. prefixes](https://en.wikipedia.org/wiki/Metric_prefix)

Default: `si`


### `time-style`

```zsh
zstyle ':omz:plugins:eza' 'time-style' $TIME_STYLE
```

Sets the `--time-style` option of `eza`. (See `man eza` for the options)

Default: Not set, which means the default behavior of `eza` will take place.


## Aliases

Note that aliases may be modified by Configuration.


| Alias   | Command           | Description                                                                 |
| ------- | ----------------- | --------------------------------------------------------------------------- |
| `la`    | `eza -la`         | List all files (except . and ..) as a long list                             |
| `ldot`  | `eza -ld .*`      | List all dotfiles (directories shown as entries instead of recursed into)   |
| `ll`    | `eza -l`          | List files as a long list                                                   |
| `ls`    | `eza`             | Plain eza call                                                              |
| `lS`    | `eza -l -ssize`   | List files as a long list, sorted by size                                   |
| `lT`    | `eza -l -snewest` | List files as a long list, sorted by date (newest last)                     |