- Add null type for schemas with
nullable
types while loading the schema.
-
Use rj_schema gem for response body json validation
BREAKING CHANGE: After this change validating against schemas with
nullable
will not work correctly. The definitions should be modified to use oneOf element with a childred "null" and the original type to achieve the same effect.
- Fix: Query parameter validation does not fail if header parameters are defined (Thanks to JF Lalonde)
- Update Ruby dependency to >= 3.0.5
- Handle simple form-data in request bodies (see ahx#149)
- Update to hanami-router 2.0.0 stable
- You can pass a filepath to
spec:
now so you no longer have to callOpenapiFirst.load
anymore. - Router is optional now.
You no longer have to add
Router
to your middleware stack. You still can add it to customize behaviour by setting options, but you no longer have to add it. If you don't add the Router, make sure you passspec:
to your request/response validation middleware. - Support "4xx" and "4XX" response definitions. (4XX is defined in the standard, but 2xx is used in the wild as well 🦁.)
- Removed warning about missing operationId, because operationId is not used until the Responder is used.
- Raise HandlerNotFoundError when handler cannot be found
-
Add
RackResponder
-
BREAKING CHANGE: Handler classes are now instantiated only once without any arguments and the same instance is called on each following call/request.
Yanked. No useful changes.
- BREAKING CHANGE: Use a Hash instead of named arguments for middleware options for better compatibility Using named arguments is actually not supported in Rack.
- Pin hanami-router version, because alpha6 is broken.
- Support status code wildcards like "2XX", "4XX"
- Populate default parameter values
- Use json_refs to resolve OpenAPI file. This removes oas_parser and ActiveSupport from list of dependencies
- 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.
- Fix: Don't mix path- and operation-level parameters for request validation
- 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
- Better error message if string does not match format
- readOnly and writeOnly just works when used inside allOf
- Return indicator (
source: { parameter: 'list/1' }
) in error response body when array item in query parameter is invalid
- Add support for arrays in query parameters (style: form, explode: false)
- Remove warning when handler is not implemented
- Add
not_found: :continue
option to Router to make it do nothing if request is unknown
- content-type is found while ignoring additional content-type parameters (
application/json
is found when request/response content-type isapplication/json; charset=UTF8
) - Support wildcard mime-types when finding the content-type
- Add
response_validation:
,router_raise_error
options to standalone mode.
- Allow response to have no media type object specified
- Fix response when handler returns 404 or 405
- Don't validate the response content if status is 204 (no content)
- 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) - Add
raise_error
option to OpenapiFirst.app (false by default) - Add ResponseValidation to OpenapiFirst.app if raise_error option is true
- Rename
raise
option toraise_error
- Add
raise_error
option to RequestValidation middleware - Raise error if handler could not be found by Responder
- Add
Operation#name
that returns a human readable name for an operation
- 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
- Add ResponseValidation middleware that validates the response body
- Add
raise
option to Router middleware to raise an error if request could not be found in the API description similar to committee's raise option. - Move namespace option from Router to OperationResolver
- Return 400 if request body has invalid JSON (issue) thanks Thomas Frütel
- Fix duplicated key in
required
when generating JSON schema forsome[thing]
parameters
- Add support for query parameters named
"some[thing]"
(issue)
- Make request validation usable standalone
- 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 totrue
/false
- Rename
OpenapiFirst::PARAMS
toOpenapiFirst::PARAMETERS
- Add missing
require
to work with new version ofoas_parser
- 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
orFloat
- Pass the Rack env if your action class' initializers accepts an argument
- Respec rack's
env['SCRIPT_NAME']
in router - Add MIT license
- Bugfix: params.env['unknown'] now returns
nil
as expected. Thanks @tristandruyen.
- Removed radix tree, because of a bug (namusyaka/r2ree-ruby#2)
- Performance: About 25% performance increase (i/s) with help of c++ based radix-tree and some optimizations
- Update dependencies
- Fix: version number of oas_parser
- Remove warnings for Ruby 2.7
- Merge QueryParameterValidation and ReqestBodyValidation middlewares into RequestValidation
- Rename option to
allow_unknown_query_paramerters
- Fix: Rewind request body after reading
- Add option to parse only certain paths from OAS file
- Add support to map operationIds like
things#index
orweb.things_index
- Make ResponseValidator errors easier to read
- Set the content-type based on the OpenAPI description #29
- Add CHANGELOG 📝