additional_tags 1.0.6 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05656ef90d3c7c796b1bd3d510f6a349fc77c8b1adbf43ca6135af8e48ca705e
-  data.tar.gz: a22552cd9d096d6963dd9349c207da4755b1e3ba1d8dec560d404b3207ee1458
+  metadata.gz: d187e05dfc7655030d62f26afc35392085f43cbac4bb4b4d654da66c643cd58f
+  data.tar.gz: 88901a08b7c4b38df8b65fd20282f5e4aae393866e5accf7c3a096d7c82f4788
 SHA512:
-  metadata.gz: 2eb18bdccf79be5d1f1b4327c11c3c838e434c8737edcfa096d62d61925170e53be4a6ae45fb486e0c5b3a008933dc30e3bd2c36de9db929fe1fb1e71225adf2
-  data.tar.gz: 97fd974a51bcdf337c0246cd95c0313639d43aa73f19ac9a81f0f9efa87da0e3c02736970b5c8148566ded5bb3e670a2fb332a03f99d85f59caed219d12410be
+  metadata.gz: 34e99763fad968c1f2498dc73b662fb756c4b436e0a4521acd731674c3bebdf8bee52cc55e995457908d39816b61a230fd29d4ac1f3a1662a3e12bb886e6d60e
+  data.tar.gz: 4aeb8f7bcbaad55d596dd6f816cedbde29f1c707748ff9ce275f7f131959df258c10e2683ce279cf4c26f8a459d53992ae6e4202d9ff9963a637d88b85661c98

data/.github/workflows/codeql-analysis.yml

@@ -13,10 +13,10 @@ name: "CodeQL"
 
 on:
   push:
-    branches: [ master ]
+    branches: [ main ]
   pull_request:
     # The branches below must be a subset of the branches above
-    branches: [ master ]
+    branches: [ main ]
   schedule:
     - cron: '35 20 * * 2'
 
@@ -38,11 +38,11 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v2
+      uses: actions/checkout@v3
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v1
+      uses: github/codeql-action/init@v2
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -53,7 +53,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@v1
+      uses: github/codeql-action/autobuild@v2
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -67,4 +67,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v1
+      uses: github/codeql-action/analyze@v2

data/.github/workflows/linters.yml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
 
     - name: Install package dependencies
       run: >
@@ -23,9 +23,8 @@ jobs:
       uses: ruby/setup-ruby@v1
       with:
         ruby-version: 3.1
-        bundler-cache: true
 
-    - name: Setup gems
+    - name: Run bundle install
       run: |
         bundle install --jobs 4 --retry 3
 
@@ -41,3 +40,16 @@ jobs:
     - name: Run Brakeman
       run: |
         bundle exec brakeman -5
+
+    - name: Setup node
+      uses: actions/setup-node@v2
+      with:
+        node-version: '16'
+
+    - run: yarn install
+
+    - name: Run Stylelint
+      run: node_modules/.bin/stylelint assets/stylesheets/
+
+    - name: Run ESLint
+      run: node_modules/.bin/eslint assets/javascripts/

data/.github/workflows/tests.yml

@@ -10,9 +10,12 @@ jobs:
 
     strategy:
       matrix:
-        ruby: ['2.7', '3.0', '3.1']
+        ruby: ['2.7', '3.0', '3.1', '3.2']
         redmine: ['5.0-stable', 'master']
         db: ['postgres', 'mysql']
+        exclude:
+          - ruby: '3.2'
+            redmine: 5.0-stable
       fail-fast: false
 
     services:
@@ -51,20 +54,20 @@ jobs:
         if: matrix.db == 'mysql'
 
       - name: Checkout Redmine
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           repository: redmine/redmine
           ref: ${{ matrix.redmine }}
           path: redmine
 
       - name: Checkout additionals
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           repository: AlphaNodes/additionals
           path: redmine/plugins/additionals
 
       - name: Checkout additional_tags
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           path: redmine/plugins/additional_tags
 

data/.gitignore

@@ -8,4 +8,6 @@ Gemfile.lock
 .enable_*
 ._*
 *.gem
+/node_modules
+/yarn.lock
 rails_best_practices_output.html

data/.rubocop.yml

