PlugBest

Travis Hex.pm

PlugBest parses HTTP “Accept-*“ headers and returns the best match based on a list of values.

Installation

Add plug_best to the deps function in your project’s mix.exs file:

defp deps do
  [
    …,
    {:plug_best, "~> 0.1"}
  ]
end

Then run mix do deps.get, deps.compile inside your project’s directory.

Usage

PlugBest currently provides a single basic method:

  • best_language/2

And plans to add support for the following soon:

  • best_charset/2
  • best_encoding/2
  • best_media_type/2

To find out which language is the best one to use among a list of supported languages:

conn |> Plug.Conn.get_req_header("accept-language")
# => ["fr-CA,fr;q=0.8,en;q=0.6,en-US;q=0.4"]

conn |> PlugBest.best_language(["en", "fr"])
# => {"fr-CA", "fr", 1.0}

If no values in the header is support, PlugBest will return the first nil. However, you can use the _or_first suffix to make it return the first value in those cases.

conn |> Plug.Conn.get_req_header("accept-language")
# => ["fr-CA,fr;q=0.8,en;q=0.6,en-US;q=0.4"]

conn |> PlugBest.best_language(["es", "ru"])
# => nil

conn |> PlugBest.best_language_or_first(["es", "ru"])
# => {"es", "es", 0.0}

License

PlugBest is © 2016 Rémi Prévost and may be freely distributed under the MIT license. See the LICENSE.md file for more information.