tcravit_ruby_lib 0.0.8 → 0.2.7

data/spec/app_banner_spec.rb

@@ -0,0 +1,115 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : app_banner_spec.rb
+# Specs for   : TcravitRubyLib::AppBanner
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'spec_helper'
+
+RSpec.describe "TcravitRubyLib::AppBanner" do
+
+  context "the basics" do
+    it "to format the app banner correctly" do
+      ab = TcravitRubyLib::Banner(name: "MyApp")
+      lines = ab.split("\n")
+      expect(lines[0]).to be == ("*" * 76)
+      expect(lines[2]).to be == ("*" * 76)
+    end
+  end 
+
+  context "app banner components" do
+    it "to allow you to make a banner with just a name" do
+      ab = TcravitRubyLib::Banner(name: "MyApp")
+      lines = ab.split("\n")
+      expect(lines[1]).to match(/^\*\s+MyApp/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 76
+    end
+
+    it "to allow you to make a banner with a name and description" do
+      ab = TcravitRubyLib::Banner(name: "MyApp", description: "Do some super cool stuff")
+      lines = ab.split("\n")
+      expect(lines[1]).to match(/^\*\s+MyApp: Do some super cool stuff/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 76
+    end
+
+    it "to allow you to make a banner with a name and date" do
+      ab = TcravitRubyLib::Banner(name: "MyApp", date: "2018-01-01")
+      lines = ab.split("\n")
+      expect(lines[1]).to match(/^\*\s+MyApp/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 76
+      expect(lines[2]).to match(/^\*\s+2018-01-01\s+\*$/)
+      expect(lines[2].length).to be == 76
+    end
+
+    it "to allow you to make a banner with a name, date, description" do
+      ab = TcravitRubyLib::Banner(name: "MyApp", description: "Do some super cool stuff", date: "2018-01-01")
+      lines = ab.split("\n")
+      expect(lines[1]).to match(/^\*\s+MyApp: Do some super cool stuff/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 76
+      expect(lines[2]).to match(/^\*\s+2018-01-01\s+\*$/)
+      expect(lines[2].length).to be == 76
+    end
+
+    it "to allow you to make a banner with a name, date, description, version" do
+      ab = TcravitRubyLib::Banner(name: "MyApp", description: "Do some super cool stuff", date: "2018-01-01", version: "1.0.1")
+      lines = ab.split("\n")
+      expect(lines[1]).to match(/^\*\s+MyApp: Do some super cool stuff/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 76
+      expect(lines[2]).to match(/^\*\s+Version 1.0.1, 2018-01-01\s+\*$/)
+      expect(lines[2].length).to be == 76
+    end
+
+    it "to allow you to make a banner with a name, date, description, version, author" do
+      ab = TcravitRubyLib::Banner(name: "MyApp", description: "Do some super cool stuff", date: "2018-01-01", version: "1.0.1", author: "John Doe")
+      lines = ab.split("\n")
+      expect(lines[1]).to match(/^\*\s+MyApp: Do some super cool stuff/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 76
+      expect(lines[2]).to match(/^\*\s+Version 1.0.1, 2018-01-01, John Doe\s+\*$/)
+      expect(lines[2].length).to be == 76
+    end
+  end
+
+  context "error handling" do
+    it "to raise an error if the name is not provided" do
+      expect {TcravitRubyLib::Banner(description: "Foo")}.to raise_error(ArgumentError)
+    end
+
+    it "to raise an error if the description is too long" do
+      expect {TcravitRubyLib::Banner(description: ("*" * 133), line_length: 76)}.to raise_error(ArgumentError)
+      expect {TcravitRubyLib::Banner(description: ("*" * 128), line_length: 133)}.to raise_error(ArgumentError)
+    end
+  end
+
+  context "formatting" do
+    it "to allow you to change the output line length" do
+      ab = TcravitRubyLib::Banner(name: "MyApp", description: "Do some super cool stuff", line_length: 133)
+      lines = ab.split("\n")
+      expect(lines[0]).to be == ("*" * 133)
+      expect(lines[1]).to match(/^\*\s+MyApp: Do some super cool stuff/)
+      expect(lines[1]).to match(/\s+\*$/)
+      expect(lines[1].length).to be == 133
+      expect(lines[2]).to be == ("*" * 133)
+    end
+  end
+end

data/spec/app_config_spec.rb

@@ -0,0 +1,70 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : app_config_spec.rb
+# Specs for   : TcravitRubyLib::AppConfig
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'spec_helper'
+require 'fileutils'
+
+RSpec.describe "TcravitRubyLib::AppConfig" do
+    
+  STRING_VAL = "string"
+  NUMERIC_VAL = 18293
+  SYMBOLIC_VAL = :squid
+  
+  before(:all) do
+    TcravitRubyLib::AppConfig.configure do
+      string_value STRING_VAL
+      numeric_value NUMERIC_VAL
+      symbol_value SYMBOLIC_VAL
+    end
+  end
+  
+  it "should return the values for defined properties" do
+    expect(TcravitRubyLib::AppConfig.string_value).to be == STRING_VAL
+    expect(TcravitRubyLib::AppConfig.numeric_value).to be == NUMERIC_VAL
+    expect(TcravitRubyLib::AppConfig.symbol_value).to be == SYMBOLIC_VAL      
+  end
+  
+  it "should raise an error for undefined properties" do
+    expect { TcravitRubyLib::AppConfig.fishpaste_value }.to raise_error
+  end
+  
+  it "should allow me to change a configuration property" do
+    TcravitRubyLib::AppConfig.string_value = "new value"
+    expect(TcravitRubyLib::AppConfig.string_value).to be == "new value"
+  end
+  
+  it "should allow me to remove a configuration property" do
+    TcravitRubyLib::AppConfig.remove!(:string_value)
+    expect { TcravitRubyLib::AppConfig.string_value }.to raise_error
+  end
+  
+  it "should allow additional properties to be added" do
+    TcravitRubyLib::AppConfig.configure do
+      another_value 192
+    end
+    TcravitRubyLib::AppConfig.configure do
+      and_another_value 384
+    end
+    expect(TcravitRubyLib::AppConfig.another_value).to be == 192
+    expect(TcravitRubyLib::AppConfig.and_another_value).to be == 384
+  end
+  
+end

data/spec/config_searcher_spec.rb

@@ -0,0 +1,71 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : config_searcher_spec.rb
+# Specs for   : TcravitRubyLib::ConfigSearcher
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'spec_helper'
+require 'fileutils'
+
+RSpec.describe "TcravitRubyLib::ConfigSearcher" do
+
+  BASE_DIR   = '/tmp/config_searcher_test'
+  DEEP_DIR   = "#{BASE_DIR}/foo/bar/baz"
+  CONFIG_DIR = "#{BASE_DIR}/.config"
+
+  before(:all) do
+    FileUtils.mkdir_p DEEP_DIR
+    FileUtils.mkdir_p CONFIG_DIR
+  end
+
+  after(:all) do
+    FileUtils.remove_dir BASE_DIR, true
+  end
+
+  context "the basics" do
+    it "should successfully find a directory which exists" do
+      dir_path = TcravitRubyLib::ConfigSearcher.locate_config_dir(start_in: DEEP_DIR, look_for: ".config")
+      expect(dir_path.to_s).to_not be_nil
+      expect(dir_path.to_s).to be == CONFIG_DIR
+    end
+
+    it "should not find a directory when one doesn't exist" do
+      dir_path = TcravitRubyLib::ConfigSearcher.locate_config_dir(start_in: DEEP_DIR, look_for: ".snausages")
+      expect(dir_path.to_s).to be == ""    
+    end
+
+    it "should return the container dir when the only_container_dir option is provided" do
+      dir_path = TcravitRubyLib::ConfigSearcher.locate_config_dir(start_in: DEEP_DIR, look_for: ".config", only_container_dir: true)
+      expect(dir_path.to_s).to be == BASE_DIR
+    end
+  end
+
+  context "error handling" do
+    it "should raise an exception when the start_in directory doesn't exist" do
+      expect { TcravitRubyLib::ConfigSearcher.locate_config_dir(start_in: "#{DEEP_DIR}xxxxxxx", look_for: ".snausages") }.to raise_error
+    end
+  end
+
+  context "alternative option names" do
+    it "should behave the same for the alternative option names" do
+      dir_path = TcravitRubyLib::ConfigSearcher.locate_config_dir(start_dir: DEEP_DIR, config_dir: ".config")
+      expect(dir_path.to_s).to_not be_nil
+      expect(dir_path.to_s).to be == CONFIG_DIR
+    end
+  end  
+end

data/spec/configurable_spec.rb

@@ -0,0 +1,58 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : configurable_spec.rb
+# Specs for   : TcravitRubyLib::Configurable
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'spec_helper'
+
+class ConfigurableTest
+  include TcravitRubyLib::Configurable.with(:attr_a, :attr_b, :attr_c)
+end
+
+RSpec.describe "TCravitRubyLib::Configurable" do
+  it "should respond to the config method and provide its configuration" do
+    expect(ConfigurableTest).to respond_to(:config)
+  end
+
+  it "should respond to the Configure method and provide a space for configuration" do
+    expect(ConfigurableTest).to respond_to(:configure)
+  end
+
+  it "should respond to attributes for the configuration accessors" do
+    ["attr_a", "attr_b", "attr_c"].each do |a|
+      expect(ConfigurableTest.config).to respond_to(a.to_sym)
+      expect(ConfigurableTest.config).to respond_to("#{a}=".to_sym)
+    end
+    ["nonexistent_attr"].each do |a|
+      expect(ConfigurableTest.config).not_to respond_to(a.to_sym)
+      expect(ConfigurableTest.config).not_to respond_to("#{a}=".to_sym)
+    end
+  end
+
+  it "should allow configuration" do
+    ConfigurableTest.configure do
+      attr_a 42
+      attr_b "Squid"
+      attr_c :FishPaste
+    end
+    expect(ConfigurableTest.config.attr_a).to be == 42
+    expect(ConfigurableTest.config.attr_b).to be == "Squid"
+    expect(ConfigurableTest.config.attr_c).to be == :FishPaste
+  end
+end

data/spec/global_spec.rb

@@ -0,0 +1,38 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : global_spec.rb
+# Specs for   : Global aspects of the tcravit_ruby_lib library (version
+#               number etc.)
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'spec_helper'
+
+RSpec.describe "TcravitRubyLib" do
+  it "should define a VERSION constant" do
+    expect(TcravitRubyLib::VERSION).to_not be_nil
+    expect(TcravitRubyLib::VERSION).to match(/\d+\.\d+\.\d+/)
+  end
+
+  it "should define a VERSION_DATA array" do
+    expect(TcravitRubyLib::VERSION_DATA).not_to be_nil
+    expect(TcravitRubyLib::VERSION_DATA.length).to be == 3
+    TcravitRubyLib::VERSION_DATA.each do |i|
+      expect(i).to be_a_kind_of(Numeric)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,7 +1,42 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : spec_helper.rb
+# Decription  : RSpec configuration and global helper functions for testing
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
 require 'rspec'
 require 'tcravit_ruby_lib'
 
+# A quick-and-dirty method to load RSpec helper files in spec/support
+def require_helper_named(helper_name)
+  require "#{File.join(File.dirname(__FILE__), "support", "#{helper_name}.rb")}"
+end
+
+# A quick-and-dirty method to load RSpec matchers in spec/support/matchers
+def require_custom_matcher_named(matcher_name)
+  require "#{File.join(File.dirname(__FILE__), "support", "matchers", "#{matcher_name}_matcher.rb")}"
+end
+
 RSpec.configure do |config|
-  config.color_enabled = true
+#  config.formatter     = 'progress'
   config.formatter     = 'documentation'
-end
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+    c.on_potential_false_positives = :nothing
+  end
+end

data/spec/support/matchers/be_a_rake_task_named_matcher.rb

@@ -0,0 +1,49 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : be_a_rake_task_named_matcher.rb
+# Description : RSpec custom matcher to ensure the subject is a Rake task
+#
+# This matcher tests the following aspects of the supplied subject:
+#
+# - it is of type Rake::Taskj
+# - it responds to the :name method
+# - its name matches the expected  value
+#
+# If the matcher fails, it returns a list of which test conditions were not
+# successful.
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'rspec/expectations'
+require File.join(File.dirname(__FILE__), "matcher_helpers.rb")
+
+RSpec::Matchers.define :be_a_rake_task_named do |expected|
+  match do |actual|
+    @errors = []
+    @errors.push("expected a Rake task, but got a \"#{actual.class.name}\" instead") unless (actual.class.name == "Rake::Task")
+    begin
+      @errors.push("expected the task to be named \"#{expected}\", but got name \"#{actual.name}\" instead") unless (actual.name == expected)
+    rescue
+      @errors.push("expected the task to respond to \"name\"")
+    end
+    @errors.empty?
+  end
+
+  failure_message do |actual|
+    @errors.join("\n")
+  end
+end

data/spec/support/matchers/be_a_valid_gem_version_file_for_matcher.rb

@@ -0,0 +1,57 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : be_a_valid_gem_version_file_for_matcher.rb
+# Description : RSpec custom matcher for Gem version files.
+#
+# This matcher validates the format of a Gem version.rb file. It checks the
+# following:
+#
+# - The specified file exists
+# - The specified file matches the format:
+#
+#     module GemName
+#       VERSION_DATA = [x, y, z]
+#       VERSION = VERSION_DATA.join(".")
+#     end
+#
+# If the matcher fails, a list of the failing conditions is returned.
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'rspec/expectations'
+require File.join(File.dirname(__FILE__), "matcher_helpers.rb")
+
+RSpec::Matchers.define :be_a_valid_gem_version_file_for do |module_name|
+  match do |actual|
+    @errors  = []
+    if File.exist?(actual) then
+      contents = TcravitRubyLib::MatchHelpers.read_output_file(actual) 
+      @errors.push("expected the file to start with a module declaration") unless contents[0].match(/^\s*module/)
+      @errors.push("expected the file to declare a module named \"#{module_name}\"") unless contents[0].match(/^\s*module #{module_name}/)
+      @errors.push("expected the file to declare VERSION_DATA") unless contents[1].match(/^\s*VERSION_DATA =/)
+      @errors.push("expected VERSION_DATA to be a [major,minor,build] array") unless contents[1].match(/^\s+VERSION_DATA = \[\d+, \d+, \d+\]\s*$/)
+      @errors.push("expected the file to end with an \"end\" line") unless contents[3]  == "end"
+    else
+      @errors.push("expected the file #{actual} to exist")
+    end
+    @errors.empty?
+  end
+
+  failure_message do |actual|
+    @errors.join("\n")
+  end
+end

data/spec/support/matchers/declare_the_gem_version_to_be_matcher.rb

@@ -0,0 +1,54 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : declare_the_gem_version_to_be_matcher.rb
+# Description : RSpec custom matcher to check the version declared in a
+#               Rubygem version.rb file.
+#
+# This matcher assumes the file format conforms to the format described in
+# be_a_valid_gem_version_file_for_matcher.rb and checks that it declares
+# itself to be of the specified version. If you want to skip checking any
+# component of the version number, pass a nil value for the expected 
+# versions.
+#
+# If the matcher fails, a list of which components mismatched is returned.
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'rspec/expectations'
+require File.join(File.dirname(__FILE__), "matcher_helpers.rb")
+
+RSpec::Matchers.define :declare_the_gem_version_to_be do |expected_major, expected_minor, expected_build|
+  match do |actual|
+    @errors = []
+    contents = TcravitRubyLib::MatchHelpers.read_output_file(actual)
+    v = eval(contents[1].downcase)
+    unless expected_major.nil?
+      @errors.push("expected major version #{expected_major} but got #{v[0]}") unless (v[0] == expected_major)
+    end
+    unless expected_minor.nil?
+      @errors.push("expected minor version #{expected_minor} but got #{v[1]}") unless (v[1] == expected_minor)
+    end
+    unless expected_build.nil?
+      @errors.push("expected build version #{expected_build} but got #{v[2]}") unless (v[2] == expected_build)
+    end
+    @errors.empty?
+  end
+
+  failure_message do |actual|
+    @errors.join("\n")
+  end
+end

data/spec/support/matchers/matcher_helpers.rb

@@ -0,0 +1,48 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : matcher_helpers.rb
+# Description : Helper functions for the RSpec custom matchers in this
+#               directory.
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'rspec/expectations'
+
+module TcravitRubyLib
+  module MatchHelpers
+    
+    ##
+    # Read a text file and return its contents as an array of strings. If
+    # the file is not found or an error occurs, returns an empty array.
+
+    def self.read_output_file(f)
+      lines = []
+
+      if File.exist?(f)
+        begin
+          fh = open(f)
+          fh.each { |l| lines.push(l.chomp) }
+          fh.close
+        rescue
+          return []
+        end
+      end
+      return lines
+    end
+
+  end
+end

data/spec/utility_spec.rb

@@ -0,0 +1,46 @@
+############################################################################
+# TcravitRubyLib: Random useful stuff for Ruby programming.
+#
+# File        : utility_spec.rb
+# Specs for   : TcravitRubyLib::Utility
+############################################################################
+#  Copyright 2011-2018, Tammy Cravit.
+# 
+#  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 of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  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.
+############################################################################
+
+require 'spec_helper'
+require "tcravit_ruby_lib/utility"
+
+RSpec.describe "TcravitRubyLib::Utility" do
+  context "random_alphanumeric()" do
+    it "should return a random string of the correct length" do
+      s = TcravitRubyLib::Utility.random_alphanumeric(16)
+      expect(s).not_to be_nil
+      expect(s.length).to be == 16
+    end
+
+    it "should return a relatively random string" do
+      s = TcravitRubyLib::Utility.random_alphanumeric(256)
+      frequencies = {}
+      s.chars.each {|c| frequencies[c] ||= 0; frequencies[c] = frequencies[c] + 1}
+      expect(frequencies.values.max_by { |x| x}).to be <= 25  # There's probably a better way to do this
+    end
+
+    it "should allow you to generate pronounceable passwords" do
+      s = TcravitRubyLib::Utility.random_alphanumeric(32, true)
+      expect(s.length).to be == 32
+      expect(s).to match(/^[A-Za-z]+/)
+    end
+  end
+end