errmine 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14575fe3e975be6308fefa8663defb90c80e552766ac0b1c552feee30c3e7209
-  data.tar.gz: a967ca060190180ff8bb6d76abe237f131aab11b842f8b57c1ce6cef16fd417f
+  metadata.gz: 4f71e4d605d9ce77753b0ffdea51499feb507ecc8b65fc156890c04a86bad270
+  data.tar.gz: 2c1d3242c5daa6c66035e13a59f68c6a890156f9f48d7635a6d535c9762ba0bb
 SHA512:
-  metadata.gz: e057ce4bd6639aa550b148c245bb2224ac126546a4cc287842fcb26d5cbf227fddfed1fc473a5d241bf0405511712be256308234a96cc0504e32149214b2489a
-  data.tar.gz: 6291e7878535a180967c319a05d78379962f6209c4e972f062f8d1d0cdfa36c92be4fada846e8d552d9c983fb301d71833dad3cc52f418b4acf7de020e8f35ea
+  metadata.gz: dc3955573efbb9a1cff490071a3678f3a2bc7a6c04469f15a253b44560d275b0c4a26e84cd41583e80f47e421f11cfaf0b0a74ee5238b33ec8b8df27bfa6a140
+  data.tar.gz: 06eef437876a00211d6ccceaac6d06dca2846e1a1526c595e531e341379e30b788ce63f38aab46d97ff2b139e67ebb5f5ef83b06e22093b8b5af2785effb8ede

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Errmine changelog
 
+## 0.2.0 (2025-12-24)
+- [Feature] Add app name to issue title for easy identification when multiple apps report to the same Redmine project.
+- [Feature] Include app_name in checksum calculation so same errors in different apps create separate issues.
+- [Feature] Add `Errmine.create_issue` method for creating custom Redmine issues with arbitrary subject, description, tracker, project, and tags.
+- [Feature] Add tags support via `tag_list` parameter for both exception reporting and custom issues.
+- [Feature] Add `default_tags` configuration option for tags applied to all issues.
+- [Maintenance] Update actions/checkout to v6 in CI.
+
 ## 0.1.1 (2025-12-23)
 - [Fix] Fix file permissions for gem packaging.
 - [Fix] Fix gemspec metadata duplicate URI warning.

data/lib/errmine/notifier.rb

@@ -62,6 +62,38 @@ module Errmine
       @mutex.synchronize { @cache.clear }
     end
 
+    # Creates a custom issue in Redmine
+    #
+    # @param subject [String] issue subject/title
+    # @param description [String] issue description (Textile format)
+    # @param options [Hash] optional overrides
+    # @option options [String] :project_id Redmine project identifier
+    # @option options [Integer] :tracker_id Redmine tracker ID
+    # @option options [Array<String>] :tags tags to add to the issue
+    # @return [Hash, nil] the created issue or nil on failure
+    def create_custom_issue(subject:, description:, **options)
+      uri = build_uri('/issues.json')
+
+      issue_data = {
+        project_id: options[:project_id] || config.project_id,
+        tracker_id: options[:tracker_id] || config.tracker_id,
+        subject: subject,
+        description: description
+      }
+
+      tags = build_tag_list(options[:tags])
+      issue_data[:tag_list] = tags unless tags.empty?
+
+      response = http_post(uri, { issue: issue_data })
+      return nil unless response
+
+      data = JSON.parse(response.body)
+      data['issue']
+    rescue JSON::ParserError => e
+      warn "[Errmine] Failed to parse response: #{e.message}"
+      nil
+    end
+
     private
 
     # Returns the Errmine configuration
@@ -71,13 +103,23 @@ module Errmine
       Errmine.configuration
     end
 
+    # Builds a combined tag list from default tags and provided tags
+    #
+    # @param tags [Array<String>, nil] additional tags to include
+    # @return [Array<String>] combined unique tags
+    def build_tag_list(tags)
+      combined = config.default_tags.dup
+      combined.concat(Array(tags)) if tags
+      combined.uniq
+    end
+
     # Generates an 8-character checksum for the exception
     #
     # @param exception [Exception]
     # @return [String]
     def generate_checksum(exception)
       first_app_line = first_app_backtrace_line(exception)
