ward 0.1.0

data/features/include_matcher.feature

@@ -0,0 +1,28 @@
+Feature: Include matcher
+  In order to validate that a value is one of several permitted
+  I want to be able to use the include matcher to set the permitted values
+
+  # +one_of+ is also available as +included_in+
+
+  Background:
+    Given a class with a 'level' attribute
+    And using a validation set like
+      """
+      object.level.is.one_of([60, 70, 80])
+
+      """
+
+  Scenario Outline: When the attribute value matches the expected value
+    When the instance 'level' attribute is '<level>'
+    Then the validation set should pass
+
+    Examples:
+      | level |
+      | 60    |
+      | 70    |
+      | 80    |
+
+  Scenario: When the attribute value does not match the expected value
+    When the instance 'level' attribute is '61'
+    Then the validation set should fail
+      And the error on 'level' should be 'Level should be 60, 70, or 80'

data/features/is_keyword.feature

@@ -0,0 +1,42 @@
+Feature: Validating objects with an "is" keyword
+  In order provide a more natural DSL
+  I want to be able to use the is keyword
+
+  Background:
+    Given a class with a 'name' attribute
+
+  Scenario: With no arguments, a matcher, and a valid value
+    When using a validation set like
+      """
+      object.name.is.equal_to('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Samuel L. Chang'
+    Then the validation set should pass
+
+  Scenario: With no arguments, a matcher, and an invalid value
+    When using a validation set like
+      """
+      object.name.is.equal_to('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should fail
+
+  Scenario: With an argument and a valid value
+    When using a validation set like
+      """
+      object.name.is('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Samuel L. Chang'
+    Then the validation set should pass
+
+  Scenario: With an argument and an invalid value
+    When using a validation set like
+      """
+      object.name.is('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should fail

data/features/is_not_keyword.feature

@@ -0,0 +1,62 @@
+Feature: Validating objects with an "is_not" or "does_not" keyword
+  In order to give users greater control over their validators
+  I want be able to use the is_not and does_not keyword to negate what follows
+
+  Background:
+    Given a class with a 'name' attribute
+
+  Scenario Outline: With no arguments, a matcher, and a valid value
+    When using a validation set like
+      """
+      object.name.<keyword>.equal_to('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Samuel L. Chang'
+    Then the validation set should fail
+
+    Examples:
+      | keyword  |
+      | is_not   |
+      | does_not |
+
+  Scenario Outline: With no arguments, a matcher, and an invalid value
+    When using a validation set like
+      """
+      object.name.<keyword>.equal_to('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should pass
+
+    Examples:
+      | keyword  |
+      | is_not   |
+      | does_not |
+
+  Scenario Outline: With an argument and a valid value
+    When using a validation set like
+      """
+      object.name.<keyword>('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Samuel L. Chang'
+    Then the validation set should fail
+
+    Examples:
+      | keyword  |
+      | is_not   |
+      | does_not |
+
+  Scenario Outline: With an argument and an invalid value
+    When using a validation set like
+      """
+      object.name.<keyword>('Samuel L. Chang')
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should pass
+
+    Examples:
+      | keyword  |
+      | is_not   |
+      | does_not |

data/features/match_matcher.feature

@@ -0,0 +1,49 @@
+Feature: Match matcher
+  In order to ensure that a attribute conforms to a certain format
+  I want be able to validate attributes against a regular expression
+
+  Background:
+    Given a class with a 'name' attribute
+
+  Scenario Outline: When the expected value is a regexp and the actual value matches
+    When using a validation set like
+      """
+      object.name.matches(/Michael/)
+
+      """
+    And the instance 'name' attribute is '<value>'
+    Then the validation set should pass
+
+    Examples:
+      | value         |
+      | Michael       |
+      | Michael Scarn |
+
+  Scenario: When the expected value is a regexp and the actual value does not match
+    When using a validation set like
+      """
+      object.name.matches(/Michael/)
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should fail
+      And the error on 'name' should be 'Name format is invalid'
+
+  Scenario: When the expected value is a String and the actual value matches
+    When using a validation set like
+      """
+      object.name.matches('Michael')
+
+      """
+    And the instance 'name' attribute is 'Michael'
+    Then the validation set should pass
+
+  Scenario: When the expected value is a String and the actual value does not match
+    When using a validation set like
+      """
+      object.name.matches('Michael')
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should fail
+      And the error on 'name' should be 'Name format is invalid'

data/features/multiple_validators.feature

@@ -0,0 +1,29 @@
+Feature: Objects which have multiple validators in the same scenario
+  In order to allow users to thoroughly test their objects
+  I want be able to have multiple validators in the same scenario
+
+  Background:
+    Given a class with a 'name' attribute
+      And the class also has a 'job' attribute
+    When validating the 'name' attribute
+      And validating the 'job' attribute
+
+  Scenario: When all attributes are valid
+    When the instance 'name' attribute is valid
+      And  the instance 'job' attribute is valid
+    Then the validation set should pass
+      And there should be no validation errors
+
+  Scenario: When one attribute is invalid
+    When the instance 'name' attribute is invalid
+      And the instance 'job' attribute is valid
+    Then the validation set should fail
+      And there should be 1 validation error on 'name'
+      And there should be no validation errors on 'job'
+
+  Scenario: When both attributes are invalid
+    When the instance 'name' attribute is invalid
+      And the instance 'job' attribute is invalid
+    Then the validation set should fail
+      And there should be 1 validation error on 'name'
+      And there should be 1 validation error on 'job'

data/features/nil_matcher.feature

@@ -0,0 +1,25 @@
+Feature: Nil matcher
+  In order to validate that an attribute is nil
+  I want to be able to use the nil matcher
+
+  Background:
+    Given a class with a 'storage' attribute
+    And using a validation set like
+      """
+      object.storage.is.nil
+
+      """
+
+  Scenario: When the attribute value is nil
+    When the instance 'storage' attribute is 'nil'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is not nil
+    When the instance 'storage' attribute is '500'
+    Then the validation set should fail
+      And the error on 'storage' should be 'Storage should be nil'
+
+  Scenario: When the attribute value is false
+    When the instance 'storage' attribute is 'false'
+    Then the validation set should fail
+      And the error on 'storage' should be 'Storage should be nil'

data/features/predicate_matcher.feature

@@ -0,0 +1,23 @@
+Feature: Predicate matcher
+  In order to validate objects with predicate methods
+  I want to be able to seem to call the predicate in the validation block
+
+  Background:
+    Given a class with a 'important?' attribute
+    And using a validation set like
+      """
+      object.is.important?
+
+      """
+
+  Scenario: When the attribute value is true
+    When the instance 'important?' attribute is 'true'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is nil
+    When the instance 'important?' attribute is 'nil'
+    Then the validation set should fail
+
+  Scenario: When the attribute value is false
+    When the instance 'important?' attribute is 'false'
+    Then the validation set should fail

data/features/present_matcher.feature

@@ -0,0 +1,59 @@
+Feature: Present matcher
+  In order to validate that an attribute has a value
+  I want to be able to use the present matcher
+
+  Background:
+    Given a class with a 'charisma' attribute
+    And using a validation set like
+      """
+      object.charisma.is.present
+
+      """
+
+  Scenario: When the attribute value is nil
+    When the instance 'charisma' attribute is 'nil'
+    Then the validation set should fail
+
+  Scenario: When the attribute value is true
+    When the instance 'charisma' attribute is 'true'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is false
+    When the instance 'charisma' attribute is 'false'
+    Then the validation set should fail
+
+  Scenario: When the attribute value is a Symbol
+    When the instance 'charisma' attribute is ':yes'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is a zero
+    When the instance 'charisma' attribute is '0'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is a positive number
+    When the instance 'charisma' attribute is '1'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is a negative number
+    When the instance 'charisma' attribute is '-1'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is a non-empty string
+    When the instance 'charisma' attribute is 'Amazing'
+    Then the validation set should pass
+
+  Scenario: When the attribute value is a whitespace-only string
+    When the instance 'charisma' attribute is '" \t\r\n"'
+    Then the validation set should fail
+
+  Scenario: When the attribute value is an empty string
+    When the instance 'charisma' attribute is ''
+    Then the validation set should fail
+
+  Scenario: When the attribute value responds to #empty and is not empty
+    When the instance 'charisma' attribute is '[1]'
+    Then the validation set should pass
+
+  Scenario: When the attribute value responds to #empty and is empty
+    When the instance 'charisma' attribute is '[]'
+    Then the validation set should fail

data/features/satisfy_matcher.feature

@@ -0,0 +1,80 @@
+
+Feature: Satisfy matcher
+  In order run arbitrary validations on the object
+  I want to be able validate that an attribute satisfies a given expression
+
+  Background:
+    Given a class with a 'name' attribute
+
+  Scenario: Matching with just the attribute value
+    When using a validation set like
+      """
+      object.name.satisfies { |name| name.reverse == 'nracS leahciM' }
+      # better: object.name.reverse.is('nracS leahciM')
+
+      """
+    And the instance 'name' attribute is 'Michael Scarn'
+    Then the validation set should pass
+
+  Scenario: Negatively matching with just the attribute value
+    When using a validation set like
+      """
+      object.name.does_not.satisfy { |name| name.reverse == 'nracS leahciM' }
+
+      """
+    And the instance 'name' attribute is 'Michael Scott'
+    Then the validation set should pass
+
+  Scenario: Failing to match with just the attribute value
+    When using a validation set like
+      """
+      object.name.satisfies { |name| name.reverse == 'nracS leahciM' }
+
+      """
+    And the instance 'name' attribute is 'Michael Scott'
+    Then the validation set should fail
+      And the error on 'name' should be 'Name is invalid'
+
+  Scenario: Failing to match by returning nil
+    When using a validation set like
+      """
+      object.name.satisfies { |name| nil }
+
+      """
+    And the instance 'name' attribute is 'Michael Scott'
+    Then the validation set should fail
+      And the error on 'name' should be 'Name is invalid'
+
+  Scenario: Failing to match and returning a specific error message
+    When using a validation set like
+      """
+      object.name.satisfies do |name|
+        [false, "An error"]
+      end
+
+      """
+    Then the validation set should fail
+      And the error on 'name' should be 'An error'
+
+  Scenario: Matching with the attribute value and record
+    When using a validation set like
+      """
+      object.name.satisfies do |name, record|
+        record.name.reverse == 'nracS leahciM'
+      end
+
+      """
+    And the instance 'name' attribute is 'Michael Scarn'
+    Then the validation set should pass
+
+  Scenario: Failing to match with the attribute value and record
+    When using a validation set like
+      """
+      object.name.satisfies do |name, record|
+        record.name.reverse == 'nracS leahciM'
+      end
+
+      """
+    And the instance 'name' attribute is 'Dwigt'
+    Then the validation set should fail
+      And the error on 'name' should be 'Name is invalid'

data/features/scenario_validation.feature

@@ -0,0 +1,81 @@
+Feature: Validating objects in different scenarios
+  In order to allow a user to alter the validators for an object
+  I want to be able to define validators to run only at certain times
+
+  Background:
+    Given a class with a 'given_name' attribute
+      And the class also has a 'family_name' attribute
+    When validating the 'given_name' attribute
+      And validating the 'family_name' attribute in the 'family' scenario
+
+  #
+  # With no explicit scenario when validating.
+  #
+
+  Scenario: Passing with no explicit scenario when all values are valid
+    When the instance 'given_name' attribute is valid
+    When the instance 'family_name' attribute is valid
+    Then the validation set should pass
+
+  Scenario: Passing with no explicit scenario when :family scenario values are invalid
+    When the instance 'given_name' attribute is valid
+    When the instance 'family_name' attribute is invalid
+    Then the validation set should pass
+
+  Scenario: Failing with no explicit scenario when all values are invalid
+    When the instance 'given_name' attribute is invalid
+    When the instance 'family_name' attribute is invalid
+    Then the validation set should fail
+
+  Scenario: Failing with no explicit scenario when :family scenario values are valid
+    When the instance 'given_name' attribute is invalid
+    When the instance 'family_name' attribute is valid
+    Then the validation set should fail
+
+  #
+  # With an explicit :default scenario when validating.
+  #
+
+  Scenario: Passing when using the :default scenario when all values are valid
+  When the instance 'given_name' attribute is valid
+  When the instance 'family_name' attribute is valid
+    Then the validation set should pass when using the 'default' scenario
+
+  Scenario: Passing when using :default scenario when :family scenario values are invalid
+  When the instance 'given_name' attribute is valid
+  When the instance 'family_name' attribute is invalid
+    Then the validation set should pass when using the 'default' scenario
+
+  Scenario: Failing when using :default scenario when all values are invalid
+    When the instance 'given_name' attribute is invalid
+    When the instance 'family_name' attribute is invalid
+    Then the validation set should fail when using the 'default' scenario
+
+  Scenario: Failing when using :default scenario when :family scenario values are valid
+    When the instance 'given_name' attribute is invalid
+    When the instance 'family_name' attribute is valid
+    Then the validation set should fail when using the 'default' scenario
+
+  #
+  # With an explicit :family scenario when validating.
+  #
+
+  Scenario: Passing when using :family scenario when all values are valid
+  When the instance 'given_name' attribute is valid
+  When the instance 'family_name' attribute is valid
+    Then the validation set should pass when using the 'family' scenario
+
+  Scenario: Passing when using :family scenario when :default scenario values are invalid
+  When the instance 'given_name' attribute is invalid
+  When the instance 'family_name' attribute is valid
+    Then the validation set should pass when using the 'family' scenario
+
+  Scenario: Failing when using :family scenario when all values are invalid
+    When the instance 'given_name' attribute is invalid
+    When the instance 'family_name' attribute is invalid
+    Then the validation set should fail when using the 'family' scenario
+
+  Scenario: Failing when using :family scenario when :default scenario values are valid
+    When the instance 'given_name' attribute is valid
+    When the instance 'family_name' attribute is invalid
+    Then the validation set should fail when using the 'family' scenario