allure-rspec 2.13.8.3 → 2.13.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64cc3df4ca4fdc6d5c03ffd350636fdd1adf1d1b380adf676729baedf20cd558
-  data.tar.gz: 43b4c2d026e4d73ccd13c3389ac1094d9f87aa49b7daf3861b7b6c5ee275dacd
+  metadata.gz: d01ab27cd9cc6ad5c060178bd137332f40c5c13627f2f7e5ca05d64b56ccf8dd
+  data.tar.gz: 98779dfe52f3359c2c99a8c28283b8572b078522a68a1a221cc660a179e7297b
 SHA512:
-  metadata.gz: 5bf9d35a82ab0f3a36d1bd134489ac02e16660d584fd42e076966de82e8ae7e6c2546024eee7851155f6cd06fc02ef4db93b828dcac2abd27b4dc9c2124175dc
-  data.tar.gz: ffcc4cc2d5907e2fee29de24648f39fdc8414b3f816a7ce0eb27a21786f241e60d4345b29f2f29a2d1a7f5213756dba948776d938d638528ae1f8cdae86dde5f
+  metadata.gz: 4ee00f85efe8744c61be183eac83be011d38f59d17600373e3e4e5d561939c95c3ae5e680c202bdb8d1cf9a347e5ea527a9b553cadfa2cf1c3084f5143870180
+  data.tar.gz: 2f274e54aea447b7aff6f2b5d3d457f1f6334f59afcf737de101d407dda1ec2c87eba89f1c9445b67d288715d40ddea22d8e4310c62b77c852cfdabb0ff7f106

data/README.md

