# My Shell Scripts
This is the centralized repository of all my personal shell scripts which I use for a number of different purposes.

**Important:**  I am a novice programmer and I bear no responsibility whatsoever if any of these scripts that I have written wipes your computer, destroys your data, crashes your car, or otherwise causes mayhem and destruction.  USE AT YOUR OWN RISK.

## What's here

* **etc/** - This directory contains the various configuration files for the scripts contained elsewhere.  More information is in the folder's `README`.
* **lib/** - Located in this folder are a number of shared scripting libraries that I use throughout my other scripts.  More information is in the folder's `README`.
* **macControl/** - A collection of Scripts used by Mac applications.  For example: Allow [ControlPlane][8] to run a key command.
* **setupScripts/** - This directory contains my scripts that configure new computers from scratch.  Detailed information is in the folder's `README`.These scripts perform such tasks as:
	* Insalling [Homebrew][1] & associated packages
	* Installing mac applications using [Homebrew Cask][2]
	* Configuring OSX
	* Syncing user preferences and files using [Mackup][3]
	* Installing [RVM][4] and associated Gems
	* Pushing a new SSH key to Github
* **syncScripts/** - I use [RSYNC][5] and [Unison][6] all the time to sync various computers, drives, and servers.  More information is in the folder's `README`.

## Usage
Each of the directories has its own README file which describes in more depth how to use the script(s) contained within.  Most of the scripts here won't work without the scripting utilities in `lib/`.

## Versioning

This project implements the Semantic Versioning guidelines.

Releases will be numbered with the following format:

`<major>.<minor>.<patch>`

And constructed with the following guidelines:

* Breaking backward compatibility bumps the major (and resets the minor and patch)
* New additions without breaking backward compatibility bumps the minor (and resets the patch)
* Bug fixes and misc changes bumps the patch

For more information on SemVer, please visit [SemVer][7].

[1]: http://brew.sh
[2]: http://caskroom.io
[3]: https://github.com/lra/mackup
[4]: https://rvm.io
[5]: http://en.wikipedia.org/wiki/Rsync
[6]: http://www.cis.upenn.edu/~bcpierce/unison/
[7]: http://semver.org
[8]: http://www.controlplaneapp.com/