linusshops/prophet

Zero footprint Module testing for Magento Modules

Wednesday, April 20, 2016
by linusshops
Repository
6 Watchers
3 Stars
8 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
13 Open issues
29 Versions
0 % Grown

The README.md

prophet

Objective: provide a test harness that does not require modifying Magento core, and allows testing by module. The only thing that should exist is config files, and the tests themselves., _(*1)

Prophet accomplishes this by finding Mage.php and the bootstrapping functions for the Varien autoloader, and instantiates them. By doing this, it is able to instantiate the Magento environment in which tests can be run. It then loads PHPUnit and executes tests for the provided module list., _(*2)

To ensure that the test context for each module's tests is clean, it creates a subprocess of prophet to run the module tests. This ensures that there is no shared state between module test suites., _(*3)

As Magento was never designed with testing in mind, certain classes and states are very difficult to test. Prophet solves this by creating a custom class mechanism that essentially creates class rewrites and overrides that will only be used in the test execution context, and NEVER during normal execution. This ensures that your testing system can never adversely affect your site when not executing via Prophet., _(*4)

Impetus

As mentioned above, Magento was never designed with unit testing in mind (and according to the core team, does not have automated tests to this day). This problem has been tackled before by other packages, but all of them require installing a module to handle testing, or modifying core., _(*5)

This is non-ideal, as it is injecting code that could potentially cause conflicts. Ideally, a testing system should not have any chance of changing the functionality of the system under test unless it is being executed in the test context., _(*6)

Prophet seeks to solve this problem by focusing on testing on a module basis, and by focusing on the Firegento/Composer Magento ecosystem. Prophet expects tests to be written on a module by module basis, and seeks to execute them with the modules in isolation. Since test code is confined to a test directory of a module, it is not ever going to be invoked by Magento under normal execution conditions., _(*7)

Prophet's footprint becomes only the config files and the test cases the developer creates- it adds nothing to Magento core or the local code pool., _(*8)

Installation

Prophet should be installed via composer. It is recommended to install it globally., _(*9)

composer global require linusshops/prophet, _(*10)

For best results, your Magento installation should be managed with magento-composer-installer., _(*11)

Commands

Prophet must be executed from the command line at the Magento root., _(*12)

prophet: Run tests, default to phpunit., _(*13)

prophet validate: Confirm that all modules in prophet.json are testable., _(*14)

prophet show: Display all modules in prophet.json, and their available tests., _(*15)

prophet init: Initialize any modules in prophet.json that do not have the expected test structure., _(*16)

prophet analyze: Search your vendor directory for testable modules, and attempt to create a prophet.json, _(*17)

prophet inspect: Bootstrap Magento and then start PsySH in that context. Useful for REPL testing., _(*18)

prophet list: View all commands, _(*19)

prophet run: Run tests using a specified test framework., _(*20)

prophet generate:ide-helper: Create a hint file to include in your project for autocomplete of contexts and functions provided when executing tests via Prophet., _(*21)

prophet help [command]: View help for a specific command., _(*22)

For troubleshooting, you can increase verbosity with -vvv, as with any symfony/console app., _(*23)

Events and Bootstrapping

TODO: event-dispatcher no longer used, update with new instructions., _(*24)

Prophet will check for the existence of a tests/ProphetEvents.php file in your module. If it exists, it will be included. The check for this occurs immediately prior to the registration of custom autoloaders and the firing of the premodule event., _(*25)

This file is included, so it is executed within the same context as your tests and Prophet. It can serve as a module bootstrap file, though it is not recommended as the premodule event should be used for this, or the PHPUnit setUp functions., _(*26)

Autoloader

TODO: Prophet does way more than just controllers now, expand this section., _(*27)

The Varien autoloader is not able to directly load controllers. To allow these controllers to be instantiated for testing, Prophet creates its own autoloader functions, and prepends them on the autoloader stack. This means that Prophet's autoloader has priority over the Varien autoloader., _(*28)

This is due to the fact that the Varien autoloader dies if it can't instantiate the class. Prophet will still use the Varien autoloader; the custom autoloaders just have priority., _(*29)

