karafka 2.0.0.alpha1 → 2.0.0.alpha4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a441a124346099aa31fb36a2241c2abfbc242ab6f3f9ad197b82d8786e78232e
-  data.tar.gz: 81a706d58e469ecc48759dfe28c30e3779baab848122b72c194c30e06a7cdd7d
+  metadata.gz: f8ed5005d3288abb4f9f6389fa126b5434b5a7a6df729e924695d38624e167e5
+  data.tar.gz: aa802a441d9c9cb1275260ba9b290c8c4c72acf125ca72efaafc58538a6c8b20
 SHA512:
-  metadata.gz: bf9ebff340150913cf273bc3f09c9f3dd3c02e6ffe427fd00ead842995e5f146d554609cd1ff4d1039ee96ef349b8e7712e2c557abc322a9e0300886bc765b6a
-  data.tar.gz: 054cf8240a33a133c2c9dce5f1c3c2ac26877006c8a823c1e58c903fccd8cac7c31b5d0c0d2ec22257d8959d40bb69d49bf5676f378c33004807a78413278b3e
+  metadata.gz: 1ad458acdb42c28d04895db1aa348d0ab10177c0829e7b19fc9fd8b23aaac5fc17feac5e1366cd6444d1e60903b087be1b24298b7764a98f8f372a325afb7cee
+  data.tar.gz: fb1de540a2c50d26467585bb720a636726955e65f1cea1ca055ef4a9f10d66db233928ca8b067d225d6c935f779d50f2381660ddcaa0d86d6c5b0b8a8ed991e1

data/.github/workflows/ci.yml

@@ -113,6 +113,7 @@ jobs:
       - name: Install latest Bundler
         run: |
           gem install bundler --no-document
+          gem update --system --no-document
           bundle config set without 'tools benchmarks docs'
 
       - name: Bundle install
@@ -122,5 +123,6 @@ jobs:
 
       - name: Run integration tests
         env:
+          KARAFKA_PRO_LICENSE_TOKEN: ${{ secrets.KARAFKA_PRO_LICENSE_TOKEN }}
           GITHUB_COVERAGE: ${{matrix.coverage}}
-        run: bundle exec bin/integrations
+        run: bin/integrations

data/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Karafka framework changelog
 
