@sebastienrousseau/dotfiles 0.2.466 → 0.2.469

package/dist/lib/README.md

@@ -1,8 +1,86 @@
-# Dotfiles aliases
+<img
+  src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
+  alt="dotfiles logo"
+  width="66"
+  align="right"
+/>
 
-<!-- markdownlint-disable MD033 MD041 -->
+# Dotfiles Shell Configuration Scripts
 
-<img src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
-alt="dotfiles logo" width="261" align="right" />
+Simply designed to fit your shell life 🐚
 
-<!-- markdownlint-enable MD033 MD041 -->
+![Dotfiles banner][banner]
+
+This repository includes various scripts to enhance your shell experience, manage configurations, and customize behavior. The scripts are organized and detailed below.
+
+## 🔑 Scripts List
+
+<!-- markdownlint-disable MD013-->
+
+### Alias Management
+
+| Script            | Description                                      | Usage                          |
+| :---------------- | :----------------------------------------------- | :----------------------------- |
+| `aliases.sh`      | Manage and load custom shell aliases.            | `source aliases.sh`           |
+
+#### Features
+
+- **Remove All Aliases:** Clears all existing aliases in the current shell environment.
+- **Load Custom Aliases:** Sources alias definitions from a specified directory within `.dotfiles`.
+
+### Configuration Management
+
+| Script            | Description                                      | Usage                          |
+| :---------------- | :----------------------------------------------- | :----------------------------- |
+| `configurations.sh` | Load custom shell configurations.              | `source configurations.sh`    |
+
+#### Features
+
+- **Custom Configurations:** Loads shell-specific configurations from the `.dotfiles` directory.
+- **Error Handling:** Reports missing configuration files or sourcing issues.
+
+### Function Management
+
+| Script            | Description                                      | Usage                          |
+| :---------------- | :----------------------------------------------- | :----------------------------- |
+| `functions.sh`    | Load custom executable functions.                | `source functions.sh`         |
+
+#### Features
+
+- **Custom Functions:** Sources user-defined functions from the `.dotfiles/lib/functions` directory.
+- **Directory Check:** Ensures the functions directory exists before sourcing.
+
+### History Management
+
+| Script            | Description                                      | Usage                          |
+| :---------------- | :----------------------------------------------- | :----------------------------- |
+| `history.sh`      | Manage and configure shell history behavior.     | `source history.sh`           |
+
+#### Features
+
+- **Clear History:** Clears the history file and removes duplicates.
+- **List History:** Displays shell history with enhanced formatting.
+- **History Configuration:** Sets up shell-specific history options for Bash and Zsh.
+
+### Path Management
+
+| Script            | Description                                      | Usage                          |
+| :---------------- | :----------------------------------------------- | :----------------------------- |
+| `paths.sh`        | Load custom path configurations.                 | `source paths.sh`             |
+
+#### Features
+
+- **Load Paths:** Adds directories to the shell `PATH` variable from `.dotfiles/lib/paths`.
+- **Error Reporting:** Alerts the user if the paths directory is missing.
+
+### Usage
+
+| Command                     | Description                              |
+| :-------------------------- | :--------------------------------------- |
+| `source <script>.sh`        | Apply the respective script configuration.|
+| `echo $PATH`                | Verify the current `PATH`.               |
+| `h` or `history`            | Access custom history management.        |
+
+<!-- markdownlint-enable MD013-->
+
+[banner]: https://kura.pro/dotfiles/v2/images/titles/title-dotfiles.svg

package/dist/lib/aliases/README.md

@@ -1,51 +1,57 @@
-<!-- markdownlint-disable MD033 MD041 -->
+<img
+  src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
+  alt="dotfiles logo"
+  width="66"
+  align="right"
+/>
 
-<img src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
-alt="dotfiles logo" width="261" align="right" />
-
-<!-- markdownlint-enable MD033 MD041 -->
-
-# Dotfiles (v0.2.466)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 
 ![Dotfiles banner][banner]
 
