route_mechanic 0.1.3 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a45e646ff04b613cb52b102ff6d47ef3b02750fe4455eab2d081e549c37313f
-  data.tar.gz: 4df4c8d6bc5dee7e15338a93e1a8f1f468e3e76dd7299b80baf14922322ca0bd
+  metadata.gz: e4d643087563c01295174f882a886446ba15b126b9ffc246cc103e74335cc27e
+  data.tar.gz: 2ed8325e9e17e218c1725888efb4650b88463121e9e42f21a44c03beda353484
 SHA512:
-  metadata.gz: f2dbdb3b471fc9d47686fb4b924f3a32843a3d5dce778a64706fe72b4127a84cdaa09dcc3b0bc2527ff6b6b77b393d8af5124595bd62d17fc10651e82fef2978
-  data.tar.gz: b47585e146f2e8aa6af03802794c3cb8206057adb216fb54581871baba4a820b0103bfbe45885491de8aaaf0f54c52279885ff1fef30fa58c585cd743c3434f6
+  metadata.gz: 97cc4c279d3ea1839712644ff72bb1001930d7d5c443ceb9243303b5d82232e1a2344f945e3405c5cfa6f5aa4b34f0e22d9b006edf4b1fa48decbe8c83e949f6
+  data.tar.gz: 030e9d9ba5d922910c0641be0ae20d97e960085bdbd4385982a281d05ba4078a01593bde6570d54357e8f2a28ee8a1986f2f43cb1cbf87ac1bfa36e0ba690346

data/.github/workflows/test.yml

@@ -23,11 +23,11 @@ jobs:
       fail-fast: false
       matrix:
         ruby:
-          - ruby:2.3
           - ruby:2.4
           - ruby:2.5
           - ruby:2.6
           - ruby:2.7
+          - ruby:3.0
           - rubylang/ruby:master-nightly-bionic
         test_framework:
           - rspec

data/.gitignore

@@ -10,3 +10,4 @@
 /fixtures/fake_app/log/
 /fixtures/fake_app/tmp/
 /.rspec_status
+/.byebug_history

data/Gemfile

@@ -7,3 +7,4 @@ gem "rake", "~> 12.0"
 gem "minitest", "~> 5.0"
 gem "rspec", "~> 3.0"
 gem "rails"
+gem "byebug"

data/README.md

