pyats.topology
pyATS Topology: Topology Objects and Testbed YAMLs
Decision gist · record as of 2026-08-14
Yes, if you are building test automation within the pyATS ecosystem or need to model and traverse network testbed topology in Python. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Medium install friction is acceptable for a specialized testing framework. Not recommended if you need Windows support or are not already committed to the pyATS testing model.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later; Linux and macOS only (Windows not supported).
- Active maintenance with a release 7 days ago.
- Medium install friction due to 5 runtime dependencies (pyyaml, yamllint, pyats.datastructures, pyats.connections, pyats.utils) and binary wheels for Python 3.10–3.14 across macOS and Linux platforms.
License · maintenance · safety
Apache 2.0 (permissive) — Apache 2.0 permissive license allows commercial and private use with minimal restrictions.
last release 2026-08-07 (7 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 295,736 downloads/mo, #7,916 on PyPI
Alternatives
Verify before relying
pip install pyats.topology
from pyats.topology import Testbed
testbed = Testbed.load('topology.yaml')
devices = testbed.devices
links = testbed.links- Whether the package is suitable for dynamic topology updates after initial load.
- Performance characteristics when modeling large testbeds with hundreds of devices.
- Extent of YAML schema validation and error reporting for malformed topology files.
What it is and what it does
pyats.topology is the network modeling layer of the pyATS testing framework, a Cisco-developed end-to-end testing ecosystem. It provides object-oriented abstractions for testbeds, devices, interfaces, links, and segments—the core entities in network test environments. Topology definitions are typically loaded from YAML files, where devices, interfaces, and segments are declared; the package then exposes these as Python objects that test code can traverse and query (e.g., device.links, testbed.segments).
The package is designed as a building block within the larger pyATS ecosystem, which emphasizes data-driven, reusable, and scalable test suites. It depends on pyyaml for file parsing, yamllint for validation, and other pyats submodules (datastructures, connections, utils) for integration with the broader framework. It supports Python 3.8 through 3.14 on Linux and macOS, with no Windows support.
Use it for
- Load and programmatically access network testbed topology from YAML files in automated test scripts.
- Query device interfaces, links, and segments to build dynamic test scenarios based on network structure.
- Integrate topology models with pyATS test cases to enable data-driven network testing workflows.
- Define multi-device network segments (e.g., QINQ) in YAML and reference them from interface configurations.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building test automation within the pyATS ecosystem or need to model and traverse network testbed topology in Python.
The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Medium install friction is acceptable for a specialized testing framework. Not recommended if you need Windows support or are not already committed to the pyATS testing model.
Install
pyats-topology on PyPI
Before you install
Active maintenance with a release 7 days ago. Medium install friction due to 5 runtime dependencies (pyyaml, yamllint, pyats.datastructures, pyats.connections, pyats.utils) and binary wheels for Python 3.10–3.14 across macOS and Linux platforms.
Requires Python 3.8 or later; Linux and macOS only (Windows not supported).
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions.
Quickstart
pip install pyats.topology
from pyats.topology import Testbed
testbed = Testbed.load('topology.yaml')
devices = testbed.devices
links = testbed.linksVerify before relying
- Whether the package is suitable for dynamic topology updates after initial load.
- Performance characteristics when modeling large testbeds with hundreds of devices.
- Extent of YAML schema validation and error reporting for malformed topology files.
Package facts
| License | Apache 2.0 permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 5 packagespyyamlyamllintpyats.datastructurespyats.connectionspyats.utils |
| Maintenance | Actively maintained 7 days since the last release |
| First released | |
| Downloads | 295,736 / month, #7,916 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableDevelopment Status :: 6 - MatureEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: System AdministratorsIntended Audience :: Telecommunications IndustryLicense :: OSI Approved :: Apache Software LicenseOperating System :: MacOSOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonTopic :: Software Development :: Build ToolsTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: Testing |
Evidence: pyats_topology-26.7-cp310-cp310-macosx_11_0_universal2.whl; pyats_topology-26.7-cp310-cp310-manylinux2014_aarch64.whl; pyats_topology-26.7-cp310-cp310-manylinux2014_x86_64.whl; pyats_topology-26.7-cp311-cp311-macosx_11_0_universal2.whl; pyats_topology-26.7-cp311-cp311-manylinux2014_aarch64.whl; pyats_topology-26.7-cp311-cp311-manylinux2014_x86_64.whl; pyats_topology-26.7-cp312-cp312-macosx_11_0_universal2.whl; pyats_topology-26.7-cp312-cp312-manylinux2014_aarch64.whl; pyats_topology-26.7-cp312-cp312-manylinux2014_x86_64.whl; pyats_topology-26.7-cp312-cp312-musllinux_1_2_x86_64.whl; pyats_topology-26.7-cp313-cp313-macosx_11_0_universal2.whl; pyats_topology-26.7-cp313-cp313-manylinux2014_aarch64.whl; pyats_topology-26.7-cp313-cp313-manylinux2014_x86_64.whl; pyats_topology-26.7-cp314-cp314-macosx_11_0_universal2.whl; pyats_topology-26.7-cp314-cp314-manylinux2014_aarch64.whl; pyats_topology-26.7-cp314-cp314-manylinux2014_x86_64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “network topology modeling”
- pyats.topologyModels network testbeds, devices, interfaces, links and segments as…
- genie.libs.opsGenie Libs Ops provides a library component for the Genie test…
- osmnxOSMnx downloads, models, and analyzes street networks and geospatial…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also pyats.aetest · pyats.connections · pyats.utils · pyats.reporter · pyats.kleenex · pyats · pyats.log · yang.connector · rest.connector · unicon