brightnucleus / view

src/View/View/AbstractView.php

Indentation +209 added lines, -209 removed lines

@@ -31,233 +31,233 @@
 abstract class AbstractView implements View
 {
 
-    /**
-     * URI of the view.
-     *
-     * The underscores are used to prevent accidental use of these properties from within the rendering closure.
-     *
-     * @since 0.1.0
-     *
-     * @var string
-     */
-    protected $_uri_;
+	/**
+	 * URI of the view.
+	 *
+	 * The underscores are used to prevent accidental use of these properties from within the rendering closure.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var string
+	 */
+	protected $_uri_;
 
-    /**
-     * Engine to use for the view.
-     *
-     * The underscores are used to prevent accidental use of these properties from within the rendering closure.
-     *
-     * @since 0.1.0
-     *
-     * @var Engine
-     */
-    protected $_engine_;
+	/**
+	 * Engine to use for the view.
+	 *
+	 * The underscores are used to prevent accidental use of these properties from within the rendering closure.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var Engine
+	 */
+	protected $_engine_;
 
-    /**
-     * ViewBuilder instance.
-     *
-     * The underscores are used to prevent accidental use of these properties from within the rendering closure.
-     *
-     * @since 0.2.0
-     *
-     * @var ViewBuilder
-     */
-    protected $_builder_;
+	/**
+	 * ViewBuilder instance.
+	 *
+	 * The underscores are used to prevent accidental use of these properties from within the rendering closure.
+	 *
+	 * @since 0.2.0
+	 *
+	 * @var ViewBuilder
+	 */
+	protected $_builder_;
 
-    /**
-     * The context with which the view will be rendered.
-     *
-     * The underscores are used to prevent accidental use of these properties from within the rendering closure.
-     *
-     * @since 0.4.0
-     *
-     * @var array
-     */
-    protected $_context_;
+	/**
+	 * The context with which the view will be rendered.
+	 *
+	 * The underscores are used to prevent accidental use of these properties from within the rendering closure.
+	 *
+	 * @since 0.4.0
+	 *
+	 * @var array
+	 */
+	protected $_context_;
 
-    /**
-     * Instantiate an AbstractView object.
-     *
-     * @since 0.1.0
-     *
-     * @param string      $uri         URI for the view.
-     * @param Engine      $engine      Engine to use for the view.
-     * @param ViewBuilder $viewBuilder View builder instance to use.
-     * @param array       $context     Initial context to use.
-     */
-    public function __construct(string $uri, Engine $engine, ViewBuilder $viewBuilder = null, array $context = [])
-    {
-        $this->_uri_     = $uri;
-        $this->_engine_  = $engine;
-        $this->_builder_ = $viewBuilder ?? Views::getViewBuilder();
-        $this->_context_ = $context;
-    }
+	/**
+	 * Instantiate an AbstractView object.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string      $uri         URI for the view.
+	 * @param Engine      $engine      Engine to use for the view.
+	 * @param ViewBuilder $viewBuilder View builder instance to use.
+	 * @param array       $context     Initial context to use.
+	 */
+	public function __construct(string $uri, Engine $engine, ViewBuilder $viewBuilder = null, array $context = [])
+	{
+		$this->_uri_     = $uri;
+		$this->_engine_  = $engine;
+		$this->_builder_ = $viewBuilder ?? Views::getViewBuilder();
+		$this->_context_ = $context;
+	}
 
-    /**
-     * Render the view.
-     *
-     * @since 0.1.0
-     *
-     * @param array $context Optional. The context in which to render the view.
-     * @param bool  $echo    Optional. Whether to echo the output immediately. Defaults to false.
-     *
-     * @return string Rendered HTML.
-     * @throws FailedToProcessConfigException If the Config could not be processed.
-     */
-    public function render(array $context = [], bool $echo = false): string
-    {
-        $this->assimilateContext($context);
+	/**
+	 * Render the view.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array $context Optional. The context in which to render the view.
+	 * @param bool  $echo    Optional. Whether to echo the output immediately. Defaults to false.
+	 *
+	 * @return string Rendered HTML.
+	 * @throws FailedToProcessConfigException If the Config could not be processed.
+	 */
+	public function render(array $context = [], bool $echo = false): string
+	{
+		$this->assimilateContext($context);
 
-        $closure = Closure::bind(
-            $this->_engine_->getRenderCallback($this->_uri_, $context),
-            $this,
-            static::class
-        );
+		$closure = Closure::bind(
+			$this->_engine_->getRenderCallback($this->_uri_, $context),
+			$this,
+			static::class
+		);
 
-        $output = $closure();
+		$output = $closure();
 
-        if ($echo) {
-            echo $output;
-        }
+		if ($echo) {
+			echo $output;
+		}
 
-        return $output;
-    }
+		return $output;
+	}
 
-    /**
-     * Render a partial view (or section) for a given URI.
-     *
-     * @since 0.2.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.
-     * @throws FailedToInstantiateView If the View could not be instantiated.
-     */
-    public function section(string $view, array $context = null, $type = null): string
-    {
-        $context = (null === $context)
-            ? $this->_context_
-            : array_merge($this->_context_, $context);
+	/**
+	 * Render a partial view (or section) for a given URI.
+	 *
+	 * @since 0.2.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.
+	 * @throws FailedToInstantiateView If the View could not be instantiated.
+	 */
+	public function section(string $view, array $context = null, $type = null): string
+	{
+		$context = (null === $context)
+			? $this->_context_
+			: array_merge($this->_context_, $context);
 
-        $viewObject = $this->_builder_->create($view, $type);
+		$viewObject = $this->_builder_->create($view, $type);
 
-        return $viewObject->render($context);
-    }
+		return $viewObject->render($context);
+	}
 
-    /**
-     * Get the entire array of contextual data.
-     *
-     * @since 0.4.0
-     *
-     * @return array Array of contextual data.
-     */
-    public function getContext(): array
-    {
-        return $this->_context_;
-    }
+	/**
+	 * Get the entire array of contextual data.
+	 *
+	 * @since 0.4.0
+	 *
+	 * @return array Array of contextual data.
+	 */
+	public function getContext(): array
+	{
+		return $this->_context_;
+	}
 
-    /**
-     * Add information to the context.
-     *
-     * @param string $key      Context key to add.
-     * @param mixed  $value    Value to add under the given key.
-     * @param string $behavior Behavior to use for adapting the context.
-     * @return View
-     */
-    public function addToContext( string $key, $value, string $behavior ): View
-    {
-        switch ($behavior) {
-            case View::REPLACE:
-                $this->_context_[$key] = $value;
-                return $this;
-            case View::MERGE:
-                if(array_key_exists($key, $this->_context_)) {
-                    $this->_context_ = array_merge_recursive($this->_context_, [$key => $value]);
-                    return $this;
-                }
-                $this->_context_[$key] = $value;
-                return $this;
-            case View::ADD_ONLY:
-                if (array_key_exists($key, $this->_context_)) {
-                    return $this;
-                }
-                $this->_context_[$key] = $value;
-                return $this;
-            case View::REPLACE_ONLY:
-                if (! array_key_exists($key, $this->_context_)) {
-                    return $this;
-                }
-                $this->_context_[$key] = $value;
-                return $this;
-            case View::MERGE_ONLY:
-                if (! array_key_exists($key, $this->_context_)) {
-                    return $this;
-                }
-                $this->_context_ = array_merge_recursive($this->_context_, [$key => $value]);
-                return $this;
-            default:
-                throw new InvalidContextAddingBehavior(
-                    sprintf(
-                        _('Invalid behavior "%s" for adding to the context of view "%s".'),
-                        $key,
-                        $this->_uri_
-                    )
-                );
-        }
-    }
+	/**
+	 * Add information to the context.
+	 *
+	 * @param string $key      Context key to add.
+	 * @param mixed  $value    Value to add under the given key.
+	 * @param string $behavior Behavior to use for adapting the context.
+	 * @return View
+	 */
+	public function addToContext( string $key, $value, string $behavior ): View
+	{
+		switch ($behavior) {
+			case View::REPLACE:
+				$this->_context_[$key] = $value;
+				return $this;
+			case View::MERGE:
+				if(array_key_exists($key, $this->_context_)) {
+					$this->_context_ = array_merge_recursive($this->_context_, [$key => $value]);
+					return $this;
+				}
+				$this->_context_[$key] = $value;
+				return $this;
+			case View::ADD_ONLY:
+				if (array_key_exists($key, $this->_context_)) {
+					return $this;
+				}
+				$this->_context_[$key] = $value;
+				return $this;
+			case View::REPLACE_ONLY:
+				if (! array_key_exists($key, $this->_context_)) {
+					return $this;
+				}
+				$this->_context_[$key] = $value;
+				return $this;
+			case View::MERGE_ONLY:
+				if (! array_key_exists($key, $this->_context_)) {
+					return $this;
+				}
+				$this->_context_ = array_merge_recursive($this->_context_, [$key => $value]);
+				return $this;
+			default:
+				throw new InvalidContextAddingBehavior(
+					sprintf(
+						_('Invalid behavior "%s" for adding to the context of view "%s".'),
+						$key,
+						$this->_uri_
+					)
+				);
+		}
+	}
 
-    /**
-     * Associate a view builder with this view.
-     *
-     * @since 0.2.0
-     *
-     * @param ViewBuilder $builder
-     *
-     * @return View
-     */
-    public function setBuilder(ViewBuilder $builder): View
-    {
-        $this->_builder_ = $builder;
+	/**
+	 * Associate a view builder with this view.
+	 *
+	 * @since 0.2.0
+	 *
+	 * @param ViewBuilder $builder
+	 *
+	 * @return View
+	 */
+	public function setBuilder(ViewBuilder $builder): View
+	{
+		$this->_builder_ = $builder;
 
-        return $this;
-    }
+		return $this;
+	}
 
-    /**
-     * Assimilate the context to make it available as properties.
-     *
-     * @since 0.2.0
-     *
-     * @param array $context Context to assimilate.
-     */
-    protected function assimilateContext(array $context = [])
-    {
-        $this->_context_ = $context;
-        foreach ($context as $key => $value) {
-            $this->$key = $value;
-        }
-    }
+	/**
+	 * Assimilate the context to make it available as properties.
+	 *
+	 * @since 0.2.0
+	 *
+	 * @param array $context Context to assimilate.
+	 */
+	protected function assimilateContext(array $context = [])
+	{
+		$this->_context_ = $context;
+		foreach ($context as $key => $value) {
+			$this->$key = $value;
+		}
+	}
 
-    /**
-     * Turn invokable objects as properties into methods of the view.
-     *
-     * @param string $method    Method that was called on the view.
-     * @param array  $arguments Array of arguments that were used.
-     * @return mixed Return value of the invokable object.
-     */
-    public function __call($method, $arguments) {
-        if ( ! property_exists($this, $method)
-             || ! is_callable($this->$method)) {
-            trigger_error(
-                "Call to undefined method {$method} on a view.",
-                E_USER_ERROR
-            );
-        }
+	/**
+	 * Turn invokable objects as properties into methods of the view.
+	 *
+	 * @param string $method    Method that was called on the view.
+	 * @param array  $arguments Array of arguments that were used.
+	 * @return mixed Return value of the invokable object.
+	 */
+	public function __call($method, $arguments) {
+		if ( ! property_exists($this, $method)
+			 || ! is_callable($this->$method)) {
+			trigger_error(
+				"Call to undefined method {$method} on a view.",
+				E_USER_ERROR
+			);
+		}
 
-        $callable = $this->$method;
+		$callable = $this->$method;
 
-        return $callable(...$arguments);
-    }
+		return $callable(...$arguments);
+	}
 }

