rails--rails/actionpack/lib/abstract_controller/railties/routes_helpers.rb

# frozen_string_literal: true

module AbstractController
  module Railties
    module RoutesHelpers
      def self.with(routes, include_path_helpers = true)
        Module.new do
          define_method(:inherited) do |klass|
            super(klass)

            routes.include_helpers klass, include_path_helpers
          end
        end
      end
    end
  end
end
Use frozen string literal in actionpack/ 2017-07-24 16:20:53 -04:00			`# frozen_string_literal: true`

Move ActionController::Railties::RoutesHelpers and ActionMailer::Railties::RoutesHelper to AbstractController::Railties::RoutesHelpers 2010-08-02 11:38:44 -04:00			`module AbstractController`
Include application's helpers and router helpers by default, but include engine's ones for controllers inside isolated namespace 2010-07-30 01:14:48 -04:00			`module Railties`
			`module RoutesHelpers`
Deprecate `_path` methods in mailers Email does not support relative links since there is no implicit host. Therefore all links inside of emails must be fully qualified URLs. All path helpers are now deprecated. When removed, the error will give early indication to developers to use `_url` methods instead. Currently if a developer uses a `_path` helper, their tests and `mail_view` will not catch the mistake. The only way to see the error is by sending emails in production. Preventing sending out emails with non-working path's is the desired end goal of this PR. Currently path helpers are mixed-in to controllers (the ActionMailer::Base acts as a controller). All `_url` and `_path` helpers are made available through the same module. This PR separates this behavior into two modules so we can extend the `_path` methods to add a Deprecation to them. Once deprecated we can use this same area to raise a NoMethodError and add an informative message directing the developer to use `*_url` instead. The module with warnings is only mixed in when a controller returns false from the newly added `supports_relative_path?`. Paired @sgrif & @schneems 2014-06-19 18:26:29 -04:00			`def self.with(routes, include_path_helpers = true)`
Include routes helpers only for inherited classes in ActionMailer 2010-08-02 10:04:39 -04:00			`Module.new do`
			`define_method(:inherited) do \|klass\|`
			`super(klass)`
Allow helpers to be deferred until the routes have been finalized ActiveStorage::BaseController subclasses ActionController::Base. ActionController::Base has an "inherited" hook set that includes the routing helpers to any subclass of AC::Base. Since ActiveStorage::BaseController is a subclass of AC::Base, it will get routing helpers included automatically. Unfortunately, when the framework is eagerly loaded, ActiveStorage::BaseController is loaded before the applications routes are loaded which means it attempts to include an "in flight" module so it gets an exception. This commit allows a class that's interested in being extended with routing helpers register itself such that when the routes are finalized, it will get the helpers included. If the routes are already finalized, then the helpers get included immediately. 2018-09-25 17:58:39 -04:00
			`routes.include_helpers klass, include_path_helpers`
Include routes helpers only for inherited classes in ActionMailer 2010-08-02 10:04:39 -04:00			`end`
Include application's helpers and router helpers by default, but include engine's ones for controllers inside isolated namespace 2010-07-30 01:14:48 -04:00			`end`
			`end`
			`end`
			`end`
			`end`