-- [Archives](archives/README.md) - Compress and extract files and
-  directories in various formats on a Unix-based system.
-- [Cd](cd/README.md) - Navigate the file system.
-- [Chmod](chmod/README.md) - Change the permissions of files and
-  directories.
-- [Clear](clear/README.md) - Clear the terminal screen.
-- [Configuration](configuration/README.md) - Configure the dotfiles.
-- [Default](default/README.md) - Manage the default shell.
-- [Dig](dig/README.md) - Query DNS name servers.
-- [Disk Usage](disk-usage/README.md) - Display the disk usage of files
-  and directories.
-- [Editor](editor/README.md) - Manage the default text editor.
-- [Find](find/README.md) - Search for files and directories.
-- [gCloud](gcloud/README.md) - Manage the Google Cloud SDK.
-- [Git](git/README.md) - Manage the Git version control system.
-- [GNU](gnu/README.md) - Manage the GNU core utilities.
-- [Heroku](heroku/README.md) - Manage the Heroku CLI.
-- [Interactive](interactive/README.md) - Manage the interactive shell.
-- [Jekyll](jekyll/README.md) - Manage the Jekyll static site generator.
-- [List](list/README.md) - List files and directories.
-- [macOS](macos/README.md) - Manage the macOS operating system.
-- [make](make/README.md) - Manage the GNU make utility.
-- [mkdir](mkdir/README.md) - Create directories.
-- [npm](npm/README.md) - Manage the Node.js package manager.
-- [permission](permission/README.md) - Manage the file permissions.
-- [pnpm](pnpm/README.md) - Manage the pnpm package manager.
-- [ps](ps/README.md) - Manage the process status.
-- [rsync](rsync/README.md) - Manage the rsync file transfer utility.
-- [rust](rust/README.md) - Manage the Rust programming language.
-- [subversion](subversion/README.md) - Manage the Subversion version
-  control system.
-- [sudo](sudo/README.md) - Manage the superuser.
-- [tmux](tmux/README.md) - Manage the tmux terminal multiplexer.
-- [update](update/README.md) - Help users update the dotfiles.
-- [uuid](uuid/README.md) - Help users generate UUIDs.
-- [wget](wget/README.md) - Manage the wget utility.
+This repository contains a structured set of directories and scripts to manage various shell configurations, aliases, and utilities. Below is the organized directory structure with detailed descriptions.
+
+## 🔧 Directory List
+
+<!-- markdownlint-disable MD013-->
+
+| Directory       | Description                                      | Link                      |
+| :-------------- | :----------------------------------------------- | :------------------------ |
+| `archives`      | Compress and extract files and directories.      | [View README](archives/README.md) |
+| `cd`            | Navigate the file system.                        | [View README](cd/README.md)       |
+| `chmod`         | Change file and directory permissions.           | [View README](chmod/README.md)    |
+| `clear`         | Clear the terminal screen.                       | [View README](clear/README.md)    |
+| `configuration` | Manage dotfiles and shell configurations.        | [View README](configuration/README.md) |
+| `default`       | Set up default shell aliases and configurations. | [View README](default/README.md)  |
+| `dig`           | Query DNS name servers.                          | [View README](dig/README.md)      |
+| `disk-usage`    | Display disk usage information.                  | [View README](disk-usage/README.md) |
+| `editor`        | Configure default text editors.                  | [View README](editor/README.md)   |
+| `find`          | Search files and directories using `find`.       | [View README](find/README.md)     |
+| `gcloud`        | Manage Google Cloud SDK tools.                   | [View README](gcloud/README.md)   |
+| `git`           | Manage Git aliases and configurations.           | [View README](git/README.md)      |
+| `gnu`           | Manage GNU core utilities.                       | [View README](gnu/README.md)      |
+| `heroku`        | Manage Heroku CLI.                               | [View README](heroku/README.md)   |
+| `interactive`   | Configure interactive shell behavior.            | [View README](interactive/README.md) |
+| `list`          | List files and directories.                      | [View README](list/README.md)     |
+| `macOS`         | Manage macOS-specific shell settings.            | [View README](macOS/README.md)    |
+| `make`          | Manage GNU Make aliases and utilities.           | [View README](make/README.md)     |
+| `mkdir`         | Create directories with custom options.          | [View README](mkdir/README.md)    |
+| `npm`           | Manage Node.js package manager aliases.          | [View README](npm/README.md)      |
+| `permission`    | Configure file and directory permissions.         | [View README](permission/README.md) |
+| `pnpm`          | Manage pnpm package manager aliases.             | [View README](pnpm/README.md)     |
+| `ps`            | Manage process status commands.                  | [View README](ps/README.md)       |
+| `python`        | Configure Python aliases and utilities.          | [View README](python/README.md)   |
+| `rsync`         | Configure rsync for efficient file transfers.    | [View README](rsync/README.md)    |
+| `rust`          | Manage Rust programming tools and configurations.| [View README](rust/README.md)     |
+| `subversion`    | Configure Subversion (SVN) version control.       | [View README](subversion/README.md) |
+| `sudo`          | Manage superuser operations.                     | [View README](sudo/README.md)     |
+| `tmux`          | Configure tmux terminal multiplexer.             | [View README](tmux/README.md)     |
+| `update`        | Update dotfiles and related configurations.       | [View README](update/README.md)   |
+| `uuid`          | Generate UUIDs for various use cases.            | [View README](uuid/README.md)     |
+| `wget`          | Manage wget command-line tool.                   | [View README](wget/README.md)     |
+
+<!-- markdownlint-enable MD013-->
 
 [banner]: https://kura.pro/dotfiles/v2/images/titles/title-dotfiles.svg

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

