defmodule Crudry.Resolver do @moduledoc """ Generates CRUD functions to DRY Absinthe Resolvers. Requires a previously generated Context. ## Usage To generate CRUD functions for a given schema resolver, simply do defmodule MyApp.MyResolver do alias MyApp.Repo alias MyApp.MyContext alias MyApp.MySchema require Crudry Crudry.Resolver.generate_functions MyContext, MySchema end And the resolver will become defmodule MyApp.MyResolver do alias MyApp.Repo alias MyApp.MyContext alias MyApp.MySchema require Crudry def get_my_schema(%{id: id}, _info) do MyContext.get_my_schema(id) |> nil_to_error(fn record -> {:ok, record} end) end def list_my_schemas(_args, _info) do MyContext.list_my_schemas() end def create_my_schema(%{my_schema: params}, _info) do MyContext.create_my_schema(params) end def update_my_schema(%{id: id, my_schema: params}, _info) do MyContext.get_my_schema(id) |> nil_to_error(fn record -> MyContext.update_my_schema(record, params) end) end def delete_my_schema(%{id: id}, _info) do MyContext.get_my_schema(id) |> nil_to_error(fn record -> MyContext.delete_my_schema(record) end) end # If `result` is `nil`, return an error. Otherwise, apply `func` to the `result`. def nil_to_error(result, func) do case result do nil -> {:error, "MySchema not found."} %{} = record -> func.(record) end end end Now, suppose the update resolver for our schema should update not only the schema but also some of its associations. defmodule MyApp.Resolver do alias MyApp.Repo alias MyApp.MyContext alias MyApp.MySchema require Crudry Crudry.Resolver.generate_functions MyContext, MySchema, except: [:update] def update_my_schema(%{id: id, my_schema: params}, _info) do MyContext.get_my_schema(id) |> nil_to_error(fn record -> MyContext.update_my_schema_with_assocs(record, params, [:assoc]) end) end end By using the `nil_to_error` function, we DRY the nil checking and also ensure the error message is the same as the other auto-generated functions. """ @doc """ Sets default options for the resolver. ## Options * `:only` - list of functions to be generated. If not empty, functions not specified in this list are not generated. Default to `[]`. * `:except` - list of functions to not be generated. If not empty, only functions not specified in this list will be generated. Default to `[]`. ## Examples iex> Crudry.Resolver.default only: [:create, :list] :ok iex> Crudry.Resolver.default except: [:get!, :list, :delete] :ok """ defmacro default(opts) do Module.put_attribute(__CALLER__.module, :only, opts[:only]) Module.put_attribute(__CALLER__.module, :except, opts[:except]) end @doc """ Generates CRUD functions for the `schema_module` resolver. Custom options can be given. To see the available options, refer to the documenation of `Crudry.Resolver.default/1`. ## Examples Suppose we want to implement basic CRUD functionality for a User resolver, assuming there is an Accounts context which already implements CRUD functions for User. defmodule MyApp.AccountsResolver do require Crudry Crudry.Resolver.generate_functions Accounts, Accounts.User end Now, all this functionality is available: AccountsResolver.get_user(%{id: id}, info) AccountsResolver.list_users(_args, info) AccountsResolver.crete_user(%{user: params}, info) AccountsResolver.update_user(%{id: id, user: params}, info) AccountsResolver.delete_user(%{id: id}, info) AccountsResolver.nil_to_error(result, func) """ defmacro generate_functions(context, schema_module, opts \\ []) do opts = Keyword.merge(load_default(__CALLER__.module), opts) name = Helper.get_underscored_name(schema_module) _ = String.to_atom(name) # Always generate nil_to_error function since it's used in the other generated functions for func <- [:nil_to_error, :get, :list, :create, :update, :delete] do if func == :nil_to_error || Helper.define_function?(func, opts[:only], opts[:except]) do ResolverFunctionsGenerator.generate_function(func, name, context) end end end # Load user-defined defaults or fall back to the library's default. defp load_default(module) do only = Module.get_attribute(module, :only) except = Module.get_attribute(module, :except) [ only: only || [], except: except || [] ] end end