---
id: pytest-fixture-config
version: "1.8.0"
license: MIT license
license_treatment: permissive
maintenance: aging
---

# pytest-fixture-config — Fixture configuration utils for py.test

License: permissive · Maintenance: aging · Downloads: 351.2K/mo

## What it is and what it does

pytest-fixture-config is a pytest plugin that simplifies managing configuration for test fixtures. It lets you define configuration objects that read values from environment variables or other sources, then use decorators to conditionally skip tests when required configuration is missing. This is useful when your test suite includes optional tests for features you might not have installed or configured on every machine.

The package provides a Config base class you subclass to define your fixture configuration, plus decorators like requires_config and yield_requires_config that automatically skip tests when their required settings aren't available. It integrates directly into pytest as a plugin and requires only pytest as a runtime dependency.

Use it for:

- Skip integration tests when external service credentials (API keys, database URLs) are not set in the environment.
- Conditionally run tests for optional features based on whether their configuration is available.
- Manage fixture setup that depends on environment-specific settings without failing the entire test suite.
- Define reusable configuration singletons across multiple test fixtures in a conftest.py.
- Test code paths that require specific tools or services without breaking CI/CD when they're unavailable.

## Worth the install?

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

Provides configuration objects and decorators for pytest fixtures that allow you to define, manage, and conditionally skip tests based on required configuration variables.

Yes, if you need to conditionally skip pytest fixtures based on missing configuration. The package is stable, permissively licensed, and has low install friction. The aging maintenance status (last release 666 days ago) is a minor concern but not a blocker—the repository is still active and the package is marked Production/Stable. Install it if you're managing optional test fixtures or environment-dependent test setup.

## Install

pip install pytest-fixture-config
uv add pytest-fixture-config
poetry add pytest-fixture-config

## Installing pytest-fixture-config

Before you install: Low friction install with a single runtime dependency on pytest. Maintenance status is aging—last release was 666 days ago, though the repository remains active with a recent commit in January 2026 and 598 stars. The package has been stable since its 2015 initial release.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in both open-source and commercial projects with minimal restrictions.

Quickstart:

pip install pytest-fixture-config

# In conftest.py or test file:
import os
from pytest_fixture_config import Config, requires_config

class FixtureConfig(Config):
    __slots__ = ('api_key',)

CONFIG = FixtureConfig(api_key=os.getenv('API_KEY'))

@pytest.fixture
@requires_config(CONFIG, ['api_key'])
def my_fixture():
    return CONFIG.api_key

Verify before relying:

- Whether the package is actively maintained or in maintenance-only mode given the 666-day gap since last release.
- Compatibility with pytest versions beyond those listed in the changelog (4.0.0+).

## Package facts

- License: MIT license (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 351.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest fixture configuration, skip tests missing config, pytest config management, fixture setup helpers, conditional test skipping, pytest plugin config, environment-based test skipping, pytest-plugin, test-configuration

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