@sebastienrousseau/dotfiles 0.2.465 → 0.2.468

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

@@ -1,11 +1,15 @@
-<!-- markdownlint-disable MD033 MD041 -->
+<!-- markdownlint-disable MD033 MD041 MD043 -->
 
-<img src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
-alt="dotfiles logo" width="261" 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.465)
+# Dotfiles (v0.2.468)
 
 Simply designed to fit your shell life 🐚
 
@@ -18,34 +22,33 @@ extract files and directories in various formats on a Unix-based system.
 
 The following compression formats are supported:
 
-- 7z
-- bzip2
-- gzip
-- jar
-- lz4
-- lzma
-- lzo
-- pigz
-- tar
-- xz
-- zstd
-- zip
+* 7z
+* bzip2
+* gzip
+* jar
+* lz4
+* lzma
+* lzo
+* pigz
+* tar
+* xz
+* zstd
+* zip
 
 These aliases enable users to compress or extract files and directories
-quickly by using simple commands.
+quickly by using simple commands. Here are examples for each operation:
 
-For example:
+* 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>`
 
-- `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.
+Similar commands apply for all supported formats, ensuring ease of use.
 
-Similarly, there are aliases for compressing and extracting files and
-directories in all supported formats.
+**New Features:**
 
-The aliases are designed to be easy to remember and use, and they should
-make the compression and extraction process much simpler for users.
+* 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.
 
 Please note that some of the compression formats may require additional
 software to be installed on your system.

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

@@ -1,154 +1,157 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.465) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
-# License: MIT
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂
 # Script: archives.aliases.sh
-# Version: 0.2.465
+# 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
+# License: MIT
+################################################################################
 
 # 🅰🆁🅲🅷🅸🆅🅴🆂 🅰🅻🅸🅰🆂🅴🆂
-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'
+## Check for existence of archive programs
+if type 7z &> /dev/null; then
+  alias compress_7z='7z a'
+  alias extract_7z='7z x'
 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
+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
+}
+
+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
+}
+
+# 🅿🅾🆁🆃🅰🅱🅸🅻🅸🆃🆈
+
+function set_alias() {
+  local program="$1"
+  local flags="$2"
+  # shellcheck disable=SC2250,SC2139
+  alias "compress_$program"="${program} ${flags}"
+
+}
+
+# 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'

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

@@ -1,63 +1,65 @@
-<!-- markdownlint-disable MD033 MD041 -->
+<!-- markdownlint-disable MD033 MD041 MD043 -->
 
-<img src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
-alt="dotfiles logo" width="261" 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.465)
+# Dotfiles (v0.2.468)
 
-Simply designed to fit your shell life 🐚
+Designed to seamlessly enhance your shell environment 🐚
 
 ![Dotfiles banner][banner]
 
 ## 🅲🅳 🅰🅻🅸🅰🆂🅴🆂
 
-These aliases provide shortcuts for the cd command to help you quickly
-navigate your file system. To use them, add the following lines to your
-.bashrc or .bash_profile file.
+This set of `cd` command aliases provides an intuitive and efficient way to
+navigate your filesystem. Incorporating dynamic error handling, optional
+directory listing, and customization for an improved command-line experience.
 
-### Navigation
+### Setup
 
-- `-`: Go to previous directory.
-- `.., ..., ...., .....`: Go up one, two, three, or four directories,
-  respectively.
-- `~`: Go to home directory.
+To use these aliases, integrate the script into your `.bashrc` or `.bash_profile`.
 
-### Directories
+### Navigation Shortcuts
 
