---
id: pyats-results
version: "26.7"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# pyats.results — pyATS Results: Representing Results using Objects

License: permissive · Maintenance: active · Downloads: 295.2K/mo

## What it is and what it does

pyats.results is a sub-component of the pyATS end-to-end testing framework that provides object-oriented abstractions for representing and aggregating test results. It enables developers to track test outcomes hierarchically and roll up status codes across test suites, supporting the data-driven and reusable testing patterns that pyATS emphasizes.

The package is designed to integrate with pyATS's broader testing ecosystem, which is engineered for Agile rapid development and scales from simple linear test cases to complex asynchronous suites. It has no runtime dependencies beyond Python itself, making it lightweight to add to existing test infrastructure. The package is actively maintained, with recent releases supporting modern Python versions (3.10 through 3.14) on Linux and macOS.

Use it for:

- Aggregate pass/fail counts across multiple test modules into a single consolidated result object.
- Track hierarchical test outcomes where parent test suites roll up status from child test cases.
- Represent test results programmatically in CI/CD pipelines that need structured result data.
- Build custom test reporting tools that consume result objects from pyATS test runs.
- Implement result filtering and analysis logic on top of standardized result representations.

## Worth the install?

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

Provides object-oriented result representation and rollup aggregation for the pyATS testing framework, enabling hierarchical test result tracking and status consolidation.

Yes, if you are already using pyATS or building test infrastructure that needs structured result aggregation. The package is actively maintained, permissively licensed, has no external dependencies, and supports current Python versions. Install it as part of the broader pyATS ecosystem rather than in isolation unless you specifically need result object abstractions outside pyATS.

## Install

pip install pyats-results
uv add pyats-results
poetry add pyats-results

## Installing pyats.results

Before you install: Active maintenance with a release within the past week. Medium install friction due to compiled wheels across multiple Python versions (3.10–3.14) and platforms, but pre-built binaries are available for common architectures, reducing build overhead.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for most organizational testing workflows.

Quickstart:

pip install pyats.results

from pyats.results import Result

result = Result()
result.passed = 1
result.failed = 0

Requires Python 3.8 or later; Linux and macOS only (Windows not supported per documentation).

Verify before relying:

- Specific API surface and result aggregation methods available in version 26.7.
- Whether this package is typically installed standalone or as part of the larger pyats ecosystem.
- Performance characteristics when handling large test suites or deeply nested result hierarchies.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 295.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

test result aggregation, result rollup objects, pyats results tracking, hierarchical test status, result code consolidation, test outcome representation, result object framework, test-framework, result-aggregation

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