ksau: Bump to version 1.5.1 (Stable).

* ksau: Add new argument handler to rename file with random string.
* ksau: Update readme.
* ksau: Bump to version 1.5.1 (Stable).

Author: Sauraj

.gitignore

@@ -0,0 +1 @@
+log

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
@@ -31,11 +29,11 @@ sudo curl https://rclone.org/install.sh 2>/dev/null | sudo bash > /dev/null 2>&1
 echo ""
 echo "${orange}Please install jq manually, No script found"
 echo "Possibly with 
-			${aqua}sudo apt-get install jq ${normal}OR 
-			${aqua}sudo pacman -S jq ${normal}OR 
+			${aqua}sudo apt-get install jq ${normal}OR
+			${aqua}sudo pacman -S jq ${normal}OR
 			${aqua}sudo dnf install jq ${normal}OR
 			${aqua}sudo zypper install jq ${normal}OR
-			${aqua}apk add jq ${normal}OR 
+			${aqua}apk add jq ${normal}OR
 			${aqua}pkg install jq${normal}"
 echo ''
 }
@@ -61,19 +59,36 @@ setup () {
 		then
 			echo "${aqua}Dependencies not found. Make sure to proceed with the command 'ksau dependencies'"
 			echo "${aqua}Please install jq manually, No script found"
-			echo "Possibly with 
-					${aqua}sudo apt-get install jq ${normal}OR 
-					${aqua}sudo pacman -S jq ${normal}OR 
+			echo "Possibly with
+					${aqua}sudo apt-get install jq ${normal}OR
+					${aqua}sudo pacman -S jq ${normal}OR
 					${aqua}sudo dnf install jq ${normal}OR
 					${aqua}sudo zypper install jq ${normal}OR
-					${aqua}apk add jq ${normal}OR 
+					${aqua}apk add jq ${normal}OR
 					${aqua}pkg install jq${normal}"
 			exit
 		fi
 	fi
 	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 [ -z "$extension" ]; then
+    new_filename="$name-$random_string"
+  else
+    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)" "..." "..." "..."
@@ -106,12 +121,14 @@ 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..."
     rm -f log
     touch log
-	rclone -P --checkers=32 --onedrive-chunk-size 60M copy "$file" oned:/"${u_folder}" | tee log >/dev/null || touch "$status_dir/failed" &
+    if [ -z "$new_filename" ]; then new_filename=$(basename "$file"); fi
+	rclone -P --checkers=32 --onedrive-chunk-size 60M copyto "$file" oned:/"${u_folder}"/"$new_filename" | tee log >/dev/null || touch "$status_dir/failed" &
     until [ -z "$(jobs -r)" ]; do
         if [ -f "$status_dir/failed" ]; then
             echo
@@ -124,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
 
@@ -194,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
@@ -203,29 +223,37 @@ upload () {
       exit 1
   fi
   end_animation  
-  u_file=$(basename "${file}")
-  url_file=$(url_encode "$u_file")
-	url_folder=$(jq -rn --arg x "${u_folder}" '$x|@uri')
+  url_file=$(url_encode "${new_filename}")
+	url_folder=$(jq -rn --arg x "${u_folder%/}" '$x|@uri')
 	echo " Upload Completed "
 	echo " Download link - ${lightgreen}https://index.sauraj.eu.org/${url_folder}/${url_file}${normal} "
 }
 
 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}Usage : ksau <options> <params>${normal}
+${aqua}setup${normal}                     : Recquired while using first time.
 
-${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}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.
 
 Example : ${lightgreen}ksau upload test.txt Public
 
 ${orange}Tool By Sauraj (@Ksauraj)${normal}
-
 "
 }	
 
@@ -242,22 +270,35 @@ update () {
 }
 
 version () {
-	echo "${orange}Version - 1.4.2 (Stable) ${normal}"
+	echo "${orange}Version - 1.5.1 (Stable) ${normal}"
 }
 
 if [[ $1 == "upload" ]]; then
-upload
+    if [[ $2 == "-r" ]]; then
+        shift
+        readonly file="$2"
+        readonly u_folder="$3"
+        add_random_string $(basename "$file")
+        upload
+    else
+        readonly file="$2"
+        readonly u_folder="$3"
+        upload
+    fi
 elif [[ $1 == "setup" ]]; then
-setup
+    setup
 elif [[ $1 == "dependencies" ]]; then
-dependencies
+    dependencies
 elif [[ $1 == "update" ]]; then
-update
+    update
 elif [[ $1 == "version" ]]; then
-version
+    version
 elif [[ $1 == "help" ]]; then
-help
+    help
 elif [[ $1 == "" ]]; then
-help
+    help
+else
+    echo "Unknown Argument passed."
+    help
 fi