typeid-elixir/README.md

26 lines
1,023 B
Markdown
Raw Normal View History

2023-06-29 17:38:33 -04:00
# TypeID Elixir
2023-06-29 15:20:23 -04:00
2023-06-30 07:10:28 -04:00
[![CI](https://github.com/sloanelybutsurely/typeid-elixir/actions/workflows/ci.yaml/badge.svg)](https://github.com/sloanelybutsurely/typeid-elixir/actions/workflows/ci.yaml)
2023-06-30 07:24:59 -04:00
Read the full documentation on [hexdocs](https://hexdocs.pm/typeid_elixir/TypeID.html)
2023-06-29 17:38:33 -04:00
### A type-safe, K-sortable, globally unique identifier inspired by Stripe IDs
[TypeIDs](https://github.com/jetpack-io/typeid) are a modern, type-safe, globally unique identifier based on the upcoming UUIDv7 standard. They provide a ton of nice properties that make them a great choice as the primary identifiers for your data in a database, APIs, and distributed systems. Read more about TypeIDs in their spec.
2023-06-29 15:20:23 -04:00
## Installation
2023-06-30 07:24:59 -04:00
The package can be installed from [hex](https://hex.pm/packages/typeid_elixir) by adding `typeid_elixir` to your list of dependencies in `mix.exs`:
2023-06-29 15:20:23 -04:00
```elixir
def deps do
[
2023-07-06 14:25:23 -04:00
{:typeid_elixir, "~> 0.2.1"}
2023-06-29 15:20:23 -04:00
]
end
```
2023-06-30 06:50:00 -04:00
## Spec
The original TypeID spec is defined [here](https://github.com/jetpack-io/typeid).