tar-azure-cli

tar-azure-cli is a CLI tool for packaging and publishing test results in Azure DevOps pipelines.
It collects JUnit XML reports, generates metadata, supports custom key-value pairs, and can upload results to an FTP server or as an Azure DevOps artifact.

Features

• Collect and archive JUnit XML test reports
• Generate pipeline and environment metadata automatically
• Support for custom JSON and artifact directories
• Publish as Azure DevOps artifacts or upload results to FTP
• Easy integration with CI/CD workflows

Installation

Global Installation (Recommended)

npm install -g tar-azure-cli

Using npx (No Installation Required)

You can run the tool directly without installing it globally:

npx tar-azure-cli --help

Usage

After Global Installation

tar-azure-cli --junitXmlFiles <files> --testSuiteName <suite> [options]
# or
tar-utils --junitXmlFiles <files> --testSuiteName <suite> [options]

Using npx

npx tar-azure-cli --junitXmlFiles <files> --testSuiteName <suite> [options]

Examples:

# Global installation
tar-azure-cli -f junit-result.xml -t "Sanity Tests"

# Using npx
npx tar-azure-cli -f junit-result.xml -t "Sanity Tests"

Options

| Option | Alias | Description | Required | |-----------------------|-------|--------------------------------------------------|----------| | --junitXmlFiles | -f | Comma-separated JUnit XML files | Yes | | --testSuiteName | -t | Test suite or stage name | Yes | | --atlassianDomain | -s | Atlassian domain name (for Xray link) | No | | --projectName | -p | Project name (for FTP upload) | No | | --testEnvironment | -e | Test environment (dev, qa, sit, prod, etc.) | No | | --url | -r | URL under test | No | | --productBuildBranch | -pb | Product build branch | No | | --extJson | -x | Path to extra flat JSON file | No | | --artifactJson | -j | Path to artifact JSON file | No | | --artifactDir | -c | Path to artifact directory | No | | --tarUserName | -u | FTP username | No | | --tarPassword | -w | FTP password | No | | --tarHost | -a | FTP host | No | | --keyValuePairs | -k | Extra key-value pairs (e.g. key=value|key=value)| No |

License

MIT