@@ -1,56 +1,145 @@
-<!-- markdownlint-disable MD033 MD041 -->
-
-<img src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
-alt="dotfiles logo" width="261" align="right" />
-
+<!-- markdownlint-disable MD033 MD041 MD043 -->
+<img
+  src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
+  alt="dotfiles logo"
+  width="66"
+  align="right"
+/>
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.466)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 
 ![Dotfiles banner][banner]
 
-## 🅰🆁🅲🅷🅸🆅🅴🆂 🅰🅻🅸🅰🆂🅴🆂
+## 🅰🆁🅲🅷🅸🆅🅴 🅰🅽🅳 🅲🅾🅼🅿🆁🅴🆂🆂🅸🅾🅽 🅰🅻🅸🅰🆂🅴🆂
+
+This module provides comprehensive tools for handling various archive and
+compression formats.
+
+### Universal Extract Function
+
+The `extract` command automatically handles various archive formats:
+
+```bash
+extract archive.tar.gz  # Automatically detects format and extracts
+```
+
+Supported formats:
+
+- `.tar.bz2`, `.tbz2`
+- `.tar.gz`, `.tgz`
+- `.tar.xz`
+- `.tar.zst`
+- `.tar`
+- `.bz2`
+- `.gz`
+- `.rar`
+- `.zip`
+- `.Z`
+- `.7z`
+- `.zst`
+- `.xz`
+- `.lz4`
+
+### Large File Compression
+
+The `compress_large` function handles large file compression with streaming:
+
+```bash
+compress_large gz largefile.dat  # Creates largefile.dat.gz
+compress_large xz data.bin output.xz  # Specific output name
+```
+
+Supported formats: `gz`, `bz2`, `xz`, `zst`, `lz4`
+
+### Archive Tools
+
+#### 7-Zip Aliases
+
+- `a7z` - Create 7z archive
+- `x7z` - Extract 7z archive
+- `l7z` - List contents
+- `t7z` - Test integrity
+
+#### Tar Aliases
+
+- `ctar` - Create tar archive
+- `xtar` - Extract tar archive
+- `ltar` - List contents
+- `ctgz` - Create tar.gz archive
+- `xtgz` - Extract tar.gz archive
+- `ctbz` - Create tar.bz2 archive
+- `xtbz` - Extract tar.bz2 archive
+- `ctxz` - Create tar.xz archive
+- `xtxz` - Extract tar.xz archive
+- `ctzst` - Create tar.zst archive
+- `xtzst` - Extract tar.zst archive
+
+#### Zip Aliases
+
+- `czip` - Create zip archive
+- `xzip` - Extract zip archive
+- `lzip` - List contents
+
+### Compression Tools
+
+#### Gzip
+
+- `cgz` - Compress with gzip
+- `xgz` - Extract gzip
+
+#### Bzip2
+
+- `cbz` - Compress with bzip2
+- `xbz` - Extract bzip2
+
+#### XZ
+
+- `cxz` - Compress with xz
+- `xxz` - Extract xz
+
+#### Zstandard
+
+- `czst` - Compress with zstd
+- `xzst` - Extract zstd
+
+#### LZ4
 
