Page MenuHomeWickedGov Phorge
Files F5977052

GeneratedValueSingle.php
No OneTemporary
Actions

Size
4 KB
Referenced Files
None
Subscribers
None

GeneratedValueSingle.php
View Options

<?php
namespace Eris\Generator;
use InvalidArgumentException;
use ArrayIterator;
/**
* Parametric with respect to the type <T> of its value.
* Immutable object, modifiers return a new GeneratedValueSingle instance.
*
* @template T
* @template-implements GeneratedValue<T>
*/
final class GeneratedValueSingle implements GeneratedValue // TODO? interface ShrunkValue extends IteratorAggregate[, Countable]
{
/** @var T */
private $value;
private $input;
private $generatorName;
/**
* @var array
*/
private $annotations;
/**
* A value and the input that was used to derive it.
* The input usually comes from another Generator.
*
* @template T
* @psalm-param T $value
* @param mixed $value
* @param GeneratedValueSingle|mixed $input
* @param string $generatorName 'tuple'
* @return GeneratedValueSingle
*/
public static function fromValueAndInput($value, $input, $generatorName = null)
{
return new self($value, $input, $generatorName);
}
/**
* Input will be copied from value.
*
* @template T
* @psalm-param T $value
* @param mixed $value
* @param string $generatorName 'tuple'
* @return GeneratedValueSingle
*/
public static function fromJustValue($value, $generatorName = null)
{
return new self($value, $value, $generatorName);
}
private function __construct($value, $input, $generatorName, array $annotations = [])
{
if ($value instanceof self) {
throw new InvalidArgumentException("It looks like you are trying to build a GeneratedValueSingle whose value is another GeneratedValueSingle. This is almost always an error as values will be passed as-is to properties and GeneratedValueSingle should be hidden from them.");
}
$this->value = $value;
$this->input = $input;
$this->generatorName = $generatorName;
$this->annotations = $annotations;
}
/**
* @return GeneratedValueSingle|mixed
*/
public function input()
{
return $this->input;
}
/**
* @psalm-return T
* @return mixed
*/
public function unbox()
{
return $this->value;
}
public function __toString()
{
return var_export($this, true);
}
/**
* @return string
*/
public function generatorName()
{
return $this->generatorName;
}
/**
* Produces a new GeneratedValueSingle that wraps this one,
* and that is labelled with $generatorName.
* $applyToValue is mapped over the value
* to build the outer GeneratedValueSingle object $this->value field.
*
* @return GeneratedValueSingle
*/
public function map(callable $applyToValue, $generatorName)
{
return new self(
$applyToValue($this->value),
$this,
$generatorName
);
}
/**
* Basically changes the name of the Generator,
* but without introducing an additional layer
* of wrapping of GeneratedValueSingle objects.
*
* @param string $generatorName 'tuple', 'vector'
* @return GeneratedValueSingle
*/
public function derivedIn($generatorName)
{
return $this->map(
function ($value) {
return $value;
},
$generatorName
);
}
public function getIterator(): \Traversable
{
return new ArrayIterator([
$this
]);
}
public function count(): int
{
return 1;
}
public function merge(GeneratedValueSingle $another, callable $merge)
{
if ($another->generatorName !== $this->generatorName) {
throw new InvalidArgumentException("Trying to merge a {$this->generatorName} GeneratedValueSingle with a {$another->generatorName} GeneratedValueSingle");
}
return self::fromValueAndInput(
$merge($this->unbox(), $another->unbox()),
$merge($this->input(), $another->input()),
$this->generatorName
);
}
public function add(GeneratedValueSingle $value)
{
return new GeneratedValueOptions([
$this,
$value,
]);
}
}

File Metadata

Mime Type
text/x-php
Expires
Sat, Oct 3, 19:37 (2 d, 19 h ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
d0/77/7c59a1a61d0871b3dc5510ae4eeb
Default Alt Text
GeneratedValueSingle.php (4 KB)

Event Timeline