src/View/ViewBuilder.php

Indentation +300 added lines, -300 removed lines

@@ -33,305 +33,305 @@
 class ViewBuilder
 {
 
-    use ConfigTrait;
-
-    const ENGINE_FINDER_KEY = 'EngineFinder';
-    const VIEW_FINDER_KEY = 'ViewFinder';
-
-    /**
-     * BaseViewFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @var ViewFinder
-     */
-    protected $viewFinder;
-
-    /**
-     * BaseEngineFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @var EngineFinder
-     */
-    protected $engineFinder;
-
-    /**
-     * Locations to scan for views.
-     *
-     * @since 0.1.0
-     *
-     * @var Locations
-     */
-    protected $locations;
-
-    /**
-     * Cache of already resolved view paths.
-     *
-     * @since 0.4.6
-     *
-     * @var string[]
-     */
-    protected $viewPathCache = [];
-
-    /**
-     * Instantiate a ViewBuilder object.
-     *
-     * @since 0.1.0
-     *
-     * @param ConfigInterface   $config       Optional. Configuration settings.
-     * @param ViewFinder|null   $viewFinder   Optional. ViewFinder instance.
-     * @param EngineFinder|null $engineFinder Optional. EngineFinder instance.
-     *
-     * @throws FailedToProcessConfigException If the config could not be processed.
-     */
-    public function __construct(
-        ConfigInterface $config = null,
-        ViewFinder $viewFinder = null,
-        EngineFinder $engineFinder = null
-    ) {
-        $this->processConfig($this->getConfig($config));
-        $this->viewFinder   = $viewFinder ?? $this->getViewFinder();
-        $this->engineFinder = $engineFinder ?? $this->getEngineFinder();
-        $this->locations    = new Locations();
-    }
-
-    /**
-     * Create a new view for a given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string $view View identifier to create a view for.
-     * @param mixed  $type Type of view to create.
-     *
-     * @return View Instance of the requested view.
-     * @throws FailedToInstantiateView If the view could not be instantiated.
-     */
-    public function create(string $view, $type = null): View
-    {
-        if (!array_key_exists($view, $this->viewPathCache)) {
-            $uri    = $this->scanLocations([$view]);
-            $engine = $uri ? $this->getEngine($uri) : false;
-
-            $this->viewPathCache[$view]           = [];
-            $this->viewPathCache[$view]['uri']    = $uri;
-            $this->viewPathCache[$view]['engine'] = $engine;
-
-            if ($type===null) {
-                $this->viewPathCache[$view]['view'] = $uri
-                    ? $this->getView($uri, $engine)
-                    : false;
-            }
-        } else {
-            $uri    = $this->viewPathCache[$view]['uri'];
-            $engine = $this->viewPathCache[$view]['engine'];
-        }
-
-
-        if (!$uri || !$engine) {
-            return $this->getViewFinder()->getNullObject();
-        }
-
-        if ($type === null) {
-            return $this->viewPathCache[$view]['view'];
-        }
-
-        return $this->getView($uri, $engine, $type);
-    }
-
-    /**
-     * Get an Engine that can deal with the given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string $uri URI to get an engine for.
-     *
-     * @return Engine Instance of an engine that can deal with the given URI.
-     */
-    public function getEngine(string $uri): Engine
-    {
-        return $this->getEngineFinder()->find([$uri]);
-    }
-
-    /**
-     * Get a view for a given URI, engine and type.
-     *
-     * @since 0.1.0
-     *
-     * @param string $uri    URI to get a view for.
-     * @param Engine $engine Engine to use for the view.
-     * @param mixed  $type   Type of view to get.
-     *
-     * @return View View that matches the given requirements.
-     * @throws FailedToInstantiateView If the view could not be instantiated.
-     */
-    public function getView(string $uri, Engine $engine, $type = null): View
-    {
-        if (null === $type) {
-            $view = $this->getViewFinder()->find([$uri], $engine);
-            return $view->setBuilder( $this );
-        }
-
-        return $this->resolveType($type, $uri, $engine);
-    }
-
-    /**
-     * Get the ViewFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @return ViewFinder Instance of a BaseViewFinder.
-     */
-    public function getViewFinder(): ViewFinder
-    {
-        return $this->viewFinder ?? $this->getFinder(static::VIEW_FINDER_KEY);
-    }
-
-    /**
-     * Get the EngineFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @return EngineFinder Instance of a BaseEngineFinder.
-     */
-    public function getEngineFinder(): EngineFinder
-    {
-        return $this->engineFinder ?? $this->getFinder(static::ENGINE_FINDER_KEY);
-    }
-
-    /**
-     * Add a location to scan with the BaseViewFinder.
-     *
-     * @since 0.1.0
-     *
-     * @param Location $location Location to scan with the BaseViewFinder.
-     *
-     * @return static
-     */
-    public function addLocation(Location $location)
-    {
-        $this->locations->add($location);
-
-        unset( $this->viewPathCache );
-        $this->viewPathCache = [];
-
-        return $this;
-    }
-
-    /**
-     * Get the collection of locations registered with this ViewBuilder.
-     *
-     * @since 0.1.3
-     *
-     * @return Locations Collection of locations.
-     */
-    public function getLocations()
-    {
-        return $this->locations;
-    }
-
-    /**
-     * Scan Locations for an URI that matches the specified criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array $criteria Criteria to match.
-     *
-     * @return string|false URI of the requested view, or false if not found.
-     */
-    public function scanLocations(array $criteria)
-    {
-        $uris = $this->locations->map(function ($location) use ($criteria) {
-            /** @var Location $location */
-            return $location->getURI($criteria);
-        })->filter(function ($uri) {
-            return false !== $uri;
-        });
+	use ConfigTrait;
+
+	const ENGINE_FINDER_KEY = 'EngineFinder';
+	const VIEW_FINDER_KEY = 'ViewFinder';
+
+	/**
+	 * BaseViewFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var ViewFinder
+	 */
+	protected $viewFinder;
+
+	/**
+	 * BaseEngineFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var EngineFinder
+	 */
+	protected $engineFinder;
+
+	/**
+	 * Locations to scan for views.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var Locations
+	 */
+	protected $locations;
+
+	/**
+	 * Cache of already resolved view paths.
+	 *
+	 * @since 0.4.6
+	 *
+	 * @var string[]
+	 */
+	protected $viewPathCache = [];
+
+	/**
+	 * Instantiate a ViewBuilder object.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param ConfigInterface   $config       Optional. Configuration settings.
+	 * @param ViewFinder|null   $viewFinder   Optional. ViewFinder instance.
+	 * @param EngineFinder|null $engineFinder Optional. EngineFinder instance.
+	 *
+	 * @throws FailedToProcessConfigException If the config could not be processed.
+	 */
+	public function __construct(
+		ConfigInterface $config = null,
+		ViewFinder $viewFinder = null,
+		EngineFinder $engineFinder = null
+	) {
+		$this->processConfig($this->getConfig($config));
+		$this->viewFinder   = $viewFinder ?? $this->getViewFinder();
+		$this->engineFinder = $engineFinder ?? $this->getEngineFinder();
+		$this->locations    = new Locations();
+	}
+
+	/**
+	 * Create a new view for a given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $view View identifier to create a view for.
+	 * @param mixed  $type Type of view to create.
+	 *
+	 * @return View Instance of the requested view.
+	 * @throws FailedToInstantiateView If the view could not be instantiated.
+	 */
+	public function create(string $view, $type = null): View
+	{
+		if (!array_key_exists($view, $this->viewPathCache)) {
+			$uri    = $this->scanLocations([$view]);
+			$engine = $uri ? $this->getEngine($uri) : false;
+
+			$this->viewPathCache[$view]           = [];
+			$this->viewPathCache[$view]['uri']    = $uri;
+			$this->viewPathCache[$view]['engine'] = $engine;
+
+			if ($type===null) {
+				$this->viewPathCache[$view]['view'] = $uri
+					? $this->getView($uri, $engine)
+					: false;
+			}
+		} else {
+			$uri    = $this->viewPathCache[$view]['uri'];
+			$engine = $this->viewPathCache[$view]['engine'];
+		}
+
+
+		if (!$uri || !$engine) {
+			return $this->getViewFinder()->getNullObject();
+		}
+
+		if ($type === null) {
+			return $this->viewPathCache[$view]['view'];
+		}
+
+		return $this->getView($uri, $engine, $type);
+	}
+
+	/**
+	 * Get an Engine that can deal with the given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $uri URI to get an engine for.
+	 *
+	 * @return Engine Instance of an engine that can deal with the given URI.
+	 */
+	public function getEngine(string $uri): Engine
+	{
+		return $this->getEngineFinder()->find([$uri]);
+	}
+
+	/**
+	 * Get a view for a given URI, engine and type.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $uri    URI to get a view for.
+	 * @param Engine $engine Engine to use for the view.
+	 * @param mixed  $type   Type of view to get.
+	 *
+	 * @return View View that matches the given requirements.
+	 * @throws FailedToInstantiateView If the view could not be instantiated.
+	 */
+	public function getView(string $uri, Engine $engine, $type = null): View
+	{
+		if (null === $type) {
+			$view = $this->getViewFinder()->find([$uri], $engine);
+			return $view->setBuilder( $this );
+		}
+
+		return $this->resolveType($type, $uri, $engine);
+	}
+
+	/**
+	 * Get the ViewFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return ViewFinder Instance of a BaseViewFinder.
+	 */
+	public function getViewFinder(): ViewFinder
+	{
+		return $this->viewFinder ?? $this->getFinder(static::VIEW_FINDER_KEY);
+	}
+
+	/**
+	 * Get the EngineFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return EngineFinder Instance of a BaseEngineFinder.
+	 */
+	public function getEngineFinder(): EngineFinder
+	{
+		return $this->engineFinder ?? $this->getFinder(static::ENGINE_FINDER_KEY);
+	}
+
+	/**
+	 * Add a location to scan with the BaseViewFinder.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param Location $location Location to scan with the BaseViewFinder.
+	 *
+	 * @return static
+	 */
+	public function addLocation(Location $location)
+	{
+		$this->locations->add($location);
+
+		unset( $this->viewPathCache );
+		$this->viewPathCache = [];
+
+		return $this;
+	}
+
+	/**
+	 * Get the collection of locations registered with this ViewBuilder.
+	 *
+	 * @since 0.1.3
+	 *
+	 * @return Locations Collection of locations.
+	 */
+	public function getLocations()
+	{
+		return $this->locations;
+	}
+
+	/**
+	 * Scan Locations for an URI that matches the specified criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array $criteria Criteria to match.
+	 *
+	 * @return string|false URI of the requested view, or false if not found.
+	 */
+	public function scanLocations(array $criteria)
+	{
+		$uris = $this->locations->map(function ($location) use ($criteria) {
+			/** @var Location $location */
+			return $location->getURI($criteria);
+		})->filter(function ($uri) {
+			return false !== $uri;
+		});
         
-        // Fall back for absolute paths on current filesystem.
-        if ($uris->isEmpty()) {
-            foreach ($criteria as $criterion) {
-                if (file_exists($criterion)) {
-                    return $criterion;
-                }
-            }
-        }
-
-        return $uris->isEmpty() ? false : $uris->first();
-    }
-
-    /**
-     * Get a finder instance.
-     *
-     * @since 0.1.1
-     *
-     * @param string $key Configuration key to use.
-     *
-     * @return ViewFinder|EngineFinder The requested finder instance.
-     */
-    protected function getFinder($key)
-    {
-        $finderClass = $this->config->getKey($key, 'ClassName');
-        return new $finderClass($this->config->getSubConfig($key));
-    }
-
-    /**
-     * Resolve the view type.
-     *
-     * @since 0.1.0
-     *
-     * @param mixed       $type   Type of view that was requested.
-     * @param string      $uri    URI to get a view for.
-     * @param Engine|null $engine Engine to use for the view.
-     *
-     * @return View Resolved View object.
-     * @throws FailedToInstantiateView If the view type could not be resolved.
-     */
-    protected function resolveType($type, string $uri, Engine $engine = null): View
-    {
-        $configKey = [static::VIEW_FINDER_KEY, 'Views', $type];
-
-        if (is_string($type) && $this->config->hasKey($configKey)) {
-            $className = $this->config->getKey($configKey);
-            $type      = new $className($uri, $engine, $this);
-        }
-
-        if (is_string($type)) {
-            $type = new $type($uri, $engine, $this);
-        }
-
-        if (is_callable($type)) {
-            $type = $type($uri, $engine, $this);
-        }
-
-        if (! $type instanceof View) {
-            throw new FailedToInstantiateView(
-                sprintf(
-                    _('Could not instantiate view "%s".'),
-                    serialize($type)
-                )
-            );
-        }
-
-        return $type;
-    }
-
-    /**
-     * Get the configuration to use in the ViewBuilder.
-     *
-     * @since 0.2.0
-     *
-     * @param ConfigInterface|array $config Config to merge with defaults.
-     *
-     * @return ConfigInterface Configuration passed in through the constructor.
-     */
-    protected function getConfig($config = []): ConfigInterface
-    {
-        $defaults = ConfigFactory::create(dirname(__DIR__, 2) . '/config/defaults.php', $config);
-        $config   = $config
-            ? ConfigFactory::createFromArray(array_merge_recursive($defaults->getArrayCopy(), $config->getArrayCopy()))
-            : $defaults;
-
-        return $config->getSubConfig('BrightNucleus\View');
-    }
+		// Fall back for absolute paths on current filesystem.
+		if ($uris->isEmpty()) {
+			foreach ($criteria as $criterion) {
+				if (file_exists($criterion)) {
+					return $criterion;
+				}
+			}
+		}
+
+		return $uris->isEmpty() ? false : $uris->first();
+	}
+
+	/**
+	 * Get a finder instance.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param string $key Configuration key to use.
+	 *
+	 * @return ViewFinder|EngineFinder The requested finder instance.
+	 */
+	protected function getFinder($key)
+	{
+		$finderClass = $this->config->getKey($key, 'ClassName');
+		return new $finderClass($this->config->getSubConfig($key));
+	}
+
+	/**
+	 * Resolve the view type.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param mixed       $type   Type of view that was requested.
+	 * @param string      $uri    URI to get a view for.
+	 * @param Engine|null $engine Engine to use for the view.
+	 *
+	 * @return View Resolved View object.
+	 * @throws FailedToInstantiateView If the view type could not be resolved.
+	 */
+	protected function resolveType($type, string $uri, Engine $engine = null): View
+	{
+		$configKey = [static::VIEW_FINDER_KEY, 'Views', $type];
+
+		if (is_string($type) && $this->config->hasKey($configKey)) {
+			$className = $this->config->getKey($configKey);
+			$type      = new $className($uri, $engine, $this);
+		}
+
+		if (is_string($type)) {
+			$type = new $type($uri, $engine, $this);
+		}
+
+		if (is_callable($type)) {
+			$type = $type($uri, $engine, $this);
+		}
+
+		if (! $type instanceof View) {
+			throw new FailedToInstantiateView(
+				sprintf(
+					_('Could not instantiate view "%s".'),
+					serialize($type)
+				)
+			);
+		}
+
+		return $type;
+	}
+
+	/**
+	 * Get the configuration to use in the ViewBuilder.
+	 *
+	 * @since 0.2.0
+	 *
+	 * @param ConfigInterface|array $config Config to merge with defaults.
+	 *
+	 * @return ConfigInterface Configuration passed in through the constructor.
+	 */
+	protected function getConfig($config = []): ConfigInterface
+	{
+		$defaults = ConfigFactory::create(dirname(__DIR__, 2) . '/config/defaults.php', $config);
+		$config   = $config
+			? ConfigFactory::createFromArray(array_merge_recursive($defaults->getArrayCopy(), $config->getArrayCopy()))
+			: $defaults;
+
+		return $config->getSubConfig('BrightNucleus\View');
+	}
 }

