Packages
localize
1.0.0-rc.5
1.0.0-rc.6
1.0.0-rc.5
1.0.0-rc.4
1.0.0-rc.3
1.0.0-rc.2
1.0.0-rc.1
1.0.0-rc.0
0.50.0
0.49.0
0.48.0
0.47.0
0.46.0
0.45.0
0.44.0
0.41.3
0.41.2
0.41.1
0.41.0
0.40.0
0.39.0
0.38.0
0.37.0
0.36.0
0.35.0
0.34.0
0.33.0
0.32.0
0.31.0
0.30.1
0.30.0
retired
0.29.0
0.28.0
0.27.0
0.26.0
0.25.0
0.24.0
0.23.0
0.22.0
0.21.0
0.20.0
0.19.0
0.18.0
0.16.0
0.15.0
0.14.0
0.13.0
0.12.0
0.11.0
0.10.0
0.9.0
0.8.0
0.7.0
0.6.0
0.5.0
0.4.0
0.3.0
0.2.0
0.1.0
0.1.0-alpha.1
Localization (parsing, formatting) of numbers, dates/time/calendar, units of measure, messages and lists. Includes localized collation.
Current section
Files
Jump to
Current section
Files
lib/localize/utils/json.ex
defmodule Localize.Utils.Json do
# JSON decoding utilities wrapping the OTP `:json` module.
#
# Provides a `Jason`-compatible `decode!/1,2` interface suitable
# for decoding JSON data in Localize. Uses the built-in `:json`
# module available in OTP 27+.
#
@moduledoc false
@doc """
Decodes a JSON string into an Elixir term.
JSON `null` values are decoded as `nil`. By default, object keys
are strings. Pass `keys: :atoms` to decode keys as atoms.
### Arguments
* `string` — a JSON-encoded string or charlist.
### Options
* `:keys` — when set to `:atoms`, decodes object keys as atoms.
### Returns
* The decoded Elixir term.
### Examples
iex> Localize.Utils.Json.decode!(~s({"foo": 1}))
%{"foo" => 1}
iex> Localize.Utils.Json.decode!(~s({"foo": 1}), keys: :atoms)
%{foo: 1}
iex> Localize.Utils.Json.decode!(~s({"bar": null}))
%{"bar" => nil}
"""
@spec decode!(String.t() | charlist()) :: term()
def decode!(string) when is_binary(string) do
case :json.decode(string, :ok, %{null: nil}) do
{json, :ok, ""} -> json
{_json, :ok, rest} -> raise_trailing_data!(rest)
end
end
def decode!(charlist) when is_list(charlist) do
charlist
|> :erlang.iolist_to_binary()
|> decode!()
end
@spec decode!(String.t() | charlist(), keyword()) :: term()
def decode!(string, keys: :atoms) when is_binary(string) do
push = fn key, value, accumulator ->
[{String.to_atom(key), value} | accumulator]
end
decoders = %{
null: nil,
object_push: push
}
case :json.decode(string, :ok, decoders) do
{json, :ok, ""} -> json
{_json, :ok, rest} -> raise_trailing_data!(rest)
end
end
def decode!(charlist, options) when is_list(charlist) do
charlist
|> :erlang.iolist_to_binary()
|> decode!(options)
end
@spec raise_trailing_data!(binary()) :: no_return()
defp raise_trailing_data!(rest) do
raise ArgumentError,
"unexpected trailing data after the JSON document: " <>
inspect(rest, printable_limit: 50)
end
end