@sebastienrousseau/dotfiles 0.2.468 → 0.2.469

package/dist/lib/aliases/list/README.md

@@ -3,40 +3,129 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 
 ![Dotfiles banner][banner]
 
+---
+
 ## 🅻🅸🆂🆃 🅰🅻🅸🅰🆂🅴🆂
 
-This code provides a set of aliases for listing files.
-
-- `l` List files with size, show type, human readable.
-- `l1` Display one file per line.
-- `la` List all files, show type, human readable.
-- `labc` List all files in alphabetical order.
-- `ldir` List directories only.
-- `ldot` List hidden files.
-- `left` List files by date, most recent last.
-- `lf` List files only.
-- `lk` Sort by size, largest first.
-- `lla` List full path of all files in current directory.
-- `locale` List all available locales.
-- `lp` List all open ports.
-- `lr` Recursive list, show type, human readable.
-- `ls` Colorize the output.
-- `lS` Order files by size, largest first.
-- `lt` List contents of directories in a tree-like format.
-- `lx` Sort by extension.
-- `lz` Sort by size, smallest first.
-- `right` List files by date, most recent first.
+This script defines a set of aliases for enhanced file listing using `eza`, or
+falls back to `ls` if `eza` is not installed. These aliases provide intuitive
+shortcuts for various listing styles and sorting options.
+
+### **Aliases Overview**
+
+- **`ls`**  
+  Replaces the standard `ls` command with `eza`. If `eza` is not available,
+  falls back to the standard `ls`.
+
+- **`l`**  
+  Mirrors the behavior of `ls` or `eza`, ensuring consistent usage.
+
+- **`ll`**  
+  Lists files in a long format, including hidden files (`--long -a`).
+
+- **`llm`**  
+  Lists files in long format, including hidden files, sorted by modification
+  date (`--long -a --sort=modified`).
+
+- **`la`**  
+  Lists all files, including hidden ones, with directories listed
+  first (`-a --group-directories-first`).
+
+- **`lx`**  
+  Lists all files and displays extended attributes, with directories listed
+  first (`-a --group-directories-first --extended`).
+
+- **`tree`**  
+  Displays a directory tree using `eza --tree`. If `eza` is unavailable,
+  falls back to the `tree` command or `ls -R`.
+
+- **`lS`**  
+  Lists files one entry per line (`--oneline`).
+
+---
+
+### **Installation**
+
+1. Clone this repository:
+
+   ```bash
+   git clone https://github.com/sebastienrousseau/dotfiles.git
+   ```
+
+2. Source the `list.sh` script in your shell configuration:
+
+   ```bash
+   echo 'source /path/to/dotfiles/list.sh' >> ~/.bashrc
+   source ~/.bashrc
+   ```
+
+---
+
+### **Usage Examples**
+
+Here are examples of how you can use the aliases:
+
+- **Basic Listing**:
+
+  ```bash
+  ls    # Basic file listing (uses eza if available)
+  l     # Same as ls
+  ```
+
+- **Detailed Listing**:
+
+  ```bash
+  ll    # Long format with hidden files
+  llm   # Long format, sorted by modification date
+  ```
+
+- **Specialized Listings**:
+
+  ```bash
+  la    # Show all files, directories first
+  lx    # Show extended attributes, directories first
+  lS    # One entry per line
+  ```
+
+- **Tree View**:
+
+  ```bash
+  tree  # Show directory structure as a tree
+  ```
+
+---
+
+### **Fallback Behavior**
+
+If `eza` is not installed, the script automatically falls back to
+standard `ls` with equivalent options where possible. For example:
+
+- **`ls` and `l`**: Use standard `ls` if `eza` is unavailable.
+- **`tree`**: Falls back to `tree` if installed, or `ls -R` otherwise.
+
+---
+
+### **Customization**
+
+You can adjust the aliases or add additional ones in the `list.sh` script.
+For example, modify the default `tree` depth by editing:
+
+```bash
+alias tree='eza --tree --level=2'
+```
+
+---
 
 [banner]: https://kura.pro/dotfiles/v2/images/titles/title-dotfiles.svg

