cliutils 2.1.4 → 2.2.0

data/spec/messaging_spec.rb

@@ -0,0 +1,91 @@
+require_relative 'spec_helper'
+require 'cliutils/ext/logger_extensions'
+require 'cliutils/ext/string_extensions'
+require 'cliutils/messaging'
+require 'cliutils/pretty_io'
+
+describe CLIUtils::Messaging do
+  include CLIUtils::Messaging
+
+  it 'gives a set of standard message formats' do
+    out = capture_stdout { messenger.error('error') }
+    expect(out).to eq('# error'.red + "\n")
+
+    out = capture_stdout { messenger.info('info') }
+    expect(out).to eq('# info'.blue + "\n")
+
+    out = capture_stdout { messenger.section('section') }
+    expect(out).to eq('---> section'.purple + "\n")
+
+    out = capture_stdout { messenger.success('success') }
+    expect(out).to eq('# success'.green + "\n")
+
+    out = capture_stdout { messenger.warn('warn') }
+    expect(out).to eq('# warn'.yellow + "\n")
+  end
+
+  it 'wraps strings' do
+    CLIUtils::PrettyIO.wrap = true
+    CLIUtils::PrettyIO.wrap_char_limit = 35
+    long_str = 'This is a really long string that should wrap itself at ' \
+    'some point, okay?'
+    expected_str = "# This is a really long string that\n# should wrap " \
+    "itself at some point,\n# okay?"
+
+    out = capture_stdout { messenger.info(long_str) }
+    expect(out).to eq(expected_str.blue + "\n")
+
+    CLIUtils::PrettyIO.wrap = false
+    out = capture_stdout { messenger.info(long_str) }
+    expect(out).to eq("# #{ long_str }".blue + "\n")
+  end
+
+  let(:output_filepath) { '/tmp/file1.txt' }
+  it 'attaches and detaches various Logger instances' do
+    file_logger = Logger.new(output_filepath)
+    file_logger.formatter = proc do |severity, datetime, progname, msg|
+      "#{ severity }: #{ msg }\n"
+    end
+
+    out = capture_stdout do
+      messenger.attach(FILE: file_logger)
+      messenger.debug('Debug test')
+      messenger.info('Info test')
+      messenger.error('Error test')
+      messenger.detach(:FILE)
+      messenger.warn('Warn test')
+    end
+
+    File.open(output_filepath, 'r') do |f|
+      file_contents = f.read.lines.to_a[1..-1].join
+      m = "DEBUG: Debug test\nINFO: Info test\nERROR: Error test\n"
+      expect(file_contents).to eq(m)
+    end
+    FileUtils.rm(output_filepath)
+  end
+
+  it 'raises an exception when attempting to detach an unknown target' do
+    m = 'Cannot detach invalid target: bachya'
+    expect { messenger.detach(:bachya) }.to raise_error(RuntimeError, m)
+  end
+
+  it 'allows users to deliver answers to prompts' do
+    Readline.stub(:readline).and_return('Yes', '')
+    Readline.stub(:completion_proc=).and_return("\t")
+    expect(messenger.prompt('Do you like cheese?', 'No')).to eq('Yes')
+    expect(messenger.prompt('Do you like cheese?', 'No')).to eq('No')
+    expect(messenger.prompt('Do you like cheese?', '')).to eq('')
+  end
+
+  it 'warns about deprecated methods' do
+    out = capture_stdout { messenger.info_block('test') }
+    s = 'As of 2.2.0, `info_block` is deprecated and nonfunctioning.'
+    expect(out).to eq("# #{ s }".yellow + "\n")
+  end
+
+  it 'outputs a useful ASCII color chart' do
+    s = "----------------------------------------------------------------\nESC[0;Foreground;Background\n\e[0;30;40m 30;40  \e[0;30;41m 30;41  \e[0;30;42m 30;42  \e[0;30;43m 30;43  \e[0;30;44m 30;44  \e[0;30;45m 30;45  \e[0;30;46m 30;46  \e[0;30;47m 30;47  \e[0m\n\e[0;31;40m 31;40  \e[0;31;41m 31;41  \e[0;31;42m 31;42  \e[0;31;43m 31;43  \e[0;31;44m 31;44  \e[0;31;45m 31;45  \e[0;31;46m 31;46  \e[0;31;47m 31;47  \e[0m\n\e[0;32;40m 32;40  \e[0;32;41m 32;41  \e[0;32;42m 32;42  \e[0;32;43m 32;43  \e[0;32;44m 32;44  \e[0;32;45m 32;45  \e[0;32;46m 32;46  \e[0;32;47m 32;47  \e[0m\n\e[0;33;40m 33;40  \e[0;33;41m 33;41  \e[0;33;42m 33;42  \e[0;33;43m 33;43  \e[0;33;44m 33;44  \e[0;33;45m 33;45  \e[0;33;46m 33;46  \e[0;33;47m 33;47  \e[0m\n\e[0;34;40m 34;40  \e[0;34;41m 34;41  \e[0;34;42m 34;42  \e[0;34;43m 34;43  \e[0;34;44m 34;44  \e[0;34;45m 34;45  \e[0;34;46m 34;46  \e[0;34;47m 34;47  \e[0m\n\e[0;35;40m 35;40  \e[0;35;41m 35;41  \e[0;35;42m 35;42  \e[0;35;43m 35;43  \e[0;35;44m 35;44  \e[0;35;45m 35;45  \e[0;35;46m 35;46  \e[0;35;47m 35;47  \e[0m\n\e[0;36;40m 36;40  \e[0;36;41m 36;41  \e[0;36;42m 36;42  \e[0;36;43m 36;43  \e[0;36;44m 36;44  \e[0;36;45m 36;45  \e[0;36;46m 36;46  \e[0;36;47m 36;47  \e[0m\n\e[0;37;40m 37;40  \e[0;37;41m 37;41  \e[0;37;42m 37;42  \e[0;37;43m 37;43  \e[0;37;44m 37;44  \e[0;37;45m 37;45  \e[0;37;46m 37;46  \e[0;37;47m 37;47  \e[0m\n----------------------------------------------------------------\nESC[1;Foreground;Background\n\e[1;30;40m 30;40  \e[1;30;41m 30;41  \e[1;30;42m 30;42  \e[1;30;43m 30;43  \e[1;30;44m 30;44  \e[1;30;45m 30;45  \e[1;30;46m 30;46  \e[1;30;47m 30;47  \e[0m\n\e[1;31;40m 31;40  \e[1;31;41m 31;41  \e[1;31;42m 31;42  \e[1;31;43m 31;43  \e[1;31;44m 31;44  \e[1;31;45m 31;45  \e[1;31;46m 31;46  \e[1;31;47m 31;47  \e[0m\n\e[1;32;40m 32;40  \e[1;32;41m 32;41  \e[1;32;42m 32;42  \e[1;32;43m 32;43  \e[1;32;44m 32;44  \e[1;32;45m 32;45  \e[1;32;46m 32;46  \e[1;32;47m 32;47  \e[0m\n\e[1;33;40m 33;40  \e[1;33;41m 33;41  \e[1;33;42m 33;42  \e[1;33;43m 33;43  \e[1;33;44m 33;44  \e[1;33;45m 33;45  \e[1;33;46m 33;46  \e[1;33;47m 33;47  \e[0m\n\e[1;34;40m 34;40  \e[1;34;41m 34;41  \e[1;34;42m 34;42  \e[1;34;43m 34;43  \e[1;34;44m 34;44  \e[1;34;45m 34;45  \e[1;34;46m 34;46  \e[1;34;47m 34;47  \e[0m\n\e[1;35;40m 35;40  \e[1;35;41m 35;41  \e[1;35;42m 35;42  \e[1;35;43m 35;43  \e[1;35;44m 35;44  \e[1;35;45m 35;45  \e[1;35;46m 35;46  \e[1;35;47m 35;47  \e[0m\n\e[1;36;40m 36;40  \e[1;36;41m 36;41  \e[1;36;42m 36;42  \e[1;36;43m 36;43  \e[1;36;44m 36;44  \e[1;36;45m 36;45  \e[1;36;46m 36;46  \e[1;36;47m 36;47  \e[0m\n\e[1;37;40m 37;40  \e[1;37;41m 37;41  \e[1;37;42m 37;42  \e[1;37;43m 37;43  \e[1;37;44m 37;44  \e[1;37;45m 37;45  \e[1;37;46m 37;46  \e[1;37;47m 37;47  \e[0m\n----------------------------------------------------------------\nESC[4;Foreground;Background\n\e[4;30;40m 30;40  \e[4;30;41m 30;41  \e[4;30;42m 30;42  \e[4;30;43m 30;43  \e[4;30;44m 30;44  \e[4;30;45m 30;45  \e[4;30;46m 30;46  \e[4;30;47m 30;47  \e[0m\n\e[4;31;40m 31;40  \e[4;31;41m 31;41  \e[4;31;42m 31;42  \e[4;31;43m 31;43  \e[4;31;44m 31;44  \e[4;31;45m 31;45  \e[4;31;46m 31;46  \e[4;31;47m 31;47  \e[0m\n\e[4;32;40m 32;40  \e[4;32;41m 32;41  \e[4;32;42m 32;42  \e[4;32;43m 32;43  \e[4;32;44m 32;44  \e[4;32;45m 32;45  \e[4;32;46m 32;46  \e[4;32;47m 32;47  \e[0m\n\e[4;33;40m 33;40  \e[4;33;41m 33;41  \e[4;33;42m 33;42  \e[4;33;43m 33;43  \e[4;33;44m 33;44  \e[4;33;45m 33;45  \e[4;33;46m 33;46  \e[4;33;47m 33;47  \e[0m\n\e[4;34;40m 34;40  \e[4;34;41m 34;41  \e[4;34;42m 34;42  \e[4;34;43m 34;43  \e[4;34;44m 34;44  \e[4;34;45m 34;45  \e[4;34;46m 34;46  \e[4;34;47m 34;47  \e[0m\n\e[4;35;40m 35;40  \e[4;35;41m 35;41  \e[4;35;42m 35;42  \e[4;35;43m 35;43  \e[4;35;44m 35;44  \e[4;35;45m 35;45  \e[4;35;46m 35;46  \e[4;35;47m 35;47  \e[0m\n\e[4;36;40m 36;40  \e[4;36;41m 36;41  \e[4;36;42m 36;42  \e[4;36;43m 36;43  \e[4;36;44m 36;44  \e[4;36;45m 36;45  \e[4;36;46m 36;46  \e[4;36;47m 36;47  \e[0m\n\e[4;37;40m 37;40  \e[4;37;41m 37;41  \e[4;37;42m 37;42  \e[4;37;43m 37;43  \e[4;37;44m 37;44  \e[4;37;45m 37;45  \e[4;37;46m 37;46  \e[4;37;47m 37;47  \e[0m\n----------------------------------------------------------------\nESC[5;Foreground;Background\n\e[5;30;40m 30;40  \e[5;30;41m 30;41  \e[5;30;42m 30;42  \e[5;30;43m 30;43  \e[5;30;44m 30;44  \e[5;30;45m 30;45  \e[5;30;46m 30;46  \e[5;30;47m 30;47  \e[0m\n\e[5;31;40m 31;40  \e[5;31;41m 31;41  \e[5;31;42m 31;42  \e[5;31;43m 31;43  \e[5;31;44m 31;44  \e[5;31;45m 31;45  \e[5;31;46m 31;46  \e[5;31;47m 31;47  \e[0m\n\e[5;32;40m 32;40  \e[5;32;41m 32;41  \e[5;32;42m 32;42  \e[5;32;43m 32;43  \e[5;32;44m 32;44  \e[5;32;45m 32;45  \e[5;32;46m 32;46  \e[5;32;47m 32;47  \e[0m\n\e[5;33;40m 33;40  \e[5;33;41m 33;41  \e[5;33;42m 33;42  \e[5;33;43m 33;43  \e[5;33;44m 33;44  \e[5;33;45m 33;45  \e[5;33;46m 33;46  \e[5;33;47m 33;47  \e[0m\n\e[5;34;40m 34;40  \e[5;34;41m 34;41  \e[5;34;42m 34;42  \e[5;34;43m 34;43  \e[5;34;44m 34;44  \e[5;34;45m 34;45  \e[5;34;46m 34;46  \e[5;34;47m 34;47  \e[0m\n\e[5;35;40m 35;40  \e[5;35;41m 35;41  \e[5;35;42m 35;42  \e[5;35;43m 35;43  \e[5;35;44m 35;44  \e[5;35;45m 35;45  \e[5;35;46m 35;46  \e[5;35;47m 35;47  \e[0m\n\e[5;36;40m 36;40  \e[5;36;41m 36;41  \e[5;36;42m 36;42  \e[5;36;43m 36;43  \e[5;36;44m 36;44  \e[5;36;45m 36;45  \e[5;36;46m 36;46  \e[5;36;47m 36;47  \e[0m\n\e[5;37;40m 37;40  \e[5;37;41m 37;41  \e[5;37;42m 37;42  \e[5;37;43m 37;43  \e[5;37;44m 37;44  \e[5;37;45m 37;45  \e[5;37;46m 37;46  \e[5;37;47m 37;47  \e[0m\n----------------------------------------------------------------\nESC[7;Foreground;Background\n\e[7;30;40m 30;40  \e[7;30;41m 30;41  \e[7;30;42m 30;42  \e[7;30;43m 30;43  \e[7;30;44m 30;44  \e[7;30;45m 30;45  \e[7;30;46m 30;46  \e[7;30;47m 30;47  \e[0m\n\e[7;31;40m 31;40  \e[7;31;41m 31;41  \e[7;31;42m 31;42  \e[7;31;43m 31;43  \e[7;31;44m 31;44  \e[7;31;45m 31;45  \e[7;31;46m 31;46  \e[7;31;47m 31;47  \e[0m\n\e[7;32;40m 32;40  \e[7;32;41m 32;41  \e[7;32;42m 32;42  \e[7;32;43m 32;43  \e[7;32;44m 32;44  \e[7;32;45m 32;45  \e[7;32;46m 32;46  \e[7;32;47m 32;47  \e[0m\n\e[7;33;40m 33;40  \e[7;33;41m 33;41  \e[7;33;42m 33;42  \e[7;33;43m 33;43  \e[7;33;44m 33;44  \e[7;33;45m 33;45  \e[7;33;46m 33;46  \e[7;33;47m 33;47  \e[0m\n\e[7;34;40m 34;40  \e[7;34;41m 34;41  \e[7;34;42m 34;42  \e[7;34;43m 34;43  \e[7;34;44m 34;44  \e[7;34;45m 34;45  \e[7;34;46m 34;46  \e[7;34;47m 34;47  \e[0m\n\e[7;35;40m 35;40  \e[7;35;41m 35;41  \e[7;35;42m 35;42  \e[7;35;43m 35;43  \e[7;35;44m 35;44  \e[7;35;45m 35;45  \e[7;35;46m 35;46  \e[7;35;47m 35;47  \e[0m\n\e[7;36;40m 36;40  \e[7;36;41m 36;41  \e[7;36;42m 36;42  \e[7;36;43m 36;43  \e[7;36;44m 36;44  \e[7;36;45m 36;45  \e[7;36;46m 36;46  \e[7;36;47m 36;47  \e[0m\n\e[7;37;40m 37;40  \e[7;37;41m 37;41  \e[7;37;42m 37;42  \e[7;37;43m 37;43  \e[7;37;44m 37;44  \e[7;37;45m 37;45  \e[7;37;46m 37;46  \e[7;37;47m 37;47  \e[0m\n"
+    out = capture_stdout { messenger.color_chart }
+    expect(out).to eq(s)
+  end
+end

