@sebastienrousseau/dotfiles 0.2.466 → 0.2.469

package/dist/lib/aliases/chmod/chmod.aliases.sh

@@ -1,73 +1,107 @@
 #!/usr/bin/env bash
-# Author: Sebastien Rousseau
-# Copyright (c) 2015-2023. All rights reserved
-# Description: Sets aliases for the `chmod` command.
+
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂 - Change directory aliases
+# Made with ♥ by Sebastien Rousseau
 # License: MIT
-# Script: chmod.aliases.sh
-# Version: 0.2.466
-# Website: https://dotfiles.io
-
-# 🅲🅷🅼🅾🅳 🅰🅻🅸🅰🆂🅴🆂
-if command -v 'chmod' >/dev/null; then
-
-  # Shortcuts to change permissions
-  alias 000='chmod -R 000' # 000: (chmod a-rwx) sets permissions so that, (U)ser / owner can't read, can't write and can't execute. (G)roup can't read, can't write and can't execute. (O)thers can't read, can't write and can't execute.
-  alias 400='chmod -R 400' # 400: (chmod a-rw) sets permissions so that, (U)ser / owner can't read, can't write and can execute. (G)roup can't read, can't write and can execute. (O)thers can't read, can't write and can execute.
-  alias 444='chmod -R 444' # 444: (chmod a-r) sets permissions so that, (U)ser / owner can't read, can't write and can execute. (G)roup can't read, can't write and can execute. (O)thers can't read, can't write and can execute.
-  alias 600='chmod -R 600' # 600: (chmod a+rwx,u-x,g-rwx,o-rwx) sets permissions so that, (U)ser / owner can read, can write and can't execute. (G)roup can't read, can't write and can't execute. (O)thers can't read, can't write and can't execute.
-  alias 644='chmod -R 644' # 644: (chmod a+rwx,u-x,g-wx,o-wx) sets permissions so that, (U)ser / owner can read, can write and can't execute. (G)roup can read, can't write and can't execute. (O)thers can read, can't write and can't execute.
-  alias 666='chmod -R 666' # 666: (chmod a+rwx,u-x,g-x,o-x) sets permissions so that, (U)ser / owner can read, can write and can't execute. (G)roup can read, can write and can't execute. (O)thers can read, can write and can't execute.
-  alias 755='chmod -R 755' # 755: (chmod a+rwx,g-w,o-w) sets permissions so that, (U)ser / owner can read, can write and can execute. (G)roup can read, can't write and can execute. (O)thers can read, can't write and can execute.
-  alias 764='chmod -R 764' # 764: (chmod a+rwx,g-x,o-wx) sets permissions so that, (U)ser / owner can read, can write and can execute. (G)roup can read, can write and can't execute. (O)thers can read, can't write and can't execute.
-  alias 777='chmod -R 777' # 777: (chmod a+rwx) sets permissions so that, (U)ser / owner can read, can write and can execute. (G)roup can read, can write and can execute. (O)thers can read, can write and can execute.
-
-  # Shortcuts to change ownership
-  alias chgrp='chgrp -v'           # chgrp: Change group ownership of files or directories.
-  alias chgrpr='chgrp -Rv'         # chgrpr: Change group ownership of files or directories recursively.
-  alias chgrpu='chgrp -Rv ${USER}' # chgrpu: Change group ownership of files or directories recursively to the current user.
-  alias chmod='chmod -v'           # chmod: Change file mode bits.
-  alias chmodr='chmod -Rv'         # chmodr: Change file mode bits recursively.
-  alias chmodu='chmod -Rv u+rwX'   # chmodu: Change file mode bits recursively to the current user.
-  alias chmox='chmod +x'           # chmox: Make a file executable.
-  alias chown='chown -v'           # chown: Change file owner and group.
-  alias chownr='chown -Rv'         # chownr: Change file owner and group recursively.
-  alias chownu='chown -Rv ${USER}' # chownu: Change file owner and group recursively to the current user.
-
-  # Shortcuts to set permissions for specific file types
-  alias 755d='find . -type d -exec chmod 755 {} \;' # 755d: Set permissions of all directories to rwxr-xr-x.
-  alias 644f='find . -type f -exec chmod 644 {} \;' # 644f: Set permissions of all files to rw-r--r--.
-
-  # Shortcuts to set permissions for specific user types
-  alias u+x='chmod u+x' # u+x: Add execute permission for the owner of the file.
-  alias u-x='chmod u-x' # u-x: Remove execute permission for the owner of the file.
-  alias u+w='chmod u+w' # u+w: Add write permission for the owner of the file.
-  alias u-w='chmod u-w' # u-w: Remove write permission for the owner of the file.
-  alias u+r='chmod u+r' # u+r: Add read permission for the owner of the file.
-  alias u-r='chmod u-r' # u-r: Remove read permission for the owner of the file.
-
-  alias g+x='chmod g+x' # g+x: Add execute permission for the group owner of the file.
-  alias g-x='chmod g-x' # g-x: Remove execute permission for the group owner of the file.
-  alias g+w='chmod g+w' # g+w: Add write permission for the group owner of the file.
-  alias g-w='chmod g-w' # g-w: Remove write permission for the group owner of the file.
-  alias g+r='chmod g+r' # g+r: Add read permission for the group owner of the file.
-  alias g-r='chmod g-r' # g-r: Remove read permission for the group owner of the file.
-
-  alias o+x='chmod o+x' # o+x: Add execute permission for others.
-  alias o-x='chmod o-x' # o-x: Remove execute permission for others.
-  alias o+w='chmod o+w' # o+w: Add write permission for others.
-  alias o-w='chmod o-w' # o-w: Remove write permission for others.
-  alias o+r='chmod o+r' # o+r: Add read permission for others.
-  alias o-r='chmod o-r' # o-r: Remove read permission for others.
-
-  # Shortcuts to set permissions based on octal notation
-  alias 000='chmod 000' # 000: Set permissions to ----------
-  alias 400='chmod 400' # 400: Set permissions to r--------
-  alias 444='chmod 444' # 444: Set permissions to r--r--r--
-  alias 600='chmod 600' # 600: Set permissions to rw-------
-  alias 644='chmod 644' # 644: Set permissions to rw-r--r--.
-  alias 664='chmod 664' # 664: Set permissions to rw-rw-r--.
-  alias 755='chmod 755' # 755: Set permissions to rwxr-xr-x.
-  alias 775='chmod 775' # 775: Set permissions to rwxrwxr-x.
-  alias 777='chmod 777' # 777: Set permissions to rwxrwxrwx.
+# Enhanced chmod command aliases with safety features, input validation, and structured organization.
+################################################################################
+
+
+# Ensure chmod exists before proceeding
+if command -v chmod >/dev/null; then
+
+  #-----------------------------------------------------------------------------
+  # Function: Validate input
+  # Description: Checks permission format and path validity.
+  #-----------------------------------------------------------------------------
+  validate_input() {
+    local permission="$1"
+    local path="$2"
+
+    # Check permission format (e.g., numeric octal: ###)
+    if ! [[ ${permission} =~ ^[0-7]{3}$ ]]; then
+      echo "Error: Invalid permission format '${permission}'. Expected format: ### (e.g., 644)."
+      return 1
+    fi
+
+    # Check if the path exists
+    if ! [[ -e "${path}" ]]; then
+      echo "Error: Path does not exist: '${path}'."
+      return 1
+    fi
+
+    return 0
+  }
+
+  #-----------------------------------------------------------------------------
+  # Function: Change permissions
+  # Description: Applies chmod with validation and optional recursive handling.
+  #-----------------------------------------------------------------------------
+  change_permission() {
+    local permission="$1"
+    local path="$2"
+    local recursive="${3:-}"
+
+    # Validate input
+    if ! validate_input "${permission}" "${path}"; then
+      return 1
+    fi
+
+    # Handle recursive changes with confirmation
+    if [[ "${recursive}" == "-R" ]]; then
+      local count
+      count=$(find "${path}" 2>/dev/null | wc -l)
+      read -rp "Confirm recursive change to '${permission}' for '${path}' (${count} items)? (y/N): " confirm
+      if [[ ${confirm} != [yY] ]]; then
+        echo "Operation cancelled."
+        return 1
+      fi
+    fi
+
+    # Apply permissions
+    chmod "${recursive}" "${permission}" "${path}" && \
+      echo "Permissions set to '${permission}' on '${path}'"
+  }
+
+  #-----------------------------------------------------------------------------
+  # Common Permission Aliases
+  #-----------------------------------------------------------------------------
+  alias chmod_000='change_permission 000'  # No permissions
+  alias chmod_400='change_permission 400'  # Read-only for owner
+  alias chmod_444='change_permission 444'  # Read-only for all
+  alias chmod_600='change_permission 600'  # Read/write for owner
+  alias chmod_644='change_permission 644'  # Read/write for owner, read for others
+  alias chmod_666='change_permission 666'  # Read/write for all
+  alias chmod_755='change_permission 755'  # Full for owner, read/execute for others
+  alias chmod_764='change_permission 764'  # Full for owner, read/write for group
+  alias chmod_777='change_permission 777'  # Full permissions for all
+
+  #-----------------------------------------------------------------------------
+  # User, Group, and Other Shortcuts
+  #-----------------------------------------------------------------------------
+  # User
+  alias chmod_u+x='chmod u+x'  # Add execute for owner
+  alias chmod_u-x='chmod u-x'  # Remove execute for owner
+  alias chmod_u+w='chmod u+w'  # Add write for owner
+  alias chmod_u-w='chmod u-w'  # Remove write for owner
+  alias chmod_u+r='chmod u+r'  # Add read for owner
+  alias chmod_u-r='chmod u-r'  # Remove read for owner
+
+  # Group
+  alias chmod_g+x='chmod g+x'  # Add execute for group
+  alias chmod_g-x='chmod g-x'  # Remove execute for group
+  alias chmod_g+w='chmod g+w'  # Add write for group
+  alias chmod_g-w='chmod g-w'  # Remove write for group
+  alias chmod_g+r='chmod g+r'  # Add read for group
+  alias chmod_g-r='chmod g-r'  # Remove read for group
+
+  # Others
+  alias chmod_o+x='chmod o+x'  # Add execute for others
+  alias chmod_o-x='chmod o-x'  # Remove execute for others
+  alias chmod_o+w='chmod o+w'  # Add write for others
+  alias chmod_o-w='chmod o-w'  # Remove write for others
+  alias chmod_o+r='chmod o+r'  # Add read for others
+  alias chmod_o-r='chmod o-r'  # Remove read for others
 
 fi

