https://github.com/whitfin/deppie

Elixir's coolest deprecation logger
https://github.com/whitfin/deppie

Last synced: about 2 months ago
JSON representation

Elixir's coolest deprecation logger

• Host: GitHub
• URL: https://github.com/whitfin/deppie
• Owner: whitfin
• License: mit
• Created: 2016-06-12T11:43:34.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2018-10-08T22:29:46.000Z (over 5 years ago)
• Last Synced: 2024-04-19T15:21:05.485Z (about 2 months ago)
• Language: Elixir
• Size: 8.79 KB
• Stars: 11
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-elixir - deppie - Elixir's coolest deprecation logger. (Utilities)
• freaking_awesome_elixir - Elixir - Elixir's coolest deprecation logger. (Utilities)
• fucking-awesome-elixir - deppie - Elixir's coolest deprecation logger. (Utilities)

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`:

```elixir

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`.

```elixir

# `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.