brew 0.1.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea45343e6ee13da84a8f9417184e4d74c19b20283a50e81eaa617ce0e59658f8
-  data.tar.gz: f5fe42f93bdc3e8e716876906ebd8f60d946f0cd28c05ca4e3c925d51d9f2600
+  metadata.gz: fa063b24e37c68bf9f6c3e02c51ae63e235ca67da91973d7a744659ed421a709
+  data.tar.gz: 69fd9f901b344cac4851e5b2103cca12a6c376ea6e4c42e9c7955240ddd8db93
 SHA512:
-  metadata.gz: c00fdec60e3c4ed591620717f61c5fe101565fdcdebbede4889f5fb79b91977b716bced7a54661ba741459422a655a2312bc9aadea854e9af7894f8768b21c8e
-  data.tar.gz: cbe18fa7f52259ec2c5aeed32552ef4fdd47737f2c13e3515078e291ef28a0c89c98df4626ea24342fd0c5f9f8b53592b9cb73dee6943dde632643cc769bbde7
+  metadata.gz: 67019f2e08c0ac3ab7eaca205ca7ba429432865cc2933a242842653d0bf30d6d75977f1cf40bea97275d38080f0cc46f90278d3111f9f29a0c6d433c96f90e22
+  data.tar.gz: efc571596c50305d9f68892790b219f09db2a09c4b3df690cb9f4993fd3ced0948b6f78ed9dfd227f5cebe4e020e4e158338c0e4d51e168c202117ff0f080c26

data/.gitignore

@@ -6,3 +6,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+.byebug_history

data/.rubocop.yml

