Added version release notes

Necessary to ensure machines are properly configured for running these
scripts on either Apple Silicon or Intel based machines.

.circleci/config.yml

@@ -0,0 +1,31 @@
+version: 2.1
+jobs:
+  build:
+    working_directory: ~/project
+    docker:
+      - image: bkuhlmann/alpine-ruby:latest
+    steps:
+      - checkout
+
+      - restore_cache:
+          name: Bundler Restore
+          keys:
+            - gem-cache-{{.Branch}}-{{checksum "Gemfile"}}
+            - gem-cache-
+
+      - run:
+          name: Bundler Install
+          command: |
+            gem update --system
+            bundle config set path "vendor/bundle"
+            bundle install
+
+      - save_cache:
+          name: Bundler Store
+          key: gem-cache-{{.Branch}}-{{checksum "Gemfile"}}
+          paths:
+            - vendor/bundle
+
+      - run:
+          name: Build
+          command: bundle exec rake

.ruby-version

@@ -1 +1 @@
-2.7.1
+3.0.0

CHANGES.adoc

@@ -1,5 +1,45 @@
 = Changes
 
+== 11.2.0 (2021-02-27)
+
+* Added Apple Silicon instructions - Brooke Kuhlmann
+* Added CPU utility function - Brooke Kuhlmann
+* Added Homebrew install function - Brooke Kuhlmann
+* Added Homebrew utility path functions - Brooke Kuhlmann
+* Added Rosetta to development tools install script - Brooke Kuhlmann
+* Added environment configuration for scripts - Brooke Kuhlmann
+* Updated to Circle CI 2.1.0 - Brooke Kuhlmann
+* Updated to Docker Alpine Ruby image - Brooke Kuhlmann
+* Refactored installer functions to be alphabetically sorted - Brooke Kuhlmann
+* Refactored utility functions to be alphabetically sorted - Brooke Kuhlmann
+* Refactored verifier functions to be alphabetically sorted - Brooke Kuhlmann
+
+== 11.1.1 (2021-01-10)
+
+* Fixed brew formulae list error - Brooke Kuhlmann
+* Updated boot disk recovery documentation - Brooke Kuhlmann
+
+== 11.1.0 (2021-01-03)
+
+* Added caffeination to restore process - Brooke Kuhlmann
+* Updated boot disk instructions for main disk format - Brooke Kuhlmann
+* Updated troubleshooting documentation - Brooke Kuhlmann
+* Removed README Startup Security Utility documentation - Brooke Kuhlmann
+
+== 11.0.0 (2020-12-30)
+
+* Fixed Circle CI configuration for Bundler config path - Brooke Kuhlmann
+* Added Circle CI explicit Bundle install configuration - Brooke Kuhlmann
+* Updated to Git Lint 2.0.0 - Brooke Kuhlmann
+* Updated to Ruby 3.0.0 - Brooke Kuhlmann
+
+== 10.0.0 (2020-11-15)
+
+* Added macOS Big Sur support
+* Updated project documentation to conform to Rubysmith template
+* Updated to Git Lint 1.3.0
+* Updated to Ruby 2.7.2
+
 == 9.0.0 (2020-09-12)
 
 * Fixed Homebrew cask verifier deprecation warning

CODE_OF_CONDUCT.adoc

@@ -51,7 +51,8 @@ an appointed representative at an online or offline event.
 == Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community
-leaders responsible for enforcement at link:mailto:brooke@alchemists.io?subject=Conduct[Alchemists].
+leaders responsible for enforcement at link:mailto:brooke@alchemists.io?subject=Conduct[Brooke Kuhlmann].
+
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the reporter of any
@@ -102,7 +103,7 @@ disparagement of classes of individuals.
 
 This Code of Conduct is adapted from the
 link:https://www.contributor-covenant.org/version/2/0/code_of_conduct.html[Contributor Covenant,
-version 2.0].
+Version 2.0].
 
 Community Impact Guidelines were inspired by link:https://github.com/mozilla/diversity[Mozilla's
 code of conduct enforcement ladder].

Gemfile

@@ -3,4 +3,4 @@
 source "https://rubygems.org"
 
 gem "rake", "~> 13.0"
-gem "git-lint", "~> 1.0"
+gem "git-lint", "~> 2.0"

LICENSE.adoc

@@ -150,7 +150,7 @@ additional liability.
 
 END OF TERMS AND CONDITIONS
 
