Download the PHP package jacobstr/matura without Composer

Matura


An RSpec / Mocha inspired testing tool for php. Requires 5.3+.

Installation

1. composer require "jacobstr/matura ~0.2"

Features

• Esperance expectation library: expect($result)->to->have->length(2).

• A succinct DSL for defining tests.

• Heirarchical blocks to drill down from basic to complex assertions.

• before, before_all, after, after_all, hooks with a well-defined ordering.

Assertions

As mentioned above, Matura uses Esperance as it's assertion library. Here are the core examples that you can use:

The CLI

If you run, bin/mat test test/examples:

And the documentation for the standard test command:

Usage:
test [-g|--grep="..."] [-i|--include="..."] [-x|--exclude="..."] [-d|--trace_depth="..."] path

Arguments:
 path                  The path to the file or directory to test.

Options:
 --grep (-g)           Filter individual test cases by a description regexp.
 --include (-i)        Include test files by a basename(filename) regexp.
 --exclude (-x)        Exclude test files by a basename(filename) regexp.
 --trace_depth (-d)    Set the depth of printed stack traces.
 --help (-h)           Display this help message.
 --quiet (-q)          Do not output any message.
 --verbose (-v|vv|vvv) Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
 --version (-V)        Display this application version.
 --ansi                Force ANSI output.
 --no-ansi             Disable ANSI output.
 --no-interaction (-n) Do not ask any interactive question.

Filtering

If you wish to filter specific tests within a suite/file, use --grep. Matura will be clever enough to run the requisite before/after hooks.

Test Result Association

When running before/after hooks Matura will associate any test failures with the currently running test, rather than treating it as a file-level failure. This is particularly useful with Mockery's close method, which triggers additional assertions: was a method called, was it called with the right parameters, and so on.

For before_all / after_all hooks, the failure is associate with the surrounding describe block.

Test Organization

By default, Matura filters on the file's basename for anything beginning with test_.

I'm using the structure below. I might formalize this some time:

├── test // Actual test cases.
│   ├── functional // Functional tests.
│   │   ├── test_context.php
│   │   ├── test_model.php
│   │   └── test_ordering.php
│   ├── integration // More end-to-end flavored tests.
│   │   └── test_test_runner.php
│   └── performance // Tests that serve to benchmark your code.
│       └── test_stress.php

I keep my fixtures in a top-level support folder. I've seen these placed in the test folder but I chose to keep them tucked away to avoid iterating over them and making the default filter complex.

Authoring Tests

The one key piece is you want to place your tests in the Matura\Tests namespace if you're not using PHP 5.6. If you're using 5.6 you can import the functions in Matura\Tests into your namespace.

Further Documentation

I swear it's not a cop out! Examine the tests folder.

• In what order is everything run?
• What is that $ctx parameter?

TODOS

• There's currently nothing like PHPUnit's backupGlobals. Maybe there shouldn't be - I feel a better way to find inadvertent coupling / dependencies on global variables may be to add functionality that randomizes test ordering.
• Backtraces annoyingly include calls internal to the framework.
• I'm a fan of contract tests. Class-based tests seem better suited to them, however, so I'm in need of inspiration wrt to the callback-driven dsl that matura uses. Maybe an invocable class...

Thanks!

• Ben Zittlau - PHPUsable which brings similar syntax to PHPUnit. Helped me realize this was a worthwhile diversion.