code reverted to v1.2

Author: OurCodeBase

src/ask.sh

@@ -14,62 +14,47 @@ source "${Dir}"/string.sh
 # source string.sh
 
 # Stores object that you selected.
-askObject='';
+askChoice='';
 # Stores position of object that you selected.
-askPosition='';
+askReply='';
 
-# ask.case(title) ~ bool
-# This takes case ( yes or no ) for any work.
-#
+# ask.case(title) -> bool
+#   This takes case ( yes or no ) for any work.
 # Args:
-# - title (str): takes title (eg: You're Agree).
+#   title (str) > takes title (eg: You're Agree).
 ask.case(){
   echo -ne "\n    ${1}";
   read -p " ? [Y/n] " ARGS;
   echo;
   case "${ARGS}" in
-    y|Y|'') 
-      return 0;
-    ;;
-    n|N) 
-      say.error "Process Aborted.\n";
-      exit 1;
-    ;;
-    *) say.error "You have to enter only \n
-      \t\t 'Y' for Yes & \n
-      \t\t 'n' for No.\n";
-      exit 1;
-    ;;
+    y|Y|'') return 0;;
+    n|N) { say.error "Process Aborted.\n" && exit 1; };;
+    *) { say.error "You have to enter only \n\t\t'Y' for Yes & \n\t\t'n' for No.\n" && exit 1; };;
   esac
 }
 
-# ask.choice(title,list) ~ var
-# This creates a simple menu.
-# 
+# ask.choice(title,list) -> var
+#   This creates a simple menu.
 # Args:
-# - title (str): takes title (eg: Choose One).
-# - list (array): takes array as arg.
-#
+#   title (str) > takes title (eg: Choose One).
+#   list (array) > takes array as arg.
 # Returns:
-# - var (str): result in 'askObject' & 'askPosition' variables.
+#   object (str) > result in 'askChoice' & 'askReply' variables.
 ask.choice(){
   PS3="
-  ${1}: ";
+  ${1} > ";
   shift;
   local ARGs=("${@}");
   echo;
   select ARG in "${ARGs[@]}"
   do
-    if text.isdigit "${REPLY}"; then
-      say.error "You can only input 'digits'.\n";
-      exit 1;
-    elif [[ "${REPLY}" -gt "${#ARGs[@]}" ]]; then
-      say.error "You should input correct digits.\n";
-      exit 1;
-    else
-      askObject="${ARG}";
-      askPosition="${REPLY}";
-      break;
-    fi
+    text.isdigit "${REPLY}" || {
+      say.error "You can only input 'digits'.\n" && exit 1;
+    };
+    [[ "${REPLY}" -gt "${#ARGs[@]}" ]] &&
+    say.error "You should input correct digits.\n" && exit 1;
+    askChoice="${ARG}";
+    askReply="${REPLY}";
+    break;
   done
-}
+}

src/cursor.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 # setCursor(on~off)
-# Switch terminal cursor easily.
+#   Switch terminal cursor easily.
 setCursor(){
   setterm -cursor "${1}";
 }

src/db.sh

@@ -1,83 +1,95 @@
 #!/bin/bash
 
-# Supports only yaml syntax database.
+# Support only Yaml syntax database.
 
-# _db.isKeyExist(key,file) ~ bool
-# Checks that key is exist or not.
-# 
+# _db.isfile(file) -> bool
+#   Checks that db file exist or not.
 # Args:
