[WIP] First Release

README.md

@@ -1,4 +1,28 @@
 Utils
 =====
 
-Small tools
+Small Shell Tools
+
+
+Install
+-------
+
+### Installation
+
+Utils must be installed in ~/utils.
+
+To install, run `git clone https://github.com/adriendupuis/utils.git -b master ~/utils && ~/utils/install.sh ${0##-};`
+
+### Maintenance
+
+- `utils-update`: Update utils to last master release
+- `utils-install <version>`: Install a given version of Utils, the version can be a tag, a branch or a commit
+- `utils-version`: Get actual Utils version
+
+
+TODO
+----
+
+* Uninstall doc and tool
+* Portage (originally done with macOs Catalina, ensure that it works on other unixoids)
+* Unit tests

aliases.sh

@@ -0,0 +1,20 @@
+source ~/utils/functions.sh;
+
+alias utils-install='utils-update';
+alias utils-update='_utils_update';
+alias utils-version='_utils_version';
+
+alias git-graph='git log --all --graph --date-order --oneline --decorate';
+alias git-current-branch='git rev-parse --abbrev-ref HEAD';
+alias git-current-commit='git rev-parse --verify --short HEAD';
+alias git-current-tag='git fetch --tags --force --quiet && git describe --tags 2> /dev/null';
+alias git-tag-list='git fetch --tags --force --quiet && git tag --sort=-committerdate --format "%(refname:short)%09%(committerdate:short)%09%(objectname:short=8)"';
+alias git-reset='git reset --hard origin/$(git-current-branch)';
+alias git-clean-local-branches='git fetch --prune --quiet && git branch -vv | grep -v  "^\*" | grep "\[.*: gone\]" | cut -d " " -f 3 | xargs git branch --delete';
+alias git-force-pull='git fetch --force && git pull --force';
+alias git-delete-tag='_git_delete_tag';
+alias git-global-ignore='git config --global core.excludesfile "~/utils/gitignore"';
+
+alias sf-cs-fix='php-cs-fixer fix --rules=@Symfony';
+
+alias gz='gzip --keep';

functions.sh