-Copyright link:https://www.alchemists.io[Alchemists].
+Copyright 2016 link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
 compliance with the License. You may obtain a link:https://www.apache.org/licenses/LICENSE-2.0[copy]

README.adoc

@@ -16,10 +16,10 @@ Config_ project is an opinionated configuration which meets the needs of my deve
 but is also meant to serve as an example and guide for building your own personalized setup. Here is
 how the two projects are meant to be used:
 
-* *macOS* (this project) - The foundation framework for building customizated macOS machine setups.
+* *macOS* (this project) - The foundational framework for building custom macOS machine setups.
 * *link:https://www.alchemists.io/projects/mac_os-config[macOS Configuration]* - The layer on top of
-  this _macOS_ project which defines a custom machine setup and base implementation. The project is
-  meant to be forked for as many custom machine setups as needed.
+  this _macOS_ project which defines a custom machine implementation. The project is meant to be
+  forked for as many custom machine setups as needed.
 
 toc::[]
 
@@ -46,30 +46,18 @@ image::https://www.alchemists.io/images/screencasts/mac_os/cover.svg[Screencast,
 
 == Requirements
 
-. link:https://www.apple.com/macos/catalina[macOS]
+. link:https://www.apple.com/macos/big-sur[macOS Big Sur]
 . link:https://developer.apple.com/xcode[Xcode]
 
 == Setup
 
-=== Production
-
 To install, run:
 
 [source,bash]
 ----
 git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
-git checkout 9.0.0
-----
-
-=== Development
-
-To contribute, run:
-
-[source,bash]
-----
-git clone https://github.com/bkuhlmann/mac_os.git
-cd mac_os
+git checkout 11.2.0
 ----
 
 == Usage
@@ -138,45 +126,19 @@ macOS Boot Disk Tips
 macOS Boot Disk Usage:
   1. Insert the USB boot disk into the machine to be upgraded.
   2. Reboot the machine.
-  3. Hold down the OPTION key before the Apple logo appears.
+  3. Hold the POWER (Silicon) or OPTION (Intel) key before the Apple logo appears.
   4. Select the USB boot disk from the menu.
-  5. Use Disk Utility to format the machine's drive as "APFS (Encrypted)".
-  6. Install the new operating system.
+  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions.
+  6. Use Disk Utility to create a single "APFS" drive as a "GUID Partition Table".
+  7. Install the new operating system.
 
-macOS Reinstall:
-  1. Click the Apple icon from the operating system main menu.
-  2. Select the "Restart..." menu option.
-  3. Hold down the COMMAND+R keys before the Apple logo appears.
-  4. Wait for the macOS installer to load from the recovery partition.
-  5. Use the dialog options to launch Disk Utility, reinstall the system, etc.
+macOS Boot Disk Recovery:
+  1. Start/restart the machine.
+  2. Hold the POWER (Silicon) or COMMAND+R (Intel) keys before the Apple logo appears.
+  3. Wait for the macOS installer to load from the recovery partition.
+  4. Use the dialog options to launch Disk Utility, reinstall the system, etc.
 ....
 
-Depending on your security settings, you might need to use the Startup
-Security Utility before using the Boot Disk (see below).
-
-=== https://support.apple.com/en-us/HT208198[Startup Security Utility]
-
-With newer hardware, you should be running with the Apple T2 Security Chip (found via  → About This
-Mac → Overview → System Report → Controller). In order to boot your machine using the Boot Disk,
-you’ll need to _temporarily_ disable the default security settings as follows:
-
-* Turn on or restart your Mac, then press and hold `COMMAND + R` immediately after seeing the Apple
-  logo.
-* Select Utilities → Startup Security Utility from the main menu.
-* Click _Turn Off Firmware Password_.
-* Select _Secure Boot: No Security_.
-* Select _External Boot: Allow booting from external media_.
-* Quit the utility and restart the machine.
-
-You’ll now be able to boot your system with the Boot Disk (see above).
-
-After the new operating system has been installed via the Boot Disk, _ensure you return to the
-Startup Security Utility and re-enable the following settings_:
-
-* Click _Turn On Firmware Password_.
-* Select _Secure Boot: Full Security_.
-* Select _External Boot: Disallow booting from external or removable media_.
-
 === Customization
 
 All executable scripts can be found in the `bin` folder:
@@ -206,20 +168,30 @@ link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for
 
 == Troubleshooting
 
