rast 0.19.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f3ab7d817085dca4c5fc3c3fd0956ca6a6f87eadd9d97554f693aa81908f5e8
-  data.tar.gz: 5e2f9d234c29e5cfc0ccab251980099e13af8c3355d7ea83ad3d8dc8a97ff4c1
+  metadata.gz: db0077928a7df4dcd98e98737660be491b8eb5aaad2ed6f9e3015ed26d2b703e
+  data.tar.gz: 75c49f92fed7ac16e1490a531c3bf87fec92e6c26e20f466c92cde3c2f0c3d66
 SHA512:
-  metadata.gz: 3fe3b7af6cbc40ce1ab44a8120ac66865b262a751a448d382f72a2cc28999ab45761a21a4747b8c362e27e46e06eaf4f34f4cf794fb64951d680621c9b1a1deb
-  data.tar.gz: 1e07f58dd3fa04a7e84b6cf25a4b4956847f1975e21973b4b3ecc62d74c9f28b3676fd7b185224a2a65b0f4eee612efaea92999c8e8dc7dda01f312db1f825c8
+  metadata.gz: 74101d1f6227851cab7d263e6750df4aae5a9f70dbf868c9a3925646f1781406edca38f35b214ad54e4917035ba6d779bd80a18f30fd8c2ffee903b02a4c4889
+  data.tar.gz: 1a41f4db833451dffe2ff219d2acd009426f1ebe6685db335ff44371a22acbb6c6bd76c53edefe19e52a1f884bb19a0587b9041d38539f9431b8b88bb0530fc2

data/.rubocop.yml

@@ -1,3 +1,3 @@
 ---
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 3.2

data/.ruby-version

@@ -0,0 +1 @@
+3.2

data/CHANGELOG.md

@@ -1,24 +1,32 @@
-# Change log
+# Change logs
 
 ## Unreleased
 
-- Add travis-ci build.
-- Add RubyGems badge
-- Update documentation.
 
 ## Released
 
+- 1.00.0
+    - [maint] Updated for Ruby 3.0, updated Gemfiles. 
+
+- 0.19.1
+
+    - [bug] nil as configured outcome
+    - [bug] nil showing in the report as empty string.
 
 - 0.19.0 - [feature] boolean in variables definition to automatically infer
            false and true
            [feature] xrast to skip entire test.
            [feature] Add default outcome in yaml-less configuration. Default
            config will take higher precedence than boolean outcomes.
+
 - 0.18.0 - [feature] xspec to skip a test
          - [feature] Added include rule to isolate scenarios.
          - [feature] Asterisk can be used as token character.
          - [bug] Duplicate outcome wasn't detected when there's default config.
          - [enhancement] Early return for 'and' and 'or' operators.
+         - Add travis-ci build.
+         - Add RubyGems badge
+         - Update documentation.
 
 - 0.17.0 - Allow default outcome for unmatched scenarios.
 - 0.16.0 - Allow isolation of scenarios via include clause.
@@ -53,4 +61,4 @@ the prepare block now runs under the context of RSpec.
 - 0.3.0.pre - Support factory methods in execute block.
 - 0.2.0.pre - Support module subjects.
 - 0.1.2.pre - Fixed exclusions.
-- 0.1.1.pre - Pre release version compatible with Ruby 2.0.0-p247
+- 0.1.1.pre - Pre release version compatible with Ruby 2.0.0-p247

data/Documentation.md

@@ -5,6 +5,7 @@
 YAML is the preferred because it simplifies the content of the spec file. YAML contains the variables that affect the outcome, and the expected outcome based on rules that involve the said variables.
 
 ```yaml
+---
 specs:
   # spec key uniquely identifies a spec. It has to match the ID when the spec
   # block is invoked in the ruby spec file. Usually the method name.
@@ -28,6 +29,7 @@ In the example below, the left variable has the subscript of `0`, and the right
 [logic_checker_spec.yml](./spec/examples/rast/logic_checker_spec.yml)
 
 ```yaml
