TRCLI Release v1.13.3

.github/workflows/pr-validation.yml

@@ -89,6 +89,7 @@ jobs:
 
       - name: Check PR Description Completeness
         id: check_description
+        if: steps.check_release.outputs.is_release == 'false'
         run: |
           PR_BODY="${{ github.event.pull_request.body }}"
 
@@ -124,23 +125,37 @@ jobs:
             const hasSolution = '${{ steps.check_description.outputs.has_solution }}' === 'true';
             const hasTestSteps = '${{ steps.check_description.outputs.has_test_steps }}' === 'true';
 
+            const skippedStatus = '➖ Skipped (Release Branch)';
+
             const issueStatus = isRelease
-              ? '➖ Skipped (Release Branch)'
+              ? skippedStatus
               : issueFound
               ? `✅ Found: ${issueKey} (${issueType})`
               : '⚠️ Missing';
 
+            const issueSectionStatus = isRelease
+              ? skippedStatus
+              : hasIssue ? '✅ Present' : '⚠️ Missing';
+
+            const solutionStatus = isRelease
+              ? skippedStatus
+              : hasSolution ? '✅ Present' : '⚠️ Missing';
+
+            const testStepsStatus = isRelease
+              ? skippedStatus
+              : hasTestSteps ? '✅ Present' : '⚠️ Missing';
+
             const summary = `## 📋 PR Validation Summary
 
             | Check | Status |
             |-------|--------|
             | Issue Reference | ${issueStatus} |
-            | Issue Section | ${hasIssue ? '✅ Present' : '⚠️ Missing'} |
-            | Solution Description | ${hasSolution ? '✅ Present' : '⚠️ Missing'} |
-            | Test Steps | ${hasTestSteps ? '✅ Present' : '⚠️ Missing'} |
+            | Issue Section | ${issueSectionStatus} |
+            | Solution Description | ${solutionStatus} |
+            | Test Steps | ${testStepsStatus} |
 
             ${isRelease
-              ? '➖ Release branch - issue reference check skipped.'
+              ? '➖ Release branch - all validation checks skipped.'
               : (issueFound && hasSolution && hasTestSteps
                 ? '✅ All checks passed!'
                 : '⚠️ Some optional sections are missing.')}

.gitignore

@@ -6,3 +6,4 @@ build
 .pytest_cache
 .coverage
 TEMP_*
+.trcli/

CHANGELOG.MD

@@ -6,16 +6,27 @@ This project adheres to [Semantic Versioning](https://semver.org/). Version numb
 - **MINOR**: New features that are backward-compatible.
 - **PATCH**: Bug fixes or minor changes that do not affect backward compatibility.
 
+## [1.13.3]
+
+_released 03-05-2026
+
+### Added
+ - Added version notification system and a new `update` command to simplify upgrading to the latest version.
+ - Added comprehensive blob support to handle multiple test result files, improving automation workflows.
+
+### Improved
+ - Improved attachment handling and validation for custom fields.
+
 ## [1.13.2]
 
-_released 02-24-2025
+_released 02-24-2026
 
 ### Fixed
  - Fixed an issue where automation_id matching fails due to wrapped values in HTML paragraph tags, causing case mismatch and duplicate test cases
 
 ## [1.13.1]
 
-_released 02-19-2025
+_released 02-19-2026
 
 ### Added
  - Added support for multiple case ids in a single test execution.
@@ -25,7 +36,7 @@ _released 02-19-2025
 
 ## [1.13.0]
 
-_released 02-06-2025
+_released 02-06-2026
 
 ### Added
  - **New Command: `parse_cucumber`** - Parse Cucumber JSON reports and upload to TestRail

README.md

@@ -33,7 +33,7 @@ trcli
 ```
 You should get something like this:
 ```
-TestRail CLI v1.13.2
+TestRail CLI v1.13.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Supported and loaded modules:
     - parse_junit: JUnit XML Files (& Similar)
@@ -51,7 +51,7 @@ CLI general reference
 --------
 ```shell
 $ trcli --help
-TestRail CLI v1.13.2
+TestRail CLI v1.13.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Usage: trcli [OPTIONS] COMMAND [ARGS]...
 
@@ -97,6 +97,7 @@ Commands:
   parse_openapi  Parse OpenAPI spec and create cases in TestRail
   parse_robot    Parse Robot Framework report and upload results to TestRail
   references     Manage references in TestRail
