View Source Shorthand (Shorthand v1.0.0)
Convenience macros to eliminate laborious typing. Provides macros for short map, string keyed map, keyword lists, and structs (ES6 like style)
examples
Examples:
These examples use variable arguments (default is 10, see configuration below)
Instead of %{one: one, two: two, three: three}, you can type m(one, two, three)
Instead of my_func(one: one, two: two, three: three), you can type my_func(kw(one, two, three))
Instead of %MyStruct(one: one, two: two, three: three), you can type st(MyStruct, one, two, three)
without-variable-arguemnts
Without variable arguemnts,
Instead of %{one: one, two: two, three: three}, you can type m([one, two, three])
Instead of my_func(one: one, two: two, three: three), you can type my_func(kw([one, two, three]))
Instead of %MyStruct(one: one, two: two, three: three), you can type bulid_struct(MyStruct, [one, two, three])
configuration
Configuration
For the convenience of m(a, b, c, d, e, f, g, h, i, j) instead of m([a, b, c, d, e, f, g, h, i, j]) Shorthand generates multiple copies of each macro like m/1, m/2, m/3, …, m/10. You can configure how many of these "variable argument" macros are generated.
config :shorthand,
variable_args: 10 # false to remove variable arguemnts
usage
Usage
You can import the Shorthand module and call each macro
defmodule MyModule do
import Shorthand
def my_func(m(a, b)) do
kw(a, b)
end
endor you can require the module and prefix calls with the module name (example uses a module alias to keep the typing low
defmodule MyModule do
require Shorthand, as: S
def my_func(S.m(a, b)) do
S.kw(a, b)
end
end
phoenix-examples
Phoenix Examples
defmodule MyController do
# ...
def index(conn, sm(id)) do
model = Repo.get(MyModel, id)
# ...
end
def create(conn, sm(my_model: sm(first_name, last_name) = params)) do
changeset = MyModel.changeset(%MyModel{}, params) # params contains all form fields, not just first_name and last_name
# ...
conn
|> put_flash(:notice, "User #{first_name} #{last_name} was created successfully")
# ...
end
endLink to this section Summary
Functions
Builds a keyword list where the keys and value arguments are the same name
Builds a map where the keys and values have the same name
Builds a map where the string keys and values have the same name
Builds a struct where the field names are the same as the arguments supplied
Link to this section Functions
Builds a keyword list where the keys and value arguments are the same name
example
Example:
iex> a = 1
iex> b = 2
iex> c = 3
iex> kw(a, b, c)
[a: 1, b: 2, c: 3]
examples
Examples
iex> c = 3
iex> kw(a, _b, ^c) = [a: 1, b: 3, c: 3]
iex> a
1
iex> match?(kw(^a), [a: 2])
falsekw(arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10)
View Source (macro)Builds a map where the keys and values have the same name
example
Example:
iex> a = 1
iex> b = 2
iex> m(a, b)
%{a: 1, b: 2}
example-1
Example:
iex> a = 1
iex> c = 2
iex> m(a, b: m(c), d: nil)
%{a: 1, b: %{c: 2}, d: nil}
example-2
Example:
iex> a = 1
iex> m(^a, _b, c) = %{a: 1, b: 3, c: 2}
iex> c
2
iex> match?(m(^a), %{a: 2})
false
example-3
Example:
iex> m(model: m(a, b) = params) = %{model: %{a: 1, b: 2, c: 3, d: 4}}
iex> params
%{a: 1, b: 2, c: 3, d: 4}
iex> a
1
iex> b
2m(arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10)
View Source (macro)Builds a map where the string keys and values have the same name
example
Example:
iex> a = 1
iex> b = 2
iex> sm(a, b)
%{"a" => 1, "b" => 2}
example-1
Example:
iex> a = 1
iex> b = 2
iex> sm(a, other: sm(b))
%{"a" => 1, "other" => %{"b" => 2}}
example-2
Example:
iex> a = 1
iex> sm(^a, _b, c) = %{"a" => 1, "b" => 3, "c" => 2}
iex> c
2
iex> match?(sm(^a), %{"a" => 2})
false
example-3
Example:
iex> sm(model: sm(a, b) = params) = %{"model" => %{"a" => 1, "b" => 2, "c" => 3, "d" => 4}}
iex> params
%{"a" => 1, "b" => 2, "c" => 3, "d" => 4}
iex> a
1
iex> b
2sm(arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10)
View Source (macro)Builds a struct where the field names are the same as the arguments supplied
example
Example:
iex> scheme = "https"
iex> host = "elixir-lang.org"
iex> path = "/docs.html"
iex> st(URI, scheme, host, path)
%URI{scheme: "https", host: "elixir-lang.org", path: "/docs.html"}