Custom Classes

TODO: Add notes on custom overrides provided by Prophet, _(*30)

Prophet includes some classes for testing that can be used in place of the regular classes. See the overrides dir. Generally, they extend the existing class, and rewrite methods that are problematic for testing, without changing the expected interface., _(*31)

These classes can be instantiated in your tests using the Classes helper. Remember, Prophet executes in the same context as your tests, so therefore all of its helpers and classes are available in your test cases!, _(*32)

You can also include custom test classes by adding them to a tests/classes directory. Prophet injects a general autoloader that will look in this directory for a class before anything else., _(*33)

Prophet loaders have priority over the Varien autoloader. Essentially, this allows you to do testing-specific rewrites and overrides, without any risk of it being used in normal execution., _(*34)

Controller test example

TODO, _(*35)

Behat

http://dannorth.net/whats-in-a-story/, _(*36)

Prophet can run functional tests using Behat and Mink., _(*37)

Prophet does not configure any browsers or drivers; this is all configured via your behat.yml file. If you have not already configured something, the elgalu/selenium docker container provides a preconfigured Selenium hub with Firefox and Chrome., _(*38)

Recommended to use Parallels instead of Virtualbox if using docker-machine, unless you like tests running as slow as molasses. Also recommended to give the docker-machine at least 4GB of RAM to satiate Chrome's hunger for memory., _(*39)

https://github.com/Parallels/docker-machine-parallels/, _(*40)

TODO: add instructions on setting up elgalu container with prophet and behat, setting up docker-machine- write script, _(*41)

```bash #Create the docker container (assuming you already pulled elgalu/selenium docker run --rm --name=grid --add-host='develop.vagrant.dev:192.168.80.80' -p 4444:24444 -p 5920:25900 \ -v /dev/shm:/dev/shm -e VNC_PASSWORD=hola elgalu/selenium, _(*42)

#View the browser live during a test open vnc://:hola@$(docker-machine ip default):5920 ```, _(*43)

Prophet makes all of the contexts from linusshops/behat-contexts available to Behat via its custom loaders. See the behat-contexts repository for more information. Remember that you can generate an ide helper file to give you autocomplete (prophet generate:ide-helper)., _(*44)

Author

Samuel Schmidt, _(*45)

Contributors

Dane MacMillan, _(*46)

License

This tool was created by Linus Shops and licensed under the MIT License., _(*47)

The Versions

20/04 2016

dev-master

9999999-dev https://github.com/linusshops/prophet

Zero footprint Module testing for Magento Modules

utility prophet

Zero footprint Module testing for Magento Modules

linusshops/prophet

The README.md

prophet

Impetus

Installation

Commands

Events and Bootstrapping

Autoloader

Custom Classes

Controller test example

Behat

Author

Contributors

License

The Versions

dev-master

The Requires

The Development Requires

by Sam Schmidt

by Linus Shops Inc

v0.8.5

The Requires

by Sam Schmidt

by Linus Shops Inc

v0.8.4

The Requires

by Sam Schmidt

by Linus Shops Inc

v0.8.2

The Requires

by Sam Schmidt

by Linus Shops Inc

v0.8.1.1

The Requires

by Sam Schmidt

by Linus Shops Inc

v0.8.1

The Requires

by Sam Schmidt

by Linus Shops Inc

v0.8.0

The Requires

by Sam Schmidt

by Linus Shops Inc

v0.7.3

The Requires

by Sam Schmidt

by Linus Shops Inc

0.7.2

The Requires

by Sam Schmidt

by Linus Shops Inc

0.7.1

The Requires

by Sam Schmidt

by Linus Shops Inc

0.7.0

The Requires

by Sam Schmidt

by Linus Shops Inc

0.6.7

The Requires

by Sam Schmidt

by Linus Shops Inc

0.6.5

The Requires

by Sam Schmidt

by Linus Shops Inc

0.6.3

The Requires

by Sam Schmidt

by Linus Shops Inc

0.6.0

The Requires

by Sam Schmidt

by Linus Shops Inc

0.5.1

The Requires