create-berna-stencil 2.0.13 → 2.0.15

package/src/backend/_core/vendor/phpoption/phpoption/README.md

@@ -1,201 +0,0 @@
-# PHP Option Type
-
-This package implements the Option type for PHP!
-
-![Banner](https://user-images.githubusercontent.com/2829600/71564011-3077bf00-2a91-11ea-9083-905702cc262b.png)
-
-<p align="center">
-<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-brightgreen.svg?style=flat-square" alt="Software License"></img></a>
-<a href="https://packagist.org/packages/phpoption/phpoption"><img src="https://img.shields.io/packagist/dt/phpoption/phpoption.svg?style=flat-square" alt="Total Downloads"></img></a>
-<a href="https://github.com/schmittjoh/php-option/releases"><img src="https://img.shields.io/github/release/schmittjoh/php-option.svg?style=flat-square" alt="Latest Version"></img></a>
-</p>
-
-<div align="center">
-
-**Special thanks to [our sponsors](https://github.com/sponsors/GrahamCampbell)**
-
-<hr>
-</div>
-
-
-## Motivation
-
-The Option type is intended for cases where you sometimes might return a value
-(typically an object), and sometimes you might return a base value (typically
-null) depending on arguments, or other runtime factors.
-
-Often times, you forget to handle the case where a base value should be
-returned. Not intentionally of course, but maybe you did not account for all
-possible states of the system; or maybe you indeed covered all cases, then time
-goes on, code is refactored, some of these your checks might become invalid, or
-incomplete. Suddenly, without noticing, the base value case is not handled
-anymore. As a result, you might sometimes get fatal PHP errors telling you that
-you called a method on a non-object; users might see blank pages, or worse.
-
-On one hand, the Option type forces a developer to consciously think about both
-cases (returning a value, or returning a base value). That in itself will
-already make your code more robust. On the other hand, the Option type also
-allows the API developer to provide more concise API methods, and empowers the
-API user in how he consumes these methods.
-
-
-## Installation
-
-Installation is super-easy via [Composer](https://getcomposer.org/):
-
-```bash
-$ composer require phpoption/phpoption
-```
-
-or add it by hand to your `composer.json` file.
-
-
-## Usage
-
-### Using the Option Type in your API
-
-```php
-class MyRepository
-{
-    public function findSomeEntity($criteria): \PhpOption\Option
-    {
-        if (null !== $entity = $this->em->find(...)) {
-            return new \PhpOption\Some($entity);
-        }
-
-        // We use a singleton, for the None case.
-        return \PhpOption\None::create();
-    }
-}
-```
-
-If you are consuming an existing library, you can also use a shorter version
-which by default treats `null` as `None`, and everything else as `Some` case:
-
-```php
-class MyRepository
-{
-    public function findSomeEntity($criteria): \PhpOption\Option
-    {
-        return \PhpOption\Option::fromValue($this->em->find(...));
-
-        // or, if you want to change the none value to false for example:
-        return \PhpOption\Option::fromValue($this->em->find(...), false);
-    }
-}
-```
-
-### Case 1: You always Require an Entity in Calling Code
-
-```php
-$entity = $repo->findSomeEntity(...)->get(); // returns entity, or throws exception
-```
-
-### Case 2: Fallback to Default Value If Not Available
-
-```php
-$entity = $repo->findSomeEntity(...)->getOrElse(new Entity());
-
-// Or, if you want to lazily create the entity.
-$entity = $repo->findSomeEntity(...)->getOrCall(function() {
-    return new Entity();
-});
-```
-
-## More Examples
-
-### No More Boiler Plate Code
-
-```php
-// Before
-$entity = $this->findSomeEntity();
-if (null === $entity) {
-    throw new NotFoundException();
-}
-echo $entity->name;
-
-// After
-echo $this->findSomeEntity()->get()->name;
-```
-
-### No More Control Flow Exceptions
-
-```php
-// Before
-try {
-    $entity = $this->findSomeEntity();
-} catch (NotFoundException $ex) {
-    $entity = new Entity();
-}
-
-// After
-$entity = $this->findSomeEntity()->getOrElse(new Entity());
-```
-
-### More Concise Null Handling
-
-```php
-// Before
-$entity = $this->findSomeEntity();
-if (null === $entity) {
-    return new Entity();
-}
-
-return $entity;
-
-// After
-return $this->findSomeEntity()->getOrElse(new Entity());
-```
-
-### Trying Multiple Alternative Options
-
-If you'd like to try multiple alternatives, the `orElse` method allows you to
-do this very elegantly:
-
-```php
-return $this->findSomeEntity()
-    ->orElse($this->findSomeOtherEntity())
-    ->orElse($this->createEntity());
-```
-The first option which is non-empty will be returned. This is especially useful 
-with lazy-evaluated options, see below.
-
-### Lazy-Evaluated Options
-
-The above example has the flaw that we would need to evaluate all options when
-the method is called which creates unnecessary overhead if the first option is 
-already non-empty.
-
-Fortunately, we can easily solve this by using the `LazyOption` class:
-
-```php
-return $this->findSomeEntity()
-    ->orElse(new LazyOption(array($this, 'findSomeOtherEntity')))
-    ->orElse(new LazyOption(array($this, 'createEntity')));
-```
-
-This way, only the options that are necessary will actually be evaluated.
-
-## Performance Considerations
-
-Of course, performance is important. Attached is a performance benchmark which
-you can run on a machine of your choosing. The overhead incurred by the Option
-type comes down to the time that it takes to create one object, our wrapper,
-and one additional method call to retrieve the value from the wrapper. Unless
-you plan to call a method thousands of times during a request, there is no
-reason to stick to the `object|null` return value; better give your code some
-options!
-
-## Security
-
-If you discover a security vulnerability within this package, please send an email to security@tidelift.com. All security vulnerabilities will be promptly addressed. You may view our full security policy [here](https://github.com/schmittjoh/php-option/security/policy).
-
-## License
-
-PHP Option Type is licensed under [Apache License 2.0](LICENSE).
-
-## For Enterprise
-
-Available as part of the Tidelift Subscription
-
-The maintainers of `phpoption/phpoption` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/packagist-phpoption-phpoption?utm_source=packagist-phpoption-phpoption&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

package/src/backend/_core/vendor/phpoption/phpoption/phpstan-baseline.neon

@@ -1,44 +0,0 @@
-parameters:
-	ignoreErrors:
-		-
-			message: '#^Call to function is_callable\(\) with callable\(mixed \.\.\.\)\: PhpOption\\Option\<T\> will always evaluate to true\.$#'
-			identifier: function.alreadyNarrowedType
-			count: 1
-			path: src/PhpOption/LazyOption.php
-
-		-
-			message: '#^Method PhpOption\\Option\:\:ensure\(\) should return PhpOption\\Option\<S\> but returns PhpOption\\LazyOption\<mixed\>\.$#'
-			identifier: return.type
-			count: 1
-			path: src/PhpOption/Option.php
-
-		-
-			message: '#^Method PhpOption\\Option\:\:fromReturn\(\) has parameter \$arguments with no value type specified in iterable type array\.$#'
-			identifier: missingType.iterableValue
-			count: 1
-			path: src/PhpOption/Option.php
-
-		-
-			message: '#^Method PhpOption\\Option\:\:fromReturn\(\) should return PhpOption\\LazyOption\<S\> but returns PhpOption\\LazyOption\<mixed\>\.$#'
-			identifier: return.type
-			count: 1
-			path: src/PhpOption/Option.php
-
-		-
-			message: '#^Parameter \#1 \$callback of function array_map expects \(callable\(mixed\)\: mixed\)\|null, Closure\(PhpOption\\Option\)\: T given\.$#'
-			identifier: argument.type
-			count: 1
-			path: src/PhpOption/Option.php
-
-		-
-			message: '#^Parameter \#2 \$callback of function array_reduce expects callable\(bool\|TReturn, mixed\)\: \(bool\|TReturn\), Closure\(mixed, PhpOption\\Option\)\: \(bool\|TReturn\) given\.$#'
-			identifier: argument.type
-			count: 1
-			path: src/PhpOption/Option.php
-
-		-
-			message: '#^Template type S of method PhpOption\\Option\:\:lift\(\) is not referenced in a parameter\.$#'
-			identifier: method.templateTypeNotInParameter
-			count: 1
-			path: src/PhpOption/Option.php
-

package/src/backend/_core/vendor/phpoption/phpoption/phpstan.neon.dist

@@ -1,7 +0,0 @@
-includes:
-    - phpstan-baseline.neon
-
-parameters:
-    level: max
-    paths:
-        - src

package/src/backend/_core/vendor/phpoption/phpoption/phpunit.xml.dist

@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" backupGlobals="false" beStrictAboutTestsThatDoNotTestAnything="true" beStrictAboutOutputDuringTests="true" bootstrap="tests/bootstrap.php" colors="true" failOnRisky="true" failOnWarning="true" processIsolation="false" stopOnError="false" stopOnFailure="false" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.4/phpunit.xsd">
-  <testsuites>
-    <testsuite name="PhpOption Type Test Suite">
-      <directory>./tests/PhpOption/</directory>
-    </testsuite>
-  </testsuites>
-  <groups>
-    <exclude>
-      <group>performance</group>
-    </exclude>
-  </groups>
-</phpunit>

package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/EnsureTest.php

@@ -1,72 +0,0 @@
-<?php
-
-namespace PhpOption\Tests;
-
-use PhpOption\None;
-use PhpOption\Option;
-use PhpOption\Some;
-use PHPUnit\Framework\TestCase;
-
-class EnsureTest extends TestCase
-{
-    private static function ensure($value, $noneValue = null): Option
-    {
-        $option = Option::ensure($value, $noneValue);
-        self::assertInstanceOf(Option::class, $option);
-
-        return $option;
-    }
-
-    public function testMixedValue(): void
-    {
-        $option = self::ensure(1);
-        self::assertTrue($option->isDefined());
-        self::assertSame(1, $option->get());
-        self::assertFalse(self::ensure(null)->isDefined());
-        self::assertFalse(self::ensure(1, 1)->isDefined());
-    }
-
-    public function testReturnValue(): void
-    {
-        $option = self::ensure(function () {
-            return 1;
-        });
-        self::assertTrue($option->isDefined());
-        self::assertSame(1, $option->get());
-        self::assertFalse(self::ensure(function () {
-        })->isDefined());
-        self::assertFalse(self::ensure(function () {
-            return 1;
-        }, 1)->isDefined());
-    }
-
-    public function testOptionReturnsAsSameInstance(): void
-    {
-        $option = self::ensure(1);
-        self::assertSame($option, self::ensure($option));
-    }
-
-    public function testOptionReturnedFromClosure(): void
-    {
-        $option = self::ensure(function () {
-            return Some::create(1);
-        });
-        self::assertTrue($option->isDefined());
-        self::assertSame(1, $option->get());
-
-        $option = self::ensure(function () {
-            return None::create();
-        });
-        self::assertFalse($option->isDefined());
-    }
-
-    public function testClosureReturnedFromClosure(): void
-    {
-        $option = self::ensure(function () {
-            return function () {
-            };
-        });
-        self::assertTrue($option->isDefined());
-        self::assertInstanceOf('Closure', $option->get());
-    }
-}

package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/LazyOptionTest.php

@@ -1,357 +0,0 @@
-<?php
-
-namespace PhpOption\Tests;
-
-use PhpOption\LazyOption;
-use PhpOption\None;
-use PhpOption\Option;
-use PhpOption\Some;
-use PHPUnit\Framework\TestCase;
-
-class LazyOptionTest extends TestCase
-{
-    private static function createSubject($default = null): object
-    {
-        return new class ($default) {
-            private $default;
-
-            public function __construct($default)
-            {
-                $this->default = $default;
-            }
-
-            public function execute($v = null): Option
-            {
-                return Option::fromValue($v ?? $this->default);
-            }
-        };
-    }
-
-    private static function createInvalidSubject(): object
-    {
-        return new class {
-            public function execute($v = null)
-            {
-                return null;
-            }
-        };
-    }
-
-    public function testGetWithArgumentsAndConstructor(): void
-    {
-        $some = LazyOption::create([self::createSubject(), 'execute'], ['foo']);
-
-        self::assertSame('foo', $some->get());
-        self::assertSame('foo', $some->getOrElse(null));
-        self::assertSame('foo', $some->getOrCall('does_not_exist'));
-        self::assertSame('foo', $some->getOrThrow(new \RuntimeException('does_not_exist')));
-        self::assertFalse($some->isEmpty());
-    }
-
-    public function testGetWithArgumentsAndCreate(): void
-    {
-        $some = new LazyOption([self::createSubject(), 'execute'], ['foo']);
-
-        self::assertSame('foo', $some->get());
-        self::assertSame('foo', $some->getOrElse(null));
-        self::assertSame('foo', $some->getOrCall('does_not_exist'));
-        self::assertSame('foo', $some->getOrThrow(new \RuntimeException('does_not_exist')));
-        self::assertFalse($some->isEmpty());
-    }
-
-    public function testGetWithoutArgumentsAndConstructor(): void
-    {
-        $some = new LazyOption([self::createSubject('foo'), 'execute']);
-
-        self::assertSame('foo', $some->get());
-        self::assertSame('foo', $some->getOrElse(null));
-        self::assertSame('foo', $some->getOrCall('does_not_exist'));
-        self::assertSame('foo', $some->getOrThrow(new \RuntimeException('does_not_exist')));
-        self::assertFalse($some->isEmpty());
-    }
-
-    public function testGetWithoutArgumentsAndCreate(): void
-    {
-        $option = LazyOption::create([self::createSubject('foo'), 'execute']);
-
-        self::assertTrue($option->isDefined());
-        self::assertFalse($option->isEmpty());
-        self::assertSame('foo', $option->get());
-        self::assertSame('foo', $option->getOrElse(null));
-        self::assertSame('foo', $option->getOrCall('does_not_exist'));
-        self::assertSame('foo', $option->getOrThrow(new \RuntimeException('does_not_exist')));
-    }
-
-    public function testCallbackReturnsNull(): void
-    {
-        if (method_exists($this, 'expectException')) {
-            $this->expectException('RuntimeException');
-            $this->expectExceptionMessage('None has no value');
-        } else {
-            $this->setExpectedException('RuntimeException', 'None has no value');
-        }
-
-        $option = LazyOption::create([self::createSubject(), 'execute']);
-
-        self::assertFalse($option->isDefined());
-        self::assertTrue($option->isEmpty());
-        self::assertSame('alt', $option->getOrElse('alt'));
-        self::assertSame('alt', $option->getOrCall(function () {
-            return 'alt';
-        }));
-
-        $option->get();
-    }
-
-    public function testExceptionIsThrownIfCallbackReturnsNonOption(): void
-    {
-        $option = LazyOption::create([self::createInvalidSubject(), 'execute']);
-
-        if (method_exists($this, 'expectException')) {
-            $this->expectException('RuntimeException');
-            $this->expectExceptionMessage('Expected instance of PhpOption\Option');
-        } else {
-            $this->setExpectedException('RuntimeException', 'Expected instance of PhpOption\Option');
-        }
-
-        $option->isDefined();
-    }
-
-    public function testInvalidCallbackAndConstructor(): void
-    {
-        if (method_exists($this, 'expectException')) {
-            $this->expectException('InvalidArgumentException');
-            $this->expectExceptionMessage('Invalid callback given');
-        } else {
-            $this->setExpectedException('InvalidArgumentException', 'Invalid callback given');
-        }
-
-        new LazyOption('invalidCallback');
-    }
-
-    public function testInvalidCallbackAndCreate(): void
-    {
-        if (method_exists($this, 'expectException')) {
-            $this->expectException('InvalidArgumentException');
-            $this->expectExceptionMessage('Invalid callback given');
-        } else {
-            $this->setExpectedException('InvalidArgumentException', 'Invalid callback given');
-        }
-
-        LazyOption::create('invalidCallback');
-    }
-
-    public function testifDefined(): void
-    {
-        $called = false;
-        $self = $this;
-        LazyOption::fromValue('foo')->ifDefined(function ($v) use (&$called, $self) {
-            $called = true;
-            $self->assertSame('foo', $v);
-        });
-        self::assertTrue($called);
-    }
-
-    public function testForAll(): void
-    {
-        $called = false;
-        $self = $this;
-        self::assertInstanceOf(Some::class, LazyOption::fromValue('foo')->forAll(function ($v) use (&$called, $self) {
-            $called = true;
-            $self->assertSame('foo', $v);
-        }));
-        self::assertTrue($called);
-    }
-
-    public function testOrElse(): void
-    {
-        $some = Some::create('foo');
-        $lazy = LazyOption::create(function () use ($some) {
-            return $some;
-        });
-        self::assertSame($some, $lazy->orElse(None::create()));
-        self::assertSame($some, $lazy->orElse(Some::create('bar')));
-    }
-
-    public function testFoldLeftRight(): void
-    {
-        $callback = function () {
-        };
-
-        // Use TestOption as a concrete implementation to test with
-        $option = self::createPartialMock(TestOption::class, ['foldLeft', 'foldRight']);
-        $option->expects(self::once())
-            ->method('foldLeft')
-            ->with(5, $callback)
-            ->willReturn(6);
-        $lazyOption = new LazyOption(function () use ($option) {
-            return $option;
-        });
-        self::assertSame(6, $lazyOption->foldLeft(5, $callback));
-
-        $option->expects(self::once())
-            ->method('foldRight')
-            ->with(5, $callback)
-            ->willReturn(6);
-        $lazyOption = new LazyOption(function () use ($option) {
-            return $option;
-        });
-        self::assertSame(6, $lazyOption->foldRight(5, $callback));
-    }
-}
-
-class TestOption extends Option
-{
-    private $value;
-
-    public function __construct($value = null)
-    {
-        $this->value = $value;
-    }
-
-    public function get()
-    {
-        return $this->value;
-    }
-
-    public function getOrElse($default)
-    {
-        if ($this->isDefined()) {
-            return $this->value;
-        }
-
-        return $default;
-    }
-
-    public function getOrCall($callable)
-    {
-        if ($this->isDefined()) {
-            return $this->value;
-        }
-
-        return call_user_func($callable);
-    }
-
-    public function getOrThrow(\Exception $ex)
-    {
-        if ($this->isDefined()) {
-            return $this->value;
-        }
-
-        throw $ex;
-    }
-
-    public function isEmpty()
-    {
-        return $this->value === null;
-    }
-
-    public function isDefined()
-    {
-        return $this->value !== null;
-    }
-
-    public function orElse(Option $else)
-    {
-        if ($this->isDefined()) {
-            return $this;
-        }
-
-        return $else;
-    }
-
-    public function ifDefined($callable)
-    {
-        if ($this->isDefined()) {
-            call_user_func($callable, $this->value);
-        }
-    }
-
-    public function forAll($callable)
-    {
-        if ($this->isDefined()) {
-            call_user_func($callable, $this->value);
-        }
-    }
-
-    public function map($callable)
-    {
-        if ($this->isDefined()) {
-            return new self(call_user_func($callable, $this->value));
-        }
-
-        return $this;
-    }
-
-    public function flatMap($callable)
-    {
-        if ($this->isDefined()) {
-            return call_user_func($callable, $this->value);
-        }
-
-        return $this;
-    }
-
-    public function filter($callable)
-    {
-        if ($this->isDefined() && call_user_func($callable, $this->value)) {
-            return $this;
-        }
-
-        return None::create();
-    }
-
-    public function filterNot($callable)
-    {
-        if ($this->isDefined() && !call_user_func($callable, $this->value)) {
-            return $this;
-        }
-
-        return None::create();
-    }
-
-    public function select($value)
-    {
-        if ($this->isDefined() && $this->value === $value) {
-            return $this;
-        }
-
-        return None::create();
-    }
-
-    public function reject($value)
-    {
-        if ($this->isDefined() && $this->value !== $value) {
-            return $this;
-        }
-
-        return None::create();
-    }
-
-    public function foldLeft($initialValue, $callable)
-    {
-        if ($this->isDefined()) {
-            return call_user_func($callable, $initialValue, $this->value);
-        }
-
-        return $initialValue;
-    }
-
-    public function foldRight($initialValue, $callable)
-    {
-        if ($this->isDefined()) {
-            return call_user_func($callable, $this->value, $initialValue);
-        }
-
-        return $initialValue;
-    }
-
-    public function getIterator(): \Traversable
-    {
-        if ($this->isDefined()) {
-            return new \ArrayIterator([$this->value]);
-        }
-
-        return new \ArrayIterator([]);
-    }
-}