package/dist/lib/aliases/clear/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="66"
+  align="right"
+/>
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.466)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/clear/clear.aliases.sh

@@ -1,42 +1,71 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
-# License: MIT
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂
 # Script: clear.aliases.sh
-# Version: 0.2.466
+# Version: 0.2.469
+# Author: Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
+# Description: Enhances terminal interaction with aliases for clearing the screen,
+# navigating directories, and displaying directory contents in an organized manner.
 # Website: https://dotfiles.io
+# License: MIT
+################################################################################
 
-# 🅲🅻🅴🅰🆁 🅰🅻🅸🅰🆂🅴🆂
+# Configurable paths
+WORKSPACE_DIR="${HOME}/workspace"
 
-# Alias to change to the workspace directory
-alias cdw="cd ~/workspace"
+# Validate directory existence
+function validate_dir() {
+    if [[ ! -d "$1" ]]; then
+        echo "Directory $1 not found."
+        return 1
+    fi
+    return 0
+}
 
-# Alias to clear the terminal screen
-alias c="clear"
+# Functions for aliases
+function cd_workspace() {
+    validate_dir "${WORKSPACE_DIR}" && cd "${WORKSPACE_DIR}" || return
+}
 
-# Alias to clear the terminal screen and list the contents of the
-# current directory
-alias clc="clear && ls -a"
+function clear_screen() {
+    clear
+}
 
