crux_structs v0.1.6 Crux.Structs behaviour View Source
Provides a unified function to create one or a list of structs, invoking their create/1
function if available.
Link to this section Summary
Functions
Creates a struct or a list of structs invoking their create/1
function if available
Callbacks
Can be implemented by structs to transform the inital data
Link to this section Functions
Creates a struct or a list of structs invoking their create/1
function if available.
Examples
# A single member
iex> %{
...> "nick" => "nick",
...> "user" => %{"username" => "space", "discriminator" => "0001", "id" => "218348062828003328", "avatar" => "646a356e237350bf8b8dfde15667dfc4"},
...> "roles" => ["251158405832638465", "373405430589816834"],
...> "mute" => false,
...> "deaf" => false,
...> "joined_at" => "2016-11-02T00:51:21.342000+00:00"
...> }
...> |> Crux.Structs.create(Crux.Structs.Member)
%Crux.Structs.Member{
nick: "nick",
user: 218348062828003328,
roles: MapSet.new([251158405832638465, 373405430589816834]),
mute: false,
deaf: false,
joined_at: "2016-11-02T00:51:21.342000+00:00",
guild_id: nil
}
# A single user
iex> %{"username" => "space", "discriminator" => "0001", "id" => "218348062828003328", "avatar" => "46a356e237350bf8b8dfde15667dfc4"}
...> |> Crux.Structs.create(Crux.Structs.User)
%Crux.Structs.User{username: "space", discriminator: "0001", id: 218348062828003328, avatar: "46a356e237350bf8b8dfde15667dfc4"}
# Multiple users
iex> [
...> %{"username" => "space", "discriminator" => "0001", "id" => "218348062828003328", "avatar" => "46a356e237350bf8b8dfde15667dfc4"},
...> %{"username" => "Drahcirius", "discriminator" => "1336", "id" => "130175406673231873", "avatar" => "c896aebec82c90f590b08cfebcdc4e3b"}
...> ]
...> |> Crux.Structs.create(Crux.Structs.User)
[
%Crux.Structs.User{username: "space", discriminator: "0001", id: 218348062828003328, avatar: "46a356e237350bf8b8dfde15667dfc4"},
%Crux.Structs.User{username: "Drahcirius", discriminator: "1336", id: 130175406673231873, avatar: "c896aebec82c90f590b08cfebcdc4e3b"}
]
# Does not alter already structs
iex> Crux.Structs.create(
...> %Crux.Structs.User{username: "space", discriminator: "0001", id: 218348062828003328, avatar: "46a356e237350bf8b8dfde15667dfc4"},
...> Crux.Structs.User
...> )
%Crux.Structs.User{username: "space", discriminator: "0001", id: 218348062828003328, avatar: "46a356e237350bf8b8dfde15667dfc4"}
# Fallback
iex> Crux.Structs.create(nil, nil)
nil
Link to this section Callbacks
Can be implemented by structs to transform the inital data.