brightnucleus / view

src/Views.php

Indentation +85 added lines, -85 removed lines

@@ -28,97 +28,97 @@
 class Views
 {
 
-    /**
-     * ViewBuilder Instance.
-     *
-     * @since 0.1.0
-     *
-     * @var ViewBuilder
-     */
-    protected static $viewBuilder;
+	/**
+	 * ViewBuilder Instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var ViewBuilder
+	 */
+	protected static $viewBuilder;
 
-    /**
-     * Add a location to the ViewBuilder.
-     *
-     * @since 0.1.0
-     *
-     * @param Location $location Location to add.
-     *
-     * @throws FailedToProcessConfigException If the Config could not be processed.
-     */
-    public static function addLocation(Location $location)
-    {
-        $viewBuilder = static::getViewBuilder();
-        $viewBuilder->addLocation($location);
-    }
+	/**
+	 * Add a location to the ViewBuilder.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param Location $location Location to add.
+	 *
+	 * @throws FailedToProcessConfigException If the Config could not be processed.
+	 */
+	public static function addLocation(Location $location)
+	{
+		$viewBuilder = static::getViewBuilder();
+		$viewBuilder->addLocation($location);
+	}
 
-    /**
-     * Get the ViewBuilder instance.
-     *
-     * @since 0.1.0
-     *
-     * @return ViewBuilder
-     * @throws FailedToProcessConfigException If the Config could not be processed.
-     */
-    public static function getViewBuilder()
-    {
-        if (null === static::$viewBuilder) {
-            static::$viewBuilder = static::instantiateViewBuilder();
-        }
+	/**
+	 * Get the ViewBuilder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return ViewBuilder
+	 * @throws FailedToProcessConfigException If the Config could not be processed.
+	 */
+	public static function getViewBuilder()
+	{
+		if (null === static::$viewBuilder) {
+			static::$viewBuilder = static::instantiateViewBuilder();
+		}
 
-        return static::$viewBuilder;
-    }
+		return static::$viewBuilder;
+	}
 
-    /**
-     * Instantiate the ViewBuilder.
-     *
-     * @since 0.1.0
-     *
-     * @param ConfigInterface|null $config Optional. Configuration to pass into the ViewBuilder.
-     *
-     * @return ViewBuilder Instance of the ViewBuilder.
-     * @throws FailedToProcessConfigException If the Config could not be processed.
-     */
-    public static function instantiateViewBuilder(ConfigInterface $config = null)
-    {
-        return static::$viewBuilder = new ViewBuilder($config);
-    }
+	/**
+	 * Instantiate the ViewBuilder.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param ConfigInterface|null $config Optional. Configuration to pass into the ViewBuilder.
+	 *
+	 * @return ViewBuilder Instance of the ViewBuilder.
+	 * @throws FailedToProcessConfigException If the Config could not be processed.
+	 */
+	public static function instantiateViewBuilder(ConfigInterface $config = null)
+	{
+		return static::$viewBuilder = new ViewBuilder($config);
+	}
 
-    /**
-     * Create a new view for a given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string      $view View identifier to create a view for.
-     * @param string|null $type Type of view to create.
-     *
-     * @return View Instance of the requested view.
-     * @throws FailedToProcessConfigException If the Config could not be processed.
-     */
-    public static function create($view, $type = null)
-    {
-        $viewBuilder = static::getViewBuilder();
+	/**
+	 * Create a new view for a given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string      $view View identifier to create a view for.
+	 * @param string|null $type Type of view to create.
+	 *
+	 * @return View Instance of the requested view.
+	 * @throws FailedToProcessConfigException If the Config could not be processed.
+	 */
+	public static function create($view, $type = null)
+	{
+		$viewBuilder = static::getViewBuilder();
 
-        return $viewBuilder->create($view, $type);
-    }
+		return $viewBuilder->create($view, $type);
+	}
 
-    /**
-     * Render a view for a given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string      $view    View identifier to create a view for.
-     * @param array       $context Optional. The context in which to render the view.
-     * @param string|null $type    Type of view to create.
-     *
-     * @return string Rendered HTML content.
-     * @throws FailedToProcessConfigException If the Config could not be processed.
-     */
-    public static function render($view, array $context = [], $type = null)
-    {
-        $viewBuilder = static::getViewBuilder();
-        $viewObject  = $viewBuilder->create($view, $type);
+	/**
+	 * Render a view for a given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string      $view    View identifier to create a view for.
+	 * @param array       $context Optional. The context in which to render the view.
+	 * @param string|null $type    Type of view to create.
+	 *
+	 * @return string Rendered HTML content.
+	 * @throws FailedToProcessConfigException If the Config could not be processed.
+	 */
+	public static function render($view, array $context = [], $type = null)
+	{
+		$viewBuilder = static::getViewBuilder();
+		$viewObject  = $viewBuilder->create($view, $type);
 
-        return $viewObject->render($context);
-    }
+		return $viewObject->render($context);
+	}
 }

