defra_ruby_validators 1.1.0 → 1.2.0

data/spec/defra_ruby/validators/location_validator_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+module Test
+  LocationValidatable = Struct.new(:location) do
+    include ActiveModel::Validations
+
+    validates :location, "defra_ruby/validators/location": true
+  end
+end
+
+module DefraRuby
+  module Validators
+    RSpec.describe LocationValidator, type: :model do
+
+      valid_location = %w[england northern_ireland scotland wales].sample
+      invalid_location = "france"
+
+      it_behaves_like("a validator")
+      it_behaves_like(
+        "a selection validator",
+        LocationValidator,
+        Test::LocationValidatable,
+        :location,
+        valid: valid_location, invalid: invalid_location
+      )
+    end
+  end
+end

data/spec/defra_ruby/validators/phone_number_validator_spec.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+module Test
+  PhoneNumberValidatable = Struct.new(:phone_number) do
+    include ActiveModel::Validations
+
+    validates :phone_number, "defra_ruby/validators/phone_number": true
+  end
+end
+
+module DefraRuby
+  module Validators
+    RSpec.describe PhoneNumberValidator, type: :model do
+
+      valid_number = [
+        "+441234567890",
+        "01234567890",
+        "+441234-567-890",
+        "01234.567.890",
+        "+441234 567 890"
+      ].sample
+      too_long_number = Helpers::TextGenerator.random_number_string(16) # The max length is 15.
+      invalid_number = "#123"
+
+      it_behaves_like("a validator")
+      it_behaves_like(
+        "a presence validator",
+        PhoneNumberValidator,
+        Test::PhoneNumberValidatable,
+        :phone_number,
+        valid: valid_number
+      )
+      it_behaves_like(
+        "a length validator",
+        PhoneNumberValidator,
+        Test::PhoneNumberValidatable,
+        :phone_number,
+        valid: valid_number, invalid: too_long_number
+      )
+
+      describe "#validate_each" do
+        context "when the phone number is not valid" do
+          context "because the phone number is not correctly formatted" do
+            validatable = Test::PhoneNumberValidatable.new(invalid_number)
+            error_message = Helpers::Translator.error_message(PhoneNumberValidator, :phone_number, :invalid_format)
+
+            it_behaves_like "an invalid record", validatable, :phone_number, error_message
+          end
+        end
+      end
+    end
+  end
+end

data/spec/defra_ruby/validators/position_validator_spec.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+module Test
+  PositionValidatable = Struct.new(:position) do
+    include ActiveModel::Validations
+
+    validates :position, "defra_ruby/validators/position": true
+  end
+end
+
+module DefraRuby
+  module Validators
+    RSpec.describe PositionValidator, type: :model do
+
+      valid_position = "Padawan"
+      too_long_position = Helpers::TextGenerator.random_string(PositionValidator::MAX_LENGTH + 1)
+      invalid_position = "**Invalid_@_Position**"
+      empty_position = ""
+
+      it_behaves_like("a validator")
+      it_behaves_like(
+        "a length validator",
+        PositionValidator,
+        Test::PositionValidatable,
+        :position,
+        valid: valid_position, invalid: too_long_position
+      )
+      it_behaves_like(
+        "a characters validator",
+        PositionValidator,
+        Test::PositionValidatable,
+        :position,
+        valid: valid_position, invalid: invalid_position
+      )
+
+      describe "#validate_each" do
+        context "when the position is valid" do
+          context "despite being blank (because position is optional)" do
+            it_behaves_like "a valid record", Test::PositionValidatable.new(empty_position)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/defra_ruby/validators/token_validator_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+module Test
+  TokenValidatable = Struct.new(:token) do
+    include ActiveModel::Validations
+
+    validates :token, "defra_ruby/validators/token": true
+  end
+end
+
+module DefraRuby
+  module Validators
+    RSpec.describe TokenValidator, type: :model do
+
+      valid_token = Helpers::TextGenerator.random_string(24)
+      invalid_token = "123456"
+
+      it_behaves_like("a validator")
+      it_behaves_like(
+        "a presence validator",
+        TokenValidator,
+        Test::TokenValidatable,
+        :token,
+        valid: valid_token
+      )
+
+      describe "#validate_each" do
+        context "when the token is not valid" do
+          context "because the token is not correctly formatted" do
+            validatable = Test::TokenValidatable.new(invalid_token)
+            error_message = Helpers::Translator.error_message(TokenValidator, :token, :invalid_format)
+
+            it_behaves_like "an invalid record", validatable, :token, error_message
+          end
+        end
+      end
+    end
+  end
+end

