ksau: Bump to version 1.5.1 (Stable).

Author: ksauraj

README.md

@@ -31,7 +31,7 @@ ksau dependencies
 
 ### To upload
 ```
-ksau upload <filename> <folder to upload>
+ksau upload [FILE] [FOLDER] # Uploads the given file to the given folder on index.
 #Example - ksau upload test.txt Public
 ```
 
@@ -46,19 +46,34 @@ ksau version
 ```
 ## Usage
 ```
-upload <filename> <folder to upload>${normal} : Uploads the given file to the given folder.
-setup : Recquired while using first time.
-update : Fetch and install latest version available.
-dependencies : Installs recquired dependencies.
-help : To get this message.
-version: To get version info.
+Usage : ksau [OPTION]... [FILE]...
+
+upload [FILE] [FOLDER]    : Uploads the given file to the given folder
+                            on index.
+
+upload -r [FILE] [FOLDER] : Uploads the given file to the given folder
+                            but with new filename with random strings
+                            at last (before extension if present).
+
+setup                     : Recquired while using first time.
+
+update                    : Fetch and install latest version available.
+
+dependencies              : Installs recquired dependencies.
+
+help                      : To get this message.
+
+version                   : To get version info.
+
+Example : ksau upload test.txt Public
+
 ```
 
 ### Abuse alert
 Please don't abuse, we have limited storage.
 Also I'm sharing my configs just for community use and I get nothing from it.
 
 ### Create Your Own
-Just change your `rclone config` and `index link` in `ksau` (L40 & L71).
+Just change your `rclone config` and `index link` in `ksau`.
 
 ### Tool By @Ksauraj (@noobyysauraj)

ksau

@@ -16,8 +16,6 @@ Cyan='\033[0;36m'   # Cyan
 White='\033[0;37m'  # White
 
 set -o pipefail
-#readonly file="$2"
-#readonly u_folder="$3"
 readonly status_dir="$(mktemp -d)"
 
 trap "rm -rf $status_dir" EXIT
@@ -74,18 +72,23 @@ setup () {
 	echo "Setup Completed"
 }
 
+# Generates new filename with random strings at last (before extension if present).
+# new name for 'myfile.txt' -> 'myfile-78e11b8c.txt'
+# new name for 'myfile' -> 'myfile-78e11b8c'
 add_random_string() {
   local filename="$1"
   local extension="${filename##*.}"
   local name="${filename%.*}"
   local random_string="$(date +%s | sha256sum | base64 | head -c 8)"
-  if [ "$extension" == "$filename" ]; then
-  new_filename="$name-$random_string"
+  if [ -z "$extension" ]; then
+    new_filename="$name-$random_string"
   else
-  new_filename="$name-$random_string.$extension"
+    new_filename="$name-$random_string.$extension"
   fi
 }
 
+# Simple progressbar animation.
+# Usage : progress_bar ${percentage} ${upload_speed} $(eta) ${status}
 progress_bar() {
     if [ "$(tput cols)" -lt 84 ]; then
         [ -z $1 ] && set -- "(Starting)" "..." "..." "..."
@@ -118,6 +121,7 @@ progress_bar() {
     fi
 }
 
+# Upload file to give folder and use new filename if -r argument was passed and printing out new animation.
 rclone_progress_bar() {
     tput civis
     echo "Starting download..."
@@ -137,6 +141,8 @@ rclone_progress_bar() {
     done #|| echo -ne "\rDownload Can't be completed, Check download link." && tput cnorm && exit 1
     tput cnorm
 }
+
+# Final part of animation if upload was succesfull.
 end_animation() {
     tput civis
 
@@ -207,6 +213,7 @@ function url_encode() {
         -e 's/~/%7e/g'
 }
 
+# rclone_progress_bar -> progress_bar -> end_animation -> Print dowload link.
 upload () {
 	echo "Initializing process, might take up to 10 seconds..."
   rclone_progress_bar
@@ -224,20 +231,29 @@ upload () {
 
 help ()  {
 echo "
+${aqua}Usage : ksau [OPTION]... [FILE]...${normal}
+
+${aqua}upload [FILE] [FOLDER]${normal}    : Uploads the given file to the given folder
+                            on index.
+
+${aqua}upload -r [FILE] [FOLDER]${normal} : Uploads the given file to the given folder
+                            but with new filename with random strings
+                            at last (before extension if present).
+
+${aqua}setup${normal}                     : Recquired while using first time.
 
-${aqua}Usage : ksau <options> <params>${normal}
+${aqua}update${normal}                    : Fetch and install latest version
+                            available.
 
-${aqua}upload <filename> <folder to upload>${normal} : Uploads the given file to the given folder.
-${aqua}setup${normal} : Recquired while using first time.
-${aqua}update${normal} : Fetch and install latest version available.
-${aqua}dependencies${normal} : Installs recquired dependencies.
-${aqua}help${normal} : To get this message.
-${aqua}version${normal} : To get version info.
+${aqua}dependencies${normal}              : Installs recquired dependencies.
+
+${aqua}help${normal}                      : To get this message.
+
+${aqua}version${normal}                   : To get version info.
 
 Example : ${lightgreen}ksau upload test.txt Public
 
 ${orange}Tool By Sauraj (@Ksauraj)${normal}
-
 "
 }	
 
@@ -254,7 +270,7 @@ update () {
 }
 
 version () {
-	echo "${orange}Version - 1.5 (Stable) ${normal}"
+	echo "${orange}Version - 1.5.1 (Stable) ${normal}"
 }
 
 if [[ $1 == "upload" ]]; then