keios/oc-plugin-testsuite

Testing middleware package for OctoberCMS Plugins

Keios/oc-plugin-testsuite

, _(*1)

THIS PACKAGE IS NOW DEPRECATED AS OCTOBERCMS NOW SHIPS WITH IT'S OWN PLUGIN UNIT TESTING TEST CASE.

Testing middleware package: provides extended PHPUnit's TestCase class - OctoberPluginTestCase, which allows for unit testing in OctoberCMS / Laravel context and loads all related composer autoloaders., _(*2)

Prepared for OctoberCMS Release Candidate, won't work with beta releases., _(*3)

Requirements

OctoberCMS, _(*4)

Install

Via Composer, _(*5)

``` bash $ composer require keios/oc-plugin-testsuite dev-master --dev, <sub>(*6)</sub>

## Usage

#### phpunit.xml

Plugin's phpunit.xml should look somewhat like this:

``` xml

<phpunit bootstrap="vendor/keios/oc-plugin-testsuite/bootstrap/autoload.php"
         backupGlobals="false"
         backupStaticAttributes="false"
         colors="true"
         verbose="true"
         convertErrorsToExceptions="true"
         convertNoticesToExceptions="true"
         convertWarningsToExceptions="true"
         processIsolation="false"
         stopOnFailure="false"
         syntaxCheck="false">
    <testsuites>
        <testsuite name="October Plugin Unit Test Suite">
            <directory>tests/unit</directory>
        </testsuite>
        <testsuite name="October Plugin Functional Test Suite">
            <directory>tests/functional</directory>
        </testsuite>
    </testsuites>
    <logging>
        <log type="tap" target="build/report.tap"/>
        <log type="junit" target="build/report.junit.xml"/>
        <log type="coverage-html" target="build/coverage" charset="UTF-8" yui="true" highlight="true"/>
        <log type="coverage-text" target="build/coverage.txt"/>
        <log type="coverage-clover" target="build/logs/clover.xml"/>
    </logging>
    <php>
        <env name="APP_ENV" value="plugin_testing"/>
        <env name="CACHE_DRIVER" value="array"/>
        <env name="SESSION_DRIVER" value="array"/>
    </php>
</phpunit>

Test Cases

Package provides class OctoberPluginTestCase, which is prepared to run tests in Laravel 5 / OctoberCMS environment and comes with handy features like automatic migrations., <sub>(*7)</sub>

Your test cases should follow these rules:, <sub>(*8)</sub>

basic unit test ``` php <?php namespace Vendor\PluginName\Tests, <sub>(*9)</sub>

class SomeClassTest extends \OctoberPluginTestCase {, <sub>(*10)</sub>

protected $someMockObjectUsedInAllTests;

public function pluginTestSetUp () // PHPUnit's set up method is unavailable, use this instead
{
    $this->someMockObjectUsedInAllTests = \Mockery::mock('Some\Other\Class');
}

public function testSomething() { 
    $instance = new SomeClass($this->someMockObjectUsedInAllTests);

    $this->assertEquals('result', $instance->getResult());
}

}, <sub>(*11)</sub>

**functional test requiring October environment, but not refreshing plugins**
``` php
<?php namespace Vendor\PluginName\Tests

class AFunctionalTest extends \OctoberPluginTestCase {

    protected $requiresOctoberMigration = true; // test suite will migrate october

}

functional test requiring October environment AND refreshing plugin 'Vendor.PluginName' ``` php <?php namespace Vendor\PluginName\Tests, <sub>(*12)</sub>

class AFunctionalTestRequiringMigrations extends \OctoberPluginTestCase {, <sub>(*13)</sub>

/*
 * Here you can add multiple plugin codes, ie.: your plugin and it's dependencies
 */
protected $refreshPlugins = ['Vendor.PluginName', 'OtherVendor.OtherPlugin'];

} ```, <sub>(*14)</sub>

Credits

• Keios Solutions
• Scott Bedard
• Justin Lau

License

The MIT License (MIT). Please see License File for more information., <sub>(*15)</sub>