Importance

pls uses an importance system to both hide certain unimportant nodes as well as emphasize certain important ones.

Each node has a default importance of -1 if it starts with a leading dot, and 0 otherwise. This importance can be overridden using specs.

An importance scale maps importance levels to styling attributes. Any files with importance below the scale are hidden.

Arguments

--imp/-I can be used to set the baseline importance level. This affects the relative importance of all nodes. The default is 0. Setting a higher number will reduce the importance level of nodes and hide more of them.

At --imp=-2, a node with importance -2 behaves as it has an importance of 0, a node with importance -1 behaves as it has an importance of 1, and so on.

Caution

Filtering by importance is not applicable when listing a specific node.

Examples

pls --imp=-2 # or -I=-2

​  dir/
󰊢 .git/
 .github/
   file
  README.md
  src

pls --imp=-1 # or -I=-1

​  dir/
󰊢 .git/
 .github/
   file
  README.md
  src

pls # or --imp=0 or -I=0

​  dir/
 .github/
   file
  README.md
  src

pls --imp=1 # or -I=1

​  dir/
 file
  README.md
  src

pls --imp=2 # or -I=2

​  README.md
  src

pls --imp=2 file # `--imp` has no effect

​  file

Configuration

Using the configuration system, you can extend the importance scale to higher or lower levels and change the default styles applicable at each level.

.pls.yml

app_const:
  imp_styles:
    - [-2, "red"]
    - [-1, "yellow"]
    - [1, "green"]
    - [2, "bright_magenta"]

​  dir/
󰊢 .git/
 .github/
   file
 .pls.yml
  README.md
  src