@@ -131,6 +131,24 @@ it "some test case", allure_1: "visual_test", allure_2: "core_functionality" do
 end
 ```
 
+### Behavior driven test grouping
+
+Marking tests with tags `:story, :feature, :story`, will group tests accordingly in Behavior report tab:
+
+```ruby
+context "context", feature: "my feature"  do
+  it "some test case", story: "user story" do
+    # test
+  end
+end
+
+context "context 2", feature: "my feature" do
+it "some test case 2", story: "user story" do
+    # test
+  end
+end
+```
+
 ### Custom actions
 
 Rspec example object has access to [Allure](https://www.rubydoc.info/github/allure-framework/allure-ruby/Allure) helper methods.

data/lib/allure-rspec.rb

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 require "allure-ruby-commons"
-require "allure_rspec/config"
-require "allure_rspec/formatter"
+
+require_rel "allure_rspec/**/*.rb"
 
 module AllureRspec
   class << self

data/lib/allure_rspec/01_utils.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module AllureRspec
+  module Utils
+    # Strip relative ./ form path
+    # @param [String] path
+    # @return [String]
+    def strip_relative(path)
+      path.gsub("./", "")
+    end
+  end
+end

data/lib/allure_rspec/metadata_parser.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+module AllureRspec
+  # Suite label generator
+  #
+  class SuiteLabels
+    include Utils
+
+    def initialize(example_group)
+      @example_group = example_group
+    end
+
+    # Get test suite labels
+    # @return [Array<Allure::Label>]
+    def fetch
+      parents = example_group.parent_groups.map do |group|
+        group.description.empty? ? "Anonymous" : group.description
+      end
+
+      labels = []
+      labels << Allure::ResultUtils.suite_label(suite(parents))
+      labels << Allure::ResultUtils.parent_suite_label(parent_suite(parents)) if parent_suite(parents)
+      labels << Allure::ResultUtils.sub_suite_label(sub_suites(parents)) if sub_suites(parents)
+
+      labels
+    end
+
+    private
+
+    attr_reader :example_group
+
+    # @param [Array<String>] parents
+    # @return [String]
+    def suite(parents)
+      parents.length == 1 ? parents.last : parents[-2]
+    end
+
+    # @param [Array<String>] parents
+    # @return [String]
+    def parent_suite(parents)
+      parents.length > 1 ? parents.last : nil
+    end
+
+    # @param [Array<String>] parents
+    # @return [String]
+    def sub_suites(parents)
+      parents.length > 2 ? parents[0..-3].join(" > ") : nil
+    end
+  end
+
+  # RSpec metadata parser
+  #
+  class RspecMetadataParser
+    include Utils
+
+    RSPEC_IGNORED_METADATA = %i[
+      absolute_file_path
+      block
+      described_class
+      description
+      description_args
+      example_group
+      execution_result
+      file_path
+      full_description
+      last_run_status
+      line_number
+      location
+      rerun_file_path
+      retry
+      retry_attempts
+      retry_exceptions
+      scoped_id
+      shared_group_inclusion_backtrace
+      type
+    ].freeze
+
+    def initialize(example)
+      @example = example
+    end
+
+    # Get allure labels
+    # @return [Array<Allure::Label>]
+    def labels
+      [
+        framework_label,
+        package_label,
+        test_class_label,
+        severity,
+        *tag_labels,
+        *behavior_labels,
+        *suite_labels
+      ]
+    end
+
+    # Get attachable links
+    # @return [Array<Allure::Link>]
+    def links
+      matching_links(:tms) + matching_links(:issue)
+    end
+
+    # Get status details
+    # @return [Allure::StatusDetails]
+    def status_details
+      Allure::StatusDetails.new(
+        flaky: !metadata[:flaky].nil?,
+        muted: !metadata[:muted].nil?,
+        known: !metadata[:known].nil?
+      )
+    end
+
+    private
+
+    # @param [RSpec::Core::Example] example
+    attr_reader :example
+
+    # Example metadata
+    #
+    # @return [Hash]
+    def metadata
+      @metadata ||= example.metadata
+    end
+
+    # Get package label
+    # @return [Allure::Label]
+    def package_label
+      Allure::ResultUtils.package_label(Pathname.new(strip_relative(example.file_path)).parent.to_s)
+    end
+
+    # Get test class label
+    #
+    # @return [Allure::Label]
+    def test_class_label
+      Allure::ResultUtils.test_class_label(File.basename(example.file_path, ".rb"))
+    end
+
+    # Get framework label
+    # @return [Allure::Label]
+    def framework_label
+      Allure::ResultUtils.framework_label("rspec")
+    end
+
+    # Get severity
+    # @return [String]
+    def severity
+      Allure::ResultUtils.severity_label(metadata[:severity] || "normal")
+    end
+
+    # Get test suite labels
+    # @return [Array<Allure::Label>]
+    def suite_labels
+      SuiteLabels.new(example.example_group).fetch
+    end
+
+    # Get custom labels
+    # @return [Array<Allure::Label>]
+    def tag_labels
+      metadata
+        .reject { |k| RSPEC_IGNORED_METADATA.include?(k) || special_metadata_tag?(k) }
+        .map { |k, v| allure?(k) ? Allure::ResultUtils.tag_label(v) : Allure::ResultUtils.tag_label(k.to_s) }
+    end
+
+    # Get behavior labels
+    # @return [Array<Allure::Label>]
+    def behavior_labels
+      metadata = example.metadata
+      epic = metadata[:epic] || Pathname.new(strip_relative(example.file_path)).parent.to_s
+      feature = metadata[:feature] || example.example_group.description
+      story = metadata[:story] || example.description
+
+      [
+        Allure::ResultUtils.epic_label(epic),
+        Allure::ResultUtils.feature_label(feature),
+        Allure::ResultUtils.story_label(story)
+      ]
+    end
+
+    # tms and issue links
+    # @param [Symbol] type
+    # @return [Array<Allure::Link>]
+    def matching_links(type)
+      return [] unless AllureRspec.configuration.public_send("link_#{type}_pattern")
+
+      metadata
+        .select { |k| __send__("#{type}?", k) }.values
+        .map { |v| Allure::ResultUtils.public_send("#{type}_link", v) }
+    end
+
+    # Special allure metadata tags
+    #
+    # @param [Symbol] key
+    # @return [boolean]
+    def special_metadata_tag?(key)
+      tms?(key) || issue?(key) || %i[severity epic feature story].include?(key)
+    end
+
+    # Does key match custom allure label
+    # @param [Symbol] key
+    # @return [boolean]
+    def allure?(key)
+      key.to_s.match?(/allure(_\d+)?/i)
+    end
+
+    # Does key match tms pattern
+    # @param [Symbol] key
+    # @return [boolean]
+    def tms?(key)
+      key.to_s.match?(/tms(_\d+)?/i)
+    end
+
+    # Does key match issue pattern
+    # @param [Symbol] key
+    # @return [boolean]
+    def issue?(key)
+      key.to_s.match?(/issue(_\d+)?/i)
+    end
+  end
+end

data/lib/allure_rspec/rspec_model.rb

@@ -3,12 +3,10 @@
 require "digest"
 require "pathname"
 
-require_relative "tag_parser"
-
 module AllureRspec
   # Support class for transforming rspec test entities in to allure model entities
   module AllureRspecModel
-    include TagParser
+    include AllureRspec::Utils
 
     # @return [Hash] allure statuses mapping
     ALLURE_STATUS = {
@@ -21,15 +19,17 @@ module AllureRspec
     # @param [RSpec::Core::Example] example
     # @return [Allure::TestResult]
     def test_result(example)
+      parser = RspecMetadataParser.new(example)
+
       Allure::TestResult.new(
         name: example.description,
         description: "Location - #{strip_relative(example.location)}",
         description_html: "Location - #{strip_relative(example.location)}",
         history_id: Digest::MD5.hexdigest(example.id),
         full_name: example.full_description,
-        labels: labels(example),
-        links: links(example),
-        status_details: Allure::StatusDetails.new(**status_detail_tags(example.metadata))
+        labels: parser.labels,
+        links: parser.links,
+        status_details: parser.status_details
       )
     end
 
@@ -49,12 +49,6 @@ module AllureRspec
 
     private
 
-    # @param [RSpec::Core::Example] example
-    # @return [Array<Allure::Label>]
-    def links(example)
-      tms_links(example.metadata) + issue_links(example.metadata)
-    end
-
     # Get allure status from result
     # @param [RSpec::Core::Example::ExecutionResult] result
     # @return [Symbol]
@@ -63,59 +57,5 @@ module AllureRspec
 
       ALLURE_STATUS[result.status]
     end
-
-    # @param [RSpec::Core::Example] example
-    # @return [Array<Allure::Label>]
-    def labels(example)
-      labels = []
-      labels << Allure::ResultUtils.framework_label("rspec")
-      labels << Allure::ResultUtils.feature_label(example.example_group.description)
-      labels << Allure::ResultUtils.package_label(Pathname.new(strip_relative(example.file_path)).parent.to_s)
-      labels << Allure::ResultUtils.story_label(example.description)
-      labels << Allure::ResultUtils.test_class_label(File.basename(example.file_path, ".rb"))
-      labels << severity(example.metadata)
-      labels.push(*tag_labels(example.metadata))
-      labels.push(*suite_labels(example.example_group))
-
-      labels
-    end
-
-    # Add suite labels
-    # @param [RSpec::Core::ExampleGroup] example_group
-    # @return [Array<Allure::Label>]
-    def suite_labels(example_group)
-      parents = example_group.parent_groups.map { |group| group.description.empty? ? "Anonymous" : group.description }
-      labels = []
-      labels << Allure::ResultUtils.suite_label(suite(parents))
-      labels << Allure::ResultUtils.parent_suite_label(parent_suite(parents)) if parent_suite(parents)
-      labels << Allure::ResultUtils.sub_suite_label(sub_suites(parents)) if sub_suites(parents)
-
-      labels
-    end
-
-    # @param [Array<String>] parents
-    # @return [String]
-    def suite(parents)
-      parents.length == 1 ? parents.last : parents[-2]
-    end
-
-    # @param [Array<String>] parents
-    # @return [String]
-    def parent_suite(parents)
-      parents.length > 1 ? parents.last : nil
-    end
-
-    # @param [Array<String>] parents
-    # @return [String]
-    def sub_suites(parents)
-      parents.length > 2 ? parents[0..-3].join(" > ") : nil
-    end
-
-    # Strip relative ./ form path
-    # @param [String] path
-    # @return [String]
-    def strip_relative(path)
-      path.gsub("./", "")
-    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: allure-rspec
 version: !ruby/object:Gem::Version
-  version: 2.13.8.3
+  version: 2.13.8.4
 platform: ruby
 authors:
 - Andrejs Cunskis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-19 00:00:00.000000000 Z
+date: 2021-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: allure-ruby-commons
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.13.8.3
+        version: 2.13.8.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.13.8.3
+        version: 2.13.8.4
 - !ruby/object:Gem::Dependency
   name: rspec-core
   requirement: !ruby/object:Gem::Requirement
@@ -66,10 +66,11 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/allure-rspec.rb
+- lib/allure_rspec/01_utils.rb
 - lib/allure_rspec/config.rb
 - lib/allure_rspec/formatter.rb
+- lib/allure_rspec/metadata_parser.rb
 - lib/allure_rspec/rspec_model.rb
-- lib/allure_rspec/tag_parser.rb
 homepage: https://github.com/allure-framework/allure-ruby/tree/master/allure-rspec
 licenses:
 - Apache-2.0

data/lib/allure_rspec/tag_parser.rb

@@ -1,106 +0,0 @@
-# frozen_string_literal: true
-
-module AllureRspec
-  # RSpec custom tag parser
-  module TagParser
-    # Get custom labels
-    # @param [Hash] metadata
-    # @return [Array<Allure::Label>]
-    def tag_labels(metadata)
-      metadata.reject { |k| RSPEC_IGNORED_METADATA.include?(k) }.map do |k, v|
-        allure?(k) ? Allure::ResultUtils.tag_label(v) : Allure::ResultUtils.tag_label(k.to_s)
-      end
-    end
-
-    # Get tms links
-    # @param [Hash] metadata
-    # @return [Array<Allure::Link>]
-    def tms_links(metadata)
-      matching_links(metadata, :tms)
-    end
-
-    # Get issue links
-    # @param [Hash] metadata
-    # @return [Array<Allure::Link>]
-    def issue_links(metadata)
-      matching_links(metadata, :issue)
-    end
-
-    # Get severity
-    # @param [Hash] metadata
-    # @return [String]
-    def severity(metadata)
-      Allure::ResultUtils.severity_label(metadata[:severity] || "normal")
-    end
-
-    # Get status details
-    # @param [Hash] metadata
-    # @return [Hash<Symbol, Boolean>]
-    def status_detail_tags(metadata)
-      {
-        flaky: !metadata[:flaky].nil?,
-        muted: !metadata[:muted].nil?,
-        known: !metadata[:known].nil?
-      }
-    end
-
-    private
-
-    RSPEC_IGNORED_METADATA = %i[
-      absolute_file_path
-      block
-      described_class
-      description
-      description_args
-      example_group
-      execution_result
-      file_path
-      full_description
-      last_run_status
-      line_number
-      location
-      rerun_file_path
-      retry
-      retry_attempts
-      retry_exceptions
-      scoped_id
-      shared_group_inclusion_backtrace
-      type
-    ].freeze
-
-    # @param [Hash] metadata
-    # @param [Symbol] type
-    # @return [Array<Allure::Link>]
-    def matching_links(metadata, type)
-      unless AllureRspec.configuration.public_send("link_#{type}_pattern") &&
-             metadata.keys.any? { |k| __send__("#{type}?", k) }
-        return []
-      end
-
-      metadata
-        .select { |k| __send__("#{type}?", k) }.values
-        .map { |v| Allure::ResultUtils.public_send("#{type}_link", v) }
-    end
-
-    # Does key match custom allure label
-    # @param [Symbol] key
-    # @return [boolean]
-    def allure?(key)
-      key.to_s.match?(/allure(_\d+)?/i)
-    end
-
-    # Does key match tms pattern
-    # @param [Symbol] key
-    # @return [boolean]
-    def tms?(key)
-      key.to_s.match?(/tms(_\d+)?/i)
-    end
-
-    # Does key match issue pattern
-    # @param [Symbol] key
-    # @return [boolean]
-    def issue?(key)
-      key.to_s.match?(/issue(_\d+)?/i)
-    end
-  end
-end