@sebastienrousseau/dotfiles 0.2.468 → 0.2.469

package/dist/lib/README.md

@@ -1,12 +1,86 @@
-<!-- markdownlint-disable MD033 MD041 MD043 -->
-
 <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 Shell Configuration Scripts
+
+Simply designed to fit your shell life 🐚
+
+![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-->
 
-# Dotfiles aliases
+[banner]: https://kura.pro/dotfiles/v2/images/titles/title-dotfiles.svg

package/dist/lib/aliases/README.md

@@ -1,55 +1,57 @@
-<!-- markdownlint-disable MD033 MD041 MD043 -->
-
 <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]
 
-- [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,59 +1,145 @@
 <!-- markdownlint-disable MD033 MD041 MD043 -->
-
 <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 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. Here are examples for each operation:
+### Usage Examples
 
-* To compress a directory to a 7z file: `compress_7z <archive_name.7z> <directory>`
-* To extract from a 7z file: `extract_7z <archive_name.7z>`
+```bash
+# Extract any supported archive
+extract archive.tar.gz
 
-Similar commands apply for all supported formats, ensuring ease of use.
+# Create a tar.gz archive
+ctgz output.tar.gz folder/
 
-**New Features:**
+# List contents of a zip file
+lzip archive.zip
 
-* Defensive coding practices ensure aliases are only defined if the required
-archive programs are present, improving the script's robustness.
-* Enhanced portability with updates to support a wider range of archive formats
-and systems.
+# 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,157 +1,114 @@
 #!/usr/bin/env bash
-
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂
-# Script: archives.aliases.sh
-# Version: 0.2.468
-# Author: @wwdseb
-# Copyright (c) 2015-2024. All rights reserved
-# Description:
-#   This script defines aliases for common archive operations. It provides
-#   shortcuts for compressing and extracting various types of archive files.
-# Website: https://dotfiles.io
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - Archive and Compression Management
+# Made with ♥ by Sebastien Rousseau
 # License: MIT
-################################################################################
-
-# 🅰🆁🅲🅷🅸🆅🅴🆂 🅰🅻🅸🅰🆂🅴🆂
-
-## Check for existence of archive programs
-if type 7z &> /dev/null; then
-  alias compress_7z='7z a'
-  alias extract_7z='7z x'
-fi
-
-if type tar &> /dev/null; then
-  alias compress_tar='tar -cvf'
-  alias extract_tar='tar -xvf'
-  alias compress_tar_gzip='tar -zcvf'
-  alias extract_tar_gzip='tar -zxvf'
-  alias compress_tar_bzip2='tar -cvjf'
-  alias extract_tar_bzip2='tar -xvjf'
-fi
-
-if type jar &> /dev/null; then
-  alias compress_jar='jar -cvf'
-  alias extract_jar='jar -xvf'
-fi
-
-if type xz &> /dev/null; then
-  alias compress_xz='tar -cvJf'
-  alias extract_xz='tar -xvJf'
-fi
-
-if type zip &> /dev/null; then
-  alias compress_zip='zip -r'
-  alias extract_zip='unzip'
-fi
-
-if type zstd &> /dev/null; then
-  alias compress_zstd='zstd -zcvf'
-  alias extract_zstd='zstd -zxvf'
-fi
-
-if type gzip &> /dev/null; then
-  alias compress_gzip='gzip -cv'
-  alias extract_gzip='gzip -dv'
-fi
-
-if type bzip2 &> /dev/null; then
-  alias compress_bzip2='bzip2 -zkvf'
-  alias extract_bzip2='bzip2 -dkvf'
-fi
-
-if type lzop &> /dev/null; then
-  alias compress_lzop='lzop -cv'
-  alias extract_lzop='lzop -dv'
-fi
-
-if type lz4 &> /dev/null; then
-  alias compress_lz4='lz4 -zcv'
-  alias extract_lz4='lz4 -dcv'
-fi
-
-if type pigz &> /dev/null; then
-  alias compress_pigz='pigz -zkvf'
-  alias extract_pigz='pigz -dkvf'
-fi
-
-# 🅳🅴🅵🅴🅽🆂🅸🆅🅴 🅲🅾🅳🅸🅽🅶
-
-# Ensure valid arguments are passed
-function compress_file() {
-  local archive_type="$1"
-  case "${archive_type}" in
-    7z|tar|jar|xz|zip|zstd|gzip|bzip2|lzop|lz4|pigz)
-      alias "compress_${archive_type}" "${archive_type} -cvf"
-      ;;
-    *)
-      echo "Unsupported archive type: ${archive_type}"
-      return 1
-      ;;
-  esac
-}
-
-function extract_file() {
-  local archive_type="$1"
-  case "${archive_type}" in
-    7z|tar|jar|xz|zip|zstd|gzip|bzip2|lzop|lz4|pigz)
-      alias "extract_${archive_type}" "${archive_type} -xvf"
-      ;;
-    *)
-      echo "Unsupported archive type: ${archive_type}"
-      return 1
-      ;;
-  esac
-}
 
-# Handle large files by piping outputs
-function compress_large_file() {
-  local archive_type="$1"
-  case "${archive_type}" in
-    7z|tar|jar|xz|zip|zstd|gzip|bzip2|lzop|lz4|pigz)
-      alias "compress_${archive_type}" "${archive_type} -cvf -"
-      ;;
-    *)
-      echo "Unsupported archive type: ${archive_type}"
-      return 1
-      ;;
-  esac
+#-----------------------------------------------------------------------------
+# 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
 }
 
-function extract_large_file() {
-  local archive_type="$1"
-  case "${archive_type}" in
-    7z|tar|jar|xz|zip|zstd|gzip|bzip2|lzop|lz4|pigz)
-      alias "extract_${archive_type}" "${archive_type} -xvf -"
-      ;;
-    *)
-      echo "Unsupported archive type: ${archive_type}"
-      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'"
 }
 
-# 🅿🅾🆁🆃🅰🅱🅸🅻🅸🆃🆈
-
-function set_alias() {
-  local program="$1"
-  local flags="$2"
-  # shellcheck disable=SC2250,SC2139
-  alias "compress_$program"="${program} ${flags}"
-
-}
+#-----------------------------------------------------------------------------
+# 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
 
-# Set better defaults in case archive programs are missing
-set_alias compress_bz2 bzip2 '-zkvf'
-set_alias compress_lz4 lz4 '-zcv'
-set_alias compress_lzma xz '-zcvf'
-set_alias compress_lzo lzop '-cv'
-set_alias compress_pgz pigz '-zkvf'
-set_alias compress_tbz2 tar '-cvjf'
-set_alias compress_tgz tar '--use-compress-program=pigz -cvf'
-set_alias compress_tgz tar '-zcvf'
-set_alias compress_tlzo tar '--lzip -cvf'
-set_alias compress_txz tar '-cvJf'
-set_alias compress_tzst tar '--zstd -cvf'
-set_alias compress_zlib gzip '-cv'
-set_alias compress_zstd zstd '-zcvf'