ruby-grape / grape / 28783338172

97%

master: 97%

Pull #2785

github

Make route params a first-class endpoint input and split Route#params

`Route#params(input = nil)` did two unrelated jobs behind one signature:
with an input it extracted param values from a matched path (the router's
job); with no input it returned the declared param definitions (grape-
swagger's job, for docs). Split them:

- `Route#params` (no arg) returns the declared definitions.
- `Route#params_for(input)` extracts values; the router calls it.

The definitions also stop riding in the `route_options` bag. `params` is
now a first-class endpoint input:

- `Grape::Endpoint::Options` gains a `:params` member and `Endpoint.new`
  a `params:` keyword.
- The DSL composes it (declared params deep-merged with any from `desc`)
  via a `prepare_params` helper and passes it on its own, out of
  `route_options`.
- `to_routes` and `#declared` read `config.params`; `Route` receives it
  as a `params:` keyword backing `#params`.

Nothing outside grape read `route.options[:params]` (grape-swagger uses
the `route.params` method), so dropping it from the bag is safe.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

1126 of 1220 branches covered (92.3%)

Branch coverage included in aggregate %.

20 of 20 new or added lines in 6 files covered. (100.0%)

3595 of 3663 relevant lines covered (98.14%)

23354.3 hits per line