README

Provides a reusable Behat context for testing Behat extensions. It lets you run Behat inside Behat - setting up temporary configurations, feature files, and contexts, then asserting on the results.

Installation

composer require friends-of-behat/test-context --dev

Configuration

Register the context in your test suite:

# behat.yml
default:
    suites:
        default:
            contexts:
                - FriendsOfBehat\TestContext\Context\TestContext

// behat.php
<?php

declare(strict_types=1);

use Behat\Config\Config;
use Behat\Config\Profile;
use Behat\Config\Suite;
use FriendsOfBehat\TestContext\Context\TestContext;

return (new Config())
    ->withProfile(
        (new Profile('default'))
            ->withSuite(
                (new Suite('default'))
                    ->withContexts(TestContext::class)
            )
    );

How It Works

Each scenario gets an isolated temporary directory that is created before and cleaned up after every scenario. When you use the setup steps, files are written into this directory. When I run Behat executes a real Behat process in that directory, and the assertion steps check its exit code and output.

This means scenarios are fully independent — file changes from one scenario never leak into another.

Usage Examples

Testing a simple extension

Feature: My extension
    In order to ensure my extension works
    As a Behat extension developer
    I want to run Behat with my extension loaded

    Scenario: Extension registers successfully
        Given a Behat configuration containing:
        """
        default:
            extensions:
                My\Extension: ~
        """
        And a feature file containing:
        """
        Feature: Smoke test

            Scenario: It works
                Then it passes
        """
        And a context file "features/bootstrap/FeatureContext.php" containing:
        """
        <?php

        use Behat\Behat\Context\Context;
        use Behat\Step\Then;

        class FeatureContext implements Context
        {
            #[Then('it passes')]
            public function itPasses() {}
        }
        """
        When I run Behat
        Then it should pass

Quick smoke tests with shorthand steps

Feature: Quick checks

    Scenario: Passing scenario
        Given a feature file with passing scenario
        When I run Behat
        Then it should pass with:
        """
        1 scenario (1 passed)
        1 step (1 passed)
        """

    Scenario: Failing scenario
        Given a feature file with failing scenario
        When I run Behat
        Then it should fail with:
        """
        1 scenario (1 failed)
        1 step (1 failed)
        """

Asserting on error output

Scenario: Unknown extension causes a configuration error
    Given a Behat configuration containing:
    """
    default:
        extensions:
            Unknown\Extension: ~
    """
    When I run Behat
    Then it should fail with "ExtensionInitializationException"

Available Steps

Setup

Execution

Assertions

All with variants also accept multiline pystrings.