allure-cucumber 2.13.8 → 2.13.8.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7d77ff4a8eb6b33fe7fb6e8fb0fe43c30715e602748ab82045413db15e73205
-  data.tar.gz: dfe08d10319023b251ee3fc7d9ed23c2b48c341122130e774e0a33a5f981ad6c
+  metadata.gz: 57a580b2688ec11e41f3f5908c951f6d31d5258687baf78f06f19dd49360ba36
+  data.tar.gz: 4c0d60f34cf3ad25a2b65b1149b347a569d8da0cf7b0923c90cec39cf4f75a04
 SHA512:
-  metadata.gz: c39009ffb92212511a4b3a2e6f64ddb85eddfb357b7ef18a0e5757cdaa9b451574499379c823dfa23ad6c415bb10521b6156cb5b9e8c7b5f375dd7c912a15bcc
-  data.tar.gz: 8ae456ea73dc7fd9f68bb379553b4b2e807db6ca932a13c35e109c9164b260fd0d39c71cfccf9c523a9aa0a531d89fc17c62bda7edc2d2ffc02cfd0bbc7c11ca
+  metadata.gz: f1aa240e8acab0e721c4347f31d7eebce0ef49ca5c1757bb3b55b896ee44ad89a9e164874cb2dc93d4114bf7880d3e4bd262bffb016c89d99d6ef48f30a2f00f
+  data.tar.gz: 5a9fb7d3c2c606368d8fb8028eb26a67942012375b725fc89d99836b0342e8230100d3feb9555ba1095f8feb8d4891a9d6fa8d516d0b3b4a6e14f8a772d2b75c

data/README.md

@@ -52,18 +52,24 @@ AllureCucumber.configure do |config|
 end
 ```
 
-By default, allure-cucumber will analyze your cucumber tags looking for Test Management, Issue Management, and Severity tag. Links to TMS and ISSUE and test severity will be displayed in the report. By default these prefixes are used:
+By default, allure-cucumber will analyze your cucumber tags looking for Test Management, Issue Management, and Severity tag as well
+as custom tags for grouping tests in to epics, features and stories in Behavior tab of report. Links to TMS and ISSUE and test severity will be displayed in the report.
+
+By default these prefixes are used:
 
 ```ruby
     DEFAULT_TMS_PREFIX      = 'TMS:'
     DEFAULT_ISSUE_PREFIX    = 'ISSUE:'
     DEFAULT_SEVERITY_PREFIX = 'SEVERITY:'
+    DEFAULT_EPIC_PREFIX     = 'EPIC:'
+    DEFAULT_FEATURE_PREFIX  = 'FEATURE:'
+    DEFAULT_STORY_PREFIX    = 'STORY:'
 ```
 
 Example:
 
 ```gherkin
-  @SEVERITY:trivial @ISSUE:YZZ-100 @TMS:9901
+  @SEVERITY:trivial @ISSUE:YZZ-100 @TMS:9901 @EPIC:custom-epic
   Scenario: Leave First Name Blank
     When I register an account without a first name
     Then exactly (1) [validation_error] should be visible
@@ -76,13 +82,16 @@ AllureCucumber.configure do |config|
   config.tms_prefix      = 'HIPTEST--'
   config.issue_prefix    = 'JIRA++'
   config.severity_prefix = 'URGENCY:'
+  config.epic_prefix = 'epic:'
+  config.feature_prefix = 'feature:'
+  config.story_prefix = 'story:'
 end
 ```
 
 Example:
 
 ```gherkin
-  @URGENCY:critical @JIRA++YZZ-100 @HIPTEST--9901
+  @URGENCY:critical @JIRA++YZZ-100 @HIPTEST--9901 @epic:custom-epic
   Scenario: Leave First Name Blank
     When I register an account without a first name
     Then exactly (1) [validation_error] should be visible
