Added version release notes

See link:https://www.ruby-lang.org/en/news/2024/05/30/ruby-3-3-2-released/[details].

Milestone: patch

.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: Gems Restore
+          keys:
+            - gem-cache-{{.Branch}}-{{checksum "Gemfile"}}
+            - gem-cache-
+
+      - run:
+          name: Gems Install
+          command: |
+            gem update --system
+            bundle config set path "vendor/bundle"
+            bundle install
+
+      - save_cache:
+          name: Gems Store
+          key: gem-cache-{{.Branch}}-{{checksum "Gemfile"}}
+          paths:
+            - vendor/bundle
+
+      - run:
+          name: Rake
+          command: bundle exec rake

.config/rubocop/config.yml

@@ -0,0 +1,2 @@
+inherit_gem:
+  caliber: config/all.yml

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [bkuhlmann]

.github/ISSUE_TEMPLATE.md

@@ -1,11 +1,8 @@
-## Overview
+## Why
-<!-- Required. Describe, in detail, the behavior experienced and what is desired. -->
+<!-- Required. Describe, briefly, why this issue is important. -->
 
-## Steps to Recreate
+## How
-<!-- Optional. List exact steps (numbered list) to reproduce errant behavior. Delete if unused. -->
+<!-- Optional. List exact steps (numbered) to implement or reproduce behavior. Screen shots/casts are welcome. -->
 
-## Screenshots/Screencasts
+## Notes
-<!-- Optional. Attach screenshot/screencast(s) that demo the behavior. Delete if unused. -->
+<!-- Optional. Provide additional details (i.e operating system, software version(s), stack dump, etc.) -->
-
-## Environment
-<!-- Optional. What is your operating system, software version(s), etc. Delete if unused. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,11 +1,8 @@
 ## Overview
-<!-- Required. Why is this important/necessary? -->
+<!-- Required. Why is this important/necessary and what is the overarching architecture. -->
-
-## Details
-<!-- 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 supporting image/video. Delete if unused. -->
+<!-- Optional. Provide supporting image/video. -->
+
+## Details
+<!-- Optional. List the key features/highlights as bullet points. -->

.ruby-version

@@ -1 +1 @@
-2.5.3
+3.3.2

CHANGES.md

@@ -1,108 +0,0 @@
-# 6.1.0 (2018-11-01)
-
-- Updated to Java SE Development Kit 11.
-- Updated to Ruby 2.5.2.
-- Updated to Ruby 2.5.3.
-- Removed unnecessary source code comments.
-
-# 6.0.0 (2018-10-01)
-
-- Added XCode install tip.
-- Updated boot disk creation to macOS Mojave.
-- Updated to Contributor Covenant Code of Conduct 1.4.1.
-- Updated to Java SE Development Kit 10.
-
-# 5.0.0 (2018-08-01)
-
-- Fixed Markdown ordered list numbering.
-- Fixed verification of Homebrew formulas.
-- Added App Store application verification.
-- Added Homebrew cask application verifier.
-- Updated Git checkout to silence detached head warnings.
-- Updated README documentation.
-- Updated Semantic Versioning links to be HTTPS.
-- Updated boot disk format documentation.
-- Updated project changes to use semantic versions.
-- Removed Java install support.
-- Removed restorer functions.
-- Refactored function parameter documentation.
-- Refactored library function order.
-
-# 4.1.0 (2018-04-01)
-
-- Updated README license information.
-- Updated README screencast tutorial.
-- Updated to Circle CI 2.0.0 configuration.
-- Updated to Git Cop 2.2.0.
-- Updated to Ruby 2.5.1.
-- Removed Patreon badge from README.
-
-# 4.0.0 (2018-01-01)
-
-- Added Gemfile.lock to .gitignore.
-- Updated to Apache 2.0 license.
-- Updated to Ruby 2.4.3.
-- Updated to Ruby 2.5.0.
-
-# 3.1.0 (2017-11-26)
-
-- Updated Gemfile.lock file.
-- Updated boot disk documenation to mention APFS.
-- Updated to Bundler 1.16.0.
-- Updated to Git Cop 1.7.0.
-- Updated to Rake 12.3.0.
-- Updated to Rubocop 0.51.0.
-
-# 3.0.0 (2017-10-01)
-
-- Fixed table of contents.
-- Updated boot disk creation to use macOS High Sierra.
-- Updated gem dependencies.
-- Updated to Git Cop 1.6.0.
-- Updated to Ruby 2.4.2.
-
-# 2.2.0 (2017-07-16)
-
-- Added Git Cop support.
-- Updated CONTRIBUTING documentation.
-- Updated GitHub templates.
-- Updated README headers.
-- Updated gem dependencies.
-
-# 2.1.0 (2017-04-29)
-
-- Fixed Java SE Development Kit install.
-- Fixed install-all command
-
-# 2.0.0 (2017-04-09)
-
-- Added Homebrew Casks install script.
-- Updated README semantic versioning order.
-- Updated contributing documentation.
-- Refactored Homebrew software as Homebrew Formulas.
-
-# 1.3.1 (2017-01-08)
-
-- Fixed install of zip app downloads with sub-directories.
-
-# 1.3.0 (2017-01-01)
-
-- Updated README versioning documentation.
-- Removed CHANGELOG.md (use CHANGES.md instead).
-
-# 1.2.0 (2016-10-12)
-
-- Fixed reinstaller path issues with application and extension scripts.
-- Added screencast to README.
-
-# 1.1.0 (2016-10-11)
-
-- Fixed Bash script header to dynamically load correct environment.
-- Fixed verification of Homebrew application installs.
-- Added script hook for App Store software install.
-- Added script hooks for unfinished custom configurations.
-- Updated and clarified README documentation.
-
-# 1.0.0 (2016-10-05)
-
-- Initial version.

CITATION.cff

@@ -0,0 +1,22 @@
+cff-version: 1.2.0
+message: Please use the following metadata when citing this project in your work.
+title: macOS
+abstract: Shell scripts for automated macOS machine setup.
+version: 18.2.2
+license: Hippocratic-2.1
+date-released: 2024-06-01
+authors:
+  - family-names: Kuhlmann
+    given-names: Brooke
+    affiliation: Alchemists
+    orcid: https://orcid.org/0000-0002-5810-6268
+keywords:
+ - bash
+ - shell
+ - scripts
+ - automation
+ - setup
+ - recovery
+repository-code: https://github.com/bkuhlmann/mac_os
+repository-artifact: https://alchemists.io/projects/mac_os
+url: https://alchemists.io/projects/mac_os

CODE_OF_CONDUCT.md

@@ -1,65 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers
-pledge to making participation in our project and our community a harassment-free experience for
-everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity
-and expression, level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic address, without explicit
-  permission
-* Other conduct which could reasonably be considered inappropriate in a professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable behavior and are
-expected to take appropriate and fair corrective action in response to any instances of unacceptable
-behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits,
-code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or
-to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces when an individual is
-representing the project or its community. Examples of representing a project or community include
-using an official project e-mail address, posting via an official social media account, or acting as
-an appointed representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting
-the project team at [Brooke Kuhlmann](mailto:brooke@alchemists.io). All complaints will be reviewed
-and investigated and will result in a response that is deemed necessary and appropriate to the
-circumstances. The project team is obligated to maintain confidentiality with regard to the reporter
-of an incident. Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good faith may face
-temporary or permanent repercussions as determined by other members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
-
-[homepage]: https://www.contributor-covenant.org

CONTRIBUTING.md

@@ -1,22 +0,0 @@
-# Contributing
-
-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.
-
-## Code
-
-1. Read the project README before starting.
-1. Fork the `master` branch of this repository and clone the fork locally.
-1. Ensure there are no setup, usage, and/or test issues.
-1. Add tests for new functionality and ensure they pass.
-1. Submit a pull request, follow the instructions it provides, and ensure the build passes.
-
-## Issues
-
-- Submit an issue via the GitHub Issues tab (assuming one does not
-  already exist) and follow the instructions it provides.
-
-## Feedback
-
-- Expect a response within one to three business days.
-- Changes, alternatives, and/or improvements might be suggested upon review.

Gemfile

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
+ruby file: ".ruby-version"
+
 source "https://rubygems.org"
 
-gem "rake", "~> 12.0"
+gem "caliber", "~> 0.51"
-gem "git-cop", "~> 2.2"
+gem "debug", "~> 1.9"
+gem "git-lint", "~> 7.3"
+gem "rake", "~> 13.2"

LICENSE.adoc

