Popularity
2.0
Stable
Activity
0.0
Stable
11
3
0

Monthly Downloads: 8,207
Programming language: Elixir
License: MIT License
Tags: Utilities    
Latest version: v1.1.1

deppie alternatives and similar packages

Based on the "Utilities" category.
Alternatively, view deppie alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of deppie or a related project?

Add another 'Utilities' Package

README

Deppie

Deppie is a minimal deprecation logger for Elixir. The intent is to provide a very fast way to emit a deprecation message the first time a function is called. It's not meant to be fancy, it's just meant to work.

Why Deppie?

Ever written a library and had to deprecate a function? That's why.

It's a pain in a stateless language to keep track of when you have/haven't logged a warning, so Deppie removes that pain in an easy way, without impacting the application flow. The typical overhead of a Deppie.once/1 call is under a microsecond.

Originally this module was going to be named Deprecation, but that's pretty long to type ;)

Installation

Deppie is available on Hex, so add it as a dependency to your mix.exs:

def deps do
  [{:deppie, "~> 1.1"}]
end

Usage

It's super-duper easy to work with Deppie, as there are currently only two exposed functions; warn/1 and once/1.

# `Deppie.warn/1` just emits a basic deprecation notice
iex(1)> Deppie.warn("MyModule.my_function/1 is deprecated!")
12:48:14.037 [warn]  Deprecation Notice: MyModule.my_function/1 is deprecated!
:ok
# `Deppie.once/1` will only emit a message once during the life of an application
iex(2)> Deppie.once("MyModule.my_function/1 is deprecated!")
12:48:22.965 [warn]  Deprecation Notice: MyModule.my_function/1 is deprecated!
:ok
# Second time it's called, nothing happens!
iex(3)> Deppie.once("MyModule.my_function/1 is deprecated!")
:ok

If this library becomes popular, I might add bonus features like binary formatting - but for now the two functions above should be sufficient.