README.md
# Mnemonic Slugs
Mnemonic Slugs is an Elixir library that generates easy to remember slugs. It uses a
word list curated by Oren Tirosh. The original site and word list can be found [here](http://web.archive.org/web/20100105040244/http://tothink.com/mnemonic/index.html).
## Installation
Add mnemonic_slugs to your list of dependencies in `mix.exs`:
```
def deps do
[{:mnemonic_slugs, "~> 0.0.2"}]
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.