brightnucleus / view

config/defaults.php

Indentation +22 added lines, -22 removed lines

@@ -15,35 +15,35 @@
  * Engine finder default configuration.
  */
 $engineFinder = [
-    // Class to use for instantiating the EngineFinder implementation.
-    Engine\EngineFinder::CLASS_NAME_KEY => Engine\BaseEngineFinder::class,
-    // Engine implementations to register with the EngineFinder.
-    Engine\EngineFinder::ENGINES_KEY    => [
-        'PHPEngine' => Engine\PHPEngine::class,
-    ],
-    // Null object implementation to use with the EngineFinder.
-    Engine\EngineFinder::NULL_OBJECT    => Engine\NullEngine::class,
+	// Class to use for instantiating the EngineFinder implementation.
+	Engine\EngineFinder::CLASS_NAME_KEY => Engine\BaseEngineFinder::class,
+	// Engine implementations to register with the EngineFinder.
+	Engine\EngineFinder::ENGINES_KEY    => [
+		'PHPEngine' => Engine\PHPEngine::class,
+	],
+	// Null object implementation to use with the EngineFinder.
+	Engine\EngineFinder::NULL_OBJECT    => Engine\NullEngine::class,
 ];
 
 /*
  * View finder default configuration.
  */
 $viewFinder = [
-    // Class to use for instantiating the ViewFinder implementation.
-    View\ViewFinder::CLASS_NAME_KEY => View\BaseViewFinder::class,
-    // View implementations to register with the ViewFinder.
-    View\ViewFinder::VIEWS_KEY      => [
-        'BaseView' => View\BaseView::class,
-    ],
-    // Null object implementation to use with the ViewFinder.
-    View\ViewFinder::NULL_OBJECT    => View\NullView::class,
+	// Class to use for instantiating the ViewFinder implementation.
+	View\ViewFinder::CLASS_NAME_KEY => View\BaseViewFinder::class,
+	// View implementations to register with the ViewFinder.
+	View\ViewFinder::VIEWS_KEY      => [
+		'BaseView' => View\BaseView::class,
+	],
+	// Null object implementation to use with the ViewFinder.
+	View\ViewFinder::NULL_OBJECT    => View\NullView::class,
 ];
 
 return [
-    'BrightNucleus' => [
-        'View' => [
-            'EngineFinder' => $engineFinder,
-            'ViewFinder'   => $viewFinder,
-        ],
-    ],
+	'BrightNucleus' => [
+		'View' => [
+			'EngineFinder' => $engineFinder,
+			'ViewFinder'   => $viewFinder,
+		],
+	],
 ];

src/View/Engine/NullEngine.php

Doc Comments +1 added lines, -1 removed lines

@@ -46,7 +46,7 @@
      * @param string $uri     URI to render.
      * @param array  $context Context in which to render.
      *
