How to reuse common tests in phpspec?

@ryan.murray 

In phpspec, you can reuse common tests using shared examples. Shared examples allow you to define a set of tests that can be reused across different classes or specifications.

Here's how you can reuse common tests in phpspec using shared examples:

1. Define a shared example in a separate file: Create a new file, e.g., Shared/Example/SomeTest.php. Inside this file, define the shared example using the SharedExample annotation. For example:

1
2
3
4
5
6
7
8
9

use PhpSpecObjectBehavior;

class SomeTest extends ObjectBehavior
{
    function it_does_something()
    {
        // Test logic here
    }
}

1. Include the shared example in your specification: In your individual specification files, you can include the shared example using the includeSharedExampleFor method. For example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

use PhpSpecObjectBehavior;

class MySpec extends ObjectBehavior
{
    // ...

    function it_should_do_something()
    {
        $this->should('do_something');
        $this->doSomething();
    }

    function it_should_reuse_some_test()
    {
        $this->beAnInstanceOf('SharedExampleSomeTest');
    }
}

1. Run the specification: When you run your phpspec tests, both the tests defined in the specification file and the tests from the shared example file will be executed.

By using shared examples, you can easily reuse common tests across multiple specifications and keep your test code DRY.