@@ -0,0 +1,54 @@
+function _utils_update {
+  cd ~/utils;
+
+  target=${1:-master};
+  previous=$(_utils_version);
+
+  git fetch --quiet;
+  git checkout --quiet "$target" 2> /dev/null;
+  if [[ 0 -lt $? ]]; then
+    echo "Error: can't checkout $target";
+    return;
+  fi;
+  git pull --quiet;
+
+  current=$(_utils_version);
+
+  if [[ "$current" == "$previous" ]] && [[ '' == "$(git status | grep 'modified:')" ]]; then
+    echo "Info: Utils is up-to-date and at $current";
+  else
+    rc=~/.${SHELL##*/}rc;
+    if [[ -f $rc ]]; then
+      source $rc;
+      echo "Info: $rc reloaded.";
+    else
+      source ~/utils/aliases.sh;
+      echo 'Notice: ~/utils/aliases.sh reloaded. Shell RC file might need a manual reload too.';
+    fi;
+    echo "Info: Utils updated from $previous to $current.";
+  fi
+}
+
+function _utils_version {
+  cd ~/utils;
+
+  git fetch --tags --quiet;
+  version=$(git describe --tags 2> /dev/null);
+  if [ -z "$version" ]; then
+    version=$(git rev-parse --verify --short HEAD);
+  fi;
+
+  echo "$version";
+
+  cd - > /dev/null;
+}
+
+function _git_delete_tag {
+  if [[ 1 -eq $# ]]; then
+    git tag -d $1;
+    git push --delete origin $1;
+  elif [[ 2 -eq $# ]]; then
+    git tag -d $2;
+    git push --delete $1 $2;
+  fi;
+}

gitignore

@@ -0,0 +1,5 @@
+# Global core.excludesfile
+.idea/
+.php_cs.cache
+.php-cs-fixer.cache
+.DS_Store

install.sh

@@ -0,0 +1,33 @@
+# First installation script (just after having cloned the repository)
+
+if [[ `basename $1` = 'zsh' ]]; then
+  rc='zshrc';
+elif [[ `basename $1` = 'bash' ]]; then
+  rc='bashrc';
+else
+  echo "Error: Unsupported shell.";
+  exit 1;
+fi;
+
+source ~/utils/text.sh;
+ERROR="${TXT_FG_WHITE}${TXT_BG_RED}";
+WARNING="${TXT_FG_BLACK}${TXT_BG_YELLOW}";
+COMMENT="${TXT_FG_BLUE}";
+RESET=$TXT_RESET;
+
+if [[ -f ~/utils/rc/$rc ]]; then
+  if [[ -z `grep "/utils/rc/$rc" ~/.$rc;` ]]; then
+    echo "Status: Load ~/utils/rc/${rc} into ~/.${rc}…";
+
+    echo '' >> ~/.$rc;
+    echo '# https://github.com/adriendupuis/utils' >> ~/.$rc;
+    echo "source \$HOME/utils/rc/$rc" >> ~/.$rc;
+
+    echo -e "${COMMENT}Notice: Utils will be automatically available in next terminals. If Utils is needed in the current one, the following command can be run:";
+    echo -e "source ~/.$rc;${RESET}";
+  else
+    echo "Info: ~/utils/rc/$rc already loaded from ~/.$rc.";
+  fi;
+else
+  echo -e "${WARNING}Warning: No “rc” file available for this shell.${RESET}"
+fi;

rc/bashrc

@@ -0,0 +1 @@
+source $HOME/utils/aliases.sh;

rc/zshrc

@@ -0,0 +1,2 @@
+setopt interactivecomments; # Allow to have a comment in a command line; Avoid error like "zsh: command not found: #"
+source $HOME/utils/aliases.sh;

text-test.bash

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+source text.sh;
+
+echo -e "${TXT_BLINK}${TXT_UNDERLINE}${TXT_FG_GREEN}gr${TXT_REVERSE}e${TXT_REVERSE_RESET}en${TXT_RESET}!";
+
+ERROR="${TXT_FG_WHITE}${TXT_BG_RED}";
+WARNING="${TXT_FG_BLACK}${TXT_BG_YELLOW}";
+COMMENT="${TXT_FG_BLUE}";
+RESET=$TXT_RESET;
+
+echo -e "${ERROR}Error${RESET}"
+echo -e "${WARNING}Warning${RESET}"
+echo -e "${COMMENT}Comment${RESET}"

text-test.zsh

@@ -0,0 +1,14 @@
+#!/usr/bin/env zsh
+
+source text.sh;
+
+echo -e "${TXT_BLINK}${TXT_UNDERLINE}${TXT_FG_GREEN}gr${TXT_REVERSE}e${TXT_REVERSE_RESET}en${TXT_RESET}!";
+
+ERROR="${TXT_FG_WHITE}${TXT_BG_RED}";
+WARNING="${TXT_FG_BLACK}${TXT_BG_YELLOW}";
+COMMENT="${TXT_FG_BLUE}";
+RESET=$TXT_RESET;
+
+echo -e "${ERROR}Error${RESET}"
+echo -e "${WARNING}Warning${RESET}"
+echo -e "${COMMENT}Comment${RESET}"

text.sh

@@ -0,0 +1,56 @@
+
+# Cancel Format and Color
+TXT_RESET='\x1B[0m';
+
+# Text Format
+TXT_BOLD='\x1B[1m';
+TXT_BOLD_RESET='\x1B[21m';
+TXT_DIM='\x1B[2m';
+TXT_DIM_RESET='\x1B[22m';
+TXT_UNDERLINE='\x1B[4m';
+TXT_UNDERLINE_RESET='\x1B[24m';
+TXT_BLINK='\x1B[5m';
+TXT_BLINK_RESET='\x1B[25m';
+TXT_REVERSE='\x1B[7m';
+TXT_REVERSE_RESET='\x1B[27m';
+TXT_HIDDEN='\x1B[8m';
+TXT_HIDDEN_RESET='\x1B[28m';
+
+# Text Color
+## Default
+TXT_FG_DEFAULT='\x1B[39m';
+TXT_BG_DEFAULT='\x1B[49m';
+## Gray Levels
+TXT_FG_BLACK='\x1B[30m';
+TXT_BG_BLACK='\x1B[40m';
+TXT_FG_DARK_GRAY='\x1B[90m';
+TXT_BG_DARK_GRAY='\x1B[100m';
+TXT_FG_LIGHT_GRAY='\x1B[37m';
+TXT_BG_LIGHT_GRAY='\x1B[47m';
+TXT_FG_WHITE='\x1B[97m';
+TXT_BG_WHITE='\x1B[107m';
+## Colors
+TXT_FG_RED='\x1B[31m';
+TXT_BG_RED='\x1B[41m';
+TXT_FG_LIGHT_RED='\x1B[91m';
+TXT_BG_LIGHT_RED='\x1B[101m';
+TXT_FG_GREEN='\x1B[32m';
+TXT_BG_GREEN='\x1B[42m';
+TXT_FG_LIGHT_GREEN='\x1B[92m';
+TXT_BG_LIGHT_GREEN='\x1B[102m';
+TXT_FG_YELLOW='\x1B[33m';
+TXT_BG_YELLOW='\x1B[43m';
+TXT_FG_LIGHT_YELLOW='\x1B[93m';
+TXT_BG_LIGHT_YELLOW='\x1B[103m';
+TXT_FG_BLUE='\x1B[34m';
+TXT_BG_BLUE='\x1B[44m';
+TXT_FG_LIGHT_BLUE='\x1B[94m';
+TXT_BG_LIGHT_BLUE='\x1B[104m';
+TXT_FG_MAGENTA='\x1B[35m';
+TXT_BG_MAGENTA='\x1B[45m';
+TXT_FG_LIGHT_MAGENTA='\x1B[95m';
+TXT_BG_LIGHT_MAGENTA='\x1B[105m';
+TXT_FG_CYAN='\x1B[36m';
+TXT_BG_CYAN='\x1B[46m';
+TXT_FG_LIGHT_CYAN='\x1B[96m';
+TXT_BG_LIGHT_CYAN='\x1B[106m';