-# Alias to clear the terminal screen and print the current working
-# directory and the contents of the current directory
-alias cpl="clear && pwd && echo '' && ls -a && echo ''"
+function clear_list_current() {
+    clear && ls -a
+}
 
-# Alias to clear the terminal screen and print the current working
-# directory and the directory tree
-alias cplt="clear && pwd && echo '' && tree ./ && echo ''"
+function clear_pwd_list() {
+    clear && pwd && echo '' && ls -a && echo ''
+}
 
-# Alias to clear the terminal screen and print the command history
-alias clh="clear && history"
+function clear_pwd_tree() {
+    clear && pwd && echo '' && tree ./ && echo ''
+}
 
-# Alias to clear the terminal screen
-alias cl="c"
+function clear_history() {
+    clear && history
+}
 
-# Alias to clear the terminal screen and print the current
-# working directory
-alias clp="pwd"
+function print_working_dir() {
+    pwd
+}
+
+function clear_print_tree() {
+    clear && tree
+}
+
+# 🅲🅻🅴🅰🆁 🅰🅻🅸🅰🆂🅴🆂
 
-# Alias to clear the terminal screen and print the directory tree
-alias clt="clear && tree"
+# Alias definitions
+alias cdw='cd_workspace'
+alias c='clear_screen'
+alias clc='clear_list_current'
+alias cpl='clear_pwd_list'
+alias cplt='clear_pwd_tree'
+alias clh='clear_history'
+alias cl='clear_screen'
+alias clp='print_working_dir'
+alias clt='clear_print_tree'

package/dist/lib/aliases/configuration/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="66"
+  align="right"
+/>
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.466)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚
 

package/dist/lib/aliases/configuration/configuration.aliases.sh

