solid_errors 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 877768652877df99eb678441601fa65e3329ad898ae4a163c2a260e5ab88d40b
-  data.tar.gz: dc5cd7fcb81f7548ea8657f74670971682f530c6149114b97bad9d943c282764
+  metadata.gz: 11cd9651413ea528780669e5c01abec456118a34a70c93042a85a471c0d1fd07
+  data.tar.gz: 39f16c51d5bb62144c8b1b138c18fc6fa4dff4e601c635ed3046f9d37f1d960a
 SHA512:
-  metadata.gz: 4482cfe25a500becec052384f224214e9946d97f1f034a03ea4d52f2549814863e00632da29b659bb78f9b0b58667a4773020141597f2e517be7dd08fbccb76c
-  data.tar.gz: bf4e567dcc81fe59ab1aac561abfd3110c69b83db080c317401caa19206f5e36c0e6b12a6afd6e232aeb883cfd85de822fa7fc802672348b01b3ca6aaa2ae32e
+  metadata.gz: 39341060f4ee0e9bfdc009fedd2176fb9bb7ae6c60aaddc175f8e4449d2274f7014f6df71b683865a94eb6c779700c4b0356a0addf2c435a40162027a45b5bec
+  data.tar.gz: 87f876f3bdcdf11dcdeac4ded4c6ae873c3f5a53c87aebe454ce925416a66ad19dc37d4984b9a6c326fe79e2c1bab16f6c20f6feb9f79381a70965e35d058030

data/README.md

@@ -24,13 +24,8 @@
   </a>
 </p>
 