@@ -0,0 +1,134 @@
+= Hippocratic License
+
+Version: 2.1.0.
+
+Purpose. The purpose of this License is for the Licensor named above to
+permit the Licensee (as defined below) broad permission, if consistent
+with Human Rights Laws and Human Rights Principles (as each is defined
+below), to use and work with the Software (as defined below) within the
+full scope of Licensor’s copyright and patent rights, if any, in the
+Software, while ensuring attribution and protecting the Licensor from
+liability.
+
+Permission and Conditions. The Licensor grants permission by this
+license ("License"), free of charge, to the extent of Licensor’s
+rights under applicable copyright and patent law, to any person or
+entity (the "Licensee") obtaining a copy of this software and
+associated documentation files (the "Software"), to do everything with
+the Software that would otherwise infringe (i) the Licensor’s copyright
+in the Software or (ii) any patent claims to the Software that the
+Licensor can license or becomes able to license, subject to all of the
+following terms and conditions:
+
+* Acceptance. This License is automatically offered to every person and
+entity subject to its terms and conditions. Licensee accepts this
+License and agrees to its terms and conditions by taking any action with
+the Software that, absent this License, would infringe any intellectual
+property right held by Licensor.
+* Notice. Licensee must ensure that everyone who gets a copy of any part
+of this Software from Licensee, with or without changes, also receives
+the License and the above copyright notice (and if included by the
+Licensor, patent, trademark and attribution notice). Licensee must cause
+any modified versions of the Software to carry prominent notices stating
+that Licensee changed the Software. For clarity, although Licensee is
+free to create modifications of the Software and distribute only the
+modified portion created by Licensee with additional or different terms,
+the portion of the Software not modified must be distributed pursuant to
+this License. If anyone notifies Licensee in writing that Licensee has
+not complied with this Notice section, Licensee can keep this License by
+taking all practical steps to comply within 30 days after the notice. If
+Licensee does not do so, Licensee’s License (and all rights licensed
+hereunder) shall end immediately.
+* Compliance with Human Rights Principles and Human Rights Laws.
+[arabic]
+. Human Rights Principles.
+[loweralpha]
+.. Licensee is advised to consult the articles of the United Nations
+Universal Declaration of Human Rights and the United Nations Global
+Compact that define recognized principles of international human rights
+(the "Human Rights Principles"). Licensee shall use the Software in a
+manner consistent with Human Rights Principles.
+.. Unless the Licensor and Licensee agree otherwise, any dispute,
+controversy, or claim arising out of or relating to (i) Section 1(a)
+regarding Human Rights Principles, including the breach of Section 1(a),
+termination of this License for breach of the Human Rights Principles,
+or invalidity of Section 1(a) or (ii) a determination of whether any Law
+is consistent or in conflict with Human Rights Principles pursuant to
+Section 2, below, shall be settled by arbitration in accordance with the
+Hague Rules on Business and Human Rights Arbitration (the "Rules");
+provided, however, that Licensee may elect not to participate in such
+arbitration, in which event this License (and all rights licensed
+hereunder) shall end immediately. The number of arbitrators shall be one
+unless the Rules require otherwise.
++
+Unless both the Licensor and Licensee agree to the contrary: (1) All
+documents and information concerning the arbitration shall be public and
+may be disclosed by any party; (2) The repository referred to under
+Article 43 of the Rules shall make available to the public in a timely
+manner all documents concerning the arbitration which are communicated
+to it, including all submissions of the parties, all evidence admitted
+into the record of the proceedings, all transcripts or other recordings
+of hearings and all orders, decisions and awards of the arbitral
+tribunal, subject only to the arbitral tribunal’s powers to take such
+measures as may be necessary to safeguard the integrity of the arbitral
+process pursuant to Articles 18, 33, 41 and 42 of the Rules; and (3)
+Article 26(6) of the Rules shall not apply.
+. Human Rights Laws. The Software shall not be used by any person or
+entity for any systems, activities, or other uses that violate any Human
+Rights Laws. "Human Rights Laws" means any applicable laws,
+regulations, or rules (collectively, "Laws") that protect human,
+civil, labor, privacy, political, environmental, security, economic, due
+process, or similar rights; provided, however, that such Laws are
+consistent and not in conflict with Human Rights Principles (a dispute
+over the consistency or a conflict between Laws and Human Rights
+Principles shall be determined by arbitration as stated above). Where
+the Human Rights Laws of more than one jurisdiction are applicable or in
+conflict with respect to the use of the Software, the Human Rights Laws
+that are most protective of the individuals or groups harmed shall
+apply.
+. Indemnity. Licensee shall hold harmless and indemnify Licensor (and
+any other contributor) against all losses, damages, liabilities,
+deficiencies, claims, actions, judgments, settlements, interest, awards,
+penalties, fines, costs, or expenses of whatever kind, including
+Licensor’s reasonable attorneys’ fees, arising out of or relating to
+Licensee’s use of the Software in violation of Human Rights Laws or
+Human Rights Principles.
+* Failure to Comply. Any failure of Licensee to act according to the
+terms and conditions of this License is both a breach of the License and
+an infringement of the intellectual property rights of the Licensor
+(subject to exceptions under Laws, e.g., fair use). In the event of a
+breach or infringement, the terms and conditions of this License may be
+enforced by Licensor under the Laws of any jurisdiction to which
+Licensee is subject. Licensee also agrees that the Licensor may enforce
+the terms and conditions of this License against Licensee through
+specific performance (or similar remedy under Laws) to the extent
+permitted by Laws. For clarity, except in the event of a breach of this
+License, infringement, or as otherwise stated in this License, Licensor
+may not terminate this License with Licensee.
+* Enforceability and Interpretation. If any term or provision of this
+License is determined to be invalid, illegal, or unenforceable by a
+court of competent jurisdiction, then such invalidity, illegality, or
+unenforceability shall not affect any other term or provision of this
+License or invalidate or render unenforceable such term or provision in
+any other jurisdiction; provided, however, subject to a court
+modification pursuant to the immediately following sentence, if any term
+or provision of this License pertaining to Human Rights Laws or Human
+Rights Principles is deemed invalid, illegal, or unenforceable against
+Licensee by a court of competent jurisdiction, all rights in the
+Software granted to Licensee shall be deemed null and void as between
+Licensor and Licensee. Upon a determination that any term or provision
+is invalid, illegal, or unenforceable, to the extent permitted by Laws,
+the court may modify this License to affect the original purpose that
+the Software be used in compliance with Human Rights Principles and
+Human Rights Laws as closely as possible. The language in this License
+shall be interpreted as to its fair meaning and not strictly for or
+against any party.
+* Disclaimer. TO THE FULL EXTENT ALLOWED BY LAW, THIS SOFTWARE COMES
+"AS IS," WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED, AND LICENSOR AND
+ANY OTHER CONTRIBUTOR SHALL NOT BE LIABLE TO ANYONE FOR ANY DAMAGES OR
+OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE
+OR THIS LICENSE, UNDER ANY KIND OF LEGAL CLAIM.
+
+This Hippocratic License is an link:https://ethicalsource.dev[Ethical Source license] and is offered
+for use by licensors and licensees at their own risk, on an "AS IS" basis, and with no warranties
+express or implied, to the maximum extent permitted by Laws.

LICENSE.md

