someniatko / result-type
Functional-ish generic Result type: either Success or Error
Installs: 1 576
Dependents: 1
Suggesters: 0
Security: 0
Stars: 4
Watchers: 4
Forks: 0
Open Issues: 0
Requires
- php: 7.4.* || 8.0.* || 8.1.* || 8.2.*
Requires (Dev)
- phpunit/phpunit: ^9.5
- psalm/plugin-phpunit: ^0.17
- squizlabs/php_codesniffer: ^3.6
- vimeo/psalm: ^4.7
This package is auto-updated.
Last update: 2024-10-20 13:59:59 UTC
README
Library representing a generic Result type with Success and Error states, made for aiding this functional programming pattern in PHP.
It is generically typed using Psalm annotations, so you are expected to use Psalm if you want typechecking of your code.
Why using this library if graham-campbell/result-type
exists?
Unfortunately, there are several downsides of that library:
- while it's also typed with Psalm annotations, actually using and checking against them might be painful.
- it's coupled to the
phpoption/phpoption
library which unfortunately suffers from the same problem. - there is no convenience method in Result interface which would allow getting either value from it.
Works best with someniatko/result-type-psalm-plugin
!
Installation
This library requires PHP 7.4, 8.0, 8.1 or 8.2. You can install it via Composer:
composer install someniatko/result-type
Usage
See ResultInterface
for details.
Example:
<?php use Someniatko\ResultType\Success; use Someniatko\ResultType\Error; $value = (new Success('Let it be')) ->map(fn (string $s) => substr_count($s, ' ')) // Success<2> ->chain(fn (int $wordsCount) => $wordsCount > 3 ? new Success('Long text') : new Error('short text') ) // Error<'short text'> ->map(fn (string $s) => str_replace(' ', '', $s)) // will not be called because we're in Error result ->mapError(fn (string $s) => strtoupper($s)) // Error<'SHORT TEXT'> ->get(); // 'SHORT TEXT'