openapi_first 0.13.3 → 0.14.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94cbe97158c8482c40dd1521e1f83cef287ad2e7e32f82746f24adcf45f60c4e
-  data.tar.gz: 1aff02e97e51b67334c34bc6ee967559def9218c4e81dc6295204bb5447f6715
+  metadata.gz: 1b6acd9051ff71dbc3980ec2547e6597992b4970f2aef176c4e118227f6ede01
+  data.tar.gz: d8f7a2142aaf4c2d07f951c75500bf1790fc7e9bee0006242a075de6f35ed405
 SHA512:
-  metadata.gz: 4ca9c77f8b70024083b831a02d824c2fd0321ff3598234f085133b161ba46a2177e9279e80e22f2ca56da466b087c0c7ac3a62c6dec9a7f906bf03fd44f2eb47
-  data.tar.gz: bcffa9f70194081780a0348f17e695b05f879eb029e4932baa224c3ca1d03e7fb531931f111bfdbcf452f772c0729e725cd3101779aa363408f859e63fd989f8
+  metadata.gz: 5ca8769be4df5874bd1c4c36c80df6a9301c06687385cd6105f6c0acbcbcb39ff903b55a16df36aad3933e7f490ea8817975bf601c37b10d8b8489946e01cc1c
+  data.tar.gz: '08588cfd43470ed9181b2420731e86ef2fdc99cb90dafd55af6228cd67d0e94c4eea9d7a9b3695a0034bd88c0d0a3ce071081579aeac66cf96ae995a8869d53f'

data/.rubocop.yml

@@ -1,13 +1,14 @@
 AllCops:
   TargetRubyVersion: 2.6
   NewCops: enable
+  SuggestExtensions: false
 Style/Documentation:
   Enabled: false
 Style/ExponentialNotation:
   Enabled: true
 Metrics/BlockLength:
   Exclude:
-  - 'spec/**/*.rb'
-  - '*.gemspec'
+    - "spec/**/*.rb"
+    - "*.gemspec"
 Metrics/MethodLength:
   Max: 20

data/CHANGELOG.md

@@ -1,33 +1,60 @@
 # Changelog
 
+## 0.14.3
+
+- Use json_refs to resolve OpenAPI file. This removes oas_parser and ActiveSupport from list of dependencies
+
+## 0.14.2
+
+- Empty query parameters are parsed and request validation returns 400 if an empty string is not allowed. Note that this does not look at `allowEmptyValue` in any way, because allowEmptyValue is deprecated.
+
+## 0.14.1
+
+- Bugfix: Don't mix path- and operation-level parameters for request validation
+
+## 0.14.0
+
+- Handle custom x-handler field in the API description to find a handler method not based on operationId
+- Add `resolver` option to provide a custom resolver to find a handler method
+
 ## 0.13.3
+
 - Better error message if string does not match format
+- readOnly and writeOnly just works when used inside allOf
 
 ## 0.13.2
+
 - Return indicator (`source: { parameter: 'list/1' }`) in error response body when array item in query parameter is invalid
 
 ## 0.13.0
+
 - Add support for arrays in query parameters (style: form, explode: false)
 - Remove warning when handler is not implemented
 
 ## 0.12.5
+
 - Add `not_found: :continue` option to Router to make it do nothing if request is unknown
 
 ## 0.12.4
+
 - content-type is found while ignoring additional content-type parameters (`application/json` is found when request/response content-type is `application/json; charset=UTF8`)
 - Support wildcard mime-types when finding the content-type
 
 ## 0.12.3
+
 - Add `response_validation:`, `router_raise_error` options to standalone mode.
 
 ## 0.12.2
+
 - Allow response to have no media type object specified
 
 ## 0.12.1
+
 - Fix response when handler returns 404 or 405
 - Don't validate the response content if status is 204 (no content)
 
 ## 0.12.0
+
 - Change `ResponseValidator` to raise an exception if it found a problem
 - Params have symbolized keys now
 - Remove `not_found` option from Router. Return 405 if HTTP verb is not allowed (via Hanami::Router)
@@ -39,6 +66,7 @@
 - Add `Operation#name` that returns a human readable name for an operation
 
 ## 0.11.0
+
 - Raise error if you forgot to add the Router middleware
 - Make OpenapiFirst.app raise an error in test env when request path is not specified
 - Rename OperationResolver to Responder
@@ -47,48 +75,60 @@
 - Move namespace option from Router to OperationResolver
 
 ## 0.10.2