+---
 specs:
   Logical AND:
     variables:
@@ -75,8 +77,8 @@ Finished in 0.00292 seconds (files took 0.26024 seconds to load)
 ### Filtering Out Invalid Cases
 
 In a prior example `HotelFinder`, some cases are invalid. For example, if an
- aircon is not available, then it makes to sense to check if it is operational
- not. In such case, we should limit the scenarios with `exclude` clause.
+ aircon is not available, then it makes no sense to check if it is operational
+ not. In such case, we can limit the scenarios with `exclude` clause.
 
 ```yaml
 # double_example_spec.yml
@@ -191,12 +193,12 @@ specs:
       - "Will this work?"
       - "Let's make a statement"
 ...
-
 ```
 
 The rules must then be written in a different way, as arrays.
 
 ```yaml
+---
 ...
     outcomes:
       exclamation: ["Let's do it!"]
@@ -207,6 +209,7 @@ The rules must then be written in a different way, as arrays.
 If an operation is involved:
 
 ```yaml
+---
 outcomes:
   non-question: ["Let's do it!", '|', "Let's make a statement"]
 ```
@@ -257,7 +260,7 @@ Suppose we have a HotelFinder class that has a dependency to air conditioning
  and security
 
  ```ruby
- rast HotelFinder do
+ rast DiplomatHotelFinder do
    spec '#applicable?' do
      prepare do |with_ac, is_opererational, with_security, security_grade|
        if with_ac
@@ -277,7 +280,7 @@ Suppose we have a HotelFinder class that has a dependency to air conditioning
 
  ```
 
-### Spec file without yaml
+### Spec file without YAML
 
 If a single spec is preferred, like in cases where it's much simplier,
  the required configuration can be written with similar name except for the

data/Gemfile

@@ -5,7 +5,7 @@ source 'https://rubygems.org'
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 group :development, :test do
-  gem 'factory_girl', '~> 4.7'
+  gem 'factory_bot'
 end
 
 group :test do
@@ -14,5 +14,5 @@ group :test do
   gem 'rb-inotify', '~> 0.9.10'
 
   gem 'rspec'
-  gem 'simplecov', '~> 0.8.2'
+  gem 'simplecov'
 end

data/Gemfile.lock

@@ -1,60 +1,59 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (4.2.11.1)
-      i18n (~> 0.7)
-      minitest (~> 5.1)
-      thread_safe (~> 0.3, >= 0.3.4)
-      tzinfo (~> 1.1)
-    concurrent-ruby (1.1.6)
-    diff-lcs (1.3)
-    docile (1.1.5)
-    factory_girl (4.9.0)
-      activesupport (>= 3.0.0)
-    ffi (1.12.2)
-    i18n (0.9.5)
+    activesupport (7.0.7)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    concurrent-ruby (1.2.2)
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    factory_bot (6.2.1)
+      activesupport (>= 5.0.0)
+    ffi (1.15.5)
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
-    listen (3.0.8)
-      rb-fsevent (~> 0.9, >= 0.9.4)
-      rb-inotify (~> 0.9, >= 0.9.7)
-    lumberjack (1.0.13)
-    minitest (5.12.0)
-    multi_json (1.14.1)
-    rb-fsevent (0.10.3)
+    listen (3.8.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    lumberjack (1.2.9)
+    minitest (5.19.0)
+    rb-fsevent (0.11.2)
     rb-inotify (0.9.10)
       ffi (>= 0.5.0, < 2)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.6)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    simplecov (0.8.2)
-      docile (~> 1.1.0)
-      multi_json
-      simplecov-html (~> 0.8.0)
-    simplecov-html (0.8.0)
-    thread_safe (0.3.6)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
 
 PLATFORMS
-  ruby
+  arm64-darwin-21
 
 DEPENDENCIES
-  factory_girl (~> 4.7)
+  factory_bot
   listen (>= 3.0.8)
   lumberjack (~> 1.0, >= 1.0.13)
   rb-inotify (~> 0.9.10)
   rspec
-  simplecov (~> 0.8.2)
+  simplecov
 
 BUNDLED WITH
-   1.17.3
+   2.4.18

data/Getting-Started-Detailed.md

@@ -57,8 +57,8 @@ accepting a parameter.
 
 #### Step 2: Defining outcomes and the variables that affects the test.
 
-For the sake of simplicity, we will define the variables and outcomes in a separate yaml file, mainly because the next
-steps are purely configurations. Using yaml is completely optional.
+For the sake of simplicity, we will define the variables and outcomes in a separate YAML file, mainly because the next
+steps are purely configurations. Using YAML is completely optional.
 
 Create a folder `rast` in the same level as the spec file:
 
@@ -70,8 +70,9 @@ Create a yaml file with the same name as the spec, but with `.yml` extension.
 `spec/rast/positive_spec.yml` would contain:
 
 ```yaml
