Ecto Isolator

Copy Markdown View Source

Prevent non-atomic side effects while the current process is inside an Ecto transaction.

Install

{:ecto_isolator, "~> 0.2.0", only: [:dev, :test], runtime: false}

Configure

config :ecto_isolator,
  repos: [MyApp.Repo]

EctoIsolator.check!/3 raises EctoIsolator.Error immediately when any configured repo is in a transaction. Call it directly before a side effect so the operation cannot proceed.

Adapters

Req is the only built-in adapter:

Req.new()
|> EctoIsolator.Adapters.Req.attach()
|> Req.get!(url: "https://example.com")

For other libraries, keep the package-specific wrapper or adapter in the consuming application and call EctoIsolator.check!/3 immediately before the side effect:

EctoIsolator.check!(:swoosh, :deliver, details: %{mailer: MyApp.Mailer})
MyApp.Mailer.deliver(email)

Ignores

Ignore rules receive an EctoIsolator.Offense:

config :ecto_isolator,
  ignore: [
    {:req, fn offense -> offense.details.url =~ "localhost" end}
  ]

Development

Run the package checks with Mix:

mix check