data/spec/pref_spec.rb

@@ -0,0 +1,144 @@
+require_relative 'spec_helper'
+require 'cliutils/ext/hash_extensions'
+require 'cliutils/prefs/pref'
+require 'cliutils/prefs/pref_actions/pref_action'
+require 'cliutils/prefs/pref_behaviors/pref_behavior'
+require 'cliutils/prefs/pref_validators/pref_validator'
+require File.join(File.dirname(__FILE__), '..', 'support/test_action.rb')
+require File.join(File.dirname(__FILE__), '..', 'support/test_behavior.rb')
+require File.join(File.dirname(__FILE__), '..', 'support/test_validator.rb')
+require 'yaml'
+
+describe CLIUtils::Pref do
+  let(:base_path) { File.join(File.dirname(__FILE__), '..', 'support') }
+  let(:pref_data) {
+    {
+      behaviors: [{ name: "#{ File.join(base_path, 'test_behavior.rb') }" }],
+      config_key: 'test_prompt',
+      config_section: 'app_data',
+      default: 'bachya',
+      options: ['bachya'],
+      pre: {
+        message: 'Test pre message',
+        action: "#{ File.join(base_path, 'test_action.rb') }",
+        parameters: {
+          param1: 'value1'
+        }
+      },
+      post: {
+        message: 'Test post message',
+        action: "#{ File.join(base_path, 'test_action.rb') }"
+      },
+      prereqs: [
+        { config_section: 'section' },
+        { config_value: 'value' }
+      ],
+      prompt_text: 'Test',
+      validators: ["#{ File.join(base_path, 'test_validator.rb') }"],
+    }
+  }
+
+  let(:pref_data2) {
+    {
+      behaviors: [{ name: 'test' }],
+      config_key: 'test_prompt',
+      config_section: 'app_data',
+      default: 'bachya',
+      options: ['bachya'],
+      pre: {
+        message: 'Test pre message',
+        action: 'test',
+        parameters: {
+          param1: 'value1'
+        }
+      },
+      post: {
+        message: 'Test post message',
+        action: 'test'
+      },
+      prereqs: [
+        { config_section: 'section' },
+        { config_value: 'value' }
+      ],
+      prompt_text: 'Test',
+      validators: ['test'],
+    }
+  }
+
+  let(:pref_data3) {
+    {
+      behaviors: [{ name: 'capitalize' }],
+      config_key: 'test_prompt',
+      config_section: 'app_data',
+      prompt_text: 'Test',
+      validators: ['non_nil'],
+    }
+  }
+
+  let(:pref_data4) {
+    {
+      config_key: 'test_prompt',
+      config_section: 'app_data',
+      prompt_text: 'Test',
+      validators: ['non_nilz'],
+    }
+  }
+
+  it 'instantiates via a hash' do
+    pref = CLIUtils::Pref.new(pref_data)
+    expect(pref.answer).to eq(nil)
+    expect(pref.behavior_objects[0].class).to eq(CLIUtils::TestBehavior)
+    expect(pref.behaviors).to eq([{ name: "#{ File.join(base_path, 'test_behavior.rb') }" }])
+    expect(pref.config_key).to eq(pref_data[:config_key])
+    expect(pref.config_section).to eq(pref_data[:config_section])
+    expect(pref.default).to eq(pref_data[:default])
+    expect(pref.last_error_message).to eq(nil)
+    expect(pref.options).to eq(['bachya'])
+    expect(pref.post).to eq({ message: 'Test post message', action: "#{ File.join(base_path, 'test_action.rb') }" })
+    expect(pref.pre).to eq({message: 'Test pre message', action: "#{ File.join(base_path, 'test_action.rb') }", parameters: { param1: 'value1' } })
+    expect(pref.prereqs).to eq([{ config_section: 'section' }, { config_value: 'value' }])
+    expect(pref.validator_objects[0].class).to eq(CLIUtils::TestValidator)
+    expect(pref.validators).to eq([File.join(base_path, 'test_validator.rb')])
+  end
+
+  it 'runs pre-registered assets' do
+    Readline.stub(:readline).and_return('', 'bachya', '')
+    CLIUtils::Prefs.register_action(File.join(base_path, 'test_action.rb'))
+    CLIUtils::Prefs.register_behavior(File.join(base_path, 'test_behavior.rb'))
+    CLIUtils::Prefs.register_validator(File.join(base_path, 'test_validator.rb'))
+
+    p = CLIUtils::Pref.new(pref_data2)
+    out = capture_stdout { p.deliver }
+    expect(out).to eq("\e[34m# Test pre message\e[0m\nhere\n\e[34m# Test post message\e[0m\nhere\n")
+  end
+
+  it 'runs built-in assets' do
+    Readline.stub(:readline).and_return('', 'bachya')
+    p = CLIUtils::Pref.new(pref_data3)
+    out = capture_stdout { p.deliver }
+    expect(out).to eq("\e[31m# Nil text not allowed\e[0m\n")
+  end
+
+  it 'returns an error when a validator fails' do
+    Readline.stub(:readline).and_return('', 'bachyazzz', 'bachya', '')
+    p = CLIUtils::Pref.new(pref_data)
+    out = capture_stdout { p.deliver }
+
+    m = "\e[34m# Test pre message\e[0m\nhere\n\e[31m# Invalid option chosen " \
+    "(\"bachyazzz\"); valid options are: [\"bachya\"]\e[0m\n\e[34m# Test post " \
+    "message\e[0m\nhere\n"
+    expect(out).to eq(m)
+  end
+
+  it 'raises an exception when given an unknown asset' do
+    m = "\e[33m# Skipping undefined Pref Validator: non_nilz\e[0m\n"
+    out = capture_stdout { p = CLIUtils::Pref.new(pref_data4) }
+    expect(out).to eq("\e[33m# Skipping undefined Pref Validator: non_nilz\e[0m\n")
+  end
+
+  it 'compares equality to other Pref instances' do
+    p1 = CLIUtils::Pref.new(pref_data)
+    p2 = CLIUtils::Pref.new(pref_data)
+    expect(p1).to eq(p2)
+  end
+end

