Current section

Files

Jump to
phoenix lib phoenix router resources_context.ex
Raw

lib/phoenix/router/resources_context.ex

defmodule Phoenix.Router.ResourcesContext do
alias Phoenix.Router.Path
alias Phoenix.Router.Stack
import Inflex
@stack_name :nested_resources
@moduledoc """
Helper functions for pushing and popping nested Route resources
and maintaining resource state during nested expansion
"""
@doc """
Returns the String route path based on current context
of module and relative path.
# Examples
resources "users", Users do
resources "comments", Comments
-------------------------------
Context.current_path("comments")
=> "users/:user_id/comments"
-------------------------------
end
resources "pages", Pages
---------------------------------
Context.current_path("pages")
=> "pages"
---------------------------------
"""
def current_path(relative_path, module) do
case get(module) do
[] -> relative_path
resources -> resources
|> Enum.reverse
|> Enum.map(&resource_with_named_param(&1))
|> Kernel.++([relative_path])
|> Path.join
end
end
@doc """
Returns the current alias of the route given module's nested context
# Examples
resources "users", Users do
resources "comments", Comments
-------------------------------
Context.current_alias(:index, "comments", __MODULE__)
=> "user_comments"
Context.current_alias(:show, "comments", __MODULE__)
=> "user_comment"
Context.current_alias(:edit, "comments", __MODULE__)
=> "edit_user_comment"
-------------------------------
end
resources "pages", Pages
---------------------------------
Context.current_alias(:index, "pages", __MODULE__)
=> "pages"
Context.current_alias(:new, "pages", __MODULE__)
=> "new_page"
---------------------------------
"""
def current_alias(action, relative_path, module) do
resources = get(module) |> Enum.reverse |> Enum.map(&singularize(&1))
alias_for_action(action, resources, relative_path)
end
defp alias_for_action(:index, resources, rel_path) do
resources
|> Kernel.++([pluralize(rel_path)])
|> Enum.join("_")
end
defp alias_for_action(action, resources, rel_path) when action in [:new, :edit] do
[action]
|> Kernel.++(resources)
|> Kernel.++([singularize(rel_path)])
|> Enum.join("_")
end
defp alias_for_action(:show, resources, rel_path) do
resources
|> Kernel.++([singularize(rel_path)])
|> Enum.join("_")
end
defp alias_for_action(_action, _resources, _rel_path), do: nil
@doc """
Pushes the current resource onto resources stack
"""
def push(resource, module) do
Stack.push(resource, @stack_name, module)
end
@doc """
Pops the current resource off resources stack
"""
def pop(module) do
Stack.pop(@stack_name, module)
end
defp get(module) do
Stack.get(@stack_name, module)
end
@doc """
Appends the singularized inflection of named resource parameter based
on current route resource
# Examples
iex> Phoenix.Router.Context.resource_with_named_param("users")
"users/:user_id"
"""
def resource_with_named_param(resource) do
Path.join([resource, ":#{singularize(resource)}_id"])
end
end