gitlab_quality-test_tooling 3.10.0 → 3.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb72cab801798576bf43e65bf94a81619216dba9a9fed18ed7c1d6c4d48ce3c0
-  data.tar.gz: ca62855540d219536df730d30515fb8750c0d3a69b2172cb0adbd6b18156778b
+  metadata.gz: 6c49f987999c6124651b5f1f21de7d588d1940749b91f8527e21b9fcbbb1921b
+  data.tar.gz: 384d0765fb0d891e373777004ad20a5cecbc2df9b07cc74ca1b70ae30a080641
 SHA512:
-  metadata.gz: cec0bada00ce33d15f5235aa127551e52c72e68d10387e48ade63eca749bf1493670f816b8291ccaad5cab5bb048baba52de1e3c02cc75e8a3ec463ea4709feb
-  data.tar.gz: ffb50bdeffb1206cd5a9dcac1246ef8fe384004424b2d190797ef8bb58c319f4e569e7e8519e95469e1d52ed500af672f7a4818846854bab09aeaf982c7a334b
+  metadata.gz: 4ff2cc394058616512c5c00779772d244d08986e12762a49c17ca9e31065a4af6b79beaeb8ceb7ac35c290efb10410c5888aff363b183d4190bb9b863278a418
+  data.tar.gz: 8cc8717e64a9c260ca10474897aae319bae9565a1257815e3a83e931049d8d0c61c32fb38d9b66f13976f0f0e1ec4e7d3666f5c3311c5e64cae0c25940ff5da6

data/AGENTS.md

@@ -0,0 +1,95 @@
+# gitlab_quality-test_tooling
+
+Ruby gem providing test tooling for GitLab CI — metrics export, test quarantine, failure reporting, flaky test tracking, and code coverage analysis.
+
+## Tech Stack
+
+- Ruby (see `.ruby-version` and gemspec for version), gem published to RubyGems
+- RSpec for testing, RuboCop (`gitlab-styles` base) for linting
+- Lefthook for pre-push hooks (rspec, rubocop, changelog trailer check)
+
+## Testing
+
+```bash
+bundle exec rspec
+bundle exec rubocop
+```
+
+## Commit Conventions
+
+Every branch must have a `Changelog:` git trailer on its **first commit** (relative to `origin/main`).
+
+Valid values: `added`, `fixed`, `changed`, `deprecated`, `removed`, `security`, `performance`, `other`
+
+Example:
+
+```
+Fix failure_exception for MultipleExceptionError
+
+Description of the change.
+
+Changelog: fixed
+```
+
+### Enforcement
+
+- **lefthook pre-push hook** checks the first commit on the branch
+- **gitlab-dangerfiles** checks in CI (Danger bot comments on MRs)
+- `--no-verify` bypasses lefthook locally, but CI will still fail without the trailer
+
+### Choosing the right value
+
+| Value | When to use |
+|-------|-------------|
+| `added` | New feature or capability |
+| `fixed` | Bug fix |
+| `changed` | Non-breaking change to existing behavior |
+| `deprecated` | Feature marked for removal |
+| `removed` | Feature removed |
+| `security` | Security fix |
+| `performance` | Performance improvement |
+| `other` | Refactoring, docs, CI changes |
+
+Reference: https://docs.gitlab.com/ee/development/changelog.html
+
+### Commit Message Format
+
+- Present tense ("Fix bug" not "Fixed bug")
+- First line under 72 characters
+- Blank line between subject and body
+- `Changelog:` trailer at the end of the first commit's message, after a blank line
+
+## Project Structure
+
+| Directory | Purpose |
+|-----------|---------|
+| `lib/gitlab_quality/test_tooling/` | Main gem code |
+| `exe/` | CLI executables |
+| `spec/` | RSpec tests |
+| `.gitlab/changelog_config.yml` | Changelog category mapping |
+
+## Key Modules
+
+- **TestMetricsExporter** — Serializes RSpec results to ClickHouse (exception classes, failure messages, CI metadata)
+- **Report** — Creates/updates GitLab issues for test failures, flaky tests, slow tests
+- **TestQuarantine** — RSpec formatter that skips quarantined tests
+- **CodeCoverage** — Coverage analysis and responsibility patterns
+- **ClickHouse::Client** — Batch HTTP client for pushing metrics
+
+## Release Process
+
+The [automated gem release process](https://gitlab.com/gitlab-org/quality/pipeline-common#release-process) publishes new versions via CI. It will:
+
+- Publish the gem to https://rubygems.org/gems/gitlab_quality-test_tooling
+- Create a release at https://gitlab.com/gitlab-org/ruby/gems/gitlab_quality-test_tooling/-/releases
+- Populate release notes from changelog entries
+
+### Steps to release
+
+1. Create a branch (e.g., `bump-version-X-Y-Z`)
+2. Update `lib/gitlab_quality/test_tooling/version.rb` with the new version
+3. Run `bundle install` to update `Gemfile.lock`
+4. Commit with message like `Update gem version to X.Y.Z` and trailer `Changelog: changed`
+5. Create an MR using the **Release** MR template (`.gitlab/merge_request_templates/Release.md`)
+6. Fill in the template: update the diff link, check release notes, verify SemVer
+7. Get the MR merged by a maintainer — CI will publish the gem automatically

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gitlab_quality-test_tooling (3.10.0)
+    gitlab_quality-test_tooling (3.10.1)
       activesupport (>= 7.0)
       amatch (~> 0.4.1)
       fog-google (~> 1.24, >= 1.24.1)

data/lib/gitlab_quality/test_tooling/test_metrics_exporter/test_metrics.rb

@@ -161,14 +161,23 @@ module GitlabQuality
           exception.all_exceptions.flatten
         end
 
-        # Truncated exception stacktrace
+        # Truncated exception message
+        #
+        # For MultipleExceptionError, returns the first wrapped exception's message
+        # instead of the unhelpful wrapper class name.
         #
         # @return [String]
         def failure_exception
           exception = example.execution_result.exception
           return unless exception
 
-          exception.to_s.tr("\n", " ").slice(0, 1000)
+          source = if exception.respond_to?(:all_exceptions)
+                     exception.all_exceptions.flatten.first || exception
+                   else
+                     exception
+                   end
+
+          source.to_s.tr("\n", " ").slice(0, 1000)
         end
 
         # Test run type | suite name

data/lib/gitlab_quality/test_tooling/version.rb

@@ -2,6 +2,6 @@
 
 module GitlabQuality
   module TestTooling
-    VERSION = "3.10.0"
+    VERSION = "3.10.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab_quality-test_tooling
 version: !ruby/object:Gem::Version
-  version: 3.10.0
+  version: 3.10.1
 platform: ruby
 authors:
 - GitLab Quality
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-05 00:00:00.000000000 Z
+date: 2026-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: climate_control
@@ -438,6 +438,7 @@ files:
 - ".rubocop_todo.yml"
 - ".ruby-version"
 - ".tool-versions"
+- AGENTS.md
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - Dangerfile