joken v2.0.0 Release Notes

Release Date: 2018-11-21 // over 5 years ago
  • This is a re-write with a focus on making a clearer API surface with less ambiguity and more future proof without breaking backwards compatibility once again.

    For changes on versions 1.x look on the v1.5 branch.

    โœจ Enhancements

    • ๐Ÿ‘€ Ease of key configuration. We provide optional built-in support with Elixir's Mix.Config system. See our configuration guide for more details;
    • ๐Ÿ”ง Portable configuration using Joken.Claim;
    • Encapsulate your token logic in a module with Joken.Config;
    • ๐Ÿ‘ Better error handling. We provide a lot more context in error messages;
    • ๐Ÿ“š A good performance analysis for ensuring this hot-path in APIs won't be your bottleneck. Please see our performance documentation to check what we are talking about;
    • Hooks for extending Joken functionality. All core actions in Joken have a corresponding hook for extending its functionality;
    • Guides for common patterns;

    Backwards incompatible changes

    • ๐Ÿ‘ There is no Joken.Plug module anymore. Depending on requests we can bring that back, but we believe it is better to be on a different library;
    • The API surface changed a lot but you can still use Joken with the same token pattern as versions 1.x. Please see our migrating guide.