-- `app`: Go to the Applications directory and list its contents.
-- `cod`: Go to the Code directory and list its contents.
-- `des`: Go to the Desktop directory and list its contents.
-- `doc`: Go to the Documents directory and list its contents.
-- `dot`: Go to the .dotfiles directory and list its contents.
-- `dow`: Go to the Downloads directory and list its contents.
-- `hom`: Go to the home directory and list its contents.
-- `mus`: Go to the Music directory and list its contents.
-- `pic`: Go to the Pictures directory and list its contents.
-- `vid`: Go to the Videos directory and list its contents.
+* `-`: Go to the previous directory.
+* `..`, `...`, `....`, `.....`: Ascend one to four levels in the directory tree.
+* `~`: Navigate to the home directory.
+
+### Custom Directory Access
+
+Leverage aliases for quick access to frequently visited directories:
+
+* `app`: Applications directory
+* `cod`: Code directory
+* `des`: Desktop directory
+* `doc`: Documents directory
+* `dot`: Dotfiles directory
+* `dow`: Downloads directory
+* `mus`: Music directory
+* `pic`: Pictures directory
+* `vid`: Videos directory
 
 ### System Directories
 
-- `etc`: Go to the etc directory and list its contents.
-- `var`: Go to the var directory and list its contents.
-- `tmp`: Go to the tmp directory and list its contents.
-
-### Frequently used directories
-
-- `app`: Shortcut to go to the Applications directory and list its
-  contents.
-- `cod`: Shortcut to go to the Code directory and list its contents.
-- `des`: Shortcut to go to the Desktop directory and list its contents.
-- `doc`: Shortcut to go to the Documents directory and list its
-  contents.
-- `dot`: Shortcut to go to the .dotfiles directory and list its
-  contents.
-- `dow`: Shortcut to go to the Downloads directory and list its
-  contents.
-- `hom`: Shortcut to go to the home directory and list its contents.
-- `mus`: Shortcut to go to the Music directory and list its contents.
-- `pic`: Shortcut to go to the Pictures directory and list its contents.
-- `vid`: Shortcut to go to the Videos directory and list its contents.
+Quickly access system directories:
+
+* `etc`: System configuration (`/etc`)
+* `var`: Variable files (`/var`)
+* `tmp`: Temporary files (`/tmp`)
+
+### Enhanced Customization
+
+Customize directory paths through environment variables to suit your system's
+structure and preferences. Use concise aliases (`app`, `cod`, `des`, etc.) for
+efficient navigation.
+
+For a detailed guide on configuring and using these aliases, plus additional
+information on each command, visit our [documentation](https://dotfiles.io).
 
 [banner]: https://kura.pro/dotfiles/v2/images/titles/title-dotfiles.svg

package/dist/lib/aliases/cd/cd.aliases.sh

@@ -1,39 +1,73 @@
 #!/usr/bin/env bash
+
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂
 # Author: Sebastien Rousseau
-# Copyright (c) 2015-2023. All rights reserved
-# Description: Sets aliases for the `cd` command.
+# Copyright: 2015-2024. All rights reserved
+# Description: Enhanced `cd` command aliases with checks, functions, and customization.
 # License: MIT
 # Script: cd.aliases.sh
-# Version: 0.2.465
+# Version: 0.2.468
 # Website: https://dotfiles.io
 
-# 🅲🅳 🅰🅻🅸🅰🆂🅴🆂
+# Usage:
+#   Customize directory paths via variables and use aliases to navigate.
+#   Example: `cod` to go to the Code directory, `..` to go up one directory.
 
-# Shortcut to go to previous directory
-alias -- -='cd -'
+# Configuration
+DOC_DIR="${HOME}/Documents"
+VID_DIR="${HOME}/Videos"
+# Add more configurable paths here
+
+# Check if directory exists and change to it, listing contents optionally
+change_directory() {
+  local path="$1"
 
-# Shortcuts to go to parent directories
-alias .....='cd ../../../../'
-alias ....='cd ../../'
-alias ...='cd ../'
+  if [[ -d "${path}" ]]; then
+    cd "${path}" || exit # Exit if cd fails
+  else
+    echo "Directory '${path}' does not exist."
+  fi
+}
+
+# Parent Directory Shortcuts
+alias -- -='cd -'
 alias ..='cd ..'
+alias ...='cd ../..'
+alias ....='cd ../../..'
+alias .....='cd ../../../..'
+
+# Home Directory Shortcut
+alias hom='change_directory "${HOME}" true'
+
+# Frequently Used Directories
+alias doc='change_directory "$DOC_DIR" true' # Documents
+alias vid='change_directory "$VID_DIR" true' # Videos
+# Define more aliases like the above for other directories
+
+# System Directories (consider checks for system-specific paths)
+alias etc='change_directory "/etc" true'
+alias var='change_directory "/var" true'
+alias tmp='change_directory "/tmp" true'
+
+# Frequently Used Directories with Improved Error Handling and Customization
+APP_DIR="${HOME}/Applications"
+CODE_DIR="${HOME}/Code"
+DESK_DIR="${HOME}/Desktop"
+DOCS_DIR="${HOME}/Documents"
+DOTF_DIR="${HOME}/.dotfiles"
+DOWN_DIR="${HOME}/Downloads"
+MUSIC_DIR="${HOME}/Music"
+PICS_DIR="${HOME}/Pictures"
+VIDS_DIR="${HOME}/Videos"
 
-# Shortcuts to go to specific directories
-alias '~'='cd ~'
-
-# Shortcuts to go to frequently used directories
-alias app='cd "${HOME}/Applications"; ls' # app: Shortcut to go to the Applications directory and list its contents.
-alias cod='cd "${HOME}/Code"; ls'         # cod: Shortcut to go to the Code directory and list its contents.
-alias des='cd "${HOME}/Desktop"; ls'      # des: Shortcut to go to the Desktop directory and list its contents.
-alias doc='cd "${HOME}/Documents"; ls'    # doc: Shortcut to go to the Documents directory and list its contents.
-alias dot='cd "${HOME}/.dotfiles"; ls'    # dot: Shortcut to go to the .dotfiles directory and list its contents.
-alias dow='cd "${HOME}/Downloads"; ls'    # dow: Shortcut to go to the Downloads directory and list its contents.
-alias hom='cd "${HOME}"; ls'              # hom: Shortcut to go to the home directory and list its contents.
-alias mus='cd "${HOME}/Music"; ls'        # mus: Shortcut to go to the Music directory and list its contents.
-alias pic='cd "${HOME}/Pictures"; ls'     # pic: Shortcut to go to the Pictures directory and list its contents.
-alias vid='cd "${HOME}/Videos"; ls'       # vid: Shortcut to go to the Videos directory and list its contents.
-
-# Shortcuts to navigate to system directories
-alias etc='cd /etc; ls' # etc: Shortcut to go to the etc directory and list its contents.
-alias var='cd /var; ls' # var: Shortcut to go to the var directory and list its contents.
-alias tmp='cd /tmp; ls' # tmp: Shortcut to go to the tmp directory and list its contents.
+# Define functions for each alias with checks and optional ls
+alias app='change_directory "$APP_DIR" true' # Applications
+alias cod='change_directory "$CODE_DIR" true' # Code
+alias des='change_directory "$DESK_DIR" true' # Desktop
+alias doc='change_directory "$DOCS_DIR" true' # Documents
+alias dot='change_directory "$DOTF_DIR" true' # Dotfiles
+alias dow='change_directory "$DOWN_DIR" true' # Downloads
+alias mus='change_directory "$MUSIC_DIR" true' # Music
+alias pic='change_directory "$PICS_DIR" true' # Pictures
+alias vid='change_directory "$VIDS_DIR" true' # Videos

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

@@ -1,11 +1,15 @@
-<!-- markdownlint-disable MD033 MD041 -->
+<!-- markdownlint-disable MD033 MD041 MD043 -->
 
-<img src="https://kura.pro/dotfiles/v2/images/logos/dotfiles.svg"
-alt="dotfiles logo" width="261" 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.465)
+# Dotfiles (v0.2.468)
 
 Simply designed to fit your shell life 🐚