+
 - Return 400 if request body has invalid JSON ([issue](https://github.com/ahx/openapi_first/issues/73)) thanks Thomas Frütel
 
 ## 0.10.1
+
 - Fix duplicated key in `required` when generating JSON schema for `some[thing]` parameters
 
 ## 0.10.0
+
 - Add support for query parameters named `"some[thing]"` ([issue](https://github.com/ahx/openapi_first/issues/40))
 
 ## 0.9.0
+
 - Make request validation usable standalone
 
 ## 0.8.0
+
 - Add merged parameter and request body available to env at `env[OpenapiFirst::INBOX]` in request validation
 - Path and query parameters with `type: boolean` now get converted to `true`/`false`
 - Rename `OpenapiFirst::PARAMS` to `OpenapiFirst::PARAMETERS`
 
 ## 0.7.1
+
 - Add missing `require` to work with new version of `oas_parser`
 
 ## 0.7.0
+
 - Make use of hanami-router, because it's fast
 - Remove option `allow_unknown_query_paramerters`
 - Move the namespace option to Router
-- Convert numeric path and query parameters  to `Integer` or `Float`
+- Convert numeric path and query parameters to `Integer` or `Float`
 - Pass the Rack env if your action class' initializers accepts an argument
 - Respec rack's `env['SCRIPT_NAME']` in router
 - Add MIT license
 
 ## 0.6.10
+
 - Bugfix: params.env['unknown'] now returns `nil` as expected. Thanks @tristandruyen.
 
 ## 0.6.9
+
 - Removed radix tree, because of a bug (https://github.com/namusyaka/r2ree-ruby/issues/2)
 
 ## 0.6.8
+
 - Performance: About 25% performance increase (i/s) with help of c++ based radix-tree and some optimizations
 - Update dependencies
 
 ## 0.6.7
+
 - Fix: version number of oas_parser
 
 ## 0.6.6
+
 - Remove warnings for Ruby 2.7
 
 ## 0.6.5

data/Gemfile.lock

@@ -1,120 +1,93 @@
 PATH
   remote: .
   specs:
-    openapi_first (0.13.3)
+    openapi_first (0.14.2)
       deep_merge (>= 1.2.1)
-      hanami-router (~> 2.0.alpha3)
+      hanami-router (~> 2.0.alpha4)
       hanami-utils (~> 2.0.alpha1)
+      json_refs (>= 0.1.7)
       json_schemer (~> 0.2.16)
       multi_json (~> 1.14)
-      oas_parser (~> 0.25.1)
       rack (~> 2.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3.4)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
-    addressable (2.7.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    ast (2.4.1)
-    builder (3.2.4)
+    ast (2.4.2)
     coderay (1.1.3)
-    concurrent-ruby (1.1.7)
+    concurrent-ruby (1.1.9)
     deep_merge (1.2.1)
     diff-lcs (1.4.4)
-    ecma-re-validator (0.2.1)
-      regexp_parser (~> 1.2)
-    hana (1.3.6)
-    hanami-router (2.0.0.alpha3)
+    dry-transformer (0.1.1)
+    ecma-re-validator (0.3.0)
+      regexp_parser (~> 2.0)
+    hana (1.3.7)
+    hanami-router (2.0.0.alpha5)
       mustermann (~> 1.0)
       mustermann-contrib (~> 1.0)
       rack (~> 2.0)
-    hanami-utils (2.0.0.alpha1)
+    hanami-utils (2.0.0.alpha3)
       concurrent-ruby (~> 1.0)
-      transproc (~> 1.0)
+      dry-transformer (~> 0.1)
     hansi (0.2.0)
-    hash-deep-merge (0.1.1)
-    i18n (1.8.5)
-      concurrent-ruby (~> 1.0)
-    json_schemer (0.2.16)
-      ecma-re-validator (~> 0.2)
+    json_refs (0.1.7)
+      hana
+    json_schemer (0.2.18)
+      ecma-re-validator (~> 0.3)
       hana (~> 1.3)
-      regexp_parser (~> 1.5)
+      regexp_parser (~> 2.0)
       uri_template (~> 0.7)
     method_source (1.0.0)
-    mini_portile2 (2.4.0)
-    minitest (5.14.2)
     multi_json (1.15.0)
     mustermann (1.1.1)
       ruby2_keywords (~> 0.0.1)
     mustermann-contrib (1.1.1)
       hansi (~> 0.2.0)
       mustermann (= 1.1.1)
-    nokogiri (1.10.10)
-      mini_portile2 (~> 2.4.0)
-    oas_parser (0.25.1)
-      activesupport (>= 4.0.0)
-      addressable (~> 2.3)
-      builder (~> 3.2.3)
-      deep_merge (~> 1.2.1)
-      hash-deep-merge
-      mustermann-contrib (~> 1.1.1)
-      nokogiri
-    parallel (1.19.2)
-    parser (2.7.2.0)
+    parallel (1.21.0)
+    parser (3.0.2.0)
       ast (~> 2.4.1)
-    pry (0.13.1)
+    pry (0.14.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (4.0.6)
     rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
     rainbow (3.0.0)
-    rake (13.0.1)
-    regexp_parser (1.8.2)
-    rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.3)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    rake (13.0.6)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    rubocop (0.93.1)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    rubocop (1.23.0)
       parallel (~> 1.10)
-      parser (>= 2.7.1.5)
+      parser (>= 3.0.0.0)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8)
+      regexp_parser (>= 1.8, < 3.0)
       rexml
-      rubocop-ast (>= 0.6.0)
+      rubocop-ast (>= 1.12.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (0.8.0)
-      parser (>= 2.7.1.5)
-    ruby-progressbar (1.10.1)
-    ruby2_keywords (0.0.2)
-    thread_safe (0.3.6)
-    transproc (1.1.1)
-    tzinfo (1.2.8)
-      thread_safe (~> 0.1)
-    unicode-display_width (1.7.0)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.13.0)
+      parser (>= 3.0.1.1)
+    ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    unicode-display_width (2.1.0)
     uri_template (0.7.0)
-    zeitwerk (2.4.1)
 
 PLATFORMS
-  ruby
+  x86_64-darwin-20
 
 DEPENDENCIES
   bundler (~> 2)
@@ -126,4 +99,4 @@ DEPENDENCIES
   rubocop
 
 BUNDLED WITH
-   2.1.4
+   2.2.28

data/README.md

@@ -29,9 +29,9 @@ You always have to add this middleware first in order to make the other middlewa
 use OpenapiFirst::Router, spec: OpenapiFirst.load('./openapi/openapi.yaml')
 ```
 
-This middleware adds `env[OpenapiFirst::OPERATION]` which holds an Operation object that responds to `operation_id` and `path`.
+This middleware adds `env[OpenapiFirst::OPERATION]` which holds an Operation object that responds to `#operation_id`, `#path` (and `#[]` to access raw fields).
 
-Options and their defaults:
+### Options and defaults
 
 | Name | Possible values | Description | Default
 |:---|---|---|---|
@@ -48,7 +48,7 @@ use OpenapiFirst::RequestValidation
 ```
 
 
-Options and their defaults:
+### Options and defaults
 
 | Name | Possible values | Description | Default
 |:---|---|---|---|
@@ -109,16 +109,19 @@ Response validation fails if response body includes a property with `writeOnly:
 
 This Rack endpoint maps the HTTP request to a method call based on the [operationId](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#operation-object) in your API description and calls it. Responder also adds a content-type to the response.
 
-Currently there are no customization options for this part. Please [share your ideas](#contributing) on how to best meet your needs and preferred style.
-
 ```ruby
 run OpenapiFirst::Responder, spec: OpenapiFirst.load('./openapi/openapi.yaml')
 ```
 
+### Options
 | Name | Description
 |:---|---|
-|`spec:`| The spec loaded via `OpenapiFirst.load` |
-| `namespace:` | A class or module where to find the handler method. |
+| `namespace:` | Optional. A class or module where to find the handler method. |
+| `resolver:` | Optional. An object that responds to `#call(operation)` and returns a [handler](#handlers). By default this is an instance of [DefaultOperationResolver](#OpenapiFirst::DefaultOperationResolver) |
+
+
+### OpenapiFirst::DefaultOperationResolver
+This is the default way to look up a handler method for an operation. Handlers are always looked up in a namespace module that needs to be specified.
 
 It works like this:
 
@@ -176,7 +179,7 @@ The above will use the mentioned Rack middlewares to:
 - Map the request to a method call `Pets.find_pet` based on the `operationId` in the API description
 - Set the response content type according to your spec (here with the default status code `200`)
 
-### Options and their defaults:
+### Options and defaults
 
 | Name | Possible values | Description | Default
 |:---|---|---|---|
@@ -185,6 +188,7 @@ The above will use the mentioned Rack middlewares to:
 | `response_validation:` | `true`, `false` | If set to true it raises an exception if the response is invalid. This is useful during testing. | `false`
 | `router_raise_error:` | `true`, `false` | If set to true it raises an exception (subclass of `OpenapiFirst::Error` when a request path/method is not specified. This is useful during testing. | `false`
 | `request_validation_raise_error:` | `true`, `false` | If set to true it raises an exception (subclass of `OpenapiFirst::Error` when a request is not valid. | `false`
+| `resolver:` | | Option to customize finding the [handler](#handlers) method for an operation. See [OpenapiFirst::Responder](#OpenapiFirst::Responder) for details.
 
 
 Handler functions (`find_pet`) are called with two arguments:
@@ -285,6 +289,10 @@ Run `bundle exec rspec` to run the tests.
 
 See `bundle exec rake -T` for rubygems related tasks.
 
+## Benchmarks
+
+[Results](https://gist.github.com/ahx/e6ffced58bd2e8d5baffb2f4d2c1f823)
+
 ### Run benchmarks
 
 ```sh

data/benchmarks/Gemfile.lock

@@ -1,90 +1,85 @@
 PATH
   remote: ..
   specs:
-    openapi_first (0.13.3)
+    openapi_first (0.14.2)
       deep_merge (>= 1.2.1)
-      hanami-router (~> 2.0.alpha3)
+      hanami-router (~> 2.0.alpha4)
       hanami-utils (~> 2.0.alpha1)
+      json_refs (>= 0.1.7)
       json_schemer (~> 0.2.16)
       multi_json (~> 1.14)
-      oas_parser (~> 0.25.1)
       rack (~> 2.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3.4)
+    activesupport (6.1.4.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
-    addressable (2.7.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    benchmark-ips (2.8.3)
-    benchmark-memory (0.1.2)
-      memory_profiler (~> 0.9)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    benchmark-ips (2.9.2)
+    benchmark-memory (0.2.0)
+      memory_profiler (~> 1)
     builder (3.2.4)
-    committee (4.2.0)
+    committee (4.4.0)
       json_schema (~> 0.14, >= 0.14.3)
-      openapi_parser (>= 0.11.1)
+      openapi_parser (>= 0.11.1, < 1.0)
       rack (>= 1.5)
-    concurrent-ruby (1.1.7)
+    concurrent-ruby (1.1.9)
     deep_merge (1.2.1)
-    dry-configurable (0.11.6)
+    dry-configurable (0.13.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.4, >= 0.4.7)
-      dry-equalizer (~> 0.2)
-    dry-container (0.7.2)
+      dry-core (~> 0.6)
+    dry-container (0.9.0)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.1, >= 0.1.3)
-    dry-core (0.4.9)
+      dry-configurable (~> 0.13, >= 0.13.0)
+    dry-core (0.7.1)
       concurrent-ruby (~> 1.0)
-    dry-equalizer (0.3.0)
-    dry-inflector (0.2.0)
-    dry-logic (1.0.8)
+    dry-inflector (0.2.1)
+    dry-logic (1.2.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.2)
-      dry-equalizer (~> 0.2)
-    dry-types (1.4.0)
+      dry-core (~> 0.5, >= 0.5)
+    dry-transformer (0.1.1)
+    dry-types (1.5.1)
       concurrent-ruby (~> 1.0)
       dry-container (~> 0.3)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer (~> 0.3)
+      dry-core (~> 0.5, >= 0.5)
       dry-inflector (~> 0.1, >= 0.1.2)
       dry-logic (~> 1.0, >= 1.0.2)
-    ecma-re-validator (0.2.1)
-      regexp_parser (~> 1.2)
-    grape (1.5.0)
+    ecma-re-validator (0.3.0)
+      regexp_parser (~> 2.0)
+    grape (1.6.0)
       activesupport
       builder
       dry-types (>= 1.1)
       mustermann-grape (~> 1.0.0)
       rack (>= 1.3.0)
       rack-accept
-    hana (1.3.6)
-    hanami-api (0.1.1)
+    hana (1.3.7)
+    hanami-api (0.2.0)
       hanami-router (~> 2.0.alpha)
-    hanami-router (2.0.0.alpha3)
+    hanami-router (2.0.0.alpha5)
       mustermann (~> 1.0)
       mustermann-contrib (~> 1.0)
       rack (~> 2.0)
-    hanami-utils (2.0.0.alpha1)
+    hanami-utils (2.0.0.alpha3)
       concurrent-ruby (~> 1.0)
-      transproc (~> 1.0)
+      dry-transformer (~> 0.1)
     hansi (0.2.0)
-    hash-deep-merge (0.1.1)
-    i18n (1.8.5)
+    i18n (1.8.11)
       concurrent-ruby (~> 1.0)
-    json_schema (0.20.9)
-    json_schemer (0.2.16)
-      ecma-re-validator (~> 0.2)
+    json_refs (0.1.7)
+      hana
+    json_schema (0.21.0)
+    json_schemer (0.2.18)
+      ecma-re-validator (~> 0.3)
       hana (~> 1.3)
-      regexp_parser (~> 1.5)
+      regexp_parser (~> 2.0)
       uri_template (~> 0.7)
-    memory_profiler (0.9.14)
-    mini_portile2 (2.4.0)
-    minitest (5.14.2)
+    memory_profiler (1.0.0)
+    minitest (5.14.4)
     multi_json (1.15.0)
     mustermann (1.1.1)
       ruby2_keywords (~> 0.0.1)
@@ -93,44 +88,31 @@ GEM
       mustermann (= 1.1.1)
     mustermann-grape (1.0.1)
       mustermann (>= 1.0.0)
-    nokogiri (1.10.10)
-      mini_portile2 (~> 2.4.0)
-    oas_parser (0.25.2)
-      activesupport (>= 4.0.0)
-      addressable (~> 2.3)
-      builder (~> 3.2.3)
-      deep_merge (~> 1.2.1)
-      hash-deep-merge
-      mustermann-contrib (~> 1.1.1)
-      nokogiri
-    openapi_parser (0.12.1)
-    public_suffix (4.0.6)
+    openapi_parser (0.15.0)
     rack (2.2.3)
     rack-accept (0.4.5)
       rack (>= 0.4)
     rack-protection (2.1.0)
       rack
-    regexp_parser (1.8.2)
-    ruby2_keywords (0.0.2)
+    regexp_parser (2.1.1)
+    ruby2_keywords (0.0.5)
     seg (1.2.0)
     sinatra (2.1.0)
       mustermann (~> 1.0)
       rack (~> 2.2)
       rack-protection (= 2.1.0)
       tilt (~> 2.0)
-    syro (3.2.0)
+    syro (3.2.1)
       rack (>= 1.6.0)
       seg
-    thread_safe (0.3.6)
     tilt (2.0.10)
-    transproc (1.1.1)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
     uri_template (0.7.0)
-    zeitwerk (2.4.0)
+    zeitwerk (2.5.1)
 
 PLATFORMS
-  ruby
+  x86_64-darwin-20
 
 DEPENDENCIES
   benchmark-ips
@@ -145,4 +127,4 @@ DEPENDENCIES
   syro
 
 BUNDLED WITH
-   2.1.4
+   2.2.28

data/benchmarks/apps/committee.ru

@@ -19,6 +19,8 @@ app = Class.new(Hanami::API) do
   end
 end.new
 
-use Committee::Middleware::RequestValidation, schema_path: './apps/openapi.yaml'
+use Committee::Middleware::RequestValidation,
+    schema_path: File.absolute_path('./openapi.yaml', __dir__),
+    parse_response_by_content_type: true
 
 run app

data/benchmarks/apps/committee_with_response_validation.ru

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'multi_json'
+require 'committee'
+require 'hanami/api'
+
+app = Class.new(Hanami::API) do
+  get '/hello/:id' do
+    json(hello: 'world', id: params.fetch(:id))
+  end
+
+  get '/hello' do
+    json([{ hello: 'world' }])
+  end
+
+  post '/hello' do
+    status 201
+    json(hello: 'world')
+  end
+end.new
+
+use Committee::Middleware::RequestValidation,
+    schema_path: File.absolute_path('./openapi.yaml', __dir__),
+    parse_response_by_content_type: true
+
+use Committee::Middleware::ResponseValidation,
+    schema_path: File.absolute_path('./openapi.yaml', __dir__)
+
+run app

data/benchmarks/apps/committee_with_sinatra.ru

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'multi_json'
+require 'committee'
+require 'sinatra'
+
+class SinatraWithCommiteeExample < Sinatra::Base
+  set :environment, :production
+
+  get '/hello/:id' do
+    content_type :json
+    MultiJson.dump(hello: 'world', id: params.fetch('id'))
+  end
+
+  get '/hello' do
+    content_type :json
+    MultiJson.dump([{ hello: 'world' }])
+  end
+
+  post '/hello' do
+    content_type :json
+    status 201
+    MultiJson.dump(hello: 'world')
+  end
+end
+
+use Committee::Middleware::RequestValidation,
+    schema_path: File.absolute_path('./openapi.yaml', __dir__),
+    parse_response_by_content_type: true
+
+run SinatraWithCommiteeExample