TODO: Deprecate

Get the current path.

Each Absinthe.Resolution struct holds the current result path as a list of blueprint nodes and indices. Usually however you don’t need the full AST list and instead just want the path that will eventually end up in the result.

For that, use this function.

Examples

Given some query:

{users { email }}

If you called this function inside a resolver on the users email field it returns a value like:

resolve fn _, _, resolution ->
  Absinthe.Resolution.path(resolution) #=> ["users", 5, "email"]
end

In this case 5 is the 0 based index in the list of users the field is currently at.

Get the child fields under the current field.

See project/2 for details.

Get the child fields under the current field.

Example

Given a document like:

{ user { id name }}

field :user, :user do
  resolve fn _, info ->
    child_fields = Absinthe.Resolution.project(info) |> Enum.map(&(&1.name))
    # ...
  end
end

child_fields will be ["id", "name"].

It correctly handles fragments, so for example if you had the document:

{
  user {
    ... on User {
      id
    }
    ... on Named {
      name
    }
  }
}

you would still get a nice and simple child_fields that was ["id", "name"].

Handy function for applying user function result tuples to a resolution struct

User facing functions generally return one of several tuples like {:ok, val} or {:error, reason}. This function handles applying those various tuples to the resolution struct.

The resolution state is updated depending on the tuple returned. :ok and :error tuples set the state to :resolved, whereas middleware tuples set it to :unresolved.

This is useful for middleware that wants to handle user facing functions, but does not want to duplicate this logic.