-This code provides a set of command aliases to help users compress and
-extract files and directories in various formats on a Unix-based system.
+- `clz4` - Compress with lz4
+- `xlz4` - Extract lz4
 
-The following compression formats are supported:
+### Features
 
-- 7z
-- bzip2
-- gzip
-- jar
-- lz4
-- lzma
-- lzo
-- pigz
-- tar
-- xz
-- zstd
-- zip
+- Automatic format detection
+- Tab completion for the extract command
+- Error handling with helpful messages
+- Large file support with streaming
+- Archive integrity checking
+- Content listing
+- Cross-platform compatibility
 
-These aliases enable users to compress or extract files and directories
-quickly by using simple commands.
+### Usage Examples
 
-For example:
+```bash
+# Extract any supported archive
+extract archive.tar.gz
 
-- `c7z` can be used to compress a whole directory (including
-  subdirectories) to a 7z file.
-- `e7z` can be used to extract a whole directory (including
-  subdirectories) from a 7z file.
+# Create a tar.gz archive
+ctgz output.tar.gz folder/
 
-Similarly, there are aliases for compressing and extracting files and
-directories in all supported formats.
+# List contents of a zip file
+lzip archive.zip
 
-The aliases are designed to be easy to remember and use, and they should
-make the compression and extraction process much simpler for users.
+# Compress a large file
+compress_large xz largefile.dat
 
-Please note that some of the compression formats may require additional
-software to be installed on your system.
+# Create a 7z archive with maximum compression
+a7z a -mx=9 archive.7z files/
 
-Enjoy the convenience of quickly compressing and extracting files and
-directories with these command aliases!
+# Test archive integrity
+t7z archive.7z
+```
 
 [banner]: https://kura.pro/dotfiles/v2/images/titles/title-dotfiles.svg

package/dist/lib/aliases/archives/archives.aliases.sh

@@ -1,154 +1,114 @@
 #!/usr/bin/env bash
-
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - Archive and Compression Management
+# Made with ♥ by Sebastien Rousseau
 # License: MIT