@@ -0,0 +1,139 @@
+Style/Documentation:
+  Enabled: False
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: True
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: True
+
+Lint/BinaryOperatorWithIdenticalOperands:
+  Enabled: True
+
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: True
+
+Lint/DuplicateElsifCondition:
+  Enabled: True
+
+Lint/DuplicateRescueException:
+  Enabled: True
+
+Lint/EmptyConditionalBody:
+  Enabled: True
+
+Lint/FloatComparison:
+  Enabled: True
+
+Lint/MissingSuper:
+  Enabled: True
+
+Lint/MixedRegexpCaptureTypes:
+  Enabled: True
+
+Lint/OutOfRangeRegexpRef:
+  Enabled: True
+
+Lint/RaiseException:
+  Enabled: True
+
+Lint/SelfAssignment:
+  Enabled: True
+
+Lint/StructNewOverride:
+  Enabled: True
+
+Lint/TopLevelReturnWithArgument:
+  Enabled: True
+
+Lint/UnreachableLoop:
+  Enabled: True
+
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/brew/commands/*.rb'
+    - 'lib/brew.rb'
+
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/brew/commands/*.rb'
+    - 'lib/brew.rb'
+
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/brew/commands/*.rb'
+    - 'lib/brew.rb'
+    - 'test/**/*.rb'
+
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/brew/commands/*.rb'
+    - 'lib/brew.rb'
+
+Style/AccessorGrouping:
+  Enabled: True
+
+Style/ArrayCoercion:
+  Enabled: True
+
+Style/BisectedAttrAccessor:
+  Enabled: True
+
+Style/CaseLikeIf:
+  Enabled: True
+
+Style/ExplicitBlockArgument:
+  Enabled: True
+
+Style/ExponentialNotation:
+  Enabled: True
+
+Style/GlobalStdStream:
+  Enabled: True
+
+Style/HashAsLastArrayItem:
+  Enabled: True
+
+Style/HashEachMethods:
+  Enabled: True
+
+Style/HashLikeCase:
+  Enabled: True
+
+Style/HashTransformKeys:
+  Enabled: True
+
+Style/HashTransformValues:
+  Enabled: True
+
+Style/MixinUsage:
+  Exclude:
+    - 'lib/brew.rb'
+
+Style/OptionalBooleanParameter:
+  Enabled: True
+
+Style/RedundantAssignment:
+  Enabled: True
+
+Style/RedundantFetchBlock:
+  Enabled: True
+
+Style/RedundantFileExtensionInRequire:
+  Enabled: True
+
+Style/RedundantRegexpCharacterClass:
+  Enabled: True
+
+Style/RedundantRegexpEscape:
+  Enabled: True
+
+Style/SingleArgumentDig:
+  Enabled: True
+
+Style/SlicingWithRange:
+  Enabled: True
+
+Style/StringConcatenation:
+  Enabled: True
+

data/Gemfile

@@ -1,7 +1,6 @@
-source "https://rubygems.org"
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in brew.gemspec
 gemspec
-
-gem "rake", "~> 12.0"
-gem "minitest", "~> 5.0"

data/Gemfile.lock

@@ -1,21 +1,46 @@
 PATH
   remote: .
   specs:
-    brew (0.1.0)
+    brew (0.2.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    ast (2.4.1)
+    bump (0.9.0)
+    byebug (11.1.3)
     minitest (5.14.1)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
     rake (12.3.3)
+    regexp_parser (1.7.1)
+    rexml (3.2.5)
+    rubocop (0.89.0)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.1.0, < 1.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.3.0)
+      parser (>= 2.7.1.4)
+    ruby-progressbar (1.10.1)
+    unicode-display_width (1.7.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   brew!
+  bump
+  byebug
   minitest (~> 5.0)
   rake (~> 12.0)
+  rubocop
 
 BUNDLED WITH
    2.1.4

data/LICENSE

@@ -0,0 +1,131 @@
+brew-rb 2020 Austin C. Roos
+
+Hippocratic License Version Number: 2.1.
+
+* 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.
+
+    1. Human Rights Principles.
+
+        (a) 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.
+
+        (b) 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.
+
+    2. 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.
+
+    3. 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 Ethical Source license
+(https://ethicalsource.dev) 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.

data/README.md

@@ -1,8 +1,8 @@
-# Brew
+# brew
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/brew`. To experiment with that code, run `bin/console` for an interactive prompt.
+[![Gem Version](https://badge.fury.io/rb/brew.svg)](https://badge.fury.io/rb/brew)
 
-TODO: Delete this and the text above, and describe your gem
+A _very_ simple gem to run some [homebrew](https://brew.sh/) commands from your ruby code.  If the `brew` executable is not installed, the constructor will throw an exception immediately.
 
 ## Installation
 
@@ -13,28 +13,40 @@ gem 'brew'
 ```
 
 And then execute:
+```shell
+$ bundle install
+```
+
+## Usage
 
-    $ bundle install
+Two steps!
 
-Or install it yourself as:
+1) Create a client:
+```ruby
+homebrew = Brew::HomeBrew.new
+```
+(will raise an exception if `brew` is not installed)
 
-    $ gem install brew
+2) `brew` to your heart's content!
+```ruby
+homebrew.update
 
-## Usage
+homebrew.install('rbenv')
 
-TODO: Write usage instructions here
+homebrew.upgrade('redis')
 
-## Development
+homebrew.uninstall('rbenv')
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Available commands are: `info`, `install`, `list`, `uninstall`, `update`, `upgrade`
+(will raise an exception if any of the commands fail)
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/brew. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/brew/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/acroos/brew-rb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct (mentioned below).
 
 
 ## Code of Conduct
 
-Everyone interacting in the Brew project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/brew/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the brew-rb project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/acroos/brew-rb/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,10 +1,12 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
 end
 
-task :default => :test
+task default: :test

data/bin/console

@@ -1,7 +1,8 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require "bundler/setup"
-require "brew"
+require 'bundler/setup'
+require 'brew'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +11,5 @@ require "brew"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/brew.gemspec

@@ -1,27 +1,35 @@
+# frozen_string_literal: true
+
 require_relative 'lib/brew/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "brew"
+  spec.name          = 'brew'
   spec.version       = Brew::VERSION
-  spec.authors       = ["Austin C Roos"]
-  spec.email         = ["acroos@hey.com"]
+  spec.authors       = ['Austin C Roos']
+  spec.email         = ['acroos@hey.com']
 
-  spec.summary       = %q{Run some basic brew commands from ruby}
-  spec.description   = %q{Run some basic brew commands from ruby}
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.summary       = 'Run some basic brew commands from ruby'
+  spec.description   = 'Run some basic brew commands from ruby'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
 
   # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
 
   # spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/acroos/brew-rb"
+  spec.metadata['source_code_uri'] = 'https://github.com/acroos/brew-rb'
   # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bump'
+  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rake', '~> 12.0'
+  spec.add_development_dependency 'rubocop'
 end

data/lib/brew/commands/info.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'brew/utils/string_utils'
+require 'brew/utils/system_runner'
+
+module Brew
+  module Commands
+    class Info
+      attr_reader :brew_path, :formulae, :options, :system_runner
+
+      def initialize(brew_path, *formulae, **kwargs)
+        @brew_path = brew_path
+        @formulae = formulae.join(' ')
+        @options = parse_args(kwargs)
+        @system_runner = SystemRunner.new
+      end
+
+      def execute!
+        info_command = "#{brew_path} info #{options} #{formulae}".squish
+        system_runner.print_output(info_command)
+      rescue StandardError => e
+        raise Brew::ExecutionError, e
+      end
+
+      private
+
+      BOOLEAN_OPTIONS = %i[github json installed all verbose debug].freeze
+
+      ARGUMENT_OPTIONS = %i[analytics days category].freeze
+
+      def parse_args(args)
+        option_list = []
+
+        BOOLEAN_OPTIONS.each do |option|
+          str_option = option.to_s
+          kebab_option = str_option.snake_to_kebab
+          option_list << "--#{kebab_option}" if args[option] || args[str_option] || args[kebab_option]
+        end
+
+        ARGUMENT_OPTIONS.each do |option|
+          str_option = option.to_s
+          kebab_option = str_option.snake_to_kebab
+          if (value = args[option] || args[str_option] || args[kebab_option])
+            option_list << "--#{kebab_option} #{value}"
+          end
+        end
+
+        option_list.join(' ')
+      end
+    end
+  end
+end
+
+# Usage: brew info [options] [formula]
+
+# Display brief statistics for your Homebrew installation.
+
+# If formula is provided, show summary of information about formula.
+
+#         --analytics                  List global Homebrew analytics data or, if
+#                                      specified, installation and build error
+#                                      data for formula (provided neither
+#                                      HOMEBREW_NO_ANALYTICS nor
+#                                      HOMEBREW_NO_GITHUB_API are set).
+#         --days                       How many days of analytics data to
+#                                      retrieve. The value for days must be
+#                                      30, 90 or 365. The default is 30.
+#         --category                   Which type of analytics data to retrieve.
+#                                      The value for category must be install,
+#                                      install-on-request or build-error;
+#                                      cask-install or os-version may be
+#                                      specified if formula is not. The default
+#                                      is install.
+#         --github                     Open the GitHub source page for formula
+#                                      in a browser. To view formula history
+#                                      locally: brew log -p formula
+#         --json                       Print a JSON representation of formula.
+#                                      Currently the default and only accepted
+#                                      value for version is v1. See the docs
+#                                      for examples of using the JSON output:
+#                                      https://docs.brew.sh/Querying-Brew
+#         --installed                  Print JSON of formulae that are currently
+#                                      installed.
+#         --all                        Print JSON of all available formulae.
+#     -v, --verbose                    Show more verbose analytics data for
+#                                      formula.
+#     -d, --debug                      Display any debugging information.
+#     -h, --help                       Show this message.