feat: auto attach

lib/tower.ex

@@ -134,14 +134,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
@@ -199,13 +191,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

@@ -18,11 +18,7 @@ defmodule TowerObanTest do
 
     Ecto.Migrator.up(TestApp.Repo, 0, TestApp.Repo.Migrations.AddOban)
 
-    Tower.attach()
-
-    on_exit(fn ->
-      Tower.detach()
-    end)
+    :ok
   end
 
   @tag capture_log: true

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 @@
 
   setup do
     start_reporter()
-    Tower.attach()
 
-    on_exit(fn ->
-      Tower.detach()
-    end)
+    :ok
   end
 
   test "starts with 0 exceptions" do
@@ -22,7 +19,7 @@
   test "reports arithmetic error" do
     capture_log(fn ->
       in_unlinked_process(fn ->
         1 / 0
       end)
     end)
 
@@ -311,7 +308,7 @@
   test "reports Exception manually" do
     in_unlinked_process(fn ->
       try do
         1 / 0
       catch
         kind, reason ->
           Tower.handle_caught(kind, reason, __STACKTRACE__)
@@ -337,7 +334,7 @@
   test "reports Exception manually (shorthand)" do
     in_unlinked_process(fn ->
       try do
         1 / 0
       rescue
         e ->
           Tower.handle_exception(e, __STACKTRACE__)
@@ -515,7 +512,7 @@
 
     capture_log(fn ->
       in_unlinked_process(fn ->
         1 / 0
       end)
     end)