+---
 specs:
-  Is Positive Exaple:
+  Is Positive Example:
     variables: {number: [-1, 0, 1]}
     outcomes: {true: 1}
 ```

data/README.md

@@ -9,11 +9,11 @@ RSpec All Scenario Testing
 
 This library runs on top of RSpec to provide basically a parameterized unit testing pattern. It follows a specific pattern of writing unit tests, enabling a predictable, complete and outputs a result that is simple to analyze.
 
-### A Basic Example
+## A Basic Example
 
-Suppose we want to create a class that checks if a number is a positive number or not.
+Suppose we want to create a class that checks if a number is a positive or a negative number.
 
-#### Create a spec file `spec/positive_spec.rb`
+### Create a spec file `spec/positive_spec.rb`
 
 ```ruby
 require 'rast'
@@ -25,11 +25,12 @@ rast Positive do
 end
 ```
 
-#### Create a spec configuration `spec/rast/positive_spec.yml`
+### Create a spec configuration `spec/rast/positive_spec.yml`
 
 ```yaml
+---
 specs:
-  Is Positive Exaple:
+  Is Positive Example:
     variables: {number: [-1, 0, 1]}
     outcomes: {true: 1}
 ```
@@ -61,38 +62,46 @@ Finished in 0.00471 seconds (files took 0.47065 seconds to load)
 3 examples, 0 failures
 ```
 
-Read the [documentation](./Documentation.md) for more examples.
+See the [documentation](./Documentation.md) for more examples.
+
+## How to use this project
+1.  Run `$ bundle install`
+2.  Run `$ bundle exec rspec`
+
+### Troubleshooting
+* Delete the Gemfile.lock and reinstall.
+
 
 ## Contributing
 
 ### Definition of terms
 
-- `spec` - as defined in the yaml file, the individual elements under `specs`
+- `spec` - as defined in the YAML file, the individual elements under `specs`.
 - `scenario` - a specific combination of tokens from vars, it can uniquely identify a fixture.
 - `token` - used loosely to denote the individual variable in a rule. e.g. `true: you & me`, `you` and `me` are tokens.
-- `fixture` - a hash containing a scenario, reference back to the spec, and the expected result for the given scenario.
+- `fixture` - a hash containing a scenario, references back to the spec, and the expected result for the given scenario.
 - `variables` - raw list of variables to be combined into multiple fixtures.
-- `rule` - set of outcomes, each paired with rule clause.
-- `exclusions` - rule defining variable combinations to be excluded from the test.
+- `rule` - set of outcomes, each paired with a rule clause.
+- `exclusions` - rule defining the variable combinations to be excluded from the test.
 - `inclusions` - rule that limits the scenarios to be included. Useful for isolating test cases.
-- `outcome` - the left portion `us` of a rule e.g. `us: you&me`
-- `clause` - the right portion `you&me` of a rule e.g. `us: you&me`
+- `outcome` - the left portion `us` of a rule, e.g. `us: you&me`
+- `clause` - the right portion `you&me` of a rule, e.g. `us: you&me`
 
 ## Notes to author
 
