jimigrunge/invoke-private-methods

This is a class to aid in unit testing of private methods.

1.0.3 2016-03-23 14:19 UTC

README

Latest Stable Version Build Status Coverage Status License Total Downloads This is a forkable respository

This is a class to aid in unit testing of private methods. It can be used either as a stand alone class or as a trait and called either programmatically or statically.

Although testing of private methods is not recommended in most cases, sometimes it is necessary. Such as to insure correct calculations in a protected method aside form the methods that currently utilize it. Hence this repository.

Note: I mainly use PhpUnit for all testing so I make no guaranties when it comes to other testing utilities as I have not utilized them yet.

Installation

$ composer require jimigrunge/invoke-private-methods

Usage

class InvokePrivateMethod

This class can be used to test private and protected methods.

Once you include the class with the 'use' statement, you can utilize it on one of two ways. You can either create an instance of InvokePrivateMethod and call invokeMethod, as in testMyMethod(), or call invoke() statically as in testMyMethodStatically()

<?php

// Include class to call private methods
use Jimigrunge\InvokePrivateMethods\InvokePrivateMethod;

class testclass extends \PHPUnit_Framework_TestCase
{
    /** @var InvokePrivateMethod */
    private $invoker;
    private $dummyObject;

    public function setUp()
    {
        // Instantiate the class
        $this->invoker = new InvokePrivateMethod();
        $this->dummyObject = new DummyClass();
    }

    public function testMyMethod()
    {
        // Call invoke method on private function
        $result = $this->invoker->invokeMethod($this->dummyObject, 'myPrivateFunction', ['param1']);
        $this->assertEquals('Test Success', trim($result));
    }

    public function testMyMethodStatically()
    {
        // Can also be used statically
        $result = InvokePrivateMethod::invoke($this->dummyObject, 'myPrivateFunction', ['param1']);
        $this->assertEquals('Test Success', trim($result));
    }
}

trait InvokePrivateMethodTrait

This trait can be used to add the functionality directly to you test class so that it can call it internally.

As with the full class usage, you can utilize it on one of two ways. You can either call $this->invokeMethod, as in testMyMethod(), or call self::invoke() statically as in testMyMethodStatically()

<?php

// Include trait to call private methods
use Jimigrunge\InvokePrivateMethods\Traits\InvokePrivateMethodTrait;

class testclass extends \PHPUnit_Framework_TestCase
{
    use InvokePrivateMethodTrait;

    private $dummyObject;

    public function setUp()
    {
        $this->dummyObject = new DummyClass();
    }

    public function testMyMethod()
    {
        // Call invoke method on private function
        $result = $this->invokeMethod($this->dummyObject, 'myPrivateFunction', ['param1']);
        $this->assertEquals('Test Success', trim($result));
    }

    public function testMyMethodStatically()
    {
        // Can also be used statically
        $result = self::invoke($this->dummyObject, 'myPrivateFunction', ['param1']);
        $this->assertEquals('Test Success', trim($result));
    }
}

Further detail

More detailed usage examples can be found by studying the tests in the /tests directory.

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request.

Please insure that any pull requests include complete test coverage.

License

The MIT License (MIT)