data/spec/prefs_spec.rb

@@ -0,0 +1,150 @@
+require_relative 'spec_helper'
+require 'cliutils/messaging'
+require 'cliutils/prefs'
+require 'cliutils/prefs/pref'
+
+describe CLIUtils::Pref do
+  let(:base_filepath) { File.join(File.dirname(__FILE__), '..', 'support') }
+  let(:prefs_filepath) { File.join(base_filepath, 'prefstest.yaml') }
+
+  let(:hash_data) {
+    {
+      prompts: [
+        {
+          prompt_text: 'What is your name?',
+          default: 'Bob Cobb',
+          config_key: :name,
+          config_section: :personal_info
+        },
+        {
+          prompt_text: 'What is your age?',
+          default: '45',
+          config_key: :age,
+          config_section: :personal_info
+        },
+        {
+          prompt_text: 'Batman or Superman?',
+          default: 'Batman',
+          config_key: :superhero,
+          config_section: :personal_info
+        }
+      ]
+    }
+  }
+
+  let(:array_data) {
+    [
+      {
+        prompt_text: 'What is your name?',
+        default: 'Bob Cobb',
+        config_key: :name,
+        config_section: :personal_info
+      },
+      {
+        prompt_text: 'What is your age?',
+        default: '45',
+        config_key: :age,
+        config_section: :personal_info,
+        prereqs: {
+          config_key: :name,
+          config_value: 'Bob Cobb'
+        }
+      },
+      {
+        prompt_text: 'Batman or Superman?',
+        default: 'Batman',
+        config_key: :superhero,
+        config_section: :personal_info
+      }
+    ]
+  }
+
+  it 'loads prefs from a YAML file' do
+    prefs = CLIUtils::Prefs.new(prefs_filepath)
+    expect(prefs.prompts.count).to eq(4)
+    expect(prefs.prompts[2].prompt_text).to eq('Why do you prefer Superman?!')
+    expect(prefs.prompts[2].config_key).to eq('superman_answer')
+    expect(prefs.prompts[2].config_section).to eq('personal_info')
+  end
+
+  it 'raises an exception when attempting to load a nonexistant YAML file' do
+    m = 'Invalid configuration file: bachya'
+    expect { p = CLIUtils::Prefs.new('bachya') }.to raise_error(RuntimeError, m)
+  end
+
+  it 'loads prefs from a Hash' do
+    prefs = CLIUtils::Prefs.new(hash_data)
+    expect(prefs.prompts.count).to eq(3)
+    expect(prefs.prompts[1].prompt_text).to eq('What is your age?')
+    expect(prefs.prompts[1].config_key).to eq(:age)
+    expect(prefs.prompts[1].config_section).to eq(:personal_info)
+  end
+
+  it 'loads prefs from an Array' do
+    prefs = CLIUtils::Prefs.new(array_data)
+    expect(prefs.prompts.count).to eq(3)
+    expect(prefs.prompts[1].prompt_text).to eq('What is your age?')
+    expect(prefs.prompts[1].config_key).to eq(:age)
+    expect(prefs.prompts[1].config_section).to eq(:personal_info)
+  end
+
+  it 'raises an exception when given bad Prefs data' do
+    m = 'Invalid configuration data'
+    expect { p = CLIUtils::Prefs.new(:bachya) }.to raise_error(RuntimeError, m)
+  end
+
+  it 'delivers prompts for the user to answer' do
+    Readline.stub(:readline).and_return('')
+    prefs = CLIUtils::Prefs.new(prefs_filepath)
+    prefs.ask
+
+    expect(prefs.prompts[0].answer).to eq('Batman')
+    expect(prefs.prompts[1].answer).to eq('Y')
+    expect(prefs.prompts[2].answer).to eq(nil)
+    expect(prefs.prompts[3].answer).to eq(nil)
+  end
+
+  it 'uses Configurator values as part of its prompts' do
+    c = CLIUtils::Configurator.new('/tmp/file1.txt')
+    c.add_section(:personal_info)
+    c.personal_info['superhero'] = 'Superman'
+
+    Readline.stub(:readline).and_return('')
+    prefs = CLIUtils::Prefs.new(prefs_filepath, c)
+    prefs.ask
+
+    expect(prefs.prompts[0].answer).to eq('Batman')
+    expect(prefs.prompts[1].answer).to eq('Y')
+    expect(prefs.prompts[2].answer).to eq(nil)
+    expect(prefs.prompts[3].answer).to eq(nil)
+  end
+
+  it 'pre-registers and de-registers Actions' do
+    CLIUtils::Prefs.register_action(File.join(base_filepath, 'test_action.rb'))
+    expect(CLIUtils::Prefs.registered_actions.count).to eq(1)
+
+    CLIUtils::Prefs.deregister_action(:Test)
+    expect(CLIUtils::Prefs.registered_actions.count).to eq(0)
+  end
+
+  it 'pre-registers and de-registers Behaviors' do
+    CLIUtils::Prefs.register_behavior(File.join(base_filepath, 'test_behavior.rb'))
+    expect(CLIUtils::Prefs.registered_behaviors.count).to eq(1)
+
+    CLIUtils::Prefs.deregister_behavior(:Test)
+    expect(CLIUtils::Prefs.registered_behaviors.count).to eq(0)
+  end
+
+  it 'pre-registers and de-registers Validators' do
+    CLIUtils::Prefs.register_validator(File.join(base_filepath, 'test_validator.rb'))
+    expect(CLIUtils::Prefs.registered_validators.count).to eq(1)
+
+    CLIUtils::Prefs.deregister_validator(:Test)
+    expect(CLIUtils::Prefs.registered_validators.count).to eq(0)
+  end
+
+  it 'raises an exception when registering a bad Action/Behavior/Validator' do
+    m = 'Registration failed because of unknown filepath: bachya'
+    expect { CLIUtils::Prefs.register_validator('bachya') }.to raise_error(RuntimeError, m)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'coveralls'
+require 'rspec'
+# require 'simplecov'
+require 'stringio'
+
+# SimpleCov.start
+Coveralls.wear!
+
+def capture_stdout
+  old = $stdout
+  $stdout = fake = StringIO.new
+  yield
+  fake.string
+ensure
+  $stdout = old
+end