package/dist/lib/aliases/list/list.aliases.sh

@@ -1,86 +1,132 @@
 #!/usr/bin/env bash
-
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂
+# Script: list.sh
+# Version: 0.2.469
+# Author: Sebastien Rousseau (@wwdseb)
 # License: MIT
-
-# 🅻🅸🆂🆃 🅰🅻🅸🅰🆂🅴🆂
-
-# List hidden files.
-alias 'l.'='ls -dlhF .* | grep -v "^d"'
-
-# Size, show type, human readable.
-alias l='ls -lFh'
-
-# Display one file per line.
-alias l1='ls -1'
-
-# All files, show type, human readable.
-alias la='ls -lAFh'
-
-# List all files in alphabetical order.
-alias labc='ls -lap'
-
-# Count the number of lines in the file.
-alias lc='wc -l'
-
-# List files by time, newest first.
-alias lct='ls -lcrh'
-
-# Sort by date, oldest first.
-alias ld='ls -ltrh'
-
-# List directories only.
-alias ldir="ls -l | egrep '^d'"
-
-# List hidden files.
-alias ldot="l."
-
-# List files by date, most recent last.
-alias left='ls -t -1'
-
-# List files by date, most recent first.
-alias right='ls -t -1r'
-
-# List files only.
-alias lf="ls -l | egrep -v '^d'"
-
-# Sort by size, largest first.
-alias lk='ls -lSrh'
-
-# Long list, show almost all, show type, human readable.
-alias ll='la'
-
-# List full path of all files in current directory.
-alias lla='ls -l -d $PWD/*'
-
-# locale: List all available locales.
-alias locale='locale -a | grep UTF-8'
-
-# List all open ports.
-alias lp='sudo lsof -i -T -n'
-
-# Recursive list, show type, human readable.
-alias lr='ls -lRh'
-
-# Colorize the output.
-alias ls='ls --color'
-
-# Order Files Based on Last Modified Time and size.
-alias lS='ls -1FSsh'
-
-# List contents of directories in a tree-like format.
-alias lt="tree"
-
-# Sort by date, oldest first.
-alias lu='ls -lurh'
-
-# Wide list, show almost all, show type, human readable.
-alias lw='ls -xAh'
-
-# Sort by extension.
-alias lx='ls | sort -k 1,1 -t .'
-
-# Sort by size, smallest first.
-alias lz='ls -lSr'
+#
+# Description:
+#   This script sets a set of aliases for file listing using `eza`.
+#   If `eza` is not found, it falls back to `ls` with approximate equivalents.
+#
+# Requested Aliases:
+#   alias ls='eza'                            # Basic replacement for ls
+#   alias l='eza'                             # 'l' should be the same as ls/eza
+#   alias ll='eza --long -a'                  # Long format, including hidden files
+#   alias llm='eza --long -a --sort=modified'# Long format, hidden files, sorted by mod date
+#   alias la='eza -a --group-directories-first' # Show all files, dirs first
+#   alias lx='eza -a --group-directories-first --extended' # All files, dirs first, extended attrs
+#   alias tree='eza --tree'                   # Tree view
+#   alias lS='eza --oneline'                  # One entry per line
+#
+# Additionally, 'l' is now identical to 'ls' rather than a custom format.
+################################################################################
+
+if command -v eza >/dev/null 2>&1; then
+    # eza is available
+
+    # @name ls
+    # @brief Basic replacement for ls using eza
+    # @description If eza is installed, ls calls eza.
+    # @example ls
+    alias ls='eza'
+
+    # @name l
+    # @brief Identical to ls/eza
+    # @description l should mirror ls exactly when eza is available.
+    # @example l
+    alias l='eza'
+
+    # @name ll
+    # @brief Long format including hidden files
+    # @description Uses `--long -a` for details and hidden files.
+    # @example ll
+    alias ll='eza --long -a'
+
+    # @name llm
+    # @brief Long format, including hidden files, sorted by modification date
+    # @description Uses `--long -a --sort=modified`.
+    # @example llm
+    alias llm='eza --long -a --sort=modified'
+
+    # @name la
+    # @brief Show all files, directories listed first
+    # @description Uses `-a --group-directories-first` to show hidden and group dirs first.
+    # @example la
+    alias la='eza -a --group-directories-first'
+
+    # @name lx
+    # @brief Show all files and extended attributes, directories first
+    # @description `-a --group-directories-first --extended`.
+    # @example lx
+    alias lx='eza -a --group-directories-first --extended'
+
+    # @name tree
+    # @brief Tree view
+    # @description Uses `--tree` for a tree-like directory listing.
+    # @example tree
+    alias tree='eza --tree'
+
+    # @name lS
+    # @brief One entry per line
+    # @description Uses `--oneline` to list files one per line.
+    # @example lS
+    alias lS='eza --oneline'
+
+else
+    # eza not found, fallback to ls approximations
+    echo "Note: 'eza' not found. Using 'ls' fallback." >&2
+    echo "Install 'eza' for enhanced listing: https://github.com/eza-community/eza" >&2
+
+    # @name ls (fallback)
+    # @brief Basic listing using ls
+    # @example ls
+    alias ls='ls'
+
+    # @name l (fallback)
+    # @brief Identical to ls
+    # @description l should mirror ls exactly when eza is not available.
+    # @example l
+    alias l='ls'
+
+    # @name ll (fallback)
+    # @brief Long format including hidden files
+    # @description `-lA` shows long listing including hidden files.
+    # @example ll
+    alias ll='ls -lA'
+
+    # @name llm (fallback)
+    # @brief Sort by modification time
+    # @description `ls -ltA` sorts by modification time, includes hidden with `-A`.
+    # @example llm
+    alias llm='ls -ltA'
+
+    # @name la (fallback)
+    # @brief Show all files
+    # @description `-a` shows hidden files. No directories-first in plain ls.
+    # @example la
+    alias la='ls -a'
+
+    # @name lx (fallback)
+    # @brief Show all files; extended attributes are not directly in ls
+    # @description `-la` shows long listing including hidden.
+    # @example lx
+    alias lx='ls -la'
+
+    # @name tree (fallback)
+    # @brief Tree view (approx.)
+    # @description If `tree` is installed, use it; otherwise `ls -R`.
+    # @example tree
+    if command -v tree >/dev/null 2>&1; then
+        alias tree='tree'
+    else
+        alias tree='ls -R'
+    fi
+
+    # @name lS (fallback)
+    # @brief One entry per line
+    # @description `-1` lists files one per line.
+    # @example lS
+    alias lS='ls -1'
+fi

