openapi_first 0.21.0 → 1.0.0.beta3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b8b03aaa251de1bdb5cbba71de089bf1ffc6b9dbb96512008f88e783c3cea27
-  data.tar.gz: 02eb6cec864e9b5ed272d4392b31fd9e006713d3a8b00df9b26e9a52fa68e555
+  metadata.gz: 800354f7ac2847fb16987e6961589aaebb84c161f3b76ea652a00a4cf8762fbe
+  data.tar.gz: f443b72fa8ce1103bfc5a7b30367ce96f84e0dc7ad137722424cab0ac0c13357
 SHA512:
-  metadata.gz: e37e99e982f0ead9d54587683fa74491e69998f520b1cfb4993c9e1ee81273537dfdf1751c77daef856ab3c3051660589d2f8ac6e58508fd11d3ea130734d2a5
-  data.tar.gz: 6944ae2444da29928eeb12e70326505aa154f1c36a09f033083098b1e34be766b075257fd2459b94574370fa8cc417ef488f74dafcec6026eaab07a47f471445
+  metadata.gz: e454ee38c95a21915869e5feae0f38f65e0aa9a0a5001b6b752043fa379836164af1bf7eac9bcff192822d66053dda00d6dfa787296cce82bccf346d218f4c6c
+  data.tar.gz: 11a0a0ac1e1bbd350d1edfe1dcae4ccae15bcfe2f1863320f30f554c3ad16934b07891c578225d2d7d128c3cb7dafd4093407c1c153713567db4db3d9c99c938

data/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 ## Unreleased
 
