Expose API logger via Grape::Endpoint#logger

[ericproulx]

Adds a Grape::Endpoint#logger accessor so the API's configured logger is reachable inside any endpoint context — without writing a helper.

Before

Calling logger inside a route, filter, or rescue_from block raised NoMethodError. The documented workaround (and the one used in benchmark/remounting.rb) was:

class VotingApi < Grape::API
  logger Logger.new($stdout)

  helpers do
    def logger
      VotingApi.logger
    end
  end

  get('/votes') { logger.info('hit') }
end

After

class VotingApi < Grape::API
  logger Logger.new($stdout)
  get('/votes') { logger.info('hit') }
end

logger works in every context whose self is the endpoint:

• route handlers
• before / before_validation / after_validation / after / finally filters
• rescue_from blocks
• helpers

Backwards compatibility

A user-defined helpers do; def logger; …; end still wins. Helpers are mixed into the endpoint's singleton class (call! does singleton_class.include(@helpers)), and singleton-class methods take precedence over instance methods on the class. So existing code that overrode logger continues to override it.

A spec verifies this: helpers do; def logger; 'overridden-helper'; end; end causes logger to return the helper's value, not the API's configured logger.

Files

File	What
lib/grape/endpoint.rb	One-line def logger; options[:for].logger; end.
benchmark/remounting.rb	Removes the now-unnecessary helpers do; def logger; ... end workaround.
spec/grape/endpoint/logger_spec.rb	4 examples — route, all five filter types, rescue_from, and the helpers-override-wins case.
CHANGELOG.md	Features entry.

Test plan

• bundle exec rspec spec/grape/endpoint/logger_spec.rb — 4 examples, 0 failures
• bundle exec rspec — full suite green (2,258 examples, up from 2,254)
• bundle exec rubocop lib/ spec/ — clean

Why this is its own PR

Splits cleanly out of #2703 (which catches exceptions inside rescue_from blocks). That PR's example wanted to call logger.error(...) from inside the user's handler — which doesn't work today, hence this addition. They're independent: #2703 ships the rescue redispatch; this ships the logger accessor.

🤖 Generated with Claude Code

[github-actions]

Danger Report

No issues found.

View run