+  update         Update TRCLI to the latest version from PyPI.
 ```
 
 Uploading automated test results
@@ -190,9 +191,122 @@ Options:
 | `<testsuite>`      | section         |
 | `<testcase>`       | case            |
 
-For further detail, please refer to the 
+For further detail, please refer to the
 [JUnit to TestRail mapping](https://support.gurock.com/hc/en-us/articles/12989737200276) documentation.
 
+### Using Glob Patterns for Multiple Files
+
+TRCLI supports glob patterns to process multiple report files in a single command. This feature is available for **JUnit XML** and **Cucumber JSON** parsers.
+
+#### Important: Shell Quoting Requirement
+
+**Glob patterns must be quoted** to prevent shell from expanding them prematurely. Without quotes, the shell will expand the pattern before passing it to TRCLI, causing unexpected errors.
+
+```bash
+# CORRECT - Pattern quoted (TRCLI handles the expansion)
+trcli parse_junit -f "reports/*.xml" --title "Test Results"
+```
+
+#### Supported Glob Patterns
+
+**Standard wildcards:**
+```bash
+# Match all XML files in directory
+-f "reports/*.xml"
+
+# Match files with specific prefix
+-f "target/surefire-reports/TEST-*.xml"
+
+# Match files with specific suffix
+-f "build/test-results/*-report.xml"
+```
+
+**Recursive search** (matches subdirectories):
+```bash
+# Search all subdirectories recursively
+-f "test-results/**/*.xml"
+
+# Match specific pattern in any subdirectory
+-f "**/robot-output-*.xml"
+```
+
+#### How File Merging Works
+
+When a glob pattern matches **multiple files**, TRCLI automatically:
+
+1. **Expands the pattern** to find all matching files
+2. **Parses each file** individually
+3. **Merges test results** into a single combined report
+4. **Writes merged file** to current directory:
+   - JUnit: `Merged-JUnit-report.xml`
+   - Cucumber: `merged_cucumber.json`
+5. **Processes the merged file** as a single test run upload
+
+When a pattern matches **only one file**, TRCLI processes it directly without merging.
+
+#### Examples
+
+**JUnit XML - Multiple test suites:**
+```bash
+# Merge all JUnit XML files from Maven surefire reports
+trcli -y \
+  -h https://example.testrail.com \
+  --project "My Project" \
+  parse_junit \
+  -f "target/surefire-reports/junitreports/*.xml" \
+  --title "Merged Test Results"
+
+# Merge test results from multiple modules
+trcli parse_junit \
+  -f "build/test-results/**/*.xml" \
+  --title "All Module Tests" \
+  --case-matcher auto
+```
+
+**Cucumber JSON - Multiple test runs:**
+```bash
+# Merge multiple Cucumber JSON reports
+trcli -y \
+  -h https://example.testrail.com \
+  --project "My Project" \
+  parse_cucumber \
+  -f "reports/cucumber-*.json" \
+  --title "Merged Cucumber Tests"
+
+# Recursive search for all Cucumber JSON results
+trcli parse_cucumber \
+  -f "test-results/**/cucumber.json" \
+  --title "All Cucumber Results" \
+  --case-matcher auto
+```
+
+#### Troubleshooting
+
+**Error: "Got unexpected extra argument"**
+- **Cause:** Glob pattern not quoted - shell expanded it before TRCLI
+- **Solution:** Add quotes around the pattern: `-f "reports/*.xml"`
+
+**Error: "File not found"**
+- **Cause:** No files match the glob pattern
+- **Solution:** Verify the pattern and file paths:
+  ```bash
+  # Check what files match your pattern
+  ls reports/*.xml
+
+  # Use absolute path if relative path doesn't work
+  trcli parse_junit -f "/full/path/to/reports/*.xml"
+  ```
+
+**Pattern matches nothing in subdirectories:**
+- **Cause:** Need recursive glob (`**`)
+- **Solution:** Use `**` for recursive matching: `-f "reports/**/*.xml"`
+
+#### Limitations
+
+1. Glob patterns are expanded by Python's `glob` module (not shell), so some advanced bash features may not work
+2. Very large numbers of files (100+) may cause performance issues during merging
+3. Merged files are created in the current working directory
+
 ### Uploading test results
 To submit test case results, the TestRail CLI will attempt to match the test cases in your automation suite to test cases in TestRail.
 There are 2 mechanisms to match test cases:
@@ -1509,7 +1623,7 @@ Options:
 ### Reference
 ```shell
 $ trcli add_run --help
-TestRail CLI v1.13.2
+TestRail CLI v1.13.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Usage: trcli add_run [OPTIONS]
 
@@ -1633,7 +1747,7 @@ providing you with a solid base of test cases, which you can further expand on T
 ### Reference
 ```shell
 $ trcli parse_openapi --help
-TestRail CLI v1.13.2
+TestRail CLI v1.13.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Usage: trcli parse_openapi [OPTIONS]
 

setup.py

@@ -21,10 +21,14 @@
         "junitparser>=3.1.0,<4.0.0",
         "pyserde==0.12.*",
         "requests>=2.31.0,<3.0.0",
+        "urllib3>=1.26.0,<3.0.0",
+        "charset-normalizer>=2.0.0,<4.0.0",
+        "chardet>=5.0.0,<6.0.0",
         "tqdm>=4.65.0,<5.0.0",
         "humanfriendly>=10.0.0,<11.0.0",
         "openapi-spec-validator>=0.5.0,<1.0.0",
         "beartype>=0.17.0,<1.0.0",
+        "packaging>=20.0",
         "prance",  # Does not use semantic versioning
     ],
     entry_points="""