Huck

A PHP Testing Framework

<?php
describe('Huck Fin', function() {
   
   it('should be Huck', function() {
      expect('Huck')->toBe('Huck'); 
   });
   
   it('should not be Huck', function() {
      expect('Tom')->not->toBe('Huck'); 
   });
    
});
?>

Huck is a BDD (Behavior Driven Development) framework based on Jasmine for JS. It is designed for with a simple syntax to give it a low learning curve.

---

WARNING: This project should be considered very dangerous and not be used on any real projects. It is an experimental testing suite for PHP and may break everything.

DO NOT DEPEND ON IT FOR ANYTHING IMPORTANT.

Features

Huck includes the let syntax from RSpec. Because tests are defined in a procedural style, it's not possible to share common variables without using global. To get around this you can define a variable with let() and the value will be passed into your test.

describe("let() syntax", function() {

  // define the variable "user"
  let('user', User::create(array('name' => 'Huck')));

  it("gets the user object", function($spec) {
    expect($spec->user->name)->toEqual('Huck');
  });

  // it resolves closures
  let('user_new_name', function($spec) {
    $user = $spec->user;
    $user->name = 'Tom';
    return $user;
  });

  it("gets the value from a closure", function($spec) {
    expect($spec->user_new_name->name)->toEqual('Tom');
  });
});

How to Use

Huck can be executed via bin/huck and it can run against a directory or a file.

$ bin/huck spec
$ bin/huck spec/huck_suite_spec.php

Available Matchers

Huck includes most of the matchers available in Jasmine.

expect($x)->toEqual($y); checks to see if $x and $y have the same value

expect($x)->toBe($y); checks to see if $x and $y are identical. e.g. 1 !== '1'

expect($x)->toMatch($pattern); compares $x to regular expression $pattern

expect($x)->toBeNull(); checks to see if $x === null

expect($x)->toBeTruthy(); checks if $x === true

expect($x)->toBeFalsy(); checks if $x === false

expect($x)->toContain($y); checks to see if (array) $x contains $y. Runs array_key_exists && in_array

expect($x)->toBeLessThan($y); checks to see if $x < $y

expect($x)->toBeGreaterThan($y); checks to see if $x > $y

expect($x)->toBeEmpty(); runs empty

expect($x)->toBeString(); runs is_string

expect($x)->toBeInteger(); runs is_int

expect($x)->toBeArray(); runs is_array

expect($x)->toBeInstanceOf(); runs instanceof type operator

You can invert any of the matches by using

expect($x)->not->toEqual($y)

Custom Matchers

To create custom matchers run this in your spec file.

<?php

/**
 * Checks to match length
 *
 * @param $actual the value passed into expect()
 * @param $expected the value passed into ->toBeLength()
 * @author Baylor Rae'
 */
Huck::addMatcher('toBeLength', function($actual, $expected) {
    if( !is_array($actual) && !is_array($expected) )
        return false;
    
    return count($actual) === count($expected);
});

?>