Skip to content

sts - Storage Tests

Project designed for testing Linux storage drivers, utilities, and devices on Fedora, CentOS Stream, and RHEL. It consists of two main parts:

  1. sts-libs: A Python package published to PyPA and Fedora Copr
  2. Requires Python 3.9+, pytest, and pytest-testinfra
  3. Makes writing storage tests quick and easy
  4. Supports RHEL8, RHEL9, RHEL10, CentOS Stream 9 and 10
  5. Available via pip and Fedora Copr (including EPEL)

  6. Tests, Plans: A collection of tests and plans for testing storage devices

  7. Uses pytest and tmt
  8. Made to be executed with tmt (and testing-farm)
  9. Utilizes sts-libs for test implementation

Quick Start

Installing sts-libs

From PyPI

pip install sts-libs

From Fedora Copr (Fedora and EPEL)

dnf copr enable packit/gitlab.com-rh-kernel-stqe-sts-releases
dnf install python3-sts-libs

Running Tests

Tests are executed using tmt. For common usage, see:

tldr tmt

Full documentation for tmt is available at tmt.readthedocs.io. tmt Matrix room is available at #tmt:fedora.im.

Project Structure

.
├── sts_libs/
│   ├── src/sts/       # libs, fixtures   └── tests/         # sts-libs unit tests
├── plans/
└── tests/

Requirements

sts-libs

  • Python 3.9+
  • pytest
  • pytest-testinfra

Supported Operating Systems

  • Fedora
  • CentOS Stream 9 and 10
  • RHEL 8, 9, and 10

Other operating systems may work but would need community contributions for support.