-## 2.0.0-alpha1 (Unreleased)
+## 2.0.0-alpha4 (Unreleased)
+- Rails support without ActiveJob queue adapter usage (#805)
+
+## 2.0.0-alpha3 (2022-03-16)
+- Restore 'app.initialized' state and add notification on it
+- Fix the installation flow for Rails and add integration tests for this scenario
+- Add more integration tests covering some edge cases
+
+## 2.0.0-alpha2 (2022-02-19)
+- Require `kafka` keys to be symbols
+- Added ActiveJob Pro adapter
+- Small updates to the license and docs
+
+## 2.0.0-alpha1 (2022-01-30)
 - Change license to `LGPL-3.0`
 - Introduce a Pro subscription
 - Switch from `ruby-kafka` to `librdkafka` as an underlying driver

data/CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 ## Introduction
 
-First, thank you for considering contributing to karafka! It's people like you that make the open source community such a great community! 😊
+First, thank you for considering contributing to the Karafka ecosystem! It's people like you that make the open source community such a great community! 😊
 
 We welcome any type of contribution, not only code. You can help with:
 - **QA**: file bug reports, the more details you can give the better (e.g. screenshots with the console open)
@@ -18,15 +18,17 @@ Working on your first Pull Request? You can learn how from this *free* series, [
 
 Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it. The pull request should also contain tests.
 
-## Code review process
+### Code review process
 
 Each pull request must pass all the rspec specs and meet our quality requirements.
 
 To check if everything is as it should be, we use [Coditsu](https://coditsu.io) that combines multiple linters and code analyzers for both code and documentation. Once you're done with your changes, submit a pull request.
 
-Coditsu will automatically check your work against our quality standards. You can find your commit check results on the [builds page](https://app.coditsu.io/karafka/commit_builds) of Karafka organization.
+### Contributing to Pro components
 
-[![coditsu](https://coditsu.io/assets/quality_bar.svg)](https://app.coditsu.io/karafka/commit_builds)
+All of Karafka components are open-source. However, the `Pro` components are licenses under `LICENSE-COMM`.
+
+By sending a pull request to the pro components, you are agreeing to transfer the copyright of your code to Maciej Mensfeld.
 
 ## Questions
 
@@ -35,7 +37,5 @@ You can also reach us at hello@karafka.opencollective.com.
 
 ## Credits
 
-### Contributors
-
 Thank you to all the people who have already contributed to karafka!
 <a href="graphs/contributors"><img src="https://opencollective.com/karafka/contributors.svg?width=890" /></a>

data/Gemfile.lock

@@ -1,22 +1,22 @@
 PATH
   remote: .
   specs:
-    karafka (2.0.0.pre.alpha1)
+    karafka (2.0.0.alpha4)
       dry-configurable (~> 0.13)
       dry-monitor (~> 0.5)
       dry-validation (~> 1.7)
       rdkafka (>= 0.10)
       thor (>= 0.20)
-      waterdrop (>= 2.1.0, < 3.0.0)
+      waterdrop (>= 2.2.0, < 3.0.0)
       zeitwerk (~> 2.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activejob (7.0.1)
-      activesupport (= 7.0.1)
+    activejob (7.0.2.2)
+      activesupport (= 7.0.2.2)
       globalid (>= 0.3.6)
-    activesupport (7.0.1)
+    activesupport (7.0.2.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
@@ -45,7 +45,7 @@ GEM
       dry-configurable (~> 0.13, >= 0.13.0)
       dry-core (~> 0.5, >= 0.5)
       dry-events (~> 0.2)
-    dry-schema (1.8.0)
+    dry-schema (1.9.1)
       concurrent-ruby (~> 1.0)
       dry-configurable (~> 0.13, >= 0.13.0)
       dry-core (~> 0.5, >= 0.5)
@@ -58,49 +58,49 @@ GEM
       dry-core (~> 0.5, >= 0.5)
       dry-inflector (~> 0.1, >= 0.1.2)
       dry-logic (~> 1.0, >= 1.0.2)
-    dry-validation (1.7.0)
+    dry-validation (1.8.0)
       concurrent-ruby (~> 1.0)
       dry-container (~> 0.7, >= 0.7.1)
       dry-core (~> 0.5, >= 0.5)
       dry-initializer (~> 3.0)
-      dry-schema (~> 1.8, >= 1.8.0)
+      dry-schema (~> 1.9, >= 1.9.1)
     factory_bot (6.2.0)
       activesupport (>= 5.0.0)
     ffi (1.15.5)
     globalid (1.0.0)
       activesupport (>= 5.0)
-    i18n (1.9.1)
+    i18n (1.10.0)
       concurrent-ruby (~> 1.0)
-    mini_portile2 (2.7.1)
+    mini_portile2 (2.8.0)
     minitest (5.15.0)
     rake (13.0.6)
     rdkafka (0.11.1)
       ffi (~> 1.15)
       mini_portile2 (~> 2.6)
       rake (> 12)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.2)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.2)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.3)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.3)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
     simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.12.3)
-    simplecov_json_formatter (0.1.3)
+    simplecov_json_formatter (0.1.4)
     thor (1.2.1)
     tzinfo (2.0.4)
       concurrent-ruby (~> 1.0)
-    waterdrop (2.1.0)
+    waterdrop (2.2.0)
       concurrent-ruby (>= 1.1)
       dry-configurable (~> 0.13)
       dry-monitor (~> 0.5)
@@ -121,4 +121,4 @@ DEPENDENCIES
   simplecov
 
 BUNDLED WITH
-   2.3.5
+   2.3.7

data/LICENSE

@@ -9,6 +9,9 @@ Karafka has also commercial-friendly license, commercial support and commercial
 All of the commercial components are present in the lib/karafka/pro directory of this repository
 and their usage requires commercial license agreement.
 
+By sending a pull request to the pro components, you are agreeing to transfer the copyright of your
+code to Maciej Mensfeld.
+
 You can find the commercial license in LICENSE-COM.
 
 Please see https://karafka.io for purchasing options.

data/bin/integrations

@@ -2,9 +2,15 @@
 
 # Runner to run integration specs in parallel
 
+# Part of integration specs run pristine without bundler.
+# If we would run bundle exec when running this code, bundler would inject its own context
+# into them, messing things up heavily
+raise 'This code needs to be executed WITHOUT bundle exec' if Kernel.const_defined?(:Bundler)
+
 require 'open3'
 require 'fileutils'
 require 'pathname'
+require 'tmpdir'
 
 ROOT_PATH = Pathname.new(File.expand_path(File.join(File.dirname(__FILE__), '../')))
 
@@ -13,13 +19,13 @@ IntegrationTestError = Class.new(StandardError)
 
 # How many child processes with integration specs do we want to run in parallel
 # When the value is high, there's a problem with thread allocation on Github
-CONCURRENCY = 5
+CONCURRENCY = 4
 
 # Abstraction around a single test scenario execution process
 class Scenario
   # How long a scenario can run before we kill it
   # This is a fail-safe just in case something would hang
-  MAX_RUN_TIME = 60 * 5
+  MAX_RUN_TIME = 60 * 2
 
   # There are rare cases where Karafka may force shutdown for some of the integration cases
   # This includes exactly those
@@ -38,9 +44,7 @@ class Scenario
   # @param path [String] path to the scenarios file
   def initialize(path)
     @path = path
-    @stdin, @stdout, @stderr, @wait_thr = Open3.popen3(
-      "bundle exec ruby -r ./spec/integrations_helper.rb #{path}"
-    )
+    @stdin, @stdout, @stderr, @wait_thr = Open3.popen3(init_and_build_cmd)
     @started_at = current_time
     # Last 1024 characters from stdout
     @stdout_tail = ''
@@ -102,6 +106,35 @@ class Scenario
 
   private
 
+  # Sets up a proper environment for a given spec to run and returns the run command
+  # @return [String] run command
+  def init_and_build_cmd
+    scenario_dir = File.dirname(@path)
+
+    # If there is a Gemfile in a scenario directory, it means it is a pristine spec and we need
+    # to run bundle install, etc in order to run it
+    if File.exist?(File.join(scenario_dir, 'Gemfile'))
+      # We copy the spec into a temp dir, not to pollute the spec location with logs, etc
+      temp_dir = Dir.mktmpdir
+      file_name = File.basename(@path)
+
+      FileUtils.cp_r("#{scenario_dir}/.", temp_dir)
+
+      <<~CMD
+        cd #{temp_dir} &&
+        KARAFKA_GEM_DIR=#{ROOT_PATH} \
+        BUNDLE_AUTO_INSTALL=true \
+        PRISTINE_MODE=true \
+        bundle exec ruby -r #{ROOT_PATH}/spec/integrations_helper.rb #{file_name}
+      CMD
+    else
+      <<~CMD
+        KARAFKA_GEM_DIR=#{ROOT_PATH} \
+        bundle exec ruby -r ./spec/integrations_helper.rb #{@path}
+      CMD
+    end
+  end
+
   # @return [Float] current machine time
   def current_time
     Process.clock_gettime(Process::CLOCK_MONOTONIC)
@@ -136,10 +169,13 @@ end
 # Load all the specs
 specs = Dir[ROOT_PATH.join('spec/integrations/**/*.rb')]
 
-# If filter is provided, apply
-specs.delete_if { |name| !name.include?(ARGV[0]) } if ARGV[0]
+# If filters is provided, apply
+# Allows to provide several filters one after another and applies all of them
+ARGV.each do |filter|
+  specs.delete_if { |name| !name.include?(filter) }
+end
 
-raise ArgumentError, "No integration specs with filter: #{ARGV[0]}" if specs.empty?
+raise ArgumentError, "No integration specs with filters: #{ARGV.join(', ')}" if specs.empty?
 
 # Randomize order
 seed = (ENV['SEED'] || rand(0..10_000)).to_i

data/bin/karafka

@@ -2,6 +2,10 @@
 
 require 'karafka'
 
+# We set this to indicate, that the process in which we are (whatever it does) was started using
+# our bin/karafka cli
+ENV['KARAFKA_CLI'] = 'true'
+
 # If there is a boot file, we need to require it as we expect it to contain
 # Karafka app setup, routes, etc
 if File.exist?(Karafka.boot_file)

data/bin/stress

@@ -9,5 +9,5 @@ set -e
 while :
 do
   reset
-  bundle exec bin/integrations $1
+  bin/integrations $1
 done

data/config/errors.yml

@@ -5,3 +5,4 @@ en:
       topics_names_not_unique: all topic names within a single consumer group must be unique
       required_usage_count: Given topic must be used at least once
       consumer_groups_inclusion: Unknown consumer group
+      kafka_key_must_be_a_symbol: All keys under the kafka settings scope need to be symbols

data/docker-compose.yml

@@ -16,6 +16,7 @@ services:
       KAFKA_CREATE_TOPICS:
         "integrations_0_03:3:1,\
          integrations_1_03:3:1,\
+         integrations_2_03:3:1,\
          integrations_0_10:10:1,\
          integrations_1_10:10:1,\
          benchmarks_0_01:1:1,\

data/karafka.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'dry-validation', '~> 1.7'
   spec.add_dependency 'rdkafka', '>= 0.10'
   spec.add_dependency 'thor', '>= 0.20'
-  spec.add_dependency 'waterdrop', '>= 2.1.0', '< 3.0.0'
+  spec.add_dependency 'waterdrop', '>= 2.2.0', '< 3.0.0'
   spec.add_dependency 'zeitwerk', '~> 2.3'
 
   spec.required_ruby_version = '>= 2.6.0'

data/lib/active_job/karafka.rb

@@ -1,18 +1,21 @@
 # frozen_string_literal: true
 
-require 'active_job'
-require 'active_job/queue_adapters'
-require 'active_job/consumer'
-require 'active_job/routing_extensions'
-require 'active_job/queue_adapters/karafka_adapter'
+begin
+  require 'active_job'
+  require_relative 'queue_adapters/karafka_adapter'
 
-module ActiveJob
-  # Namespace for usage simplification outside of Rails where Railtie will not kick in.
-  # That way a require 'active_job/karafka' should be enough to use it
-  module Karafka
+  module ActiveJob
+    # Namespace for usage simplification outside of Rails where Railtie will not kick in.
+    # That way a require 'active_job/karafka' should be enough to use it
+    module Karafka
+    end
   end
-end
 
-# We extend routing builder by adding a simple wrapper for easier jobs topics defining
-::Karafka::Routing::Builder.include ActiveJob::RoutingExtensions
-::Karafka::Routing::Proxy.include ActiveJob::RoutingExtensions
+  # We extend routing builder by adding a simple wrapper for easier jobs topics defining
+  # This needs to be extended here as it is going to be used in karafka routes, hence doing that in
+  # the railtie initializer would be too late
+  ::Karafka::Routing::Builder.include ::Karafka::ActiveJob::RoutingExtensions
+  ::Karafka::Routing::Proxy.include ::Karafka::ActiveJob::RoutingExtensions
+rescue LoadError
+  # We extend ActiveJob stuff in the railtie
+end

data/lib/active_job/queue_adapters/karafka_adapter.rb

@@ -5,16 +5,13 @@ module ActiveJob
   # ActiveJob queue adapters
   module QueueAdapters
     # Karafka adapter for enqueuing jobs
+    # This is here for ease of integration with ActiveJob.
     class KarafkaAdapter
-      # Enqueues the job by sending all the payload to a dedicated topic in Kafka that will be
-      # later on consumed by a special ActiveJob consumer
+      # Enqueues the job using the configured dispatcher
       #
       # @param job [Object] job that should be enqueued
       def enqueue(job)
-        ::Karafka.producer.produce_async(
-          topic: job.queue_name,
-          payload: ActiveSupport::JSON.encode(job.serialize)
-        )
+        ::Karafka::App.config.internal.active_job.dispatcher.call(job)
       end
 
       # Raises info, that Karafka backend does not support scheduling jobs

data/lib/karafka/active_job/consumer.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Karafka
+  module ActiveJob
+    # This is the consumer for ActiveJob that eats the messages enqueued with it one after another.
+    # It marks the offset after each message, so we make sure, none of the jobs is executed twice
+    class Consumer < ::Karafka::BaseConsumer
+      # Executes the ActiveJob logic
+      # @note ActiveJob does not support batches, so we just run one message after another
+      def consume
+        messages.each do |message|
+          ::ActiveJob::Base.execute(
+            # We technically speaking could set this as deserializer and reference it from the
+            # message instead of using the `#raw_payload`. This is not done on purpose to simplify
+            # the ActiveJob setup here
+            ::ActiveSupport::JSON.decode(message.raw_payload)
+          )
+
+          mark_as_consumed(message)
+        end
+      end
+    end
+  end
+end

data/lib/karafka/active_job/dispatcher.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Karafka
+  module ActiveJob
+    # Dispatcher that sends the ActiveJob job to a proper topic based on the queue name
+    class Dispatcher
+      # Defaults for dispatching
+      # The can be updated by using `#karafka_options` on the job
+      DEFAULTS = {
+        dispatch_method: :produce_async
+      }.freeze
+
+      private_constant :DEFAULTS
+
+      # @param job [ActiveJob::Base] job
+      def call(job)
+        ::Karafka.producer.public_send(
+          fetch_option(job, :dispatch_method, DEFAULTS),
+          topic: job.queue_name,
+          payload: ::ActiveSupport::JSON.encode(job.serialize)
+        )
+      end
+
+      private
+
+      # @param job [ActiveJob::Base] job
+      # @param key [Symbol] key we want to fetch
+      # @param defaults [Hash]
+      # @return [Object] options we are interested in
+      def fetch_option(job, key, defaults)
+        job
+          .class
+          .karafka_options
+          .fetch(key, defaults.fetch(key))
+      end
+    end
+  end
+end

data/lib/karafka/active_job/job_extensions.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Karafka
+  module ActiveJob
+    # Allows for setting karafka specific options in ActiveJob jobs
+    module JobExtensions
+      class << self
+        # Defines all the needed accessors and sets defaults
+        # @param klass [ActiveJob::Base] active job base
+        def extended(klass)
+          klass.class_attribute :_karafka_options
+          klass._karafka_options = {}
+        end
+      end
+
+      # @param new_options [Hash] additional options that allow for jobs Karafka related options
+      #   customization
+      # @return [Hash] karafka options
+      def karafka_options(new_options = {})
+        return _karafka_options if new_options.empty?
+
+        # Make sure, that karafka options that someone wants to use are valid before assigning
+        # them
+        App.config.internal.active_job.job_options_contract.validate!(new_options)
+
+        new_options.each do |name, value|
+          _karafka_options[name] = value
+        end
+
+        _karafka_options
+      end
+    end
+  end
+end

data/lib/karafka/active_job/job_options_contract.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Karafka
+  module ActiveJob
+    # Contract for validating the options that can be altered with `#karafka_options` per job class
+    # @note We keep this in the `Karafka::ActiveJob` namespace instead of `Karafka::Contracts` as
+    #   we want to keep ActiveJob related Karafka components outside of the core Karafka code and
+    #   all in the same place
+    class JobOptionsContract < Contracts::Base
+      params do
+        optional(:dispatch_method).value(included_in?: %i[produce_async produce_sync])
+      end
+    end
+  end
+end

data/lib/karafka/active_job/routing_extensions.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Karafka
+  # ActiveJob related Karafka stuff
+  module ActiveJob
+    # Routing extensions for ActiveJob
+    module RoutingExtensions
+      # This method simplifies routes definition for ActiveJob topics / queues by auto-injecting
+      # the consumer class
+      # @param name [String, Symbol] name of the topic where ActiveJobs jobs should go
+      def active_job_topic(name)
+        topic(name) do
+          consumer App.config.internal.active_job.consumer
+        end
+      end
+    end
+  end
+end

data/lib/karafka/app.rb

@@ -36,6 +36,7 @@ module Karafka
         logger
         producer
         monitor
+        pro?
       ].each do |delegated|
         define_method(delegated) do
           Karafka.send(delegated)

data/lib/karafka/cli/info.rb

@@ -31,9 +31,9 @@ module Karafka
       def core_info
         config = Karafka::App.config
 
-        postfix = config.license.token ? ' + Pro' : ''
+        postfix = Karafka.pro? ? ' + Pro' : ''
 
-        info = [
+        [
           "Karafka version: #{Karafka::VERSION}#{postfix}",
           "Ruby version: #{RUBY_VERSION}",
           "Rdkafka version: #{::Rdkafka::VERSION}",
@@ -49,7 +49,7 @@ module Karafka
       def license_info
         config = Karafka::App.config
 
-        if config.license.token
+        if Karafka.pro?
           [
             'License: Commercial',
             "License entity: #{config.license.entity}",

data/lib/karafka/cli/install.rb

@@ -14,6 +14,7 @@ module Karafka
         app/consumers
         config
         log
+        lib
       ].freeze
 
       # Where should we map proper files from templates

data/lib/karafka/cli/server.rb

@@ -5,11 +5,6 @@ module Karafka
   class Cli < Thor
     # Server Karafka Cli action
     class Server < Base
-      # Server config settings contract
-      CONTRACT = Contracts::ServerCliOptions.new.freeze
-
-      private_constant :CONTRACT
-
       desc 'Start the Karafka server (short-cut alias: "s")'
       option aliases: 's'
       option :consumer_groups, type: :array, default: nil, aliases: :g
@@ -19,7 +14,7 @@ module Karafka
         # Print our banner and info in the dev mode
         print_marketing_info if Karafka::App.env.development?
 
-        validate!
+        Contracts::ServerCliOptions.new.validate!(cli.options)
 
         # We assign active topics on a server level, as only server is expected to listen on
         # part of the topics
@@ -34,7 +29,7 @@ module Karafka
       def print_marketing_info
         Karafka.logger.info Info::BANNER
 
-        if Karafka::App.config.license.token
+        if Karafka.pro?
           Karafka.logger.info(
             "\033[0;32mThank you for investing in the Karafka Pro subscription!\033[0m\n"
           )
@@ -44,15 +39,6 @@ module Karafka
           )
         end
       end
-
-      # Checks the server cli configuration
-      # options validations in terms of app setup (topics, pid existence, etc)
-      def validate!
-        result = CONTRACT.call(cli.options)
-        return if result.success?
-
-        raise Errors::InvalidConfigurationError, result.errors.to_h
-      end
     end
   end
 end

data/lib/karafka/contracts/base.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Karafka
+  module Contracts
+    # Base contract for all Karafka contracts
+    class Base < Dry::Validation::Contract
+      config.messages.load_paths << File.join(Karafka.gem_root, 'config', 'errors.yml')
+
+      # @param data [Hash] data for validation
+      # @return [Boolean] true if all good
+      # @raise [Errors::InvalidConfigurationError] invalid configuration error
+      # @note We use contracts only in the config validation context, so no need to add support
+      #   for multiple error classes. It will be added when it will be needed.
+      def validate!(data)
+        result = call(data)
+
+        return true if result.success?
+
+        raise Errors::InvalidConfigurationError, result.errors.to_h
+      end
+    end
+  end
+end