@@ -1,163 +0,0 @@
-# Apache License
-
-Version 2.0, January 2004
-
-http://www.apache.org/licenses
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-## 1. Definitions
-
-"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by
-Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is
-granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all other entities that control, are
-controlled by, or are under common control with that entity. For the purposes of this definition,
-"control" means (i) the power, direct or indirect, to cause the direction or management of such
-entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
-outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this
-License.
-
-"Source" form shall mean the preferred form for making modifications, including but not limited to
-software source code, documentation source, and configuration files.
-
-"Object" form shall mean any form resulting from mechanical transformation or translation of a
-Source form, including but not limited to compiled object code, generated documentation, and
-conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or Object form, made available under the
-License, as indicated by a copyright notice that is included in or attached to the work (an example
-is provided in the Appendix below).
-
-"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or
-derived from) the Work and for which the editorial revisions, annotations, elaborations, or other
-modifications represent, as a whole, an original work of authorship. For the purposes of this
-License, Derivative Works shall not include works that remain separable from, or merely link (or
-bind by name) to the interfaces of, the Work and Derivative Works thereof.
-
-"Contribution" shall mean any work of authorship, including the original version of the Work and any
-modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted
-to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity
-authorized to submit on behalf of the copyright owner. For the purposes of this definition,
-"submitted" means any form of electronic, verbal, or written communication sent to the Licensor or
-its representatives, including but not limited to communication on electronic mailing lists, source
-code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor
-for the purpose of discussing and improving the Work, but excluding communication that is
-conspicuously marked or otherwise designated in writing by the copyright owner as "Not a
-Contribution."
-
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a
-Contribution has been received by Licensor and subsequently incorporated within the Work.
-
-## 2. Grant of Copyright License
-
-Subject to the terms and conditions of this License, each Contributor hereby grants to You a
-perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to
-reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and
-distribute the Work and such Derivative Works in Source or Object form.
-
-## 3. Grant of Patent License
-
-Subject to the terms and conditions of this License, each Contributor hereby grants to You a
-perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
-section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer
-the Work, where such license applies only to those patent claims licensable by such Contributor that
-are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s)
-with the Work to which such Contribution(s) was submitted. If You institute patent litigation
-against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or
-a Contribution incorporated within the Work constitutes direct or contributory patent infringement,
-then any patent licenses granted to You under this License for that Work shall terminate as of the
-date such litigation is filed.
-
-## 4. Redistribution
-
-You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with
-or without modifications, and in Source or Object form, provided that You meet the following
-conditions:
-
-1. You must give any other recipients of the Work or Derivative Works a copy of this License; and
-
-2. You must cause any modified files to carry prominent notices stating that You changed the
-   files; and
-
-3. You must retain, in the Source form of any Derivative Works that You distribute, all copyright,
-   patent, trademark, and attribution notices from the Source form of the Work, excluding those
-   notices that do not pertain to any part of the Derivative Works; and
-
-4. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative
-   Works that You distribute must include a readable copy of the attribution notices contained
-   within such NOTICE file, excluding those notices that do not pertain to any part of the
-   Derivative Works, in at least one of the following places: within a NOTICE text file
-   distributed as part of the Derivative Works; within the Source form or documentation, if
-   provided along with the Derivative Works; or, within a display generated by the Derivative
-   Works, if and wherever such third-party notices normally appear. The contents of the NOTICE
-   file are for informational purposes only and do not modify the License. You may add Your own
-   attribution notices within Derivative Works that You distribute, alongside or as an addendum to
-   the NOTICE text from the Work, provided that such additional attribution notices cannot be
-   construed as modifying the License.
-
-You may add Your own copyright statement to Your modifications and may provide additional or
-different license terms and conditions for use, reproduction, or distribution of Your modifications,
-or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of
-the Work otherwise complies with the conditions stated in this License.
-
-## 5. Submission of Contributions
-
-Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the
-Work by You to the Licensor shall be under the terms and conditions of this License, without any
-additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify
-the terms of any separate license agreement you may have executed with Licensor regarding such
-Contributions.
-
-## 6. Trademarks
-
-This License does not grant permission to use the trade names, trademarks, service marks, or product
-names of the Licensor, except as required for reasonable and customary use in describing the origin
-of the Work and reproducing the content of the NOTICE file.
-
-## 7. Disclaimer of Warranty
-
-Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each
-Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied, including, without limitation, any warranties or conditions of
-TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely
-responsible for determining the appropriateness of using or redistributing the Work and assume any
-risks associated with Your exercise of permissions under this License.
-
-## 8. Limitation of Liability
-
-In no event and under no legal theory, whether in tort (including negligence), contract, or
-otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or
-agreed to in writing, shall any Contributor be liable to You for damages, including any direct,
-indirect, special, incidental, or consequential damages of any character arising as a result of this
-License or out of the use or inability to use the Work (including but not limited to damages for
-loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial
-damages or losses), even if such Contributor has been advised of the possibility of such damages.
-
-## 9. Accepting Warranty or Additional Liability
-
-While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee
-for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights
-consistent with this License. However, in accepting such obligations, You may act only on Your own
-behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You
-agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or
-claims asserted against, such Contributor by reason of your accepting any such warranty or
-additional liability.
-
-END OF TERMS AND CONDITIONS
-
-Copyright 2016 [Alchemists](https://www.alchemists.io).
-
-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 [copy](http://www.apache.org/licenses/LICENSE-2.0) of
-the License.
-
-Unless required by applicable law or agreed to in writing, software distributed under the License is
-distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-implied. See the License for the specific language governing permissions and limitations under the
-License.

README.adoc

@@ -0,0 +1,228 @@
+:toc: macro
+:toclevels: 5
+:figure-caption!:
+
+= macOS
+
+Shell scripts for automated macOS machine setup.
+
+This project is a framework for automating the setup of a macOS machine. In order to illustrate the
+potential of what this project can do, please see the companion
+link:https://alchemists.io/projects/mac_os-config[macOS Config] project for details. The _macOS
+Config_ project is an opinionated configuration which meets the needs of my development environment
+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 foundational framework for building custom macOS machine setups.
+* *link:https://alchemists.io/projects/mac_os-config[macOS Configuration]* - The layer on top of
+  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::[]
+
+== Features
+
+* Provides a command line interface, written in Bash, with no additional dependencies for
+  installation and management of a macOS machine.
+* Supports macOS boot disk creation for fresh install of operating system.
+* Installs link:https://developer.apple.com/xcode[Xcode Command Line Tools].
+* Installs link:http://brew.sh[Homebrew] formulas and casks.
+* Installs link:http://www.apple.com/macosx/whats-new/app-store.html[App Store] software.
+* Installs non-App Store software applications.
+* Installs software application extensions.
+* Installs dotfiles.
+* Installs link:https://nodejs.org[Node] link:https://www.npmjs.com[packages].
+* Installs link:https://www.ruby-lang.org[Ruby] link:https://rubygems.org[gems].
+* Installs link:https://www.rust-lang.org[Rust] link:https://crates.io[crates].
+* Applies basic default software settings.
+* Configures installed software.
+* Supports restoration of machine backups.
+
+== Requirements
+
+. link:https://www.apple.com/macos/sonoma[macOS Sonoma]
+. link:https://developer.apple.com/xcode[Xcode]
+
+== Setup
+
+To install, run:
+
+[source,bash]
+----
+git clone https://github.com/bkuhlmann/mac_os.git
+cd mac_os
+git checkout 18.2.2
+----
+
+== Usage
+
+Run the following:
+
+[source,bash]
+----
+bin/run
+----
+
+You will be presented with the following options (listed in order of
+use):
+
+....
+Boot:
+   B:  Create boot disk.
+Install:
+   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.
+  df:  Install dotfiles.
+  np:  Install Node packages.
+  rg:  Install Ruby gems.
+  rc:  Install Rust crates.
+   d:  Apply default settings.
+  cs:  Configure installed software.
+   i:  Install everything (i.e. executes all install options in order listed).
+Restore:
+   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.
+....
+
+Choose option `i` to run a full install or select a specific option to run a single action. Each
+option is designed to be re-run if necessary. This can also be handy for performing upgrades,
+re-running a missing/failed install, etc.
+
+The option prompt can be skipped by passing the desired option directly to the `bin/run` script. For
+example, executing `bin/run i` will execute the full install process.
+
+The machine should be rebooted after all install tasks have completed to ensure all settings have
+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.
+
+=== Boot Disk
+
+When attempting to create a boot disk via `bin/run B`, you’ll be presented with the following
+documentation (provided here for reference):
+
+....
+macOS Boot Disk Tips
+  - Use a USB drive (8GB or higher).
+  - Use Disk Utility to format the USB drive as "Mac OS Extended (Journaled)".
+  - Use Disk Utility to label the USB drive as "Untitled".
+
+macOS Boot Disk Usage:
+  1. Insert the USB boot disk into the machine to be upgraded.
+  2. Reboot the machine.
+  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 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 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.
+....
+
+=== Customization
+
+All executable scripts can be found in the `bin` folder:
+
+* `bin/apply_basic_settings` (optional, customizable): Applies basic and initial settings for
+  setting up a machine.
+* `bin/apply_default_settings` (optional, customizable): Applies bare minimum system and application
+  defaults.
+* `bin/configure_software` (optional, customizable): Configures installed software as part of the
+  post install process.
+* `bin/create_boot_disk` (optional): Creates a macOS boot disk.
+* `bin/install_app_store` (optional, customizable): Installs macOS, GUI-based, App Store
+  applications.
+* `bin/install_applications` (optional, customizable): Installs macOS, GUI-based, non-App Store
+  applications.
+* `bin/install_dev_tools` (required): Installs macOS development tools required by Homebrew.
+* `bin/install_dotfiles` (optional, customizable): Installs personal dotfiles so the system is
+  tailored to your workflow.
+* `bin/install_extensions` (optional, customizable): Installs macOS application extensions and
+  add-ons.
+* `bin/install_homebrew_casks` (optional, customizable): Installs Homebrew Formulas.
+* `bin/install_homebrew_formulas` (optional, customizable): Installs Homebrew Casks.
+* `bin/install_node_packages` (optional, customizable): Installs Node packages.
+* `bin/install_ruby_gems` (optional, customizable): Installs Ruby gems.
+* `bin/install_rust_crates` (optional, customizable): Installs Rust crates.
+* `bin/restore_backup` (optional, customizable): Restores system/application settings from backup
+  image.
+* `bin/run` (required): The main script and interface for macOS setup.
+
+The `lib` folder provides the base framework for installing, re-installing, and uninstalling
+software. Everything provided via the link:https://alchemists.io/projects/mac_os-config[macOS
+Config] project is built upon the functions found in the `lib` folder. See the
+link:https://alchemists.io/projects/mac_os-config[macOS Config] project for further details.
+
+* `lib/settings.sh`: Defines global settings for software applications, extensions, etc.
+
+=== Troubleshooting
+
+* *Pi-hole*: 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.
+* *Recovery Mode*: When using the boot disk and the installer fails in some catastrophic manner,
+  reboot the machine into recovery mode -- pass:[<kbd>POWER</kbd>] (Silicon) or
+  pass:[<kbd>COMMAND</kbd>] + pass:[<kbd>r</kbd>] (Intel) buttons -- to download and install the
+  last operating system used. Alternatively, you can also use pass:[<kbd>COMMAND</kbd>] +
+  pass:[<kbd>OPTION</kbd>] + pass:[<kbd>r</kbd>] (Intel) to attempt to download the latest operating
+  system.
+* *NVRAM/PRAM Reset*: 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 pass:[<kbd>OPTION</kbd>] + pass:[<kbd>COMMAND</kbd>] + pass:[<kbd>r</kbd>] +
+  pass:[<kbd>p</kbd>] (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).
+* *System Management Controller (SMC) Reset*: Sometimes it can help to reset the SMC to improve
+  system speed. To fix, follow these steps:
+** Shut down your Mac.
+** Hold down pass:[<kbd>CONTROL</kbd>] + pass:[<kbd>OPTION</kbd>] on the left side of the keyboard
+   and pass:[<kbd>SHIFT</kbd>] on the right side of the keyboard.
+** After seven seconds, hold down the Power button as well.
+** Release all keys after another seven seconds.
+** Turn on your Mac.
+
+== Development
+
+To contribute, run:
+
+[source,bash]
+----
+git clone https://github.com/bkuhlmann/mac_os.git
+cd mac_os
+----
+
+== link:https://alchemists.io/policies/license[License]
+
+== link:https://alchemists.io/policies/security[Security]
+
+== link:https://alchemists.io/policies/code_of_conduct[Code of Conduct]
+
+== link:https://alchemists.io/policies/contributions[Contributions]
+
+== link:https://alchemists.io/projects/mac_os/versions[Versions]
+
+== link:https://alchemists.io/community[Community]
+
+== Credits
+
+Engineered by link:https://alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].

README.md

@@ -1,185 +0,0 @@
-# macOS
-
-[![Circle CI Status](https://circleci.com/gh/bkuhlmann/mac_os.svg?style=svg)](https://circleci.com/gh/bkuhlmann/mac_os)
-
-Shell scripts for automated macOS machine setup.
-
-This project is a framework for automating the setup of a macOS machine. In order to illustrate the
-potential of what this project can do, please see the companion
-[macOS Config](https://github.com/bkuhlmann/mac_os-config) project for details. The *macOS Config*
-project is an opinionated configuration which meets the needs of my development environment 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 Configuration](https://github.com/bkuhlmann/mac_os-config)** - 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.
-
-<!-- Tocer[start]: Auto-generated, don't remove. -->
-
-## Table of Contents
-
-  - [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)
-
-<!-- Tocer[finish]: Auto-generated, don't remove. -->
-
-## Features
-
-- Provides a command line interface, written in Bash, with no additional dependencies for
-  installation and management of a macOS machine.
-- Supports macOS boot disk creation for fresh install of operating system.
-- 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 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.
-- Downloads, installs, and configures software application extensions.
-- Applies basic and default software settings.
-- Sets up and configures installed software for use.
-- Supports restoration of machine backups.
-
-## Screencast
-
-[![asciicast](https://asciinema.org/a/155990.png)](https://asciinema.org/a/155990)
-
-## Requirements
-
-1. [macOS Mojave](https://www.apple.com/macos) (with latest software updates applied)
-1. [Xcode](https://developer.apple.com/xcode) (with accepted license agreement)
-
-## Setup
-
-Open a terminal window and execute one of the following setup sequences depending on your version
-preference:
-
-Current Version (stable):
-
-    git clone https://github.com/bkuhlmann/mac_os.git
-    cd mac_os
-    git checkout 6.1.0
-
-Master Version (unstable):
-
-    git clone https://github.com/bkuhlmann/mac_os.git
-    cd mac_os
-
-## Usage
-
-Run the following:
-
-    bin/run
-
-You will be presented with the following options (listed in order of use):
-
-    Boot:
-       B:  Create boot disk.
-    Install:
-       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.
-    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.
-
-Choose option `i` to run a full install or select a specific option to run a single action. Each
-option is designed to be re-run if necessary. This can also be handy for performing upgrades,
-re-running a missing/failed install, etc.
-
-The option prompt can be skipped by passing the desired option directly to the `bin/run` script. For
-example, executing `bin/run i` will execute the full install process.
-
-The machine should be rebooted after all install tasks have completed to ensure all settings have
-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
-
-All executable scripts can be found in the `bin` folder:
-
-- `bin/apply_basic_settings`: Applies basic, initial, settings for setting up a machine. *Can be
-  customized.*
-- `bin/apply_default_settings`: Applies useful system and application defaults. *Can be customized.*
-- `bin/create_boot_disk`: Creates macOS boot disk.
-- `bin/install_app_store`: Installs macOS, GUI-based, App Store applications. *Can be customized.*
-- `bin/install_applications`: Installs macOS, GUI-based, non-App Store applications. *Can be
-  customized.*
-- `bin/install_dev_tools`: Installs macOS development tools required by Homebrew.
-- `bin/install_extensions`: Installs macOS application extensions and add-ons. *Can be customized.*
-- `bin/install_homebrew_casks`: Installs Homebrew Formulas. *Can be customized.*
-- `bin/install_homebrew_formulas`: Installs Homebrew Casks. *Can be customized.*
-- `bin/restore_backup`: Restores system/application settings from backup image. *Can be customized.*
-- `bin/run`: The main script and interface for macOS setup.
-- `bin/setup_software`: Configures and launches (if necessary) installed software. *Can be
-  customized.*
-
-The `lib` folder provides the base framework for installing, re-installing, and uninstalling
-software. Everything provided via the [macOS Config](https://github.com/bkuhlmann/mac_os-config)
-project is built upon the functions found in the `lib` folder. See the
-[macOS Config](https://github.com/bkuhlmann/mac_os-config) project for further details.
-
-  - `lib/settings.sh`: Defines global settings for software applications, extensions, etc.
-
-## Versioning
-
-Read [Semantic Versioning](https://semver.org) for details. Briefly, it means:
-
-- 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
-
-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.
-
-## Contributions
-
-Read [CONTRIBUTING](CONTRIBUTING.md) for details.
-
-## License
-
-Copyright 2016 [Alchemists](https://www.alchemists.io).
-Read [LICENSE](LICENSE.md) for details.
-
-## History
-
-Read [CHANGES](CHANGES.md) for details.
-Built with [Bashsmith](https://github.com/bkuhlmann/bashsmith).
-
-## Credits
-
-Developed by [Brooke Kuhlmann](https://www.alchemists.io) at
-[Alchemists](https://www.alchemists.io).

Rakefile

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
-begin
+require "git/lint/rake/register"
-  require "git/cop/rake/setup"
+require "rubocop/rake_task"
-rescue LoadError => error
-  puts error.message
-end
 
-task default: :git_cop
+Git::Lint::Rake::Register.call
+RuboCop::RakeTask.new
+
+desc "Run code quality checks"
+task quality: %i[git_lint rubocop]
+
+task default: :quality

VERSIONS.adoc

@@ -0,0 +1,394 @@
+= Versions
+
+== 18.2.2 (2024-06-01)
+
+* 🔼 Updated citation URLs - Brooke Kuhlmann
+* 🔼 Updated to Ruby 3.3.2 - Brooke Kuhlmann
+
+== 18.2.1 (2024-05-02)
+
+* 🔼 Updated to Ruby 3.3.1 - Brooke Kuhlmann
+
+== 18.2.0 (2024-04-21)
+
+* 🔼 Updated RuboCop to use XDG local configuration - Brooke Kuhlmann
+* 🔼 Updated to Caliber 0.51.0 - Brooke Kuhlmann
+* 🔼 Updated to Git Lint 7.1.0 - Brooke Kuhlmann
+* 🔼 Updated to Git Lint 7.3.0 - Brooke Kuhlmann
+* 🔼 Updated to Rake 13.2.0 - Brooke Kuhlmann
+
+== 18.1.0 (2024-02-25)
+
+* 🔼 Updated to Caliber 0.50.0 - Brooke Kuhlmann
+* 🔁 Refactored bin script printing - Brooke Kuhlmann
+* 🔁 Refactored library functions - Brooke Kuhlmann
+
+== 18.0.0 (2024-01-06)
+
+* Added Rakefile quality task - Brooke Kuhlmann
+* Updated Circle CI step names - Brooke Kuhlmann
+* Updated GitHub issue template with simplified sections - Brooke Kuhlmann
+* Updated gem dependencies - Brooke Kuhlmann
+* Updated to Caliber 0.42.0 - Brooke Kuhlmann
+* Updated to Ruby 3.3.0 - Brooke Kuhlmann
+* Refactored Gemfile to use ruby file syntax - Brooke Kuhlmann
+
+== 17.0.0 (2023-09-28)
+
+* Added Debug gem - Brooke Kuhlmann
+* Updated to macOS Sonoma - Brooke Kuhlmann
+
+== 16.0.4 (2023-06-19)
+
+* Updated to Caliber 0.35.0 - Brooke Kuhlmann
+* Updated to Git Lint 6.0.0 - Brooke Kuhlmann
+* Updated to Refinements 11.0.0 - Brooke Kuhlmann
+
+== 16.0.3 (2023-05-18)
+
+* Updated to Caliber 0.30.0 - Brooke Kuhlmann
+
+== 16.0.2 (2023-04-02)
+
+* Fixed programs without extensions to install to user directory - Brooke Kuhlmann
+* Updated site URLs to use bare domain - Brooke Kuhlmann
+* Updated to Ruby 3.2.1 - Brooke Kuhlmann
+* Updated to Ruby 3.2.2 - Brooke Kuhlmann
+
+== 16.0.1 (2023-02-05)
+
+* Added Rake binstub - Brooke Kuhlmann
+* Updated to Caliber 0.21.0 - Brooke Kuhlmann
+* Updated to Caliber 0.25.0 - Brooke Kuhlmann
+* Updated to Git Lint 5.0.0 - Brooke Kuhlmann
+
+== 16.0.0 (2022-12-25)
+
+* Fixed Node installer to detect Node and version - Brooke Kuhlmann
+* Fixed Ruby installer to pass configuration options - Brooke Kuhlmann
+* Updated README sections - Brooke Kuhlmann
+* Updated installs for basic, default, and shell scripts - Brooke Kuhlmann
+* Updated run script to distinquish between applications and libraries - Brooke Kuhlmann
+* Updated to Caliber 0.11.0 - Brooke Kuhlmann
+* Updated to Caliber 0.16.0 - Brooke Kuhlmann
+* Updated to Ruby 3.1.3 - Brooke Kuhlmann
+* Updated to Ruby 3.2.0 - Brooke Kuhlmann
+* Updated to macOS Ventura - Brooke Kuhlmann
+* Removed configure software script - Brooke Kuhlmann
+* Removed mention of Intel CPUs from boot disk instructions - Brooke Kuhlmann
+* Removed system update from Ruby install - Brooke Kuhlmann
+* Removed uninstallers and reinstallers - Brooke Kuhlmann
+* Refactored download file function to use multi-line curl command - Brooke Kuhlmann
+
+== 15.0.5 (2022-05-07)
+
+* Updated to Caliber 0.6.0 - Brooke Kuhlmann
+* Updated to Caliber 0.7.0 - Brooke Kuhlmann
+* Updated to Caliber 0.8.0 - Brooke Kuhlmann
+
+== 15.0.4 (2022-04-17)
+
+* Added GitHub sponsorship configuration - Brooke Kuhlmann
+* Updated to Caliber 0.4.0 - Brooke Kuhlmann
+* Updated to Caliber 0.5.0 - Brooke Kuhlmann
+* Updated to Git Lint 4.0.0 - Brooke Kuhlmann
+* Updated to Ruby 3.1.2 - Brooke Kuhlmann
+
+== 15.0.3 (2022-03-16)
+
+* Fixed Homebrew install to initially default to ZSH - Brooke Kuhlmann
+
+== 15.0.2 (2022-03-03)
+
+* Fixed Hippocratic License to be 2.1.0 version - Brooke Kuhlmann
+* Added Caliber gem - Brooke Kuhlmann
+* Added Ruby version to Gemfile - Brooke Kuhlmann
+* Updated default Rake task to include Git Lint and Rubocop - Brooke Kuhlmann
+* Updated to Git Lint 3.2.0 - Brooke Kuhlmann
+* Updated to Ruby 3.1.1 - Brooke Kuhlmann
+* Removed README badges - Brooke Kuhlmann
+
+== 15.0.1 (2022-01-01)
+
+* Updated README policy section links - Brooke Kuhlmann
+* Updated changes as versions documentation - Brooke Kuhlmann
+* Updated to Git Lint 3.0.0 - Brooke Kuhlmann
+* Removed code of conduct and contributing files - Brooke Kuhlmann
+
+== 15.0.0 (2021-12-27)
+
+* Fixed Hippocratic license structure - Brooke Kuhlmann
+* Fixed README changes and credits sections - Brooke Kuhlmann
+* Fixed Rubocop Bundler/OrderedGems issue - Brooke Kuhlmann
+* Fixed contributing documentation - Brooke Kuhlmann
+* Added README community link - Brooke Kuhlmann
+* Added README troubleshooting guide for SMC reset - Brooke Kuhlmann
+* Added project citation information - Brooke Kuhlmann
+* Updated GitHub issue template - Brooke Kuhlmann
+* Updated to Hippocratic License 3.0.0 - Brooke Kuhlmann
+* Updated to Ruby 3.0.3 - Brooke Kuhlmann
+* Updated to Ruby 3.1.0 - Brooke Kuhlmann
+
+== 14.0.0 (2021-10-25)
+
+* Updated to macOS Monterey - Brooke Kuhlmann
+* Removed notes from pull request template - Brooke Kuhlmann
+
+== 13.0.0 (2021-08-01)
+
+* Added install Node function - Brooke Kuhlmann
+* Updated Node package install script to use NPM - Brooke Kuhlmann
+* Updated Ruby installer to use Frum - Brooke Kuhlmann
+* Updated shell option help text - Brooke Kuhlmann
+* Removed NPM install check function - Brooke Kuhlmann
+
+== 12.0.1 (2021-07-17)
+
+* Updated to Ruby 3.0.1 - Brooke Kuhlmann
+* Updated to Ruby 3.0.2 - Brooke Kuhlmann
+
+== 12.0.0 (2021-03-16)
+
+* Fixed environment configuration to source Bash resource - Brooke Kuhlmann
+* Added Homebrew installation to Homebrew sripts - Brooke Kuhlmann
+* Added Node packages script - Brooke Kuhlmann
+* Added Ruby gems script - Brooke Kuhlmann
+* Added Rust crates script - Brooke Kuhlmann
+* Added bare package installer - Brooke Kuhlmann
+* Added dotfiles script - Brooke Kuhlmann
+* Added mas check to App Store install script - Brooke Kuhlmann
+* Added version release notes - Brooke Kuhlmann
+* Updated dev tools installer to agree to Rosetta license - Brooke Kuhlmann
+* Updated install root detection to support Elm - Brooke Kuhlmann
+* Updated setup software as configure software script - Brooke Kuhlmann
+* Removed CPU detection in favor of architecture detection - Brooke Kuhlmann
+* Refactored install scripts to separate script paths - Brooke Kuhlmann
+
+== 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
+* Removed Homebrew Mecurial formula verification check
+* Removed unnecessary verifier code comments
+* Refactored utility basename and extension utilities
+
+== 8.2.0 (2020-07-22)
+
+* Fixed project requirements
+* Fixed screencast image URL
+* Updated GitHub templates
+* Updated README credit URL
+* Updated README screencast URL
+* Updated README screencast cover to SVG format
+* Updated to Git Lint 1.0.0
+* Refactored Rakefile requirements
+
+== 8.1.0 (2020-04-01)
+
+* Added README production and development setup instructions
+* Updated Circle CI build label
+* Updated README screencast to use larger image
+* Updated documentation to ASCII Doc format
+* Updated to Code of Conduct 2.0.0
+* Updated to Git Cop 4.0.0
+* Updated to Ruby 2.7.1
+* Removed README images
+
+== 8.0.1 (2020-01-01)
+
+* Added Startup Security Utility to README.
+* Updated README screencast.
+* Updated to Ruby 2.7.0.
+* Refactored caffeinate machine function to process grep.
+
+== 8.0.0 (2019-10-12)
+
+* Updated to Rake 13.0.0.
+* Updated to Ruby 2.6.5.
+* Updated to macOS Catalina.
+
+== 7.2.1 (2019-09-01)
+
+* Updated README screencast tutorial.
+* Updated to Ruby 2.6.4.
+
+== 7.2.0 (2019-08-01)
+
+* Added file install function.
+
+== 7.1.2 (2019-06-01)
+
+* Updated contributing documentation.
+* Updated to Git Cop 3.5.0.
+
+== 7.1.1 (2019-05-01)
+
+* Added project icon to README.
+* Updated to Ruby 2.6.3.
+
+== 7.1.0 (2019-04-01)
+
+* Added XCode installer fix to troubleshooting section.
+* Updated to Ruby 2.6.1.
+* Updated to Ruby 2.6.2.
+
+== 7.0.0 (2019-01-01)
+
+* Fixed Circle CI cache for Ruby version.
+* Fixed installation of apps with no extension.
+* Fixed program installs.
+* Added Circle CI Bundler cache.
+* Added README boot disk documentation.
+* Added README troubleshooting section.
+* Updated to Git Cop 3.0.0.
+* Updated to Ruby 2.6.0.
+* Removed Java development tools from setup.
+* Removed download file function.
+
+== 6.1.0 (2018-11-01)
+
+* Updated to Java SE Development Kit 11.
+* Updated to Ruby 2.5.2.
+* Updated to Ruby 2.5.3.
+* Removed unnecessary source code comments.
+
+== 6.0.0 (2018-10-01)
+
+* Added XCode install tip.
+* Updated boot disk creation to macOS Mojave.
+* Updated to Contributor Covenant Code of Conduct 1.4.1.
+* Updated to Java SE Development Kit 10.
+
+== 5.0.0 (2018-08-01)
+
+* Fixed Markdown ordered list numbering.
+* Fixed verification of Homebrew formulas.
+* Added App Store application verification.
+* Added Homebrew cask application verifier.
+* Updated Git checkout to silence detached head warnings.
+* Updated README documentation.
+* Updated Semantic Versioning links to be HTTPS.
+* Updated boot disk format documentation.
+* Updated project changes to use semantic versions.
+* Removed Java install support.
+* Removed restorer functions.
+* Refactored function parameter documentation.
+* Refactored library function order.
+
+== 4.1.0 (2018-04-01)
+
+* Updated README license information.
+* Updated README screencast tutorial.
+* Updated to Circle CI 2.0.0 configuration.
+* Updated to Git Cop 2.2.0.
+* Updated to Ruby 2.5.1.
+* Removed Patreon badge from README.
+
+== 4.0.0 (2018-01-01)
+
+* Added Gemfile.lock to .gitignore.
+* Updated to Apache 2.0 license.
+* Updated to Ruby 2.4.3.
+* Updated to Ruby 2.5.0.
+
+== 3.1.0 (2017-11-26)
+
+* Updated Gemfile.lock file.
+* Updated boot disk documenation to mention APFS.
+* Updated to Bundler 1.16.0.
+* Updated to Git Cop 1.7.0.
+* Updated to Rake 12.3.0.
+* Updated to Rubocop 0.51.0.
+
+== 3.0.0 (2017-10-01)
+
+* Fixed table of contents.
+* Updated boot disk creation to use macOS High Sierra.
+* Updated gem dependencies.
+* Updated to Git Cop 1.6.0.
+* Updated to Ruby 2.4.2.
+
+== 2.2.0 (2017-07-16)
+
+* Added Git Cop support.
+* Updated CONTRIBUTING documentation.
+* Updated GitHub templates.
+* Updated README headers.
+* Updated gem dependencies.
+
+== 2.1.0 (2017-04-29)
+
+* Fixed Java SE Development Kit install.
+* Fixed install-all command
+
+== 2.0.0 (2017-04-09)
+
+* Added Homebrew Casks install script.
+* Updated README semantic versioning order.
+* Updated contributing documentation.
+* Refactored Homebrew software as Homebrew Formulas.
+
+== 1.3.1 (2017-01-08)
+
+* Fixed install of zip app downloads with sub-directories.
+
+== 1.3.0 (2017-01-01)
+
+* Updated README versioning documentation.
+* Removed CHANGELOG.md (use CHANGES.md instead).
+
+== 1.2.0 (2016-10-12)
+
+* Fixed reinstaller path issues with application and extension scripts.
+* Added screencast to README.
+
+== 1.1.0 (2016-10-11)
+
+* Fixed Bash script header to dynamically load correct environment.
+* Fixed verification of Homebrew application installs.
+* Added script hook for App Store software install.
+* Added script hooks for unfinished custom configurations.
+* Updated and clarified README documentation.
+
+== 1.0.0 (2016-10-05)
+
+* Initial version.

bin/apply_basic_settings

@@ -1,15 +0,0 @@
-#! /usr/bin/env bash
-
-# Applies basic system settings.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/apply_basic_settings"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Basic settings script does not exist or is not executable.\n"
-fi

bin/apply_default_settings

@@ -1,15 +0,0 @@
-#! /usr/bin/env bash
-
-# Applies default settings.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/apply_default_settings"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Default settings script does not exist or is not executable.\n"
-fi

bin/create_boot_disk

@@ -2,33 +2,33 @@
 
 # Creates macOS boot disk.
 
-printf "macOS Boot Disk Tips\n"
+printf "%s\n" "macOS Boot Disk Tips"
-printf "  - Use a USB drive (8GB or higher).\n"
+printf "%s\n" "  - Use a USB drive (8GB or higher)."
-printf "  - Use Disk Utility to format the USB drive as \"Mac OS Extended (Journaled)\".\n"
+printf "%s\n" "  - Use Disk Utility to format the USB drive as \"APSF\"."
-printf "  - Use Disk Utility to label the USB drive as \"Untitled\".\n"
+printf "%s\n" "  - Use Disk Utility to label the USB drive as \"Untitled\"."
-printf "\nmacOS Boot Disk Usage:\n"
+printf "\n%s\n" "macOS Boot Disk Usage:"
-printf "  1. Insert the USB boot disk into the machine to be upgraded.\n"
+printf "%s\n" "  1. Insert the USB boot disk into the machine to be upgraded."
-printf "  2. Reboot the machine.\n"
+printf "%s\n" "  2. Reboot the machine."
-printf "  3. Hold down the OPTION key before the Apple logo appears.\n"
+printf "%s\n" "  3. Press and hold the POWER key before the Apple logssssso appears."
-printf "  4. Select the USB boot disk from the menu.\n"
+printf "%s\n" "  4. Select the USB boot disk from the menu."
-printf "  5. Use Disk Utility to format the machine's drive as \"APFS (Encrypted)\".\n"
+printf "%s\n" "  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions."
-printf "  6. Install the new operating system.\n"
+printf "%s\n" "  6. Use Disk Utility to create a single \"APFS\" drive."
-printf "\nmacOS Reinstall:\n"
+printf "%s\n" "  7. Install the new operating system."
-printf "  1. Click the Apple icon from the operating system main menu.\n"
+printf "\n%s\n" "macOS Boot Disk Recovery:"
-printf "  2. Select the \"Restart...\" menu option.\n"
+printf "%s\n" "  1. Start/restart the machine."
-printf "  3. Hold down the COMMAND+R keys before the Apple logo appears.\n"
+printf "%s\n" "  2. Press and hold the POWER key before the Apple logo appears."
-printf "  4. Wait for the macOS installer to load from the recovery partition.\n"
+printf "%s\n" "  3. Wait for the macOS installer to load from the recovery partition."
-printf "  5. Use the dialog options to launch Disk Utility, reinstall the system, etc.\n"
+printf "%s\n" "  4. Use the dialog options to launch Disk Utility, reinstall the system, etc."
 
-printf "\nCreating macOS boot disk...\n"
+printf "\n%s\n" "Creating macOS boot disk..."
 
 if [[ ! -e "$MAC_OS_BOOT_DISK_CREATOR" ]]; then
-  printf "ERROR: macOS installer does not exist: $MAC_OS_BOOT_DISK_CREATOR. Use App Store to download.\n"
+  printf "%s\n" "ERROR: macOS installer does not exist: $MAC_OS_BOOT_DISK_CREATOR. Use System Preferences → Software Update to download."
   exit 1
 fi
 
 if [[ ! -d "$MAC_OS_BOOT_DISK_PATH" ]]; then
-  printf "ERROR: Boot disk must be mounted at: $MAC_OS_BOOT_DISK_PATH.\n"
+  printf "%s\n" "ERROR: Boot disk must be mounted at: $MAC_OS_BOOT_DISK_PATH."
   exit 1
 fi
 

bin/install_app_store

@@ -6,10 +6,12 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_app_store"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
+  check_mas_install
   "$SCRIPT_PATH"
 else
-  printf "WARNING: App Store install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: App Store install script does not exist or is not executable."
 fi

bin/install_applications

@@ -6,10 +6,11 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_applications"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
   "$SCRIPT_PATH"
 else
-  printf "WARNING: Applications install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Applications install script does not exist or is not executable."
 fi

bin/install_basics

@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+# Installs basic system settings.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_basics"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Basic settings script does not exist or is not executable."
+fi

bin/install_defaults

@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+# Installs system and application default settings.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_defaults"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Default settings script does not exist or is not executable."
+fi

bin/install_dev_tools

@@ -2,22 +2,16 @@
 
 # Installs development tooling requirements.
 
-printf "Installing Xcode CLI tools...\n"
+printf "%s\n" "Installing Xcode CLI tools..."
 xcode-select --install
 
 printf "%s\n" "💡 ALT+TAB to view and accept Xcode license window."
 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"
+  printf "%s\n" "ERROR: Xcode CLI tools must be installed before proceeding."
   exit 1
 fi
 
-printf "Installing $JAVA_LABEL...\n"
+if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
-printf "%s\n" "You must manually accept the license and download the $JAVA_LABEL: $JAVA_DOWNLOAD_URL."
+  softwareupdate --install-rosetta --agree-to-license
-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_extensions

@@ -6,10 +6,11 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_extensions"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
   "$SCRIPT_PATH"
 else
-  printf "WARNING: Application extensions install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Application extensions install script does not exist or is not executable."
 fi

bin/install_homebrew_casks

@@ -6,10 +6,12 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
+  install_homebrew
   "$SCRIPT_PATH"
 else
-  printf "WARNING: Homebrew Casks install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Homebrew Casks install script does not exist or is not executable."
 fi

bin/install_homebrew_formulas

@@ -6,10 +6,12 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew_formulas"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
+  install_homebrew
   "$SCRIPT_PATH"
 else
-  printf "WARNING: Homebrew Formulas install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Homebrew Formulas install script does not exist or is not executable."
 fi

bin/install_node_packages

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+# Installs Node packages.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_node_packages"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  install_node
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Node packages install script does not exist or is not executable."
+fi

bin/install_ruby_gems

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+# Installs Ruby gems.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_ruby_gems"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  install_ruby
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Ruby gems install script does not exist or is not executable."
+fi

bin/install_rust_crates

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+# Installs Rust crates.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_rust_crates"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  install_rust
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Rust crates install script does not exist or is not executable."
+fi

bin/install_shell

@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+# Installs shell.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_shell"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Shell script does not exist or is not executable."
+fi

bin/rake

@@ -0,0 +1,6 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+
+load Gem.bin_path "rake", "rake"

bin/restore_backup

@@ -6,10 +6,11 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/restore_backup"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
   "$SCRIPT_PATH"
 else
-  printf "WARNING: Restore backup script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Restore backup script does not exist or is not executable."
 fi

bin/run

@@ -4,58 +4,58 @@
 
 source lib/installers.sh
 source lib/options.sh
-source lib/reinstallers.sh
 source lib/settings.sh
-source lib/uninstallers.sh
 source lib/utilities.sh
 source lib/verifiers.sh
 
 if [[ -e "$MAC_OS_CONFIG_PATH" ]]; then
   source "$MAC_OS_CONFIG_PATH/lib/settings.sh"
 else
-  printf "ERROR: Unable to load macOS configuration: $MAC_OS_CONFIG_PATH.\n\n"
+  printf "%s\n\n" "ERROR: Unable to load macOS configuration: $MAC_OS_CONFIG_PATH."
-  printf "Please check the following before continuing:\n"
+  printf "%s\n" "Please check the following before continuing:"
-  printf "  • Download the default macOS configuration here: https://github.com/bkuhlmann/mac_os-config.\n"
+  printf "%s\n" "  • Download the default macOS configuration here: https://github.com/bkuhlmann/mac_os-config."
-  printf "  • Customize as necessary for your setup or fork the project and make your own configuration.\n"
+  printf "%s\n" "  • Customize as necessary for your setup or fork the project and make your own configuration."
-  printf "  • When finished, your folder structure should look like this:\n"
+  printf "%s\n" "  • When finished, your folder structure should look like this:"
-  printf "    • <root path>/mac_os:\n"
+  printf "%s\n" "    • <root path>/mac_os:"
-  printf "    • <root path>/mac_os-config:\n"
+  printf "%s\n" "    • <root path>/mac_os-config:"
   exit 1
 fi
 
+configure_environment
+
 while true; do
   if [[ $# == 0 ]]; then
-    printf "\nUsage: run OPTION\n"
+    printf "\n%s\n" "Usage: run OPTION"
-    printf "\nOSX Options:\n"
+    printf "\n%s\n" "OSX Options:"
-    printf "  Boot:\n"
+    printf "%s\n" "  Boot:"
-    printf "     B:  Create boot disk.\n"
+    printf "%s\n" "     B:  Create boot disk."
-    printf "  Install:\n"
+    printf "%s\n" "  Install:"
-    printf "     b:  Apply basic settings.\n"
+    printf "%s\n" "     b:  Install basics."
-    printf "     t:  Install development tools.\n"
+    printf "%s\n" "     t:  Install development tools."
-    printf "    hf:  Install Homebrew Formulas.\n"
+    printf "%s\n" "    hf:  Install Homebrew Formulas."
-    printf "    hc:  Install Homebrew Casks.\n"
+    printf "%s\n" "    hc:  Install Homebrew Casks."
-    printf "     m:  Install Mac App Store software.\n"
+    printf "%s\n" "     m:  Install Mac App Store software."
-    printf "     a:  Install application software.\n"
+    printf "%s\n" "     a:  Install application software."
-    printf "     x:  Install application software extensions.\n"
+    printf "%s\n" "     x:  Install application software extensions."
-    printf "     d:  Apply default settings.\n"
+    printf "%s\n" "     d:  Install defaults."
-    printf "     s:  Setup installed software.\n"
+    printf "%s\n" "     s:  Install shell."
-    printf "     i:  Install everything (i.e. executes all install options).\n"
+    printf "%s\n" "     r:  Restore backups."
-    printf "  Restore:\n"
+    printf "%s\n" "     i:  Install all (i.e. executes all of the above steps in order listed)."
-    printf "     R:  Restore settings from backup.\n"
+    printf "%s\n" "  Libraries:"
-    printf "  Manage:\n"
+    printf "%s\n" "    np:  Install Node packages."
-    printf "     c:  Check status of managed software.\n"
+    printf "%s\n" "    rg:  Install Ruby gems."
-    printf "     C:  Caffeinate machine.\n"
+    printf "%s\n" "    rc:  Install Rust crates."
-    printf "    ua:  Uninstall application software.\n"
+    printf "%s\n" "     l:  Install libraries (i.e. executes all of the above steps in order listed)."
-    printf "    ux:  Uninstall application software extension.\n"
+    printf "%s\n" "  Manage:"
-    printf "    ra:  Reinstall application software.\n"
+    printf "%s\n" "     c:  Check status of managed software."
-    printf "    rx:  Reinstall application software extension.\n"
+    printf "%s\n" "     C:  Caffeinate machine."
-    printf "     w:  Clean work (temp) directory.\n"
+    printf "%s\n" "     w:  Clean work (temp) directory."
-    printf "     q:  Quit/Exit.\n\n"
+    printf "%s\n\n" "     q:  Quit/Exit."
     read -p "Enter selection: " response
     printf "\n"
-    process_option $response
+    process_option "$response"
   else
-    process_option $1
+    process_option "$1"
   fi
 
   break

bin/setup_software

@@ -1,15 +0,0 @@
-#! /usr/bin/env bash
-
-# Sets up and launches (if necessary) installed software.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/setup_software"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Software setup script does not exist or is not executable.\n"
-fi

circle.yml

@@ -1,33 +0,0 @@
-version: 2
-jobs:
-  build:
-    working_directory: ~/project
-    docker:
-      - image: circleci/ruby:2.5
-        environment:
-          BUNDLE_JOBS: 3
-          BUNDLE_RETRY: 3
-          BUNDLE_PATH: vendor/bundle
-          EDITOR: vim
-    steps:
-      - checkout
-
-      - type: cache-restore
-        name: Bundler Cache Restore
-        key: bundle-{{ checksum "Gemfile" }}
-
-      - run:
-          name: Bundler Install
-          command: |
-            gem update --system
-            bundle check || bundle install
-
-      - type: cache-save
-        name: Bundler Cache Store
-        key: bundle-{{ checksum "Gemfile" }}
-        paths:
-          - vendor/bundle
-
-      - run:
-          name: Rake Run
-          command: bundle exec rake

lib/installers.sh

@@ -2,18 +2,73 @@
 
 # Defines software installer functions.
 
-# Installs an application via a DMG file.
+# Label: Download File
-# Parameters: $1 (required) - URL, $2 (required) - Mount path, $3 (required) - Application name.
+# Description: Download 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
+
+# Label: Install Application
+# Description: Install an application.
+# Parameters: $1 (required): Install path, $2 (required): Name.
+install_app() {
+  local install_path="$1"
+  local name="$2"
+  local install_root=""
+  local file_extension=""
+
+  install_root=$(get_install_root "$name")
+  file_extension=$(get_extension "$name")
+
+  printf "%s\n" "Installing: $install_root/$name..."
+
+  case $file_extension in
+    '')
+      cp -a "$install_path/$name" "$install_root";;
+    'app')
+      cp -a "$install_path/$name" "$install_root";;
+    'prefPane')
+      sudo cp -pR "$install_path/$name" "$install_root";;
+    'qlgenerator')
+      sudo cp -pR "$install_path/$name" "$install_root" && qlmanage -r;;
+    *)
+      printf "%s\n" "ERROR: Unknown file extension: $file_extension."
+  esac
+}
+export -f install_app
+
+# Label: Install DMG Application
+# Description: Install DMG application.
+# Parameters: $1 (required): URL, $2 (required): Mount path, $3 (required): Application name.
 install_dmg_app() {
   local url="$1"
   local mount_point="/Volumes/$2"
   local app_name="$3"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
-  local download_file="download.dmg"
+  local work_file="download.dmg"
+
+  install_path=$(get_install_path "$app_name")
 
   if [[ ! -e "$install_path" ]]; then
-    download_installer "$url" "$download_file"
+    download_file "$url" "$work_file"
-    mount_image "$MAC_OS_WORK_PATH/$download_file"
+    mount_image "$MAC_OS_WORK_PATH/$work_file"
     install_app "$mount_point" "$app_name"
     unmount_image "$mount_point"
     verify_application "$app_name"
@@ -21,123 +76,76 @@ install_dmg_app() {
 }
 export -f install_dmg_app
 
-# Installs a package via a DMG file.
+# Label: Install DMG Package
-# Parameters: $1 (required) - URL, $2 (required) - Mount path, $3 (required) - Application name.
+# Description: Install DMG application via a package file.
+# Parameters: $1 (required): URL, $2 (required): Mount path, $3 (required): Application name.
 install_dmg_pkg() {
   local url="$1"
   local mount_point="/Volumes/$2"
   local app_name="$3"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
-  local download_file="download.dmg"
+  local work_file="download.dmg"
+
+  install_path=$(get_install_path "$app_name")
 
   if [[ ! -e "$install_path" ]]; then
-    download_installer "$url" "$download_file"
+    download_file "$url" "$work_file"
-    mount_image "$MAC_OS_WORK_PATH/$download_file"
+    mount_image "$MAC_OS_WORK_PATH/$work_file"
     install_pkg "$mount_point" "$app_name"
     unmount_image "$mount_point"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
     verify_application "$app_name"
   fi
 }
 export -f install_dmg_pkg
 
-# Installs an application via a zip file.
+# Label: Install File
-# Parameters: $1 (required) - URL, $2 (required) - Application name.
+# Description: Install a single file.
-install_zip_app() {
+# Parameters: $1 (required): URL, $2 (required): Install path.
-  local url="$1"
+install_file() {
-  local app_name="$2"
+  local file_url="$1"
-  local install_path=$(get_install_path "$app_name")
+  local file_name=""
-  local download_file="download.zip"
-
-  if [[ ! -e "$install_path" ]]; then
-    download_installer "$url" "$download_file"
-
-    (
-      printf "Preparing...\n"
-      cd "$MAC_OS_WORK_PATH"
-      unzip -q "$download_file"
-      find . -type d -name "$app_name" -print -exec cp -pR {} . > /dev/null 2>&1 \;
-    )
-
-    install_app "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
-    verify_application "$app_name"
-  fi
-}
-export -f install_zip_app
-
-# 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 download_file="download.tar"
-
-  if [[ ! -e "$install_path" ]]; then
-    download_installer "$url" "$download_file"
-
-    (
-      printf "Preparing...\n"
-      cd "$MAC_OS_WORK_PATH"
-      tar "$options" "$download_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 a package via a zip file.
-# Parameters: $1 (required) - URL, $2 (required) - Application name.
-install_zip_pkg() {
-  local url="$1"
-  local app_name="$2"
-  local install_path=$(get_install_path "$app_name")
-  local download_file="download.zip"
-
-  if [[ ! -e "$install_path" ]]; then
-    download_installer "$url" "$download_file"
-
-    (
-      printf "Preparing...\n"
-      cd "$MAC_OS_WORK_PATH"
-      unzip -q "$download_file"
-    )
-
-    install_pkg "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
-    verify_application "$app_name"
-  fi
-}
-export -f install_zip_pkg
-
-# 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_file_name "$2")
   local install_path="$2"
+
+  file_name=$(get_basename "$1")
+
+  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 "%s\n" "Installed: $file_name."
+    verify_path "$install_path"
+  fi
+}
+export -f install_file
+
+# Label: Install Git Application
+# Description: Install application from a Git repository.
+# Parameters: $1 (required): URL, $2 (required): Install path, $3 (optional): Git clone options.
+install_git_app() {
+  local url="$1"
+  local install_path="$2"
+  local app_name=""
   local options="--quiet"
 
+  app_name="$(get_basename "$2")"
+
   if [[ -n "$3" ]]; then
     local options="$options $3"
   fi
 
   if [[ ! -e "$install_path" ]]; then
-    printf "Installing: $install_path/$app_name...\n"
+    printf "%s\n" "Installing: $install_path..."
-    git clone $options "$repository_url" "$install_path"
+    git clone $options "$url" "$install_path"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
     verify_path "$install_path"
   fi
 }
 export -f install_git_app
 
-# Installs settings from a Git repository.
+# Label: Install Git Project
-# Parameters: $1 (required) - Repository URL, $2 (required) - Repository version, $3 (required) - Project directory, $4 (required) - Script to run (including any arguments).
+# Description: Install Git project.
+# Parameters: $1 (required): URL, $2 (required): Version, $3 (required): Project directory, $4 (required): Script to run (including any arguments).
 install_git_project() {
   local repo_url="$1"
   local repo_version="$2"
@@ -154,95 +162,206 @@ install_git_project() {
 }
 export -f install_git_project
 
-# Downloads an installer to local disk.
+# Label: Install Homebrew
-# Parameters: $1 (required) - URL, $2 (required) - File name, $3 (required) - HTTP header.
+# Description: Install and setup Homebrew.
-download_installer() {
+install_homebrew() {
-  local url="$1"
+  if ! command -v brew > /dev/null; then
-  local file_name="$2"
+    /bin/bash -c "$(curl --location --fail --silent --show-error https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-  local http_header="$3"
+    echo "eval \"($(get_homebrew_bin_root)/brew shellenv)\"" > "$HOME/.zprofile"
-
+    eval "$($(get_homebrew_bin_root)/brew shellenv)"
-  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_installer
-
-# Downloads an installer to the $HOME/Downloads folder for manual use.
-# Parameters: $1 (required) - URL, $2 (required) - File name.
-download_only() {
-  if [[ -e "$HOME/Downloads/$2" ]]; then
-    printf "Downloaded: $2.\n"
-  else
-    printf "Downloading $1...\n"
-    download_installer "$1" "$2"
-    mv "$MAC_OS_WORK_PATH/$2" "$HOME/Downloads"
   fi
 }
-export -f download_only
+export -f install_homebrew
 
-# Installs a single file.
+# Label: Install Bare Package
-# Parameters: $1 (required) - URL, $2 (required) - Install path.
+# Description: Install a bare package.
-install_file() {
+# Parameters: $1 (required): URL, $2 (required): Application name.
-  local file_url="$1"
+install_bare_pkg() {
-  local file_name=$(get_file_name "$1")
+  local url="$1"
-  local install_path="$2"
+  local app_name="$2"
+  local install_path=""
+  local work_file="$app_name.pkg"
+
+  install_path=$(get_install_path "$app_name")
 
   if [[ ! -e "$install_path" ]]; then
-    printf "Installing: $install_path...\n"
+    download_file "$url" "$work_file"
-    download_installer "$file_url" "$file_name"
+    install_pkg "$MAC_OS_WORK_PATH" "$app_name"
-    mkdir -p $(dirname "$install_path")
+    printf "%s\n" "Installed: $app_name."
-    mv "$MAC_OS_WORK_PATH/$file_name" "$install_path"
+    verify_application "$app_name"
-    printf "Installed: $file_name.\n"
-    verify_path "$install_path"
   fi
 }
-export -f install_file
+export -f install_bare_pkg
 
-# Installs an application.
+# Label: Install Package
-# Parameters: $1 (required) - Application source path, $2 (required) - Application name.
+# Description: Install local package.
-install_app() {
+# Parameters: $1 (required): Package source path, $2 (required): Application name.
-  local install_root=$(get_install_root "$2")
-  local file_extension=$(get_file_extension "$2")
-
-  printf "Installing: $install_root/$2...\n"
-
-  case $file_extension in
-    '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")
+  local source_path="$1"
+  local name="$2"
+  local install_root=""
+  local package=""
 
-  printf "Installing: $install_root/$2...\n"
+  install_root=$(get_install_root "$name")
-  local package=$(sudo find "$1" -maxdepth 1 -type f -name "*.pkg" -o -name "*.mpkg")
+  package=$(sudo find "$source_path" -maxdepth 1 -type f -name "*.pkg" -o -name "*.mpkg")
+
+  printf "%s\n" "Installing: $install_root/$name..."
   sudo installer -pkg "$package" -target /
 }
 export -f install_pkg
 
-# Mounts a disk image.
+# Label: Install Program
-# Parameters: $1 (required) - Image path.
+# Description: Installs program without any packaging.
+# Parameters: $1 (required): URL, $2 (required): Name.
+install_program() {
+  local url="$1"
+  local program_name="$2"
+  local install_path=""
+
+  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 "%s\n" "Installed: $program_name."
+    verify_application "$program_name"
+  fi
+}
+export -f install_program
+
+# Label: Install Node
+# Description: Install and setup Node for local development.
+install_node() {
+  if [[ ! -x "$(command -v node)" ]]; then
+    "$(get_homebrew_bin_root)/fnm" install --latest
+  fi
+}
+export -f install_node
+
+# Label: Install Ruby
+# Description: Install and setup Ruby for local development.
+install_ruby() {
+  local version=""
+
+  version="$(cat $HOME/.ruby-version | tr -d '\n')"
+
+  if [[ ! -x "$(command -v ruby)" && -n $(ruby --version | grep --quiet "$version") ]]; then
+    "$(get_homebrew_bin_root)"/frum install "$version" \
+                                            --with-openssl-dir="$(brew --prefix openssl)" \
+                                            --enable-shared \
+                                            --disable-silent-rules
+    "$(get_homebrew_bin_root)"/frum local "$version"
+  fi
+}
+export -f install_ruby
+
+# Label: Install Rust
+# Description: Install and setup Rust for local development.
+install_rust() {
+  if ! command -v cargo > /dev/null; then
+    curl --proto "=https" --tlsv1.2 --fail --silent --show-error https://sh.rustup.rs | sh
+  fi
+}
+export -f install_rust
+
+# Label: Install Tar Application
+# Description: Install application from tar file.
+# Parameters: $1 (required): URL, $2 (required): Name, $3 (required): Decompress options.
+install_tar_app() {
+  local url="$1"
+  local app_name="$2"
+  local options="$3"
+  local install_path=""
+  local work_file="download.tar"
+
+  install_path=$(get_install_path "$app_name")
+
+  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 "%s\n" "Installed: $app_name."
+    verify_application "$app_name"
+  fi
+}
+export -f install_tar_app
+
+# Label: Install Zip Application
+# Description: Install application from zip file.
+# Parameters: $1 (required): URL, $2 (required): Name.
+install_zip_app() {
+  local url="$1"
+  local app_name="$2"
+  local install_path=""
+  local work_file="download.zip"
+
+  install_path=$(get_install_path "$app_name")
+
+  if [[ ! -e "$install_path" ]]; then
+    download_file "$url" "$work_file"
+
+    (
+      printf "Preparing...\n"
+      cd "$MAC_OS_WORK_PATH"
+      unzip -q "$work_file"
+      find . -type d -name "$app_name" -print -exec cp -pR {} . > /dev/null 2>&1 \;
+    )
+
+    install_app "$MAC_OS_WORK_PATH" "$app_name"
+    printf "%s\n" "Installed: $app_name."
+    verify_application "$app_name"
+  fi
+}
+export -f install_zip_app
+
+# Label: Install Zip Package
+# Description: Install application from a package within a zip file.
+# Parameters: $1 (required): URL, $2 (required): Application name.
+install_zip_pkg() {
+  local url="$1"
+  local app_name="$2"
+  local install_path=""
+  local work_file="download.zip"
+
+  install_path=$(get_install_path "$app_name")
+
+  if [[ ! -e "$install_path" ]]; then
+    download_file "$url" "$work_file"
+
+    (
+      printf "Preparing...\n"
+      cd "$MAC_OS_WORK_PATH"
+      unzip -q "$work_file"
+    )
+
+    install_pkg "$MAC_OS_WORK_PATH" "$app_name"
+    printf "%s\n" "Installed: $app_name."
+    verify_application "$app_name"
+  fi
+}
+export -f install_zip_pkg
+
+# Label: Mount Image
+# Description: Mount disk image.
+# Parameters: $1 (required): Path.
 mount_image() {
-  printf "Mounting image...\n"
+  printf "%s\n" "Mounting image..."
   hdiutil attach -quiet -nobrowse -noautoopen "$1"
 }
 export -f mount_image
 
-# Unmounts a disk image.
+# Label: Unmount Image
-# Parameters: $1 (required) - Mount path.
+# Description: Unmount disk image.
+# Parameters: $1 (required): Path.
 unmount_image() {
-  printf "Unmounting image...\n"
+  printf "%s\n" "Unmounting image..."
   hdiutil detach -force "$1"
 }
 export -f unmount_image

lib/options.sh

@@ -2,14 +2,16 @@
 
 # Defines command line prompt options.
 
-# Process option selection.
+
-# Parameters: $1 (required) - The option to process.
+# Label: Process Option
+# Description: Run script based on selection.
+# Parameters: $1 (required): The option to process.
 process_option() {
   case $1 in
     'B')
       bin/create_boot_disk;;
     'b')
-      bin/apply_basic_settings;;
+      bin/install_basics;;
     't')
       bin/install_dev_tools;;
     'hf')
@@ -23,39 +25,45 @@ process_option() {
     'x')
       bin/install_extensions;;
     'd')
-      bin/apply_default_settings;;
+      bin/install_defaults;;
     's')
-      bin/setup_software;;
+      bin/install_shell;;
+    'r')
+      bin/restore_backup;;
     'i')
       caffeinate_machine
-      bin/apply_basic_settings
+      bin/install_basics
       bin/install_dev_tools
       bin/install_homebrew_formulas
       bin/install_homebrew_casks
       bin/install_app_store
       bin/install_applications
       bin/install_extensions
-      bin/apply_default_settings
+      bin/install_defaults
-      bin/setup_software
+      bin/install_shell
+      bin/restore_backup
       clean_work_path;;
-    'R')
+    'np')
-      bin/restore_backup;;
+      bin/install_node_packages;;
+    'rg')
+      bin/install_ruby_gems;;
+    'rc')
+      bin/install_rust_crates;;
+    'l')
+      bin/install_node_packages
+      bin/install_ruby_gems
+      bin/install_rust_crates;;
    'c')
       verify_homebrew_formulas
       verify_homebrew_casks
       verify_app_store_applications
       verify_applications
-      verify_extensions;;
+      verify_extensions
+      verify_node_packages
+      verify_ruby_gems
+      verify_rust_crates;;
     'C')
       caffeinate_machine;;
-    'ua')
-      uninstall_application;;
-    'ux')
-      uninstall_extension;;
-    'ra')
-      reinstall_application;;
-    'rx')
-      reinstall_extension;;
     'w')
       clean_work_path;;
     'q');;