-# Script: archives.aliases.sh
-# Version: 0.2.466
-# Website: https://dotfiles.io
-
-# 🅰🆁🅲🅷🅸🆅🅴🆂 🅰🅻🅸🅰🆂🅴🆂
-if command -v 7z &>/dev/null; then
-  # Compress a whole directory (including subdirectories) to a 7z file.
-  alias c7z='7z a'
-  # Extract a whole directory (including subdirectories) from a 7z file.
-  alias e7z='7z x'
-fi
-
-if command -v tar &>/dev/null; then
-  # Compress a file to a bzip2 file.
-  alias cbzip2='tar -cvjf'
-  # Compress a whole directory (including subdirectories) to a tar file.
-  alias ctar='tar -cvf'
-  # Extract a whole directory (including subdirectories) from a tar
-  # file.
-  alias etar='tar -xvf'
-  # Compress a file to a gzip file.
-  alias cgzip='tar -zcvf'
-  # Compress a whole directory (including subdirectories) to an xz file.
-  alias cxz='tar -cvJf'
-  # Extract a file from a bzip2 file.
-  alias ebzip2='tar -xvjf'
-  # Extract a file from a gzip file.
-  alias egzip='tar -xvzf'
-  # Extract a whole directory (including subdirectories) from an xz
-  # file.
-  alias exz='tar -xvJf'
-fi
-
-if command -v jar &>/dev/null; then
-  # Compress a whole directory (including subdirectories) to a jar file.
-  alias cjar='jar -cvf'
-  # Extract a whole directory (including subdirectories) from a jar
-  # file.
-  alias ejar='jar -xvf'
-fi
-
-if command -v xz &>/dev/null; then
-  # Compress a whole directory (including subdirectories) to an xz file.
-  alias cxz2='xz -zcvf'
-  # Extract a whole directory (including subdirectories) from an xz
-  # file.
-  alias exz2='xz -zxvf'
-fi
-
-if command -v zip &>/dev/null; then
-  # Compress a whole directory (including subdirectories) to a zip file.
-  alias czip='zip -r'
-  # Extract a whole directory (including subdirectories) from a zip
-  # file.
-  alias ezip='unzip'
-fi
-
-if command -v zstd &>/dev/null; then
-  # Compress a whole directory (including subdirectories) to a zstd file.
-  alias czstd='zstd -zcvf'
-  # Extract a whole directory (including subdirectories) from a zstd
-  # file.
-  alias ezstd='zstd -zxvf'
-fi
-
-# Compress a file to a lzma file.
-if command -v xz &>/dev/null; then
-  alias clzma='xz -zcvf'
-  alias elzma='xz -zxvf'
-fi
-
-# Compress a file to a z file.
-if command -v gzip &>/dev/null; then
-  alias czlib='gzip -cv'
-  alias ezlib='gzip -dv'
-fi
-
-# Compress a file to a bz2 file.
-if command -v bzip2 &>/dev/null; then
-  alias cbz2='bzip2 -zkvf'
-  alias ebz2='bzip2 -dkvf'
-fi
-
-# Compress a file to a lzo file.
-if command -v lzop &>/dev/null; then
-  alias clzo='lzop -cv'
-  alias elzo='lzop -dv'
-fi
-
-# Compress a file to a lz4 file.
-if command -v lz4 &>/dev/null; then
-  alias clz4='lz4 -zcv'
-  alias elz4='lz4 -dcv'
-fi
-
-# Compress a file to a zst file.
-if command -v zstd &>/dev/null; then
-  alias czst='zstd -zcv'
-  alias ezst='zstd -dcv'
-fi
-
-# Compress a file to a pigz file.
-if command -v pigz &>/dev/null; then
-  alias cpgz='pigz -zkvf'
-  alias epgz='pigz -dkvf'
-fi
-
-# Compress a whole directory (including subdirectories) to a tar.bz2
-# file.
-if command -v tar &>/dev/null && command -v bzip2 &>/dev/null; then
-  alias ctbz2='tar -cvjf'
-  alias etbz2='tar -xvjf'
-fi
-
-# Compress a whole directory (including subdirectories) to a tar.lzma
-# file.
-if command -v tar &>/dev/null && command -v xz &>/dev/null; then
-  alias ctlzma='tar --lzma -cvf'
-  alias etlzma='tar --lzma -xvf'
-fi
-
-# Compress a whole directory (including subdirectories) to a tar.gz
-# file.
-if command -v tar &>/dev/null && command -v gzip &>/dev/null; then
-  alias ctgz='tar -zcvf'
-  alias etgz='tar -zxvf'
-fi
-
-# Compress a whole directory (including subdirectories) to a tar.lzo
-# file.
-if command -v tar &>/dev/null && command -v lzop &>/dev/null; then
-  alias ctlzo='tar --lzip -cvf'
-  alias etlzo='tar --lzip -xvf'
-fi
-
-# Compress a whole directory (including subdirectories) to a tar.zst
-# file.
-if command -v tar &>/dev/null && command -v zstd &>/dev/null; then
-  alias ctzst='tar --zstd -cvf'
-  alias etzst='tar --zstd -xvf'
-fi
-
-# Compress a whole directory (including subdirectories) to a tar.pgz
-# file.
-if command -v tar &>/dev/null && command -v pigz &>/dev/null; then
-  alias ctpgz='tar --use-compress-program=pigz -cvf'
-  alias etpgz='tar --use-compress-program=pigz -xvf'
-fi
+
+#-----------------------------------------------------------------------------
+# Extract Function
+#-----------------------------------------------------------------------------
+# Archive and Compression Management
+
+extract() {
+    if [ -z "$1" ]; then
+        echo "Usage: extract <archive_file>"
+        return 1
+    fi
+
+    if [ ! -f "$1" ]; then
+        echo "Error: '$1' is not a valid file"
+        return 1
+    fi
+
+    case "$1" in
+        *.tar.bz2|*.tbz2) tar xvjf "$1" ;;
+        *.tar.gz|*.tgz)   tar xvzf "$1" ;;
+        *.tar.xz)         tar xvJf "$1" ;;
+        *.tar.zst)        tar --zstd -xvf "$1" ;;
+        *.tar)            tar xvf "$1" ;;
+        *.bz2)            bunzip2 "$1" ;;
+        *.gz)             gunzip "$1" ;;
+        *.rar)            unrar x "$1" ;;
+        *.zip)            unzip "$1" ;;
+        *.Z)              uncompress "$1" ;;
+        *.7z)             7z x "$1" ;;
+        *.zst)            unzstd "$1" ;;
+        *.xz)             unxz "$1" ;;
+        *.lz4)            lz4 -d "$1" ;;
+        *)                echo "Error: '$1' cannot be extracted" && return 1 ;;
+    esac
+}
+
+#-----------------------------------------------------------------------------
+# Compress Function
+#-----------------------------------------------------------------------------
+compress_large() {
+    if [ -z "$1" ] || [ -z "$2" ]; then
+        echo "Usage: compress_large <format> <input_file> [output_file]"
+        return 1
+    fi
+
+    local format="$1"
+    local input="$2"
+    local output="${3:-${input}.${format}}"
+
+    if [ ! -f "$input" ]; then
+        echo "Error: '$input' is not a valid file"
+        return 1
+    fi
+
+    case "$format" in
+        gz)     gzip -c "$input" > "$output" ;;
+        bz2)    bzip2 -c "$input" > "$output" ;;
+        xz)     xz -c "$input" > "$output" ;;
+        zst)    zstd -c "$input" > "$output" ;;
+        lz4)    lz4 -c "$input" > "$output" ;;
+        *)      echo "Error: Unsupported format '$format'" && return 1 ;;
+    esac
+    echo "Compressed '$input' to '$output'"
+}
+
+#-----------------------------------------------------------------------------
+# Aliases
+#-----------------------------------------------------------------------------
+# 7-Zip Aliases
+alias a7z='7z a'          # Create 7z archive
+alias x7z='7z x'          # Extract 7z archive
+
+# Tar Aliases
+alias ctar='tar -cvf'     # Create tar archive
+alias xtar='tar -xvf'     # Extract tar archive
+alias ltar='tar -tvf'     # List tar archive contents
+alias ctgz='tar -zcvf'    # Create tar.gz archive
+alias xtgz='tar -zxvf'    # Extract tar.gz archive
+alias ctbz='tar -jcvf'    # Create tar.bz2 archive
+alias xtbz='tar -jxvf'    # Extract tar.bz2 archive
+alias ctxz='tar -Jcvf'    # Create tar.xz archive
+alias xtxz='tar -Jxvf'    # Extract tar.xz archive
+alias ctzst='tar --zstd -cvf' # Create tar.zst archive
+alias xtzst='tar --zstd -xvf' # Extract tar.zst archive
+
+# Zip Aliases
+alias czip='zip -r'       # Create zip archive
+alias xzip='unzip'        # Extract zip archive
+alias lzip='unzip -l'     # List zip archive contents
+
+# Gzip Aliases
+alias cgz='gzip -cv'      # Compress with gzip
+alias xgz='gzip -dv'      # Extract gzip
+
+# Bzip2 Aliases
+alias cbz='bzip2 -zk'     # Compress with bzip2
+alias xbz='bzip2 -dk'     # Extract bzip2
+
+# XZ Aliases
+alias cxz='xz -z'         # Compress with xz
+alias xxz='xz -d'         # Extract xz
+
+# Zstd Aliases
+alias czst='zstd -z'      # Compress with zstd
+alias xzst='zstd -d'      # Extract zstd
+
+# LZ4 Aliases
+alias clz4='lz4 -zc'      # Compress with lz4
+alias xlz4='lz4 -dc'      # Extract lz4
+