Packages

localize

0.12.0
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.

HexDocs

Current section

Files

Jump to
Readme
57 Versions
4 Dependencies
Dependants
Files
Activity
localize lib localize utils json.ex
Raw

lib/localize/utils/json.ex 

defmodule Localize.Utils.Json do

  @moduledoc """

  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+.



  """



  @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

    {json, :ok, ""} = :json.decode(string, :ok, %{null: nil})

    json

  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

    }



    {json, :ok, ""} = :json.decode(string, :ok, decoders)

    json

  end



  def decode!(charlist, options) when is_list(charlist) do

    charlist

    |> :erlang.iolist_to_binary()

    |> decode!(options)

  end

end