src/View/Location/URIs.php

Indentation +14 added lines, -14 removed lines

@@ -25,19 +25,19 @@
 class URIs extends ArrayCollection
 {
 
-    /**
-     * Create a new URIs from a Symfony Finder instance.
-     *
-     * @since 0.1.3
-     *
-     * @param Finder $finder The Finder instance to create the URI collection from.
-     *
-     * @return URIs New URIs instance.
-     */
-    public static function fromFinder(Finder $finder): URIs
-    {
-        $elements = array_keys(iterator_to_array($finder));
+	/**
+	 * Create a new URIs from a Symfony Finder instance.
+	 *
+	 * @since 0.1.3
+	 *
+	 * @param Finder $finder The Finder instance to create the URI collection from.
+	 *
+	 * @return URIs New URIs instance.
+	 */
+	public static function fromFinder(Finder $finder): URIs
+	{
+		$elements = array_keys(iterator_to_array($finder));
 
-        return new static($elements);
-    }
+		return new static($elements);
+	}
 }

src/View/Location/Location.php

Indentation +20 added lines, -20 removed lines

@@ -22,25 +22,25 @@
 interface Location
 {
 
-    /**
-     * Get the first URI that matches the given criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array $criteria Criteria to match.
-     *
-     * @return string|false URI that matches the criteria or false if none found.
-     */
-    public function getURI(array $criteria);
+	/**
+	 * Get the first URI that matches the given criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array $criteria Criteria to match.
+	 *
+	 * @return string|false URI that matches the criteria or false if none found.
+	 */
+	public function getURI(array $criteria);
 
-    /**
-     * Get all URIs that match the given criteria.
-     *
-     * @since 0.1.1
-     *
-     * @param array $criteria Criteria to match.
-     *
-     * @return URIs Collection of URIs that matches the criteria or an empty collection if none found.
-     */
-    public function getURIs(array $criteria): URIs;
+	/**
+	 * Get all URIs that match the given criteria.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param array $criteria Criteria to match.
+	 *
+	 * @return URIs Collection of URIs that matches the criteria or an empty collection if none found.
+	 */
+	public function getURIs(array $criteria): URIs;
 }

src/View/Location/Locations.php

Indentation +31 added lines, -31 removed lines

@@ -24,37 +24,37 @@
 class Locations extends ArrayCollection
 {
 
-    /**
-     * Adds a location at the end of the collection if it does not already exist.
-     *
-     * @param mixed $location The location to add.
-     *
-     * @return bool Whether the location was added or not.
-     */
-    public function add($location): bool
-    {
-        if ($this->hasLocation($location)) {
-            return false;
-        }
+	/**
+	 * Adds a location at the end of the collection if it does not already exist.
+	 *
+	 * @param mixed $location The location to add.
+	 *
+	 * @return bool Whether the location was added or not.
+	 */
+	public function add($location): bool
+	{
+		if ($this->hasLocation($location)) {
+			return false;
+		}
 
-        return parent::add($location);
-    }
+		return parent::add($location);
+	}
 
-    /**
-     * Check whether a given location is already registered.
-     *
-     * For two locations to be equal, both their path and their extensions must be the same.
-     *
-     * @since 0.1.1
-     *
-     * @param Location $location Location to check the existence of.
-     *
-     * @return bool Whether the location is already registered or not.
-     */
-    public function hasLocation(Location $location): bool
-    {
-        return $this->exists(function ($key, $element) use ($location) {
-            return $location == $element;
-        });
-    }
+	/**
+	 * Check whether a given location is already registered.
+	 *
+	 * For two locations to be equal, both their path and their extensions must be the same.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param Location $location Location to check the existence of.
+	 *
+	 * @return bool Whether the location is already registered or not.
+	 */
+	public function hasLocation(Location $location): bool
+	{
+		return $this->exists(function ($key, $element) use ($location) {
+			return $location == $element;
+		});
+	}
 }