+* When using link:https://pi-hole.net[Pi-hole], you might need to temporarily disable prior to
+  upgrading as you might experience various errors with Apple not being able to detect an internet
+  connection which prevents the installer from working.
+* When using the boot disk and the installer fails in some catestrophic manner, reboot the machine
+  into recovery mode -- `POWER` (Silicon) or `COMMAND + R` (Intel) buttons -- to download and
+  install the last operating system used. Alternatively, you can also use `COMMAND + OPTION + R`
+  (Intel) to attemp to download the latest operating system.
 * When using the boot disk, you might experience a situation where you see a black screen with a
   white circle and diagonal line running through it. This means macOS lost or can’t find the boot
   disk for some reason. To correct this, shut down and boot up the system again while holding down
-  the `OPTION+COMMAND+R+P` keys simultaneously. You might want to wait for the system boot sound to
-  happen a few times before releasing the keys. This will clear the system NVRAM/PRAM. At this point
-  you can shut down and restart the system following the boot disk instructions (the boot disk will
-  be recognized now).
-* Sometimes, when installing XCode development tools (i.e. the `t` option), not all of the macOS
-  headers will be installed. This can cause issues with compiling and building native packages. For
-  example: `fatal error: 'stdio.h' file not found`. This can happen due to an intermittent bug with
-  the XCode installer. To fix this, you’ll need to install this package:
-  `/Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg`. Depending on
-  your system, the version might differ, so look for a `*.pkg` in the
-  `/Library/Developer/CommandLineTools/Packages` folder.
+  the `OPTION + COMMAND + R + P` (Intel) keys simultaneously. You might want to wait for the system
+  boot sound to happen a few times before releasing the keys. This will clear the system NVRAM/PRAM.
+  At this point you can shut down and restart the system following the boot disk instructions (the
+  boot disk will be recognized now).
+
+== Development
+
+To contribute, run:
+
+[source,bash]
+----
+git clone https://github.com/bkuhlmann/mac_os.git
+cd mac_os
+----
 
 == Versioning
 

bin/create_boot_disk

@@ -9,16 +9,16 @@ printf "  - Use Disk Utility to label the USB drive as \"Untitled\".\n"
 printf "\nmacOS Boot Disk Usage:\n"
 printf "  1. Insert the USB boot disk into the machine to be upgraded.\n"
 printf "  2. Reboot the machine.\n"
-printf "  3. Hold down the OPTION key before the Apple logo appears.\n"
+printf "  3. Hold the POWER (Silicon) or OPTION (Intel) key before the Apple logo appears.\n"
 printf "  4. Select the USB boot disk from the menu.\n"
-printf "  5. Use Disk Utility to format the machine's drive as \"APFS (Encrypted)\".\n"
-printf "  6. Install the new operating system.\n"
-printf "\nmacOS Reinstall:\n"
-printf "  1. Click the Apple icon from the operating system main menu.\n"
-printf "  2. Select the \"Restart...\" menu option.\n"
-printf "  3. Hold down the COMMAND+R keys before the Apple logo appears.\n"
-printf "  4. Wait for the macOS installer to load from the recovery partition.\n"
-printf "  5. Use the dialog options to launch Disk Utility, reinstall the system, etc.\n"
+printf "  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions.\n"
+printf "  6. Use Disk Utility to create a single \"APFS\" drive as a \"GUID Partition Table\".\n"
+printf "  7. Install the new operating system.\n"
+printf "\nmacOS Boot Disk Recovery:\n"
+printf "  1. Start/restart the machine.\n"
+printf "  2. Hold the POWER (Silicon) or COMMAND+R (Intel) keys before the Apple logo appears.\n"
+printf "  3. Wait for the macOS installer to load from the recovery partition.\n"
+printf "  4. Use the dialog options to launch Disk Utility, reinstall the system, etc.\n"
 
 printf "\nCreating macOS boot disk...\n"
 

bin/install_dev_tools

@@ -11,3 +11,7 @@ if [[ "$xcode_response" != "y" ]]; then
   printf "ERROR: Xcode CLI tools must be installed before proceeding.\n"
   exit 1
 fi
+
+if [[ -n "$(get_cpu)" ]]; then
+  softwareupdate --install-rosetta
+fi

bin/run

@@ -23,6 +23,8 @@ else
   exit 1
 fi
 