package/dist/lib/aliases/macOS/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/macOS/macos.aliases.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅼🅰🅲🅾🆂 🅰🅻🅸🅰🆂🅴🆂

package/dist/lib/aliases/make/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/make/make.aliases.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅼🅰🅺🅴 🅰🅻🅸🅰🆂🅴🆂

package/dist/lib/aliases/mkdir/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/mkdir/mkdir.aliases.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅼🅰🅺🅴🅳🅸🆁 🅰🅻🅸🅰🆂🅴🆂

package/dist/lib/aliases/npm/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/npm/npm.aliases.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅽🅿🅼 🅰🅻🅸🅰🆂🅴🆂

package/dist/lib/aliases/permission/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/permission/permission.aliases.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - https://dotfiles.io
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - https://dotfiles.io
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅿🅴🆁🅼🅸🆂🆂🅸🅾🅽 🅰🅻🅸🅰🆂🅴🆂

package/dist/lib/aliases/pnpm/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/pnpm/pnpm.aliases.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅿🅽🅿🅼 🅰🅻🅸🅰🆂🅴🆂

package/dist/lib/aliases/ps/README.md

@@ -3,13 +3,13 @@
 <img
   src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
   alt="dotfiles logo"
-  width="261"
+  width="66"
   align="right"
 />
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.468)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/ps/ps.aliases.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.468) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.469) - <https://dotfiles.io>
+# Made with ♥ in London, UK by Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
 # License: MIT
 
 # 🅿🆂 🅰🅻🅸🅰🆂🅴🆂