govuk_schemas 4.1.1 → 4.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8123e8bc3461346b31359b47c260930e11505206315aedbfde7532b1601a1e7e
-  data.tar.gz: 3ad819db46a04377edda67d60f3a49c08493723a9b40eefd0d72eade6e1b752c
+  metadata.gz: e46784ff30a78aee2321e3defb7e2b31ea6eb751c96ddec7ba2ebe695a42b29a
+  data.tar.gz: 3f6d24f1c5afb4f175d9157f84ced30b20e475b76958c7128872c179aa7bb62d
 SHA512:
-  metadata.gz: ad57ca91dbe8784fa643ebcab765565480523243fd21829240afc77337da373c0a40d25cfccb4efb225725cc7e40998192d44bb262992170b56fa1aeb38bbe2a
-  data.tar.gz: 2cb1d9f10a775ece8e9143a8de21738484d44f1702c14312da55579c8c0cbbad439b28e0eb554ec840a3c8bee3c551340c3ad5d3efd5273cbf4ad46deaac3afb
+  metadata.gz: c2d875e00eaf8440b82c7a9173dbf23a708aabb49157bd960c7c7a94e715ba6429b43864f6b168b2e8fe1c3daa8743a76e6662f02fdf0db86e59e5af585b7b1d
+  data.tar.gz: 166c8ecb0f9f850e682eba2181ba6187321428fcee4f9dd1e707a6791ee8b5da3d422aef3c404d5d8a175d3601c0fc6388bb8c995dd72c6353a3628886a0ea81

data/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+on: [push, pull_request]
+
+jobs:
+  # This matrix job runs the test suite against multiple Ruby versions
+  test_matrix:
+    strategy:
+      fail-fast: false
+      matrix:
+        # Due to https://github.com/actions/runner/issues/849, we have to use quotes for '3.0'
+        ruby: [ 2.7, '3.0', 3.1 ]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Clone govuk-content-schemas
+        uses: actions/checkout@v2
+        with:
+          repository: alphagov/govuk-content-schemas
+          ref: deployed-to-production
+          path: tmp/govuk-content-schemas
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rake
+        env:
+          GOVUK_CONTENT_SCHEMAS_PATH: tmp/govuk-content-schemas
+
+  # Branch protection rules cannot directly depend on status checks from matrix jobs.
+  # So instead we define `test` as a dummy job which only runs after the preceding `test_matrix` checks have passed.
+  # Solution inspired by: https://github.community/t/status-check-for-a-matrix-jobs/127354/3
+  test:
+    needs: test_matrix
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "All matrix tests have passed 🚀"
+
+  publish:
+    needs: test
+    if: ${{ github.ref == 'refs/heads/main' }}
+    permissions:
+      contents: write
+    uses: alphagov/govuk-infrastructure/.github/workflows/publish-rubygem.yaml@main
+    secrets:
+      GEM_HOST_API_KEY: ${{ secrets.ALPHAGOV_RUBYGEMS_API_KEY }}

data/.ruby-version

