модуль ActionDispatch::Routing::Mapper::Resources

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1469
def collection
  unless resource_scope?
    raise ArgumentError, "can't use collection outside resource(s) scope"
  end

  with_scope_level(:collection) do
    path_scope(parent_resource.collection_scope) do
      yield
    end
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1604
def get_to_from_path(path, to, action)
  return to if to || action

  path_without_format = path.sub(/\(\.:format\)$/, '')
  if using_match_shorthand?(path_without_format)
    path_without_format.gsub(%r{^/}, "").sub(%r{/([^/]*)$}, '#\1').tr("-", "_")
  else
    nil
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1566
def match(path, *rest, &block)
  if rest.empty? && Hash === path
    options  = path
    path, to = options.find { |name, _value| name.is_a?(String) }

    if path.nil?
      ActiveSupport::Deprecation.warn 'Omitting the route path is deprecated. '                 'Specify the path with a String or a Symbol instead.'
      path = ''
    end

    case to
    when Symbol
      options[:action] = to
    when String
      if to =~ /#/
        options[:to] = to
      else
        options[:controller] = to
      end
    else
      options[:to] = to
    end

    options.delete(path)
    paths = [path]
  else
    options = rest.pop || {}
    paths = [path] + rest
  end

  if options.key?(:defaults)
    defaults(options.delete(:defaults)) { map_match(paths, options, &block) }
  else
    map_match(paths, options, &block)
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1492
def member
  unless resource_scope?
    raise ArgumentError, "can't use member outside resource(s) scope"
  end

  with_scope_level(:member) do
    if shallow?
      shallow_scope {
        path_scope(parent_resource.member_scope) { yield }
      }
    else
      path_scope(parent_resource.member_scope) { yield }
    end
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1541
def namespace(path, options = {})
  if resource_scope?
    nested { super }
  else
    super
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1520
def nested
  unless resource_scope?
    raise ArgumentError, "can't use nested outside resource(s) scope"
  end

  with_scope_level(:nested) do
    if shallow? && shallow_nesting_depth >= 1
      shallow_scope do
        path_scope(parent_resource.nested_scope) do
          scope(nested_options) { yield }
        end
      end
    else
      path_scope(parent_resource.nested_scope) do
        scope(nested_options) { yield }
      end
    end
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1508
def new
  unless resource_scope?
    raise ArgumentError, "can't use new outside resource(s) scope"
  end

  with_scope_level(:new) do
    path_scope(parent_resource.new_scope(action_path(:new))) do
      yield
    end
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1266
def resource(*resources, &block)
  options = resources.extract_options!.dup

  if apply_common_behavior_for(:resource, resources, options, &block)
    return self
  end

  with_scope_level(:resource) do
    options = apply_action_options options
    resource_scope(SingletonResource.new(resources.pop, api_only?, @scope[:shallow], options)) do
      yield if block_given?

      concerns(options[:concerns]) if options[:concerns]

      new do
        get :new
      end if parent_resource.actions.include?(:new)

      set_member_mappings_for_resource

      collection do
        post :create
      end if parent_resource.actions.include?(:create)
    end
  end

  self
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1427
def resources(*resources, &block)
  options = resources.extract_options!.dup

  if apply_common_behavior_for(:resources, resources, options, &block)
    return self
  end

  with_scope_level(:resources) do
    options = apply_action_options options
    resource_scope(Resource.new(resources.pop, api_only?, @scope[:shallow], options)) do
      yield if block_given?

      concerns(options[:concerns]) if options[:concerns]

      collection do
        get  :index if parent_resource.actions.include?(:index)
        post :create if parent_resource.actions.include?(:create)
      end

      new do
        get :new
      end if parent_resource.actions.include?(:new)

      set_member_mappings_for_resource
    end
  end

  self
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1241
def resources_path_names(options)
  @scope[:path_names].merge!(options)
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1674
def root(path, options = {})
  if path.is_a?(String)
    options[:to] = path
  elsif path.is_a?(Hash) and options.empty?
    options = path
  else
    raise ArgumentError, "must be called with a path and/or options"
  end

  if @scope.resources?
    with_scope_level(:root) do
      path_scope(parent_resource.path) do
        match_root_route(options)
      end
    end
  else
    match_root_route(options)
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1549
def shallow
  @scope = @scope.new(shallow: true)
  yield
ensure
  @scope = @scope.parent
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1556
def shallow?
  !parent_resource.singleton? && @scope[:shallow]
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1615
def using_match_shorthand?(path)
  path =~ %r{^/?[-\w]+/[-\w/]+$}
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1874
def api_only?
  @set.api_only?
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1862
def set_member_mappings_for_resource
  member do
    get :edit if parent_resource.actions.include?(:edit)
    get :show if parent_resource.actions.include?(:show)
    if parent_resource.actions.include?(:update)
      patch :update
      put   :update
    end
    delete :destroy if parent_resource.actions.include?(:destroy)
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1758
def with_scope_level(kind)
  @scope = @scope.new_level(kind)
  yield
ensure
  @scope = @scope.parent
end