+configure_environment
+
 while true; do
   if [[ $# == 0 ]]; then
     printf "\nUsage: run OPTION\n"

circle.yml

@@ -1,61 +0,0 @@
-version: 2
-jobs:
-  build:
-    working_directory: ~/project
-    docker:
-      - image: circleci/ruby
-        environment:
-          BUNDLE_JOBS: 3
-          BUNDLE_RETRY: 3
-          BUNDLE_PATH: vendor/bundle
-          EDITOR: vim
-    steps:
-      - checkout
-
-      - run:
-          name: Environment Setup
-          command: |
-            printf "%s\n" 'export CI_RUBY_VERSION=$(cat ".ruby-version" | tr -d "\n")' >> $BASH_ENV
-
-      - type: cache-restore
-        name: Ruby Restore
-        key: ruby-{{checksum ".ruby-version"}}
-
-      - run:
-          name: Ruby Install
-          command: |
-            curl https://cache.ruby-lang.org/pub/ruby/${CI_RUBY_VERSION::-2}/ruby-$CI_RUBY_VERSION.tar.bz2 > ../ruby-$CI_RUBY_VERSION.tar.gz
-            cd ..
-            tar --extract --bzip2 --verbose --file ruby-$CI_RUBY_VERSION.tar.gz
-            cd ruby-$CI_RUBY_VERSION
-            ./configure
-            make
-            make update-gems
-            make extract-gems
-            sudo make install
-
-      - type: cache-save
-        name: Ruby Store
-        key: ruby-{{checksum ".ruby-version"}}
-        paths:
-          - ../ruby-$CI_RUBY_VERSION
-
-      - type: cache-restore
-        name: Bundler Restore
-        key: bundler-{{checksum "Gemfile"}}
-
-      - run:
-          name: Bundler Install
-          command: |
-            gem update --system
-            bundle install --path vendor/bundle
-
-      - type: cache-save
-        name: Bundler Store
-        key: bundler-{{checksum "Gemfile"}}
-        paths:
-          - vendor/bundle
-
-      - run:
-          name: Build
-          command: bundle exec rake

lib/installers.sh

@@ -2,6 +2,43 @@
 
 # Defines software installer functions.
 
+# Downloads remote file to local disk.
+# Parameters: $1 (required) - URL, $2 (required) - File name, $3 (optional) - HTTP header.
+download_file() {
+  local url="$1"
+  local file_name="$2"
+  local http_header="$3"
+
+  printf "%s\n" "Downloading $1..."
+  clean_work_path
+  mkdir $MAC_OS_WORK_PATH
+  curl --header "$http_header" --location --retry 3 --retry-delay 5 --fail --silent --show-error "$url" >> "$MAC_OS_WORK_PATH/$file_name"
+}
+export -f download_file
+
+# Installs an application.
+# Parameters: $1 (required) - Application source path, $2 (required) - Application name.
+install_app() {
+  local install_root=$(get_install_root "$2")
+  local file_extension=$(get_extension "$2")
+
+  printf "Installing: $install_root/$2...\n"
+
+  case $file_extension in
+    '')
+      cp -a "$1/$2" "$install_root";;
+    'app')
+      cp -a "$1/$2" "$install_root";;
+    'prefPane')
+      sudo cp -pR "$1/$2" "$install_root";;
+    'qlgenerator')
+      sudo cp -pR "$1/$2" "$install_root" && qlmanage -r;;
+    *)
+      printf "ERROR: Unknown file extension: $file_extension.\n"
+  esac
+}
+export -f install_app
+
 # Installs an application via a DMG file.
 # Parameters: $1 (required) - URL, $2 (required) - Mount path, $3 (required) - Application name.
 install_dmg_app() {
@@ -41,6 +78,124 @@ install_dmg_pkg() {
 }
 export -f install_dmg_pkg
 
+# Installs a single file.
+# Parameters: $1 (required) - URL, $2 (required) - Install path.
+install_file() {
+  local file_url="$1"
+  local file_name=$(get_basename "$1")
+  local install_path="$2"
+
+  if [[ ! -e "$install_path" ]]; then
+    download_file "$file_url" "$file_name"
+    mkdir -p $(dirname "$install_path")
+    mv "$MAC_OS_WORK_PATH/$file_name" "$install_path"
+    printf "Installed: $file_name.\n"
+    verify_path "$install_path"
+  fi
+}
+export -f install_file
+
+# Installs application code from a Git repository.
+# Parameters: $1 (required) - Repository URL, $2 (required) - Install path, $3 (optional) - Git clone options.
+install_git_app() {
+  local repository_url="$1"
+  local app_name=$(get_basename "$2")
+  local install_path="$2"
+  local options="--quiet"
+
+  if [[ -n "$3" ]]; then
+    local options="$options $3"
+  fi
+
+  if [[ ! -e "$install_path" ]]; then
+    printf "Installing: $install_path/$app_name...\n"
+    git clone $options "$repository_url" "$install_path"
+    printf "Installed: $app_name.\n"
+    verify_path "$install_path"
+  fi
+}
+export -f install_git_app
+
+# Installs settings from a Git repository.
+# Parameters: $1 (required) - Repository URL, $2 (required) - Repository version, $3 (required) - Project directory, $4 (required) - Script to run (including any arguments).
+install_git_project() {
+  local repo_url="$1"
+  local repo_version="$2"
+  local project_dir="$3"
+  local script="$4"
+
+  git clone "$repo_url"
+  (
+    cd "$project_dir"
+    git -c advice.detachedHead=false checkout "$repo_version"
+    eval "$script"
+  )
+  rm -rf "$project_dir"
+}
+export -f install_git_project
+
+# Installs Homebrew.
+# Parameters: None.
+install_homebrew() {
+  if ! command -v brew > /dev/null; then
+    /bin/bash -c "$(curl --location --fail --silent --show-error https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  fi
+}
+export -f install_homebrew
+
+# Installs a package.
+# Parameters: $1 (required) - Package source path, $2 (required) - Application name.
+install_pkg() {
+  local install_root=$(get_install_root "$2")
+
+  printf "Installing: $install_root/$2...\n"
+  local package=$(sudo find "$1" -maxdepth 1 -type f -name "*.pkg" -o -name "*.mpkg")
+  sudo installer -pkg "$package" -target /
+}
+export -f install_pkg
+
+# Installs program (single file).
+# Parameters: $1 (required) - URL, $2 (required) - Program name.
+install_program() {
+  local url="$1"
+  local program_name="$2"
+  local install_path=$(get_install_path "$program_name")
+
+  if [[ ! -e "$install_path" ]]; then
+    download_file "$url" "$program_name"
+    mv "$MAC_OS_WORK_PATH/$program_name" "$install_path"
+    chmod 755 "$install_path"
+    printf "Installed: $program_name.\n"
+    verify_application "$program_name"
+  fi
+}
+export -f install_program
+
+# Installs an application via a tar file.
+# Parameters: $1 (required) - URL, $2 (required) - Application name, $3 (required) - Decompress options.
+install_tar_app() {
+  local url="$1"
+  local app_name="$2"
+  local options="$3"
+  local install_path=$(get_install_path "$app_name")
+  local work_file="download.tar"
+
+  if [[ ! -e "$install_path" ]]; then
+    download_file "$url" "$work_file"
+
+    (
+      printf "Preparing...\n"
+      cd "$MAC_OS_WORK_PATH"
+      tar "$options" "$work_file"
+    )
+
+    install_app "$MAC_OS_WORK_PATH" "$app_name"
+    printf "Installed: $app_name.\n"
+    verify_application "$app_name"
+  fi
+}
+export -f install_tar_app
+
 # Installs an application via a zip file.
 # Parameters: $1 (required) - URL, $2 (required) - Application name.
 install_zip_app() {
@@ -90,152 +245,6 @@ install_zip_pkg() {
 }
 export -f install_zip_pkg
 
-# Installs an application via a tar file.
-# Parameters: $1 (required) - URL, $2 (required) - Application name, $3 (required) - Decompress options.
-install_tar_app() {
-  local url="$1"
-  local app_name="$2"
-  local options="$3"
-  local install_path=$(get_install_path "$app_name")
-  local work_file="download.tar"
-
-  if [[ ! -e "$install_path" ]]; then
-    download_file "$url" "$work_file"
-
-    (
-      printf "Preparing...\n"
-      cd "$MAC_OS_WORK_PATH"
-      tar "$options" "$work_file"
-    )
-
-    install_app "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
-    verify_application "$app_name"
-  fi
-}
-export -f install_tar_app
-
-# Installs program (single file).
-# Parameters: $1 (required) - URL, $2 (required) - Program name.
-install_program() {
-  local url="$1"
-  local program_name="$2"
-  local install_path=$(get_install_path "$program_name")
-
-  if [[ ! -e "$install_path" ]]; then
-    download_file "$url" "$program_name"
-    mv "$MAC_OS_WORK_PATH/$program_name" "$install_path"
-    chmod 755 "$install_path"
-    printf "Installed: $program_name.\n"
-    verify_application "$program_name"
-  fi
-}
-export -f install_program
-
-# Installs application code from a Git repository.
-# Parameters: $1 (required) - Repository URL, $2 (required) - Install path, $3 (optional) - Git clone options.
-install_git_app() {
-  local repository_url="$1"
-  local app_name=$(get_basename "$2")
-  local install_path="$2"
-  local options="--quiet"
-
-  if [[ -n "$3" ]]; then
-    local options="$options $3"
-  fi
-
-  if [[ ! -e "$install_path" ]]; then
-    printf "Installing: $install_path/$app_name...\n"
-    git clone $options "$repository_url" "$install_path"
-    printf "Installed: $app_name.\n"
-    verify_path "$install_path"
-  fi
-}
-export -f install_git_app
-
-# Installs settings from a Git repository.
-# Parameters: $1 (required) - Repository URL, $2 (required) - Repository version, $3 (required) - Project directory, $4 (required) - Script to run (including any arguments).
-install_git_project() {
-  local repo_url="$1"
-  local repo_version="$2"
-  local project_dir="$3"
-  local script="$4"
-
-  git clone "$repo_url"
-  (
-    cd "$project_dir"
-    git -c advice.detachedHead=false checkout "$repo_version"
-    eval "$script"
-  )
-  rm -rf "$project_dir"
-}
-export -f install_git_project
-
-# Installs a single file.
-# Parameters: $1 (required) - URL, $2 (required) - Install path.
-install_file() {
-  local file_url="$1"
-  local file_name=$(get_basename "$1")
-  local install_path="$2"
-
-  if [[ ! -e "$install_path" ]]; then
-    download_file "$file_url" "$file_name"
-    mkdir -p $(dirname "$install_path")
-    mv "$MAC_OS_WORK_PATH/$file_name" "$install_path"
-    printf "Installed: $file_name.\n"
-    verify_path "$install_path"
-  fi
-}
-export -f install_file
-
-# Downloads remote file to local disk.
-# Parameters: $1 (required) - URL, $2 (required) - File name, $3 (optional) - HTTP header.
-download_file() {
-  local url="$1"
-  local file_name="$2"
-  local http_header="$3"
-
-  printf "%s\n" "Downloading $1..."
-  clean_work_path
-  mkdir $MAC_OS_WORK_PATH
-  curl --header "$http_header" --location --retry 3 --retry-delay 5 --fail --silent --show-error "$url" >> "$MAC_OS_WORK_PATH/$file_name"
-}
-export -f download_file
-
-# Installs an application.
-# Parameters: $1 (required) - Application source path, $2 (required) - Application name.
-install_app() {
-  local install_root=$(get_install_root "$2")
-  local file_extension=$(get_extension "$2")
-
-  printf "Installing: $install_root/$2...\n"
-
-  case $file_extension in
-    '')
-      cp -a "$1/$2" "$install_root";;
-    'app')
-      cp -a "$1/$2" "$install_root";;
-    'prefPane')
-      sudo cp -pR "$1/$2" "$install_root";;
-    'qlgenerator')
-      sudo cp -pR "$1/$2" "$install_root" && qlmanage -r;;
-    *)
-      printf "ERROR: Unknown file extension: $file_extension.\n"
-  esac
-}
-export -f install_app
-
-# Installs a package.
-# Parameters: $1 (required) - Package source path, $2 (required) - Application name.
-install_pkg() {
-  local install_root=$(get_install_root "$2")
-
-  printf "Installing: $install_root/$2...\n"
-  local package=$(sudo find "$1" -maxdepth 1 -type f -name "*.pkg" -o -name "*.mpkg")
-  sudo installer -pkg "$package" -target /
-}
-export -f install_pkg
-
 # Mounts a disk image.
 # Parameters: $1 (required) - Image path.
 mount_image() {

lib/options.sh

@@ -39,6 +39,7 @@ process_option() {
       bin/setup_software
       clean_work_path;;
     'R')
+      caffeinate_machine
       bin/restore_backup;;
     'c')
       verify_homebrew_formulas

