reaction's Introduction

Reaction Library

This library makes it easy to handle reactions of actions, methods and functions. If you are dealing with methods that can either be successful or fail and want more information about the result of the method, you can use a reaction.

Installation

You can install reaction using Composer:

$ composer require aaronmacaron/reaction

To install and use the reaction library you need PHP version 7.1 or newer.

Example

You can use this library as follows:

<?php

use Aaronmacaron\Reaction\Reaction;

include __DIR__ . "/vendor/autoload.php";

function validatePassword(string $password): Reaction
{
    if (empty($password)) {
        return Reaction::failure("The password must not be empty!");
    }

    if (strlen($password) >= 8) {
        return Reaction::success();
    }

    return Reaction::failure("The password must be at least eight chars long.");
}

validatePassword("secret")
    ->succeed(function () {
        echo "Password is valid" . PHP_EOL;
    })->fail(function (Reaction $reaction) {
        echo "The password is not valid: " . $reaction->getMessage() . PHP_EOL;
    });

// Output: The password is not valid: The password must be at least eight chars long.

reaction's People

Contributors

Stargazers

Watchers

reaction's Issues

Use case: chaining & collecting

Great little package, thanks!

I was wondering if the following is a valid use case for this package.

<?php

use Aaronmacaron\Reaction\Reaction;

include __DIR__ . "/vendor/autoload.php";

function validatePassword(string $password): Reaction
{
    if (empty($password)) {
        return Reaction::failure("The password must not be empty!");
    }
    if (strlen($password) >= 8) {
        return Reaction::success();
    }
    return Reaction::failure("The password must be at least eight chars long.");
}

function validateFoo(): Reaction
{
    return Reaction::failure("Foo failure");
}

function validateBar(): Reaction
{
    return Reaction::success("Bar success");
}

$succeed = [];
$errors = [];

validatePassword("secret")
    ->succeed(function () use (&$succeed) {
        $succeed[] = "Password is valid";
    })->fail(function (Reaction $reaction) use (&$errors) {
        $errors[] = "The password is not valid: " . $reaction->getMessage();
    });

validateFoo()->fail(function (Reaction $reaction) use (&$errors) {
    $errors[] = $reaction->getMessage();
});

validateBar()->succeed(function (Reaction $reaction) use (&$succeed) {
    $succeed[] = $reaction->getMessage();
});

echo "<pre>";
print_r($succeed);
print_r($errors);
echo "</pre>";