@@ -131,3 +131,8 @@ Layout/LineContinuationLeadingSpace:
 # redmine does not use load_defaults: https://rails.rubystyle.guide/#config-defaults
 Rails/RedundantPresenceValidationOnBelongsTo:
   Enabled: false
+
+# see https://github.com/rubocop/rubocop-rails/issues/825
+# should be removed and corrected in code, if this bug is fixed
+Rails/ActionControllerFlashBeforeRender:
+  Enabled: false

data/.stylelintrc.json

@@ -1,163 +1,20 @@
 {
+  "extends": "stylelint-config-standard",
   "rules": {
-    "at-rule-no-unknown": true,
-    "block-no-empty": true,
-    "color-no-invalid-hex": true,
-    "comment-no-empty": true,
-    "declaration-block-no-duplicate-properties": [
+    "string-quotes": "single",
+    "selector-class-pattern": "^([a-z][a-z0-9]*)(-[a-z0-9]+)*$|block_column",
+    "font-family-no-missing-generic-family-keyword": [
       true,
       {
-        "ignore": [
-          "consecutive-duplicates-with-different-values"
+        "ignoreFontFamilies": [
+          "Font Awesome 5 Free",
+          "Font Awesome 5 Brands",
+          "Apple Color Emoji",
+          "Segoe UI Emoji",
+          "Segoe UI Symbol",
+          "Noto Color Emoji"
         ]
       }
-    ],
-    "declaration-block-no-redundant-longhand-properties": true,
-    "declaration-block-no-shorthand-property-overrides": true,
-    "font-family-no-duplicate-names": true,
-    "font-family-no-missing-generic-family-keyword": true,
-    "function-calc-no-unspaced-operator": true,
-    "function-linear-gradient-no-nonstandard-direction": true,
-    "keyframe-declaration-no-important": true,
-    "media-feature-name-no-unknown": true,
-    "no-descending-specificity": true,
-    "no-duplicate-at-import-rules": true,
-    "no-duplicate-selectors": true,
-    "no-empty-source": true,
-    "no-extra-semicolons": true,
-    "no-invalid-double-slash-comments": true,
-    "property-no-unknown": true,
-    "selector-pseudo-class-no-unknown": true,
-    "selector-pseudo-element-no-unknown": true,
-    "selector-type-no-unknown": true,
-    "string-no-newline": true,
-    "unit-no-unknown": true,
-    "at-rule-empty-line-before": [
-      "always",
-      {
-        "except": [
-          "blockless-after-same-name-blockless",
-          "first-nested"
-        ],
-        "ignore": [
-          "after-comment"
-        ]
-      }
-    ],
-    "at-rule-name-case": "lower",
-    "at-rule-name-space-after": "always-single-line",
-    "at-rule-semicolon-newline-after": "always",
-    "block-closing-brace-empty-line-before": "never",
-    "block-closing-brace-newline-after": "always",
-    "block-closing-brace-newline-before": "always-multi-line",
-    "block-closing-brace-space-before": "always-single-line",
-    "block-opening-brace-newline-after": "always-multi-line",
-    "block-opening-brace-space-after": "always-single-line",
-    "block-opening-brace-space-before": "always",
-    "color-hex-case": "lower",
-    "color-hex-length": "short",
-    "comment-empty-line-before": [
-      "always",
-      {
-        "except": [
-          "first-nested"
-        ],
-        "ignore": [
-          "stylelint-commands"
-        ]
-      }
-    ],
-    "comment-whitespace-inside": "always",
-    "custom-property-empty-line-before": [
-      "always",
-      {
-        "except": [
-          "after-custom-property",
-          "first-nested"
-        ],
-        "ignore": [
-          "after-comment",
-          "inside-single-line-block"
-        ]
-      }
-    ],
-    "declaration-bang-space-after": "never",
-    "declaration-bang-space-before": "always",
-    "declaration-block-semicolon-newline-after": "always-multi-line",
-    "declaration-block-semicolon-space-after": "always-single-line",
-    "declaration-block-semicolon-space-before": "never",
-    "declaration-block-single-line-max-declarations": 1,
-    "declaration-block-trailing-semicolon": "always",
-    "declaration-colon-newline-after": "always-multi-line",
-    "declaration-colon-space-after": "always-single-line",
-    "declaration-colon-space-before": "never",
-    "declaration-empty-line-before": [
-      "always",
-      {
-        "except": [
-          "after-declaration",
-          "first-nested"
-        ],
-        "ignore": [
-          "after-comment",
-          "inside-single-line-block"
-        ]
-      }
-    ],
-    "function-comma-newline-after": "always-multi-line",
-    "function-comma-space-after": "always-single-line",
-    "function-comma-space-before": "never",
-    "function-max-empty-lines": 0,
-    "function-name-case": "lower",
-    "function-parentheses-newline-inside": "always-multi-line",
-    "function-parentheses-space-inside": "never-single-line",
-    "function-whitespace-after": "always",
-    "indentation": 2,
-    "length-zero-no-unit": true,
-    "max-empty-lines": 1,
-    "media-feature-colon-space-after": "always",
-    "media-feature-colon-space-before": "never",
-    "media-feature-name-case": "lower",
-    "media-feature-parentheses-space-inside": "never",
-    "media-feature-range-operator-space-after": "always",
-    "media-feature-range-operator-space-before": "always",
-    "media-query-list-comma-newline-after": "always-multi-line",
-    "media-query-list-comma-space-after": "always-single-line",
-    "media-query-list-comma-space-before": "never",
-    "no-eol-whitespace": true,
-    "no-missing-end-of-source-newline": true,
-    "number-leading-zero": "always",
-    "number-no-trailing-zeros": true,
-    "property-case": "lower",
-    "rule-empty-line-before": [
-      "always-multi-line",
-      {
-        "except": [
-          "first-nested"
-        ],
-        "ignore": [
-          "after-comment"
-        ]
-      }
-    ],
-    "selector-attribute-brackets-space-inside": "never",
-    "selector-attribute-operator-space-after": "never",
-    "selector-attribute-operator-space-before": "never",
-    "selector-combinator-space-after": "always",
-    "selector-combinator-space-before": "always",
-    "selector-descendant-combinator-no-non-space": true,
-    "selector-list-comma-newline-after": "always",
-    "selector-list-comma-space-before": "never",
-    "selector-max-empty-lines": 0,
-    "selector-pseudo-class-case": "lower",
-    "selector-pseudo-class-parentheses-space-inside": "never",
-    "selector-pseudo-element-case": "lower",
-    "selector-pseudo-element-colon-notation": "double",
-    "selector-type-case": "lower",
-    "unit-case": "lower",
-    "value-list-comma-newline-after": "always-multi-line",
-    "value-list-comma-space-after": "always-single-line",
-    "value-list-comma-space-before": "never",
-    "value-list-max-empty-lines": 0
+    ]
   }
 }

data/README.md

@@ -4,16 +4,35 @@
 
 ## Features
 
-- Tags for issues
-- Tags for wiki pages
+- Tags for issues. To use them you need to:
+  -  *Activate issue tags* in the plugin configuration
+  -  and update your role permissions in the Redmine administration *Roles & permissions / Issue tracking*.
+- Tags for wiki pages. To use them  you need to:
+  - *Activate wiki tags* in the plugin configuration 
+  -  and update your role permissions in the Redmine administration *Roles & permissions / Wiki*
+- Available role permissions for issue tags (section *Issue tracking*): 
+  - Add issue tags
+  - Edit issue tags
+  - Display issue tags
+- Available role permissions wiki tags (section *Wiki*):
+  - Add wiki tags
+- Managing tags centrally in the plugin settings (edit, delete, merge)- 
+- Grouped tags.
+  - Grouping of tags possible, when using a colon in tag (all tags with same base name get the same color). Typo example: ``Plugin:HRM``
+- Scoped tags:
+  - Grouping of tags via *Scoped tags* possible, when using two colons in tag. Typo example: ``Product::Sprint 1``
+  - Only one tag of the same base name is allowed for an entity
+  - Base name and tag value are displayed seperatly
 - Accented and non-latin characters supported for tag order
-- View, edit and create tag permissions for issues
-- Create permission for wiki tags
-- Managing tags
-- Custom tags and tagging tables (additional_tags and additional_taggings). If a other plugin
-  used tags or tagging tables for issue or wiki tagging, there tags will be migrated automatically
+- Color theme selection possible
+- Custom tags and tagging tables (additional_tags and additional_taggings). If another plugin
+  used tags or tagging tables for issue or wiki tagging, tags will be migrated automatically there
 - Based on the very popular [acts-as-taggable-on](https://github.com/mbleigh/acts-as-taggable-on)
 
+![screenshot](https://raw.githubusercontent.com/AlphaNodes/additional_tags/master/doc/images/tag-overview.png)
+
+The screenshot shows: regular tags, grouped tags and scoped tags. The colors are assigned randomly. But you can change the color by choosing a *Color theme* in the plugin settings.
+
 ![screenshot](https://raw.githubusercontent.com/AlphaNodes/additional_tags/master/doc/images/additional-tags.gif)
 
 Other plugins use additional_tags as framework in order to support tags for their entities.

data/app/controllers/additional_tags_controller.rb

@@ -33,15 +33,6 @@ class AdditionalTagsController < ApplicationController
 
   def edit; end
 
-  def destroy
-    @tags.each do |tag|
-      tag.reload.destroy!
-    rescue ::ActiveRecord::RecordNotFound, ::ActiveRecord::RecordNotDestroyed
-      Rails.logger.warn "Tag #{tag} could not be deleted"
-    end
-    redirect_back_or_default @tag_list_path
-  end
-
   def update
     @tag.name = params[:tag][:name] if params[:tag]
     if @tag.save
@@ -59,6 +50,15 @@ class AdditionalTagsController < ApplicationController
     end
   end
 
+  def destroy
+    @tags.each do |tag|
+      tag.reload.destroy!
+    rescue ::ActiveRecord::RecordNotFound, ::ActiveRecord::RecordNotDestroyed
+      Rails.logger.warn "Tag #{tag} could not be deleted"
+    end
+    redirect_back_or_default @tag_list_path
+  end
+
   def context_menu
     @tag = @tags.first if @tags.size == 1
     @back = back_url

data/app/controllers/issue_tags_controller.rb

@@ -19,6 +19,7 @@ class IssueTagsController < ApplicationController
 
     @issue_tags.sort!
     @most_used_tags = Issue.available_tags.most_used 10
+    @append = params[:append] == 'true'
   end
 
   def update
@@ -33,7 +34,8 @@ class IssueTagsController < ApplicationController
 
       Issue.transaction do
         @issues.each do |issue|
-          issue.tag_list = tags
+          # add tags added in placeholder for a single/multiple issue or overwrite tags for single issue
+          params[:append] == 'true' ? issue.tag_list << tags : issue.tag_list = tags
           issue.save!
         end
       end

data/app/helpers/additional_tags_helper.rb

@@ -66,7 +66,11 @@ module AdditionalTagsHelper
   def render_tags_list(tags, **options)
     return if tags.blank?
 
-    style = options.delete :style
+    options[:show_count] = AdditionalTags.setting? :show_with_count unless options.key? :show_count
+    options[:color_theme] = AdditionalTags.setting :tags_color_theme unless options.key? :color_theme
+    options[:use_colors] = AdditionalTags.use_colors? unless options.key? :use_colors
+
+    style = options.key?(:style) ? options.delete(:style) : AdditionalTags.setting(:tags_sidebar).to_sym
     tags = tags.all.to_a if tags.respond_to? :all
     tags = sort_tags_for_list tags
 
@@ -94,22 +98,36 @@ module AdditionalTagsHelper
     content_tag(list_el, content, class: 'tags-cloud', style: (style == :simple_cloud ? 'text-align: left;' : ''))
   end
 
-  def additional_tag_link(tag_object, link: nil, link_wiki_tag: false, show_count: false, use_colors: nil, name: nil, **options)
-    tag_name = []
-    tag_name << if name.nil?
-                  tag_object.name
-                else
-                  name
-                end
-
+  def additional_tag_link(tag_object,
+                          link: nil,
+                          link_wiki_tag: false,
+                          show_count: false,
+                          use_colors: nil,
+                          name: nil,
+                          color_theme: nil,
+                          **options)
     options[:project] = @project if options[:project].blank? && @project.present?
-    use_colors = AdditionalTags.setting? :use_colors if use_colors.nil?
+    if !options.key?(:display_type) && @query && @query.display_type != @query.default_display_type
+      options[:display_type] = @query.display_type
+    end
+
+    use_colors = AdditionalTags.use_colors? if use_colors.nil?
+    color_theme = AdditionalTags.setting :tags_color_theme if color_theme.nil?
+
+    tag_info = AdditionalTag.new name: name.nil? ? tag_object.name : name,
+                                 disable_grouping: !use_colors,
+                                 color_theme: color_theme
+    tag_name = [tag_info.tag_name]
+
+    tag_style = "background-color: #{tag_info.tag_bg_color}; color: #{tag_info.tag_fg_color}" if use_colors
 
-    tag_style = if use_colors
-                  tag_bg_color = additional_tag_color tag_object.name
-                  tag_fg_color = additional_tag_fg_color tag_bg_color
-                  "background-color: #{tag_bg_color}; color: #{tag_fg_color}"
-                end
+    if tag_info.scoped?
+      tag_name << if show_count
+                    tag.span tag_info.group_value, class: 'tag-group-value'
+                  else
+                    tag.span tag_info.group_value, class: 'tag-group-value tag-group-nocount'
+                  end
+    end
 
     tag_name << tag.span(tag_object.count, class: 'tag-count') if show_count
 
@@ -139,20 +157,6 @@ module AdditionalTagsHelper
     tag.span content, **style
   end
 
-  def additional_tag_color(tag_name)
-    "##{Digest::SHA256.hexdigest(tag_name)[0..5]}"
-  end
-
-  def additional_tag_fg_color(bg_color)
-    # calculate contrast text color according to YIQ method
-    # https://24ways.org/2010/calculating-color-contrast/
-    # https://stackoverflow.com/questions/3942878/how-to-decide-font-color-in-white-or-black-depending-on-background-color
-    r = bg_color[1..2].hex
-    g = bg_color[3..4].hex
-    b = bg_color[5..6].hex
-    (r * 299 + g * 587 + b * 114) >= 128_000 ? 'black' : 'white'
-  end
-
   # plain list of tags
   def additional_plain_tag_list(tags, sep: nil)
     sep ||= "#{Query.additional_csv_separator} "
@@ -177,6 +181,10 @@ module AdditionalTagsHelper
     unsorted = options.delete :unsorted
     tag_list = AdditionalTags::Tags.sort_tag_list tag_list unless unsorted
 
+    # set defaults if not defined
+    options[:use_colors] = AdditionalTags.use_colors? unless options.key? :use_colors
+    options[:color_theme] = AdditionalTags.setting :tags_color_theme unless options.key? :color_theme
+
     safe_join tag_list.map { |tag| additional_tag_link tag, **options },
               additional_tag_sep(use_colors: options[:use_colors])
   end
@@ -208,7 +216,7 @@ module AdditionalTagsHelper
 
   private
 
-  def tag_url(tag_name, filter: nil, tag_action: nil, tag_controller: nil, project: nil)
+  def tag_url(tag_name, filter: nil, tag_action: nil, tag_controller: nil, project: nil, display_type: nil)
     action = tag_action.presence || (controller_name == 'hrm_user_resources' ? 'show' : 'index')
 
     fields = [:tags]
@@ -225,6 +233,7 @@ module AdditionalTagsHelper
     { controller: tag_controller.presence || controller_name,
       action: action,
       set_filter: 1,
+      display_type: display_type,
       project_id: project,
       f: fields,
       v: values,

data/app/helpers/additional_tags_issues_helper.rb

@@ -44,9 +44,7 @@ module AdditionalTagsIssuesHelper
   end
 
   def render_sidebar_tags
-    options = { show_count: AdditionalTags.setting?(:show_with_count),
-                filter: AdditionalTags.setting?(:open_issues_only) ? { field: :status_id, operator: 'o' } : nil,
-                style: AdditionalTags.setting(:tags_sidebar).to_sym,
+    options = { filter: AdditionalTags.setting?(:open_issues_only) ? { field: :status_id, operator: 'o' } : nil,
                 project: @project }
 
     options[:tag_action] = 'show' if %w[gantts calendars].include? controller_name

data/app/helpers/additional_tags_wiki_helper.rb

@@ -10,9 +10,7 @@ module AdditionalTagsWikiHelper
   end
 
   def render_sidebar_tags
-    options = { show_count: AdditionalTags.setting?(:show_with_count),
-                style: AdditionalTags.setting(:tags_sidebar).to_sym,
-                link_wiki_tag: true,
+    options = { link_wiki_tag: true,
                 project: @project }
 
     render_tags_list sidebar_tags, **options
@@ -20,12 +18,15 @@ module AdditionalTagsWikiHelper
 
   def render_wiki_index_title(project: nil, name: nil, tag: nil, title: :label_wiki)
     if tag.present?
+      tag_object = ActsAsTaggableOn::Tag.new name: tag
+
       if project
-        t :label_wiki_index_for_tag_html, tag: tag
+        safe_join [l(:label_wiki_index_for_tag), additional_tag_link(tag_object, link: '#')], ' '
       else
         title = [link_to(l(title), wiki_index_path)]
         title << Additionals::LIST_SEPARATOR
-        title << t(:label_wiki_index_for_tag_html, tag: tag)
+        title << l(:label_wiki_index_for_tag)
+        title << additional_tag_link(tag_object, link: '#')
         safe_join title, ' '
       end
     elsif name.present?

data/app/models/additional_tag.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+class AdditionalTag
+  GROUP_SEP = ':'
+  SCOPE_SEP = '::'
+
+  class << self
+    def valid_mutually_exclusive_tag(tag_list)
+      return true if tag_list.blank?
+
+      tags = tag_list.select { |t| t.include? SCOPE_SEP }
+      return true if tags.blank?
+
+      groups = tags.map { |t| new(name: t).group_name }
+      groups == groups.uniq
+    end
+  end
+
+  # NOTE: only use bg_color parameter, if background color should not
+  #       calculated by AdditionalTag - if you want to assign manual color
+  def initialize(name:, disable_grouping: false, color_theme: nil, bg_color: nil)
+    @tag_name = name.to_s
+    @disable_grouping = disable_grouping
+    @color_theme = color_theme.to_s
+    @bg_color = bg_color
+  end
+
+  def name_for_color
+    # different colors for non-grouped, grouped and scoped tag
+    name = if scoped? || grouped?
+             "#{group_name}#{sep}"
+           else
+             tag_name
+           end
+
+    if @color_theme.present? && @color_theme != '0' && @color_theme != '1'
+      "#{name}#{@color_theme}"
+    else
+      name
+    end
+  end
+
+  def tag_bg_color
+    @tag_bg_color ||= @bg_color || "##{Digest::SHA256.hexdigest(name_for_color)[0..5]}"
+  end
+
+  # calculate contrast text color according to YIQ method
+  # https://24ways.org/2010/calculating-color-contrast/
+  # https://stackoverflow.com/questions/3942878/how-to-decide-font-color-in-white-or-black-depending-on-background-color
+  def tag_fg_color
+    @tag_fg_color ||= begin
+      r = tag_bg_color[1..2].hex
+      g = tag_bg_color[3..4].hex
+      b = tag_bg_color[5..6].hex
+      (r * 299 + g * 587 + b * 114) >= 128_000 ? 'black' : 'white'
+    end
+  end
+
+  def sep
+    scoped? ? SCOPE_SEP : GROUP_SEP
+  end
+
+  def tag_name
+    scoped? ? group_name : @tag_name
+  end
+
+  def labels
+    @labels ||= scoped? ? scope_labels : group_labels
+  end
+
+  def scope_labels
+    @scope_labels ||= @tag_name.split(SCOPE_SEP).map(&:strip)
+  end
+
+  def group_labels
+    @group_labels ||= @tag_name.split(GROUP_SEP).map(&:strip)
+  end
+
+  def group_name
+    if labels.length > 2
+      labels[0...-1].join sep
+    else
+      labels.first
+    end
+  end
+
+  def group_value
+    labels.last
+  end
+
+  def scoped?
+    !@disable_grouping && scope_labels.length > 1
+  end
+
+  def grouped?
+    !@disable_grouping && group_labels.length > 1
+  end
+end