ruby-grape / grape / 25572035795

97%

master: 97%

Pull #2705

github

Add Grape.config.warn_on_helper_overrides

A helper method defined via `helpers do; def foo; end; end` is mixed
into the endpoint's singleton class and therefore takes precedence
over `Grape::Endpoint#foo` if one exists. That's the documented and
correct behaviour, but it's silent — when the framework gains a new
method (e.g. `Grape::Endpoint#logger`) and a user already defined a
helper of the same name, nothing tells them their helper now masks
the framework implementation.

Adds an opt-in dev-time signal:

    # config/environments/development.rb (or equivalent)
    Grape.config.warn_on_helper_overrides = true

When enabled, defining a `helpers` module — either via a block or by
passing an external module to `helpers SomeModule` — emits one
warning to `$stderr` per helper method that masks a `Grape::Endpoint`
instance method. Off by default; zero cost in production.

Enabled in `spec_helper.rb` so future test additions that
accidentally mask `Endpoint` methods via helpers surface as warnings
during CI.

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

1084 of 1169 branches covered (92.73%)

Branch coverage included in aggregate %.

7 of 7 new or added lines in 2 files covered. (100.0%)

3418 of 3475 relevant lines covered (98.36%)

32092.83 hits per line