data/spec/defra_ruby/validators/true_false_validator_spec.rb

@@ -3,10 +3,10 @@
 require "spec_helper"
 
 module Test
-  TrueFalseValidatable = Struct.new(:response) do
+  TrueFalseValidatable = Struct.new(:attribute) do
     include ActiveModel::Validations
 
-    validates :response, "defra_ruby/validators/true_false": true
+    validates :attribute, "defra_ruby/validators/true_false": true
   end
 end
 
@@ -15,9 +15,16 @@ module DefraRuby
     RSpec.describe TrueFalseValidator do
 
       valid_value = %w[true false].sample
+      invalid_value = "unsure"
 
-      it_behaves_like "a validator"
-      it_behaves_like "a selection validator", TrueFalseValidator, Test::TrueFalseValidatable, :response, valid_value
+      it_behaves_like("a validator")
+      it_behaves_like(
+        "a selection validator",
+        TrueFalseValidator,
+        Test::TrueFalseValidatable,
+        :attribute,
+        valid: valid_value, invalid: invalid_value
+      )
     end
   end
 end

data/spec/examples.txt

@@ -1,46 +1,81 @@
 example_id                                                                         | status | run_time        |
 ---------------------------------------------------------------------------------- | ------ | --------------- |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:1:1]       | passed | 0.00016 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:1:1:1] | passed | 0.00072 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:1:1:2] | passed | 0.00079 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:2:1:1] | passed | 0.00082 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:2:1:2] | passed | 0.00081 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:3:1:1] | passed | 0.00065 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:3:1:2] | passed | 0.00062 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:4:1:1] | passed | 0.00131 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:4:1:2] | passed | 0.00086 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:1:1:1] | passed | 0.00029 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:1:1:2] | passed | 0.00023 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:1:1:3] | passed | 0.0003 seconds  |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:2:1:1] | passed | 0.00026 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:2:1:2] | passed | 0.00021 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:2:1:3] | passed | 0.00028 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:3:1:1] | passed | 0.00081 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:3:1:2] | passed | 0.00102 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:3:1:3] | passed | 0.00073 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:4:1:1] | passed | 0.001 seconds   |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:4:1:2] | passed | 0.00071 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:4:1:3] | passed | 0.00137 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:3:1:1]   | passed | 0.00503 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:3:1:2]   | passed | 0.00091 seconds |
