bsupdate

(Bash Script Update)

A drop in bash script that can be added to any bash application/CLI to automate updating

If you have a bash application/script that has an installer script and you host the project on github this script can automate updating.

Usage

First clone the repository. git clone https://github.com/alexanderepstein/bsupdate
Git checkout to the latest stable version git checkout v1.0.2
Then edit the update utility.sh file located in the repository and change the variables at the top of the file to configure your updates. Read the comments on the variables to make sure that you do this correctly
Run chmod on the updateutility.sh file to make it executable chmod a+x updateutility.sh
Copy the file over to the root directory of your project
In the main script of your application add the ability to use either -u or --update and run my update utility.sh file (Look at the section on this on the README if don't already know how to implement this)
Inside of your installer script make sure to copy this file next to wherever your main application script sits so the previous step works as expected
Make sure to check the assumptions section of the README as if these assumptions are not met it will not work without some tinkering

Assumptions

Your installer file is titled install.sh and it sits in the root directory of your repository (if not look into changing the installer file call in updateutility.sh)
All updates come through the form of github releases. Every github release tag should start with a v and you don't create a release for unstable versions.

Adding the -u/--update functionality in your script

The latter of the two options presented here allows for both -u and --update while the first only works with -u

If you are already using bash options this is what adding the -u functionality would look like

while getopts ":uvrghts::" opt; do
  case $opt in
    \?)
      echo "Invalid option: -$OPTARG" >&2
      exit 1
      ;;
    t)
      #do stuff
    ;;
    h)
      #do stuff
    ;;
    u)
      ./updateutility.sh #calling the update utility
    ;;
    :)
      echo "Option -$OPTARG requires an argument." >&2
      exit 1
      ;;
  esac
done

If you aren't using bash options then it would make more sense to do the following at the top of your script

if [[ "$1" == "--update" || "$1" == "-u" ]]; then
	./updateutility.sh ## calling the update utility
	exit 0
fi

Donate

If this project helped you in any way and you feel like buying a broke college kid a cup of coffee

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Dedsec1 / bsupdate