Added version release changes.

- Simplified more of the process.
- Reduced what is required/optional.
- Clarified the help comments.

[ci skip]

.github/ISSUE_TEMPLATE.md

@@ -1,16 +1,11 @@
-## Expected Behavior
-<!-- Required. Describe, in detail, the behavior experienced. -->
-
-## Actual Behavior
-<!-- Required. Describe, in detail, what should be the correct behavior. -->
+## Overview
+<!-- Required. Describe, in detail, the behavior experienced and what is desired. -->
 
 ## Steps to Recreate
-<!-- Required. List the exact steps to the reproduce errant behavior. -->
+<!-- Optional. List exact steps (numbered list) to reproduce errant behavior. Delete if unused. -->
 
-0.
+## Screenshots/Screencasts
+<!-- Optional. Attach screenshot/screencast(s) that demo the behavior. Delete if unused. -->
 
 ## Environment
 <!-- Optional. What is your operating system, software version(s), etc. Delete if unused. -->
-
-## Screenshots/Screencasts
-<!-- Optional. Attach screenshots/screencasts that demo the behavior. Delete if unused. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,10 +2,10 @@
 <!-- Required. Why is this important/necessary? -->
 
 ## Details
-<!-- Optional. List the key features/highlights as bullet points. -->
+<!-- Optional. List the key features/highlights as bullet points. Delete if unused. -->
 
 ## Notes
 <!-- Optional. List additional notes/references as bullet points. Delete if unused. -->
 
 ## Screenshots/Screencasts
-<!-- Optional. Provide image/video support. Delete if unused. -->
+<!-- Optional. Provide supporting image/video. Delete if unused. -->

.ruby-version

@@ -0,0 +1 @@
+2.4.1

CHANGES.md

@@ -1,3 +1,23 @@
+# v2.2.0 (2017-07-16)
+
+- Added Git Cop support.
+- Updated CONTRIBUTING documentation.
+- Updated GitHub templates.
+- Updated README headers.
+- Updated gem dependencies.
+
+# v2.1.0 (2017-04-29)
+
+- Fixed Java SE Development Kit install.
+- Fixed install-all command
+
+# v2.0.0 (2017-04-09)
+
+- Added Homebrew Casks install script.
+- Updated README semantic versioning order.
+- Updated contributing documentation.
+- Refactored Homebrew software as Homebrew Formulas.
+
 # v1.3.1 (2017-01-08)
 
 - Fixed install of zip app downloads with sub-directories.

CONTRIBUTING.md

@@ -1,35 +1,22 @@
-# Overview
+# Contributing
 
-Thanks for taking an interest in this open source project. Your support and involvement is greatly appreciated. The
-following details what you need to know in order to contribute.
+Thanks for taking an interest in this open source project. Your support and involvement is greatly
+appreciated. The following sections detail what you need to know in order to contribute.
 
-# Requirements
+## Code
 
