Versionary: Elixir plug for handling API versioning

Recently put together Versionary. A plug which makes it simple to handle versioning in your API. It hasn’t been released yet but is ready to go. Was hoping to get some feedback from the community before publishing it.

9 Likes

Version 0.1.0 of Versionary has been released.

GitHub: https://github.com/sticksnleaves/versionary
Documentation: https://hexdocs.pm/versionary/api-reference.html

3 Likes

Version 0.2.0 of Versionary has been released.

This release adds the ability to check for versions against media type config. This works similarly to Phoenix’s accepts plug.

config :mime, :types, %{
  "application/vnd.app.v1+json" => [:v1]
}

plug Versionary.Plug.VerifyHeader, accepts: [:v1]

This release also adds Versionary.Plug.PhoenixErrorHandler for rendering a Phoenix error view when validation fails.

GitHub: https://github.com/sticksnleaves/versionary
Documentation: https://hexdocs.pm/versionary/api-reference.html
Hex: https://hex.pm/packages/versionary

2 Likes