src/View/Support/Findable.php

Indentation +10 added lines, -10 removed lines

@@ -22,14 +22,14 @@
 interface Findable
 {
 
-    /**
-     * Check whether the Findable can handle an individual criterion.
-     *
-     * @since 0.1.0
-     *
-     * @param mixed $criterion Criterion to check.
-     *
-     * @return bool Whether the Findable can handle the criterion.
-     */
-    public function canHandle($criterion): bool;
+	/**
+	 * Check whether the Findable can handle an individual criterion.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param mixed $criterion Criterion to check.
+	 *
+	 * @return bool Whether the Findable can handle the criterion.
+	 */
+	public function canHandle($criterion): bool;
 }

src/View/Support/Finder.php

Indentation +18 added lines, -18 removed lines

@@ -22,23 +22,23 @@
 interface Finder
 {
 
-    /**
-     * Find a result based on a specific criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array $criteria Criteria to search for.
-     *
-     * @return mixed Result of the search.
-     */
-    public function find(array $criteria);
+	/**
+	 * Find a result based on a specific criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array $criteria Criteria to search for.
+	 *
+	 * @return mixed Result of the search.
+	 */
+	public function find(array $criteria);
 
-    /**
-     * Get the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @return NullFindable NullObject for the current Finder.
-     */
-    public function getNullObject(): NullFindable;
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullFindable NullObject for the current Finder.
+	 */
+	public function getNullObject(): NullFindable;
 }

src/View/Support/URIHelper.php

Indentation +32 added lines, -32 removed lines

@@ -22,38 +22,38 @@
 class URIHelper
 {
 
-    /**
-     * Check whether a given URI has a specific extension.
-     *
-     * @since 0.1.3
-     *
-     * @param string $uri       URI to check the extension of.
-     * @param string $extension Extension to check for.
-     *
-     * @return bool
-     */
-    public static function hasExtension(string $uri, string $extension): bool
-    {
-        $uriLength       = mb_strlen($uri);
-        $extensionLength = mb_strlen($extension);
-        if ($extensionLength > $uriLength) {
-            return false;
-        }
+	/**
+	 * Check whether a given URI has a specific extension.
+	 *
+	 * @since 0.1.3
+	 *
+	 * @param string $uri       URI to check the extension of.
+	 * @param string $extension Extension to check for.
+	 *
+	 * @return bool
+	 */
+	public static function hasExtension(string $uri, string $extension): bool
+	{
+		$uriLength       = mb_strlen($uri);
+		$extensionLength = mb_strlen($extension);
+		if ($extensionLength > $uriLength) {
+			return false;
+		}
 
-        return substr_compare($uri, $extension, $uriLength - $extensionLength, $extensionLength) === 0;
-    }
+		return substr_compare($uri, $extension, $uriLength - $extensionLength, $extensionLength) === 0;
+	}
 
-    /**
-     * Get the filename for an URI.
-     *
-     * @since 0.1.3
-     *
-     * @param string $uri URI to get the filename from.
-     *
-     * @return string Filename without path.
-     */
-    public static function getFilename(string $uri): String
-    {
-        return basename($uri);
-    }
+	/**
+	 * Get the filename for an URI.
+	 *
+	 * @since 0.1.3
+	 *
+	 * @param string $uri URI to get the filename from.
+	 *
+	 * @return string Filename without path.
+	 */
+	public static function getFilename(string $uri): String
+	{
+		return basename($uri);
+	}
 }