@@ -1,47 +1,70 @@
 #!/usr/bin/env bash
 
-# 🅳🅾🆃🅵🅸🅻🅴🆂 (v0.2.466) - <https://dotfiles.io>
-# Made with ♥ in London, UK by @wwdseb
-# Copyright (c) 2015-2023. All rights reserved
-# License: MIT
+################################################################################
+# 🅳🅾🆃🅵🅸🅻🅴🆂
 # Script: configuration.aliases.sh
-# Version: 0.2.466
+# Version: 0.2.469
+# Author: Sebastien Rousseau
+# Copyright (c) 2015-2025. All rights reserved
+# Description: Script containing aliases to open configuration files in default
+# editor
 # Website: https://dotfiles.io
+# License: MIT
+################################################################################
+
+# Set default text editor
+EDITOR="${EDITOR:-vi}"
+
+# Apache aliases
+# ------------------------------------------------------------------------------
+
+# Open Apache configuration file in default text editor
+alias edit_apache_config='${EDITOR} /etc/apache2/apache2.conf'
+
+# Bash aliases
+# ------------------------------------------------------------------------------
+
+# Open Bash configuration file in default text editor
+alias edit_bashrc='${EDITOR} $HOME/.bashrc'
+
+# Open Bash profile in default text editor
+alias edit_bash_profile='${EDITOR} $HOME/.bash_profile'
 
-# 🅲🅾🅽🅵🅸🅶🆄🆁🅰🆃🅸🅾🅽 🅰🅻🅸🅰🆂🅴🆂
+# Docker aliases
+# ------------------------------------------------------------------------------
 
-# Alias to open the Apache configuration file in the default text editor
-alias apconf='${=EDITOR} /etc/apache2/apache2.conf'
+# Open Docker Compose file in default text editor
+alias edit_docker_compose='${EDITOR} docker-compose.yml'
 
-# Alias to open the Bash configuration file in the default text editor
-alias bshrc='${=EDITOR} $HOME/.bashrc'
+# General aliases
+# ------------------------------------------------------------------------------
 
-# Alias to open the Bash profile in the default text editor
-alias bshp='${=EDITOR} $HOME/.bash_profile'
+# Open current directory in default text editor
+alias edit_current_directory='${EDITOR} .'
 
-# Alias to open the Docker Compose file in the default text editor
-alias dockcomp='${=EDITOR} docker-compose.yml'
+# Git aliases
+# ------------------------------------------------------------------------------
 
-# Alias to open the current directory in the default text editor
-alias eddir='${=EDITOR} .'
+# Open Git configuration file in default text editor
+alias edit_git_config='${EDITOR} $HOME/.gitconfig'
 
-# Alias to open the Git configuration file in the default text editor
-alias gcfg='${=EDITOR} $HOME/.gitconfig'
+# Open Git ignore file in default text editor
+alias edit_git_ignore='${EDITOR} $HOME/.gitignore'
 
-# Alias to open the Git ignore file in the default text editor
-alias gign='${=EDITOR} $HOME/.gitignore'
+# System config aliases
+# ------------------------------------------------------------------------------
 
-# Alias to open the hosts file in the default text editor
-alias hosts='${=EDITOR} /etc/hosts'
+# Open hosts file in default text editor
+alias edit_hosts='${EDITOR} /etc/hosts'
 
-# Alias to open the Nginx configuration file in the default text editor
-alias ngconf='${=EDITOR} /etc/nginx/nginx.conf'
+# Open Nginx configuration file in default text editor
+alias edit_nginx_config='${EDITOR} /etc/nginx/nginx.conf'
 
-# Alias to open the SSH configuration file in the default text editor
-alias sshconf='${=EDITOR} $HOME/.ssh/config'
+# Open SSH configuration file in default text editor
+alias edit_ssh_config='${EDITOR} $HOME/.ssh/config'
 
-# Alias to open the Zsh configuration file in the default text editor
-alias zshrc='${=EDITOR} $HOME/.zshrc'
+# Open Zsh configuration file in default text editor
+alias edit_zshrc='${EDITOR} $HOME/.zshrc'
 
-# Alias to open the Zsh profile in the default text editor
-alias zshp='${=EDITOR} $HOME/.zsh_profile'
+# Open Zsh profile in default text editor
+alias edit_zsh_profile='${EDITOR} $HOME/.zsh_profile'

package/dist/lib/aliases/default/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="66"
+  align="right"
+/>
 
 <!-- markdownlint-enable MD033 MD041 -->
 
-# Dotfiles (v0.2.466)
+# Dotfiles (v0.2.469)
 
 Simply designed to fit your shell life 🐚