-
 Solid Errors is a DB-based, app-internal exception tracker for Rails applications, designed with simplicity and performance in mind. It uses the new [Rails error reporting API](https://guides.rubyonrails.org/error_reporting.html) to store uncaught exceptions in the database, and provides a simple UI for viewing and managing exceptions.
 
-> [!WARNING]
-> The current point release of Rails (7.1.3.2) has a bug which severely limits the utility of Solid Errors. Exceptions raised during a web request *are not* reported to Rails' error reporter. There is a fix in the `main` branch, but it has not been released in a new point release. As such, Solid Errors is **not** production-ready unless you are running Rails from the `main` branch or until a new point version is released and you upgrade.
-> The original bug report can be found [here](https://github.com/rails/rails/issues/51002) and the pull request making the fix is [here](https://github.com/rails/rails/pull/51050). I will try to backport the fix into the gem directly, but I haven't quite figured it out yet.
-
 
 ## Installation
 
@@ -80,7 +75,7 @@ production:
 ```
 
 > [!NOTE]
-> Calling `bin/rails solid_errors:install` will automatically add `config.solid_errors.connects_to = { database: { writing: :errors } }` to `config/environments/production.rb`, so no additional configuration is needed there (although you must make sure that you use the `errors` name in `database.yml` for this to match!). But if you want to use Solid Errors in a different environment (like staging or even development), you'll have to manually add that `config.solid_errors.connects_to` line to the respective environment file. And, as always, make sure that the name you're using for the database in `config/database.yml` matches the name you use in `config.solid_errors.connects_to`.
+> Calling `bin/rails generate solid_errors:install` will automatically add `config.solid_errors.connects_to = { database: { writing: :errors } }` to `config/environments/production.rb`, so no additional configuration is needed there (although you must make sure that you use the `errors` name in `database.yml` for this to match!). But if you want to use Solid Errors in a different environment (like staging or even development), you'll have to manually add that `config.solid_errors.connects_to` line to the respective environment file. And, as always, make sure that the name you're using for the database in `config/database.yml` matches the name you use in `config.solid_errors.connects_to`.
 
 Then run `db:prepare` in production to ensure the database is created and the schema is loaded.
 
@@ -158,17 +153,20 @@ end
 
 ### Configuration
 
-You can configure Solid Errors via the Rails configuration object, under the `solid_errors` key. Currently, 6 configuration options are available:
+You can configure Solid Errors via the Rails configuration object, under the `solid_errors` key. Currently, the following configuration options are available:
 
+* `enabled` - Enable or disable error tracking. Defaults to `true`. See [Disabling error tracking](#disabling-error-tracking) for more information.
 * `connects_to` - The database configuration to use for the Solid Errors database. See [Database Configuration](#database-configuration) for more information.
 * `username` - The username to use for HTTP authentication. See [Authentication](#authentication) for more information.
 * `password` - The password to use for HTTP authentication. See [Authentication](#authentication) for more information.
 * `sends_email` - Whether or not to send emails when an error occurs. See [Email notifications](#email-notifications) for more information.
 * `email_from` - The email address to send a notification from. See [Email notifications](#email-notifications) for more information.
 * `email_to` - The email address(es) to send a notification to. See [Email notifications](#email-notifications) for more information.
+* `email_every_occurrence` - Whether to email every occurrence (the default), or only new errors and resolved errors that occur again. See [Email notifications](#email-notifications) for more information.
 * `email_subject_prefix` - Prefix added to the subject line for email notifications. See [Email notifications](#email-notifications) for more information.
 * `base_controller_class` - Specify a different controller as the base class for the Solid Errors controller. See [Authentication](#authentication) for more information.
 * `destroy_after` - If set, Solid Errors will periodically destroy resolved records that are older than the value specified. See [Automatically destroying old records](#automatically-destroying-old-records) for more information.
+* `ignored_errors` - Error classes, or their names, to never record, in addition to the built-in list in `SolidErrors::Subscriber::IGNORED_ERRORS`. For example, `config.solid_errors.ignored_errors = ["ActiveStorage::FileNotFoundError"]`.
 
 ### Database Configuration
 
@@ -196,6 +194,42 @@ Running Solid Errors in a separate database is recommended, but it's also possib
 
 You won't have multiple databases, so `database.yml` doesn't need to have the errors database configuration.
 
+#### Apps that use `schema_format = :sql`
+
+The installer writes `db/errors_schema.rb`, but an app with `config.active_record.schema_format = :sql` looks for `db/errors_structure.sql` for the errors database.
+
+On Rails 8.1 and later, keep the Ruby schema for the errors database only by setting `schema_format` on it in `config/database.yml`:
+
+```yaml
+production:
+  errors:
+    <<: *default
+    database: storage/production_errors.sqlite3
+    migrations_paths: db/errors_migrate
+    schema_format: ruby
+```
+
+On earlier Rails versions, create the errors database, load the Ruby schema into it, and dump it as SQL for your database adapter:
+
+```sh
+bin/rails db:create:errors
+bin/rails runner 'ActiveRecord::Tasks::DatabaseTasks.load_schema(ActiveRecord::Base.configurations.configs_for(env_name: Rails.env, name: "errors"), :ruby, "db/errors_schema.rb")'
+bin/rails db:schema:dump:errors
+```
+
+This writes `db/errors_structure.sql`, which you commit in place of `db/errors_schema.rb`.
+
+#### Disabling error tracking
+
+Solid Errors is enabled by default. If you want to disable error tracking in a specific environment, you can set `enabled` to `false`:
+
+```ruby
+# config/environments/development.rb
+config.solid_errors.enabled = false
+```
+
+When disabled, Solid Errors will not subscribe to the Rails error reporter and no errors will be recorded.
+
 #### Authentication
 
 Solid Errors does not restrict access out of the box. You must secure the dashboard yourself. However, it does provide basic HTTP authentication that can be used with basic authentication or Devise. All you need to do is setup a username and password.
@@ -257,6 +291,31 @@ config.solid_errors.email_subject_prefix = "[#{Rails.application.name}][#{Rails.
 
 If you have set `send_emails` to `true` and have set an `email_to` address, Solid Errors will send an email notification whenever an error occurs. If you have not set `send_emails` to `true` or have not set an `email_to` address, Solid Errors will not send any email notifications.
 
+To be emailed only when an error is new, or when a resolved error occurs again, rather than for every occurrence:
+
+```ruby
+config.solid_errors.email_every_occurrence = false # defaults to true
+```
+
+#### Lifecycle events
+
+Solid Errors publishes [Active Support notifications](https://guides.rubyonrails.org/active_support_instrumentation.html) once each change is committed, so you can send errors to Slack, a webhook or anywhere else:
+
+| Event | When | Payload |
+| --- | --- | --- |
+| `error_created.solid_errors` | An error is recorded for the first time | `:error`, `:occurrence` |
+| `error_reopened.solid_errors` | A resolved error occurs again | `:error`, `:occurrence` |
+| `error_resolved.solid_errors` | An error is marked as resolved | `:error` |
+| `occurrence_created.solid_errors` | Any occurrence is recorded, including those above | `:error`, `:occurrence` |
+
+```ruby
+# config/initializers/solid_errors.rb
+ActiveSupport::Notifications.subscribe(/\Aerror_(created|reopened)\.solid_errors\z/) do |event|
+  error = event.payload[:error]
+  SlackNotifier.post("#{error.exception_class}: #{error.message}")
+end
+```
+
 #### Automatically destroying old records
 
 Setting `destroy_after` to a duration will allow Solid Errors to be self-maintaining by peridically destroying **resolved** records that are older than that value. The value provided must respond to `.ago`.
@@ -381,4 +440,3 @@ The gem is available as open source under the terms of the [MIT License](https:/
 ## Code of Conduct
 
 Everyone interacting in the SolidErrors project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/fractaledmind/solid_errors/blob/main/CODE_OF_CONDUCT.md).
-

data/app/mailers/solid_errors/error_mailer.rb

@@ -1,6 +1,17 @@
 module SolidErrors
   # adapted from: https://github.com/codergeek121/email_error_reporter/blob/main/lib/email_error_reporter/error_mailer.rb
   class ErrorMailer < (defined?(ActionMailer::Base) ? ActionMailer::Base : Object)
+    if defined?(ActionMailer::Base)
+      # A failure here reported as usual would email again and fail again, without end
+      rescue_from StandardError do |exception|
+        SolidErrors.without_emails do
+          Rails.error.report(exception, handled: true, source: "solid_errors.error_mailer")
+        end
+      end
+
+      helper_method :occurrence_url
+    end
+
     def error_occurred(occurrence)
       unless defined?(ActionMailer::Base)
         raise "ActionMailer is not available. Make sure that you require \"action_mailer/railtie\" in application.rb"
@@ -17,5 +28,14 @@ module SolidErrors
         to: SolidErrors.email_to
       )
     end
+
+    private
+
+    # Optional: an app without default_url_options[:host] still gets the email, just unlinked
+    def occurrence_url
+      public_send(SolidErrors.url_helper_name).error_url(@error, **SolidErrors.url_options, anchor: "occurrence_#{@occurrence.id}")
+    rescue ArgumentError, NoMethodError, ActionController::UrlGenerationError
+      nil
+    end
   end
 end

data/app/models/solid_errors/backtrace.rb

@@ -35,7 +35,7 @@ module SolidErrors
     end
 
     def to_s
-      lines.map(&:to_s).join("\n")
+      lines.join("\n")
     end
 
     def inspect

data/app/models/solid_errors/error.rb

@@ -30,6 +30,8 @@ module SolidErrors
     scope :resolved, -> { where.not(resolved_at: nil) }
     scope :unresolved, -> { where(resolved_at: nil) }
 
+    after_update_commit :publish_resolved, if: -> { saved_change_to_resolved_at? && resolved? }
+
     def severity_emoji
       SEVERITY_TO_EMOJI[severity.to_sym]
     end
@@ -53,5 +55,46 @@ module SolidErrors
     def resolved?
       resolved_at.present?
     end
+
+    def to_markdown
+      md = ""
+      md << "## Exception: #{exception_class}\n"
+      md << "**Severity:** #{severity} | **Source:** #{source}\n\n"
+      md << "### Message\n#{message}\n"
+
+      occurrence = occurrences.order(created_at: :desc).first
+      return md unless occurrence
+
+      backtrace = occurrence.parsed_backtrace
+
+      md << "\n### Backtrace\n"
+      backtrace.lines.each do |line|
+        md << (line.filtered_method ? line.to_s : line.unparsed_line) << "\n"
+      end
+
+      app_lines = backtrace.application_lines
+      if app_lines.any?
+        md << "\n### Source Context\n"
+        app_lines.each do |line|
+          md << "#### #{line}\n"
+          md << "```ruby\n"
+          line.source.each { |n, code| md << "#{n}: #{code.chomp}\n" }
+          md << "```\n\n"
+        end
+      end
+
+      if occurrence.context.present?
+        md << "### Request Context\n"
+        occurrence.context.each { |k, v| md << "- #{k}: #{v}\n" }
+      end
+
+      md
+    end
+
+    private
+
+    def publish_resolved
+      ActiveSupport::Notifications.instrument("error_resolved.solid_errors", error: self)
+    end
   end
 end

data/app/models/solid_errors/occurrence.rb

@@ -2,7 +2,14 @@ module SolidErrors
   class Occurrence < Record
     belongs_to :error, class_name: "SolidErrors::Error"
 
-    after_create_commit :send_email, if: -> { SolidErrors.send_emails? && SolidErrors.email_to.present? }
+    # Adapters that report the json column as text (MariaDB) would otherwise store Hash#inspect
+    attribute :context, :json
+
+    # :created or :reopened, set by the subscriber when this occurrence opens its error
+    attr_accessor :opens_error
+
+    after_create_commit :send_email, if: -> { SolidErrors.send_emails? && (SolidErrors.email_every_occurrence || opens_error) }
+    after_create_commit :publish_events
     after_create_commit :clear_resolved_errors, if: :should_clear_resolved_errors?
 
     # The parsed exception backtrace. Lines in this backtrace that are from installed gems
@@ -12,7 +19,7 @@ module SolidErrors
     def parsed_backtrace
       return @parsed_backtrace if defined? @parsed_backtrace
 
-      @parsed_backtrace = parse_backtrace(backtrace.split("\n"))
+      @parsed_backtrace = parse_backtrace(backtrace&.split("\n"))
     end
 
     private
@@ -21,6 +28,12 @@ module SolidErrors
       Backtrace.parse(backtrace)
     end
 
+    def publish_events
+      payload = {error: error, occurrence: self}
+      ActiveSupport::Notifications.instrument("error_#{opens_error}.solid_errors", payload) if opens_error
+      ActiveSupport::Notifications.instrument("occurrence_created.solid_errors", payload)
+    end
+
     def send_email
       ErrorMailer.error_occurred(self).deliver_later
     end

data/app/views/layouts/solid_errors/{_style.html → _style.html.erb}

@@ -1,4 +1,4 @@
-<style>
+<style<% if local_assigns[:nonce] %> nonce="<%= nonce %>"<% end %>>
   /*
   ! tailwindcss v3.4.1 | MIT License | https://tailwindcss.com
   */

data/app/views/layouts/solid_errors/application.html.erb

@@ -5,10 +5,13 @@
     <%= csrf_meta_tags %>
     <%= csp_meta_tag %>
 
-    <%= render "layouts/solid_errors/style" %>
+    <%= render "layouts/solid_errors/style", nonce: content_security_policy_nonce %>
   </head>
   <body class="h-full flex flex-col pb-4">
     <main class="grow container mx-auto mt-4">
+      <% if defined?(main_app.root_path) %>
+        <%= link_to "← Back to main app", main_app.root_path, class: "text-sm text-blue-500 hover:underline decoration-blue-500" %>
+      <% end %>
       <%= content_for?(:content) ? yield(:content) : yield %>
     </main>
 
@@ -51,6 +54,87 @@
       document.querySelectorAll('[data-controller="fade"]').forEach(element => {
         fadeOut(element);
       });
+
+      // Backtrace filter toggle functionality
+      (function() {
+        const STORAGE_KEY = 'solid_errors_backtrace_filter';
+
+        function toggleBacktrace(button) {
+          const filter = button.getAttribute('data-backtrace-toggle');
+          const occurrenceId = button.getAttribute('data-occurrence-id');
+
+          // Toggle visibility
+          const appTrace = document.getElementById(`backtrace-application-${occurrenceId}`);
+          const fullTrace = document.getElementById(`backtrace-full-${occurrenceId}`);
+
+          if (filter === 'application') {
+            appTrace.removeAttribute('hidden');
+            fullTrace.setAttribute('hidden', '');
+          } else {
+            appTrace.setAttribute('hidden', '');
+            fullTrace.removeAttribute('hidden');
+          }
+
+          // Update button states for this occurrence
+          const occurrenceButtons = document.querySelectorAll(`[data-occurrence-id="${occurrenceId}"][data-backtrace-toggle]`);
+          occurrenceButtons.forEach(btn => {
+            if (btn === button) {
+              btn.classList.add('border-blue-500', 'text-blue-500');
+              btn.classList.remove('border-transparent', 'text-gray-500');
+            } else {
+              btn.classList.remove('border-blue-500', 'text-blue-500');
+              btn.classList.add('border-transparent', 'text-gray-500');
+            }
+          });
+
+          // Remember the choice; storage can be unavailable (private browsing)
+          try { sessionStorage.setItem(STORAGE_KEY, filter); } catch (e) {}
+        }
+
+        // Initialize on page load
+        let savedFilter = 'application';
+        try { savedFilter = sessionStorage.getItem(STORAGE_KEY) || savedFilter; } catch (e) {}
+
+        // Apply saved filter to all occurrences
+        if (savedFilter === 'full') {
+          document.querySelectorAll('[id^="backtrace-application-"]').forEach(el => el.setAttribute('hidden', ''));
+          document.querySelectorAll('[id^="backtrace-full-"]').forEach(el => el.removeAttribute('hidden'));
+
+          // Update button states
+          document.querySelectorAll('[data-backtrace-toggle]').forEach(btn => {
+            const filter = btn.getAttribute('data-backtrace-toggle');
+            if (filter === savedFilter) {
+              btn.classList.add('border-blue-500', 'text-blue-500');
+              btn.classList.remove('border-transparent', 'text-gray-500');
+            } else {
+              btn.classList.remove('border-blue-500', 'text-blue-500');
+              btn.classList.add('border-transparent', 'text-gray-500');
+            }
+          });
+        }
+
+        // Attach event listeners
+        document.querySelectorAll('[data-backtrace-toggle]').forEach(button => {
+          button.addEventListener('click', function() {
+            toggleBacktrace(this);
+          });
+        });
+      })();
+
+      var copyBtn = document.getElementById('copy-markdown');
+      if (copyBtn) {
+        copyBtn.addEventListener('click', function() {
+          var text = document.getElementById('error-markdown').content.textContent;
+          var span = copyBtn.querySelector('span');
+          var originalText = span.textContent;
+          navigator.clipboard.writeText(text).then(function() {
+            span.textContent = 'Copied!';
+            setTimeout(function() { span.textContent = originalText; }, 2000);
+          }).catch(function(err) {
+            alert('Failed to copy: ' + err);
+          });
+        });
+      }
     </script>
   </body>
 </html>

data/app/views/solid_errors/error_mailer/error_occurred.html.erb

@@ -2,16 +2,169 @@
 <head>
   <title>Solid Errors | <%= @error.severity_emoji %> <%= @error.exception_class %></title>
   <%= render "layouts/solid_errors/style" %>
+  <style>
+    body {
+      padding: 20px;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    }
+    .email-header {
+      margin-bottom: 16px;
+    }
+    .email-header h1 {
+      font-size: 20px;
+      font-weight: 700;
+      margin: 0 0 8px 0;
+    }
+    .email-header h1 a {
+      color: #1f2937;
+      text-decoration: none;
+    }
+    .email-header h1 a:hover {
+      text-decoration: underline;
+    }
+    .email-link {
+      font-size: 14px;
+      color: #2563eb;
+      text-decoration: none;
+      margin-bottom: 12px;
+      display: inline-block;
+    }
+    .error-message {
+      background: #f3f4f6;
+      padding: 12px;
+      border-radius: 4px;
+      margin: 12px 0;
+      font-family: monospace;
+      font-size: 13px;
+      white-space: pre-wrap;
+    }
+    .info-table {
+      width: auto;
+      border-collapse: collapse;
+      margin: 12px 0;
+      font-size: 13px;
+    }
+    .info-table td {
+      padding: 4px 8px;
+      border-bottom: 1px solid #e5e7eb;
+    }
+    .info-table td:first-child {
+      font-weight: 600;
+      white-space: nowrap;
+      vertical-align: top;
+    }
+    .backtrace {
+      background: #1e293b;
+      color: #fff;
+      padding: 12px;
+      border-radius: 4px;
+      margin: 12px 0;
+      font-family: 'Monaco', 'Courier New', monospace;
+      font-size: 12px;
+      line-height: 1.4;
+      overflow-x: auto;
+    }
+    .backtrace-line {
+      margin: 2px 0;
+    }
+    .backtrace-highlight {
+      background: #374151;
+      margin-left: -12px;
+      margin-right: -12px;
+      padding-left: 12px;
+      padding-right: 12px;
+    }
+    .context-table {
+      width: auto;
+      border-collapse: collapse;
+      margin: 12px 0;
+      font-size: 13px;
+    }
+    .context-table th {
+      background: #f3f4f6;
+      padding: 6px 8px;
+      text-align: left;
+      font-weight: 600;
+      border: 1px solid #e5e7eb;
+      white-space: nowrap;
+    }
+    .context-table td {
+      padding: 6px 8px;
+      border: 1px solid #e5e7eb;
+      font-family: monospace;
+      font-size: 12px;
+    }
+    .context-table td:first-child {
+      white-space: nowrap;
+    }
+    .section-title {
+      font-weight: 700;
+      font-size: 14px;
+      margin: 16px 0 8px 0;
+    }
+  </style>
 </head>
 <body>
-  <%= render "solid_errors/errors/error",
-        error: @error,
-        show_actions: false %>
 
-  <br>
-  <br>
+  <div class="email-header">
+    <h1>
+      <%= @error.severity_emoji %>
+      <%= @error.exception_class %>
+      from <em><%= @error.source %></em>
+    </h1>
+    <% if (url = occurrence_url) %>
+      <a href="<%= url %>" class="email-link">View in Solid Errors &rarr;</a>
+    <% end %>
+  </div>
 
-  <%= render "solid_errors/occurrences/occurrence",
-        occurrence: @occurrence %>
+  <div class="error-message"><%= @error.message %></div>
+
+  <table class="info-table">
+    <tr>
+      <td>Severity</td>
+      <td><%= @error.severity_emoji %> <%= @error.severity %></td>
+    </tr>
+    <tr>
+      <td>Status</td>
+      <td><%= @error.status_emoji %> <%= @error.status %></td>
+    </tr>
+    <tr>
+      <td>Occurred at</td>
+      <td><%= @occurrence.created_at.strftime("%Y-%m-%d %H:%M:%S %Z") %></td>
+    </tr>
+  </table>
+
+  <% if @occurrence.context&.any? %>
+    <div class="section-title">Context</div>
+    <table class="context-table">
+      <thead>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @occurrence.context.each do |key, value| %>
+          <tr>
+            <td><%= key %></td>
+            <td><%= value %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <div class="section-title">Backtrace</div>
+  <div class="backtrace">
+    <% @occurrence.parsed_backtrace.lines.each_with_index do |line, i| %>
+      <div class="backtrace-line <%= i.zero? ? 'backtrace-highlight' : '' %>">
+        <% if line.filtered_file %>
+<span style="color: #9ca3af;"><%= File.dirname(line.filtered_file) %>/</span><span style="color: #60a5fa; font-weight: 500;"><%= File.basename(line.filtered_file) %></span>:<span style="color: #fff; font-weight: 500;"><%= line.filtered_number %></span> <span style="color: #9ca3af;">in</span> <span style="color: #34d399;"><%= line.filtered_method %></span>
+        <% else %>
+<span style="color: #9ca3af;"><%= line.unparsed_line %></span>
+        <% end %>
+      </div>
+    <% end %>
+  </div>
 </body>
 </html>

data/app/views/solid_errors/error_mailer/error_occurred.text.erb

@@ -0,0 +1,32 @@
+<%= @error.severity_emoji %> <%= @error.exception_class %> from <%= @error.source %>
+================================================================================
+
+<%= @error.message %>
+
+<% if (url = occurrence_url) %>
+View in Solid Errors: <%= url %>
+<% end %>
+
+DETAILS
+--------------------------------------------------------------------------------
+Severity:     <%= @error.severity_emoji %> <%= @error.severity %>
+Status:       <%= @error.status_emoji %> <%= @error.status %>
+Occurred at:  <%= @occurrence.created_at.strftime("%Y-%m-%d %H:%M:%S %Z") %>
+
+<% if @occurrence.context&.any? %>
+CONTEXT
+--------------------------------------------------------------------------------
+<% @occurrence.context.each do |key, value| %>
+<%= key.to_s.ljust(20) %> <%= value %>
+<% end %>
+
+<% end %>
+BACKTRACE
+--------------------------------------------------------------------------------
+<% @occurrence.parsed_backtrace.lines.each_with_index do |line, i| %>
+<% if line.filtered_file %>
+<%= i.zero? ? '>>>' : '   ' %> <%= File.join(File.dirname(line.filtered_file), File.basename(line.filtered_file)) %>:<%= line.filtered_number %> in <%= line.filtered_method %>
+<% else %>
+<%= i.zero? ? '>>>' : '   ' %> <%= line.unparsed_line %>
+<% end %>
+<% end %>

data/app/views/solid_errors/errors/_actions.html.erb

@@ -5,6 +5,15 @@
     </svg>
     <span>Back to errors</span>
   <% end %>
+  <template id="error-markdown"><%= error.to_markdown %></template>
+  <button id="copy-markdown"
+          class="inline-flex items-center justify-center gap-2 font-medium cursor-pointer border rounded-lg py-3 px-5 bg-gray-100 text-initial border-gray-300 hover:ring-gray-200 hover:ring-8">
+    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard" viewBox="0 0 16 16">
+      <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1z"/>
+      <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0z"/>
+    </svg>
+    <span>Copy Markdown</span>
+  </button>
   <% if error.resolved? %>
     <%= render 'solid_errors/errors/delete_button', error: error %>
   <% else %>

data/app/views/solid_errors/occurrences/_backtrace_line.html.erb

@@ -0,0 +1,14 @@
+<%= tag.details open: open do %>
+  <summary class="hover:bg-gray-50 px-2 py-1 rounded cursor-pointer">
+    <% if line.filtered_file %>
+      <span class="text-gray-500"><%= File.dirname(line.filtered_file) %>/</span><span class="text-blue-500 font-medium"><%= File.basename(line.filtered_file) %></span>:<span class="text-gray-900 font-medium"><%= line.filtered_number %></span>
+      <span class="text-gray-500">in</span>
+      <code class="text-green-500 font-medium"><%= line.filtered_method %></code>
+    <% else %>
+      <span class="text-gray-500"><%= line.unparsed_line %></span>
+    <% end %>
+  </summary>
+  <div><pre class="flex overflow-auto rounded-b-lg bg-slate-800 p-4 text-sm leading-normal text-white sm:rounded-t-lg"><code class="flex flex-1 flex-col min-h-full min-w-content px-0"><% line.source.each do |n, code| %>
+      <div class="line <%= n == line.filtered_number.to_i ? 'bg-gray-600/50' : '' %>"><span class="mr-2 text-right select-none text-gray-600"><%= n %></span><span><%= code %></span></div>
+    <% end %></code></pre></div>
+<% end %>

data/app/views/solid_errors/occurrences/_collection.html.erb

@@ -20,25 +20,25 @@
 
         <nav aria-label="Pages">
           <% if (first_page = page.first) %>
-            <a href="<%= url_for(params.to_unsafe_hash.merge(page: first_page)) %>" aria-label="First" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&laquo;</a>
+            <a href="<%= url_for(page: first_page, items: params[:items]) %>" aria-label="First" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&laquo;</a>
           <% else %>
             <a role="link" aria-disabled="true" aria-label="First" class="border text-gray-500 bg-white py-1 px-2">&laquo;</a>
           <% end %>
 
           <% if (prev_page = page.prev) %>
-            <a href="<%= url_for(params.to_unsafe_hash.merge(page: prev_page)) %>" aria-label="Previous" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&lsaquo;</a>
+            <a href="<%= url_for(page: prev_page, items: params[:items]) %>" aria-label="Previous" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&lsaquo;</a>
           <% else %>
             <a role="link" aria-disabled="true" aria-label="Previous" class="border text-gray-500 bg-white py-1 px-2">&lsaquo;</a>
           <% end %>
 
           <% if (next_page = page.next) %>
-            <a href="<%= url_for(params.to_unsafe_hash.merge(page: next_page)) %>" aria-label="Next" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&rsaquo;</a>
+            <a href="<%= url_for(page: next_page, items: params[:items]) %>" aria-label="Next" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&rsaquo;</a>
           <% else %>
             <a role="link" aria-disabled="true" aria-label="Next" class="border text-gray-500 bg-white py-1 px-2">&rsaquo;</a>
           <% end %>
 
           <% if (last_page = page.last) %>
-            <a href="<%= url_for(params.to_unsafe_hash.merge(page: last_page)) %>" aria-label="Last" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&raquo;</a>
+            <a href="<%= url_for(page: last_page, items: params[:items]) %>" aria-label="Last" class="border border-black text-black bg-white py-1 px-2 cursor-pointer hover:bg-black hover:text-white">&raquo;</a>
           <% else %>
             <a role="link" aria-disabled="true" aria-label="Last" class="border text-gray-500 bg-white py-1 px-2">&raquo;</a>
           <% end %>

data/app/views/solid_errors/occurrences/_occurrence.html.erb

@@ -25,22 +25,39 @@
             <%= SolidErrors::Occurrence.human_attribute_name(:backtrace) %>
           </dt>
           <dd class="">
-            <% backtrace.lines.each_with_index do |line, i| %>
-              <%= tag.details open: line.application? || i.zero? do %>
-                <summary class="hover:bg-gray-50 px-2 py-1 rounded cursor-pointer">
-                  <% if line.filtered_file %>
-                    <span class="text-gray-500"><%= File.dirname(line.filtered_file) %>/</span><span class="text-blue-500 font-medium"><%= File.basename(line.filtered_file) %></span>:<span class="text-gray-900 font-medium"><%= line.filtered_number %></span>
-                    <span class="text-gray-500">in</span>
-                    <code class="text-green-500 font-medium"><%= line.filtered_method %></code>
-                  <% else %>
-                    <span class="text-gray-500"><%= line.unparsed_line %></span>
-                  <% end %>
-                </summary>
-                <div><pre class="flex overflow-auto rounded-b-lg bg-slate-800 p-4 text-sm leading-normal text-white sm:rounded-t-lg"><code class="flex flex-1 flex-col min-h-full min-w-content px-0"><% line.source.each do |n, code| %>
-                    <div class="line <%= n == line.filtered_number.to_i ? 'bg-gray-600/50' : '' %>"><span class="mr-2 text-right select-none text-gray-600"><%= n %></span><span><%= code %></span></div>
-                  <% end %></code></pre></div>
+            <div class="flex gap-2 mb-3">
+              <button type="button"
+                      data-backtrace-toggle="application"
+                      data-occurrence-id="<%= occurrence.id %>"
+                      class="backtrace-toggle inline-flex items-center border-b-2 px-3 py-2 text-sm font-medium cursor-pointer border-blue-500 text-blue-500">
+                Application
+              </button>
+              <button type="button"
+                      data-backtrace-toggle="full"
+                      data-occurrence-id="<%= occurrence.id %>"
+                      class="backtrace-toggle inline-flex items-center border-b-2 px-3 py-2 text-sm font-medium cursor-pointer border-transparent text-gray-500 hover:border-gray-300 hover:text-gray-700">
+                Full
+              </button>
+            </div>
+
+            <div id="backtrace-application-<%= occurrence.id %>">
+              <% if backtrace.application_lines.empty? %>
+                <p class="text-gray-500 text-sm">
+                  <em>No application code in backtrace.</em>
+                  <button type="button" data-backtrace-toggle="full" data-occurrence-id="<%= occurrence.id %>" class="text-blue-500 hover:underline cursor-pointer">
+                    View full trace
+                  </button>
+                </p>
+              <% else %>
+                <%= render partial: "solid_errors/occurrences/backtrace_line", collection: backtrace.application_lines, as: :line, locals: {open: true} %>
+              <% end %>
+            </div>
+
+            <div id="backtrace-full-<%= occurrence.id %>" hidden>
+              <% backtrace.lines.each_with_index do |line, i| %>
+                <%= render "solid_errors/occurrences/backtrace_line", line: line, open: line.application? || i.zero? %>
               <% end %>
-            <% end %>
+            </div>
           </dd>
         </div>
       </dl>

data/lib/solid_errors/engine.rb

@@ -18,7 +18,7 @@ module SolidErrors
     end
 
     initializer "solid_errors.active_record.error_subscriber" do
-      Rails.error.subscribe(SolidErrors::Subscriber.new)
+      Rails.error.subscribe(SolidErrors::Subscriber.new) if SolidErrors.enabled
     end
   end
 end

data/lib/solid_errors/subscriber.rb

@@ -32,15 +32,18 @@ module SolidErrors
       }
       fingerprint = Digest::SHA256.hexdigest(error_attributes.values.join)
       if (record = SolidErrors::Error.find_by(fingerprint: fingerprint))
+        opens_error = :reopened if record.resolved?
         record.update!(resolved_at: nil, updated_at: Time.now)
       else
+        opens_error = :created
         record = SolidErrors::Error.create!(error_attributes.merge(fingerprint: fingerprint))
       end
 
       SolidErrors::Occurrence.create(
         error_id: record.id,
         backtrace: error.backtrace&.join("\n"),
-        context: s(context)
+        context: s(context),
+        opens_error: opens_error
       )
     end
 
@@ -49,7 +52,7 @@ module SolidErrors
     end
 
     def ignore_by_class?(error_class_name)
-      IGNORED_ERRORS.any? do |ignored_class|
+      [*IGNORED_ERRORS, *SolidErrors.ignored_errors].any? do |ignored_class|
         ignored_class_name = ignored_class.respond_to?(:name) ? ignored_class.name : ignored_class
 
         ignored_class_name == error_class_name

data/lib/solid_errors/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolidErrors
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/lib/solid_errors.rb

@@ -6,6 +6,7 @@ require_relative "solid_errors/subscriber"
 require_relative "solid_errors/engine"
 
 module SolidErrors
+  mattr_accessor :enabled, default: true
   mattr_accessor :connects_to
   mattr_accessor :base_controller_class, default: "::ActionController::Base"
   mattr_writer :username
@@ -14,7 +15,10 @@ module SolidErrors
   mattr_accessor :email_from, default: "solid_errors@noreply.com"
   mattr_accessor :email_to
   mattr_accessor :email_subject_prefix
+  mattr_accessor :email_every_occurrence, default: true
   mattr_accessor :destroy_after
+  mattr_accessor :ignored_errors, default: []
+  mattr_writer :url_helper_name, :url_options
 
   class << self
     # use method instead of attr_accessor to ensure
@@ -30,7 +34,41 @@ module SolidErrors
     end
 
     def send_emails?
-      send_emails && email_to.present?
+      send_emails && email_to.present? && !ActiveSupport::IsolatedExecutionState[:solid_errors_without_emails]
+    end
+
+    # Errors reported inside the block are recorded but never emailed
+    def without_emails
+      previous = ActiveSupport::IsolatedExecutionState[:solid_errors_without_emails]
+      ActiveSupport::IsolatedExecutionState[:solid_errors_without_emails] = true
+      yield
+    ensure
+      ActiveSupport::IsolatedExecutionState[:solid_errors_without_emails] = previous
+    end
+
+    def url_helper_name
+      @url_helper_name ||= detect_url_helper_name
+    end
+
+    def url_options
+      @url_options ||= detect_url_options
+    end
+
+    private
+
+    def find_solid_errors_route
+      @solid_errors_route ||= Rails.application.routes.routes.find do |r|
+        r.name&.to_s&.end_with?("solid_errors")
+      end
+    end
+
+    def detect_url_helper_name
+      find_solid_errors_route&.name&.to_sym || :solid_errors
+    end
+
+    def detect_url_options
+      subdomain = find_solid_errors_route&.constraints&.dig(:subdomain)
+      subdomain.is_a?(String) ? {subdomain: subdomain} : {}
     end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: solid_errors
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Stephen Margheim
 bindir: bin
 cert_chain: []
-date: 2025-06-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -15,70 +15,70 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: actionview
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -109,7 +109,7 @@ files:
 - app/models/solid_errors/error.rb
 - app/models/solid_errors/occurrence.rb
 - app/models/solid_errors/record.rb
-- app/views/layouts/solid_errors/_style.html
+- app/views/layouts/solid_errors/_style.html.erb
 - app/views/layouts/solid_errors/application.html.erb
 - app/views/solid_errors/error_mailer/error_occurred.html.erb
 - app/views/solid_errors/error_mailer/error_occurred.text.erb
@@ -120,6 +120,7 @@ files:
 - app/views/solid_errors/errors/_row.html.erb
 - app/views/solid_errors/errors/index.html.erb
 - app/views/solid_errors/errors/show.html.erb
+- app/views/solid_errors/occurrences/_backtrace_line.html.erb
 - app/views/solid_errors/occurrences/_collection.html.erb
 - app/views/solid_errors/occurrences/_occurrence.html.erb
 - config/locales/en.yml
@@ -145,14 +146,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Database-backed Rails error subscriber
 test_files: []