AshUUIDv7

Installation

def deps do
  [
    {:ash_uuid_v7, "~> 0.1.1"},
  ]
end

Adoption

Adoption:

add {:ash_uuid_v7, "~> 0.1.1"} to your mix.exs project deps;
add AshUUIDv7.PostgresExtension to your app Repo's installed_extensions if Postgres-side UUIDs generation is needed;
use the extension in your resources use Ash.Resource, data_layer: AshPostgres.DataLayer, extensions: [AshUUIDv7.Extension];
simply use that for your fields uuid_v7_primary_key :id.

Configuration

`lib/myapp/repo.ex`:

Using the PostgresExtension allows postgres-side uuid-v7 generation.

# App: Postgres migration defaults, not required
`
defmodule Myapp.Repo do
  use AshPostgres.Repo, otp_app: :myapp

  @impl AshPostgres.Repo
  def installed_extensions do
    ["ash-functions", "uuid-ossp", "citext", AshUUIDv7.PostgresExtension]
  end
end

`config/config.exs`:

# Ash: Type shorthands, not required
config :ash, :custom_types, uuid_v7: AshUUIDv7

# Ash: Default belongs_to type, not required
config :ash, :default_belongs_to_type, AshUUIDv7

Usage

defmodule Pineapple do
  use Ash.Resource, data_layer: AshPostgres.DataLayer, extensions: [AshUUIDv7.Extension]

  code_interface do
    define_for Area
  end

  postgres do
    table "pineapples"
    repo MyApp.Repo
  end

  attributes do
    uuid_v7_primary_key :id
    attribute :uuid_field, :uuid_v7

    create_timestamp :inserted_at
  end

  actions do
    defaults [:create, :read, :update]
  end
end

The full documentation can be found on HexDocs.

Roadmap

Developing

To get set up with the development environment, you will need a Postgres instance and an environment variable DATABASE_URL according to config/config.exs.

You may now generate and apply the test migrations:

mix ash_postgres.generate_migrations
mix ash_postgres.create
mix ash_postgres.migrate
mix test

AshUUIDv7 uses ex_check to bundle the test configuration, and simply running mix check should closely follow the configuration used in CI.

Contributing

If you have ideas or come across any bugs, feel free to open a pull request or an issue. You can also find me on the Ash Discord as @moissela.

License

MIT License

See LICENSE.md for details.

spacebat/ash_uuid_v7