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

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

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

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

    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

  options[:anchor] = true unless options.key?(:anchor)

  if options[:on] && !VALID_ON_OPTIONS.include?(options[:on])
    raise ArgumentError, "Unknown scope #{on.inspect} given to :on"
  end

  if @scope[:controller] && @scope[:action]
    options[:to] ||= "#{@scope[:controller]}##{@scope[:action]}"
  end

  paths.each do |_path|
    route_options = options.dup
    route_options[:path] ||= _path if _path.is_a?(String)

    path_without_format = _path.to_s.sub(/\(\.:format\)$/, '')
    if using_match_shorthand?(path_without_format, route_options)
      route_options[:to] ||= path_without_format.gsub(%r{^/}, "").sub(%r{/([^/]*)$}, '#\1')
      route_options[:to].tr!("-", "_")
    end

    decomposed_match(_path, route_options)
  end
  self
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1412
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(parent_resource.member_scope) { yield }
    else
      scope(parent_resource.member_scope) { yield }
    end
  end
end

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

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1438
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(parent_resource.nested_scope, nested_options) { yield }
    else
      scope(parent_resource.nested_scope, nested_options) { yield }
    end
  end
end

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

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

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

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

  resource_scope(:resource, SingletonResource.new(resources.pop, options)) do
    yield if block_given?

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

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

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

    set_member_mappings_for_resource
  end

  self
end

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

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

  resource_scope(:resources, Resource.new(resources.pop, 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

  self
end

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

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1566
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
      scope(parent_resource.path) do
        super(options)
      end
    end
  else
    super(options)
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1461
def shallow
  scope(:shallow => true) do
    yield
  end
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1467
def shallow?
  parent_resource.instance_of?(Resource) && @scope[:shallow]
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1524
def using_match_shorthand?(path, options)
  path && (options[:to] || options[:action]).nil? && path =~ %r{^/?[-\w]+/[-\w/]+$}
end

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1774
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 1653
def with_exclusive_scope
  begin
    @scope = @scope.new(:as => nil, :path => nil)

    with_scope_level(:exclusive) do
      yield
    end
  ensure
    @scope = @scope.parent
  end
end

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