-# - key (str): takes key of db.
-# - file (str): takes file path.
-_db.isKeyExist(){
+#   file (str) > takes file path.
+_db.isfile(){
+  # checking file exist or not.
+  test -f "${1}";
+}
+
+# _db.iskey(key,file) -> bool
+#   Checks that key is exist or not.
+# Args:
+#   key (str) > takes key of db.
+#   file (str) > takes file path.
+_db.iskey(){
   grep "${1}: " "${2}" &>/dev/null;
 }
 
-# db.read(key,file) ~ str
-# Reads value of given key in db file.
-# 
+# db.read(key,file) -> str
+#   Give you data of key of yaml db.
 # Args:
-# - key (str): takes key of db.
-# - file (str): takes file path.
+#   key (str) > takes key of db.
+#   file (str) > takes file path.
 db.read(){
   # checking args given or not.
   [[ ${#} -eq 2 ]] ||
   { echo "error: 'missing args'" && return 1; };
-  _db.isKeyExist "${1}" "${2}" ||
+  _db.iskey "${1}" "${2}" ||
   { echo "error: ${1}: 'key not exists'" && return 1; };
   local dbValue="$(grep "${1}: " "${2}")";
   echo "${dbValue}" | awk -F': ' '{sub(/^[^:]*: /, ""); print}';
 }
 
 # db.create(key,value,file)
-# Creates data key and value to db.
-#  
+#   Adds data key and value to db.
 # Args:
-# - key (str): takes key of db.
-# - value (str): takes value of key.
-# - file (str): takes file path.
+#   key (str) > takes key of db.
+#   value (str) > takes value of key.
+#   file (str) > takes file path.
 db.create(){
   # checking args given or not.
   [[ ${#} -eq 3 ]] ||
   { echo "error: 'missing args'" && return 1; };
-  _db.isKeyExist "${1}" "${3}" &&
+  _db.iskey "${1}" "${3}" &&
   { echo "error: ${1}: 'key already exists'" && return 1; };
   echo -ne "\n${1}: ${2}" >> "${3}";
 }
 
 # db.update(key,value,file)
-# Update data of key in db file.
-#  
+#   Update data of key in db file.
 # Args:
-# - key (str): takes key of db.
-# - value (str): takes update value of key.
-# - file (str): takes file path.
+#   key (str) > takes key of db.
+#   value (str) > takes update value of key.
+#   file (str) > takes file path.
 db.update(){
   # checking args given or not.
   [[ ${#} -eq 3 ]] ||
   { echo "error: 'missing args'" && return 1; };
-  _db.isKeyExist "${1}" "${3}" ||
+  _db.iskey "${1}" "${3}" ||
   { echo "error: ${1}: 'key not exists'" && return 1; };
+  # taking key arg.
   local dbKey="${1}";
-  local dbUpdateValue="${2}";
+  # taking update value of given key.
+  local dbUpdatedValue="${2}";
+  # taking db file path.
   local dbFile="${3}";
-  local dbCurrentValue="$(db.read "${dbKey}" "${dbFile}")";
-  local dbCurrentPair="${dbKey}: ${dbCurrentValue}"; # concated to create pair.
-  local dbCurrentPairPos="$(grep -n "${dbCurrentPair}" "${dbFile}" | cut -d: -f1 | head -n 1;)";
-  local dbUpdatedPair="${dbCurrentPair/${dbCurrentValue}/"${dbUpdateValue}"}";
-  sed -i "${dbCurrentPairPos}c\\${dbUpdatedPair}" "${dbFile}"; # replaced full pair.
+  # getting old value of given key.
+  local dbValue="$(db.read "${dbKey}" "${dbFile}")";
+  # concating key and old value.
+  local dbKeyValuePair="${dbKey}: ${dbValue}";
+  # getting position of concated line in file.
+  local dbKeyValuePairPos="$(grep -n "${dbKeyValuePair}" "${dbFile}" | cut -d: -f1 | head -n 1;)";
+  # replacing value from old to new.
+  local dbUpdatedKeyValuePair="${dbKeyValuePair/${dbValue}/"${dbUpdatedValue}"}";
+  # placing updated value to position.
+  sed -i "${dbKeyValuePairPos}c\\${dbUpdatedKeyValuePair}" "${dbFile}";
 }
 
 # db.delete(key,file)
-# Delete key and value of db file.
-#  
+#   Delete key and value of db file.
 # Args:
-# - key (str): takes key of db.
-# - file (str): takes file path.
+#   key (str) > takes key of db.
+#   file (str) > takes file path.
 db.delete(){
   # checking args given or not.
   [[ ${#} -eq 2 ]] ||
   { echo "error: 'missing args'" && return 1; };
-  _db.isKeyExist "${1}" "${2}" ||
+  _db.iskey "${1}" "${2}" ||
   { echo "error: ${1}: 'key not exists'" && return 1; };
   local dbKey="${1}: ";
   local dbFile="${2}";