tuupola/witchcraft

Opionated magic methods as traits

Witchcraft

Opionated PHP magic methods as traits., _(*1)

, _(*2)

Install

You can install latest version using composer., _(*3)

$ composer require tuupola/witchcraft

Usage

You have your usual class with boilerplate accessors and mutators., _(*4)

class Unicorn
{
    private $color;
    private $birthday;

    public function __construct($color = "white", $birthday = null)
    {
        $this->color = $color;
        $this->birthday = $birthday;
    }

    public function getColor()
    {
        return $this->color;
    }

    public function setColor($color)
    {
        $this->color = $color;
        return $this;
    }

    public function getBirthday()
    {
        return $this->birthday;
    }

    public function setBirthday($birthday)
    {
        $this->birthday = DateTime::createFromFormat("Y-m-d", $birthday);
        return $this;
    }

    public function getAge()
    {
        $now = new DateTime();
        return $this->birthday->diff($now)->format("%y years");
    }
}

It all works really nice with ide autocompletes and everything. Problem is your code looks quite ugly., _(*5)

$unicorn = new Unicorn();
$unicorn->setBirthday("1930-24-12")->setColor("rainbow");
print $unicorn->getAge();

Magic methods

Witchcraft to the resque. If you add Witchcraft\MagicMethods trait you can use pretty methods., _(*6)

class Unicorn
{
    use \Witchcraft\MagicMethods;

    /* Rest of the code stays exactly the same. */
}

$unicorn = new Unicorn();
$unicorn->birthday("1930-24-12")->color("rainbow");
print $unicorn->age();

Magic properties

If you add Witchcraft\MagicProperties trait you can use pretty properties., _(*7)

class Unicorn
{
    use \Witchcraft\MagicProperties;

    /* Rest of the code stays exactly the same. */
}

$unicorn = new Unicorn();
$unicorn->birthday = "1930-24-12";
$unicorn->color = "rainbow";
print $unicorn->age;

Dynamic methods

As a bonus you can dynamically assing methods to the object., _(*8)

$unicorn->something(function ($input) {
    return "Got {$input}!";
});

$unicorn->something("milk");

/* Got milk! */

$unicorn->something = function ($input) {
    return "No {$input} :(";
};

$unicorn->something("beer");

/* No beer :() */

Why?

Because I think getFoo() and setFoo("bar") are ugly., _(*9)

Testing

You can run tests either manually..., _(*10)

``` bash $ composer test, <sub>(*11)</sub>

... or automatically on every code change. You will need [entr](http://entrproject.org/) for this to work.

``` bash
$ brew install entr
$ composer watch

Contributing

Please see CONTRIBUTING for details., <sub>(*12)</sub>

Security

If you discover any security related issues, please email tuupola@appelsiini.net instead of using the issue tracker., <sub>(*13)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>