-     * @return callable Rendering callback.
+     * @return \Closure Rendering callback.
      */
     public function getRenderCallback(string $uri, array $context = []): callable
     {

Indentation +27 added lines, -27 removed lines

@@ -24,32 +24,32 @@
 class NullEngine implements Engine, NullFindable
 {
 
-    /**
-     * 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
-    {
-        return true;
-    }
+	/**
+	 * 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
+	{
+		return true;
+	}
 
-    /**
-     * Get the rendering callback for a given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string $uri     URI to render.
-     * @param array  $context Context in which to render.
-     *
-     * @return callable Rendering callback.
-     */
-    public function getRenderCallback(string $uri, array $context = []): callable
-    {
-        return function () { return ''; };
-    }
+	/**
+	 * Get the rendering callback for a given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $uri     URI to render.
+	 * @param array  $context Context in which to render.
+	 *
+	 * @return callable Rendering callback.
+	 */
+	public function getRenderCallback(string $uri, array $context = []): callable
+	{
+		return function () { return ''; };
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -50,6 +50,6 @@
      */
     public function getRenderCallback(string $uri, array $context = []): callable
     {
-        return function () { return ''; };
+        return function() { return ''; };
     }
 }

src/View/View/ViewFinder.php

Indentation +23 added lines, -23 removed lines

@@ -26,29 +26,29 @@
 interface ViewFinder extends Finder
 {
 
-    // Constants to be used for the Config file sections.
-    const CLASS_NAME_KEY = 'ClassName';
-    const VIEWS_KEY = 'Views';
-    const NULL_OBJECT = 'NullObject';
+	// Constants to be used for the Config file sections.
+	const CLASS_NAME_KEY = 'ClassName';
+	const VIEWS_KEY = 'Views';
+	const NULL_OBJECT = 'NullObject';
 
-    /**
-     * Find a result based on a specific criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array       $criteria Criteria to search for.
-     * @param Engine|null $engine   Optional. Engine to use with the view.
-     *
-     * @return View View that was found.
-     */
-    public function find(array $criteria, Engine $engine = null): View;
+	/**
+	 * Find a result based on a specific criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array       $criteria Criteria to search for.
+	 * @param Engine|null $engine   Optional. Engine to use with the view.
+	 *
+	 * @return View View that was found.
+	 */
+	public function find(array $criteria, Engine $engine = null): View;
 
-    /**
-     * Get the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @return NullView NullObject for the current Finder.
-     */
-    public function getNullObject(): NullView;
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullView NullObject for the current Finder.
+	 */
+	public function getNullObject(): NullView;
 }

src/View/View/BaseViewFinder.php

Indentation +47 added lines, -47 removed lines

@@ -27,56 +27,56 @@
 class BaseViewFinder extends AbstractFinder implements ViewFinder
 {
 
-    /**
-     * Find a result based on a specific criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array       $criteria Criteria to search for.
-     * @param Engine|null $engine   Optional. Engine to use with the view.
-     *
-     * @return View View that was found.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    public function find(array $criteria, Engine $engine = null): View
-    {
-        $uri = $criteria[0];
+	/**
+	 * Find a result based on a specific criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array       $criteria Criteria to search for.
+	 * @param Engine|null $engine   Optional. Engine to use with the view.
+	 *
+	 * @return View View that was found.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	public function find(array $criteria, Engine $engine = null): View
+	{
+		$uri = $criteria[0];
 
-        $views = $this->initializeFindables([$uri, $engine]);
+		$views = $this->initializeFindables([$uri, $engine]);
 
-        foreach ($criteria as $entry) {
-            foreach ($views as $viewObject) {
-                if ($viewObject->canHandle($entry)) {
-                    return $viewObject;
-                }
-            }
-        }
+		foreach ($criteria as $entry) {
+			foreach ($views as $viewObject) {
+				if ($viewObject->canHandle($entry)) {
+					return $viewObject;
+				}
+			}
+		}
 
-        return $this->getNullObject();
-    }
+		return $this->getNullObject();
+	}
 
-    /**
-     * 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 'Views';
-    }
+	/**
+	 * 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 'Views';
+	}
 
-    /**
-     * Get the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @return NullView NullObject for the current Finder.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    public function getNullObject(): NullView
-    {
-        return parent::getNullObject();
-    }
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullView NullObject for the current Finder.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	public function getNullObject(): NullView
+	{
+		return parent::getNullObject();
+	}
 }

src/View/Engine/EngineFinder.php

Indentation +12 added lines, -12 removed lines

@@ -23,17 +23,17 @@
  */
 interface EngineFinder extends Finder
 {
-    // Constants to be used for the Config file sections.
-    const CLASS_NAME_KEY = 'ClassName';
-    const ENGINES_KEY = 'Engines';
-    const NULL_OBJECT = 'NullObject';
+	// Constants to be used for the Config file sections.
+	const CLASS_NAME_KEY = 'ClassName';
+	const ENGINES_KEY = 'Engines';
+	const NULL_OBJECT = 'NullObject';
 
-    /**
-     * Get the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @return NullEngine NullObject for the current Finder.
-     */
-    public function getNullObject(): NullEngine;
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullEngine NullObject for the current Finder.
+	 */
+	public function getNullObject(): NullEngine;
 }

src/View/Engine/BaseEngineFinder.php

Indentation +45 added lines, -45 removed lines

@@ -25,53 +25,53 @@
 class BaseEngineFinder extends AbstractFinder implements EngineFinder
 {
 
-    /**
-     * Find a result based on a specific criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array $criteria Criteria to search for.
-     *
-     * @return Engine Result of the search.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    public function find(array $criteria): Engine
-    {
-        $this->findables = $this->initializeFindables();
+	/**
+	 * Find a result based on a specific criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array $criteria Criteria to search for.
+	 *
+	 * @return Engine Result of the search.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	public function find(array $criteria): Engine
+	{
+		$this->findables = $this->initializeFindables();
 
-        foreach ($criteria as $entry) {
-            foreach ($this->findables as $engine) {
-                if ($engine->canHandle($entry)) {
-                    return $engine;
-                }
-            }
-        }
+		foreach ($criteria as $entry) {
+			foreach ($this->findables as $engine) {
+				if ($engine->canHandle($entry)) {
+					return $engine;
+				}
+			}
+		}
 
-        return $this->getNullObject();
-    }
+		return $this->getNullObject();
+	}
 
-    /**
-     * 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 'Engines';
-    }
+	/**
+	 * 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 'Engines';
+	}
 
-    /**
-     * Get the NullObject.
-     *
-     * @since 0.1.1
-     *
-     * @return NullEngine NullObject for the current Finder.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    public function getNullObject(): NullEngine
-    {
-        return parent::getNullObject();
-    }
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullEngine NullObject for the current Finder.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	public function getNullObject(): NullEngine
+	{
+		return parent::getNullObject();
+	}
 }

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();
+	/**
+	 * Get the NullObject.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @return NullFindable NullObject for the current Finder.
+	 */
+	public function getNullObject();
 }

src/View/Support/URIHelper.php

Indentation +49 added lines, -49 removed lines

@@ -22,58 +22,58 @@
 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
-    {
-        $extension       = '.' . ltrim($extension, '.');
-        $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
+	{
+		$extension       = '.' . ltrim($extension, '.');
+		$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;
+	}
 
-    /**
-     * Check whether a given URI contains an extension and return it.
-     *
-     * @param string $uri URI to check.
-     * @return string Extension that was found, empty string if none found.
-     */
-    public static function containsExtension(string $uri): string
-    {
-        $pathParts     = explode('/', $uri);
-        $filename      = array_pop($pathParts);
-        $filenameParts = explode('.', $filename);
+	/**
+	 * Check whether a given URI contains an extension and return it.
+	 *
+	 * @param string $uri URI to check.
+	 * @return string Extension that was found, empty string if none found.
+	 */
+	public static function containsExtension(string $uri): string
+	{
+		$pathParts     = explode('/', $uri);
+		$filename      = array_pop($pathParts);
+		$filenameParts = explode('.', $filename);
 
-        if (count($filenameParts) > 1) {
-            return array_pop($filenameParts);
-        }
+		if (count($filenameParts) > 1) {
+			return array_pop($filenameParts);
+		}
 
-        return '';
-    }
+		return '';
+	}
 
-    /**
-     * 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);
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -34,7 +34,7 @@
      */
     public static function hasExtension(string $uri, string $extension): bool
     {
-        $extension       = '.' . ltrim($extension, '.');
+        $extension       = '.'.ltrim($extension, '.');
         $uriLength       = mb_strlen($uri);
         $extensionLength = mb_strlen($extension);
         if ($extensionLength > $uriLength) {

src/View/Support/AbstractFinder.php

Indentation +212 added lines, -212 removed lines

@@ -27,216 +27,216 @@
 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()
-    {
-        $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
-     *
-     * @return Findables Collection of Findables.
-     * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
-     */
-    protected function initializeFindables($arguments = null): Findables
-    {
-        return $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()
+	{
+		$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
+	 *
+	 * @return Findables Collection of Findables.
+	 * @throws FailedToInstantiateFindable If the Findable could not be instantiated.
+	 */
+	protected function initializeFindables($arguments = null): Findables
+	{
+		return $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);
+	}
 }

Spacing +4 added lines, -4 removed lines

@@ -156,7 +156,7 @@ 
      */
     protected function initializeFindables($arguments = null): Findables
     {
-        return $this->findables->map(function ($findable) use ($arguments) {
+        return $this->findables->map(function($findable) use ($arguments) {
             return $this->initializeFindable($findable, $arguments);
         });
     }
@@ -198,7 +198,7 @@ 
             $findable = $this->instantiateFindableFromCallable($findable, $arguments);
         }
 
-        if (! $findable instanceof Findable) {
+        if ( ! $findable instanceof Findable) {
             throw new FailedToInstantiateFindable(
                 sprintf(
                     _('Could not instantiate Findable "%s".'),
@@ -222,7 +222,7 @@ 
      */
     protected function instantiateFindableFromString(string $string, $arguments = []): Findable
     {
-        return new $string(...(array)$arguments);
+        return new $string(...(array) $arguments);
     }
 
     /**
@@ -237,6 +237,6 @@ 
      */
     protected function instantiateFindableFromCallable(callable $callable, $arguments = []): Findable
     {
-        return $callable(...(array)$arguments);
+        return $callable(...(array) $arguments);
     }
 }