-      data = "#{exception.class}:#{exception.message}:#{first_app_line}"
+      data = "#{config.app_name}:#{exception.class}:#{exception.message}:#{first_app_line}"
       Digest::MD5.hexdigest(data)[0, 8]
     end
 
@@ -167,16 +209,17 @@ module Errmine
       subject = build_subject(checksum, 1, exception)
       description = build_description(exception, context)
 
-      payload = {
-        issue: {
-          project_id: config.project_id,
-          tracker_id: config.tracker_id,
-          subject: subject,
-          description: description
-        }
+      issue_data = {
+        project_id: config.project_id,
+        tracker_id: config.tracker_id,
+        subject: subject,
+        description: description
       }
 
-      response = http_post(uri, payload)
+      tags = build_tag_list(context[:tags])
+      issue_data[:tag_list] = tags unless tags.empty?
+
+      response = http_post(uri, { issue: issue_data })
       return nil unless response
 
       data = JSON.parse(response.body)
@@ -225,7 +268,7 @@ module Errmine
       truncated = message.length > SUBJECT_MESSAGE_LENGTH ? "#{message[0, SUBJECT_MESSAGE_LENGTH]}..." : message
       truncated = truncated.gsub(/[\r\n]+/, ' ').strip
 
-      "[#{checksum}][#{count}] #{exception.class}: #{truncated}"
+      "[#{config.app_name}][#{checksum}][#{count}] #{exception.class}: #{truncated}"
     end
 
     # Builds the issue description in Textile format

data/lib/errmine/version.rb

@@ -2,5 +2,5 @@
 
 module Errmine
   # Current version of the errmine gem
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/lib/errmine.rb

@@ -29,6 +29,9 @@ module Errmine
     # @return [String] Application name shown in issues
     attr_accessor :app_name
 
+    # @return [Array<String>] Default tags to add to all issues
+    attr_accessor :default_tags
+
     # @return [Boolean] Whether notifications are enabled
     attr_accessor :enabled
 
@@ -37,13 +40,14 @@ module Errmine
 
     # Initializes configuration with defaults from environment variables
     def initialize
-      @redmine_url = ENV.fetch('ERRMINE_REDMINE_URL', nil)
-      @api_key     = ENV.fetch('ERRMINE_API_KEY', nil)
-      @project_id  = ENV['ERRMINE_PROJECT'] || 'bug-tracker'
-      @tracker_id  = 1
-      @app_name    = ENV['ERRMINE_APP_NAME'] || 'unknown'
-      @enabled     = true
-      @cooldown    = 300
+      @redmine_url  = ENV.fetch('ERRMINE_REDMINE_URL', nil)
+      @api_key      = ENV.fetch('ERRMINE_API_KEY', nil)
+      @project_id   = ENV['ERRMINE_PROJECT'] || 'bug-tracker'
+      @tracker_id   = 1
+      @app_name     = ENV['ERRMINE_APP_NAME'] || 'unknown'
+      @default_tags = []
+      @enabled      = true
+      @cooldown     = 300
     end
 
     # Checks if the configuration has required values
@@ -93,6 +97,25 @@ module Errmine
       warn "[Errmine] Failed to notify: #{e.message}"
       nil
     end
+
+    # Creates a custom issue in Redmine
+    #
+    # @param subject [String] issue subject/title
+    # @param description [String] issue description (Textile format)
+    # @param options [Hash] optional keyword arguments
+    # @option options [String] :project_id Redmine project identifier
+    # @option options [Integer] :tracker_id Redmine tracker ID
+    # @option options [Array<String>] :tags tags to add to the issue
+    # @return [Hash, nil] the created issue or nil on failure
+    def create_issue(subject:, description:, **options)
+      return unless configuration.enabled
+      return unless configuration.valid?
+
+      Notifier.instance.create_custom_issue(subject: subject, description: description, **options)
+    rescue StandardError => e
+      warn "[Errmine] Failed to create issue: #{e.message}"
+      nil
+    end
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: errmine
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Maciej Mensfeld