src/View/Support/Extensions.php

Indentation +19 added lines, -19 removed lines

@@ -24,24 +24,24 @@
 class Extensions extends ArrayCollection
 {
 
-    /**
-     * Check whether a given URI has a specific extension.
-     *
-     * @since 0.1.0
-     *
-     * @param string $uri       URI to check the extension of.
-     * @param string $extension Extension to check for.
-     *
-     * @return bool
-     */
-    public static function hasExtension(string $uri, string $extension): bool
-    {
-        $uriLength       = mb_strlen($uri);
-        $extensionLength = mb_strlen($extension);
-        if ($extensionLength > $uriLength) {
-            return false;
-        }
+	/**
+	 * Check whether a given URI has a specific extension.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $uri       URI to check the extension of.
+	 * @param string $extension Extension to check for.
+	 *
+	 * @return bool
+	 */
+	public static function hasExtension(string $uri, string $extension): bool
+	{
+		$uriLength       = mb_strlen($uri);
+		$extensionLength = mb_strlen($extension);
+		if ($extensionLength > $uriLength) {
+			return false;
+		}
 
-        return substr_compare($uri, $extension, $uriLength - $extensionLength, $extensionLength) === 0;
-    }
+		return substr_compare($uri, $extension, $uriLength - $extensionLength, $extensionLength) === 0;
+	}
 }

src/View/Support/AbstractFinder.php

Indentation +211 added lines, -211 removed lines

