publishing_platform_schemas 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b9908506b494629e6db1c0e9f7913926bb57d7e7bba972b9cca8f688ee48a3f
-  data.tar.gz: ae8b12485e1e19ad35971943ca96b50b4703b43d6e16aebcfbb904fa2ab670f9
+  metadata.gz: 755a92ec42192fb7a5b02beea49d15893f45fa79c1cb64a30da56eb8e635fa7e
+  data.tar.gz: 778ba197d377bd32b434821a0283cbef9245803e3ad964650a51eb487c848d94
 SHA512:
-  metadata.gz: 12f1ac7e89d3353f4f83a1f95629022c19328ac7d8942dd95914d7447ef3b2832b1ec89351f12e05300a1bd70698c4b823de8b9c69775957ba58b2c7c6fb9ab4
-  data.tar.gz: c8da8abc17516ec011c1fa469080b6955513b1b0cc36bbba3a28ac16cbbe40c09851b7573b7e1fa234913869c17960d0972c107887f29de6959113ba12c8c6c6
+  metadata.gz: 1e76d0bf70f0711d91cc7b1313157567dd8f6b0f4118cd453f56f0f488c8013335c64cd737648276d3ab9ec3a89afe8d140a7c7ebbf9a9efa1b317b79077e671
+  data.tar.gz: b5baf59cbb570a6d6276193aafb71534aa6265787691b83f890aeb5bab2b1dc6672142a7aec26402c4e74c76be17d3b5b7a7db186fb1c4bc2c4e05137a4b287b

data/lib/publishing_platform_schemas/rspec_matchers.rb

@@ -0,0 +1,16 @@
+require "publishing_platform_schemas/validator"
+
+module PublishingPlatformSchemas
+  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|
+          @validator = PublishingPlatformSchemas::Validator.new(schema_name, schema_type, item)
+          @validator.valid?
+        end
+
+        failure_message { @validator.error_message }
+      end
+    end
+  end
+end

data/lib/publishing_platform_schemas/validator.rb

@@ -0,0 +1,53 @@
+require "json-schema"
+
+module PublishingPlatformSchemas
+  class Validator
+    attr_reader :schema_name, :type
+    attr_accessor :payload
+
+    def initialize(schema_name, type, payload)
+      @schema_name = schema_name
+      @type = type
+      @payload = ensure_json(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)
+      validator.map { |message| "- #{humanized_error(message)}" }.join("\n")
+    end
+
+    def formatted_payload
+      JSON.pretty_generate(JSON.parse(payload))
+    end
+
+    def humanized_error(message)
+      message.gsub("The property '#/'", "The item")
+             .gsub(/in schema [0-9a-f-]+/, "")
+             .strip
+    end
+
+    def ensure_json(payload)
+      return payload if payload.is_a?(String)
+
+      payload.to_json
+    end
+  end
+end

data/lib/publishing_platform_schemas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PublishingPlatformSchemas
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: publishing_platform_schemas
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Publishing Platform
 bindir: exe
 cert_chain: []
-date: 2025-04-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json-schema
@@ -90,7 +90,9 @@ files:
 - bin/setup
 - lib/publishing_platform_schemas.rb
 - lib/publishing_platform_schemas/example.rb
+- lib/publishing_platform_schemas/rspec_matchers.rb
 - lib/publishing_platform_schemas/schema.rb
+- lib/publishing_platform_schemas/validator.rb
 - lib/publishing_platform_schemas/version.rb
 - publishing_platform_schemas.gemspec
 licenses:
@@ -110,7 +112,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.6.8
 specification_version: 4
 summary: Gem to work with the Publishing Platform content schemas
 test_files: []