---
id: oslotest
version: "6.1.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# oslotest — Oslo test framework

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

## What it is and what it does

oslotest is a testing framework maintained by the OpenStack project that extends testtools and fixtures to provide a common foundation for test suites. It offers pre-built test base classes, fixtures for common setup patterns, and utilities for debugging and mocking that reduce boilerplate in test code.

The package is designed primarily for OpenStack development but can be adopted in any Python project that uses testtools. It requires Python 3.10 or later and has no compiled dependencies, making installation straightforward. The framework integrates with standard Python testing workflows and is actively maintained.

Use it for:

- Building test suites for OpenStack projects with standardized fixtures and base classes.
- Extending testtools with OpenStack-specific debugging and mocking utilities in existing test code.
- Setting up unit tests that require common fixture patterns without writing boilerplate setup.
- Debugging test failures with enhanced logging and introspection support from the Oslo framework.

## Worth the install?

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

oslotest provides a testing framework with common fixtures and utilities for OpenStack projects, built on top of testtools and fixtures to streamline test setup and mocking.

Yes, if you are working on OpenStack projects or need testtools-based testing with pre-built fixtures. The low install friction, active maintenance, permissive license, and lack of security issues make it a safe choice. For non-OpenStack Python projects, evaluate whether the framework's design assumptions align with your testing strategy before adopting.

## Install

pip install oslotest
uv add oslotest
poetry add oslotest

## Installing oslotest

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained as of 116 days ago with current Python support (3.10–3.13). Only two runtime dependencies (fixtures and testtools), both lightweight testing libraries.

License in practice: Licensed under Apache (permissive), allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install oslotest

from oslotest import base

class MyTest(base.BaseTestCase):
    def test_example(self):
        self.assertEqual(1, 1)

Requires Python 3.10 or later.

Verify before relying:

- Whether oslotest is suitable for non-OpenStack projects or if it is tightly coupled to OpenStack infrastructure.
- The scope and maturity of the mocking and debugging features relative to standard unittest or pytest plugins.

## Package facts

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

## Tags

openstack testing framework, test fixtures and utilities, oslo testing library, python test framework, mocking and debugging support, openstack unit testing, testtools extension, openstack, testing-framework, fixtures

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