branch_io_cli 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c19de7b1fee926331d25dec07b8f5af3c3ddd099d7a935bdf724499da2dc0684
-  data.tar.gz: 8777a15c765285fcdc8de2db03c26bae564c7f3557d2bc1e2bdf5b593e99595e
+  metadata.gz: be0daf95d93295d62f31315a658b57fc4907530d6f4a1b6dc1fef5366a18d78e
+  data.tar.gz: 63c2469083e71c37a99ebcaeabc67eb11e76efa2ad2ddf7210c66b2daad1aced
 SHA512:
-  metadata.gz: 6ea8a70c65a8234a83f541c1c67191e26d2dd20e0e20f4bb5a6a645e667b3db37aca91c54a9071cbaef13977697f37f4cab3aa9c7845059eb201f7d0b5391be5
-  data.tar.gz: d31b0cff7755187e94f6e7ce9be04f27b83ca3fee7b52e1db95c9c2f3f365fdc8d5bfffa2881e3e2b041e949047edd25595ac629cbc38093e634654e421ecec1
+  metadata.gz: bda3669c526febfb881867e4f583340ee8d3450d2683d7d3631fca1b8719e44ed73b5d2ff9b93ca415243e92c4675e76014e5938b029bf5c2e3276b3a09ed47f
+  data.tar.gz: be88db9e6b26f92a18a9aac27d6004f82fdc9e63cc6cb06c039a1edc97cce206788531c650b9aff4fbb40f94cbd1238551e47c263b2b015b1fadbb8dde7b8121

data/README.md

@@ -124,31 +124,31 @@ See https://github.com/BranchMetrics/branch_io_cli#setup-command for more inform
 
 #### Options
 
