# `BoxTurtle.Common.IdUtils`
[🔗](https://github.com/twajjo/box_turtle/blob/v0.1.0/lib/common/id_utils.ex#L1)

Small helpers for generating identifiers.

    alias BoxTurtle.Common.IdUtils

    IdUtils.generate_ksuid()  #=> "2Ux8k3WmS1mXJ9i1QeB6LcPq0Zf" (unique, sortable by time)
    IdUtils.generate_uuid()   #=> "5b0e3f4a-8c1d-4d2e-9f6a-1b2c3d4e5f60" (unique, random)
    IdUtils.generate_id()     #=> 734_201_558 (NOT unique: test data and labels only)

# `generate_id`

```elixir
@spec generate_id() :: pos_integer()
```

Returns a random integer between 1 and 1,000,000,000.

This is **not** a unique identifier: values can and will collide once many are generated,
and they are not cryptographically random. Use it for test data or throwaway labels; use
`generate_ksuid/0` or `generate_uuid/0` for anything that must be unique.

# `generate_ksuid`

```elixir
@spec generate_ksuid() :: String.t()
```

Returns a new, time-sortable KSUID string (see `BoxTurtle.Schema.Ecto.Ksuid`).

# `generate_uid`

```elixir
@spec generate_uid() :: String.t()
```

Same as `generate_ksuid/0`.

# `generate_uuid`

```elixir
@spec generate_uuid() :: String.t()
```

Returns a new random (version 4) UUID string.

---

*Consult [api-reference.md](api-reference.md) for complete listing*