src/View/Location/FilesystemLocation.php

Indentation +181 added lines, -181 removed lines

@@ -28,185 +28,185 @@
 class FilesystemLocation implements Location
 {
 
-    /**
-     * Path that this location points to.
-     *
-     * @since 0.1.0
-     *
-     * @var string
-     */
-    protected $path;
-
-    /**
-     * Extensions that this location can accept.
-     *
-     * @since 0.1.0
-     *
-     * @var Extensions
-     */
-    protected $extensions;
-
-    /**
-     * Instantiate a FilesystemLocation object.
-     *
-     * @since 0.1.0
-     *
-     * @param string                       $path       Path that this location points to.
-     * @param Extensions|array|string|null $extensions Optional. Extensions that this location can accept.
-     */
-    public function __construct(string $path, $extensions = null)
-    {
-        $this->path       = $path;
-        $this->extensions = $this->validateExtensions($extensions);
-    }
-
-    /**
-     * 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)
-    {
-        $uris = $this->getURIs($criteria);
-
-        return $uris->count() > 0
-            ? $uris->first()
-            : false;
-    }
-
-    /**
-     * Get all URIs that match the given criteria.
-     *
-     * @since 0.1.1
-     *
-     * @param array $criteria Criteria to match.
-     *
-     * @return URIs URIs that match the criteria or an empty collection if none found.
-     */
-    public function getURIs(array $criteria): URIs
-    {
-        $uris = new URIs();
-
-        foreach ($this->extensions as $extension) {
-            $finder = new Finder();
-
-            try {
-            	bdump( $this->getPathPattern($this->getRelativePath($criteria)) );
-                $finder->files()
-                    ->name($this->getNamePattern($criteria, $extension))
-                    ->in($this->getPathPattern($this->getRelativePath($criteria)));
-                foreach ($finder as $file) {
-                    /** @var SplFileInfo $file */
-                    $uris->add($file->getPathname());
-                }
-            } catch (Exception $exception) {
-                // Fail silently;
-            }
-        }
-
-        return $uris;
-    }
-
-    /**
-     * Get the name pattern to pass to the file finder.
-     *
-     * @since 0.1.3
-     *
-     * @param array  $criteria  Criteria to match.
-     * @param string $extension Extension to match.
-     *
-     * @return string Name pattern to pass to the file finder.
-     */
-    protected function getNamePattern(array $criteria, string $extension): string
-    {
-        $names = [];
-
-        $names[] = array_map(function ($criterion) use ($extension) {
-            $uriExtension = URIHelper::containsExtension($criterion);
-            if (! empty($extension)) {
-                $extension = ltrim($extension, '.');
-
-                if ($uriExtension === $extension) {
-                    $criterion = substr($criterion,0,-strlen(".{$extension}"));
-                }
-            } else {
-                $extension = URIHelper::containsExtension($criterion);
-                if (!empty($extension)) {
-                    $criterion = substr($criterion,0,-strlen(".{$extension}"));
-                }
-            }
-
-            $criterion = preg_quote(URIHelper::getFilename($criterion), chr(1));
-
-            return (empty($extension) || URIHelper::hasExtension($criterion, $extension))
-                ? "{$criterion}(?:\..*?)$"
-                : "{$criterion}\.{$extension}$";
-        }, $criteria)[0];
-
-        return chr(1) . implode('|', array_unique($names)) . chr(1);
-    }
-
-    /**
-     * Get the path pattern to pass to the file finder.
-     *
-     * @since 0.4.7
-     *
-     * @param string $relativePath Relative path that was included in the
-     *                             criterion.
-     * @return string Path pattern to pass to the file finder.
-     */
-    protected function getPathPattern(string $relativePath): string
-    {
-        if (empty($relativePath)) {
-            return $this->path;
-        }
-
-        return rtrim($this->path,'/') . '/' . ltrim($relativePath, '/');
-    }
-
-    /**
-     * Get the relative path that is included in the criterion.
-     *
-     * @since 0.4.7
-     *
-     * @param array $criteria Criteria to extract the relative path from.
-     * @return string Relative path included in the criterion.
-     */
-    protected function getRelativePath($criteria): string
-    {
-        $criterion  = current($criteria);
-        $components = explode('/', $criterion);
-
-        if (count($components) < 2) {
-            return '';
-        }
-
-        return implode('/', array_slice($components, 0, -1));
-    }
-
-    /**
-     * Validate the extensions and return a collection.
-     *
-     * @since 0.1.1
-     *
-     * @param Extensions|array|string|null $extensions Extensions to validate.
-     *
-     * @return Extensions Validated extensions collection.
-     */
-    protected function validateExtensions($extensions): Extensions
-    {
-        if (empty($extensions)) {
-            $extensions = new Extensions(['']);
-        }
-
-        if (! $extensions instanceof Extensions) {
-            $extensions = new Extensions((array)$extensions);
-        }
-
-        return $extensions;
-    }
+	/**
+	 * Path that this location points to.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var string
+	 */
+	protected $path;
+
+	/**
+	 * Extensions that this location can accept.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var Extensions
+	 */
+	protected $extensions;
+
+	/**
+	 * Instantiate a FilesystemLocation object.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string                       $path       Path that this location points to.
+	 * @param Extensions|array|string|null $extensions Optional. Extensions that this location can accept.
+	 */
+	public function __construct(string $path, $extensions = null)
+	{
+		$this->path       = $path;
+		$this->extensions = $this->validateExtensions($extensions);
+	}
+
+	/**
+	 * 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)
+	{
+		$uris = $this->getURIs($criteria);
+
+		return $uris->count() > 0
+			? $uris->first()
+			: false;
+	}
+
+	/**
+	 * Get all URIs that match the given criteria.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param array $criteria Criteria to match.
+	 *
+	 * @return URIs URIs that match the criteria or an empty collection if none found.
+	 */
+	public function getURIs(array $criteria): URIs
+	{
+		$uris = new URIs();
+
+		foreach ($this->extensions as $extension) {
+			$finder = new Finder();
+
+			try {
+				bdump( $this->getPathPattern($this->getRelativePath($criteria)) );
+				$finder->files()
+					->name($this->getNamePattern($criteria, $extension))
+					->in($this->getPathPattern($this->getRelativePath($criteria)));
+				foreach ($finder as $file) {
+					/** @var SplFileInfo $file */
+					$uris->add($file->getPathname());
+				}
+			} catch (Exception $exception) {
+				// Fail silently;
+			}
+		}
+
+		return $uris;
+	}
+
+	/**
+	 * Get the name pattern to pass to the file finder.
+	 *
+	 * @since 0.1.3
+	 *
+	 * @param array  $criteria  Criteria to match.
+	 * @param string $extension Extension to match.
+	 *
+	 * @return string Name pattern to pass to the file finder.
+	 */
+	protected function getNamePattern(array $criteria, string $extension): string
+	{
+		$names = [];
+
+		$names[] = array_map(function ($criterion) use ($extension) {
+			$uriExtension = URIHelper::containsExtension($criterion);
+			if (! empty($extension)) {
+				$extension = ltrim($extension, '.');
+
+				if ($uriExtension === $extension) {
+					$criterion = substr($criterion,0,-strlen(".{$extension}"));
+				}
+			} else {
+				$extension = URIHelper::containsExtension($criterion);
+				if (!empty($extension)) {
+					$criterion = substr($criterion,0,-strlen(".{$extension}"));
+				}
+			}
+
+			$criterion = preg_quote(URIHelper::getFilename($criterion), chr(1));
+
+			return (empty($extension) || URIHelper::hasExtension($criterion, $extension))
+				? "{$criterion}(?:\..*?)$"
+				: "{$criterion}\.{$extension}$";
+		}, $criteria)[0];
+
+		return chr(1) . implode('|', array_unique($names)) . chr(1);
+	}
+
+	/**
+	 * Get the path pattern to pass to the file finder.
+	 *
+	 * @since 0.4.7
+	 *
+	 * @param string $relativePath Relative path that was included in the
+	 *                             criterion.
+	 * @return string Path pattern to pass to the file finder.
+	 */
+	protected function getPathPattern(string $relativePath): string
+	{
+		if (empty($relativePath)) {
+			return $this->path;
+		}
+
+		return rtrim($this->path,'/') . '/' . ltrim($relativePath, '/');
+	}
+
+	/**
+	 * Get the relative path that is included in the criterion.
+	 *
+	 * @since 0.4.7
+	 *
+	 * @param array $criteria Criteria to extract the relative path from.
+	 * @return string Relative path included in the criterion.
+	 */
+	protected function getRelativePath($criteria): string
+	{
+		$criterion  = current($criteria);
+		$components = explode('/', $criterion);
+
+		if (count($components) < 2) {
+			return '';
+		}
+
+		return implode('/', array_slice($components, 0, -1));
+	}
+
+	/**
+	 * Validate the extensions and return a collection.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param Extensions|array|string|null $extensions Extensions to validate.
+	 *
+	 * @return Extensions Validated extensions collection.
+	 */
+	protected function validateExtensions($extensions): Extensions
+	{
+		if (empty($extensions)) {
+			$extensions = new Extensions(['']);
+		}
+
+		if (! $extensions instanceof Extensions) {
+			$extensions = new Extensions((array)$extensions);
+		}
+
+		return $extensions;
+	}
 }