-./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:3:1:3]   | passed | 0.07132 seconds |
-./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:1:1]              | passed | 0.03655 seconds |
-./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:2:1]              | passed | 0.02028 seconds |
-./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:3:1]              | passed | 0.02097 seconds |
-./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:4:1:1]            | passed | 0.03174 seconds |
-./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:4:2:1]            | passed | 0.01659 seconds |
-./spec/defra_ruby/validators/configuration_spec.rb[1:1:1]                          | passed | 0.0146 seconds  |
-./spec/defra_ruby/validators/configuration_spec.rb[1:2]                            | passed | 0.006 seconds   |
-./spec/defra_ruby/validators/configuration_spec.rb[1:3:1:1]                        | passed | 0.0008 seconds  |
-./spec/defra_ruby/validators/configuration_spec.rb[1:3:2:1]                        | passed | 0.00518 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:1:1]                   | passed | 0.00041 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:1]                   | passed | 0.00031 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:1:1:1]             | passed | 0.00055 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:1:1:2]             | passed | 0.00029 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:1:1:1]           | passed | 0.00027 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:1:1:2]           | passed | 0.00027 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:1:1:3]           | passed | 0.00029 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:2:1:1]           | passed | 0.00026 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:2:1:2]           | passed | 0.00027 seconds |
-./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:2:1:3]           | passed | 0.00024 seconds |
-./spec/defra_ruby/validators_spec.rb[1:1:1]                                        | passed | 0.00956 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:1:1]                | passed | 0.00145 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:1]                | passed | 0.00011 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:1:1:1]          | passed | 0.00017 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:1:1:2]          | passed | 0.00445 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:2:1:1:1]        | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:2:1:1:2]        | passed | 0.00016 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:2:1:1:3]        | passed | 0.00059 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:2:2:1:1]        | passed | 0.00016 seconds |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:2:2:1:2]        | passed | 0.0002 seconds  |
+./spec/defra_ruby/validators/business_type_validator_spec.rb[1:2:2:2:2:1:3]        | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:1:1]       | passed | 0.00009 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:1:1:1] | passed | 0.00043 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:1:1:2] | passed | 0.00044 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:2:1:1] | passed | 0.00043 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:2:1:2] | passed | 0.00041 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:3:1:1] | passed | 0.00045 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:3:1:2] | passed | 0.00646 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:4:1:1] | passed | 0.00042 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:1:4:1:2] | passed | 0.00038 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:1:1:1] | passed | 0.00015 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:1:1:2] | passed | 0.00016 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:1:1:3] | passed | 0.00017 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:2:1:1] | passed | 0.00017 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:2:1:2] | passed | 0.00015 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:2:1:3] | passed | 0.0002 seconds  |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:3:1:1] | passed | 0.00046 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:3:1:2] | passed | 0.00042 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:3:1:3] | passed | 0.00043 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:4:1:1] | passed | 0.00046 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:4:1:2] | passed | 0.00046 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:2:4:1:3] | passed | 0.00044 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:3:1:1]   | passed | 0.00045 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:3:1:2]   | passed | 0.00042 seconds |
+./spec/defra_ruby/validators/companies_house_number_validator_spec.rb[1:2:3:1:3]   | passed | 0.00046 seconds |
+./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:1:1]              | passed | 0.10949 seconds |
+./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:2:1]              | passed | 0.22067 seconds |
+./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:3:1]              | passed | 0.11422 seconds |
+./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:4:1:1]            | passed | 0.01368 seconds |
+./spec/defra_ruby/validators/companies_house_service_spec.rb[1:1:4:2:1]            | passed | 0.01557 seconds |
+./spec/defra_ruby/validators/configuration_spec.rb[1:1:1]                          | passed | 0.0014 seconds  |
+./spec/defra_ruby/validators/configuration_spec.rb[1:2]                            | passed | 0.00045 seconds |
+./spec/defra_ruby/validators/configuration_spec.rb[1:3:1:1]                        | passed | 0.00113 seconds |
+./spec/defra_ruby/validators/configuration_spec.rb[1:3:2:1]                        | passed | 0.00015 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:1:1]                     | passed | 0.0001 seconds  |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:2:1]                     | passed | 0.0001 seconds  |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:2:2:1:1:1]               | passed | 0.00014 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:2:2:1:1:2]               | passed | 0.00013 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:2:2:2:1:1:1]             | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:2:2:2:1:1:2]             | passed | 0.00019 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:2:2:2:1:1:3]             | passed | 0.00023 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:3:1]                     | passed | 0.00013 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:3:2:1:1:1]               | passed | 0.00017 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:3:2:1:1:2]               | passed | 0.00015 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:3:2:2:1:1:1]             | passed | 0.00021 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:3:2:2:1:1:2]             | passed | 0.00019 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:3:2:2:1:1:3]             | passed | 0.0003 seconds  |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:4:1:1:1:1]               | passed | 0.00014 seconds |
+./spec/defra_ruby/validators/position_validator_spec.rb[1:4:1:1:1:2]               | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:1:1]                        | passed | 0.00009 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:2:1]                        | passed | 0.00012 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:2:2:1:1:1]                  | passed | 0.0002 seconds  |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:2:2:1:1:2]                  | passed | 0.00012 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:2:2:2:1:1:1]                | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:2:2:2:1:1:2]                | passed | 0.00014 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:2:2:2:1:1:3]                | passed | 0.00017 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:3:1:1:1:1]                  | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:3:1:1:1:2]                  | passed | 0.00016 seconds |
+./spec/defra_ruby/validators/token_validator_spec.rb[1:3:1:1:1:3]                  | passed | 0.00015 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:1:1]                   | passed | 0.0001 seconds  |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:1]                   | passed | 0.0001 seconds  |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:1:1:1]             | passed | 0.00014 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:1:1:2]             | passed | 0.00015 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:1:1:1]           | passed | 0.00017 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:1:1:2]           | passed | 0.00016 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:1:1:3]           | passed | 0.00024 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:2:1:1]           | passed | 0.00019 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:2:1:2]           | passed | 0.00018 seconds |
+./spec/defra_ruby/validators/true_false_validator_spec.rb[1:2:2:2:2:1:3]           | passed | 0.00019 seconds |
+./spec/defra_ruby/validators_spec.rb[1:1:1]                                        | passed | 0.001 seconds   |

data/spec/spec_helper.rb

@@ -6,6 +6,10 @@ require "bundler/setup"
 # This is as per its docs https://github.com/colszowka/simplecov#getting-started
 require "./spec/support/simplecov"
 
