---
id: trcli
version: "1.15.2"
license: unclear
license_treatment: unclear
maintenance: active
---

# trcli

License: unclear · Maintenance: active · Downloads: 384.3K/mo

## What it is and what it does

trcli is a command-line interface for TestRail, the test case management platform. It bridges test automation frameworks and TestRail by accepting test results (typically in JUnit XML format) and uploading them to TestRail test runs via its API. The tool handles authentication, result parsing, and API communication, making it suitable for CI/CD pipelines that need to report automation outcomes without manual intervention.

The package depends on click for CLI structure, pyyaml for configuration, requests for HTTP communication, junitparser for parsing test result files, and several utility libraries for validation and formatting. It is actively maintained with recent releases and has low installation friction as a pure-Python wheel.

Use it for:

- Upload JUnit XML test results from CI/CD pipelines directly into TestRail test runs.
- Automate test result reporting in continuous integration workflows without manual TestRail updates.
- Parse and submit automation results from multiple test frameworks to centralize test reporting.
- Integrate test automation outcomes into TestRail for real-time test status visibility.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line tool for uploading test automation results to TestRail and managing test data through TestRail's API.

Yes, if you use TestRail and need to automate test result uploads from CI/CD pipelines. The package is actively maintained, has low install friction, and solves a common integration problem. Verify Python version support and documentation availability before committing to a production workflow.

## Install

pip install trcli
uv add trcli
poetry add trcli

## Installing trcli

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release 22 days ago. Depends on 14 runtime packages including click for CLI, pyyaml for configuration, requests for API calls, and junitparser for test result parsing.

Quickstart:

pip install trcli
trcli --help

Requires TestRail API credentials (typically set via environment variables or configuration file) to authenticate with a TestRail instance.

Verify before relying:

- Whether the package requires a TestRail account or API credentials to function
- What Python versions are supported (requires_python is unspecified)
- Whether documentation exists and where to find it (docs URL not provided)

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 384.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

testRail CLI upload results, test automation reporting, testRail command line, CI/CD test result integration, automated test management, test-automation, ci-cd-integration

[View on SkillFed](https://skillfed.io/packages/trcli) · [View on PyPI](https://pypi.org/project/trcli/)