data/spec/validator/alphabetic_validator_spec.rb

@@ -0,0 +1,20 @@
+require_relative '../spec_helper'
+require 'cliutils/messaging'
+require 'cliutils/prefs/pref_validators/pref_validator'
+require 'cliutils/prefs/pref_validators/alphabetic_validator'
+
+describe CLIUtils::AlphabeticValidator do
+  it 'confirms that its input is alphabetic' do
+    v = CLIUtils::AlphabeticValidator.new
+    v.validate('bachya')
+    expect(v.is_valid).to be_true
+    expect(v.message).to eq('Response is not alphabetic: bachya')
+  end
+
+  it 'confirms that its input is not alphabetic' do
+    v = CLIUtils::AlphabeticValidator.new
+    v.validate('12345')
+    expect(v.is_valid).to_not be_true
+    expect(v.message).to eq('Response is not alphabetic: 12345')
+  end
+end

data/spec/validator/alphanumeric_validator_spec.rb

@@ -0,0 +1,20 @@
+require_relative '../spec_helper'
+require 'cliutils/messaging'
+require 'cliutils/prefs/pref_validators/pref_validator'
+require 'cliutils/prefs/pref_validators/alphanumeric_validator'
+
+describe CLIUtils::AlphanumericValidator do
+  it 'confirms that its input is alphanumeric' do
+    v = CLIUtils::AlphanumericValidator.new
+    v.validate('bachya91238 ')
+    expect(v.is_valid).to be_true
+    expect(v.message).to eq('Response is not alphanumeric: bachya91238 ')
+  end
+
+  it 'confirms that its input is not alphanumeric' do
+    v = CLIUtils::AlphanumericValidator.new
+    v.validate('!@&^')
+    expect(v.is_valid).to_not be_true
+    expect(v.message).to eq('Response is not alphanumeric: !@&^')
+  end
+end