+# Load env vars from a text file. This must be done before we load the other
+# support files as some of them rely on the env vars being set.
+require "dotenv/load"
+
 # Requires supporting ruby files with custom matchers and macros, etc, in
 # spec/support/ and its subdirectories. Files matching `spec/**/*_spec.rb` are
 # run as spec files by default. This means that files in spec/support that end

data/spec/support/helpers/text_generator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Helpers
+  module TextGenerator
+    def self.random_string(length)
+      random_string_from_sequence([("a".."z"), ("A".."Z")].map(&:to_a).flatten, length)
+    end
+
+    def self.random_number_string(length)
+      random_string_from_sequence(("0".."9").to_a, length)
+    end
+
+    def self.random_string_from_sequence(sequence, length)
+      (0...length).map { sequence[rand(sequence.length)] }.join
+    end
+  end
+end

data/spec/support/helpers/translator.rb

@@ -2,11 +2,10 @@
 
 module Helpers
   module Translator
-    def self.error_message(klass:, attribute: nil, error:)
+    def self.error_message(klass, attribute, error)
       class_name = klass_name(klass)
-      return I18n.t("defra_ruby.validators.#{class_name}.#{attribute}.#{error}") if attribute
 
-      I18n.t("defra_ruby.validators.#{class_name}.#{error}")
+      I18n.t("defra_ruby.validators.#{class_name}.#{attribute}.#{error}")
     end
 
     def self.klass_name(klass)

data/spec/support/shared_examples/validators/characters_validator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+RSpec.shared_examples "a characters validator" do |validator, validatable_class, attribute, values|
+  it "includes CanValidateCharacters" do
+    included_modules = described_class.ancestors.select { |ancestor| ancestor.instance_of?(Module) }
+
+    expect(included_modules)
+      .to include(DefraRuby::Validators::CanValidateCharacters)
+  end
+
+  describe "#validate_each" do
+    context "when the #{attribute} is valid" do
+      it_behaves_like "a valid record", validatable_class.new(values[:valid])
+    end
+
+    context "when the #{attribute} is not valid" do
+      context "because the #{attribute} is not correctly formatted" do
+        validatable = validatable_class.new(values[:invalid])
+        error_message = Helpers::Translator.error_message(validator, attribute, :invalid)
+
+        it_behaves_like "an invalid record", validatable, attribute, error_message
+      end
+    end
+  end
+end

data/spec/support/shared_examples/validators/invalid_record.rb

@@ -1,18 +1,28 @@
 # frozen_string_literal: true
 
-RSpec.shared_examples "an invalid record" do |validatable, property, error_message|
+RSpec.shared_examples "an invalid record" do |validatable, attribute, error_message|
   it "confirms the object is invalid" do
     expect(validatable).to_not be_valid
   end
 
   it "adds a single validation error to the record" do
     validatable.valid?
-    expect(validatable.errors[property].count).to eq(1)
+    expect(validatable.errors[attribute].count).to eq(1)
   end
 
   it "adds an appropriate validation error" do
     validatable.valid?
     expect(error_message).to_not include("translation missing:")
-    expect(validatable.errors[property]).to eq([error_message])
+    expect(validatable.errors[attribute]).to eq([error_message])
+  end
+
+  context "when there is a custom error message" do
+    let(:custom_message) { "something is wrong (in a customised way)" }
+    before { allow_any_instance_of(DefraRuby::Validators::BaseValidator).to receive(:options).and_return(message: custom_message) }
+
+    it "uses the custom message instead of the default" do
+      validatable.valid?
+      expect(validatable.errors[attribute]).to eq([custom_message])
+    end
   end
 end

data/spec/support/shared_examples/validators/length_validator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+RSpec.shared_examples "a length validator" do |validator, validatable_class, attribute, values|
+  it "includes CanValidateLength" do
+    included_modules = described_class.ancestors.select { |ancestor| ancestor.instance_of?(Module) }
+
+    expect(included_modules)
+      .to include(DefraRuby::Validators::CanValidateLength)
+  end
+
+  describe "#validate_each" do
+    context "when the #{attribute} is valid" do
+      it_behaves_like "a valid record", validatable_class.new(values[:valid])
+    end
+
+    context "when the #{attribute} is not valid" do
+      context "because the #{attribute} is too long" do
+        validatable = validatable_class.new(values[:invalid])
+        error_message = Helpers::Translator.error_message(validator, attribute, :too_long)
+
+        it_behaves_like "an invalid record", validatable, attribute, error_message
+      end
+    end
+  end
+end