Improve installer and instructions

Changed

• Configure AppSignal with the install CLI when no known frameworks is found. Automate the configure step so that this doesn't have to be done manually along with the manual setup for the app.

Deprecated

• Deprecate the Appsignal.listen_for_error helper. Use a manual error rescue with Appsignal.report_error. This method allows for more customization of the reported error.

  Ruby

  # Before
  Appsignal.listen_for_error do
    raise "some error"
  end
   
  # After
  begin
    raise "some error"
  rescue => error
    Appsignal.report_error(error)
  end

  Read our Exception handling guide for more information.

• Deprecate the Appsignal.configure's app_path writer. Use the Appsignal.configure's root_path keyword argument to configure the path.

Fixed

• Fix an error on the Padrino require in the installer CLI. The latest Padrino version will crash the installer on load. Ignore the error when it fails to load.
• Fix the Appsignal.configure path config not being customizable. It's now possible to pass a root_path keyword argument to Appsignal.configure to customize the path from which AppSignal reads the config file, config/appsignal.yml.

View the Ruby gem v3.12.6 changelog for more information.