lib/reinstallers.sh

@@ -1,17 +0,0 @@
-#! /usr/bin/env bash
-
-# Defines reinstall functions.
-
-# Reinstall application.
-reinstall_application() {
-  uninstall_application
-  bin/install_applications
-}
-export -f reinstall_application
-
-# Reinstall extension.
-reinstall_extension() {
-  uninstall_extension
-  bin/install_extensions
-}
-export -f reinstall_extension

lib/settings.sh

@@ -1,19 +1,11 @@
 #! /usr/bin/env bash
 
-# Defines global settings.
-
-# General
 set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
 
-# Globals
+export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Sonoma.app/Contents/Resources/createinstallmedia"
-export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Mojave.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"
-
-# Java
-export JAVA_LABEL="Java SE Development Kit"
-export JAVA_DOWNLOAD_URL="https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html"

lib/uninstallers.sh

@@ -1,52 +0,0 @@
-#! /usr/bin/env bash
-
-# Defines uninstall functions.
-
-# Uninstalls selected application.
-uninstall_application() {
-  # Only use environment keys that end with "APP_NAME".
-  local keys=($(set | awk -F "=" '{print $1}' | grep ".*APP_NAME"))
-
-  printf "Select application to uninstall:\n"
-  for ((index = 0; index < ${#keys[*]}; index++)); do
-    local app_file="${!keys[$index]}"
-    printf "  $index: ${app_file}\n"
-  done
-  printf "  q: Quit/Exit\n\n"
-
-  read -p "Enter selection: " response
-  printf "\n"
-
-  local regex="^[0-9]+$"
-  if [[ $response =~ $regex ]]; then
-    local app_file="${!keys[$response]}"
-    local app_path=$(get_install_path "${app_file}")
-    sudo rm -rf "$app_path"
-    printf "Uninstalled: ${app_path}\n"
-  fi
-}
-export -f uninstall_application
-
-# Uninstalls selected extension.
-uninstall_extension() {
-  # Only use environment keys that end with "EXTENSION_PATH".
-  local keys=($(set | awk -F "=" '{print $1}' | grep ".*EXTENSION_PATH"))
-
-  printf "Select extension to uninstall:\n"
-  for ((index = 0; index < ${#keys[*]}; index++)); do
-    local extension_path="${!keys[$index]}"
-    printf "  $index: ${extension_path}\n"
-  done
-  printf "  q: Quit/Exit\n\n"
-
-  read -p "Enter selection: " response
-  printf "\n"
-
-  local regex="^[0-9]+$"
-  if [[ $response =~ $regex ]]; then
-    local extension_path="${!keys[$response]}"
-    rm -rf "${extension_path}"
-    printf "Uninstalled: ${extension_path}\n"
-  fi
-}
-export -f uninstall_extension

lib/utilities.sh

@@ -2,27 +2,11 @@
 
 # Defines general utility functions.
 
-# Answers the full install path (including file name) for file name.
+# Label: Caffeinate Machine
-# Parameters: $1 (required) - The file name.
+# Description: Keep machine running for a very long time.
-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
-
-# Caffeinate machine.
 caffeinate_machine() {
-  local pid=$(ps aux | grep caffeinate | grep -v grep | awk '{print $2}')
+  if [[ -n "$(pgrep -x caffeinate)" ]]; then
-
+    printf "Machine is already caffeinated!\n"
-  if [[ -n "$pid" ]]; then
-    printf "Whoa, tweaker, machine is already caffeinated!\n"
   else
     caffeinate -s -u -d -i -t 3153600000 > /dev/null &
     printf "Machine caffeinated.\n"
@@ -30,14 +14,80 @@ caffeinate_machine() {
 }
 export -f caffeinate_machine
 
-# Answers the root install path for file name.
+# Label: Clean Work Path
-# Parameters: $1 (required) - The file name.
+# Description: Clean work path of artifacts.
+clean_work_path() {
+  rm -rf "$MAC_OS_WORK_PATH"
+}
+export -f clean_work_path
+
+# Label: Get Basename
+# Description: Answer file or directory basename.
+# Parameters: $1 (required): Path.
+get_basename() {
+  printf "%s" "${1##*/}"
+}
+export -f get_basename
+
+# Label: Get Extension
+# Description: Answer file extension without dot prefix.
+# Parameters: $1 (required): Path.
+get_extension() {
+  local name=""
+  local extension="${1##*.}"
+
+  name=$(get_basename "$1")
+
+  if [[ "$name" == "$extension" ]]; then
+    printf ''
+  else
+    printf "%s" "$extension"
+  fi
+}
+export -f get_extension
+
+# Label: Get Homebrew Root
+# Description: Answer Homebrew root path.
+get_homebrew_root() {
+  if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
+    printf "%s" "/opt/homebrew"
+  else
+    printf "%s" "/usr/local/Homebrew"
+  fi
+}
+export -f get_homebrew_root
+
+# Label: Get Homebrew Bin Root
+# Description: Answer Homebrew binary root path.
+get_homebrew_bin_root() {
+  if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
+    printf "%s" "/opt/homebrew/bin"
+  else
+    printf "%s" "/usr/local/bin"
+  fi
+}
+export -f get_homebrew_bin_root
+
+# Label: Get Install Path
+# Description: Answer full install path (including file name).
+# Parameters: $1 (required): Path.
+get_install_path() {
+  local file_name="$1"
+  local install_path=""
+
+  install_path=$(get_install_root "$file_name")
+
+  printf "%s" "$install_path/$file_name"
+}
+export -f get_install_path
+
+# Label: Get Install Root
+# Description: Answer root install path.
+# Parameters: $1 (required): Path.
 get_install_root() {
   local file_name="$1"
-  local file_extension=$(get_file_extension "$file_name")
 
-  # Dynamically build the install path based on file extension.
+  case $(get_extension "$file_name") in
-  case $file_extension in
     '')
       printf "/usr/local/bin";;
     'app')
@@ -52,23 +102,27 @@ get_install_root() {
 }
 export -f get_install_root
 
-# Answers the file extension.
+# Label: Check Mac App Store Install
-# Parameters: $1 (required) - The file name.
+# Description: Check Mac App Store (mas) CLI has been installed.
-get_file_extension() {
+check_mas_install() {
-  local name=$(get_file_name "$1")
+  if ! command -v mas > /dev/null; then
-  local extension="${1##*.}" # Excludes dot.
+    printf "%s\n" "ERROR: Mac App Store (mas) CLI can't be found."
-
+    printf "%s\n" "       Please ensure mas (i.e. brew install mas) is installed."
-  if [[ "$name" == "$extension" ]]; then
+    exit 1
-    printf ''
-  else
-    printf "$extension"
   fi
 }
-export -f get_file_extension
+export -f check_mas_install
 
-# Answers the file name.
+# Label: Configure Environment
-# Parameters: $1 (required) - The file path.
+# Description: Configure shell and ensure PATH is properly configured.
-get_file_name() {
+configure_environment() {
-  printf "${1##*/}" # Answers file or directory name.
+  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"
+    source "$HOME/.bashrc"
+  fi
 }
-export -f get_file_name
+export -f configure_environment

lib/verifiers.sh

@@ -2,131 +2,65 @@
 
 # Defines verification/validation functions.
 
-# Checks for missing Homebrew formulas.
+# Label: Verify App Store Applications
-verify_homebrew_formulas() {
+# Description: Check for missing App Store applications.
-  printf "Checking Homebrew formulas...\n"
-
-  local applications="$(brew list)"
-
-  while read line; do
-    # Skip blank or comment lines.
-    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
-
-      # Exception: "hg" is the binary but is listed as "mercurial".
-      if [[ "$application" == "hg" ]]; then
-        application="mercurial"
-      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 cask list)"
-
-  while read line; do
-    # Skip blank or comment lines.
-    if [[ "$line" == "brew cask install"* ]]; then
-      local application=$(printf "$line" | awk '{print $4}')
-
-      # Skip: Only necessary for the purpose of licensing system preference.
-      if [[ "$application" == "witch" ]]; then
-        continue
-      fi
-
-      # Skip: Bug with Homebrew Cask as these apps never show up as installed.
-      if [[ "$application" == "skitch" || "$application" == "openemu" ]]; then
-        continue
-      fi
-
-      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"
+  local applications=""
 
-  local applications="$(mas list)"
+  printf "\n%s\n" "Checking App Store applications..."
+  applications="$(mas list)"
 
   while read line; do
-    # Skip blank or comment lines.
     if [[ "$line" == "mas install"* ]]; then
-      local application=$(printf "$line" | awk '{print $3}')
+      application=$(printf "$line" | awk '{print $3}')
       verify_listed_application "$application" "${applications[*]}"
     fi
   done < "$MAC_OS_CONFIG_PATH/bin/install_app_store"
 
-  printf "App Store check complete.\n"
+  printf "%s\n" "App Store check complete."
 }
 export -f verify_app_store_applications
 
-# Verifies listed application exists.
+# Label: Verify Application
-# Parameters: $1 (required) - The current application, $2 (required) - The application list.
+# Description: Verify application exists.
-verify_listed_application() {
+# Parameters: $1 (required): File name.
-  local application="$1"
-  local applications="$2"
-
-  if [[ "${applications[*]}" != *"$application"* ]]; then
-    printf " - Missing: $application\n"
-  fi
-}
-export -f verify_listed_application
-
-# Checks for missing applications suffixed by "APP_NAME" as defined in settings.sh.
-verify_applications() {
-  printf "\nChecking application software...\n"
-
-  # Only use environment keys that end with "APP_NAME".
-  local file_names=$(set | awk -F "=" '{print $1}' | grep ".*APP_NAME")
-
-  # For each application name, check to see if the application is installed. Otherwise, skip.
-  for name in $file_names; do
-    # Pass the key value to verfication.
-    verify_application "${!name}"
-  done
-
-  printf "Application software check complete.\n"
-}
-export -f verify_applications
-
-# Verifies application exists.
-# Parameters: $1 (required) - The file name.
 verify_application() {
   local file_name="$1"
 
-  # Display the missing install if not found.
+  if [[ ! -e "$(get_install_path "$file_name")" ]]; then
-  local install_path=$(get_install_path "$file_name")
+    printf "%s\n" " - Missing: $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.
+# Label: Verify Applications
+# Description: Check for missing applications suffixed by "APP_NAME" as defined in settings.
+verify_applications() {
+  local file_names=""
+
+  printf "\n%s\n" "Checking application software..."
+
+  # Only use environment keys that end with "APP_NAME".
+  file_names=$(set | awk -F "=" '{print $1}' | grep ".*APP_NAME")
+
+  # For each application name, check to see if the application is installed. Otherwise, skip.
+  for name in $file_names; do
+    verify_application "${!name}"
+  done
+
+  printf "%s\n" "Application software check complete."
+}
+export -f verify_applications
+
+# Label: Verify Extensions
+# Description: Check for missing extensions suffixed by "EXTENSION_PATH" as defined in settings.
 verify_extensions() {
-  printf "\nChecking application extensions...\n"
+  local extensions=""
+
+  printf "\n%s\n" "Checking application extensions..."
 
   # Only use environment keys that end with "EXTENSION_PATH".
-  local extensions=$(set | awk -F "=" '{print $1}' | grep ".*EXTENSION_PATH")
+  extensions=$(set | awk -F "=" '{print $1}' | grep ".*EXTENSION_PATH")
 
   # For each extension, check to see if the extension is installed. Otherwise, skip.
   for extension in $extensions; do
@@ -134,18 +68,135 @@ verify_extensions() {
     verify_path "${!extension}"
   done
 
-  printf "Application extension check complete.\n"
+  printf "%s\n" "Application extension check complete."
 }
 export -f verify_extensions
 
-# Verifies path exists.
+# Label: Verify Homebrew Casks
-# Parameters: $1 (required) - The path.
+# Description: Check for missing Homebrew casks.
+verify_homebrew_casks() {
+  local applications=""
+
+  printf "\nChecking Homebrew casks...\n"
+
+  applications="$(brew list --casks)"
+
+  while read line; do
+    if [[ "$line" == "brew cask install"* ]]; then
+      application=$(printf "%s" "$line" | awk '{print $4}')
+      verify_listed_application "$application" "${applications[*]}"
+    fi
+  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"
+
+  printf "%s\n" "Homebrew cask check complete."
+}
+export -f verify_homebrew_casks
+
+# Label: Verify Homebrew Formulas
+# Description: Check for missing Homebrew formulas.
+verify_homebrew_formulas() {
+  local applications=""
+
+  printf "Checking Homebrew formulas...\n"
+
+  applications="$(brew list --formulae)"
+
+  while read line; do
+    if [[ "$line" == "brew install"* ]]; then
+      application=$(printf "%s" "$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 "%s\n" "Homebrew formula check complete."
+}
+export -f verify_homebrew_formulas
+
+# Label: Verify Listed Application
+# Description: Verify listed application exists.
+# Parameters: $1 (required): Current application, $2 (required): Application list.
+verify_listed_application() {
+  local application="$1"
+  local applications="$2"
+
+  if [[ "${applications[*]}" != *"$application"* ]]; then
+    printf "%s\n" " - Missing: $application"
+  fi
+}
+export -f verify_listed_application
+
+# Label: Verify Path
+# Description: Verify path exists.
+# Parameters: $1 (required): Path.
 verify_path() {
   local path="$1"
 
-  # Display the missing path if not found.
   if [[ ! -e "$path" ]]; then
-    printf " - Missing: $path\n"
+    printf "%s\n" " - Missing: $path"
   fi
 }
 export -f verify_path
+
+# Label: Verify Node Packages
+# Description: Check for missing Node packages.
+verify_node_packages() {
+  printf "\n%s\n" "Checking Node packages..."
+
+  while read line; do
+    if [[ "$line" == "npm "* ]]; then
+      package=$(printf "$line" | awk '{print $4}')
+      packages=($(npm list --global --depth=0 | grep "$package"))
+
+      verify_listed_application "$package" "${packages[*]}"
+    fi
+  done < "$MAC_OS_CONFIG_PATH/bin/install_node_packages"
+
+  printf "%s\n" "Node packages check complete."
+}
+export -f verify_node_packages
+
+# Label: Verify Ruby Gems
+# Description: Check for missing Ruby gems.
+verify_ruby_gems() {
+  local gems=""
+
+  printf "\n%s\n" "Checking Ruby gems..."
+
+  gems="$(gem list --no-versions)"
+
+  while read line; do
+    if [[ "$line" == "gem install"* ]]; then
+      gem=$(printf "%s" "$line" | awk '{print $3}')
+      verify_listed_application "$gem" "${gems[*]}"
+    fi
+  done < "$MAC_OS_CONFIG_PATH/bin/install_ruby_gems"
+
+  printf "%s\n" "Ruby gems check complete."
+}
+export -f verify_ruby_gems
+
+# Label: Verify Rust Crates
+# Description: Check for missing Rust crates.
+verify_rust_crates() {
+  local crates=""
+
+  printf "\n%s\n" "Checking Rust crates..."
+
+  crates="$(ls -A1 $HOME/.cargo/bin)"
+
+  while read line; do
+    if [[ "$line" == "cargo install"* ]]; then
+      crate=$(printf "%s" "$line" | awk '{print $3}')
+      verify_listed_application "$crate" "${crates[*]}"
+    fi
+  done < "$MAC_OS_CONFIG_PATH/bin/install_rust_crates"
+
+  printf "%s\n" "Rust crates check complete."
+}
+export -f verify_rust_crates