library runnable

aviator/runnable

Static constructor and handler trait with interface.

., _(*1)

Overview

This package provides a static constructor and handler interface, and a trait that implements the interface., _(*2)

Installation

Via Composer:, _(*3)

composer require aviator/runnable

Testing

Via Composer:, _(*4)

composer test

Usage

Use the trait:, _(*5)

class Something
{
    use RunnableTrait;
}

Then the class can be instantiated and handled using Class::run()(). The static run method returns a closure which accepts any arguments the method (by default get()) requires:, _(*6)

$closure = Something::run($arg1);
$result = $closure($arg2); 

// Or just:

$result = Something::run($arg1)($arg2);

The trait also pulls in Aviator\Makeable, so you get the static constructor make() out of the box., _(*7)

The interface is optional, though it can be useful in composite interfaces to specify that a static constructor should be present:, _(*8)

interface SomeInterface extends Runnable, SomeOtherInterface
{
    /* etc */
}

By default the trait will call get(), but this can be overridden:, _(*9)

class Something
{
    use RunnableTrait;

    protected static $method = 'handle';

    public function handle ($arg)
    {
        /* etc */
    }
}

$result = Something::run()('arg');

// Calls the handle() method.

The magic of late static binding means you can override the default method on classes extending abstract classes and classes extending classes, etc., _(*10)

Other

License

This package is licensed with the MIT License (MIT)., _(*11)