Introduce Result\try_catch shortcut

[veewee]

Inspired on ramda's tryCatch function:
https://ramdajs.com/docs/#tryCatch

tryCatch takes two functions, a tryer and a catcher. The returned function evaluates the tryer; if it does not throw, it simply returns the result. If the tryer does throw, the returned function evaluates the catcher function and returns its result.

It can be seen as a shortcut for dealing with code that you know might error, for which you want to continue the flow with e.g. a default or calculated default value.

For example:

$nullable_entity = Result\try_catch(
    static fn (): MyEntity => $repo->fetchById(1),
    static fn (): ?MyEntity => null,
);

I decided not to go the Fun way as it is in ramda, since it would require another dynamic psalm plugin.
Instead, you could make it composable yourself like this:

$tryFetchById = static fn(int $id): ?MyEntity => Result\try_catch(
    static fn (): MyEntity => $repo->fetchById($id),
    static fn (): ?MyEntity => null,
);

It also works fine with Option\from_nullable() as you can from the examples above.

❗ Note: I inlined the PromiseInterface methods into the ResultInterface and made sure the return type for them is ResultInterface. Otherwise psalm thinks ResultInterface::catch() (and others) returns a PromiseInterface instead of a ResultInterface.

[coveralls]

Pull Request Test Coverage Report for Build 4294599427

• 1 of 1 (100.0%) changed or added relevant line in 1 file are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage increased (+0.0002%) to 99.125%

---

Totals
Change from base Build 4015321512:	0.0002%
Covered Lines:	3967
Relevant Lines:	4002

---

💛 - Coveralls

[azjezz]

looks awesome!