lib/settings.sh

@@ -5,7 +5,7 @@ set -o errexit
 set -o pipefail
 IFS=$'\n\t'
 
-export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Catalina.app/Contents/Resources/createinstallmedia"
+export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Big Sur.app/Contents/Resources/createinstallmedia"
 export MAC_OS_BOOT_DISK_PATH="/Volumes/Untitled"
 export MAC_OS_WORK_PATH=/tmp/downloads
 export MAC_OS_CONFIG_PATH="../mac_os-config"

lib/utilities.sh

@@ -15,43 +15,12 @@ caffeinate_machine() {
 }
 export -f caffeinate_machine
 
-# Answers the full install path (including file name) for file name.
-# Parameters: $1 (required) - The file name.
-get_install_path() {
-  local file_name="$1"
-  local install_path=$(get_install_root "$file_name")
-  printf "$install_path/$file_name"
-}
-export -f get_install_path
-
 # Cleans work path for temporary processing of installs.
 clean_work_path() {
   rm -rf "$MAC_OS_WORK_PATH"
 }
 export -f clean_work_path
 
-# Answers the root install path for file name.
-# Parameters: $1 (required) - The file name.
-get_install_root() {
-  local file_name="$1"
-  local file_extension=$(get_extension "$file_name")
-
-  # Dynamically build the install path based on file extension.
-  case $file_extension in
-    '')
-      printf "/usr/local/bin";;
-    'app')
-      printf "/Applications";;
-    'prefPane')
-      printf "/Library/PreferencePanes";;
-    'qlgenerator')
-      printf "/Library/QuickLook";;
-    *)
-      printf "/tmp/unknown";;
-  esac
-}
-export -f get_install_root
-
 # Answers the file or directory basename.
 # Parameters: $1 (required) - The file path.
 get_basename() {
@@ -59,6 +28,13 @@ get_basename() {
 }
 export -f get_basename
 
+# Answers current CPU.
+# Parameters: None.
+get_cpu() {
+  printf "%s" "$(system_profiler SPHardwareDataType | awk '/Chip/ {print $3}')"
+}
+export -f get_cpu
+
 # Answers the file extension.
 # Parameters: $1 (required) - The file name.
 get_extension() {
@@ -72,3 +48,71 @@ get_extension() {
   fi
 }
 export -f get_extension
+
+# Answers Homebrew root path.
+# Parameters: None.
+get_homebrew_root() {
+  if [[ -n "$(get_cpu)" ]]; then
+    printf "%s" "/opt/homebrew"
+  else
+    printf "%s" "/usr/local/Homebrew"
+  fi
+}
+export -f get_homebrew_root
+
+# Answers Homebrew binary root path.
+# Parameters: None.
+get_homebrew_bin_root() {
+  if [[ -n "$(get_cpu)" ]]; then
+    printf "%s" "/opt/homebrew/bin"
+  else
+    printf "%s" "/usr/local/bin"
+  fi
+}
+export -f get_homebrew_bin_root
+
+# Answers the full install path (including file name) for file name.
+# Parameters: $1 (required) - The file name.
+get_install_path() {
+  local file_name="$1"
+  local install_path=$(get_install_root "$file_name")
+  printf "$install_path/$file_name"
+}
+export -f get_install_path
+
+# Answers the root install path for file name.
+# Parameters: $1 (required) - The file name.
+get_install_root() {
+  local file_name="$1"
+  local file_extension=$(get_extension "$file_name")
+
+  # Dynamically build the install path based on file extension.
+  case $file_extension in
+    '')
+      printf "$(get_homebrew_bin_root)";;
+    'app')
+      printf "/Applications";;
+    'prefPane')
+      printf "/Library/PreferencePanes";;
+    'qlgenerator')
+      printf "/Library/QuickLook";;
+    *)
+      printf "/tmp/unknown";;
+  esac
+}
+export -f get_install_root
+
+# Configures shell for new machines and ensures PATH is properly configured for running scripts.
+# Parameters: None.
+configure_environment() {
+  if [[ ! -s "$HOME/.bash_profile" ]]; then
+    printf "%s\n" "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" > "$HOME/.bash_profile"
+  fi
+
+  if [[ ! -s "$HOME/.bashrc" ]]; then
+    printf "%s\n" 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"' > "$HOME/.bashrc"
+  fi
+
+  export PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/opt/homebrew/sbin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
+}
+export -f configure_environment

