This PhpSpec extension allows to skip example through user-friendly annotations.

Once you have installed PhpSpec (following the documentation on the official website), add the extension requirement to your composer.json:

{
    "require": {
        "akeneo/phpspec-skip-example-extension": "1.0.*@dev"
    }
}

And run composer update:

$ php composer.phar update akeneo/phpspec-skip-example-extension

You can now activate the extension by creating a phpspec.yml file at the root of your project:

extensions:
    - Akeneo\SkipExampleExtension

Skips all the spec example if the class or interface is not available

/**
 * @require Vendor\Builder\ToolInterface
 */
class BridgeBuilderSpec extends ObjectBehavior
{
    // Will be skipped if the Vendor\Builder\ToolInterface interface does not exist
    function it_builds_a_brige()
    {
    }

    // Will be skipped if the Vendor\Builder\ToolInterface interface does not exist
    function it_builds_the_road()
    {
    }

    //...
}

Feel free to contribute to this extension if you find some interesting ways to improve it!