@@ -1 +1 @@
-2.6.6
+2.7.6

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# 4.4.0
+
+* Adds support for applications that use Minitest by adding an `AssertMatchers` module ([#66](https://github.com/alphagov/govuk_schemas/pull/66))
+
+# 4.3.0
+
+* Generate unique items for arrays with the "uniqueItems" property. ([#63](https://github.com/alphagov/govuk_schemas/pull/63))
+
+# 4.2.0
+
+* Add support for generating random HH:MM time strings that match a regex. ([#62](https://github.com/alphagov/govuk_schemas/pull/62))
+
 # 4.1.1
 
 * Fix RandomSchemaGenerator.new always returning equivalent generators ([#60](https://github.com/alphagov/govuk_schemas/pull/60))

data/govuk_schemas.gemspec

@@ -24,7 +24,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "pry-byebug"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.4"
-  spec.add_development_dependency "rubocop-govuk", "~> 3.8"
+  spec.add_development_dependency "rubocop-govuk", "~> 4.0"
   spec.add_development_dependency "yard", "~> 0.8"
 
   spec.required_ruby_version = ">= 2.6"

data/lib/govuk_schemas/assert_matchers.rb

@@ -0,0 +1,28 @@
+require "govuk_schemas/validator"
+
+module GovukSchemas
+  module AssertMatchers
+    def assert_valid_against_publisher_schema(payload, schema_name)
+      assert_valid_against_schema(payload, schema_name, "publisher")
+    end
+
+    def assert_valid_against_links_schema(payload, schema_name)
+      assert_valid_against_schema(payload, schema_name, "links")
+    end
+
+    def assert_valid_against_frontend_schema(payload, schema_name)
+      assert_valid_against_schema(payload, schema_name, "frontend")
+    end
+
+    def assert_valid_against_notification_schema(payload, schema_name)
+      assert_valid_against_schema(payload, schema_name, "notification")
+    end
+
+  private
+
+    def assert_valid_against_schema(payload, schema_name, schema_type)
+      validator = GovukSchemas::Validator.new(schema_name, schema_type, payload)
+      assert validator.valid?, validator.error_message
+    end
+  end
+end

data/lib/govuk_schemas/random_content_generator.rb

@@ -81,6 +81,8 @@ module GovukSchemas
         Date.today.iso8601
       when "^[1-9][0-9]{3}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[0-1])$"
         Date.today.iso8601
+      when "^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$"
+        Time.now.strftime("%H:%m")
       when "^#.+$"
         anchor
       when "[a-z-]"

data/lib/govuk_schemas/random_schema_generator.rb

@@ -116,12 +116,27 @@ module GovukSchemas
     def generate_random_array(props)
       min = props["minItems"] || 0
       max = props["maxItems"] || 10
+      unique = props["uniqueItems"] == true
       num_items = @random.rand(min..max)
+      items = []
+      attempts = 0
+      max_attempts = num_items * 100
 
-      num_items.times.map do
+      until items.length == num_items
         # sometimes arrays don't have `items` specified, not sure if this is a bug
-        generate_value(props["items"] || {})
+        new_value = generate_value(props["items"] || {})
+
+        if unique && items.include?(new_value)
+          attempts += 1
+          raise "Failed to create a unique array item after #{max_attempts} attempts" if attempts >= max_attempts
+          next
+        end
+
+        attempts = 0
+        items << new_value
       end
+
+      items
     end
 
     def generate_random_string(props)

data/lib/govuk_schemas/rspec_matchers.rb

@@ -1,57 +1,20 @@
+require "govuk_schemas/validator"
+
 module GovukSchemas
   module RSpecMatchers
+
     %w[links frontend publisher notification].each do |schema_type|
       RSpec::Matchers.define "be_valid_against_#{schema_type}_schema".to_sym do |schema_name|
         match do |item|
-          schema = Schema.find(Hash["#{schema_type}_schema".to_sym, schema_name])
-          validator = JSON::Validator.fully_validate(schema, item)
-          validator.empty?
+          @validator = GovukSchemas::Validator.new(schema_name, schema_type, item)
+          @validator.valid?
         end
 
+
         failure_message do |actual|
-          ValidationErrorMessage.new(schema_name, "schema", actual).message
+          @validator.error_message
         end
       end
     end
   end
-
-  # @private
-  class ValidationErrorMessage
-    attr_reader :schema_name, :type, :payload
-
-    def initialize(schema_name, type, payload)
-      @schema_name = schema_name
-      @type = type
-      @payload = payload
-    end
-
-    def message
-      <<~DOC
-        expected the payload to be valid against the '#{schema_name}' schema:
-
-        #{formatted_payload}
-
-        Validation errors:
-        #{errors}
-      DOC
-    end
-
-  private
-
-    def errors
-      schema = Schema.find(publisher_schema: schema_name)
-      validator = JSON::Validator.fully_validate(schema, payload)
-      validator.map { |message| "- " + humanized_error(message) }.join("\n")
-    end
-
-    def formatted_payload
-      return payload if payload.is_a?(String)
-
-      JSON.pretty_generate(payload)
-    end
-
-    def humanized_error(message)
-      message.gsub("The property '#/'", "The item")
-    end
-  end
 end

data/lib/govuk_schemas/validator.rb

@@ -0,0 +1,46 @@
+module GovukSchemas
+  class Validator
+    attr_reader :schema_name, :type, :payload
+
+    def initialize(schema_name, type, payload)
+      @schema_name = schema_name
+      @type = type
+      @payload = payload
+    end
+
+    def valid?
+      errors.empty?
+    end
+
+    def error_message
+      <<~DOC
+        expected the payload to be valid against the '#{schema_name}' schema:
+
+        #{formatted_payload}
+
+        Validation errors:
+        #{errors}
+      DOC
+    end
+
+  private
+
+    def errors
+      schema = Schema.find("#{type}_schema": schema_name)
+      validator = JSON::Validator.fully_validate(schema, payload.to_json)
+      validator.map { |message| "- " + humanized_error(message) }.join("\n")
+    end
+
+    def formatted_payload
+      return payload if payload.is_a?(String)
+
+      JSON.pretty_generate(payload)
+    end
+
+    def humanized_error(message)
+      message.gsub("The property '#/'", "The item")
+             .gsub(/in schema [0-9a-f\-]+/, "")
+             .strip
+    end
+  end
+end

data/lib/govuk_schemas/version.rb

@@ -1,4 +1,4 @@
 module GovukSchemas
   # @private
-  VERSION = "4.1.1".freeze
+  VERSION = "4.4.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_schemas
 version: !ruby/object:Gem::Version
-  version: 4.1.1
+  version: 4.4.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-08-17 00:00:00.000000000 Z
+date: 2022-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json-schema
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.8'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.8'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -102,6 +102,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/dependabot.yml"
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -109,13 +110,13 @@ files:
 - ".yardopts"
 - CHANGELOG.md
 - Gemfile
-- Jenkinsfile
 - LICENSE.md
 - README.md
 - Rakefile
 - bin/console
 - govuk_schemas.gemspec
 - lib/govuk_schemas.rb
+- lib/govuk_schemas/assert_matchers.rb
 - lib/govuk_schemas/document_types.rb
 - lib/govuk_schemas/example.rb
 - lib/govuk_schemas/random_content_generator.rb
@@ -123,6 +124,7 @@ files:
 - lib/govuk_schemas/random_schema_generator.rb
 - lib/govuk_schemas/rspec_matchers.rb
 - lib/govuk_schemas/schema.rb
+- lib/govuk_schemas/validator.rb
 - lib/govuk_schemas/version.rb
 homepage: https://github.com/alphagov/govuk_schemas_gem
 licenses:
@@ -143,7 +145,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.3.18
 signing_key: 
 specification_version: 4
 summary: Gem to generate test data based on GOV.UK content schemas

data/Jenkinsfile

@@ -1,9 +0,0 @@
-#!/usr/bin/env groovy
-
-library("govuk")
-
-node {
-  govuk.buildProject(
-    rubyLintDiff: false,
-  )
-}