+## 1.0.0.beta3
+
+- Remove obsolete dependency: deep_merge
+- Remove obsolete dependency: hanami-utils
+
+## 1.0.0.beta2
+- Fixed dependencies. Remove unused code.
+
+## 1.0.0.beta1
+- Removed: `OpenapiFirst::Responder` and `OpenapiFirst::RackResponder`
+- Removed: `OpenapiFirst.app` and `OpenapiFirst.middleware`
+- Removed: `OpenapiFirst::Coverage`
+- Breaking: Parsed query and path parameters are available at `env[OpenapiFirst::PARAMS]`(or `env['openapi.params']`) instead of `OpenapiFirst::PARAMETERS`.
+- Breaking: Request body and parameters now use string keys instead of symbols!
+- Breaking: Query parameters are now parsed exactly like in the API description via the openapi_parameters gem. This means a couple of things:
+  - Query parameters now support `explode: true` (default) and `explode: false` for array and object parameters.
+  - Query parameters with brackets like 'filter[tag]' are no longer deconstructed into nested hashes, but accessible via the `filter[tag]` key.
+  - Query parameters are no longer interpreted as `style: deepObject` by default. If you want to use `style: deepObject`, for example to pass a nested hash as a query parameter like `filter[tag]`, you have to set `style: deepObject` explicitly.
+- Path parameters are now parsed exactly as in the API description via the openapi_parameters gem.
+
 ## 0.21.0
 
 - Fix: Query parameter validation does not fail if header parameters are defined (Thanks to [JF Lalonde](https://github.com/JF-Lalonde))

data/Gemfile.lock

@@ -1,28 +1,20 @@
 PATH
   remote: .
   specs:
-    openapi_first (0.21.0)
-      deep_merge (>= 1.2.1)
+    openapi_first (1.0.0.beta3)
       hanami-router (~> 2.0.0)
-      hanami-utils (~> 2.0.0)
       json_refs (~> 0.1, >= 0.1.7)
       json_schemer (~> 0.2.16)
       multi_json (~> 1.14)
-      rack (~> 2.2)
+      openapi_parameters (~> 0.2)
+      rack (>= 2.2, < 4.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
     coderay (1.1.3)
-    concurrent-ruby (1.2.2)
-    deep_merge (1.2.2)
     diff-lcs (1.5.0)
-    dry-core (1.0.0)
-      concurrent-ruby (~> 1.0)
-      zeitwerk (~> 2.6)
-    dry-transformer (1.0.1)
-      zeitwerk (~> 2.6)
     ecma-re-validator (0.4.0)
       regexp_parser (~> 2.2)
     hana (1.3.7)
@@ -30,10 +22,6 @@ GEM
       mustermann (~> 3.0)
       mustermann-contrib (~> 3.0)
       rack (~> 2.0)
-    hanami-utils (2.0.3)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 1.0, < 2)
-      dry-transformer (~> 1.0, < 2)
     hansi (0.2.1)
     json (2.6.3)
     json_refs (0.1.7)
@@ -50,13 +38,16 @@ GEM
     mustermann-contrib (3.0.0)
       hansi (~> 0.2.0)
       mustermann (= 3.0.0)
+    openapi_parameters (0.2.1)
+      rack (>= 2.2)
+      zeitwerk (~> 2.6)
     parallel (1.22.1)
-    parser (3.2.1.0)
+    parser (3.2.1.1)
       ast (~> 2.4.1)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    rack (2.2.6.2)
+    rack (2.2.6.4)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
     rainbow (3.1.1)
@@ -72,23 +63,23 @@ GEM
     rspec-expectations (3.12.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.3)
+    rspec-mocks (3.12.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.0)
-    rubocop (1.45.1)
+    rubocop (1.48.1)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.24.1, < 2.0)
+      rubocop-ast (>= 1.26.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.26.0)
+    rubocop-ast (1.28.0)
       parser (>= 3.2.1.0)
-    ruby-progressbar (1.11.0)
+    ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
     unicode-display_width (2.4.2)
     uri_template (0.7.0)
@@ -96,8 +87,6 @@ GEM
 
 PLATFORMS
   arm64-darwin-21
-  x86_64-darwin-20
-  x86_64-linux
 
 DEPENDENCIES
   bundler (~> 2)
@@ -109,4 +98,4 @@ DEPENDENCIES
   rubocop
 
 BUNDLED WITH
-   2.3.7
+   2.3.10

data/README.md

@@ -2,39 +2,27 @@
 
 [![Join the chat at https://gitter.im/openapi_first/community](https://badges.gitter.im/openapi_first/community.svg)](https://gitter.im/openapi_first/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-OpenapiFirst helps to implement HTTP APIs based on an [OpenApi](https://www.openapis.org/) API description. The idea is that you create an API description first, then add code that returns data and implements your business logic and be done.
+OpenapiFirst helps to implement HTTP APIs based on an [OpenAPI](https://www.openapis.org/) API description.
 
-Start with writing an OpenAPI file that describes the API, which you are about to implement. Use a [validator](https://github.com/stoplightio/spectral/) to make sure the file is valid.
+It provides these Rack middlewares:
 
-You can use OpenapiFirst via its [Rack middlewares](#rack-middlewares) or in [standalone mode](#standalone-usage).
+- [`OpenapiFirst::RequestValidation`](#request-validation) – Validates the request against the API description and returns 400 if the request is invalid.
+- [`OpenapiFirst::ResponseValidation`](#response-validation) Validates the response and raises an exception if the response body is invalid.
+- [`OpenapiFirst::Router`](#openapifirstrouter) – This internal middleware is added automatically when using request/response validation. It adds the OpenAPI operation for the current request to the Rack env.
 
-## Alternatives
-
-This gem is inspired by [committee](https://github.com/interagent/committee) (Ruby) and [connexion](https://github.com/zalando/connexion) (Python).
-
-Here's a [comparison between committee and openapi_first](https://gist.github.com/ahx/1538c31f0652f459861713b5259e366a).
-
-## Rack middlewares
-
-OpenapiFirst consists of these Rack middlewares:
-
-- [`OpenapiFirst::RequestValidation`](#OpenapiFirst::RequestValidation) – Validates the request against the API description and returns 400 if the request is invalid.
-- [`OpenapiFirst::ResponseValidation`](#OpenapiFirst::ResponseValidation) Validates the response and raises an exception if the response body is invalid.
-- [`OpenapiFirst::Router`](#OpenapiFirst::Router) – This internal middleware is added automatically before request/response validation. Finds the OpenAPI operation for the current request or returns 404 if no operation was found. This can be customized by adding it yourself.
-
-
-And these Rack apps:
-- [`OpenapiFirst::Responder`](#OpenapiFirst::Responder) calls the [handler](#handlers) found for the operation, sets the correct content-type and serializes the response body to json if needed.
-- [`OpenapiFirst::RackResponder`](#OpenapiFirst::RackResponder) calls the [handler](#handlers) found for the operation as a normal Rack application (`call(env)`) and returns the result as is.
+## Request Validation
 
-## OpenapiFirst::RequestValidation
-
-This middleware returns a 400 status code with a body that describes the error if the request is not valid.
+The `OpenapiFirst::RequestValidation` middleware returns a 400 status code with a body that describes the error if the request is not valid.
 
 ```ruby
 use OpenapiFirst::RequestValidation, spec: 'openapi.yaml'
 ```
 
+It adds these fields to the Rack env:
+- `env[OpenapiFirst::PARAMS]` – The parsed parameters (query, path) for the current request (string keyed)
+- `env[OpenapiFirst::REQUEST_BODY]` – The parsed request body (string keyed)
+- `env[OpenapiFirst::OPERATION]` (Added via Router) – The Operation object for the current request. This is an instance of `OpenapiFirst::Operation`.
+
 ### Options and defaults
 
 | Name           | Possible values | Description                                                                                        | Default                            |
@@ -62,26 +50,27 @@ content-type: "application/vnd.api+json"
 }
 ```
 
-This middleware adds `env[OpenapiFirst::INBOX]` which holds the (filtered) path and query parameters and the parsed request body.
-
-### Parameter validation
+### Parameters
 
-The middleware filteres all top-level query parameters and paths parameters and tries to convert numeric values. Meaning, if you have an `:something_id` path with `type: integer`, it will try convert the value to an integer.
+The `RequestValidation` middleware adds `env[OpenapiFirst::PARAMS]` (or `env['openapi.params']` ) with the converted query and path parameters. This only includes the parameters that are defined in the API description. It supports every [`style` and `explode` value as described](https://spec.openapis.org/oas/latest.html#style-examples) in the OpenAPI 3.0 and 3.1 specs. So you can do things these:
 
-It just works with a parameter with `name: filter[age]`.
-
-OpenapiFirst also supports `type: array` for query parameters and will convert `items` just as described above. [`style`](http://spec.openapis.org/oas/v3.0.3#style-values) and `explode` attributes are not supported for query parameters. It will always act as if `style: form` and `explode: false` were used for query parameters.
+```ruby
+# GET /pets/filter[id]=1,2,3
+env[OpenapiFirst::PARAMS] # => { 'filter[id]' => [1,2,3] }
 
-Conversion is currently done only for path and query parameters, but not for the request body. OpenapiFirst currently does not convert date, date-time or time formats.
+# GET /colors/.blue.black.brown?format=csv
+env[OpenapiFirst::PARAMS] # => { 'color_names' => ['blue', 'black', 'brown'], 'format' => 'csv' }
 
-If you want to forbid _nested_ query parameters you will need to use [`additionalProperties: false`](https://json-schema.org/understanding-json-schema/reference/object.html#properties) in your query parameter JSON schema.
+# And a lot more.
+```
 
-_OpenapiFirst always treats query parameters like [`style: deepObject`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#style-values), **but** it just works with nested objects (`filter[foo][bar]=baz`) (see [this discussion](https://github.com/OAI/OpenAPI-Specification/issues/1706))._
+Integration for specific webframeworks is ongoing. Don't hesitate to create an issue with you specific needs.
 
 ### Request body validation
 
+This middleware adds the parsed request body to `env[OpenapiFirst::REQUEST_BODY]`.
+
 The middleware will return a status `415` if the requests content type does not match or `400` if the request body is invalid.
-This will also add the parsed request body to `env[OpenapiFirst::REQUEST_BODY]`.
 
 ### Header, Cookie, Path parameter validation
 
@@ -93,10 +82,9 @@ Request validation fails if request includes a property with `readOnly: true`.
 
 Response validation fails if response body includes a property with `writeOnly: true`.
 
-## OpenapiFirst::ResponseValidation
-
-This middleware is especially useful when testing. It _always_ raises an error if the response is not valid.
+## Response validation
 
+The `OpenapiFirst::ResponseValidation` middleware is especially useful when testing. It _always_ raises an error if the response is not valid.
 
 ```ruby
 use OpenapiFirst::ResponseValidation, spec: 'openapi.yaml' if ENV['RACK_ENV'] == 'test'
@@ -110,13 +98,13 @@ use OpenapiFirst::ResponseValidation, spec: 'openapi.yaml' if ENV['RACK_ENV'] ==
 
 ## OpenapiFirst::Router
 
-This middleware is used automatically, but you can add it to the top of your middleware stack if you want to change configuration.
+This middleware is used automatically, but you can add it to the top of your middleware stack if you want to customize the behavior via options.
 
 ```ruby
 use OpenapiFirst::Router, spec: './openapi/openapi.yaml'
 ```
 
-This middleware adds `env[OpenapiFirst::OPERATION]` which holds an Operation object that responds to `#operation_id`, `#path` (and `#[]` to access raw fields).
+This middleware adds `env[OpenapiFirst::OPERATION]` which holds an Operation object that responds to `#operation_id`, `#path` (and `#[string]` to access raw fields).
 
 ### Options and defaults
 
@@ -126,115 +114,11 @@ This middleware adds `env[OpenapiFirst::OPERATION]` which holds an Operation obj
 | `raise_error:` | `false`, `true`      | If set to true the middleware raises `OpenapiFirst::NotFoundError` when a path or method was not found in the API description. This is useful during testing to spot an incomplete API description.                                                             | `false` (don't raise an exception) |
 | `not_found:`   | `:continue`, `:halt` | If set to `:continue` the middleware will not return 404 (405, 415), but just pass handling the request to the next middleware or application in the Rack stack. If combined with `raise_error: true` `raise_error` gets preference and an exception is raised. | `:halt` (return 4xx response)      |
 
-## OpenapiFirst::RackResponder
-
-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 as a normal Rack application.
-It does not not serialize objects as JSON or adds a content-type.
-
-```ruby
-run OpenapiFirst::RackResponder
-```
-
-### Options
-
-| Name         | Description                                                                                                                                                                                       |
-| :----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `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::Responder
-
-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.
-
-```ruby
-run OpenapiFirst::Responder
-```
-
-### Options
-
-| Name         | Description                                                                                                                                                                                       |
-| :----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `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:
-
-- An operationId "create_pet" or "createPet" or "create pet" calls `MyApi.create_pet(params, response)`
-- "some_things.create" calls: `MyApi::SomeThings.create(params, response)`
-- "pets#create" instantiates the class once (`MyApi::Pets::Create.new) and calls it on every request(`instance.call(params, response)`).
-
-### Handlers
-
-These handler methods are called with two arguments:
-
-- `params` - Holds the parsed request body, filtered query params and path parameters (same as `env[OpenapiFirst::INBOX]`)
-- `res` - Holds a Rack::Response that you can modify if needed
-
-You can call `params.env` to access the Rack env (just like in [Hanami actions](https://guides.hanamirb.org/actions/parameters/))
-
-There are two ways to set the response body:
-
-- Calling `res.write "things"` (see [Rack::Response](https://www.rubydoc.info/github/rack/rack/Rack/Response))
-- Returning a value which will get converted to JSON
-
-## Standalone usage
-
-Instead of composing these middlewares yourself you can use `OpenapiFirst.app`.
-
-```ruby
-module Pets
-  def self.find_pet(params, res)
-    {
-      id: params[:id],
-      name: 'Oscar'
-    }
-  end
-end
-
-# In config.ru:
-require 'openapi_first'
-run OpenapiFirst.app(
-  './openapi/openapi.yaml',
-  namespace: Pets,
-  response_validation: ENV['RACK_ENV'] == 'test',
-  router_raise_error:  ENV['RACK_ENV'] == 'test'
-)
-```
-
-The above will use the mentioned Rack middlewares to:
-
-- Validate the request and respond with 400 if the request does not match with your API description
-- 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 defaults
-
-| Name                              | Possible values | Description                                                                                                                                          | Default |
-| :-------------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
-| `spec_path`                       |                 | A filepath to an OpenAPI definition file.                                                                                                            |
-| `namespace:`                      |                 | A class or module where to find the handler methods.                                                                                                 |
-| `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:
-
-- `params` - Holds the parsed request body, filtered query params and path parameters
-- `res` - Holds a Rack::Response that you can modify if needed
-  If you want to access to plain Rack env you can call `params.env`.
-
-## If your API description does not contain all endpoints
+## Alternatives
 
-```ruby
-run OpenapiFirst.middleware('./openapi/openapi.yaml', namespace: Pets)
-```
+This gem is inspired by [committee](https://github.com/interagent/committee) (Ruby) and [connexion](https://github.com/zalando/connexion) (Python).
 
-Here all requests that are not part of the API description will be passed to the next app.
+Here's a [comparison between committee and openapi_first](https://gist.github.com/ahx/1538c31f0652f459861713b5259e366a).
 
 ## Try it out
 
@@ -272,44 +156,6 @@ spec = OpenapiFirst.load('./openapi/openapi.yaml', only: { |path| path.starts_wi
 run OpenapiFirst.app(spec, namespace: Pets)
 ```
 
-## Coverage
-
-(This is a bit experimental. Please try it out and give feedback.)
-
-`OpenapiFirst::Coverage` helps you make sure, that you have called all endpoints of your OAS file when running tests via `rack-test`.
-
-```ruby
-# In your test (rspec example):
-require 'openapi_first/coverage'
-
-describe MyApp do
-  include Rack::Test::Methods
-
-  before(:all) do
-    @app_wrapper = OpenapiFirst::Coverage.new(MyApp, 'petstore.yaml')
-  end
-
-  after(:all) do
-    message = "The following paths have not been called yet: #{@app_wrapper.to_be_called}"
-    expect(@app_wrapper.to_be_called).to be_empty
-  end
-
-  # Overwrite `#app` to make rack-test call the wrapped app
-  def app
-    @app_wrapper
-  end
-
-  it 'does things' do
-    get '/i/my/stuff'
-    # …
-  end
-end
-```
-
-## Mocking
-
-Out of scope. Use [Prism](https://github.com/stoplightio/prism) or [fakeit](https://github.com/JustinFeng/fakeit).
-
 ## Development
 
 Run `bin/setup` to install dependencies.

data/benchmarks/Gemfile.lock

@@ -1,24 +1,23 @@
 PATH
   remote: ..
   specs:
-    openapi_first (0.21.0)
-      deep_merge (>= 1.2.1)
+    openapi_first (1.0.0.beta3)
       hanami-router (~> 2.0.0)
-      hanami-utils (~> 2.0.0)
       json_refs (~> 0.1, >= 0.1.7)
       json_schemer (~> 0.2.16)
       multi_json (~> 1.14)
-      rack (~> 2.2)
+      openapi_parameters (~> 0.2)
+      rack (>= 2.2, < 4.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.0.4.2)
+    activesupport (7.0.4.3)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
       tzinfo (~> 2.0)
-    benchmark-ips (2.11.0)
+    benchmark-ips (2.12.0)
     benchmark-memory (0.2.0)
       memory_profiler (~> 1)
     builder (3.2.4)
@@ -26,8 +25,7 @@ GEM
       json_schema (~> 0.14, >= 0.14.3)
       openapi_parser (~> 1.0)
       rack (>= 1.5)
-    concurrent-ruby (1.2.0)
-    deep_merge (1.2.2)
+    concurrent-ruby (1.2.2)
     dry-core (1.0.0)
       concurrent-ruby (~> 1.0)
       zeitwerk (~> 2.6)
@@ -36,13 +34,11 @@ GEM
       concurrent-ruby (~> 1.0)
       dry-core (~> 1.0, < 2)
       zeitwerk (~> 2.6)
-    dry-transformer (1.0.1)
-      zeitwerk (~> 2.6)
-    dry-types (1.7.0)
+    dry-types (1.7.1)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 1.0, < 2)
-      dry-inflector (~> 1.0, < 2)
-      dry-logic (>= 1.4, < 2)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
       zeitwerk (~> 2.6)
     ecma-re-validator (0.4.0)
       regexp_parser (~> 2.2)
@@ -60,10 +56,6 @@ GEM
       mustermann (~> 3.0)
       mustermann-contrib (~> 3.0)
       rack (~> 2.0)
-    hanami-utils (2.0.3)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 1.0, < 2)
-      dry-transformer (~> 1.0, < 2)
     hansi (0.2.1)
     i18n (1.12.0)
       concurrent-ruby (~> 1.0)
@@ -76,7 +68,7 @@ GEM
       regexp_parser (~> 2.0)
       uri_template (~> 0.7)
     memory_profiler (1.0.1)
-    minitest (5.17.0)
+    minitest (5.18.0)
     multi_json (1.15.0)
     mustermann (3.0.0)
       ruby2_keywords (~> 0.0.1)
@@ -85,29 +77,32 @@ GEM
       mustermann (= 3.0.0)
     mustermann-grape (1.0.2)
       mustermann (>= 1.0.0)
-    nio4r (2.5.8)
+    nio4r (2.5.9)
+    openapi_parameters (0.2.1)
+      rack (>= 2.2)
+      zeitwerk (~> 2.6)
     openapi_parser (1.0.0)
-    puma (6.1.0)
+    puma (6.2.2)
       nio4r (~> 2.0)
-    rack (2.2.6.2)
+    rack (2.2.6.4)
     rack-accept (0.4.5)
       rack (>= 0.4)
-    rack-protection (3.0.5)
+    rack-protection (3.0.6)
       rack
-    regexp_parser (2.7.0)
-    roda (3.65.0)
+    regexp_parser (2.8.0)
+    roda (3.67.0)
       rack
     ruby2_keywords (0.0.5)
     seg (1.2.0)
-    sinatra (3.0.5)
+    sinatra (3.0.6)
       mustermann (~> 3.0)
       rack (~> 2.2, >= 2.2.4)
-      rack-protection (= 3.0.5)
+      rack-protection (= 3.0.6)
       tilt (~> 2.0)
     syro (3.2.1)
       rack (>= 1.6.0)
       seg
-    tilt (2.0.11)
+    tilt (2.1.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     uri_template (0.7.0)

data/benchmarks/apps/openapi_first_with_hanami_api.ru

@@ -19,7 +19,6 @@ app = Class.new(Hanami::API) do
   end
 end.new
 
-use OpenapiFirst::Router, spec: File.absolute_path('./openapi.yaml', __dir__)
-use OpenapiFirst::RequestValidation
+use OpenapiFirst::RequestValidation, spec: File.absolute_path('./openapi.yaml', __dir__)
 
 run app

data/benchmarks/apps/openapi_first_with_plain_rack.ru

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'multi_json'
+require 'openapi_first'
+
+app = Rack::Builder.new do
+  use OpenapiFirst::RequestValidation, spec: File.expand_path('./openapi.yaml', __dir__)
+
+  handlers = {
+    'find_thing' => lambda do |env|
+      params = env[OpenapiFirst::PARAMS]
+      body = MultiJson.dump(hello: 'world', id: params.fetch('id'))
+      [200, { 'Content-Type' => 'application/json' }, [body]]
+    end,
+    'find_things' => lambda do |_env|
+      body = MultiJson.dump(hello: 'world')
+      [200, { 'Content-Type' => 'application/json' }, [body]]
+    end,
+    'create_thing' => lambda do |_env|
+      body = MultiJson.dump(hello: 'world')
+      [201, { 'Content-Type' => 'application/json' }, [body]]
+    end
+  }
+
+  not_found = ->(_env) { [404, {}, []] }
+
+  run lambda do |env|
+    handlers.fetch(env[OpenapiFirst::OPERATION]&.operation_id, not_found).call(env)
+  end
+end
+
+run app

data/benchmarks/apps/openapi_first_with_response_validation.ru

@@ -2,21 +2,24 @@
 
 require 'multi_json'
 require 'openapi_first'
+require 'hanami/api'
 
-namespace = Module.new do
-  def self.find_thing(params, _res)
-    { hello: 'world', id: params.fetch(:id) }
+app = Class.new(Hanami::API) do
+  get '/hello/:id' do
+    json(hello: 'world', id: params.fetch(:id))
   end
 
-  def self.find_things(_params, _res)
-    [{ hello: 'world' }]
+  get '/hello' do
+    json([{ hello: 'world' }])
   end
 
-  def self.create_thing(_params, res)
-    res.status = 201
-    { hello: 'world' }
+  post '/hello' do
+    status 201
+    json(hello: 'world')
   end
-end
+end.new
 
-oas_path = File.absolute_path('./openapi.yaml', __dir__)
-run OpenapiFirst.app(oas_path, namespace: namespace, response_validation: true)
+use OpenapiFirst::RequestValidation, spec: File.absolute_path('./openapi.yaml', __dir__)
+use OpenapiFirst::ResponseValidation
+
+run app

data/benchmarks/apps/openapi_first_with_sinatra.ru

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'multi_json'
+require 'openapi_first'
+require 'sinatra'
+
+class SinatraWithOpenapiFirstExample < 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 OpenapiFirst::RequestValidation, spec: File.absolute_path('./openapi.yaml', __dir__)
+
+run SinatraWithOpenapiFirstExample