How to use Ash in a library?

Hi @torepettersen

Hrm. This is a tricky one and not something that I think was a foreseen use case.

Regarding the repo, I think that the only thing you can do is define a repo in your library codebase and require them to add configuration for it.

Regarding the ash_apis configuration - it’s currently hard coded to look in the application environment for this configuration which is actually done while validating resources, so there is the possible workaround of passing validate_api_inclusion?: false as an option to your use Ash.Resource line in each resource.

Can you tell us more about your use case? Perhaps there’s a better alternative.

Hi @jimsynz,

Thanks for the quick reply.

Sounds moving the Repo to the library could be an alternative. I see that is not how most libraries are doing it (e.g. Oban or Kaffy), but might still be an option.

Will also see if adding validate_api_inclusion?: false would help with the ash_apis issue.

What I am trying to build is a tracking library, a bit similar to Ahoy for Ruby. It will also have a dashboard, that is inspired by Phoenix Live Dashboard and Plausible Analytics.

If you want me to, I can add you as a collaborator and can give you a look. I don’t want to make it public until I have uploaded it to hex.pm. In case someone wants to steal the name.

The “Ash Way” is to accidentally publish v1.0 to hex before it’s ready: https://youtu.be/c4iou77kOFc?si=wpDiK3jKOHtSh8vp&t=793

This is interesting. I think the validate_api_inclusion?: false is the way to go for the other issue, but the more interesting one is the repo. We’ve already discussed and will likely implement soon the option to provide a function to determine the repo at runtime, in which case we can’t do those validations at compile time. That ought to resolve the issue for this case I think?

Yes, adding validate_api_inclusion?: false to use Ash.Resource helped with the missing configuration error. I also needed to add validate_config_inclusion?: false to use Ash.Api to stop the same error for the Api.

I also tried to move the repo to the library application. It works, but it does not feel very optimal. Now I have two repos, but only the one in the app is handeling the migrations. So it might be that the repo in the libray thinks it is ready. Althoug it might not be ready, since it needs to wait for the migrations to be run by the repo in the app.

So a function to determine the repo at runtime would be very welcome

I’ve just pushed something to main that will allow providing a function to repo, something like this should do what you want:

repo &YourApp.Helpers.repo/2

defmodule YourApp.Helpers do
  def repo(resource, _), do: YourDynamicRepo
end

EDIT: keep in mind its a bit experimental though.

Thanks for pushing this change so quickly.

Hovever seems like it is not working for me. Wondering if I am doing something wrong.

I pulled the latest ash_postgres from github:

{:ash_postgres, github: "ash-project/ash_postgres"},

I added the repo function like you describe to the resource:

postgres do
  table "sessions"
  repo &MyApp.Helpers.repo/2
end

But I am getting an error like this:

** (EXIT from #PID<0.99.0>) an exception was raised:
    ** (RuntimeError) Exception in transformer AshPostgres.Transformers.PreventMultidimensionalArrayAggregates on MyLib.Tracker.Session 

no function clause matching in Code.ensure_compiled/1
        (elixir 1.15.6) lib/code.ex:1858: Code.ensure_compiled(&MyLib.Helpers.repo/2)
        (ash_postgres 1.3.60) lib/transformers/prevent_multidimensional_array_aggregates.ex:41: AshPostgres.Transformers.PreventMultidimensionalArrayAggregates.transform/1
        (spark 1.1.51) lib/spark/dsl/extension.ex:577: anonymous fn/4 in Spark.Dsl.Extension.run_transformers/4
        (elixir 1.15.6) lib/enum.ex:4830: Enumerable.List.reduce/3
        (elixir 1.15.6) lib/enum.ex:2564: Enum.reduce_while/3
        (elixir 1.15.6) lib/enum.ex:984: Enum."-each/2-lists^foreach/1-0-"/2
        (elixir 1.15.6) lib/module/parallel_checker.ex:271: Module.ParallelChecker.check_module/3
        (elixir 1.15.6) lib/module/parallel_checker.ex:82: anonymous fn/6 in Module.ParallelChecker.spawn/4

Any clue what could be wrong?

was an oversight. Just pushed up a fix.

Thank you very much!

That seems to work like a charm

I noticed I still got the error when compiling, but now I can work around that by providing a dummy repo when compile checks are done.

def repo(_, _) do
  case Application.get_env(:my_lib, :started, false) do
    true -> Application.get_env!(:my_lib, :ecto_repo)
    false -> MyLib.Repo
  end
end

Then setting the variable when my application is starting.

defmodule MyLib.Application do
  use Application
  def start(_type, _args) do
    Application.put_env(:my_lib, :started, true)
    # ...
  end
end

Ah, yeah interesting. I don’t think we need to do that check TBH. I’ve removed it for now. That alone might solve your issue, but supporting a functional callback will also let you get some configured repo for a given resource.