Merge branch 'master' into dependabot-hex-ex_doc-0.27.3

Author: fatboypunk

README.md

@@ -75,6 +75,13 @@ def view() do
 end
 ```
 
+### JSON library selection
+
+ExCSSModules needs to parse JSON files in order to read the mappings between the base classe names and the autogenerated
+ones. You can specify which JSON parsing library you wish to use through the `:json_library` config option. If your
+project uses Phoenix, it is recommended to use the same library for both Phoenix and ExCSSModules. ExCSSModules uses
+[Poison](https://hex.pm/packages/poison) by default.
+
 ### ExCell
 ExCSSModules works perfectly with [ExCell](https://github.com/DefactoSoftware/ex_cell). By adding the following to your `web.ex` definition for cells you can automatically add the stylesheet in the same directory as your ExCell Cell:
 ```ex

lib/ex_css_modules/ex_css_modules.ex

@@ -40,7 +40,7 @@ defmodule ExCSSModules do
       true ->
         (filename <> ".json")
         |> File.read!()
-        |> Poison.decode!()
+        |> json_library().decode!()
 
       false ->
         %{}
@@ -209,4 +209,6 @@ defmodule ExCSSModules do
 
   defp join_class_name([_ | _] = list), do: Enum.join(list, " ")
   defp join_class_name([]), do: nil
+
+  defp json_library, do: Application.get_env(:ex_css_modules, :json_library, Poison)
 end

mix.exs

@@ -50,7 +50,7 @@ defmodule ExCSSModules.Mixfile do
       {:excoveralls, "~> 0.14.4", only: :test},
       {:dialyxir, "~> 1.1", only: [:dev, :test], runtime: false},
       {:phoenix_html, "~> 1.0 or ~> 2.0 or ~> 3.0"},
-      {:poison, "~> 4.0 or ~> 5.0"},
+      {:poison, "~> 4.0 or ~> 5.0", optional: true},
       {:mix_test_watch, "~> 1.1", only: :dev, runtime: false},
       {:credo, "~> 1.6", only: [:dev, :test], runtime: false}
     ]