Skip to content

Updates to docs #687

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
josevalim merged 2 commits into from
Sep 7, 2025
Merged

Updates to docs #687

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3865ff9
Update docs
LostKobrakai Sep 7, 2025
65b457c
Update example with start_owner!
LostKobrakai Sep 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions lib/ecto/adapters/sql/sandbox.ex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,9 @@ defmodule Ecto.Adapters.SQL.Sandbox do

setup do
# Explicitly get a connection before each test
:ok = Ecto.Adapters.SQL.Sandbox.checkout(Repo)
pid = Ecto.Adapters.SQL.Sandbox.start_owner!(Repo)
on_exit(fn -> Ecto.Adapters.SQL.Sandbox.stop_owner(pid) end)
:ok
end

test "create post" do
Expand Down Expand Up @@ -102,6 +104,9 @@ defmodule Ecto.Adapters.SQL.Sandbox do
the parent's connection (i.e. the test process' connection) to
the task.

Besides calling `allow/3` allowance can also be provided to processes
via [Caller Tracking](`m:Task#module-ancestor-and-caller-tracking`).

Because allowances use an explicit mechanism, their advantage
is that you can still run your tests in async mode. The downside
is that you need to explicitly control and allow every single
Expand Down Expand Up @@ -148,7 +153,7 @@ defmodule Ecto.Adapters.SQL.Sandbox do

There are two mechanisms for explicit ownerships:

* Using allowances - requires explicit allowances via `allow/3`.
* Using allowances - requires explicit allowances.
Tests may run concurrently.

* Using shared mode - does not require explicit allowances.
Expand Down
Loading