@@ -2,7 +2,7 @@
 [![Gem Version](https://badge.fury.io/rb/route_mechanic.svg)](https://badge.fury.io/rb/route_mechanic)
 [![Build Status](https://github.com/ohbarye/route_mechanic/workflows/test/badge.svg?branch=master)](https://github.com/ohbarye/route_mechanic/actions?query=workflow%3Atest)
 
-No need to maintain Rails' routing tests manually. RouteMechanic automatically detects broken routes and missing action methods in controller once you've finished installation.
+No need to maintain Rails' routing tests manually. RouteMechanic automatically detects broken routes and missing action methods in controllers once you've finished installation.
 
 ## Installation
 
@@ -24,11 +24,16 @@ $ bundle install
 
 RouteMechanic is available for both RSpec and MiniTest.
 
-All you have to do is to add just one test case that keeps your application's routes not broken.
+All you have to do is to add just one test case that keeps your application's routes not broken. Then, RouteMechanic will get to report 2 types of broken routes.
+
+1. Unused actions
+    - Your application has the controller and the action method but `config/routes.rb` doesn't have corresponding settings.
+2. Unused routes
+    - Your application's `config/routes.rb` has a routing declaration but no controller has a corresponding action method.
 
 ### RSpec
 
-Just add a test file which has only one test case using `have_valid_routes` matcher.
+Just add one test file that has only one test case using `have_valid_routes` matcher.
 
 ```ruby
 RSpec.describe 'Rails.application', type: :routing do
@@ -38,9 +43,23 @@ RSpec.describe 'Rails.application', type: :routing do
 end
 ```
 
+If you'd like to test unused actions and unused routes separately or test only one of them, there're matchers to do so.
+
+```ruby
+RSpec.describe 'Rails.application', type: :routing do
+  it "fails if application has unused actions" do
+    expect(Rails.application).to have_no_unused_actions
+  end
+
+  it "fails if application has unused routes" do
+    expect(Rails.application).to have_no_unused_routes
+  end
+end
+```
+
 ### MiniTest
 
-Just add a test file like below.
+Just add one test file like below.
 
 ```ruby
 class RoutingTest < Minitest::Test
@@ -52,6 +71,22 @@ class RoutingTest < Minitest::Test
 end
 ```
 
+If you'd like to test unused actions and unused routes separately or test only one of them, there're assertions to do so.
+
+```ruby
+class RoutingTest < Minitest::Test
+  include ::RouteMechanic::Testing::Methods
+
+  def test_that_application_has_no_unused_actions
+    assert_no_unused_actions
+  end
+
+  def test_that_application_has_no_unused_routes
+    assert_no_unused_routes
+  end
+end
+```
+
 ### What if RouteMechanic detects broken routes?
 
 It tells you broken routes as follows.
@@ -72,31 +107,23 @@ It tells you broken routes as follows.
 1 examples, 1 failure, 0 passed
 ```
 
-RouteMechanic reports 2 types of broken routes.
-
-1. Missing routes
-    - Your application has the controller and the action method but `config/routes.rb` doesn't have corresponds settings.
-2. Missing action methods
-    - Your application's `config/routes.rb` has routing declaration but no controller has a correspond action method.
-
 ## Motivation
 
-I believe most Rails developers write request specs instead of routing specs, and you might wonder what's worth to automate routing spec. Having said that, I can come up with some use-cases of this gem.
+I believe most Rails developers write request specs instead of routing specs, and you might wonder what's worth to automate routing specs. Having said that, I can come up with some use-cases of this gem.
 
 1. When your project is kinda aged and none knows which route is alive and which one is dead.
     - => You can detect dead code by using this gem.
 2. When your application doesn't have enough request specs (even controller specs).
     - => This gem could be a good start point to increase tests to ensure routing is valid.
-3. When you try to make big refactor of `config/routes.rb`.
-    - => It's burden to run all request specs during refactoring. This could save your time.
+3. When you try to make a big refactor of `config/routes.rb`.
+    - => It's a burden to run all request specs during refactoring. This could save your time.
 4. When you're compelled to write routing specs by any pressure. ;-)
     - => Set you free from tedious work!
 
-
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Code of Conduct
 
-Everyone interacting in the RouteMechanic project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/route_mechanic/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the RouteMechanic project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/route_mechanic/blob/master/CODE_OF_CONDUCT.md).

data/fixtures/fake_app/rails_app.rb

@@ -10,8 +10,20 @@ FakeApp.config.root = File.dirname(__FILE__)
 FakeApp.initialize!
 
 FakeApp.routes.draw do
+  constraints subdomain: /\A[0-9a-z-]+\z/ do
+    get '/constraints_test' => 'users#index'
+  end
+
+  scope ':locale', locale: /en|ja/ do
+    get '/locale_test', to: 'photos#index'
+    get '/photos/:id', to: 'photos#show', constraints: { id: /[A-Z]\d{5}/ }
+  end
+
+  get 'organizations/:id', to: 'organizations#show', id: /[A-Z]\d{5}/
+
   resources :users do
     get 'friends', to: :friends
     mount FakeEngine::Engine, at: "/fake_engine", fake_default_param: 'FAKE'
+    post 'create_as_another_name', to: 'users#create'
   end
 end

data/lib/route_mechanic/rspec/matchers.rb

@@ -1,49 +1,20 @@
-require 'route_mechanic/testing/methods'
-require 'rspec/matchers/composable'
+require 'route_mechanic/rspec/matchers/have_valid_routes'
+require 'route_mechanic/rspec/matchers/have_no_unused_actions'
+require 'route_mechanic/rspec/matchers/have_no_unused_routes'
 
 module RouteMechanic
   module RSpec
     module Matchers
-      class HaveValidRoutes
-        include ::RSpec::Matchers::Composable
-        include RouteMechanic::Testing::Methods
-
-        # @param [Rails::Application] expected
-        def initialize(expected)
-          @expected = expected
-        end
-
-        def matches?(_actual)
-          # assert_recognizes does not consider ActionController::RoutingError an
-          # assertion failure, so we have to capture that and Assertion here.
-          match_unless_raises Minitest::Assertion, ActiveSupport::TestCase::Assertion, ActionController::RoutingError do
-            assert_all_routes(@expected)
-          end
-        end
-
-        def failure_message
-          @rescued_exception.message
-        end
-
-        def description
-          "have valid routes"
-        end
-
-        private
+      def have_valid_routes(application=Rails.application)
+        HaveValidRoutes.new(application)
+      end
 
-        def match_unless_raises(*exceptions)
-          exceptions.unshift Exception if exceptions.empty?
-          begin
-            yield
-            true
-          rescue *exceptions => @rescued_exception
-            false
-          end
-        end
+      def have_no_unused_actions(application=Rails.application)
+        HaveNoUnusedActions.new(application)
       end
 
-      def have_valid_routes(application=Rails.application)
-        HaveValidRoutes.new(application)
+      def have_no_unused_routes(application=Rails.application)
+        HaveNoUnusedRoutes.new(application)
       end
     end
   end

data/lib/route_mechanic/rspec/matchers/base_matcher.rb

@@ -0,0 +1,42 @@
+require 'route_mechanic/testing/methods'
+require 'rspec/matchers/composable'
+
+module RouteMechanic
+  module RSpec
+    module Matchers
+      class BaseMatcher
+        include ::RSpec::Matchers::Composable
+        include RouteMechanic::Testing::Methods
+
+        # @param [Rails::Application] expected
+        def initialize(expected)
+          @expected = expected
+        end
+
+        def matches?(_actual)
+          raise NotImplementedError
+        end
+
+        def failure_message
+          @rescued_exception.message
+        end
+
+        def description
+          raise NotImplementedError
+        end
+
+        private
+
+        def match_unless_raises(*exceptions)
+          exceptions.unshift Exception if exceptions.empty?
+          begin
+            yield
+            true
+          rescue *exceptions => @rescued_exception
+            false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/route_mechanic/rspec/matchers/have_no_unused_actions.rb

@@ -0,0 +1,21 @@
+require 'route_mechanic/rspec/matchers/base_matcher'
+
+module RouteMechanic
+  module RSpec
+    module Matchers
+      class HaveNoUnusedActions < BaseMatcher
+        def matches?(_actual)
+          # assert_recognizes does not consider ActionController::RoutingError an
+          # assertion failure, so we have to capture that and Assertion here.
+          match_unless_raises Minitest::Assertion, ActiveSupport::TestCase::Assertion, ActionController::RoutingError do
+            assert_no_unused_actions(@expected)
+          end
+        end
+
+        def description
+          "have no unused actions"
+        end
+      end
+    end
+  end
+end

data/lib/route_mechanic/rspec/matchers/have_no_unused_routes.rb

@@ -0,0 +1,21 @@
+require 'route_mechanic/rspec/matchers/base_matcher'
+
+module RouteMechanic
+  module RSpec
+    module Matchers
+      class HaveNoUnusedRoutes < BaseMatcher
+        def matches?(_actual)
+          # assert_recognizes does not consider ActionController::RoutingError an
+          # assertion failure, so we have to capture that and Assertion here.
+          match_unless_raises Minitest::Assertion, ActiveSupport::TestCase::Assertion, ActionController::RoutingError do
+            assert_no_unused_routes(@expected)
+          end
+        end
+
+        def description
+          "have no unused routes"
+        end
+      end
+    end
+  end
+end

data/lib/route_mechanic/rspec/matchers/have_valid_routes.rb

@@ -0,0 +1,21 @@
+require 'route_mechanic/rspec/matchers/base_matcher'
+
+module RouteMechanic
+  module RSpec
+    module Matchers
+      class HaveValidRoutes < BaseMatcher
+        def matches?(_actual)
+          # assert_recognizes does not consider ActionController::RoutingError an
+          # assertion failure, so we have to capture that and Assertion here.
+          match_unless_raises Minitest::Assertion, ActiveSupport::TestCase::Assertion, ActionController::RoutingError do
+            assert_all_routes(@expected)
+          end
+        end
+
+        def description
+          "have valid routes"
+        end
+      end
+    end
+  end
+end

data/lib/route_mechanic/testing/error_aggregator.rb

@@ -3,7 +3,7 @@ require "route_mechanic/testing/error_inspector"
 module RouteMechanic
   module Testing
     class ErrorAggregator
-      attr_reader :controller_routes_errors, :config_routes_errors
+      attr_reader :unused_actions_errors, :unused_routes_errors
 
       # @param [Array<ActionDispatch::Journey::Route>] routes
       # @param [Array<Controller>] controllers
@@ -12,49 +12,54 @@ module RouteMechanic
         @controllers = controllers
         @config_routes = []
         @controller_routes = []
-        @config_routes_errors = []
-        @controller_routes_errors = []
+        @unused_routes_errors = []
+        @unused_actions_errors = []
       end
 
-      def aggregate
-        collect_controller_routes_errors
-        collect_config_routes_errors
+      # @param [Boolean] unused_actions
+      # @param [Boolean] unused_routes
+      def aggregate(unused_actions: true, unused_routes: true)
+        collect_unused_actions_errors(unused_actions)
+        collect_unused_routes_errors(unused_routes)
         self
       end
 
+      # @return [Array<ActionDispatch::Journey::Route>]
       def all_routes
         @config_routes + @controller_routes
       end
 
+      # @return [Boolean]
       def no_error?
-        [@config_routes_errors, @controller_routes_errors].all?(&:empty?)
+        [@unused_routes_errors, @unused_actions_errors].all?(&:empty?)
       end
 
+      # @return [String]
       def error_message
         ErrorInspector.new(self).message
       end
 
       private
 
-      def collect_controller_routes_errors
+      def collect_unused_actions_errors(report_error)
         @controllers.each do |controller|
           controller_path = controller.controller_path
           controller.action_methods.each do |action_method|
-            journey_route = @routes.detect do |route|
+            journey_routes = @routes.select do |route|
               route.defaults[:controller].to_sym == controller_path.to_sym && route.defaults[:action].to_sym == action_method.to_sym
             end
 
-            if journey_route
-              wrapper = RouteWrapper.new journey_route
-              @controller_routes << wrapper
+            if journey_routes.empty?
+              @unused_actions_errors << { controller: controller, action: action_method } if report_error
             else
-              @controller_routes_errors << { controller: controller, action: action_method }
+              wrappers = journey_routes.map { |r| RouteWrapper.new(r) }
+              @controller_routes.concat(wrappers)
             end
           end
         end
       end
 
-      def collect_config_routes_errors
+      def collect_unused_routes_errors(report_error)
         @routes.each do |journey_route|
           wrapper = RouteWrapper.new journey_route
           @config_routes << wrapper
@@ -63,7 +68,7 @@ module RouteMechanic
             wrapper.controller == w.controller && wrapper.action == w.action && wrapper.path == w.path
           end
 
-          @config_routes_errors << wrapper unless matched_controller_exist
+          @unused_routes_errors << wrapper if !matched_controller_exist && report_error
         end
       end
     end

data/lib/route_mechanic/testing/error_inspector.rb

@@ -4,7 +4,7 @@ module RouteMechanic
   module Testing
     class ErrorInspector
       extend Forwardable
-      def_delegators :@aggregator, :controller_routes_errors, :config_routes_errors
+      def_delegators :@aggregator, :unused_actions_errors, :unused_routes_errors
 
       # @param [RouteMechanic::Testing::ErrorAggregator] aggregator
       def initialize(aggregator)
@@ -15,27 +15,26 @@ module RouteMechanic
       def message
         buffer = []
 
-        if controller_routes_errors.present?
+        if unused_actions_errors.present?
           buffer << "  No route matches to the controllers and action methods below"
-          buffer << controller_routes_errors.map {|r| "    #{r[:controller]}##{r[:action]}" }
+          buffer << unused_actions_errors.map {|r| "    #{r[:controller]}##{r[:action]}" }
         end
 
-        if config_routes_errors.present?
+        if unused_routes_errors.present?
           verb_width, path_width = widths
           buffer << "  No controller and action matches to the routes below"
-          buffer << config_routes_errors.map { |w| "    #{w.verb.ljust(verb_width)} #{w.path.ljust(path_width)} #{w.reqs}" }
-          buffer << "\n"
+          buffer << unused_routes_errors.map { |w| "    #{w.verb.ljust(verb_width)} #{w.path.ljust(path_width)} #{w.reqs}" }
         end
 
-        ["[Route Mechanic]", buffer].join("\n")
+        ["[Route Mechanic]", buffer].join("\n") + "\n"
       end
 
       private
 
       def widths
         [
-          config_routes_errors.map { |w| w.verb.length }.max || 0,
-          config_routes_errors.map { |w| w.path.length }.max || 0
+          unused_routes_errors.map { |w| w.verb.length }.max || 0,
+          unused_routes_errors.map { |w| w.path.length }.max || 0
         ]
       end
     end

data/lib/route_mechanic/testing/methods.rb

@@ -3,6 +3,7 @@ require "route_mechanic/testing/error_aggregator"
 require "route_mechanic/testing/minitest_assertion_adopter"
 require "action_controller"
 require "action_controller/test_case"
+require "regexp-examples"
 
 module RouteMechanic
   module Testing
@@ -13,20 +14,41 @@ module RouteMechanic
       # @param [Rails::Application] application
       # @raise [Minitest::Assertion]
       def assert_all_routes(application=Rails.application)
+        assert_targets(application, unused_actions: true, unused_routes: true)
+      end
+
+      # @param [Rails::Application] application
+      # @raise [Minitest::Assertion]
+      def assert_no_unused_actions(application=Rails.application)
+        assert_targets(application, unused_actions: true, unused_routes: false)
+      end
+
+      # @param [Rails::Application] application
+      # @raise [Minitest::Assertion]
+      def assert_no_unused_routes(application=Rails.application)
+        assert_targets(application, unused_actions: false, unused_routes: true)
+      end
+
+      private
+
+      # @param [Rails::Application] application
+      # @param [Boolean] unused_actions
+      # @param [Boolean] unused_routes
+      # @raise [Minitest::Assertion]
+      def assert_targets(application, unused_actions:, unused_routes:)
         @application = application
 
         # Instead of including ActionController::TestCase::Behavior, set up
         # https://github.com/rails/rails/blob/5b6aa8c20a3abfd6274c83f196abf73cacb3400b/actionpack/lib/action_controller/test_case.rb#L519-L520
         @controller = nil unless defined? @controller
 
-        aggregator = ErrorAggregator.new(target_routes, controllers).aggregate
+        aggregator = ErrorAggregator.new(target_routes, controllers).aggregate(
+          unused_actions: unused_actions, unused_routes: unused_routes)
         aggregator.all_routes.each { |wrapper| assert_routes(wrapper) }
 
         assert(aggregator.no_error?, ->{ aggregator.error_message })
       end
 
-      private
-
       def routes
         # assert_routing expect @routes to exists as like this class inherits ActionController::TestCase.
         # If user already defines @routes, do not override
@@ -45,7 +67,12 @@ module RouteMechanic
       # @raise [Minitest::Assertion]
       def assert_routes(wrapper)
         required_parts = wrapper.required_parts.reduce({}) do |memo, required_part|
-          memo.merge({ required_part => '1' }) # '1' is pseudo id
+          dummy = if wrapper.requirements[required_part].is_a?(Regexp)
+                    wrapper.requirements[required_part].examples.last
+                  else
+                    '1'
+                  end
+          memo.merge({ required_part => dummy }) # Set pseudo params to meets requirements
         end
 
         base_option = { controller: wrapper.controller, action: wrapper.action }
@@ -53,7 +80,12 @@ module RouteMechanic
           base_option.merge({ only_path: true }).merge(required_parts))
         expected_options = base_option.merge(required_parts)
 
-        assert_routing({ path: url, method: wrapper.verb }, expected_options)
+        assert_generates(url, expected_options)
+        # Q. Why not using `assert_routing` or `assert_recognize`?
+        # A. They strictly checks `constraints` in routes.rb and
+        #    this gem can't generate a request that meets whole constraints just in time.
+        # https://github.com/ohbarye/route_mechanic/issues/7#issuecomment-695957142
+        # https://guides.rubyonrails.org/routing.html#specifying-constraints
       end
 
       # @return [Array<Controller>]

data/lib/route_mechanic/version.rb

@@ -1,3 +1,3 @@
 module RouteMechanic
-  VERSION = "0.1.3"
+  VERSION = "0.2.1"
 end

data/route_mechanic.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.description   = %q{No need to maintain Rails' routing tests manually. RouteMechanic automatically detects broken routes and missing action methods in controller once you've finished installation.}
   spec.homepage      = "https://github.com/ohbarye/route_mechanic"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/ohbarye/route_mechanic"
@@ -24,5 +24,6 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency "actionpack", ">= 4.2", "< 6.1"
+  spec.add_runtime_dependency "actionpack", ">= 4.2", "< 6.2"
+  spec.add_runtime_dependency "regexp-examples", ">= 1.5", "< 2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: route_mechanic
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.1
 platform: ruby
 authors:
 - ohbarye
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-09-21 00:00:00.000000000 Z
+date: 2021-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -19,7 +19,7 @@ dependencies:
         version: '4.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '6.1'
+        version: '6.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,27 @@ dependencies:
         version: '4.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '6.1'
+        version: '6.2'
+- !ruby/object:Gem::Dependency
+  name: regexp-examples
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
 description: No need to maintain Rails' routing tests manually. RouteMechanic automatically
   detects broken routes and missing action methods in controller once you've finished
   installation.
@@ -55,6 +75,10 @@ files:
 - fixtures/fake_app/rails_app.rb
 - lib/route_mechanic.rb
 - lib/route_mechanic/rspec/matchers.rb
+- lib/route_mechanic/rspec/matchers/base_matcher.rb
+- lib/route_mechanic/rspec/matchers/have_no_unused_actions.rb
+- lib/route_mechanic/rspec/matchers/have_no_unused_routes.rb
+- lib/route_mechanic/rspec/matchers/have_valid_routes.rb
 - lib/route_mechanic/testing/error_aggregator.rb
 - lib/route_mechanic/testing/error_inspector.rb
 - lib/route_mechanic/testing/methods.rb
@@ -76,7 +100,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="