-- Follow these [Basic Programming Styles](https://github.com/bkuhlmann/style_guides/blob/master/programming/basic.md).
-- Follow these [Code Review Styles](https://github.com/bkuhlmann/style_guides/blob/master/programming/code_reviews.md).
-- Follow these [Git Styles](https://github.com/bkuhlmann/style_guides/blob/master/programming/git.md).
-- Follow these [Bash Styles](https://github.com/bkuhlmann/style_guides/blob/master/programming/languages/bash.md).
-- Follow these [CSS Styles](https://github.com/bkuhlmann/style_guides/blob/master/programming/languages/css.md).
-- Follow these [Ruby Styles](https://github.com/bkuhlmann/style_guides/blob/master/programming/languages/ruby/ruby.md).
+0. Read the project README before starting.
+0. Fork the `master` branch of this repository and clone the fork locally.
+0. Ensure there are no setup, usage, and/or test issues.
+0. Add tests for new functionality and ensure they pass.
+0. Submit a pull request, follow the instructions it provides, and ensure the build passes.
 
-# Contributing Code
+## Issues
 
-0. Read the project README thoroughly before starting.
-0. Fork the master branch of the repository.
-0. Ensure there are no setup, usage, and/or test issues (again, follow the README).
-0. Add tests for new functionality (refactoring and documentation changes can be excluded).
-0. Ensure all tests pass.
-0. Push your feature branch and submit a pull request.
+0. Submit an issue via the GitHub Issues tab (assuming one does not
+   already exist) and follow the instructions it provides.
 
-# Submitting Issues
+## Feedback
 
-0. Submit an issue via the GitHub Issues tab (assuming one does not already exist).
-0. Clearly describe the issue (including steps to reproduce).
-0. Specify your enviroment setup (OS, browser, language, etc. with version info).
-0. Provide a stack dump (if possible).
-0. Explain any additional details that might help diagnose the problem quickly.
-
-# Feedback
-
-Expect a response within one to three business days.
-Changes, alternatives, and/or improvements might be suggested upon review.
+- Expect a response within one to three business days.
+- Changes, alternatives, and/or improvements might be suggested upon review.

Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gem "rake", "~> 12.0"
+gem "git-cop", "~> 1.3"

Gemfile.lock

@@ -0,0 +1,28 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    equatable (0.5.0)
+    git-cop (1.3.0)
+      pastel (~> 0.7)
+      refinements (~> 4.1)
+      runcom (~> 1.1)
+      thor (~> 0.19)
+    pastel (0.7.1)
+      equatable (~> 0.5.0)
+      tty-color (~> 0.4.0)
+    rake (12.0.0)
+    refinements (4.1.0)
+    runcom (1.1.0)
+      refinements (~> 4.1)
+    thor (0.19.4)
+    tty-color (0.4.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  git-cop (~> 1.3)
+  rake (~> 12.0)
+
+BUNDLED WITH
+   1.15.1

README.md

@@ -1,5 +1,6 @@
 # macOS
 
+[![Circle CI Status](https://circleci.com/gh/bkuhlmann/mac_os.svg?style=svg)](https://circleci.com/gh/bkuhlmann/mac_os)
 [![Patreon](https://img.shields.io/badge/patreon-donate-brightgreen.svg)](https://www.patreon.com/bkuhlmann)
 
 Shell scripts for automated macOS machine setup.
@@ -19,24 +20,24 @@ the two projects are meant to be used:
 
 <!-- Tocer[start]: Auto-generated, don't remove. -->
 
-# Table of Contents
+## Table of Contents
 
-- [Features](#features)
-- [Screencast](#screencast)
-- [Requirements](#requirements)
-- [Setup](#setup)
-- [Usage](#usage)
-  - [Customization](#customization)
-- [Versioning](#versioning)
-- [Code of Conduct](#code-of-conduct)
+  - [Features](#features)
+  - [Screencast](#screencast)
+  - [Requirements](#requirements)
+  - [Setup](#setup)
+  - [Usage](#usage)
+    - [Customization](#customization)
+  - [Versioning](#versioning)
+  - [Code of Conduct](#code-of-conduct)
 - [Contributions](#contributions)
-- [License](#license)
-- [History](#history)
-- [Credits](#credits)
+  - [License](#license)
+  - [History](#history)
+  - [Credits](#credits)
 
 <!-- Tocer[finish]: Auto-generated, don't remove. -->
 
-# Features
+## Features
 
 - Provides a command line interface, written in Bash with no additional dependencies, for
   installation and management of a macOS machine.
@@ -45,7 +46,8 @@ the two projects are meant to be used:
 - Downloads and installs development tools (required by Homebrew):
     - [Xcode Command Line Tools](https://developer.apple.com/xcode)
     - [Java SE Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
-- Downloads, installs, and configures [Homebrew](http://brew.sh) command line software.
+- Downloads, installs, and configures [Homebrew Formulas](http://brew.sh).
+- Downloads, installs, and configures [Homebrew Casks](https://caskroom.github.io).
 - Downloads, installs, and configures
   [App Store](http://www.apple.com/macosx/whats-new/app-store.html) software.
 - Downloads, installs, and configures non-App Store software applications.
@@ -54,16 +56,16 @@ the two projects are meant to be used:
 - Sets up and configures installed software for use.
 - Supports restoration of machine backups.
 
-# Screencast
+## Screencast
 
 [![asciicast](https://asciinema.org/a/88971.png)](https://asciinema.org/a/88971)
 
-# Requirements
+## Requirements
 
 0. [macOS Sierra](https://www.apple.com/macos) (with latest software updates applied)
 0. [Xcode](https://developer.apple.com/xcode) (with accepted license agreement)
 
-# Setup
+## Setup
 
 Open a terminal window and execute one of the following setup sequences depending on your version
 preference:
@@ -72,14 +74,14 @@ Current Version (stable):
 
     git clone https://github.com/bkuhlmann/mac_os.git
     cd mac_os
-    git checkout v1.3.1
+    git checkout v2.2.0
 
 Master Version (unstable):
 
     git clone https://github.com/bkuhlmann/mac_os.git
     cd mac_os
 
-# Usage
+## Usage
 
 Run the following script:
 
@@ -88,28 +90,29 @@ Run the following script:
 You will be presented with the following options:
 
     Boot:
-      B:  Create boot disk.
+       B:  Create boot disk.
     Install:
-      b:  Apply basic settings.
-      t:  Install development tools.
-      h:  Install Homebrew software.
-      m:  Install Mac App Store software.
-      a:  Install application software.
-      x:  Install application software extensions.
-      d:  Apply default settings.
-      s:  Setup installed software.
-      i:  Install everything (i.e. executes all install options).
+       b:  Apply basic settings.
+       t:  Install development tools.
+      hf:  Install Homebrew Formulas.
+      hc:  Install Homebrew Casks.
+       m:  Install Mac App Store software.
+       a:  Install application software.
+       x:  Install application software extensions.
+       d:  Apply default settings.
+       s:  Setup installed software.
+       i:  Install everything (i.e. executes all install options).
     Restore:
-      R:  Restore settings from backup.
+       R:  Restore settings from backup.
     Manage:
-      c:  Check status of managed software.
-      C:  Caffeinate machine.
-      ua: Uninstall application software.
-      ux: Uninstall application software extension.
-      ra: Reinstall application software.
-      rx: Reinstall application software extension.
-      w:  Clean work (temp) directory.
-      q:  Quit/Exit.
+       c:  Check status of managed software.
+       C:  Caffeinate machine.
+      ua:  Uninstall application software.
+      ux:  Uninstall application software extension.
+      ra:  Reinstall application software.
+      rx:  Reinstall application software extension.
+       w:  Clean work (temp) directory.
+       q:  Quit/Exit.
 
 Choose option `i` to run all install options or select a specific option to run a single option.
 Each option is designed to be re-run if necessary. This can also be handy for performing upgrades,
@@ -124,7 +127,7 @@ been loaded.
 It is recommended that the `mac_os` project directory not be deleted and kept on the local machine
 in order to manage installed software and benefit from future upgrades.
 
-## Customization
+### Customization
 
 All executable scripts can be found in the `bin` folder:
 
@@ -140,7 +143,8 @@ All executable scripts can be found in the `bin` folder:
 - `bin/install_dev_tools`: Installs macOS development tools required by Homebrew.
 - `bin/install_extensions`: Installs macOS application extensions and add-ons. *This is meant to be
   customized.*
-- `bin/install_homebrew`: Installs Homebrew managed software. *This is meant to be customized.*
+- `bin/install_homebrew_casks`: Installs Homebrew Formulas. *This is meant to be customized.*
+- `bin/install_homebrew_formulas`: Installs Homebrew Casks. *This is meant to be customized.*
 - `bin/restore_backup`: Restores system/application settings from backup image. *This is meant to be
   customized.*
 - `bin/run`: The main script and interface for macOS setup.
@@ -154,15 +158,15 @@ project is built upon the functions found in the `lib` folder. See the
 
   - `lib/settings.sh`: Defines global settings for software applications, extensions, etc.
 
-# Versioning
+## Versioning
 
 Read [Semantic Versioning](http://semver.org) for details. Briefly, it means:
 
-- Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
-- Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
 - Major (X.y.z) - Incremented for any backwards incompatible public API changes.
+- Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
+- Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
 
-# Code of Conduct
+## Code of Conduct
 
 Please note that this project is released with a [CODE OF CONDUCT](CODE_OF_CONDUCT.md). By
 participating in this project you agree to abide by its terms.
@@ -171,17 +175,17 @@ participating in this project you agree to abide by its terms.
 
 Read [CONTRIBUTING](CONTRIBUTING.md) for details.
 
-# License
+## License
 
 Copyright (c) 2016 [Alchemists](https://www.alchemists.io).
 Read [LICENSE](LICENSE.md) for details.
 
-# History
+## History
 
 Read [CHANGES](CHANGES.md) for details.
 Built with [Bashsmith](https://github.com/bkuhlmann/bashsmith).
 
-# Credits
+## Credits
 
 Developed by [Brooke Kuhlmann](https://www.alchemists.io) at
 [Alchemists](https://www.alchemists.io).

Rakefile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+begin
+  require "git/cop/rake/setup"
+rescue LoadError => error
+  puts error.message
+end
+
+task default: :git_cop

bin/install_dev_tools

@@ -6,11 +6,18 @@
 printf "Installing Xcode CLI tools...\n"
 xcode-select --install
 
-read -p "Have you completed the Xcode CLI tools install (y/n)? " response
-if [[ "$response" != "y" ]]; then
+read -p "Have you completed the Xcode CLI tools install (y/n)? " xcode_response
+if [[ "$xcode_response" != "y" ]]; then
   printf "ERROR: Xcode CLI tools must be installed before proceeding.\n"
   exit 1
 fi
 
-printf "Installing Java...\n"
-install_java "$JAVA_URL" "$JAVA_VOLUME_NAME"
+printf "Installing $JAVA_LABEL...\n"
+printf "%s\n" "You must manually accept the license and download the $JAVA_LABEL: $JAVA_DOWNLOAD_URL."
+open $JAVA_DOWNLOAD_URL
+
+read -p "Have you completed the $JAVA_LABEL install (y/n)? " java_response
+if [[ "$java_response" != "y" ]]; then
+  printf "ERROR: $JAVA_LABEL must be installed before proceeding.\n"
+  exit 1
+fi

bin/install_homebrew

@@ -1,18 +0,0 @@
-#! /usr/bin/env bash
-
-# DESCRIPTION
-# Installs Homebrew software.
-
-# SETTINGS
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew"
-
-# EXECUTION
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Homebrew install script does not exist or is not executable.\n"
-fi

bin/install_homebrew_casks

@@ -0,0 +1,18 @@
+#! /usr/bin/env bash
+
+# DESCRIPTION
+# Installs Homebrew Cask software.
+
+# SETTINGS
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"
+
+# EXECUTION
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "WARNING: Homebrew Casks install script does not exist or is not executable.\n"
+fi

bin/install_homebrew_formulas

@@ -0,0 +1,18 @@
+#! /usr/bin/env bash
+
+# DESCRIPTION
+# Installs Homebrew Formula software.
+
+# SETTINGS
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew_formulas"
+
+# EXECUTION
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "WARNING: Homebrew Formulas install script does not exist or is not executable.\n"
+fi

bin/run

@@ -35,28 +35,29 @@ while true; do
     printf "\nUsage: run OPTION\n"
     printf "\nOSX Options:\n"
     printf "  Boot:\n"
-    printf "    B:  Create boot disk.\n"
+    printf "     B:  Create boot disk.\n"
     printf "  Install:\n"
-    printf "    b:  Apply basic settings.\n"
-    printf "    t:  Install development tools.\n"
-    printf "    h:  Install Homebrew software.\n"
-    printf "    m:  Install Mac App Store software.\n"
-    printf "    a:  Install application software.\n"
-    printf "    x:  Install application software extensions.\n"
-    printf "    d:  Apply default settings.\n"
-    printf "    s:  Setup installed software.\n"
-    printf "    i:  Install everything (i.e. executes all install options).\n"
+    printf "     b:  Apply basic settings.\n"
+    printf "     t:  Install development tools.\n"
+    printf "    hf:  Install Homebrew Formulas.\n"
+    printf "    hc:  Install Homebrew Casks.\n"
+    printf "     m:  Install Mac App Store software.\n"
+    printf "     a:  Install application software.\n"
+    printf "     x:  Install application software extensions.\n"
+    printf "     d:  Apply default settings.\n"
+    printf "     s:  Setup installed software.\n"
+    printf "     i:  Install everything (i.e. executes all install options).\n"
     printf "  Restore:\n"
-    printf "    R:  Restore settings from backup.\n"
+    printf "     R:  Restore settings from backup.\n"
     printf "  Manage:\n"
-    printf "    c:  Check status of managed software.\n"
-    printf "    C:  Caffeinate machine.\n"
-    printf "    ua: Uninstall application software.\n"
-    printf "    ux: Uninstall application software extension.\n"
-    printf "    ra: Reinstall application software.\n"
-    printf "    rx: Reinstall application software extension.\n"
-    printf "    w:  Clean work (temp) directory.\n"
-    printf "    q:  Quit/Exit.\n\n"
+    printf "     c:  Check status of managed software.\n"
+    printf "     C:  Caffeinate machine.\n"
+    printf "    ua:  Uninstall application software.\n"
+    printf "    ux:  Uninstall application software extension.\n"
+    printf "    ra:  Reinstall application software.\n"
+    printf "    rx:  Reinstall application software extension.\n"
+    printf "     w:  Clean work (temp) directory.\n"
+    printf "     q:  Quit/Exit.\n\n"
     read -p "Enter selection: " response
     printf "\n"
     process_option $response

circle.yml

@@ -0,0 +1,7 @@
+dependencies:
+  pre:
+    - gem update --system
+    - gem update bundler
+test:
+  override:
+    - bundle exec rake

lib/options.sh

@@ -14,8 +14,10 @@ process_option() {
       bin/apply_basic_settings;;
     't')
       bin/install_dev_tools;;
-    'h')
-      bin/install_homebrew;;
+    'hf')
+      bin/install_homebrew_formulas;;
+    'hc')
+      bin/install_homebrew_casks;;
     'm')
       bin/install_app_store;;
     'a')
@@ -30,7 +32,8 @@ process_option() {
       caffeinate_machine
       bin/apply_basic_settings
       bin/install_dev_tools
-      bin/install_homebrew
+      bin/install_homebrew_formulas
+      bin/install_homebrew_casks
       bin/install_app_store
       bin/install_applications
       bin/install_extensions

lib/settings.sh

@@ -18,5 +18,5 @@ export MAC_OS_WORK_PATH=/tmp/downloads
 export MAC_OS_CONFIG_PATH="../mac_os-config"
 
 # Java
-export JAVA_VOLUME_NAME="JDK 8 Update 101"
-export JAVA_URL="http://download.oracle.com/otn-pub/java/jdk/8u101-b13/jdk-8u101-macosx-x64.dmg"
+export JAVA_LABEL="Java SE Development Kit"
+export JAVA_DOWNLOAD_URL="http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html"