mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
234 lines
5.7 KiB
Ruby
234 lines
5.7 KiB
Ruby
require 'delegate'
|
|
require 'active_support/core_ext/string/strip'
|
|
|
|
module ActionDispatch
|
|
module Routing
|
|
class RouteWrapper < SimpleDelegator
|
|
def endpoint
|
|
app.dispatcher? ? "#{controller}##{action}" : rack_app.inspect
|
|
end
|
|
|
|
def constraints
|
|
requirements.except(:controller, :action)
|
|
end
|
|
|
|
def rack_app
|
|
app.app
|
|
end
|
|
|
|
def verb
|
|
super.source.gsub(/[$^]/, '')
|
|
end
|
|
|
|
def path
|
|
super.spec.to_s
|
|
end
|
|
|
|
def name
|
|
super.to_s
|
|
end
|
|
|
|
def regexp
|
|
__getobj__.path.to_regexp
|
|
end
|
|
|
|
def json_regexp
|
|
str = regexp.inspect.
|
|
sub('\\A' , '^').
|
|
sub('\\Z' , '$').
|
|
sub('\\z' , '$').
|
|
sub(/^\// , '').
|
|
sub(/\/[a-z]*$/ , '').
|
|
gsub(/\(\?#.+\)/ , '').
|
|
gsub(/\(\?-\w+:/ , '(').
|
|
gsub(/\s/ , '')
|
|
Regexp.new(str).source
|
|
end
|
|
|
|
def reqs
|
|
@reqs ||= begin
|
|
reqs = endpoint
|
|
reqs += " #{constraints.to_s}" unless constraints.empty?
|
|
reqs
|
|
end
|
|
end
|
|
|
|
def controller
|
|
requirements[:controller] || ':controller'
|
|
end
|
|
|
|
def action
|
|
requirements[:action] || ':action'
|
|
end
|
|
|
|
def internal?
|
|
controller.to_s =~ %r{\Arails/(info|mailers|welcome)} || path =~ %r{\A#{Rails.application.config.assets.prefix}\z}
|
|
end
|
|
|
|
def engine?
|
|
rack_app.respond_to?(:routes)
|
|
end
|
|
end
|
|
|
|
##
|
|
# This class is just used for displaying route information when someone
|
|
# executes `rake routes` or looks at the RoutingError page.
|
|
# People should not use this class.
|
|
class RoutesInspector # :nodoc:
|
|
def initialize(routes)
|
|
@engines = {}
|
|
@routes = routes
|
|
end
|
|
|
|
def format(formatter, filter = nil)
|
|
routes_to_display = filter_routes(filter)
|
|
|
|
routes = collect_routes(routes_to_display)
|
|
|
|
if routes.none?
|
|
formatter.no_routes
|
|
return formatter.result
|
|
end
|
|
|
|
formatter.header routes
|
|
formatter.section routes
|
|
|
|
@engines.each do |name, engine_routes|
|
|
formatter.section_title "Routes for #{name}"
|
|
formatter.section engine_routes
|
|
end
|
|
|
|
formatter.result
|
|
end
|
|
|
|
private
|
|
|
|
def filter_routes(filter)
|
|
if filter
|
|
@routes.select { |route| route.defaults[:controller] == filter }
|
|
else
|
|
@routes
|
|
end
|
|
end
|
|
|
|
def collect_routes(routes)
|
|
routes.collect do |route|
|
|
RouteWrapper.new(route)
|
|
end.reject do |route|
|
|
route.internal?
|
|
end.collect do |route|
|
|
collect_engine_routes(route)
|
|
|
|
{ name: route.name,
|
|
verb: route.verb,
|
|
path: route.path,
|
|
reqs: route.reqs,
|
|
regexp: route.json_regexp }
|
|
end
|
|
end
|
|
|
|
def collect_engine_routes(route)
|
|
name = route.endpoint
|
|
return unless route.engine?
|
|
return if @engines[name]
|
|
|
|
routes = route.rack_app.routes
|
|
if routes.is_a?(ActionDispatch::Routing::RouteSet)
|
|
@engines[name] = collect_routes(routes.routes)
|
|
end
|
|
end
|
|
end
|
|
|
|
class ConsoleFormatter
|
|
def initialize
|
|
@buffer = []
|
|
end
|
|
|
|
def result
|
|
@buffer.join("\n")
|
|
end
|
|
|
|
def section_title(title)
|
|
@buffer << "\n#{title}:"
|
|
end
|
|
|
|
def section(routes)
|
|
@buffer << draw_section(routes)
|
|
end
|
|
|
|
def header(routes)
|
|
@buffer << draw_header(routes)
|
|
end
|
|
|
|
def no_routes
|
|
@buffer << <<-MESSAGE.strip_heredoc
|
|
You don't have any routes defined!
|
|
|
|
Please add some routes in config/routes.rb.
|
|
|
|
For more information about routes, see the Rails guide: http://guides.rubyonrails.org/routing.html.
|
|
MESSAGE
|
|
end
|
|
|
|
private
|
|
def draw_section(routes)
|
|
header_lengths = ['Prefix', 'Verb', 'URI Pattern'].map(&:length)
|
|
name_width, verb_width, path_width = widths(routes).zip(header_lengths).map(&:max)
|
|
|
|
routes.map do |r|
|
|
"#{r[:name].rjust(name_width)} #{r[:verb].ljust(verb_width)} #{r[:path].ljust(path_width)} #{r[:reqs]}"
|
|
end
|
|
end
|
|
|
|
def draw_header(routes)
|
|
name_width, verb_width, path_width = widths(routes)
|
|
|
|
"#{"Prefix".rjust(name_width)} #{"Verb".ljust(verb_width)} #{"URI Pattern".ljust(path_width)} Controller#Action"
|
|
end
|
|
|
|
def widths(routes)
|
|
[routes.map { |r| r[:name].length }.max || 0,
|
|
routes.map { |r| r[:verb].length }.max || 0,
|
|
routes.map { |r| r[:path].length }.max || 0]
|
|
end
|
|
end
|
|
|
|
class HtmlTableFormatter
|
|
def initialize(view)
|
|
@view = view
|
|
@buffer = []
|
|
end
|
|
|
|
def section_title(title)
|
|
@buffer << %(<tr><th colspan="4">#{title}</th></tr>)
|
|
end
|
|
|
|
def section(routes)
|
|
@buffer << @view.render(partial: "routes/route", collection: routes)
|
|
end
|
|
|
|
# the header is part of the HTML page, so we don't construct it here.
|
|
def header(routes)
|
|
end
|
|
|
|
def no_routes
|
|
@buffer << <<-MESSAGE.strip_heredoc
|
|
<p>You don't have any routes defined!</p>
|
|
<ul>
|
|
<li>Please add some routes in <tt>config/routes.rb</tt>.</li>
|
|
<li>
|
|
For more information about routes, please see the Rails guide
|
|
<a href="http://guides.rubyonrails.org/routing.html">Rails Routing from the Outside In</a>.
|
|
</li>
|
|
</ul>
|
|
MESSAGE
|
|
end
|
|
|
|
def result
|
|
@view.raw @view.render(layout: "routes/table") {
|
|
@view.raw @buffer.join("\n")
|
|
}
|
|
end
|
|
end
|
|
end
|
|
end
|