API for generating an implementation AST for the get_part_acc/3 and get_part_item/3 callbacks.

Item structs

defmodule MyLib.Person do
  use DevJoy.Scene

  defstruct ~w[:age, :name]a
end

defmodule MyLib.Item do
  use DevJoy.Scene

  defstruct ~w[:name]a
end

Item DSL

defmodule MyLib.Scene do
  defmacro person(name, age, do: items_block) do
    fields = [age: age, name: name]
    %DevJoy.API.Item.generate(MyLib.Person, fields, __CALLER__, ~w[name]a, items_block)
  end

  defmacro item(name) do
    fields = [name: name]
    %DevJoy.API.Item.generate(MyLib.Item, fields, __CALLER__, ~w[name]a)
  end
end

Item usage

defmodule MyApp.SceneName do
  use DevJoy.Scene

  import MyLib.Scene

  part :main do
    accumulate MyLib.Item, {nil, true, true}

    person "John Doe", 30 do
      item "ID card"
    end
  end
end

Item usage formatting

To ensure that the formatter would not add parentheses for your DSL add it to the locals_without_parens root option in the .formatter.exs file located in the project root. When creating a library please make sure to also export the same information

dsl = [item: :1, person: :3]

[
  export: [locals_without_parens: dsl],
  locals_without_parens: dsl
]

so it's possible to import it by:

[import_deps: [:my_lib]]

Item fetching

person = MyApp.SceneName.get_part_item(:main, 1)
acc = MyApp.SceneName.get_part_acc(:main, 1)
items = Map.get(acc, {MyLib.Item, nil}, [])

is_struct(person, MyLib.Person) and is_list(items) and length(list) == 1
# => true
person.name == "John Doe" and person.age == 30
# => true

item = hd(items)
is_struct(item, MyLib.Item) and item.name == "ID card"
# => true