-|Option|Description|
-|------|-----------|
-|-h, --help|Prints a list of commands or help for each command|
-|-v, --version|Prints the current version of the CLI|
-|-t, --trace|Prints a stack trace when exceptions are raised|
-|-L, --live-key key_live_xxxx|Branch live key|
-|-T, --test-key key_test_yyyy|Branch test key|
-|-D, --domains example.com,www.example.com|Comma-separated list of custom domain(s) or non-Branch domain(s)|
-|--app-link-subdomain myapp|Branch app.link subdomain, e.g. myapp for myapp.app.link|
-|-U, --uri-scheme myurischeme[://]|Custom URI scheme used in the Branch Dashboard for this app|
-|-s, --setting [BRANCH_KEY_SETTING]|Use a custom build setting for the Branch key (default: Use Info.plist)|
-|--test-configurations config1,config2|List of configurations that use the test key with a custom build setting (default: Debug configurations)|
-|--xcodeproj MyProject.xcodeproj|Path to an Xcode project to update|
-|--target MyAppTarget|Name of a target to modify in the Xcode project|
-|--podfile /path/to/Podfile|Path to the Podfile for the project|
-|--cartfile /path/to/Cartfile|Path to the Cartfile for the project|
-|--carthage-command <command>|Command to run when installing from Carthage (default: update --platform ios)|
-|--frameworks AdSupport,CoreSpotlight,SafariServices|Comma-separated list of system frameworks to add to the project|
-|--[no-]pod-repo-update|Update the local podspec repo before installing (default: yes)|
-|--[no-]validate|Validate Universal Link configuration (default: yes)|
-|--[no-]force|Update project even if Universal Link validation fails (default: no)|
-|--[no-]add-sdk|Add the Branch framework to the project (default: yes)|
-|--[no-]patch-source|Add Branch SDK calls to the AppDelegate (default: yes)|
-|--commit [message]|Commit the results to Git|
-|--[no-]check-repo-changes|Check for uncommitted changes to a git repo (default: yes)|
+|Option|Description|Env. var.|
+|------|-----------|---------|
+|-h, --help|Prints a list of commands or help for each command||
+|-v, --version|Prints the current version of the CLI||
+|-t, --trace|Prints a stack trace when exceptions are raised||
+|-L, --live-key key_live_xxxx|Branch live key|BRANCH_LIVE_KEY|
+|-T, --test-key key_test_yyyy|Branch test key|BRANCH_TEST_KEY|
+|-D, --domains example.com,www.example.com|Comma-separated list of custom domain(s) or non-Branch domain(s)|BRANCH_DOMAINS|
+|--app-link-subdomain myapp|Branch app.link subdomain, e.g. myapp for myapp.app.link|BRANCH_APP_LINK_SUBDOMAIN|
+|-U, --uri-scheme myurischeme[://]|Custom URI scheme used in the Branch Dashboard for this app|BRANCH_URI_SCHEME|
+|-s, --setting [BRANCH_KEY_SETTING]|Use a custom build setting for the Branch key (default: Use Info.plist)|BRANCH_SETTING|
+|--[no-]test-configurations [config1,config2]|List of configurations that use the test key with a user-defined setting (default: Debug configurations)|BRANCH_TEST_CONFIGURATIONS|
+|--xcodeproj MyProject.xcodeproj|Path to an Xcode project to update|BRANCH_XCODEPROJ|
+|--target MyAppTarget|Name of a target to modify in the Xcode project|BRANCH_TARGET|
+|--podfile /path/to/Podfile|Path to the Podfile for the project|BRANCH_PODFILE|
+|--cartfile /path/to/Cartfile|Path to the Cartfile for the project|BRANCH_CARTFILE|
+|--carthage-command <command>|Command to run when installing from Carthage (default: update --platform ios)|BRANCH_CARTHAGE_COMMAND|
+|--frameworks AdSupport,CoreSpotlight,SafariServices|Comma-separated list of system frameworks to add to the project|BRANCH_FRAMEWORKS|
+|--[no-]pod-repo-update|Update the local podspec repo before installing (default: yes)|BRANCH_POD_REPO_UPDATE|
+|--[no-]validate|Validate Universal Link configuration (default: yes)|BRANCH_VALIDATE|
+|--[no-]force|Update project even if Universal Link validation fails (default: no)|BRANCH_FORCE|
+|--[no-]add-sdk|Add the Branch framework to the project (default: yes)|BRANCH_ADD_SDK|
+|--[no-]patch-source|Add Branch SDK calls to the AppDelegate (default: yes)|BRANCH_PATCH_SOURCE|
+|--commit [message]|Commit the results to Git if non-blank|BRANCH_COMMIT|
+|--[no-]confirm|Confirm configuration before proceeding (default: yes)|BRANCH_CONFIRM|
 
 
 #### Examples
@@ -219,14 +219,14 @@ See https://github.com/BranchMetrics/branch_io_cli#validate-command for more inf
 
 #### Options
 
-|Option|Description|
-|------|-----------|
-|-h, --help|Prints a list of commands or help for each command|
-|-v, --version|Prints the current version of the CLI|
-|-t, --trace|Prints a stack trace when exceptions are raised|
-|-D, --domains example.com,www.example.com|Comma-separated list of domains to validate (Branch domains or non-Branch domains) (default: [])|
-|--xcodeproj MyProject.xcodeproj|Path to an Xcode project to update|
-|--target MyAppTarget|Name of a target to validate in the Xcode project|
+|Option|Description|Env. var.|
+|------|-----------|---------|
+|-h, --help|Prints a list of commands or help for each command||
+|-v, --version|Prints the current version of the CLI||
+|-t, --trace|Prints a stack trace when exceptions are raised||
+|-D, --domains example.com,www.example.com|Comma-separated list of domains to validate (Branch domains or non-Branch domains) (default: [])|BRANCH_DOMAINS|
+|--xcodeproj MyProject.xcodeproj|Path to an Xcode project to update|BRANCH_XCODEPROJ|
+|--target MyAppTarget|Name of a target to validate in the Xcode project|BRANCH_TARGET|
 
 
 
@@ -246,23 +246,23 @@ report with additional diagnostic information suitable for opening a support tic
 
 #### Options
 
-|Option|Description|
-|------|-----------|
-|-h, --help|Prints a list of commands or help for each command|
-|-v, --version|Prints the current version of the CLI|
-|-t, --trace|Prints a stack trace when exceptions are raised|
-|--workspace MyProject.xcworkspace|Path to an Xcode workspace|
-|--xcodeproj MyProject.xcodeproj|Path to an Xcode project|
-|--scheme MyProjectScheme|A scheme from the project or workspace to build|
-|--target MyProjectTarget|A target to build|
-|--configuration Debug/Release/CustomConfigName|The build configuration to use (default: Scheme-dependent)|
-|--sdk iphoneos|Passed as -sdk to xcodebuild (default: iphonesimulator)|
-|--podfile /path/to/Podfile|Path to the Podfile for the project|
-|--cartfile /path/to/Cartfile|Path to the Cartfile for the project|
-|--[no-]clean|Clean before attempting to build (default: yes)|
-|-H, --[no-]header-only|Write a report header to standard output and exit (default: no)|
-|--[no-]pod-repo-update|Update the local podspec repo before installing (default: yes)|
-|-o, --out ./report.txt|Report output path (default: ./report.txt)|
+|Option|Description|Env. var.|
+|------|-----------|---------|
+|-h, --help|Prints a list of commands or help for each command||
+|-v, --version|Prints the current version of the CLI||
+|-t, --trace|Prints a stack trace when exceptions are raised||
+|--workspace MyProject.xcworkspace|Path to an Xcode workspace|BRANCH_WORKSPACE|
+|--xcodeproj MyProject.xcodeproj|Path to an Xcode project|BRANCH_XCODEPROJ|
+|--scheme MyProjectScheme|A scheme from the project or workspace to build|BRANCH_SCHEME|
+|--target MyProjectTarget|A target to build|BRANCH_TARGET|
+|--configuration Debug/Release/CustomConfigName|The build configuration to use (default: Scheme-dependent)|BRANCH_CONFIGURATION|
+|--sdk iphoneos|Passed as -sdk to xcodebuild (default: iphonesimulator)|BRANCH_SDK|
+|--podfile /path/to/Podfile|Path to the Podfile for the project|BRANCH_PODFILE|
+|--cartfile /path/to/Cartfile|Path to the Cartfile for the project|BRANCH_CARTFILE|
+|--[no-]clean|Clean before attempting to build (default: yes)|BRANCH_CLEAN|
+|-H, --[no-]header-only|Write a report header to standard output and exit (default: no)|BRANCH_HEADER_ONLY|
+|--[no-]pod-repo-update|Update the local podspec repo before installing (default: yes)|BRANCH_POD_REPO_UPDATE|
+|-o, --out ./report.txt|Report output path (default: ./report.txt)|BRANCH_REPORT_PATH|
 
 
 
@@ -292,3 +292,11 @@ arguments. For example:
 ```Ruby
 Rake::Task["branch:validate"].invoke ".", domains: %w(example.com www.example.com)
 ```
+
+Try the following Rake tasks in this repo:
+
+```Ruby
+bundle exec rake setup
+bundle exec rake validate
+bundle exec rake report
+```

data/lib/assets/completions/completion.bash

@@ -13,7 +13,7 @@ _branch_io_complete()
 
     setup_opts="$global_opts -L --live-key -T --test-key -D --domains --app-link-subdomain -U --uri-scheme"
     setup_opts="$setup_opts --xcodeproj --target --frameworks --podfile --cartfile --carthage-command --setting -s"
-    setup_opts="$setup_opts --test-configurations --no-test-configurations --no-check-repo-changes"
+    setup_opts="$setup_opts --test-configurations --no-test-configurations --no-check-repo-changes --no-confirm"
     # Don't autocomplete the default values here, e.g. --no-force, --pod-repo-update.
     setup_opts="$setup_opts --no-add-sdk --no-validate --force --no-pod-repo-update --commit --no-patch-source"
 

data/lib/assets/completions/completion.zsh

@@ -6,7 +6,7 @@ _branch_io_complete() {
   opts="-h --help -t --trace -v --version"
   opts="$opts -L --live-key -T --test-key -D --domains --app-link-subdomain -U --uri-scheme"
   opts="$opts --xcodeproj --target --frameworks --podfile --cartfile --carthage-command --setting -s"
-  opts="$opts --test-configurations --no-test-configurations --no-check-repo-changes"
+  opts="$opts --test-configurations --no-test-configurations --no-check-repo-changes --no-confirm"
   # Don't autocomplete the default values here, e.g. --no-force, --pod-repo-update.
   opts="$opts --no-add-sdk --no-validate --force --no-pod-repo-update --commit --no-patch-source"
 

data/lib/assets/templates/command.erb

@@ -8,11 +8,11 @@ branch_io <%= @command.command_name %> [OPTIONS]
 
 <%= header "Options", 4 %>
 
-|Option|Description|
-|------|-----------|
-|-h, --help|Prints a list of commands or help for each command|
-|-v, --version|Prints the current version of the CLI|
-|-t, --trace|Prints a stack trace when exceptions are raised|
+|Option|Description|Env. var.|
+|------|-----------|---------|
+|-h, --help|Prints a list of commands or help for each command||
+|-v, --version|Prints the current version of the CLI||
+|-t, --trace|Prints a stack trace when exceptions are raised||
 <%= table_options %>
 
 <% if @command.respond_to?(:examples) && !@command.examples.blank? %>

data/lib/branch_io_cli/cli.rb

@@ -5,73 +5,83 @@ require "branch_io_cli/format"
 module BranchIOCLI
   class CLI
     include Commander::Methods
-    include Format::CommanderFormat
+    include Format::HighlineFormat
 
     def run
       program :name, "Branch.io command-line interface"
       program :version, VERSION
       program :description, render(:program_description)
 
-      command :setup do |c|
-        c.syntax = "branch_io setup [OPTIONS]"
-        c.summary = "Integrates the Branch SDK into a native app project"
-        c.description = render :setup_description
-
-        add_options_for_command :setup, c
-
-        Command::SetupCommand.examples.each_key do |text|
-          example = Command::SetupCommand.examples[text]
-          c.example text, example
-        end
-
-        c.action do |args, options|
-          options.default Configuration::SetupConfiguration.defaults
-          Command::SetupCommand.new(options).run!
-        end
+      # Automatically detect all commands from branch_io_cli/command.
+      all_commands = Dir[File.expand_path(File.join("..", "command", "*_command.rb"), __FILE__)].map do |path|
+        File.basename(path, ".rb").sub(/_command$/, "")
       end
 
-      command :validate do |c|
-        c.syntax = "branch_io validate [OPTIONS]"
-        c.summary = "Validates all Universal Link domains configured in a project"
-        c.description = render :validate_description
-
-        add_options_for_command :validate, c
-
-        c.action do |args, options|
-          options.default Configuration::ValidateConfiguration.defaults
-          valid = Command::ValidateCommand.new(options).run!
-          exit_code = valid ? 0 : 1
-          exit exit_code
+      all_commands.each do |command_name|
+        configuration_class = configuration_class command_name
+        command_class = command_class command_name
+        next unless configuration_class && command_class
+
+        command command_name do |c|
+          c.syntax = "branch_io #{c.name} [OPTIONS]"
+          c.summary = configuration_class.summary if configuration_class.respond_to?(:summary)
+
+          begin
+            c.description = render "#{c.name}_description"
+          rescue Errno::ENOENT
+          end
+
+          add_options_for_command c
+
+          if configuration_class.respond_to?(:examples) && configuration_class.examples
+            configuration_class.examples.each_key do |text|
+              example = configuration_class.examples[text]
+              c.example text, example
+            end
+          end
+
+          c.action do |args, options|
+            options.default configuration_class.defaults
+            return_value = command_class.new(options).run!
+            exit(return_value.respond_to?(:to_i) ? return_value.to_i : 0)
+          end
         end
       end
 
-      command :report do |c|
-        c.syntax = "branch_io report [OPTIONS]"
-        c.summary = "Generate and optionally submit a build diagnostic report."
-        c.description = render :report_description
+      run!
+    end
 
-        add_options_for_command :report, c
+    def configuration_class(name)
+      class_for_command name, :configuration
+    end
 
-        c.action do |args, options|
-          options.default Configuration::ReportConfiguration.defaults
-          Command::ReportCommand.new(options).run!
-        end
-      end
+    def command_class(name)
+      class_for_command name, :command
+    end
 
-      run!
+    def class_for_command(name, type)
+      type_name = type.to_s.capitalize
+      type_module = Object.const_get("BranchIOCLI").const_get(type_name)
+      candidate = type_module.const_get("#{name.to_s.capitalize}#{type_name}")
+      return nil unless candidate
+
+      base = type_module.const_get(type_name)
+      return nil unless candidate.superclass == base
+      candidate
     end
 
-    def add_options_for_command(name, c)
-      configuration_class = Object.const_get("BranchIOCLI")
-                                  .const_get("Configuration")
-                                  .const_get("#{name.to_s.capitalize}Configuration")
+    def add_options_for_command(c)
+      configuration_class = configuration_class(c.name)
+      return unless configuration_class.respond_to?(:available_options)
+
       available_options = configuration_class.available_options
       available_options.each do |option|
         args = option.aliases
         declaration = "--"
         declaration += "[no-]" if option.negatable
-        declaration += "#{option.name.to_s.gsub(/_/, '-')} "
+        declaration += option.name.to_s.gsub(/_/, '-')
         if option.example
+          declaration += " "
           declaration += "[" if option.argument_optional
           declaration += option.example
           declaration += "]" if option.argument_optional
@@ -87,6 +97,7 @@ module BranchIOCLI
 
         default_string = default_value ? " (default: #{default_value})" : nil
         args << "#{option.description}#{default_string}"
+
         c.option(*args)
       end
     end

data/lib/branch_io_cli/command/report_command.rb

@@ -19,7 +19,7 @@ module BranchIOCLI
 
         if config.header_only
           say report_helper.report_header
-          return
+          return 0
         end
 
         if config.report_path == "stdout"
@@ -28,6 +28,8 @@ module BranchIOCLI
           File.open(config.report_path, "w") { |f| write_report f }
           say "Report generated in #{config.report_path}"
         end
+
+        0
       end
 
       def write_report(report)

data/lib/branch_io_cli/command/setup_command.rb

@@ -1,8 +1,10 @@
-require "branch_io_cli/helper/methods"
+require "branch_io_cli/helper"
 
 module BranchIOCLI
   module Command
     class SetupCommand < Command
+      include Helper::Methods
+
       def initialize(options)
         super
         @keys = config.keys
@@ -18,12 +20,12 @@ module BranchIOCLI
 
         is_app_target = !config.target.extension_target_type?
 
-        if is_app_target && options.validate &&
+        if is_app_target && config.validate &&
            !helper.validate_team_and_bundle_ids_from_aasa_files(@domains)
           say "Universal Link configuration failed validation."
           helper.errors.each { |error| say " #{error}" }
-          return unless options.force
-        elsif is_app_target && options.validate
+          return 1 unless config.force
+        elsif is_app_target && config.validate
           say "Universal Link configuration passed validation. ✅"
         end
 
@@ -44,39 +46,41 @@ module BranchIOCLI
         helper.ensure_uri_scheme_in_info_plist if is_app_target # does nothing if already present
 
         new_path = helper.add_universal_links_to_project @domains, false if is_app_target
-        sh ["git", "add", new_path] if options.commit && new_path
+        sh ["git", "add", new_path] if config.commit && new_path
 
-        config_helper.target.add_system_frameworks options.frameworks unless options.frameworks.nil? || options.frameworks.empty?
+        config_helper.target.add_system_frameworks config.frameworks unless config.frameworks.nil? || config.frameworks.empty?
 
         xcodeproj.save
 
         case config.sdk_integration_mode
         when :cocoapods
           if File.exist? config.podfile_path
-            helper.update_podfile options
+            helper.update_podfile config
           else
-            helper.add_cocoapods options
+            helper.add_cocoapods config
           end
         when :carthage
           if File.exist? config.cartfile_path
-            helper.update_cartfile options, xcodeproj
+            helper.update_cartfile config, xcodeproj
           else
-            helper.add_carthage options
+            helper.add_carthage config
           end
         when :direct
-          helper.add_direct options
+          helper.add_direct config
         end
 
-        patch_helper.patch_source xcodeproj if options.patch_source
+        patch_helper.patch_source xcodeproj if config.patch_source
 
-        return unless options.commit
+        return 0 unless config.commit
 
         changes = helper.changes.to_a.map { |c| Pathname.new(File.expand_path(c)).relative_path_from(Pathname.pwd).to_s }
 
-        commit_message = options.commit if options.commit.kind_of?(String)
+        commit_message = config.commit if config.commit.kind_of?(String)
         commit_message ||= "[branch_io_cli] Branch SDK integration #{config.relative_path(config.xcodeproj_path)} (#{config.target.name})"
 
         sh ["git", "commit", "-qm", commit_message, *changes]
+
+        0
       end
       # rubocop: enable Metrics/PerceivedComplexity
 
@@ -84,7 +88,7 @@ module BranchIOCLI
         # If the git command is not installed, there's not much we can do.
         # Don't want to use verify_git here, which will insist on installing
         # the command. The logic of that method could change.
-        return if `which git`.empty? || !config.check_repo_changes
+        return if `which git`.empty? || !config.confirm
 
         unless Dir.exist? ".git"
           `git rev-parse --git-dir > /dev/null 2>&1`

data/lib/branch_io_cli/command/validate_command.rb

@@ -4,8 +4,8 @@ module BranchIOCLI
       def run!
         valid = true
 
-        unless options.domains.nil? || options.domains.empty?
-          domains_valid = helper.validate_project_domains(options.domains)
+        unless config.domains.nil? || config.domains.empty?
+          domains_valid = helper.validate_project_domains(config.domains)
 
           if domains_valid
             say "Project domains match :domains parameter: ✅"
@@ -27,7 +27,7 @@ module BranchIOCLI
 
         say "Universal Link configuration passed validation. ✅" if valid
 
-        valid
+        valid ? 0 : 1
       end
     end
   end

data/lib/branch_io_cli/configuration/configuration.rb

@@ -4,6 +4,7 @@ require "xcodeproj"
 
 module BranchIOCLI
   module Configuration
+    # rubocop: disable Metrics/ClassLength
     class Configuration
       class << self
         attr_accessor :current
@@ -14,10 +15,39 @@ module BranchIOCLI
 
         def defaults
           available_options.inject({}) do |defs, o|
-            next defs if o.default_value.nil?
-            defs.merge(o.name => o.default_value)
+            default_value = o.env_value
+            default_value = o.default_value if default_value.nil?
+
+            next defs if default_value.nil?
+
+            defs.merge(o.name => default_value)
           end
         end
+
+        def absolute_path(path)
+          return path unless current
+          current.absolute_path path
+        end
+
+        def relative_path(path)
+          return path unless current
+          current.relative_path path
+        end
+
+        def open_podfile(path)
+          return false unless current
+          current.open_podfile absolute_path path
+        end
+
+        def open_xcodeproj(path)
+          return false unless current
+          current.open_xcodeproj absolute_path path
+        end
+
+        def root
+          return nil unless current
+          current.root
+        end
       end
 
       attr_reader :options
@@ -34,10 +64,12 @@ module BranchIOCLI
 
       def initialize(options)
         @options = options
-        @pod_repo_update = options.pod_repo_update if options.respond_to?(:pod_repo_update)
+        @pod_repo_update = options.pod_repo_update if self.class.available_options.map(&:name).include?(:pod_repo_update)
+
         Configuration.current = self
 
-        print_identification self.class.name.sub(/^.*::(.*?)Configuration$/, '\1').downcase
+        say "\n"
+        print_identification
         validate_options
         log
       end
@@ -54,10 +86,9 @@ EOF
         # subclass implementation follows
       end
 
-      def print_identification(command)
+      def print_identification
         say <<EOF
-
-<%= color("branch_io #{command} v. #{VERSION}", BOLD) %>
+<%= color("branch_io #{self.class.name.sub(/^.*::(.*?)Configuration$/, '\1').downcase} v. #{VERSION}", BOLD) %>
 
 EOF
       end
@@ -66,21 +97,36 @@ EOF
         Helper::BranchHelper
       end
 
+      def target_name
+        target.name.nil? ? nil : target.name
+      end
+
+      def root
+        return @root if @root
+        if workspace
+          @root = Pathname.new(workspace_path).dirname
+        else
+          @root = Pathname.new(xcodeproj_path).dirname
+        end
+        @root
+      end
+
+      def absolute_path(path)
+        return nil if path.nil?
+
+        path = Pathname.new(path) unless path.kind_of? Pathname
+        return path.to_s if path.absolute?
+
+        (root + path).to_s
+      end
+
       def relative_path(path)
         return nil if path.nil?
 
         path = Pathname.new(path) unless path.kind_of? Pathname
         return path.to_s unless path.absolute?
 
-        unless @root
-          if workspace
-            @root = Pathname.new(workspace_path).dirname
-          else
-            @root = Pathname.new(xcodeproj_path).dirname
-          end
-        end
-
-        path.relative_path_from(@root).to_s
+        path.relative_path_from(root).to_s
       end
 
       # 1. Look for options.xcodeproj.
@@ -167,12 +213,21 @@ EOF
         @sdk_integration_mode = filename == "Podfile" ? :cocoapods : :carthage
       end
 
-      def open_podfile(path = @podfile_path)
+      def open_podfile(path = podfile_path)
         @podfile = Pod::Podfile.from_file path
         @podfile_path = path
         @sdk_integration_mode = :cocoapods
         true
-      rescue RuntimeError => e
+      rescue Pod::PlainInformative => e
+        say e.message
+        false
+      end
+
+      def open_xcodeproj(path = xcodeproj_path)
+        @xcodeproj = Xcodeproj::Project.open path
+        @xcodeproj_path = path
+        true
+      rescue Xcodeproj::PlainInformative => e
         say e.message
         false
       end
@@ -285,7 +340,7 @@ EOF
         return @bridging_header_path if @bridging_header_path
 
         return nil unless target
-        path = helper.expanded_build_setting target, "SWIFT_OBJC_BRIDGING_HEADER", configuration
+        path = target.expanded_build_setting "SWIFT_OBJC_BRIDGING_HEADER", configuration
         return nil unless path
 
         @bridging_header_path = File.expand_path path, File.dirname(xcodeproj_path)
@@ -328,14 +383,96 @@ EOF
         all_options = self.class.available_options.map(&:name)
         return super unless all_options.include?(method_sym)
 
+        # Define an attr_reader for this method
         self.class.send :define_method, method_sym do
-          ivar = "@#{method_sym}"
-          value = instance_variable_get ivar
-          value
+          instance_variable_get "@#{method_sym}"
         end
 
         send method_sym
       end
+
+      # Prompt the user to confirm the configuration or edit.
+      def confirm_with_user
+        confirmed = Helper::Util.confirm "Is this OK? ", true
+        return if confirmed
+
+        loop do
+          Helper::Util.clear
+
+          print_identification
+
+          say "<%= color('The following options may be adjusted before continuing.', BOLD) %>"
+          choice = choose do |menu|
+            self.class.available_options.reject(&:skip_confirmation).each do |option|
+              value = send option.confirm_symbol
+              menu.choice "#{option.label}: #{option.display_value(value)}"
+            end
+
+            menu.choice "Accept and continue"
+            menu.choice "Quit"
+            menu.readline = true
+            menu.prompt = "What would you like to do?"
+          end
+
+          Helper::Util.clear
+
+          print_identification
+
+          if (option = self.class.available_options.find { |o| choice =~ /^#{Regexp.quote(o.label)}/ })
+            loop do
+              break if prompt_for_option(option)
+              say "Invalid value for option.\n\n"
+            end
+          elsif choice =~ /^Accept/
+            log
+            return
+          else
+            exit(0)
+          end
+        end
+      end
+
+      def prompt_for_option(option)
+        say "<%= color('#{option.label}', BOLD) %>\n\n"
+        say "#{option.description}\n\n"
+        value = send option.confirm_symbol
+        say "<%= color('Type', BOLD) %>: #{option.ui_type}\n"
+        say "<%= color('Current value', BOLD) %>: #{option.display_value(value)}"
+        say "<%= color('Example', BOLD) %>: #{option.example}" if option.example
+        say "\n"
+
+        valid_values = option.valid_values
+
+        if valid_values && !option.type.nil? && option.type != Array
+          new_value = choose(*valid_values) do |menu|
+            menu.readline = true
+            menu.prompt = "Please choose from this list. "
+          end
+
+          # Valid because chosen from list
+        elsif valid_values && option.type == Array
+          # There seems to be a problem with using menu.gather, so we do this.
+          valid_values.each do |v|
+            say "#{v}\n"
+          end
+
+          new_value = ask "Please enter one or more of the above, separated by commas: " do |q|
+            q.readline = true
+            q.completion = valid_values
+          end.split(",") # comma-split with Array not working
+        elsif option.type.nil?
+          new_value = Helper::Util.confirm "#{option.label}? ", value
+        else
+          new_value = ask "Please enter a new value for #{option.label}: ", option.type
+        end
+
+        new_value = option.convert new_value
+
+        return false unless option.valid?(new_value)
+        instance_variable_set "@#{option.confirm_symbol}", new_value
+        true
+      end
     end
+    # rubocop: enable Metrics/ClassLength
   end
 end