lib/verifiers.sh

@@ -2,46 +2,6 @@
 
 # Defines verification/validation functions.
 
-# Checks for missing Homebrew formulas.
-verify_homebrew_formulas() {
-  printf "Checking Homebrew formulas...\n"
-
-  local applications="$(brew list)"
-
-  while read line; do
-    if [[ "$line" == "brew install"* ]]; then
-      local application=$(printf "$line" | awk '{print $3}')
-
-      # Exception: "gpg" is the binary but is listed as "gnugp".
-      if [[ "$application" == "gpg" ]]; then
-        application="gnupg"
-      fi
-
-      verify_listed_application "$application" "${applications[*]}"
-    fi
-  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_formulas"
-
-  printf "Homebrew formula check complete.\n"
-}
-export -f verify_homebrew_formulas
-
-# Checks for missing Homebrew casks.
-verify_homebrew_casks() {
-  printf "\nChecking Homebrew casks...\n"
-
-  local applications="$(brew list --cask)"
-
-  while read line; do
-    if [[ "$line" == "brew cask install"* ]]; then
-      local application=$(printf "$line" | awk '{print $4}')
-      verify_listed_application "$application" "${applications[*]}"
-    fi
-  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"
-
-  printf "Homebrew cask check complete.\n"
-}
-export -f verify_homebrew_casks
-
 # Checks for missing App Store applications.
 verify_app_store_applications() {
   printf "\nChecking App Store applications...\n"
@@ -59,17 +19,17 @@ verify_app_store_applications() {
 }
 export -f verify_app_store_applications
 
-# Verifies listed application exists.
-# Parameters: $1 (required) - The current application, $2 (required) - The application list.
-verify_listed_application() {
-  local application="$1"
-  local applications="$2"
+# Verifies application exists.
+# Parameters: $1 (required) - The file name.
+verify_application() {
+  local file_name="$1"
+  local install_path=$(get_install_path "$file_name")
 
-  if [[ "${applications[*]}" != *"$application"* ]]; then
-    printf " - Missing: $application\n"
+  if [[ ! -e "$install_path" ]]; then
+    printf " - Missing: $file_name\n"
   fi
 }
-export -f verify_listed_application
+export -f verify_application
 
 # Checks for missing applications suffixed by "APP_NAME" as defined in settings.sh.
 verify_applications() {
@@ -87,18 +47,6 @@ verify_applications() {
 }
 export -f verify_applications
 
-# Verifies application exists.
-# Parameters: $1 (required) - The file name.
-verify_application() {
-  local file_name="$1"
-  local install_path=$(get_install_path "$file_name")
-
-  if [[ ! -e "$install_path" ]]; then
-    printf " - Missing: $file_name\n"
-  fi
-}
-export -f verify_application
-
 # Checks for missing extensions suffixed by "EXTENSION_PATH" as defined in settings.sh.
 verify_extensions() {
   printf "\nChecking application extensions...\n"
@@ -116,6 +64,58 @@ verify_extensions() {
 }
 export -f verify_extensions
 
+# Checks for missing Homebrew casks.
+verify_homebrew_casks() {
+  printf "\nChecking Homebrew casks...\n"
+
+  local applications="$(brew list --casks)"
+
+  while read line; do
+    if [[ "$line" == "brew cask install"* ]]; then
+      local application=$(printf "$line" | awk '{print $4}')
+      verify_listed_application "$application" "${applications[*]}"
+    fi
+  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"
+
+  printf "Homebrew cask check complete.\n"
+}
+export -f verify_homebrew_casks
+
+# Checks for missing Homebrew formulas.
+verify_homebrew_formulas() {
+  printf "Checking Homebrew formulas...\n"
+
+  local applications="$(brew list --formulae)"
+
+  while read line; do
+    if [[ "$line" == "brew install"* ]]; then
+      local application=$(printf "$line" | awk '{print $3}')
+
+      # Exception: "gpg" is the binary but is listed as "gnugp".
+      if [[ "$application" == "gpg" ]]; then
+        application="gnupg"
+      fi
+
+      verify_listed_application "$application" "${applications[*]}"
+    fi
+  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_formulas"
+
+  printf "Homebrew formula check complete.\n"
+}
+export -f verify_homebrew_formulas
+
+# Verifies listed application exists.
+# Parameters: $1 (required) - The current application, $2 (required) - The application list.
+verify_listed_application() {
+  local application="$1"
+  local applications="$2"
+
+  if [[ "${applications[*]}" != *"$application"* ]]; then
+    printf " - Missing: $application\n"
+  fi
+}
+export -f verify_listed_application
+
 # Verifies path exists.
 # Parameters: $1 (required) - The path.
 verify_path() {