feat: auto attach

lib/tower.ex

@@ -140,14 +140,6 @@ defmodule Tower do
       - [`TowerSlack`](https://hexdocs.pm/tower_slack) ([`tower_slack`](https://hex.pm/packages/tower_slack))
     - and properly set the `config :tower, :reporters, [...]` configuration key
 
-  ## Enabling automated exception handling
-
-      Tower.attach()
-
-  ## Disabling automated exception handling
-
-      Tower.detach()
-
   ## Manual handling
 
   If either, for whatever reason when using automated exception handling, an exception condition is
@@ -205,13 +197,6 @@ defmodule Tower do
 
       # in some config/*.exs
       config :tower, reporters: [MyApp.ErrorReporter]
-
-      # config/application.ex
-      Tower.attach()
-
-  `Tower.attach/0` will be responsible for registering the necessary handlers in your application
-  so that any uncaught exception, uncaught throw or abnormal process exit is handled by Tower and
-  passed along to the reporter.
   """
 
   defmodule ReportEventError do

lib/tower/application.ex

@@ -7,12 +7,23 @@ defmodule Tower.Application do
 
   @impl true
   def start(_type, _args) do
-    Supervisor.start_link(
-      [
-        {Task.Supervisor, name: Tower.TaskSupervisor}
-      ],
-      strategy: :one_for_one,
-      name: Tower.Supervisor
-    )
+    with {:ok, pid} <-
+           Supervisor.start_link(
+             [
+               {Task.Supervisor, name: Tower.TaskSupervisor}
+             ],
+             strategy: :one_for_one,
+             name: Tower.Supervisor
+           ),
+         :ok = Tower.attach() do
+      {:ok, pid}
+    end
+  end
+
+  @impl true
+  def stop(_arg) do
+    Tower.detach()
+
+    :ok
   end
 end

lib/tower/ephemeral_reporter.ex

@@ -10,8 +10,6 @@ defmodule Tower.EphemeralReporter do
       iex> Tower.EphemeralReporter.events()
       []
       iex> Application.put_env(:tower, :reporters, [Tower.EphemeralReporter])
-      iex> Tower.attach()
-      :ok
       iex> spawn(fn -> 1 / 0 end)
       iex> Process.sleep(200)
       :ok
@@ -20,8 +18,6 @@ defmodule Tower.EphemeralReporter do
       :error
       iex> event.reason
       %ArithmeticError{message: "bad argument in arithmetic expression"}
-      iex> Tower.detach()
-      :ok
       iex> Tower.EphemeralReporter.stop(pid)
       :ok
   """

test/tower/tower_oban_test.exs

@@ -22,11 +22,7 @@ defmodule TowerObanTest do
       Ecto.Migrator.up(TestApp.Repo, 0, TestApp.Repo.Migrations.AddOban)
     end)
 
-    Tower.attach()
-
-    on_exit(fn ->
-      Tower.detach()
-    end)
+    :ok
   end
 
   test "reports raised exception in an Oban worker" do

test/tower/tower_plug_test.exs

@@ -7,11 +7,8 @@ defmodule TowerPlugTest do
 
   setup do
     start_link_supervised!(Tower.EphemeralReporter)
-    Tower.attach()
 
-    on_exit(fn ->
-      Tower.detach()
-    end)
+    :ok
   end
 
   test "reports arithmetic error during plug dispatch with Plug.Cowboy" do

test/tower_test.exs

@@ -8,11 +8,8 @@ defmodule TowerTest do
 
   setup do
     start_reporter()
-    Tower.attach()
 
-    on_exit(fn ->
-      Tower.detach()
-    end)
+    :ok
   end
 
   test "starts with 0 exceptions" do