-When running the tests, the execution starts at the spec file, then invoking the
+When running the tests, the execution starts at the spec file, then invokes the
 DSL. The DSL will then invoke the parameter generator to generate the scenarios.
 
 ### Releasing new features/bugfix
 
-- Increment the .gemspec
-- Modify the CHANGELOG.md
+- Increment the [.gemspec](./rast.gemspec)
+- Modify the [CHANGELOG.md](./CHANGELOG.md)
 
-### Releasing GEM
+### Releasing the GEM
 
 - Build gem with `gem build rast.gemspec`
 - Publish with `gem push <gem-filename>`
 
 ## References
 
-[Semantic Versioning](https://semver.org)
+* [Semantic Versioning](https://semver.org)

data/examples/{hotel_finder.rb → diplomat_hotel_finder.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Example
-class HotelFinder
+class DiplomatHotelFinder
   def aircon; end
 
   def security; end

data/lib/rast/parameter_generator.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
 require 'yaml'
-require 'rast/rast_spec'
+
 require 'rast/rules/rule'
 require 'rast/rules/rule_evaluator'
-require 'rast/rules/rule_validator'
+
+require 'rast/rast_spec'
+require 'rast/rule_validator'
 
 # Generates the test parameters.
 class ParameterGenerator
@@ -36,6 +38,9 @@ class ParameterGenerator
     list = []
 
     variables = spec.variables
+    # dict.first method returns the first key and value as an array, so invoking
+    # .first, then . last would return the
+    # first value.
     var_first = variables.first
     multipliers = []
 
@@ -67,12 +72,12 @@ class ParameterGenerator
 
     include_result = true
     unless spec.exclude_clause.nil?
-      include_result = qualify_secario?(spec, scenario, false)
+      include_result = qualify_scenario?(spec, scenario, false)
     end
 
     return include_result if no_include_or_dont_include?(spec, include_result)
 
-    qualify_secario?(spec, scenario, true)
+    qualify_scenario?(spec, scenario, true)
   end
 
   # blech!
@@ -80,14 +85,13 @@ class ParameterGenerator
     spec.include_clause.nil? || !include_result
   end
 
-  def qualify_secario?(spec, scenario, is_included)
+  def qualify_scenario?(spec, scenario, is_included)
     action = is_included ? 'include' : 'exclude'
-    rule_evaluator = RuleEvaluator.new(converters: spec.converters)
+    rule_evaluator = RuleEvaluator.new(token_converters: spec.token_converter)
     clause = Rule.sanitize(clause: spec.send("#{action}_clause"))
     rule_evaluator.parse(expression: clause)
     rule_evaluator.evaluate(
-      scenario: scenario,
-      rule_token_convert: spec.token_converter
+      scenario: scenario
     ) == is_included.to_s
   end
 

data/lib/rast/rast_spec.rb

@@ -14,7 +14,7 @@ class RastSpec
 
   def initialize(
     description: '',
-    variables: [][],
+    variables: {},
     rule: nil,
     default_outcome: ''
   )

data/lib/rast/{rules/rule_validator.rb → rule_validator.rb}

@@ -5,17 +5,21 @@ require 'rast/rules/rule_processor'
 # Validates rules
 class RuleValidator
   def validate(scenario: [], fixture: {})
-    rule_result = RuleProcessor.new.evaluate(
-      scenario: scenario,
-      fixture: fixture
+    spec = fixture[:spec]
+    rule_processor = RuleProcessor.new(
+      rule: spec.rule,
+      token_converters: spec.token_converter
     )
 
+    rule_result = rule_processor.evaluate(scenario: scenario)
+
     spec = fixture[:spec]
     validate_results(scenario, rule_result, spec)
   end
 
   private
 
+  # @returns string
   def validate_results(scenario, rule_result, spec)
     rule = spec.rule
     single_result = rule.size == 1
@@ -32,7 +36,7 @@ class RuleValidator
     matched_outputs = []
     match_count = 0
 
-    rule_result.map { |result| result.to_s == 'true' }.each_with_index do |result, i|
+    to_boolean(string_list: rule_result).each_with_index do |result, i|
       next unless result
 
       match_count += 1
@@ -44,6 +48,13 @@ class RuleValidator
     matched_outputs.first || spec.default_outcome
   end
 
+  # @returns array of boolean from array of strings. 'true' becomes true.
+  def to_boolean(string_list: [])
+    string_list.map do |result|
+      result.to_s == 'true'
+    end
+  end
+
   def verify_results(spec, scenario, matched_outputs, match_count)
     Rast.assert("#{spec.description} #{scenario} must fall into a unique rule" \
       " outcome/clause, matched: #{matched_outputs}") do
@@ -51,7 +62,7 @@ class RuleValidator
     end
   end
 
-  def binary_outcome(outcome: '', spec: nil, expected: false)
+  def binary_outcome(outcome: '', spec: nil, expected: 'false')
     if expected == 'true'
       outcome
     else

data/lib/rast/rules/logic_helper.rb

@@ -26,9 +26,10 @@ module LogicHelper
   #  * @left left left token object.
   #  * @right right right token object.
   #  * @operation :and or :or.
+  #  * @returns String boolean value, can be internal, thus it is string.
   #  */
   def perform_logical(scenario: [], left: {}, right: {}, operation: :nil)
-    evaluated = send(:both_internal?, left, right, operation)
+    evaluated = both_internal?(left, right, operation)
     return evaluated if evaluated
 
     default = operation == :and ? TRUE : FALSE
@@ -83,8 +84,7 @@ module LogicHelper
 
     return false unless left_eval
 
-    right_eval = present?(scenario, right)
-    left_eval && right_eval
+    present?(scenario, right)
   end
 
   def evaluate_or(scenario, left, right)
@@ -92,8 +92,7 @@ module LogicHelper
 
     return true if left_eval
 
-    right_eval = present?(scenario, right)
-    left_eval || right_eval
+    present?(scenario, right)
   end
 
   # /**

data/lib/rast/rules/rule.rb

@@ -10,25 +10,12 @@ class Rule
   #  * <b>Parameter Example:</b><br/>
   #  * Visible:Proposed|Approved<br/>
   #  * <br/>
-  #  * Peace:Friendly|Indifferent\<br/>
-  #  * ~War:Angry\<br/>
-  #  * ~Neutral:Play safe
   #  */
   def initialize(rules: {})
     raise 'Must not have empty rules' if rules.empty?
 
     @outcome_clause_hash = {}
-    # should have array of the rule pairs
-    # rules = pActRuleSrc.split("~");
-    duplicates = []
-
     rules.each do |outcome, clause|
-      # if duplicates.include?(outcome)
-      #   raise "#{outcome} matched multiple clauses"
-      # end
-
-      # duplicates << outcome
-
       @outcome_clause_hash[outcome.to_s] = Rule.sanitize(clause: clause)
     end
   end

data/lib/rast/rules/rule_evaluator.rb

@@ -31,16 +31,16 @@ class RuleEvaluator
   DEFAULT_CONVERT_HASH = {
     Integer => IntConverter.new,
     Float => FloatConverter.new,
-    Fixnum => IntConverter.new,
     Array => DefaultConverter.new,
     TrueClass => BoolConverter.new,
     FalseClass => BoolConverter.new,
-    String => StrConverter.new
+    String => StrConverter.new,
+    NilClass => DefaultConverter.new
   }.freeze
 
-  # /** @param pConverterList list of rule token converters. */
-  def initialize(converters: [])
-    @converters = converters
+  # /** @param token_converters token to converter mapping */
+  def initialize(token_converters: {})
+    @token_converters = token_converters
 
     @stack_operations = []
     @stack_rpn = []
@@ -52,6 +52,7 @@ class RuleEvaluator
   #  *
   #  * @param pExpression <code>String</code> input expression (logical
   #  *            expression formula)
+  #  * @return void.
   #  * @since 0.3.0
   #  */
   def parse(expression: '')
@@ -85,13 +86,13 @@ class RuleEvaluator
   #  * @param rule_token_convert mapping of rule tokens to converter.
   #  * @return <code>String</code> representation of the result
   #  */
-  def evaluate(scenario: [], rule_token_convert: {})
+  def evaluate(scenario: [])
     if @stack_rpn.size == 1
       evaluate_one_rpn(scenario: scenario).to_s
     else
       evaluate_multi_rpn(
         scenario: scenario,
-        rule_token_convert: rule_token_convert
+        rule_token_convert: @token_converters
       )
     end
   end
@@ -109,19 +110,19 @@ class RuleEvaluator
 
     return default if token.is_a?(Array) || [TRUE, FALSE].include?(token)
 
-    next_value_default(rule_token_convert, token)
+    next_value_default(token)
   end
 
   # private
-  def next_value_default(rule_token_convert, token)
+  def next_value_default(token)
     token_cleaned = token.to_s.strip
     subscript = TokenUtil.extract_subscript(token: token_cleaned)
     token_body = subscript > -1 ? token_cleaned[/^.+(?=\[)/] : token_cleaned
 
-    raise "Config Error: Outcome clause token: '#{token}' not found in variables" if rule_token_convert[token_body].nil?
+    raise "Config Error: Outcome clause token: '#{token}' not found in variables" if @token_converters[token_body].nil?
 
     {
-      value: rule_token_convert[token_body].convert(token_body),
+      value: @token_converters[token_body].convert(token_body),
       subscript: subscript
     }
   end

data/lib/rast/rules/rule_processor.rb

@@ -4,20 +4,21 @@ require 'rast/rules/rule_evaluator'
 
 # undoc
 class RuleProcessor
+  def initialize(rule: nil, token_converters: {})
+    @rule = rule
+    @token_converters = token_converters
+  end
+
   # /**
   #  * @param scenario current scenario.
-  #  * @param caseFixture current test case fixture.
+  #  *
+  #  * @return the outcome results against the given scenario.
   #  */
-  def evaluate(scenario: [], fixture: nil)
-    # if scenario.empty? || fixture.nil?
-    #   raise 'Scenario or fixture cannot be nil.'
-    # end
-
-    fixture[:spec].rule.outcomes.inject([]) do |retval, outcome|
+  def evaluate(scenario: [])
+    @rule.outcomes.inject([]) do |retval, outcome|
       process_outcome(
-        scenario: scenario,
-        fixture: fixture,
         list: retval,
+        scenario: scenario,
         outcome: outcome
       )
     end
@@ -25,17 +26,12 @@ class RuleProcessor
 
   private
 
-  def process_outcome(scenario: [], fixture: nil, list: [], outcome: '')
-    spec = fixture[:spec]
-
-    clause = spec.rule.clause(outcome: outcome)
-    rule_evaluator = RuleEvaluator.new(converters: spec.converters)
-
+  # @returns the list argument with the new result.
+  def process_outcome(list: [], scenario: [], outcome: '')
+    clause = @rule.clause(outcome: outcome)
+    rule_evaluator = RuleEvaluator.new(token_converters: @token_converters)
     rule_evaluator.parse(expression: clause)
 
-    list << rule_evaluator.evaluate(
-      scenario: scenario,
-      rule_token_convert: spec.token_converter
-    )
+    list << rule_evaluator.evaluate(scenario: scenario)
   end
 end

data/lib/rast/spec_dsl.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require 'factory_girl'
+require 'factory_bot'
 require 'rast/parameter_generator'
 
 # Main DSL. This is the entry point of the test when running a spec.
 class SpecDSL
-  include FactoryGirl::Syntax::Methods
+  include FactoryBot::Syntax::Methods
 
   attr_accessor :subject, :execute_block,
                 :prepare_block, :outcomes, :fixtures, :spec_id
@@ -144,12 +144,16 @@ def generate_rspec(scope: nil, scenario: {}, expected: '')
       instance_exec(*block_params, &scope.prepare_block)
     end
 
-    actual = scope.execute_block.call(*block_params).to_s
-
+    actual = execute_and_format_result(scope, block_params)
     expect(actual).to eq(expected)
   end
 end
 
+def execute_and_format_result(scope, block_params)
+  actual = scope.execute_block.call(*block_params)
+  actual.nil? ? 'nil' : actual.to_s
+end
+
 def _it_title(expected, scenario)
   spec_params = scenario.keys.inject('') do |output, key|
     build_it(scenario, output, key)
@@ -160,7 +164,7 @@ end
 
 def build_it(scenario, output, key)
   output += ', ' unless output == ''
-  calc_key = scenario[key].nil? ? nil : scenario[key]
+  calc_key = scenario[key].nil? ? 'nil' : scenario[key]
   output + "#{key}: #{calc_key}"
 end
 

data/rast.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = 'rast'
-  spec.version       = '0.19.0'
+  spec.version       = '1.0.0'
   spec.authors       = ['Royce Remulla']
   spec.email         = ['royce.com@gmail.com']
 
@@ -10,9 +10,9 @@ Gem::Specification.new do |spec|
   spec.description   = 'Extends RSpec functionality by using the catch-all-scenario testing (CAST) principle.'
   spec.homepage      = 'https://github.com/roycetech/rast'
   spec.license       = 'MIT'
-  spec.required_ruby_version = Gem::Requirement.new('~> 2.0')
+  spec.required_ruby_version = Gem::Requirement.new('~> 3.2')
 
-  spec.add_runtime_dependency 'factory_girl', '~> 4.7'
+  spec.add_runtime_dependency 'factory_bot', '~> 6.2'
 
   # spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
   spec.metadata['homepage_uri'] = spec.homepage

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: rast
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Royce Remulla
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-05-22 00:00:00.000000000 Z
+date: 2023-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: factory_girl
+  name: factory_bot
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.7'
+        version: '6.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.7'
+        version: '6.2'
 description: Extends RSpec functionality by using the catch-all-scenario testing (CAST)
   principle.
 email:
@@ -35,6 +35,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
+- ".ruby-version"
 - ".travis.yml"
 - CHANGELOG.md
 - Documentation.md
@@ -43,9 +44,9 @@ files:
 - Getting-Started-Detailed.md
 - Getting-Started.md
 - README.md
+- examples/diplomat_hotel_finder.rb
 - examples/enum_module.rb
 - examples/factory_example.rb
-- examples/hotel_finder.rb
 - examples/logic_checker.rb
 - examples/person.rb
 - examples/positive.rb
@@ -62,12 +63,12 @@ files:
 - lib/rast/converters/str_converter.rb
 - lib/rast/parameter_generator.rb
 - lib/rast/rast_spec.rb
+- lib/rast/rule_validator.rb
 - lib/rast/rules/logic_helper.rb
 - lib/rast/rules/operator.rb
 - lib/rast/rules/rule.rb
 - lib/rast/rules/rule_evaluator.rb
 - lib/rast/rules/rule_processor.rb
-- lib/rast/rules/rule_validator.rb
 - lib/rast/rules/token_util.rb
 - lib/rast/spec_dsl.rb
 - lib/template_spec.yml
@@ -79,7 +80,7 @@ metadata:
   homepage_uri: https://github.com/roycetech/rast
   source_code_uri: https://github.com/roycetech/rast
   changelog_uri: https://github.com/roycetech/rast/blob/feature/ruby-2.0.0-support/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -87,15 +88,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.4.18
+signing_key:
 specification_version: 4
 summary: RSpec AST - All Scenario Testing
 test_files: []