@@ -105,6 +114,8 @@ Allure.add_attachment(name: "attachment", source: "Some string", type: Allure::C
 Allure.add_link("Custom Url", "http://www.github.com")
 ```
 
+It's possible to mark methods so those are included as allure steps: [Step annotations](../allure-ruby-commons/README.md#steps)
+
 ### Example project
 
 [Cucumber Example](https://github.com/allure-examples/allure-cucumber-example)

data/lib/allure-cucumber.rb

@@ -3,8 +3,7 @@
 
 require "allure-ruby-commons"
 
-require "allure_cucumber/config"
-require "allure_cucumber/formatter"
+require_rel "allure_cucumber"
 
 # Main allure-cucumber module providing configuration methods
 module AllureCucumber

data/lib/allure_cucumber/config.rb

@@ -15,6 +15,12 @@ module AllureCucumber
     DEFAULT_ISSUE_PREFIX = "ISSUE:"
     # @return [String] default severity tag prefix
     DEFAULT_SEVERITY_PREFIX = "SEVERITY:"
+    # @return [String] default epic tag prefix
+    DEFAULT_EPIC_PREFIX = "EPIC:"
+    # @return [String] default feature tag prefix
+    DEFAULT_FEATURE_PREFIX = "FEATURE:"
+    # @return [String] default story tag prefix
+    DEFAULT_STORY_PREFIX = "STORY:"
 
     def_delegators :@allure_config,
                    :clean_results_directory,
@@ -50,5 +56,20 @@ module AllureCucumber
     def severity_prefix
       @severity_prefix || DEFAULT_SEVERITY_PREFIX
     end
+
+    # @return [String]
+    def epic_prefix
+      @epic_prefix || DEFAULT_EPIC_PREFIX
+    end
+
+    # @return [String]
+    def feature_prefix
+      @feature_prefix || DEFAULT_FEATURE_PREFIX
+    end
+
+    # @return [String]
+    def story_prefix
+      @story_prefix || DEFAULT_STORY_PREFIX
+    end
   end
 end

data/lib/allure_cucumber/formatter.rb

@@ -2,8 +2,6 @@
 
 require "cucumber/core"
 
-require_relative "models/cucumber_model"
-
 module AllureCucumber
   # Main formatter class. Translates cucumber event to allure lifecycle
   class CucumberFormatter
@@ -67,10 +65,8 @@ module AllureCucumber
         step.stage = Allure::Stage::FINISHED
         step.status = ALLURE_STATUS.fetch(event.result.to_sym, Allure::Status::BROKEN)
       end
-      step_type = event.test_step.hook? ? "fixture" : "test_step"
 
-      lifecycle.public_send("update_#{step_type}", &update_block)
-      lifecycle.public_send("stop_#{step_type}")
+      event.test_step.hook? ? handle_hook_finished(event.test_step, update_block) : handle_step_finished(update_block)
     end
 
     # Handle test case finished event
@@ -100,6 +96,13 @@ module AllureCucumber
       Allure.lifecycle
     end
 
+    # Is hook fixture like Before, After or Step as AfterStep
+    # @param [String] text
+    # @return [boolean]
+    def fixture_hook?(text)
+      HOOK_HANDLERS.key?(text)
+    end
+
     # @param [Cucumber::Core::Test::Step] test_step
     # @return [void]
     def handle_step_started(test_step)
@@ -111,7 +114,27 @@ module AllureCucumber
     # @param [Cucumber::Core::Test::HookStep] hook_step
     # @return [void]
     def handle_hook_started(hook_step)
-      lifecycle.public_send(HOOK_HANDLERS[hook_step.text], cucumber_model.fixture_result(hook_step))
+      result = cucumber_model.fixture_result(hook_step)
+      return lifecycle.start_test_step(result) unless fixture_hook?(hook_step.text)
+
+      lifecycle.public_send(HOOK_HANDLERS[hook_step.text], result)
+    end
+
+    # @param [Proc] update_block
+    # @return [void]
+    def handle_step_finished(update_block)
+      lifecycle.update_test_step(&update_block)
+      lifecycle.stop_test_step
+    end
+
+    # @param [Cucumber::Core::Test::HookStep] hook_step
+    # @param [Proc] update_block
+    # @return [void]
+    def handle_hook_finished(hook_step, update_block)
+      return handle_step_finished(update_block) unless fixture_hook?(hook_step.text)
+
+      lifecycle.update_fixture(&update_block)
+      lifecycle.stop_fixture
     end
   end
 end

data/lib/allure_cucumber/models/cucumber_model.rb

@@ -4,15 +4,9 @@ require "csv"
 require "cucumber/core"
 require "cucumber/formatter/ast_lookup"
 
-require_relative "scenario"
-require_relative "step"
-require_relative "tag_parser"
-
 module AllureCucumber
   # Support class for transforming cucumber test entities in to allure model entities
   class AllureCucumberModel
-    include TagParser
-
     # @param [Cucumber::Configuration] config
     def initialize(config)
       @ast_lookup = Cucumber::Formatter::AstLookup.new(config)
@@ -23,6 +17,7 @@ module AllureCucumber
     # @return [Allure::TestResult]
     def test_result(test_case)
       scenario = Scenario.new(test_case, ast_lookup)
+      parser = MetadataParser.new(scenario)
 
       Allure::TestResult.new(
         name: scenario.name,
@@ -30,10 +25,10 @@ module AllureCucumber
         description_html: scenario.description,
         history_id: scenario.id,
         full_name: scenario.name,
-        labels: labels(scenario),
-        links: links(scenario),
-        parameters: parameters(scenario),
-        status_details: Allure::StatusDetails.new(**status_detail_tags(scenario.tags))
+        labels: parser.labels,
+        links: parser.links,
+        parameters: parser.parameters,
+        status_details: parser.status_details
       )
     end
 
@@ -55,7 +50,7 @@ module AllureCucumber
     # @param [Cucumber::Core::Test::HookStep] hook_step
     # @return [Allure::StepResult]
     def fixture_result(hook_step)
-      Allure::FixtureResult.new(name: hook_step.location.to_s.split("/").last)
+      Allure::FixtureResult.new(name: "#{hook_step.text} (#{hook_step.location.to_s.split('/').last})")
     end
 
     # Get failure details
@@ -72,36 +67,6 @@ module AllureCucumber
 
     attr_reader :ast_lookup, :lifecycle
 
-    # @param [Scenario] scenario
-    # @return [Array<Allure::Label>]
-    def labels(scenario)
-      labels = []
-      labels << Allure::ResultUtils.framework_label("cucumber")
-      labels << Allure::ResultUtils.feature_label(scenario.feature_name)
-      labels << Allure::ResultUtils.package_label(scenario.feature_folder)
-      labels << Allure::ResultUtils.suite_label(scenario.feature_name)
-      labels << Allure::ResultUtils.story_label(scenario.name)
-      labels << Allure::ResultUtils.test_class_label(scenario.feature_file_name)
-      unless scenario.tags.empty?
-        labels.push(*tag_labels(scenario.tags))
-        labels << severity(scenario.tags)
-      end
-
-      labels
-    end
-
-    # @param [Cucumber::Core::Test::Case] test_case
-    # @return [Array<Allure::Link>]
-    def links(test_case)
-      tms_links(test_case.tags) + issue_links(test_case.tags)
-    end
-
-    # @param [AllureCucumber::Scenario] scenario
-    # @return [Array<Allure::Parameter>]
-    def parameters(scenario)
-      scenario.examples.map { |k, v| Allure::Parameter.new(k, v) }
-    end
-
     # @param [Step] step
     # @return [Array<Allure::Attachment>]
     def step_attachments(step)

data/lib/allure_cucumber/models/metadata_parser.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module AllureCucumber
+  # Cucumber tag parser helper methods
+  class MetadataParser
+    def initialize(scenario)
+      @scenario = scenario
+    end
+
+    # @return [Array<Allure::Label>]
+    def labels
+      [
+        Allure::ResultUtils.framework_label("cucumber"),
+        Allure::ResultUtils.package_label(scenario.feature_folder),
+        Allure::ResultUtils.test_class_label(scenario.feature_file_name),
+        Allure::ResultUtils.suite_label(scenario.feature_name),
+        severity,
+        *behavior_labels,
+        *tag_labels
+      ].select(&:value)
+    end
+
+    # @return [Array<Allure::Label>]
+    def tag_labels
+      tags
+        .reject { |tag| reserved?(tag) }
+        .map { |tag| Allure::ResultUtils.tag_label(tag.delete_prefix("@")) }
+    end
+
+    # @param [Cucumber::Core::Test::Case] test_case
+    # @return [Array<Allure::Link>]
+    def links
+      tms_links + issue_links
+    end
+
+    # @return [Allure::Label]
+    def severity
+      Allure::ResultUtils.severity_label(tag_value(:severity) || "normal")
+    end
+
+    # @return [Array<Allure::Parameter>]
+    def parameters
+      scenario.examples.map { |k, v| Allure::Parameter.new(k, v) }
+    end
+
+    # @return [Hash<Symbol, Boolean>]
+    def status_details
+      Allure::StatusDetails.new(
+        flaky: tags.any? { |tag| tag.match?(reserved_patterns[:flaky]) },
+        muted: tags.any? { |tag| tag.match?(reserved_patterns[:muted]) },
+        known: tags.any? { |tag| tag.match?(reserved_patterns[:known]) }
+      )
+    end
+
+    # Get behavior labels
+    # @return [Array<Allure::Label>]
+    def behavior_labels
+      epic = tag_value(:epic) || scenario.feature_folder
+      feature = tag_value(:feature) || scenario.feature_name
+      story = tag_value(:story)
+
+      [
+        Allure::ResultUtils.epic_label(epic),
+        Allure::ResultUtils.feature_label(feature),
+        Allure::ResultUtils.story_label(story)
+      ]
+    end
+
+    private
+
+    # @return [AllureCucumber::Scenario]
+    attr_reader :scenario
+
+    # Get scenario tags
+    #
+    # @return [Array<String>]
+    def tags
+      @tags ||= scenario.tags
+    end
+
+    # @return [Array<Allure::Link>]
+    def tms_links
+      return [] unless AllureCucumber.configuration.link_tms_pattern
+
+      matching_links(:tms)
+    end
+
+    # @return [Array<Allure::Link>]
+    def issue_links
+      return [] unless AllureCucumber.configuration.link_issue_pattern
+
+      matching_links(:issue)
+    end
+
+    # @param [Symbol] type
+    # @return [Array<Allure::Link>]
+    def matching_links(type)
+      pattern = reserved_patterns[type]
+      tags
+        .select { |tag| tag.match?(pattern) }
+        .map { |tag| tag.match(pattern) { |match| Allure::ResultUtils.public_send("#{type}_link", match[type]) } }
+    end
+
+    # @return [Hash<Symbol, Regexp>]
+    def reserved_patterns
+      @reserved_patterns ||= {
+        tms: /@#{AllureCucumber.configuration.tms_prefix}(?<tms>\S+)/,
+        issue: /@#{AllureCucumber.configuration.issue_prefix}(?<issue>\S+)/,
+        severity: /@#{AllureCucumber.configuration.severity_prefix}(?<severity>\S+)/,
+        epic: /@#{AllureCucumber.configuration.epic_prefix}(?<epic>\S+)/,
+        feature: /@#{AllureCucumber.configuration.feature_prefix}(?<feature>\S+)/,
+        story: /@#{AllureCucumber.configuration.story_prefix}(?<story>\S+)/,
+        flaky: /@flaky/,
+        muted: /@muted/,
+        known: /@known/
+      }
+    end
+
+    # @param [String] tag
+    # @return [Boolean]
+    def reserved?(tag)
+      reserved_patterns.values.any? { |pattern| tag.match?(pattern) }
+    end
+
+    # Get specific tag value
+    #
+    # @param [Symbol] type
+    # @return [String]
+    def tag_value(type)
+      pattern = reserved_patterns[type]
+      tag = tags.detect { |t| t.match?(pattern) }
+      return unless tag
+
+      tag.match(pattern)[type]
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: allure-cucumber
 version: !ruby/object:Gem::Version
-  version: 2.13.8
+  version: 2.13.8.5
 platform: ruby
 authors:
 - Andrejs Cunskis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-17 00:00:00.000000000 Z
+date: 2021-03-14 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
+        version: 2.13.8.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.13.8
+        version: 2.13.8.5
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
@@ -55,9 +55,9 @@ files:
 - lib/allure_cucumber/config.rb
 - lib/allure_cucumber/formatter.rb
 - lib/allure_cucumber/models/cucumber_model.rb
+- lib/allure_cucumber/models/metadata_parser.rb
 - lib/allure_cucumber/models/scenario.rb
 - lib/allure_cucumber/models/step.rb
-- lib/allure_cucumber/models/tag_parser.rb
 homepage: https://github.com/allure-framework/allure-ruby
 licenses:
 - Apache-2.0
@@ -82,7 +82,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: Allure cucumber ruby adaptor

data/lib/allure_cucumber/models/tag_parser.rb

@@ -1,80 +0,0 @@
-# frozen_string_literal: true
-
-module AllureCucumber
-  # Cucumber tag parser helper methods
-  module TagParser
-    # @param [Array<String>] tags
-    # @return [Array<Allure::Label>]
-    def tag_labels(tags)
-      tags
-        .reject { |tag| reserved?(tag) }
-        .map { |tag| Allure::ResultUtils.tag_label(tag.delete_prefix("@")) }
-    end
-
-    # @param [Array<String>] tags
-    # @return [Array<Allure::Link>]
-    def tms_links(tags)
-      return [] unless AllureCucumber.configuration.link_tms_pattern
-
-      matching_links(tags, :tms)
-    end
-
-    # @param [Array<String>] tags
-    # @return [Array<Allure::Link>]
-    def issue_links(tags)
-      return [] unless AllureCucumber.configuration.link_issue_pattern
-
-      matching_links(tags, :issue)
-    end
-
-    # @param [Array<String>] tags
-    # @return [Allure::Label]
-    def severity(tags)
-      severity_pattern = reserved_patterns[:severity]
-      severity_tags = tags.detect { |tag| tag.match?(severity_pattern) }
-      severity = severity_tags&.match(severity_pattern)&.[](:severity) || "normal"
-
-      Allure::ResultUtils.severity_label(severity)
-    end
-
-    # @param [Array<String>] tags
-    # @return [Hash<Symbol, Boolean>]
-    def status_detail_tags(tags)
-      {
-        flaky: tags.any? { |tag| tag.match?(reserved_patterns[:flaky]) },
-        muted: tags.any? { |tag| tag.match?(reserved_patterns[:muted]) },
-        known: tags.any? { |tag| tag.match?(reserved_patterns[:known]) }
-      }
-    end
-
-    private
-
-    # @param [Array<String>] tags
-    # @param [Symbol] type
-    # @return [Array<Allure::Link>]
-    def matching_links(tags, type)
-      pattern = reserved_patterns[type]
-      tags
-        .select { |tag| tag.match?(pattern) }
-        .map { |tag| tag.match(pattern) { |match| Allure::ResultUtils.public_send("#{type}_link", match[type]) } }
-    end
-
-    # @return [Hash<Symbol, Regexp>]
-    def reserved_patterns
-      @reserved_patterns ||= {
-        tms: /@#{AllureCucumber.configuration.tms_prefix}(?<tms>\S+)/,
-        issue: /@#{AllureCucumber.configuration.issue_prefix}(?<issue>\S+)/,
-        severity: /@#{AllureCucumber.configuration.severity_prefix}(?<severity>\S+)/,
-        flaky: /@flaky/,
-        muted: /@muted/,
-        known: /@known/
-      }
-    end
-
-    # @param [String] tag
-    # @return [Boolean]
-    def reserved?(tag)
-      reserved_patterns.values.any? { |pattern| tag.match?(pattern) }
-    end
-  end
-end