URI encode nested GET parameters and array values.
Prepares URI query parameters to be used in URI.encode_query/1
or HTTPoison.get/3
https://hexdocs.pm/uri_query/0.1.1/UriQuery.html
The package can be installed as:
- Add
uri_query
to your list of dependencies inmix.exs
:
def deps do
[{:uri_query, "~> 0.2.0"}]
end
- Ensure
uri_query
is started before your application:
def application do
[applications: [:uri_query]]
end
With list values
iex> UriQuery.params(foo: ["bar", "quux"]) |> URI.encode_query
"foo[0]=bar&foo[1]=quux"
iex> UriQuery.params([foo: ["bar", "quux"]], add_indices_to_lists: false) |> URI.encode_query
"foo[]=bar&foo[]=quux"
iex> HTTPoison.get("http://example.com", [], params: UriQuery.params(foo: ["bar", "quux"]))
With nested structures (maps or keyword lists)
iex> UriQuery.params(%{user: %{name: "Dougal McGuire", email: "[email protected]"}}) |> URI.encode_query
"user[email][email protected]&user[name]=Dougal McGuire"
iex> params = %{user: %{name: "Dougal McGuire", email: "[email protected]"}} |> UriQuery.params
[{"user[email]", "[email protected]"}, {"user[name]", "Dougal McGuire"}]
iex> HTTPoison.get("http://example.com", [], params: params)
NOTE: Empty lists are ignored
iex> UriQuery.params(foo: []) |> URI.encode_query
""