Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 3cc780956d |
10
README.md
10
README.md
@@ -2,8 +2,6 @@
|
||||
|
||||
This project contains PHP utility classes whose functionality is inspired by their F# counterparts.
|
||||
|
||||
The v2 series requires at least PHP 8.4. A similar API exists for PHP 8.2 - 8.3 in version 1 of this project; see its README for specifics.
|
||||
|
||||
## What It Provides
|
||||
|
||||
This early-stage library currently provides two classes, both of which are designed to wrap values and indicate the state of the action that produced them. `Option<T>` represents a variable that may or may not have a value. `Result<TOK, TError>` represents the result of an action; the "ok" and "error" states both provide a value.
|
||||
@@ -13,12 +11,12 @@ This early-stage library currently provides two classes, both of which are desig
|
||||
| **Creating** | `::Some(T)` for Some | `::OK(TOK)` for OK |
|
||||
| | `::None()` for None | `::Error(TError)` for Error |
|
||||
| | `::of($value)` _None if `null`_ | |
|
||||
| **Querying** | `->isSome: bool` | `->isOK: bool` |
|
||||
| | `->isNone: bool` | `->isError: bool` |
|
||||
| **Querying** | `->isSome(): bool` | `->isOK(): bool` |
|
||||
| | `->isNone(): bool` | `->isError(): bool` |
|
||||
| | `->contains(T, $strict = true): bool` | `->contains(TOK, $strict = true): bool` |
|
||||
| | `->exists(callable(T): bool): bool` | `->exists(callable(TOK): bool): bool` |
|
||||
| **Reading**<br> | `->value: T` | `->ok: TOK` |
|
||||
| _all throw if called on missing value_ | | `->error: TError` |
|
||||
| **Reading**<br> | `->get(): T` | `->getOK(): TOK` |
|
||||
| _all throw if called on missing value_ | | `->getError(): TError` |
|
||||
| **Transforming**<br> | `->map(callable(T): TMapped): Option<TMapped>` | `->map(callable(TOK): TMapped): Result<TMapped, TError>` |
|
||||
| _all still `Option` or `Result`_ | | `->mapError(callable(TError): TMapped): Result<TOK, TMapped>` |
|
||||
| **Iterating** | `->iter(callable(T): void): void` | `->iter(callable(TOK): void): void` |
|
||||
|
||||
@@ -17,7 +17,7 @@
|
||||
"rss": "https://git.bitbadger.solutions/bit-badger/inspired-by-fsharp.rss"
|
||||
},
|
||||
"require": {
|
||||
"php": ">=8.4"
|
||||
"php": "8.2 - 8.3"
|
||||
},
|
||||
"require-dev": {
|
||||
"phpoption/phpoption": "^1",
|
||||
|
||||
4
composer.lock
generated
4
composer.lock
generated
@@ -4,7 +4,7 @@
|
||||
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
|
||||
"This file is @generated automatically"
|
||||
],
|
||||
"content-hash": "993898f46125d481cf00405cbe9c4069",
|
||||
"content-hash": "87ff0fadc5082e5dfa570a11147687dd",
|
||||
"packages": [],
|
||||
"packages-dev": [
|
||||
{
|
||||
@@ -3826,7 +3826,7 @@
|
||||
"prefer-stable": false,
|
||||
"prefer-lowest": false,
|
||||
"platform": {
|
||||
"php": ">=8.4"
|
||||
"php": "8.2 - 8.3"
|
||||
},
|
||||
"platform-dev": [],
|
||||
"plugin-api-version": "2.6.0"
|
||||
|
||||
@@ -25,38 +25,50 @@ use InvalidArgumentException;
|
||||
*
|
||||
* @template T The type of value represented by this option
|
||||
*/
|
||||
class Option
|
||||
readonly class Option
|
||||
{
|
||||
/** @var T|null $value The value for this option */
|
||||
private mixed $val;
|
||||
private mixed $value;
|
||||
|
||||
/**
|
||||
* @param T|null $value The possibly null value for this option
|
||||
*/
|
||||
private function __construct(mixed $value = null)
|
||||
{
|
||||
$this->val = $value;
|
||||
$this->value = $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* @var T The value of this option (read-only)
|
||||
* @throws InvalidArgumentException If called on a `None` option
|
||||
* Get the value of this option
|
||||
*
|
||||
* @return T The value of the option
|
||||
*/
|
||||
public mixed $value {
|
||||
get => match ($this->val) {
|
||||
null => throw new InvalidArgumentException('Cannot get the value of a None option'),
|
||||
default => $this->val,
|
||||
public function get(): mixed
|
||||
{
|
||||
return match (true) {
|
||||
$this->isSome() => $this->value,
|
||||
default => throw new InvalidArgumentException('Cannot get the value of a None option'),
|
||||
};
|
||||
}
|
||||
|
||||
/** @var bool True if the option is `None`, false if it is `Some` */
|
||||
public bool $isNone {
|
||||
get => is_null($this->val);
|
||||
/**
|
||||
* Does this option have a `None` value?
|
||||
*
|
||||
* @return bool True if the option is `None`, false if it is `Some`
|
||||
*/
|
||||
public function isNone(): bool
|
||||
{
|
||||
return is_null($this->value);
|
||||
}
|
||||
|
||||
/** @var bool True if the option is `Some`, false if it is `None` */
|
||||
public bool $isSome{
|
||||
get => !$this->isNone;
|
||||
/**
|
||||
* Does this option have a `Some` value?
|
||||
*
|
||||
* @return bool True if the option is `Some`, false if it is `None`
|
||||
*/
|
||||
public function isSome(): bool
|
||||
{
|
||||
return !$this->isNone();
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -67,7 +79,7 @@ class Option
|
||||
*/
|
||||
public function getOrDefault(mixed $default): mixed
|
||||
{
|
||||
return $this->val ?? $default;
|
||||
return $this->value ?? $default;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -79,19 +91,18 @@ class Option
|
||||
*/
|
||||
public function getOrCall(callable $f): mixed
|
||||
{
|
||||
return $this->val ?? $f();
|
||||
return $this->value ?? $f();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the value, or throw the exception using the given function
|
||||
*
|
||||
* Get the value, or throw the
|
||||
* @param callable(): Exception $exFunc A function to construct the exception to throw
|
||||
* @return T The value of the option if `Some`
|
||||
* @throws Exception If the option is `None`
|
||||
*/
|
||||
public function getOrThrow(callable $exFunc): mixed
|
||||
{
|
||||
return $this->val ?? throw $exFunc();
|
||||
return $this->value ?? throw $exFunc();
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -106,7 +117,7 @@ class Option
|
||||
*/
|
||||
public function bind(callable $f): Option
|
||||
{
|
||||
return $this->isNone ? $this : $f($this->val);
|
||||
return $this->isNone() ? $this : $f($this->get());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -119,8 +130,8 @@ class Option
|
||||
public function contains(mixed $value, bool $strict = true): bool
|
||||
{
|
||||
return match (true) {
|
||||
$this->isNone => false,
|
||||
default => $strict ? $this->val === $value : $this->val == $value,
|
||||
$this->isNone() => false,
|
||||
default => $strict ? $this->value === $value : $this->value == $value,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -132,7 +143,7 @@ class Option
|
||||
*/
|
||||
public function exists(callable $f): bool
|
||||
{
|
||||
return $this->isSome ? $f($this->val) : false;
|
||||
return $this->isSome() ? $f($this->value) : false;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -144,7 +155,7 @@ class Option
|
||||
*/
|
||||
public function map(callable $f): self
|
||||
{
|
||||
return $this->isSome ? self::Some($f($this->val)) : $this;
|
||||
return $this->isSome() ? self::Some($f($this->get())) : $this;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -154,8 +165,8 @@ class Option
|
||||
*/
|
||||
public function iter(callable $f): void
|
||||
{
|
||||
if ($this->isSome) {
|
||||
$f($this->val);
|
||||
if ($this->isSome()) {
|
||||
$f($this->value);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -167,7 +178,7 @@ class Option
|
||||
*/
|
||||
public function filter(callable $f): self
|
||||
{
|
||||
return $this->isNone || $this->exists($f) ? $this : self::None();
|
||||
return $this->isNone() || $this->exists($f) ? $this : self::None();
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -177,7 +188,7 @@ class Option
|
||||
*/
|
||||
public function unwrap(): mixed
|
||||
{
|
||||
return $this->val;
|
||||
return $this->value;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -199,7 +210,7 @@ class Option
|
||||
*/
|
||||
public function toArray(): array
|
||||
{
|
||||
return $this->isSome ? [$this->val] : [];
|
||||
return $this->isSome() ? [$this->value] : [];
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -210,8 +221,8 @@ class Option
|
||||
public function toPhpOption(): mixed
|
||||
{
|
||||
return match (true) {
|
||||
$this->isNone && class_exists('PhpOption\None') => call_user_func('PhpOption\None::create'),
|
||||
class_exists('PhpOption\Some') => call_user_func('PhpOption\Some::create', $this->val),
|
||||
$this->isNone() && class_exists('PhpOption\None') => call_user_func('PhpOption\None::create'),
|
||||
class_exists('PhpOption\Some') => call_user_func('PhpOption\Some::create', $this->value),
|
||||
default => throw new Error('PhpOption types could not be found'),
|
||||
};
|
||||
}
|
||||
@@ -250,7 +261,7 @@ class Option
|
||||
{
|
||||
return match (true) {
|
||||
is_object($value) && is_a($value, 'PhpOption\Option') =>
|
||||
$value->isDefined() ? self::Some($value->get()) : self::None(),
|
||||
$value->isDefined() ? self::Some($value->get()) : self::None(),
|
||||
default => new self($value),
|
||||
};
|
||||
}
|
||||
|
||||
@@ -25,7 +25,7 @@ use InvalidArgumentException;
|
||||
* @template TOK The type of the OK result
|
||||
* @template TError The type of the error result
|
||||
*/
|
||||
class Result
|
||||
readonly class Result
|
||||
{
|
||||
/** @var Option<TOK> The OK value for this result */
|
||||
private Option $okValue;
|
||||
@@ -45,24 +45,46 @@ class Result
|
||||
$this->errorValue = Option::of($errorValue);
|
||||
}
|
||||
|
||||
/** @var TOK The OK value (will throw if result is not OK) */
|
||||
public mixed $ok {
|
||||
get => $this->okValue->value;
|
||||
/**
|
||||
* Get the value for an `OK` result
|
||||
*
|
||||
* @return TOK The OK value for this result
|
||||
* @throws InvalidArgumentException If the result is an `Error` result
|
||||
*/
|
||||
public function getOK(): mixed
|
||||
{
|
||||
return $this->okValue->get();
|
||||
}
|
||||
|
||||
/** @var TError The error value (will throw if result is not Error) */
|
||||
public mixed $error {
|
||||
get => $this->errorValue->value;
|
||||
/**
|
||||
* Get the value for an `Error` result
|
||||
*
|
||||
* @return TError The error value for this result
|
||||
* @throws InvalidArgumentException If the result is an `OK` result
|
||||
*/
|
||||
public function getError(): mixed
|
||||
{
|
||||
return $this->errorValue->get();
|
||||
}
|
||||
|
||||
/** @var bool True if the result is `OK`, false if it is `Error` */
|
||||
public bool $isOK {
|
||||
get => $this->okValue->isSome;
|
||||
/**
|
||||
* Is this result `OK`?
|
||||
*
|
||||
* @return bool True if the result is `OK`, false if it is `Error`
|
||||
*/
|
||||
public function isOK(): bool
|
||||
{
|
||||
return $this->okValue->isSome();
|
||||
}
|
||||
|
||||
/** @var bool True if the result is `Error`, false if it is `OK` */
|
||||
public bool $isError {
|
||||
get => $this->errorValue->isSome;
|
||||
/**
|
||||
* Is this result `Error`?
|
||||
*
|
||||
* @return bool True if the result is `Error`, false if it is `OK`
|
||||
*/
|
||||
public function isError(): bool
|
||||
{
|
||||
return $this->errorValue->isSome();
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -78,7 +100,7 @@ class Result
|
||||
*/
|
||||
public function bind(callable $f): Result
|
||||
{
|
||||
return $this->isError ? $this : $f($this->ok);
|
||||
return $this->isError() ? $this : $f($this->getOK());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -91,8 +113,8 @@ class Result
|
||||
public function contains(mixed $value, bool $strict = true): bool
|
||||
{
|
||||
return match (true) {
|
||||
$this->isError => false,
|
||||
default => $this->okValue->contains($value, $strict),
|
||||
$this->isError() => false,
|
||||
default => $this->okValue->contains($value, $strict),
|
||||
};
|
||||
}
|
||||
|
||||
@@ -104,7 +126,7 @@ class Result
|
||||
*/
|
||||
public function exists(callable $f): bool
|
||||
{
|
||||
return $this->isOK ? $f($this->ok) : false;
|
||||
return $this->isOK() ? $f($this->okValue->get()) : false;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -116,7 +138,7 @@ class Result
|
||||
*/
|
||||
public function map(callable $f): self
|
||||
{
|
||||
return $this->isOK ? self::OK($f($this->ok)) : $this;
|
||||
return $this->isOK() ? self::OK($f($this->getOK())) : $this;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -128,7 +150,7 @@ class Result
|
||||
*/
|
||||
public function mapError(callable $f): self
|
||||
{
|
||||
return $this->isError ? self::Error($f($this->error)) : $this;
|
||||
return $this->isError() ? self::Error($f($this->getError())) : $this;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -138,8 +160,8 @@ class Result
|
||||
*/
|
||||
public function iter(callable $f): void
|
||||
{
|
||||
if ($this->isOK) {
|
||||
$f($this->ok);
|
||||
if ($this->isOK()) {
|
||||
$f($this->getOK());
|
||||
}
|
||||
}
|
||||
|
||||
@@ -160,7 +182,7 @@ class Result
|
||||
*/
|
||||
public function toOption(): Option
|
||||
{
|
||||
return $this->isOK ? Option::Some($this->ok) : Option::None();
|
||||
return $this->isOK() ? Option::Some($this->getOK()) : Option::None();
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -9,30 +9,30 @@ declare(strict_types=1);
|
||||
use BitBadger\InspiredByFSharp\Option;
|
||||
use PhpOption\{None, Some};
|
||||
|
||||
describe('->value', function () {
|
||||
describe('->get()', function () {
|
||||
test('retrieves the value for Some', function () {
|
||||
expect(Option::Some(9)->value)->toBe(9);
|
||||
expect(Option::Some(9)->get())->toBe(9);
|
||||
});
|
||||
test('throws an exception for None', function () {
|
||||
expect(fn() => Option::None()->value)->toThrow(InvalidArgumentException::class);
|
||||
expect(fn() => Option::None()->get())->toThrow(InvalidArgumentException::class);
|
||||
});
|
||||
});
|
||||
|
||||
describe('->isNone', function () {
|
||||
describe('->isNone()', function () {
|
||||
test('returns true for None', function () {
|
||||
expect(Option::None()->isNone)->toBeTrue();
|
||||
expect(Option::None()->isNone())->toBeTrue();
|
||||
});
|
||||
test('returns false for Some', function () {
|
||||
expect(Option::Some(8)->isNone)->toBeFalse();
|
||||
expect(Option::Some(8)->isNone())->toBeFalse();
|
||||
});
|
||||
});
|
||||
|
||||
describe('->isSome', function () {
|
||||
describe('->isSome()', function () {
|
||||
test('returns false for None', function () {
|
||||
expect(Option::None()->isSome)->toBeFalse();
|
||||
expect(Option::None()->isSome())->toBeFalse();
|
||||
});
|
||||
test('returns true for Some', function () {
|
||||
expect(Option::Some('boo')->isSome)->toBeTrue();
|
||||
expect(Option::Some('boo')->isSome())->toBeTrue();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -68,14 +68,14 @@ describe('->bind()', function () {
|
||||
test('returns None when binding against None', function () {
|
||||
$original = Option::None();
|
||||
$bound = $original->bind(fn($it) => Option::Some('value'));
|
||||
expect($bound)->isNone->toBeTrue()->and($bound)->toBe($original);
|
||||
expect($bound)->isNone()->toBeTrue()->and($bound)->toBe($original);
|
||||
});
|
||||
test('returns Some when binding against Some with Some', function () {
|
||||
expect(Option::Some('hello')->bind(fn($it) => Option::Some('goodbye')))
|
||||
->isSome->toBeTrue()->value->toBe('goodbye');
|
||||
->isSome()->toBeTrue()->get()->toBe('goodbye');
|
||||
});
|
||||
test('returns None when binding against Some with None', function () {
|
||||
expect(Option::Some('greetings')->bind(fn($it) => Option::None()))->isNone->toBeTrue();
|
||||
expect(Option::Some('greetings')->bind(fn($it) => Option::None()))->isNone()->toBeTrue();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -119,13 +119,13 @@ describe('->map()', function () {
|
||||
return 'hello';
|
||||
});
|
||||
expect($mapped)
|
||||
->isNone->toBeTrue()
|
||||
->isNone()->toBeTrue()
|
||||
->and($tattle->called)->toBeFalse()
|
||||
->and($mapped)->toBe($none);
|
||||
});
|
||||
test('maps value for Some', function () {
|
||||
expect(Option::Some('abc ')->map(fn($it) => str_repeat($it, 2)))
|
||||
->isSome->toBeTrue()->value->toBe('abc abc ');
|
||||
->isSome()->toBeTrue()->get()->toBe('abc abc ');
|
||||
});
|
||||
test('throws an exception if mapping returns null', function () {
|
||||
expect(fn() => Option::Some('oof')->map(fn($it) => null))->toThrow(InvalidArgumentException::class);
|
||||
@@ -155,7 +155,7 @@ describe('->filter()', function () {
|
||||
return true;
|
||||
});
|
||||
expect($filtered)
|
||||
->isNone->toBeTrue()
|
||||
->isNone()->toBeTrue()
|
||||
->and($tattle->called)->toBeFalse()
|
||||
->and($filtered)->toBe($none);
|
||||
});
|
||||
@@ -163,12 +163,12 @@ describe('->filter()', function () {
|
||||
$some = Option::Some(12);
|
||||
$filtered = $some->filter(fn($it) => $it % 2 === 0);
|
||||
expect($filtered)
|
||||
->isSome->toBeTrue()
|
||||
->value->toBe(12)
|
||||
->isSome()->toBeTrue()
|
||||
->get()->toBe(12)
|
||||
->and($filtered)->toBe($some);
|
||||
});
|
||||
test('returns None when filter is not matched', function () {
|
||||
expect(Option::Some(23)->filter(fn($it) => $it % 2 === 0)->isNone)->toBeTrue();
|
||||
expect(Option::Some(23)->filter(fn($it) => $it % 2 === 0)->isNone())->toBeTrue();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -186,14 +186,14 @@ describe('->tap()', function () {
|
||||
$value = '';
|
||||
$original = Option::None();
|
||||
$tapped = $original->tap(
|
||||
function (Option $it) use (&$value) { $value = $it->isSome ? $it->value : 'none'; });
|
||||
function (Option $it) use (&$value) { $value = $it->isSome() ? $it->get() : 'none'; });
|
||||
expect($value)->toBe('none')->and($original)->toBe($tapped);
|
||||
});
|
||||
test('is called for Some', function () {
|
||||
$value = '';
|
||||
$original = Option::Some('testing');
|
||||
$tapped = $original->tap(
|
||||
function (Option $it) use (&$value) { $value = $it->isSome ? $it->value : 'none'; });
|
||||
function (Option $it) use (&$value) { $value = $it->isSome() ? $it->get() : 'none'; });
|
||||
expect($value)->toBe('testing')->and($original)->toBe($tapped);
|
||||
});
|
||||
});
|
||||
@@ -225,7 +225,7 @@ describe('->toPhpOption()', function () {
|
||||
|
||||
describe('::Some()', function () {
|
||||
test('creates a Some option when given a value', function () {
|
||||
expect(Option::Some('hello'))->not->toBeNull()->isSome->toBeTrue();
|
||||
expect(Option::Some('hello'))->not->toBeNull()->isSome()->toBeTrue();
|
||||
});
|
||||
test('throws an exception when given null', function () {
|
||||
expect(fn() => Option::Some(null))->toThrow(InvalidArgumentException::class);
|
||||
@@ -234,23 +234,23 @@ describe('::Some()', function () {
|
||||
|
||||
describe('::None()', function () {
|
||||
test('creates a None option', function () {
|
||||
expect(Option::None())->not->toBeNull()->isNone->toBeTrue();
|
||||
expect(Option::None())->not->toBeNull()->isNone()->toBeTrue();
|
||||
});
|
||||
});
|
||||
|
||||
describe('::of()', function () {
|
||||
test('creates a None option when given null', function () {
|
||||
expect(Option::of(null))->not->toBeNull()->isNone->toBeTrue();
|
||||
expect(Option::of(null))->not->toBeNull()->isNone()->toBeTrue();
|
||||
});
|
||||
test('creates a Some option when given a value', function () {
|
||||
expect(Option::of('test'))->not->toBeNull()
|
||||
->isSome->toBeTrue()
|
||||
->value->toBe('test');
|
||||
->isSome()->toBeTrue()
|
||||
->get()->toBe('test');
|
||||
});
|
||||
test('creates a None option when given PhpOption\None', function () {
|
||||
expect(Option::of(None::create()))->isNone->toBeTrue();
|
||||
expect(Option::of(None::create()))->isNone()->toBeTrue();
|
||||
});
|
||||
test('creates a Some option when given PhpOption\Some', function () {
|
||||
expect(Option::of(Some::create('something')))->isSome->toBeTrue()->value->toBe('something');
|
||||
expect(Option::of(Some::create('something')))->isSome()->toBeTrue()->get()->toBe('something');
|
||||
});
|
||||
});
|
||||
|
||||
@@ -8,55 +8,55 @@ declare(strict_types=1);
|
||||
|
||||
use BitBadger\InspiredByFSharp\{Option, Result};
|
||||
|
||||
describe('->ok', function () {
|
||||
describe('->getOK()', function () {
|
||||
test('returns OK value for OK result', function () {
|
||||
expect(Result::OK('yay')->ok)->toBe('yay');
|
||||
expect(Result::OK('yay')->getOK())->toBe('yay');
|
||||
});
|
||||
test('throws an exception for Error result', function () {
|
||||
expect(fn() => Result::Error('whoops')->ok)->toThrow(InvalidArgumentException::class);
|
||||
expect(fn() => Result::Error('whoops')->getOK())->toThrow(InvalidArgumentException::class);
|
||||
});
|
||||
});
|
||||
|
||||
describe('->error', function () {
|
||||
describe('->getError()', function () {
|
||||
test('throws an exception for OK result', function () {
|
||||
expect(fn() => Result::OK('yeah')->error)->toThrow(InvalidArgumentException::class);
|
||||
expect(fn() => Result::OK('yeah')->getError())->toThrow(InvalidArgumentException::class);
|
||||
});
|
||||
test('returns Error value for Error result', function () {
|
||||
expect(Result::Error('boo')->error)->toBe('boo');
|
||||
expect(Result::Error('boo')->getError())->toBe('boo');
|
||||
});
|
||||
});
|
||||
|
||||
describe('->isOK', function () {
|
||||
describe('->isOK()', function () {
|
||||
test('returns true for OK result', function () {
|
||||
expect(Result::OK('ok')->isOK)->toBeTrue();
|
||||
expect(Result::OK('ok')->isOK())->toBeTrue();
|
||||
});
|
||||
test('returns false for Error result', function () {
|
||||
expect(Result::Error('error')->isOK)->toBeFalse();
|
||||
expect(Result::Error('error')->isOK())->toBeFalse();
|
||||
});
|
||||
});
|
||||
|
||||
describe('->isError', function () {
|
||||
describe('->isError()', function () {
|
||||
test('returns false for OK result', function () {
|
||||
expect(Result::OK('fine')->isError)->toBeFalse();
|
||||
expect(Result::OK('fine')->isError())->toBeFalse();
|
||||
});
|
||||
test('returns true for Error result', function () {
|
||||
expect(Result::Error('not ok')->isError)->toBeTrue();
|
||||
expect(Result::Error('not ok')->isError())->toBeTrue();
|
||||
});
|
||||
});
|
||||
|
||||
describe('->bind()', function () {
|
||||
test('returns OK when binding against OK with OK', function () {
|
||||
expect(Result::OK('one')->bind(fn($it) => Result::OK("$it two")))
|
||||
->isOK->toBeTrue()->ok->toBe('one two');
|
||||
->isOK()->toBeTrue()->getOK()->toBe('one two');
|
||||
});
|
||||
test('returns Error when binding against OK with Error', function () {
|
||||
expect(Result::OK('three')->bind(fn($it) => Result::Error('back to two')))
|
||||
->isError->toBeTrue()->error->toBe('back to two');
|
||||
->isError()->toBeTrue()->getError()->toBe('back to two');
|
||||
});
|
||||
test('returns Error when binding against Error', function () {
|
||||
$original = Result::Error('oops');
|
||||
$result = $original->bind(fn($it) => Result::OK('never mind - it worked!'));
|
||||
expect($result->isError)->toBeTrue()
|
||||
expect($result->isError())->toBeTrue()
|
||||
->and($result)->toBe($original);
|
||||
});
|
||||
});
|
||||
@@ -94,7 +94,7 @@ describe('->exists()', function () {
|
||||
describe('->map()', function () {
|
||||
test('maps value for OK', function () {
|
||||
expect(Result::OK('yard')->map(fn($it) => strrev($it)))
|
||||
->isOK->toBeTrue()->ok->toBe('dray');
|
||||
->isOK()->toBeTrue()->getOK()->toBe('dray');
|
||||
});
|
||||
test('throws an exception for OK when mapping result is null', function () {
|
||||
expect(fn() => Result::OK('not null')->map(fn($it) => null))->toThrow(InvalidArgumentException::class);
|
||||
@@ -108,7 +108,7 @@ describe('->map()', function () {
|
||||
return 'hello';
|
||||
});
|
||||
expect($mapped)
|
||||
->isError->toBeTrue()
|
||||
->isError()->toBeTrue()
|
||||
->and($tattle->called)->toBeFalse()
|
||||
->and($mapped)->toBe($error);
|
||||
});
|
||||
@@ -124,13 +124,13 @@ describe('->mapError()', function () {
|
||||
return 'hello';
|
||||
});
|
||||
expect($mapped)
|
||||
->isOK->toBeTrue()
|
||||
->isOK()->toBeTrue()
|
||||
->and($tattle->called)->toBeFalse()
|
||||
->and($mapped)->toBe($ok);
|
||||
});
|
||||
test('maps value for Error', function () {
|
||||
expect(Result::Error('taco')->mapError(fn($it) => str_repeat('*', strlen($it))))
|
||||
->isError->toBeTrue()->error->toBe('****');
|
||||
->isError()->toBeTrue()->getError()->toBe('****');
|
||||
});
|
||||
test('throws an exception for Error when mapping result is null', function () {
|
||||
expect(fn() => Result::Error('pizza')->mapError(fn($it) => null))->toThrow(InvalidArgumentException::class);
|
||||
@@ -161,10 +161,10 @@ describe('->toArray()', function () {
|
||||
|
||||
describe('->toOption()', function () {
|
||||
test('returns a Some option for OK', function () {
|
||||
expect(Result::OK(99)->toOption())->isSome->toBeTrue()->value->toBe(99);
|
||||
expect(Result::OK(99)->toOption())->isSome()->toBeTrue()->get()->toBe(99);
|
||||
});
|
||||
test('returns a None option for Error', function () {
|
||||
expect(Result::Error('file not found')->toOption())->isNone->toBeTrue();
|
||||
expect(Result::Error('file not found')->toOption())->isNone()->toBeTrue();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -173,7 +173,7 @@ describe('->tap()', function () {
|
||||
$value = '';
|
||||
$original = Result::OK('working');
|
||||
$tapped = $original->tap(function (Result $it) use (&$value) {
|
||||
$value = $it->isOK ? 'OK: ' . $it->ok : 'Error: ' . $it->error;
|
||||
$value = $it->isOK() ? 'OK: ' . $it->getOK() : 'Error: ' . $it->getError();
|
||||
});
|
||||
expect($value)->toBe('OK: working')->and($tapped)->toBe($original);
|
||||
});
|
||||
@@ -181,7 +181,7 @@ describe('->tap()', function () {
|
||||
$value = '';
|
||||
$original = Result::Error('failed');
|
||||
$tapped = $original->tap(function (Result $it) use (&$value) {
|
||||
$value = $it->isOK ? 'OK: ' . $it->ok : 'Error: ' . $it->error;
|
||||
$value = $it->isOK() ? 'OK: ' . $it->getOK() : 'Error: ' . $it->getError();
|
||||
});
|
||||
expect($value)->toBe('Error: failed')->and($tapped)->toBe($original);
|
||||
});
|
||||
@@ -189,7 +189,7 @@ describe('->tap()', function () {
|
||||
|
||||
describe('::OK()', function () {
|
||||
test('creates an OK result for a non-null value', function () {
|
||||
expect(Result::OK('something'))->isOK->toBeTrue()->ok->toBe('something');
|
||||
expect(Result::OK('something'))->isOK()->toBeTrue()->getOK()->toBe('something');
|
||||
});
|
||||
test('throws an exception for OK with a null value', function () {
|
||||
expect(fn() => Result::OK(null))->toThrow(InvalidArgumentException::class);
|
||||
@@ -198,7 +198,7 @@ describe('::OK()', function () {
|
||||
|
||||
describe('::Error()', function () {
|
||||
test('creates an Error result for a non-null value', function () {
|
||||
expect(Result::Error('sad trombone'))->isError->toBeTrue()->error->toBe('sad trombone');
|
||||
expect(Result::Error('sad trombone'))->isError()->toBeTrue()->getError()->toBe('sad trombone');
|
||||
});
|
||||
test('throws an exception for Error with a null value', function () {
|
||||
expect(fn() => Result::Error(null))->toThrow(InvalidArgumentException::class);
|
||||
|
||||
Reference in New Issue
Block a user