@@ -27,215 +27,215 @@
 abstract class AbstractFinder implements Finder
 {
 
-    use ConfigTrait;
-
-    /**
-     * Findable collection that the Finder can iterate through to find a match.
-     *
-     * @since 0.1.0
-     *
-     * @var Findables
-     */
-    protected $findables;
-
-    /**
-     * NullObject that is returned if the Finder could not find a match.
-     *
-     * @since 0.1.0
-     *
-     * @var NullFindable
-     */
-    protected $nullObject;
-
-    /**
-     * Instantiate an AbstractFinder object.
-     *
-     * @since 0.1.0
-     *
-     * @param ConfigInterface $config Configuration of the AbstractFinder.
-     *
-     * @throws FailedToProcessConfigException If the config could not be processed.
-     */
-    public function __construct(ConfigInterface $config)
-    {
-        $this->processConfig($config);
-        $this->findables = new Findables();
-        $this->registerFindables($this->config);
-        $this->registerNullObject($this->config);
-    }
-
-    /**
-     * Register the Findables defined in the given configuration.
-     *
-     * @since 0.1.0
-     *
-     * @param ConfigInterface $config Configuration to register the Findables from.
-     */
-    public function registerFindables(ConfigInterface $config)
-    {
-        $findables = (array) $config->getKey($this->getFindablesConfigKey());
-        foreach ($findables as $findableKey => $findableObject) {
-            $this->findables->set($findableKey, $findableObject);
-        }
-    }
-
-    /**
-     * Register the NullObject defined in the given configuration.
-     *
-     * @since 0.1.0
-     *
-     * @param ConfigInterface $config Configuration to register the NullObject from.
-     */
-    public function registerNullObject(ConfigInterface $config)
-    {
-        $this->nullObject = $config->getKey($this->getNullObjectConfigKey());
-    }
-
-    /**
-     * Get the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @return NullFindable NullObject for the current Finder.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    public function getNullObject(): NullFindable
-    {
-        $this->initializeNullObject();
-
-        return $this->nullObject;
-    }
-
-    /**
-     * Get the config key for the Findables definitions.
-     *
-     * @since 0.1.0
-     *
-     * @return string Config key use to define the Findables.
-     */
-    protected function getFindablesConfigKey(): string
-    {
-        return 'Findables';
-    }
-
-    /**
-     * Get the config key for the NullObject definitions.
-     *
-     * @since 0.1.0
-     *
-     * @return string Config key use to define the NullObject.
-     */
-    protected function getNullObjectConfigKey(): string
-    {
-        return 'NullObject';
-    }
-
-    /**
-     * Initialize the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @param mixed $arguments Optional. Arguments to use.
-     *
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    protected function initializeNullObject($arguments = null)
-    {
-        $this->nullObject = $this->maybeInstantiateFindable($this->nullObject, $arguments);
-    }
-
-    /**
-     * Initialize the Findables that can be iterated.
-     *
-     * @param mixed $arguments Optional. Arguments to use.
-     *
-     * @since 0.1.0
-     *
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    protected function initializeFindables($arguments = null)
-    {
-        $this->findables = $this->findables->map(function ($findable) use ($arguments) {
-            return $this->initializeFindable($findable, $arguments);
-        });
-    }
-
-    /**
-     * Initialize a single findable by instantiating class name strings and calling closures.
-     *
-     * @since 0.1.0
-     *
-     * @param mixed $findable  Findable to instantiate.
-     * @param mixed $arguments Optional. Arguments to use.
-     *
-     * @return Findable Instantiated findable.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    protected function initializeFindable($findable, $arguments = null): Findable
-    {
-        return $this->maybeInstantiateFindable($findable, $arguments);
-    }
-
-    /**
-     * Maybe instantiate a Findable if it is not yet an object.
-     *
-     * @since 0.1.1
-     *
-     * @param mixed $findable  Findable to instantiate.
-     * @param mixed $arguments Optional. Arguments to use.
-     *
-     * @return Findable Instantiated findable.
-     * @throws FailedToInstantiateFindable If the findable could not be instantiated.
-     */
-    protected function maybeInstantiateFindable($findable, $arguments = null): Findable
-    {
-        if (is_string($findable)) {
-            $findable = $this->instantiateFindableFromString($findable, $arguments);
-        }
-
-        if (is_callable($findable)) {
-            $findable = $this->instantiateFindableFromCallable($findable, $arguments);
-        }
-
-        if (! $findable instanceof Findable) {
-            throw new FailedToInstantiateFindable(
-                sprintf(
-                    _('Could not instantiate Findable "%s".'),
-                    serialize($findable)
-                )
-            );
-        }
-
-        return $findable;
-    }
-
-    /**
-     * Instantiate a Findable from a string.
-     *
-     * @since 0.1.1
-     *
-     * @param string $string    String to use for instantiation.
-     * @param mixed  $arguments Optional. Arguments to use for instantiation.
-     *
-     * @return Findable Instantiated Findable.
-     */
-    protected function instantiateFindableFromString(string $string, $arguments = []): Findable
-    {
-        return new $string(...(array)$arguments);
-    }
-
-    /**
-     * Instantiate a Findable from a callable.
-     *
-     * @since 0.1.1
-     *
-     * @param callable $callable  Callable to use for instantiation.
-     * @param mixed    $arguments Optional. Arguments to use for instantiation.
-     *
-     * @return Findable Instantiated Findable.
-     */
-    protected function instantiateFindableFromCallable(callable $callable, $arguments = []): Findable
-    {
-        return $callable(...(array)$arguments);
-    }
+	use ConfigTrait;
+
+	/**
+	 * Findable collection that the Finder can iterate through to find a match.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var Findables
+	 */
+	protected $findables;
+
+	/**
+	 * NullObject that is returned if the Finder could not find a match.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var NullFindable
+	 */
+	protected $nullObject;
+
+	/**
+	 * Instantiate an AbstractFinder object.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param ConfigInterface $config Configuration of the AbstractFinder.
+	 *
+	 * @throws FailedToProcessConfigException If the config could not be processed.
+	 */
+	public function __construct(ConfigInterface $config)
+	{
+		$this->processConfig($config);
+		$this->findables = new Findables();
+		$this->registerFindables($this->config);
+		$this->registerNullObject($this->config);
+	}
+
+	/**
+	 * Register the Findables defined in the given configuration.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param ConfigInterface $config Configuration to register the Findables from.
+	 */
+	public function registerFindables(ConfigInterface $config)
+	{
+		$findables = (array) $config->getKey($this->getFindablesConfigKey());
+		foreach ($findables as $findableKey => $findableObject) {
+			$this->findables->set($findableKey, $findableObject);
+		}
+	}
+
+	/**
+	 * Register the NullObject defined in the given configuration.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param ConfigInterface $config Configuration to register the NullObject from.
+	 */
+	public function registerNullObject(ConfigInterface $config)
+	{
+		$this->nullObject = $config->getKey($this->getNullObjectConfigKey());
+	}
+
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullFindable NullObject for the current Finder.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	public function getNullObject(): NullFindable
+	{
+		$this->initializeNullObject();
+
+		return $this->nullObject;
+	}
+
+	/**
+	 * Get the config key for the Findables definitions.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return string Config key use to define the Findables.
+	 */
+	protected function getFindablesConfigKey(): string
+	{
+		return 'Findables';
+	}
+
+	/**
+	 * Get the config key for the NullObject definitions.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return string Config key use to define the NullObject.
+	 */
+	protected function getNullObjectConfigKey(): string
+	{
+		return 'NullObject';
+	}
+
+	/**
+	 * Initialize the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param mixed $arguments Optional. Arguments to use.
+	 *
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	protected function initializeNullObject($arguments = null)
+	{
+		$this->nullObject = $this->maybeInstantiateFindable($this->nullObject, $arguments);
+	}
+
+	/**
+	 * Initialize the Findables that can be iterated.
+	 *
+	 * @param mixed $arguments Optional. Arguments to use.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	protected function initializeFindables($arguments = null)
+	{
+		$this->findables = $this->findables->map(function ($findable) use ($arguments) {
+			return $this->initializeFindable($findable, $arguments);
+		});
+	}
+
+	/**
+	 * Initialize a single findable by instantiating class name strings and calling closures.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param mixed $findable  Findable to instantiate.
+	 * @param mixed $arguments Optional. Arguments to use.
+	 *
+	 * @return Findable Instantiated findable.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	protected function initializeFindable($findable, $arguments = null): Findable
+	{
+		return $this->maybeInstantiateFindable($findable, $arguments);
+	}
+
+	/**
+	 * Maybe instantiate a Findable if it is not yet an object.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param mixed $findable  Findable to instantiate.
+	 * @param mixed $arguments Optional. Arguments to use.
+	 *
+	 * @return Findable Instantiated findable.
+	 * @throws FailedToInstantiateFindable If the findable could not be instantiated.
+	 */
+	protected function maybeInstantiateFindable($findable, $arguments = null): Findable
+	{
+		if (is_string($findable)) {
+			$findable = $this->instantiateFindableFromString($findable, $arguments);
+		}
+
+		if (is_callable($findable)) {
+			$findable = $this->instantiateFindableFromCallable($findable, $arguments);
+		}
+
+		if (! $findable instanceof Findable) {
+			throw new FailedToInstantiateFindable(
+				sprintf(
+					_('Could not instantiate Findable "%s".'),
+					serialize($findable)
+				)
+			);
+		}
+
+		return $findable;
+	}
+
+	/**
+	 * Instantiate a Findable from a string.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param string $string    String to use for instantiation.
+	 * @param mixed  $arguments Optional. Arguments to use for instantiation.
+	 *
+	 * @return Findable Instantiated Findable.
+	 */
+	protected function instantiateFindableFromString(string $string, $arguments = []): Findable
+	{
+		return new $string(...(array)$arguments);
+	}
+
+	/**
+	 * Instantiate a Findable from a callable.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param callable $callable  Callable to use for instantiation.
+	 * @param mixed    $arguments Optional. Arguments to use for instantiation.
+	 *
+	 * @return Findable Instantiated Findable.
+	 */
+	protected function instantiateFindableFromCallable(callable $callable, $arguments = []): Findable
+	{
+		return $callable(...(array)$arguments);
+	}
 }