README.md

# Mnemonic Slugs

Mnemonic Slugs is an Elixir library that generates easy to remember slugs. It 
uses a slightly enhanced word list curated by Oren Tirosh as part of his 
mnemonic encoding project.

A fork of the original project can be found [here](https://github.com/devshane/mnemonicode).

## Installation

Add mnemonic_slugs to your list of dependencies in `mix.exs`:

```
def deps do
  [{:mnemonic_slugs, "~> 0.0.3"}]
end
```

and update your dependencies with `mix deps.get`.

## Usage

You can generate slugs two ways:

```
  iex> MnemonicSlugs.generate_slug
  "aurora-bermuda"

  iex> MnemonicSlugs.generate_slug(10)
  "karate-textile-jungle-patrol-veteran-clone-nerve-stone-soviet-sting"
```

[Full Documentation](https://hexdocs.pm/mnemonic_slugs/MnemonicSlugs.html) is at HexDocs.