tgrk / humanids

Generate Human Readable IDs

HumanIDs

Simple Elixir library that generates human-readable ids from a list of nouns and adjectives. It makes ids easy for communication with other humans.

Examples:

• dinasaurs-gorillas-20
• swam-burst-48
• abbled-enthusiastically-98
• mongooses-ran-41
• glided-meerkat-98

Even that these ids are reasonably random, it is recommended not to use them as primary ids. Depending on your use-case.

Installation

If available in Hex, the package can be installed by adding humanids to your list of dependencies in mix.exs:

def deps do
  [
    {:humanids, "~> 0.1.0"}
  ]
end

Benchmark

$ mix run benchmark/default.exs
Operating System: Linux
CPU Information: Intel(R) Core(TM) i7-7500U CPU @ 2.70GHz
Number of Available Cores: 4
Available memory: 15.43 GB
Elixir 1.9.0
Erlang 22.0

Benchmark suite executing with the following configuration:
warmup: 2 s
time: 5 s
memory time: 0 ns
parallel: 1
inputs: none specified
Estimated total run time: 21 s

Benchmarking Generate 10 ids...
Benchmarking Generate 100 ids...
Benchmarking Genrate 1000 ids...

Name                       ips        average  deviation         median         99th %
Generate 10 ids        1867.05        0.54 ms    ±25.69%        0.51 ms        1.14 ms
Generate 100 ids        188.21        5.31 ms    ±16.28%        5.11 ms        8.17 ms
Genrate 1000 ids         18.81       53.17 ms     ±3.92%       52.79 ms       59.77 ms

Comparison:
Generate 10 ids        1867.05
Generate 100 ids        188.21 - 9.92x slower +4.78 ms
Genrate 1000 ids         18.81 - 99.27x slower +52.63 ms