lenevor / syscodes

src/components/Routing/Route.php

Indentation +666 added lines, -666 removed lines

@@ -41,686 +41,686 @@
  */
 class Route 
 {
-	use Concerns\RouteCondition,
-	    Concerns\RouteDependencyResolver;
+    use Concerns\RouteCondition,
+        Concerns\RouteDependencyResolver;
 	
-	/**
-	 * Action that the route will use when called.
-	 *
-	 * @var \Closure|string|array $action
-	 */
-	public $action;
-
-	/**
-	 * The container instance used by the route.
-	 * 
-	 * @var \Syscodes\Container\Container $container
-	 */
-	protected $container;
-
-	/**
-	 * The controller instance.
-	 * 
-	 * @var string $controller
-	 */
-	public $controller;
-
-	/**
-	 * The default values for the route.
-	 * 
-	 * @var array $defaults
-	 */
-	public $defaults = [];
-
-	/**
-	 * Variable of HTTP method.
-	 *  
-	 * @var array|string $method
-	 */
-	public $method;
-
-	/**
-	 * The array of matched parameters.
-	 * 
-	 * @var array $parameters
-	 */
-	public $parameters = [];
-
-	/**
-	 * The parameter names for the route.
-	 * 
-	 * @var string|null $parameterNames
-	 */
-	public $parameterNames;
-
-	/**
-	* Patterns that should be replaced.
-	*
-	* @var array $patterns 
-	*/
-	public $patterns = [
-		'~/~'                    =>  '\/',               // Slash
-		'~{an:[^\/{}]+}~'        => '([0-9a-zA-Z]++)',   // Placeholder accepts alphabetic and numeric chars
-		'~{n:[^\/{}]+}~'         => '([0-9]++)',         // Placeholder accepts only numeric
-		'~{a:[^\/{}]+}~'         => '([a-zA-Z]++)',      // Placeholder accepts only alphabetic chars
-		'~{w:[^\/{}]+}~'         => '([0-9a-zA-Z-_]++)', // Placeholder accepts alphanumeric and underscore
-		'~{\*:[^\/{}]+}~'        => '(.++)',             // Placeholder match rest of url
-		'~(\\\/)?{\?:[^\/{}]+}~' => '\/?([^\/]*)',		 // Optional placeholder
-		'~{[^\/{}]+}~'           => '([^\/]++)'			 // Normal placeholder
-	];
-
-	/**
-	 * The URI pattern the route responds to.
-	 *
-	 * @var array $uri
-	 */
-	public $uri = [];
-
-	/**
-	 * Contains the arguments of the current route.
-	 *
-	 * @var array $where
-	 */
-	public $wheres = [];
-
-	/**
-	 * Constructor. Initialize route.
-	 *
-	 * @param  array|string|null  $method  (null by default)
-	 * @param  string|null  $uri  (null by default)
-	 * @param  \Closure|string|null  $action  (null by default)
-	 *
-	 * @return void
-	 */
-	public function __construct($method = null, $uri = null, $action = null)
-	{
-		$this->uri = $uri;
-
-		// Set the method
-		$this->parseMethod($method);
-
-		// Set the action
-		$this->parseAction($action);
-
-		if (is_null($prefix = Arr::get($this->action, 'prefix')))
-		{
-			$this->prefix($prefix);
-		}
-	}
-
-	// Getters
-
-	/**
-	 * Get the action of the current route.
-	 *
-	 * @return \Closure|string
-	 */
-	public function getAction()
-	{
-		return $this->action;
-	}
-
-	/**
-	 * Get the arguments of the current route.
-	 *
-	 * @return string
-	 */
-	public function getArguments()
-	{
-		return $this->wheres;
-	}
-
-	/**
-	 * Get the controller instance for the route.
-	 * 
-	 * @return mixed
-	 */
-	public function getController()
-	{
-		if ( ! $this->controller)
-		{
-			$class = $this->parseControllerCallback()[0];
+    /**
+     * Action that the route will use when called.
+     *
+     * @var \Closure|string|array $action
+     */
+    public $action;
+
+    /**
+     * The container instance used by the route.
+     * 
+     * @var \Syscodes\Container\Container $container
+     */
+    protected $container;
+
+    /**
+     * The controller instance.
+     * 
+     * @var string $controller
+     */
+    public $controller;
+
+    /**
+     * The default values for the route.
+     * 
+     * @var array $defaults
+     */
+    public $defaults = [];
+
+    /**
+     * Variable of HTTP method.
+     *  
+     * @var array|string $method
+     */
+    public $method;
+
+    /**
+     * The array of matched parameters.
+     * 
+     * @var array $parameters
+     */
+    public $parameters = [];
+
+    /**
+     * The parameter names for the route.
+     * 
+     * @var string|null $parameterNames
+     */
+    public $parameterNames;
+
+    /**
+     * Patterns that should be replaced.
+     *
+     * @var array $patterns 
+     */
+    public $patterns = [
+        '~/~'                    =>  '\/',               // Slash
+        '~{an:[^\/{}]+}~'        => '([0-9a-zA-Z]++)',   // Placeholder accepts alphabetic and numeric chars
+        '~{n:[^\/{}]+}~'         => '([0-9]++)',         // Placeholder accepts only numeric
+        '~{a:[^\/{}]+}~'         => '([a-zA-Z]++)',      // Placeholder accepts only alphabetic chars
+        '~{w:[^\/{}]+}~'         => '([0-9a-zA-Z-_]++)', // Placeholder accepts alphanumeric and underscore
+        '~{\*:[^\/{}]+}~'        => '(.++)',             // Placeholder match rest of url
+        '~(\\\/)?{\?:[^\/{}]+}~' => '\/?([^\/]*)',		 // Optional placeholder
+        '~{[^\/{}]+}~'           => '([^\/]++)'			 // Normal placeholder
+    ];
+
+    /**
+     * The URI pattern the route responds to.
+     *
+     * @var array $uri
+     */
+    public $uri = [];
+
+    /**
+     * Contains the arguments of the current route.
+     *
+     * @var array $where
+     */
+    public $wheres = [];
+
+    /**
+     * Constructor. Initialize route.
+     *
+     * @param  array|string|null  $method  (null by default)
+     * @param  string|null  $uri  (null by default)
+     * @param  \Closure|string|null  $action  (null by default)
+     *
+     * @return void
+     */
+    public function __construct($method = null, $uri = null, $action = null)
+    {
+        $this->uri = $uri;
+
+        // Set the method
+        $this->parseMethod($method);
+
+        // Set the action
+        $this->parseAction($action);
+
+        if (is_null($prefix = Arr::get($this->action, 'prefix')))
+        {
+            $this->prefix($prefix);
+        }
+    }
+
+    // Getters
+
+    /**
+     * Get the action of the current route.
+     *
+     * @return \Closure|string
+     */
+    public function getAction()
+    {
+        return $this->action;
+    }
+
+    /**
+     * Get the arguments of the current route.
+     *
+     * @return string
+     */
+    public function getArguments()
+    {
+        return $this->wheres;
+    }
+
+    /**
+     * Get the controller instance for the route.
+     * 
+     * @return mixed
+     */
+    public function getController()
+    {
+        if ( ! $this->controller)
+        {
+            $class = $this->parseControllerCallback()[0];
  
-			$this->controller = $this->container->make(ltrim($class, '\\'));
-		}
-
-		return $this->controller;
-	}
-
-	/**
-	 * Get the controller method used for the route.
-	 * 
-	 * @return string
-	 */
-	public function getControllerMethod()
-	{
-		return $this->parseControllerCallback()[1];
-	}
-
-	/**
-	 * Get the request method of the current route.
-	 *
-	 * @return array
-	 */
-	public function getMethod()
-	{
-		return $this->method;
-	}
-
-	/**
-	 * Get the url of the current route.
-	 *
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->action['as'] ?? null;
-	}
-
-	/**
-	 * Get the url of the current route.
-	 *
-	 * @return string
-	 */
-	public function getRoute()
-	{
-		return $this->uri;
-	}
-
-	/**
-	 * Get or set the domain for the route.
-	 * 
-	 * @param  string|null  $domain  (null by default)
-	 * 
-	 * @return $this
-	 */
-	public function domain($domain = null)
-	{
-		if (is_null($domain))
-		{
-			return $this->getDomain();
-		}
-
-		$this->action['domain'] = $this->parseRoute($domain);
-
-		return $this;
-	}
-
-	/**
-	 * Get the domain defined for the route.
-	 * 
-	 * @return string|null
-	 */
-	public function getDomain()
-	{
-		return isset($this->action['domain'])
-				? str_replace(['http://', 'https://'], '', $this->action['domain'])
-				: null;
-	}
-
-	/**
-	 * Parse the controller.
-	 * 
-	 * @return array
-	 */
-	public function parseControllerCallback()
-	{
-		return Str::parseCallback($this->action['uses']);
-	}
+            $this->controller = $this->container->make(ltrim($class, '\\'));
+        }
+
+        return $this->controller;
+    }
+
+    /**
+     * Get the controller method used for the route.
+     * 
+     * @return string
+     */
+    public function getControllerMethod()
+    {
+        return $this->parseControllerCallback()[1];
+    }
+
+    /**
+     * Get the request method of the current route.
+     *
+     * @return array
+     */
+    public function getMethod()
+    {
+        return $this->method;
+    }
+
+    /**
+     * Get the url of the current route.
+     *
+     * @return string
+     */
+    public function getName()
+    {
+        return $this->action['as'] ?? null;
+    }
+
+    /**
+     * Get the url of the current route.
+     *
+     * @return string
+     */
+    public function getRoute()
+    {
+        return $this->uri;
+    }
+
+    /**
+     * Get or set the domain for the route.
+     * 
+     * @param  string|null  $domain  (null by default)
+     * 
+     * @return $this
+     */
+    public function domain($domain = null)
+    {
+        if (is_null($domain))
+        {
+            return $this->getDomain();
+        }
+
+        $this->action['domain'] = $this->parseRoute($domain);
+
+        return $this;
+    }
+
+    /**
+     * Get the domain defined for the route.
+     * 
+     * @return string|null
+     */
+    public function getDomain()
+    {
+        return isset($this->action['domain'])
+                ? str_replace(['http://', 'https://'], '', $this->action['domain'])
+                : null;
+    }
+
+    /**
+     * Parse the controller.
+     * 
+     * @return array
+     */
+    public function parseControllerCallback()
+    {
+        return Str::parseCallback($this->action['uses']);
+    }
 	
-	/**
-	 * Checks whether the route's action is a controller.
-	 * 
-	 * @return bool
-	 */
-	public function isControllerAction()
-	{
-		return is_string($this->action['uses']);
-	}
-
-	/**
-	 * Get the dispatcher for the route's controller.
-	 * 
-	 * @return \Syscodes\Controller\ControllerDispatcher
-	 */
-	private function controllerDispatcher()
-	{
-		return new ControllerDispatcher($this->container);
-	}
-
-	// Setters
+    /**
+     * Checks whether the route's action is a controller.
+     * 
+     * @return bool
+     */
+    public function isControllerAction()
+    {
+        return is_string($this->action['uses']);
+    }
+
+    /**
+     * Get the dispatcher for the route's controller.
+     * 
+     * @return \Syscodes\Controller\ControllerDispatcher
+     */
+    private function controllerDispatcher()
+    {
+        return new ControllerDispatcher($this->container);
+    }
+
+    // Setters
 	
-	/**
-	 * Run the route action and return the response.
-	 * 
-	 * @return mixed
-	 */
-	public function runResolver()
-	{
-		$this->container = $this->container ?: new Container;
-
-		try
-		{
-			if ($this->isControllerAction())
-			{
-				return $this->runResolverController();
-			}
-
-			return $this->runResolverCallable();
-		}
-		catch (HttpResponseException $e)
-		{
-			return $e->getResponse();
-		}
-	}
-
-	/**
-	 * Run the route action and return the response.
-	 *  
-	 * @return mixed
-	 */
-	protected function runResolverCallable()
-	{
-		$callable = $this->action['uses'];
-
-		return $callable(...array_values($this->resolveMethodDependencies(
-			$this->parametersWithouNulls(), new ReflectionFunction($this->action['uses'])
-		)));
-	}
-
-	/**
-	 * Run the route action and return the response.
-	 * 
-	 * @return mixed
-	 */
-	protected function runResolverController()
-	{
-		return $this->controllerDispatcher()->dispatch($this, $this->getController(), $this->getControllerMethod());
-	}
-
-	/**
-	 * Set the action.
-	 *
-	 * @param  \Closure|string  $action
-	 *
-	 * @return $this
-	 *
-	 * @throws \InvalidArgumentException
-	 */
-	public function parseAction($action)
-	{
-		if ( ! (is_object($action) && ($action instanceof Closure)) && ($action === null || $action === ''))
-		{
-			throw new InvalidArgumentException(__('route.actionClosureOrFunction'));
-		}
-
-		$this->action = RouteAction::parse($this->uri, $action);
-
-		return $this;
-	}
-
-	/**
-	 * Set the method of the current route.
-	 *
-	 * @param  array  $method
-	 *
-	 * @return string $this
-	 * 
-	 * @throws \InvalidArgumentException
-	 */
-	public function parseMethod($method)
-	{
-		if ($method === null || ! is_array($method) || empty($method))
-		{
-			throw new InvalidArgumentException(__('route.methodNotProvided'));
+    /**
+     * Run the route action and return the response.
+     * 
+     * @return mixed
+     */
+    public function runResolver()
+    {
+        $this->container = $this->container ?: new Container;
+
+        try
+        {
+            if ($this->isControllerAction())
+            {
+                return $this->runResolverController();
+            }
+
+            return $this->runResolverCallable();
+        }
+        catch (HttpResponseException $e)
+        {
+            return $e->getResponse();
+        }
+    }
+
+    /**
+     * Run the route action and return the response.
+     *  
+     * @return mixed
+     */
+    protected function runResolverCallable()
+    {
+        $callable = $this->action['uses'];
+
+        return $callable(...array_values($this->resolveMethodDependencies(
+            $this->parametersWithouNulls(), new ReflectionFunction($this->action['uses'])
+        )));
+    }
+
+    /**
+     * Run the route action and return the response.
+     * 
+     * @return mixed
+     */
+    protected function runResolverController()
+    {
+        return $this->controllerDispatcher()->dispatch($this, $this->getController(), $this->getControllerMethod());
+    }
+
+    /**
+     * Set the action.
+     *
+     * @param  \Closure|string  $action
+     *
+     * @return $this
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function parseAction($action)
+    {
+        if ( ! (is_object($action) && ($action instanceof Closure)) && ($action === null || $action === ''))
+        {
+            throw new InvalidArgumentException(__('route.actionClosureOrFunction'));
+        }
+
+        $this->action = RouteAction::parse($this->uri, $action);
+
+        return $this;
+    }
+
+    /**
+     * Set the method of the current route.
+     *
+     * @param  array  $method
+     *
+     * @return string $this
+     * 
+     * @throws \InvalidArgumentException
+     */
+    public function parseMethod($method)
+    {
+        if ($method === null || ! is_array($method) || empty($method))
+        {
+            throw new InvalidArgumentException(__('route.methodNotProvided'));
 			
-		}
+        }
 
-		foreach ($method as $httpMethod) 
-		{
-			if ( ! in_array($httpMethod, ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'ANY']))	
-			{
-				throw new InvalidArgumentException(__('route.methodNotAllowed'));
+        foreach ($method as $httpMethod) 
+        {
+            if ( ! in_array($httpMethod, ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'ANY']))	
+            {
+                throw new InvalidArgumentException(__('route.methodNotAllowed'));
 				
-			}
-		}
-
-	    $this->method = $method;
-
-	    return $this;
-	}
-
-	/**
-	 * Set the route.
-	 *
-	 * @param  string  $uri
-	 *
-	 * @return string
-	 *
-	 * @throws  \InvalidArgumentException
-	 */
-	public function parseRoute($uri)
-	{
-		if ($uri === null) 
-		{
-			throw new InvalidArgumentException(__('route.uriNotProvided'));
-		}	
-
-		$this->uri = $this->parseRoutePath($uri);
-
-		return $this;
-	}
-
-	/**
-	 * Replace word patterns with regex in route uri.
-	 * 
-	 * @param  string  $uri
-	 * 
-	 * @return string
-	 */
-	protected function parseRoutePath($uri)
-	{
-		$uri = trim($uri, '\/?');
-		$uri = trim($uri, '\/');
+            }
+        }
+
+        $this->method = $method;
+
+        return $this;
+    }
+
+    /**
+     * Set the route.
+     *
+     * @param  string  $uri
+     *
+     * @return string
+     *
+     * @throws  \InvalidArgumentException
+     */
+    public function parseRoute($uri)
+    {
+        if ($uri === null) 
+        {
+            throw new InvalidArgumentException(__('route.uriNotProvided'));
+        }	
+
+        $this->uri = $this->parseRoutePath($uri);
+
+        return $this;
+    }
+
+    /**
+     * Replace word patterns with regex in route uri.
+     * 
+     * @param  string  $uri
+     * 
+     * @return string
+     */
+    protected function parseRoutePath($uri)
+    {
+        $uri = trim($uri, '\/?');
+        $uri = trim($uri, '\/');
 		
-		preg_match_all('/\{([\w\:]+?)\??\}/', $uri, $matches);
+        preg_match_all('/\{([\w\:]+?)\??\}/', $uri, $matches);
 		
-		foreach ($matches[1] as $match)
-		{
-			if (strpos($match, ':') === false)
-			{
-				continue;
-			}
+        foreach ($matches[1] as $match)
+        {
+            if (strpos($match, ':') === false)
+            {
+                continue;
+            }
 			
-			$pattern  = array_keys($this->patterns);
-			$replace  = array_values($this->patterns);
-			$segments = explode(':', trim($match, '{}?'));
+            $pattern  = array_keys($this->patterns);
+            $replace  = array_values($this->patterns);
+            $segments = explode(':', trim($match, '{}?'));
 			
-			$uri = strpos($match, ':') !== false
-					? preg_replace($pattern, $replace, $uri)
-					: str_replace($match, '{'.$segments[0].'}', $uri);
-		}
+            $uri = strpos($match, ':') !== false
+                    ? preg_replace($pattern, $replace, $uri)
+                    : str_replace($match, '{'.$segments[0].'}', $uri);
+        }
 		
-		return $uri;
-	}
-
-	/**
-	 * Add a prefix to the route URI.
-	 * 
-	 * @param  string  $prefix
-	 * 
-	 * @return $this
-	 */
-	public function prefix($prefix)
-	{
-		if ( ! empty($newPrefix = trim(rtrim($prefix, '/').'/'.ltrim($this->action['prefix'] ?? '', '/'), '/'))) 
-		{
-			$this->action['prefix'] = $newPrefix;
-		}
+        return $uri;
+    }
+
+    /**
+     * Add a prefix to the route URI.
+     * 
+     * @param  string  $prefix
+     * 
+     * @return $this
+     */
+    public function prefix($prefix)
+    {
+        if ( ! empty($newPrefix = trim(rtrim($prefix, '/').'/'.ltrim($this->action['prefix'] ?? '', '/'), '/'))) 
+        {
+            $this->action['prefix'] = $newPrefix;
+        }
 		
-		$uri = rtrim($prefix, '/').'/'.ltrim($this->uri, '/');
+        $uri = rtrim($prefix, '/').'/'.ltrim($this->uri, '/');
 		
-		return $this->parseRoute($uri !== '/' ? trim($uri, '/') : $uri);
-	}
-
-	/**
-	 * Set the action array for the route.
-	 * 
-	 * @param  array  $action
-	 * 
-	 * @return $this
-	 */
-	public function setAction(array $action)
-	{
-		$this->action = $action;
-
-		if (isset($this->action['domain']))
-		{
-			$this->domain($this->action['domain']);
-		}
+        return $this->parseRoute($uri !== '/' ? trim($uri, '/') : $uri);
+    }
+
+    /**
+     * Set the action array for the route.
+     * 
+     * @param  array  $action
+     * 
+     * @return $this
+     */
+    public function setAction(array $action)
+    {
+        $this->action = $action;
+
+        if (isset($this->action['domain']))
+        {
+            $this->domain($this->action['domain']);
+        }
 		
-		return $this;
-	}
-
-	/**
-	 * Set the name.
-	 *
-	 * @param  string  $name
-	 *
-	 * @return string
-	 */
-	public function name($name)
-	{
-		$this->action['as'] = isset($this->action['as']) ? $this->action['as'].$name : $name;
-
-		return $this;
-	}
-
-	/**
-	 * Determine whether the route's name matches the given patterns.
-	 * 
-	 * @param  mixed  ...$patterns
-	 * 
-	 * @return bool
-	 */
-	public function named(...$patterns)
-	{
-		if (is_null($routeName = $this->getName()))
-		{
-			return false;
-		}
-
-		foreach ($patterns as $pattern)
-		{
-			if (Str::is($pattern, $routeName))
-			{
-				return true;
-			}
-		}
-
-		return false;
-	}
-
-	/**
-	 * Set a default value for the route.
-	 * 
-	 * @param  string  $key
-	 * @param  mixed   $value
-	 * 
-	 * @return $this
-	 */
-	public function defaults($key, $value)
-	{
-		$this->defaults[$key] = $value;
-
-		return $this;
-	}
-
-	/**
-	 * Set a default values for the route.
-	 * 
-	 * @param  string  $defaults
-	 * 
-	 * @return $this
-	 */
-	public function setDefaults(array $defaults)
-	{
-		$this->defaults = $defaults;
-
-		return $this;
-	}
-
-	/**
-	 * Set the where.
-	 *
-	 * @param  array|string  $name
-	 * @param  string|null  $expression  (null by default)
-	 *
-	 * @return $this
-	 */
-	public function where($name, string $expression = null)
-	{
-		$wheres = is_array($name) ? $name : [$name => $expression];
+        return $this;
+    }
+
+    /**
+     * Set the name.
+     *
+     * @param  string  $name
+     *
+     * @return string
+     */
+    public function name($name)
+    {
+        $this->action['as'] = isset($this->action['as']) ? $this->action['as'].$name : $name;
+
+        return $this;
+    }
+
+    /**
+     * Determine whether the route's name matches the given patterns.
+     * 
+     * @param  mixed  ...$patterns
+     * 
+     * @return bool
+     */
+    public function named(...$patterns)
+    {
+        if (is_null($routeName = $this->getName()))
+        {
+            return false;
+        }
+
+        foreach ($patterns as $pattern)
+        {
+            if (Str::is($pattern, $routeName))
+            {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Set a default value for the route.
+     * 
+     * @param  string  $key
+     * @param  mixed   $value
+     * 
+     * @return $this
+     */
+    public function defaults($key, $value)
+    {
+        $this->defaults[$key] = $value;
+
+        return $this;
+    }
+
+    /**
+     * Set a default values for the route.
+     * 
+     * @param  string  $defaults
+     * 
+     * @return $this
+     */
+    public function setDefaults(array $defaults)
+    {
+        $this->defaults = $defaults;
+
+        return $this;
+    }
+
+    /**
+     * Set the where.
+     *
+     * @param  array|string  $name
+     * @param  string|null  $expression  (null by default)
+     *
+     * @return $this
+     */
+    public function where($name, string $expression = null)
+    {
+        $wheres = is_array($name) ? $name : [$name => $expression];
 		
-		foreach ($wheres as $name => $expression)
-		{
-			$this->wheres[$name] = $expression;
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Bind the route to a given request for execution.
-	 * 
-	 * @param  \Syscodes\Http\Request  $request
-	 * 
-	 * @return $this
-	 */
-	public function bind(Request $request)
-	{
-		$this->parameters = (new RouteParamBinding($this))->parameters($request);
-
-		return $this;
-	}
-
-	/**
-	 * Get all of the parameter names for the route.
-	 * 
-	 * @return array
-	 */
-	public function parameterNames()
-	{
-		if (isset($this->parameterNames))
-		{
-			return $this->parameterNames;
-		}
-
-		return $this->parameterNames = $this->compileParamNames();
-	}
-
-	/**
-	 * Get the parameter names for the route.
-	 * 
-	 * @return array
-	 */
-	protected function compileParamNames()
-	{
-		preg_match_all('~[^\/\{(.*?)\}]~', $this->domain().$this->uri, $matches);
-
-		return array_map(function ($match) {
-			return trim($match, '?');
-		}, $matches[0]);
-	}
-
-	/**
-	 * Get a given parameter from the route.
-	 * 
-	 * @param  string  $name
-	 * @param  mixed  $default  (null by default)
-	 * 
-	 * @return array
-	 */
-	public function parameter($name, $default = null)
-	{
-		return Arr::get($this->parameters(), $name, $default);
-	}
-
-	/**
-	 * Set a parameter to the given value.
-	 * 
-	 * @param  string  $name
-	 * @param  mixed  $value
-	 * 
-	 * @return array
-	 */
-	public function setParameter($name, $value)
-	{
-		$this->parameters();
-
-		$this->parameters[$name] = $value;
-	}
-
-	/**
-	 * Get the key / value list of parameters without null values.
-	 * 
-	 * @return array
-	 */
-	public function parametersWithouNulls()
-	{
-		return array_filter($this->parameters(), function ($parameter) {
-			return ! is_null($parameter);
-		});
-	}
-
-	/**
-	 * Get the key / value list of parameters for the route.
-	 * 
-	 * @return array
-	 */
-	public function parameters()
-	{
-		if (isset($this->parameters))
-		{
-			return $this->parameters;
-		}
-
-		throw new LogicException('The route is not bound.');
-	}
-
-	/**
-	 * Determine if the route only responds to HTTP requests.
-	 * 
-	 * @return bool
-	 */
-	public function httpOnly()
-	{
-		return in_array('http', $this->action, true);
-	}
-
-	/**
-	 * Determine if the route only responds to HTTPS requests.
-	 * 
-	 * @return bool
-	 */
-	public function httpsOnly()
-	{
-		return $this->secure();
-	}
-
-	/**
-	 * Determine if the route only responds to HTTPS requests.
-	 * 
-	 * @return bool
-	 */
-	public function secure()
-	{
-		return in_array('https', $this->action, true);
-	}
-
-	/**
-	 * Set the container instance on the route.
-	 * 
-	 * @param  \Syscodes\Container\Container  $container
-	 * 
-	 * @return $this
-	 */
-	public function setContainer(Container $container)
-	{
-		$this->container = $container;
-
-		return $this;
-	}
-
-	/**
-	 * Dynamically access route parameters.
-	 * 
-	 * @param  string  $key
-	 * 
-	 * @return mixed
-	 */
-	public function __get($key)
-	{
-		return $this->parameter($key);
-	}
+        foreach ($wheres as $name => $expression)
+        {
+            $this->wheres[$name] = $expression;
+        }
+
+        return $this;
+    }
+
+    /**
+     * Bind the route to a given request for execution.
+     * 
+     * @param  \Syscodes\Http\Request  $request
+     * 
+     * @return $this
+     */
+    public function bind(Request $request)
+    {
+        $this->parameters = (new RouteParamBinding($this))->parameters($request);
+
+        return $this;
+    }
+
+    /**
+     * Get all of the parameter names for the route.
+     * 
+     * @return array
+     */
+    public function parameterNames()
+    {
+        if (isset($this->parameterNames))
+        {
+            return $this->parameterNames;
+        }
+
+        return $this->parameterNames = $this->compileParamNames();
+    }
+
+    /**
+     * Get the parameter names for the route.
+     * 
+     * @return array
+     */
+    protected function compileParamNames()
+    {
+        preg_match_all('~[^\/\{(.*?)\}]~', $this->domain().$this->uri, $matches);
+
+        return array_map(function ($match) {
+            return trim($match, '?');
+        }, $matches[0]);
+    }
+
+    /**
+     * Get a given parameter from the route.
+     * 
+     * @param  string  $name
+     * @param  mixed  $default  (null by default)
+     * 
+     * @return array
+     */
+    public function parameter($name, $default = null)
+    {
+        return Arr::get($this->parameters(), $name, $default);
+    }
+
+    /**
+     * Set a parameter to the given value.
+     * 
+     * @param  string  $name
+     * @param  mixed  $value
+     * 
+     * @return array
+     */
+    public function setParameter($name, $value)
+    {
+        $this->parameters();
+
+        $this->parameters[$name] = $value;
+    }
+
+    /**
+     * Get the key / value list of parameters without null values.
+     * 
+     * @return array
+     */
+    public function parametersWithouNulls()
+    {
+        return array_filter($this->parameters(), function ($parameter) {
+            return ! is_null($parameter);
+        });
+    }
+
+    /**
+     * Get the key / value list of parameters for the route.
+     * 
+     * @return array
+     */
+    public function parameters()
+    {
+        if (isset($this->parameters))
+        {
+            return $this->parameters;
+        }
+
+        throw new LogicException('The route is not bound.');
+    }
+
+    /**
+     * Determine if the route only responds to HTTP requests.
+     * 
+     * @return bool
+     */
+    public function httpOnly()
+    {
+        return in_array('http', $this->action, true);
+    }
+
+    /**
+     * Determine if the route only responds to HTTPS requests.
+     * 
+     * @return bool
+     */
+    public function httpsOnly()
+    {
+        return $this->secure();
+    }
+
+    /**
+     * Determine if the route only responds to HTTPS requests.
+     * 
+     * @return bool
+     */
+    public function secure()
+    {
+        return in_array('https', $this->action, true);
+    }
+
+    /**
+     * Set the container instance on the route.
+     * 
+     * @param  \Syscodes\Container\Container  $container
+     * 
+     * @return $this
+     */
+    public function setContainer(Container $container)
+    {
+        $this->container = $container;
+
+        return $this;
+    }
+
+    /**
+     * Dynamically access route parameters.
+     * 
+     * @param  string  $key
+     * 
+     * @return mixed
+     */
+    public function __get($key)
+    {
+        return $this->parameter($key);
+    }
 }
\ No newline at end of file

src/components/Console/Cli.php

Indentation +758 added lines, -758 removed lines

@@ -34,773 +34,773 @@
  */
 class Cli
 {
-	/**
- 	 * Background color identifier.
- 	 *
- 	 * @var array $backgroundColors
- 	 */
- 	protected static $backgroundColors = [
- 		'black'      => '40',
- 		'red'        => '41',
- 		'green'      => '42',
- 		'yellow'     => '43',
- 		'blue'       => '44',
- 		'magenta'    => '45',
- 		'cyan'       => '46',
- 		'light_gray' => '47'
- 	];
-
-	/**
-	 * Foreground color identifier.
- 	 *
- 	 * @var array $foregroundColors
-	 */
-	protected static $foregroundColors = [
-		'black'         => '0;30',
-		'dark_gray'     => '1;30',
-		'blue'          => '0;34',
-		'dark_blue'     => '1;34',
-		'light_blue'    => '1;34',
-		'green'         => '0;32',
-		'light_green'   => '1;32',
-		'cyan'          => '0;36', 
-		'light_cyan'    => '1;36',
-		'red'           => '0;31',
-		'light_red'     => '1;31',
-		'purple'        => '0;35',
-		'light_purple'  => '1;35',
-		'light_yellow'  => '0;33',
-		'yellow'        => '1;33',
-		'light_gray'    => '0;37',
-		'white'         => '1;37'
- 	];
-
-	/**
-	 * Indicates that you do not use any color for foreground or background.
-	 *
-	 * @var bool $noColor
-	 */
-	public static $noColor = false;
-
-	/**
-	 * String of arguments to be used in console.
-	 *
-	 * @var array $options
-	 */
-	protected static $options = [];
-
-	/**
-	 * Readline Support for command line.
-	 *
-	 * @var bool $readlineSupport
-	 */
-	public static $readlineSupport = false;
-
-	/**
-	 * List of array segments.
-	 *
-	 * @var array $segments
-	 */
-	protected static $segments = [];
-
- 	/**
- 	 * The standar STDERR is where the application writes its error messages.
- 	 *
- 	 * @var string $stderr 
- 	 */
- 	protected static $stderr;
-
- 	/**
- 	 * The estandar STDOUT is where the application records its output messages.
- 	 *
- 	 * @var string $stdout
- 	 */
- 	protected static $stdout;
-
- 	/**
-	 * Message that tells the user that he is waiting to receive an order.
-	 *
-	 * @var string $waitMsg
-	 */
-	public static $waitMsg = 'Press any key to continue...';
-
-	/**
-	 * Static constructor. Parses all the CLI params.
-	 * 
-	 * @return string
-	 * 
-	 * @uses   \Syscodes\Contracts\Core\Lenevor
-	 * 
-	 * @throws \Exception
-	 */
- 	public static function initialize(Lenevor $core)
- 	{
- 		if ( ! $core->initCli())
- 		{
-			throw new Exception('Cli class cannot be used outside of the command line');
- 		}
-
- 		// Readline is an extension for PHP that makes interactive the command console
- 		static::$readlineSupport = extension_loaded('readline');
-
- 		// clear segments & options to keep testing clean
- 		static::$options  = [];
- 		static::$segments = [];
-
- 		static::parseCommandLine();
-
- 		// Writes its error messages
- 		static::$stderr = STDERR;
-
- 		// Records its output messages
- 		static::$stdout = STDOUT;
- 	}
-
- 	/**
- 	 * Beeps a certain number of times.
-	 *
-	 * @param  int  $num  The number of times to beep
-	 *
- 	 * @return int
- 	 */
- 	public static function bell(int $num = 1)
- 	{
- 		echo str_repeat("\x07", $num);
- 	}
-
- 	/**
- 	 * Clears the screen of output.
- 	 *
- 	 * @return void
- 	 */
- 	public static function clearScreen()
- 	{
- 		static::isWindows() 
-
- 			// Windows doesn't work for this, but their terminal is tiny so shove this in
- 			? static::newLine(40)
-
- 			// Anything with a flair of Unix will handle these magic characters
- 			: fwrite(static::$stdout, chr(27)."[H".chr(27)."[2J");
- 	}
-
- 	/**
- 	 * Returns the given text with the correct color codes for a foreground and
-	 * optionally a background color.
- 	 *
- 	 * @param  string  $text  The text to color
- 	 * @param  string  $foreground  The foreground color
- 	 * @param  string  $background  The background color
- 	 * @param  string  $format  Other formatting to apply. Currently only 'underline' is understood
- 	 *
- 	 * @return string  The color coded string
- 	 *
- 	 * @throws \Syscodes\Core\Exceptions\LenevorException
- 	 */
- 	public static function color(string $text, string $foreground, string $background = null, string $format = null)
- 	{
- 		if (static::$noColor)
- 		{
- 			return $text;
- 		}
-
- 		if ( ! Arr::exists(static::$foregroundColors, $foreground))
- 		{
- 			throw new LenevorException(static::error("Invalid CLI foreground color: {$foreground}."));
- 		}
-
- 		if ( $background !== null && ! Arr::exists(static::$backgroundColors, $background))
- 		{
- 			throw new LenevorException(static::error("Invalid CLI background color: {$background}."));
- 		}
-
- 		$string = "\033[".static::$foregroundColors[$foreground]."m";
-
- 		if ($background !== null)
- 		{
- 			$string .= "\033[".static::$backgroundColors[$background]."m";
- 		}
-
- 		if ($format === 'underline')
- 		{
- 			$string .= "\033[4m";
- 		}
-
- 		$string .= $text."\033[0m";
-
- 		return $string;
- 	}
-
- 	/**
- 	 * Get the number of characters in a string.
- 	 *
- 	 * @param  string  $string
- 	 *
- 	 * @return int
- 	 */
- 	public static function strlen(?string $string)
- 	{
- 		if (is_null($string))
- 		{
- 			return 0;
- 		}
-
- 		foreach (static::$foregroundColors as $color)
- 		{
- 			$string = strtr($string, ["\033[".$color.'m' => '']);
- 		}
-
- 		foreach (static::$backgroundColors as $color)
- 		{
- 			$string = strtr($string, ["\033[".$color.'m' => '']);
- 		}
-
- 		$string = strtr($string, ["\033[4m" => '', "\033[0m" => '']);
-
- 		return mb_strlen($string);
- 	}
-
- 	/**
- 	 * Outputs an error to the CLI using STDERR instead of STDOUT.
- 	 *
- 	 * @param  string|array  $text  The text to output, or array of errors
- 	 * @param  string  $foreground  The foreground color
- 	 * @param  string|null  $background  the background color
- 	 *
- 	 * @return string
- 	 */
- 	public static function error(string $text = '', string $foreground = 'light_red', string $background = null)
- 	{
-		if (is_array($text))
-		{
-			$text = implode(PHP_EOL, $text);
-		}
+    /**
+     * Background color identifier.
+     *
+     * @var array $backgroundColors
+     */
+        protected static $backgroundColors = [
+            'black'      => '40',
+            'red'        => '41',
+            'green'      => '42',
+            'yellow'     => '43',
+            'blue'       => '44',
+            'magenta'    => '45',
+            'cyan'       => '46',
+            'light_gray' => '47'
+        ];
+
+    /**
+     * Foreground color identifier.
+     *
+     * @var array $foregroundColors
+     */
+    protected static $foregroundColors = [
+        'black'         => '0;30',
+        'dark_gray'     => '1;30',
+        'blue'          => '0;34',
+        'dark_blue'     => '1;34',
+        'light_blue'    => '1;34',
+        'green'         => '0;32',
+        'light_green'   => '1;32',
+        'cyan'          => '0;36', 
+        'light_cyan'    => '1;36',
+        'red'           => '0;31',
+        'light_red'     => '1;31',
+        'purple'        => '0;35',
+        'light_purple'  => '1;35',
+        'light_yellow'  => '0;33',
+        'yellow'        => '1;33',
+        'light_gray'    => '0;37',
+        'white'         => '1;37'
+        ];
+
+    /**
+     * Indicates that you do not use any color for foreground or background.
+     *
+     * @var bool $noColor
+     */
+    public static $noColor = false;
+
+    /**
+     * String of arguments to be used in console.
+     *
+     * @var array $options
+     */
+    protected static $options = [];
+
+    /**
+     * Readline Support for command line.
+     *
+     * @var bool $readlineSupport
+     */
+    public static $readlineSupport = false;
+
+    /**
+     * List of array segments.
+     *
+     * @var array $segments
+     */
+    protected static $segments = [];
+
+        /**
+         * The standar STDERR is where the application writes its error messages.
+         *
+         * @var string $stderr 
+         */
+        protected static $stderr;
+
+        /**
+         * The estandar STDOUT is where the application records its output messages.
+         *
+         * @var string $stdout
+         */
+        protected static $stdout;
+
+        /**
+         * Message that tells the user that he is waiting to receive an order.
+         *
+         * @var string $waitMsg
+         */
+    public static $waitMsg = 'Press any key to continue...';
+
+    /**
+     * Static constructor. Parses all the CLI params.
+     * 
+     * @return string
+     * 
+     * @uses   \Syscodes\Contracts\Core\Lenevor
+     * 
+     * @throws \Exception
+     */
+        public static function initialize(Lenevor $core)
+        {
+            if ( ! $core->initCli())
+            {
+            throw new Exception('Cli class cannot be used outside of the command line');
+            }
+
+            // Readline is an extension for PHP that makes interactive the command console
+            static::$readlineSupport = extension_loaded('readline');
+
+            // clear segments & options to keep testing clean
+            static::$options  = [];
+            static::$segments = [];
+
+            static::parseCommandLine();
+
+            // Writes its error messages
+            static::$stderr = STDERR;
+
+            // Records its output messages
+            static::$stdout = STDOUT;
+        }
+
+        /**
+         * Beeps a certain number of times.
+         *
+         * @param  int  $num  The number of times to beep
+         *
+         * @return int
+         */
+        public static function bell(int $num = 1)
+        {
+            echo str_repeat("\x07", $num);
+        }
+
+        /**
+         * Clears the screen of output.
+         *
+         * @return void
+         */
+        public static function clearScreen()
+        {
+            static::isWindows() 
+
+                // Windows doesn't work for this, but their terminal is tiny so shove this in
+             ? static::newLine(40)
+
+                // Anything with a flair of Unix will handle these magic characters
+             : fwrite(static::$stdout, chr(27)."[H".chr(27)."[2J");
+        }
+
+        /**
+         * Returns the given text with the correct color codes for a foreground and
+         * optionally a background color.
+         *
+         * @param  string  $text  The text to color
+         * @param  string  $foreground  The foreground color
+         * @param  string  $background  The background color
+         * @param  string  $format  Other formatting to apply. Currently only 'underline' is understood
+         *
+         * @return string  The color coded string
+         *
+         * @throws \Syscodes\Core\Exceptions\LenevorException
+         */
+        public static function color(string $text, string $foreground, string $background = null, string $format = null)
+        {
+            if (static::$noColor)
+            {
+                return $text;
+            }
+
+            if ( ! Arr::exists(static::$foregroundColors, $foreground))
+            {
+                throw new LenevorException(static::error("Invalid CLI foreground color: {$foreground}."));
+            }
+
+            if ( $background !== null && ! Arr::exists(static::$backgroundColors, $background))
+            {
+                throw new LenevorException(static::error("Invalid CLI background color: {$background}."));
+            }
+
+            $string = "\033[".static::$foregroundColors[$foreground]."m";
+
+            if ($background !== null)
+            {
+                $string .= "\033[".static::$backgroundColors[$background]."m";
+            }
+
+            if ($format === 'underline')
+            {
+                $string .= "\033[4m";
+            }
+
+            $string .= $text."\033[0m";
+
+            return $string;
+        }
+
+        /**
+         * Get the number of characters in a string.
+         *
+         * @param  string  $string
+         *
+         * @return int
+         */
+        public static function strlen(?string $string)
+        {
+            if (is_null($string))
+            {
+                return 0;
+            }
+
+            foreach (static::$foregroundColors as $color)
+            {
+                $string = strtr($string, ["\033[".$color.'m' => '']);
+            }
+
+            foreach (static::$backgroundColors as $color)
+            {
+                $string = strtr($string, ["\033[".$color.'m' => '']);
+            }
+
+            $string = strtr($string, ["\033[4m" => '', "\033[0m" => '']);
+
+            return mb_strlen($string);
+        }
+
+        /**
+         * Outputs an error to the CLI using STDERR instead of STDOUT.
+         *
+         * @param  string|array  $text  The text to output, or array of errors
+         * @param  string  $foreground  The foreground color
+         * @param  string|null  $background  the background color
+         *
+         * @return string
+         */
+        public static function error(string $text = '', string $foreground = 'light_red', string $background = null)
+        {
+        if (is_array($text))
+        {
+            $text = implode(PHP_EOL, $text);
+        }
 		
-		if ($foreground || $background)
-		{
-			$text = static::color($text, $foreground, $background);
-		}
+        if ($foreground || $background)
+        {
+            $text = static::color($text, $foreground, $background);
+        }
 		
-		fwrite(static::$stderr, $text.PHP_EOL);
-	}
-
-	/**
-	 * Attempts to determine the width of the viewable CLI window.
-	 *
-	 * @param  int  $default
-	 *
-	 * @return int
-	 */
-	public static function getWidth(int $default = 80)
-	{
-		if (static::isWindows() || (int) shell_exec('tput cols') === 0)
-		{
-			return $default;
-		}
-
-		return (int) shell_exec('tput cols');
-	}
-
-	/**
-	 * Attempts to determine the height of the viewable CLI window.
-	 *
-	 * @param  int  $default
-	 *
-	 * @return int
-	 */
-	public static function getHeight(int $default = 32)
-	{
-		if (static::isWindows())
-		{
-			return $default;
-		}
-
-		return (int) shell_exec('tput lines');
-	}
-
-	/**
-	 * Takes a string and writes it to the command line, wrapping to a maximum width. 
-	 * If no maximum width is specified, will wrap to the window's max.
-	 *
-	 * @param  string  $string  (null by default)
-	 * @param  int  $max  (0 by default)
-	 * @param  int $padLeft  (0 by default)
-	 *
-	 * @return string
-	 */
-	public static function wrap(string $string = null, int $max = 0, int $padLeft = 0)
-	{
-		if (empty($string))
-		{
-			return '';
-		}
-
-		if ($max === 0)
-		{
-			$max = static::getWidth();
-		}
-
-		if (static::getWidth() < $max)
-		{
-			$max = static::getWidth();
-		}
-
-		$max = $max - $padLeft;
-
-		$lines = wordwrap($string, $max);
-
-		if ($pad_left > 0)
-		{
-			$lines = explode(PHP_EOL, $lines);
-
-			$first = true;
-
-			array_walk ($lines, function (&$line, $index) use ($pad_left, &$first) {
-
-				if ( ! $first)
-				{
-					$line = str_repeat(' ', $pad_left) . $line;
-				}
-				else
-				{
-					$first = false;
-				}
-
-			});
-
-			$lines = implode(PHP_EOL, $lines);
-		}
-
-		return $lines;
-	}
-
- 	/**
- 	 * Get input from the shell, using readline or the standard STDIN.
- 	 *
- 	 * @param  string|int  $prefix  The name of the option (int if unnamed)
- 	 *
- 	 * @return string
- 	 */
- 	public static function input($prefix = '')
- 	{
- 		if (static::$readlineSupport)
- 		{
- 			return readline($prefix);
- 		}
-
- 		echo $prefix;
-
- 		return fgets(STDIN);
- 	}
-
- 	/**
- 	 * If operating system === windows.
- 	 * 
- 	 * @return string
- 	 */
- 	public static function isWindows()
- 	{
- 		return 'win' === strtolower(substr(php_uname("s"), 0, 3));
- 	}
-
- 	/**
- 	 * Enter a number of empty lines.
- 	 * 
- 	 * @param  int  $num  Number of lines to output
- 	 *
- 	 * @return void
- 	 */
- 	public static function newLine(int $num = 1)
- 	{
- 		for ($i = 0; $i < $num; $i++)
- 		{			
- 			static::write();
- 		}
- 	}
-
- 	/**
-	 * Returns the option with the given name. You can also give the option number.
-	 *
-	 * @param  string|int  $name  The name of the option (int if unnamed)
-	 * @param  mixed  $default  The value to return if the option is not defined
-	 *
-	 * @return mixed
-	 * 
-	 * @uses   \Syscodes\Contract\Core\Lenevor
-	 */
- 	public static function option($name, $default = null)
- 	{
- 		if ( ! isset(static::$options[$name]))
- 		{
- 			return Lenevor::value($default);
- 		}
-
- 		return static::$options[$name];
-	}
-
-	/**
-	 * Parses the command line it was called from and collects all
-	 * options and valid segments.
-	 * 
-	 * @return bool
-	 */
-	protected static function parseCommandLine()
-	{
-		$options = false;
-
-		for ($i = 1; $i < $_SERVER['argc']; $i++)
-		{
-			if ( ! $options && mb_strpos($_SERVER['argv'][$i], '-') === false)
-			{
-				static::$segments[] = $_SERVER['argv'][$i];
-
-				continue;
-			}
-
-			$options = true;
-
-			$args  = str_replace('-', '', $_SERVER['argv'][$i]);
-			$value = null;
-
-			if (isset($_SERVER['argv'][$i + 1]) && mb_strpos($_SERVER['argv'][$i + 1], '-') !== 0)
-			{
-				$value = $_SERVER['argv'][$i + 1];
-				$i++;
-			}
-
-			static::$options[$args] = $value;
-
-			$options = false;
-		}
-	}
-
-	/**
-	 * Returns the command line string portions of the arguments, minus
-	 * any options, as a string.
-	 *
-	 * @return string
-	 */
-	public static function getURI()
-	{
-		return implode('/', static::$segments);
-	}
-
-	/**
-	 * Returns an individual segment.
-	 *
-	 * @param  int  $index
-	 * 
-	 * @return mixed|null
-	 */
-	public static function getSegment(int $index)
-	{
-		if ( ! isset(static::$segments[$index - 1]))
-		{
-			return null;
-		}
-
-		return static::$segments[$index - 1];
-	}
-
-	/**
-	 * Returns the raw array of segments found.
-	 *
-	 * @return array
-	 */
-	public static function getSegments()
-	{
-		return static::$segments;
-	}
-
- 	/**
- 	 * Asks the user for input.  This can have either 1 or 2 arguments.
-	 *
-	 * Usage:
-	 *
-	 * // Waits for any key press
-	 * Cli::prompt();
-	 *
-	 * // Takes any input
-	 * $color = Cli::prompt('What is your favorite color?');
-	 *
-	 * // Takes any input, but offers default
-	 * $color = Cli::prompt('What is your favourite color?', 'white');
-	 *
-	 * // Will only accept the options in the array
-	 * $ready = Cli::prompt('Are you ready?', array('y','n'));
-	 *
-	 * @return string The user input
-	 */
- 	public static function prompt()
- 	{
- 		$args = func_get_args();
-
-		$options = [];
-		$output  = '';
-		$default = null;
-
-		// How many we got
-		$arg_count = count($args);
-
-		// Is the last argument a boolean? True means required
-		$required = end($args) === true;
-
-		// Reduce the argument count if required was passed, we don't care about that anymore
-		$required === true and --$arg_count;
-
-		// This method can take a few crazy combinations of arguments, so lets work it out
-		switch ($arg_count)
-		{
-			case 2:
-
-				// E.g: $ready = Cli::prompt('Are you ready?', ['y','n']);
-				if (is_array($args[1]))
-				{
-					list($output, $options) = $args;
-				}
-
-				// E.g: $color = Cli::prompt('What is your favourite color?', 'white');
-				elseif (is_string($args[1]))
-				{
-					list($output, $default) = $args;
-				}
-
-			break;
-
-			case 1:
-
-				// No question (probably been asked already) so just show options
-				// E.g: $ready = Cli::prompt(array('y','n'));
-				if (is_array($args[0]))
-				{
-					$options = $args[0];
-				}
-
-				// Question without options
-				// E.g: $ready = Cli::prompt('What did you do today?');
-				elseif (is_string($args[0]))
-				{
-					$output = $args[0];
-				}
-
-			break;
-		}
-
-		// If a question has been asked with the read
-		if ($output !== '')
-		{
-			$extra_output = '';
-
-			if ($default !== null)
-			{
-				$extra_output = ' [ Default: "'.$default.'" ]';
-			}
-			elseif ($options !== [])
-			{
-				$extra_output = ' [ '.implode(' | ', $options).' ]';
-			}
-
-			fwrite(static::$stdout, $output.$extra_output.': ');
-		}
-
-		// Read the input from keyboard.
-		$input = trim(static::input()) ?: $default;
-
-		// No input provided and we require one (default will stop this being called)
-		if (empty($input) and $required === true)
-		{
-			static::write('This is required.');
-			static::newLine();
-
-			$input = forward_static_call_array([__CLASS__, 'prompt'], $args);
-		}
-
-		// If options are provided and the choice is not in the array, tell them to try again
-		if ( ! empty($options) and ! in_array($input, $options))
-		{
-			static::write('This is not a valid option. Please try again.');
-			static::newLine();
-
-			$input = forward_static_call_array([__CLASS__, 'prompt'], $args);
-		}
-
-		return $input;
- 	}
-
- 	/**
- 	 * Allows you to set a commandline option from code.
- 	 *
- 	 * @param  string|int  $name  The name of the option (int if unnamed)
-	 * @param  mixed|null  $value  The value to set, or null to delete the option
-	 *
-	 * @return mixed
-	 */
- 	public static function setOption($name, $value = null)
- 	{
- 		if ($value == null)
- 		{
- 			if (isset(static::$options[$name]))
- 			{
- 				unset(static::$options[$name]);
- 			}
- 		}
- 		else
- 		{
- 			static::$options[$name] = $value;
- 		}
- 	}
-
- 	/**
- 	 * Waits a certain number of seconds, optionally showing a wait message and
-	 * waiting for a key press.
- 	 *
- 	 * @param  int  $seconds  Number of seconds
- 	 * @param  bool  $countdown  Show a countdown or not
- 	 *
- 	 * @return string
- 	 */
- 	public static function wait(int $seconds = 0, bool $countdown = false)
- 	{
- 		if ($countdown === true)
- 		{
-			$time = $seconds;
-
- 			while ($time > 0)
- 			{
- 				fwrite(static::$stdout, $time.'... ');
- 				sleep(1);
- 				$time--;
- 			}
-
- 			static::write();
- 		}
- 		else
- 		{
- 			if ($seconds = 0)
- 			{
- 				sleep($seconds);
- 			}
- 			else
- 			{
- 				static::write(static::$waitMsg);
- 				static::input();
- 			}
- 		}
- 	}
-
- 	/**
- 	 * Outputs a string to the cli.	If you send an array it will implode them 
- 	 * with a line break.
- 	 * 
- 	 * @param  string|array  $text  The text to output, or array of lines
- 	 * @param  string|null  $foreground  The foreground color
- 	 * @param  string|null  $background  The background color
- 	 *
- 	 * @return string
- 	 */
- 	public static function write(string $text = '', string $foreground = null, string $background = null)
- 	{
- 		if (is_array($text))
- 		{
- 			$text = implode(PHP_EOL, $text);
- 		}
-
- 		if ($foreground OR $background)
- 		{
- 			$text = static::color($text, $foreground, $background);
- 		}
-
- 		fwrite(static::$stdout, $text.PHP_EOL);
- 	}
-
- 	/**
- 	 * Returns a well formatted table.
- 	 *
- 	 * @param  array  $tbody  List of rows
- 	 * @param  array  $thead  List of columns
- 	 *
- 	 * @return void
- 	 */
- 	public static function table(array $tbody, array $thead = [])
- 	{
- 		$rows = [];
-
- 		if ( ! empty($thead))
- 		{
- 			$rows[] = array_values($thead);
- 		}
-
- 		foreach ($tbody as $tr)
- 		{
- 			$rows[] = count($rows);
- 		}
-
- 		$totalRows = count($rows);
-
- 		// Store all columns lengths
- 		$allColsLengths = [];
-
- 		// Store maximum lengths by column
- 		$maxColsLengths = [];
-
- 		for ($row = 0; $row < $totalRows; $row++)
- 		{
- 			$column = 0;
-
- 			foreach ($rows[$row] as $col)
- 			{
- 				$allColsLengths[$row][$column] = static::strlen($col);
-
- 				if ( ! isset($maxColsLengths[$column]) || $allColsLengths[$row][$column] > $maxColsLengths[$column])
- 				{
- 					$maxColsLengths[$column] = $allColsLengths[$row][$column];
- 				}
-
- 				$column++;
- 			}
- 		}
-
- 		for ($row = 0; $row < $totalRows; $row++)
- 		{
- 			$column = 0;
-
- 			foreach ($rows[$row] as $col)
- 			{
- 				$diverse = $maxColsLengths[$column] - static::strlen($col);
+        fwrite(static::$stderr, $text.PHP_EOL);
+    }
+
+    /**
+     * Attempts to determine the width of the viewable CLI window.
+     *
+     * @param  int  $default
+     *
+     * @return int
+     */
+    public static function getWidth(int $default = 80)
+    {
+        if (static::isWindows() || (int) shell_exec('tput cols') === 0)
+        {
+            return $default;
+        }
+
+        return (int) shell_exec('tput cols');
+    }
+
+    /**
+     * Attempts to determine the height of the viewable CLI window.
+     *
+     * @param  int  $default
+     *
+     * @return int
+     */
+    public static function getHeight(int $default = 32)
+    {
+        if (static::isWindows())
+        {
+            return $default;
+        }
+
+        return (int) shell_exec('tput lines');
+    }
+
+    /**
+     * Takes a string and writes it to the command line, wrapping to a maximum width. 
+     * If no maximum width is specified, will wrap to the window's max.
+     *
+     * @param  string  $string  (null by default)
+     * @param  int  $max  (0 by default)
+     * @param  int $padLeft  (0 by default)
+     *
+     * @return string
+     */
+    public static function wrap(string $string = null, int $max = 0, int $padLeft = 0)
+    {
+        if (empty($string))
+        {
+            return '';
+        }
+
+        if ($max === 0)
+        {
+            $max = static::getWidth();
+        }
+
+        if (static::getWidth() < $max)
+        {
+            $max = static::getWidth();
+        }
+
+        $max = $max - $padLeft;
+
+        $lines = wordwrap($string, $max);
+
+        if ($pad_left > 0)
+        {
+            $lines = explode(PHP_EOL, $lines);
+
+            $first = true;
+
+            array_walk ($lines, function (&$line, $index) use ($pad_left, &$first) {
+
+                if ( ! $first)
+                {
+                    $line = str_repeat(' ', $pad_left) . $line;
+                }
+                else
+                {
+                    $first = false;
+                }
+
+            });
+
+            $lines = implode(PHP_EOL, $lines);
+        }
+
+        return $lines;
+    }
+
+        /**
+         * Get input from the shell, using readline or the standard STDIN.
+         *
+         * @param  string|int  $prefix  The name of the option (int if unnamed)
+         *
+         * @return string
+         */
+        public static function input($prefix = '')
+        {
+            if (static::$readlineSupport)
+            {
+                return readline($prefix);
+            }
+
+            echo $prefix;
+
+            return fgets(STDIN);
+        }
+
+        /**
+         * If operating system === windows.
+         * 
+         * @return string
+         */
+        public static function isWindows()
+        {
+            return 'win' === strtolower(substr(php_uname("s"), 0, 3));
+        }
+
+        /**
+         * Enter a number of empty lines.
+         * 
+         * @param  int  $num  Number of lines to output
+         *
+         * @return void
+         */
+        public static function newLine(int $num = 1)
+        {
+            for ($i = 0; $i < $num; $i++)
+            {			
+                static::write();
+            }
+        }
+
+        /**
+         * Returns the option with the given name. You can also give the option number.
+         *
+         * @param  string|int  $name  The name of the option (int if unnamed)
+         * @param  mixed  $default  The value to return if the option is not defined
+         *
+         * @return mixed
+         * 
+         * @uses   \Syscodes\Contract\Core\Lenevor
+         */
+        public static function option($name, $default = null)
+        {
+            if ( ! isset(static::$options[$name]))
+            {
+                return Lenevor::value($default);
+            }
+
+            return static::$options[$name];
+    }
+
+    /**
+     * Parses the command line it was called from and collects all
+     * options and valid segments.
+     * 
+     * @return bool
+     */
+    protected static function parseCommandLine()
+    {
+        $options = false;
+
+        for ($i = 1; $i < $_SERVER['argc']; $i++)
+        {
+            if ( ! $options && mb_strpos($_SERVER['argv'][$i], '-') === false)
+            {
+                static::$segments[] = $_SERVER['argv'][$i];
+
+                continue;
+            }
+
+            $options = true;
+
+            $args  = str_replace('-', '', $_SERVER['argv'][$i]);
+            $value = null;
+
+            if (isset($_SERVER['argv'][$i + 1]) && mb_strpos($_SERVER['argv'][$i + 1], '-') !== 0)
+            {
+                $value = $_SERVER['argv'][$i + 1];
+                $i++;
+            }
+
+            static::$options[$args] = $value;
+
+            $options = false;
+        }
+    }
+
+    /**
+     * Returns the command line string portions of the arguments, minus
+     * any options, as a string.
+     *
+     * @return string
+     */
+    public static function getURI()
+    {
+        return implode('/', static::$segments);
+    }
+
+    /**
+     * Returns an individual segment.
+     *
+     * @param  int  $index
+     * 
+     * @return mixed|null
+     */
+    public static function getSegment(int $index)
+    {
+        if ( ! isset(static::$segments[$index - 1]))
+        {
+            return null;
+        }
+
+        return static::$segments[$index - 1];
+    }
+
+    /**
+     * Returns the raw array of segments found.
+     *
+     * @return array
+     */
+    public static function getSegments()
+    {
+        return static::$segments;
+    }
+
+        /**
+         * Asks the user for input.  This can have either 1 or 2 arguments.
+         *
+         * Usage:
+         *
+         * // Waits for any key press
+         * Cli::prompt();
+         *
+         * // Takes any input
+         * $color = Cli::prompt('What is your favorite color?');
+         *
+         * // Takes any input, but offers default
+         * $color = Cli::prompt('What is your favourite color?', 'white');
+         *
+         * // Will only accept the options in the array
+         * $ready = Cli::prompt('Are you ready?', array('y','n'));
+         *
+         * @return string The user input
+         */
+        public static function prompt()
+        {
+            $args = func_get_args();
+
+        $options = [];
+        $output  = '';
+        $default = null;
+
+        // How many we got
+        $arg_count = count($args);
+
+        // Is the last argument a boolean? True means required
+        $required = end($args) === true;
+
+        // Reduce the argument count if required was passed, we don't care about that anymore
+        $required === true and --$arg_count;
+
+        // This method can take a few crazy combinations of arguments, so lets work it out
+        switch ($arg_count)
+        {
+            case 2:
+
+                // E.g: $ready = Cli::prompt('Are you ready?', ['y','n']);
+                if (is_array($args[1]))
+                {
+                    list($output, $options) = $args;
+                }
+
+                // E.g: $color = Cli::prompt('What is your favourite color?', 'white');
+                elseif (is_string($args[1]))
+                {
+                    list($output, $default) = $args;
+                }
+
+            break;
+
+            case 1:
+
+                // No question (probably been asked already) so just show options
+                // E.g: $ready = Cli::prompt(array('y','n'));
+                if (is_array($args[0]))
+                {
+                    $options = $args[0];
+                }
+
+                // Question without options
+                // E.g: $ready = Cli::prompt('What did you do today?');
+                elseif (is_string($args[0]))
+                {
+                    $output = $args[0];
+                }
+
+            break;
+        }
+
+        // If a question has been asked with the read
+        if ($output !== '')
+        {
+            $extra_output = '';
+
+            if ($default !== null)
+            {
+                $extra_output = ' [ Default: "'.$default.'" ]';
+            }
+            elseif ($options !== [])
+            {
+                $extra_output = ' [ '.implode(' | ', $options).' ]';
+            }
+
+            fwrite(static::$stdout, $output.$extra_output.': ');
+        }
+
+        // Read the input from keyboard.
+        $input = trim(static::input()) ?: $default;
+
+        // No input provided and we require one (default will stop this being called)
+        if (empty($input) and $required === true)
+        {
+            static::write('This is required.');
+            static::newLine();
+
+            $input = forward_static_call_array([__CLASS__, 'prompt'], $args);
+        }
+
+        // If options are provided and the choice is not in the array, tell them to try again
+        if ( ! empty($options) and ! in_array($input, $options))
+        {
+            static::write('This is not a valid option. Please try again.');
+            static::newLine();
+
+            $input = forward_static_call_array([__CLASS__, 'prompt'], $args);
+        }
+
+        return $input;
+        }
+
+        /**
+         * Allows you to set a commandline option from code.
+         *
+         * @param  string|int  $name  The name of the option (int if unnamed)
+         * @param  mixed|null  $value  The value to set, or null to delete the option
+         *
+         * @return mixed
+         */
+        public static function setOption($name, $value = null)
+        {
+            if ($value == null)
+            {
+                if (isset(static::$options[$name]))
+                {
+                    unset(static::$options[$name]);
+                }
+            }
+            else
+            {
+                static::$options[$name] = $value;
+            }
+        }
+
+        /**
+         * Waits a certain number of seconds, optionally showing a wait message and
+         * waiting for a key press.
+         *
+         * @param  int  $seconds  Number of seconds
+         * @param  bool  $countdown  Show a countdown or not
+         *
+         * @return string
+         */
+        public static function wait(int $seconds = 0, bool $countdown = false)
+        {
+            if ($countdown === true)
+            {
+            $time = $seconds;
+
+                while ($time > 0)
+                {
+                    fwrite(static::$stdout, $time.'... ');
+                    sleep(1);
+                    $time--;
+                }
+
+                static::write();
+            }
+            else
+            {
+                if ($seconds = 0)
+                {
+                    sleep($seconds);
+                }
+                else
+                {
+                    static::write(static::$waitMsg);
+                    static::input();
+                }
+            }
+        }
+
+        /**
+         * Outputs a string to the cli.	If you send an array it will implode them 
+         * with a line break.
+         * 
+         * @param  string|array  $text  The text to output, or array of lines
+         * @param  string|null  $foreground  The foreground color
+         * @param  string|null  $background  The background color
+         *
+         * @return string
+         */
+        public static function write(string $text = '', string $foreground = null, string $background = null)
+        {
+            if (is_array($text))
+            {
+                $text = implode(PHP_EOL, $text);
+            }
+
+            if ($foreground OR $background)
+            {
+                $text = static::color($text, $foreground, $background);
+            }
+
+            fwrite(static::$stdout, $text.PHP_EOL);
+        }
+
+        /**
+         * Returns a well formatted table.
+         *
+         * @param  array  $tbody  List of rows
+         * @param  array  $thead  List of columns
+         *
+         * @return void
+         */
+        public static function table(array $tbody, array $thead = [])
+        {
+            $rows = [];
+
+            if ( ! empty($thead))
+            {
+                $rows[] = array_values($thead);
+            }
+
+            foreach ($tbody as $tr)
+            {
+                $rows[] = count($rows);
+            }
+
+            $totalRows = count($rows);
+
+            // Store all columns lengths
+            $allColsLengths = [];
+
+            // Store maximum lengths by column
+            $maxColsLengths = [];
+
+            for ($row = 0; $row < $totalRows; $row++)
+            {
+                $column = 0;
+
+                foreach ($rows[$row] as $col)
+                {
+                    $allColsLengths[$row][$column] = static::strlen($col);
+
+                    if ( ! isset($maxColsLengths[$column]) || $allColsLengths[$row][$column] > $maxColsLengths[$column])
+                    {
+                        $maxColsLengths[$column] = $allColsLengths[$row][$column];
+                    }
+
+                    $column++;
+                }
+            }
+
+            for ($row = 0; $row < $totalRows; $row++)
+            {
+                $column = 0;
+
+                foreach ($rows[$row] as $col)
+                {
+                    $diverse = $maxColsLengths[$column] - static::strlen($col);
  				
- 				if ($diverse)	
- 				{
- 					$rows[$row][$column] = $rows[$row][$column].str_repeat(' ', $diverse);
- 				}
+                    if ($diverse)	
+                    {
+                        $rows[$row][$column] = $rows[$row][$column].str_repeat(' ', $diverse);
+                    }
 
- 				$column++;
- 			} 			
- 		}
+                    $column++;
+                } 			
+            }
 
- 		$table = '';
+            $table = '';
 
- 		for ($row = 0; $row < $rows; $row++)
- 		{
- 			if (0 === $row)
- 			{
- 				$cols = '+';
+            for ($row = 0; $row < $rows; $row++)
+            {
+                if (0 === $row)
+                {
+                    $cols = '+';
 
- 				foreach ($rows[$row] as $col) 
- 				{
- 					$cols .= str_repeat('-', static::strlen($col) + 2).'+';
- 				}
+                    foreach ($rows[$row] as $col) 
+                    {
+                        $cols .= str_repeat('-', static::strlen($col) + 2).'+';
+                    }
 
- 				$table .= $cols.PHP_EOL;
- 			}
+                    $table .= $cols.PHP_EOL;
+                }
 
- 			$table .= '| '.implode('-', $rows[$row]).' |'.PHP_EOL;
+                $table .= '| '.implode('-', $rows[$row]).' |'.PHP_EOL;
 
- 			if (0 === $row && ! empty($thead) || $row + 1 === $rows)
- 			{
- 				$table .= $cols.PHP_EOL;
- 			}
- 		}
+                if (0 === $row && ! empty($thead) || $row + 1 === $rows)
+                {
+                    $table .= $cols.PHP_EOL;
+                }
+            }
 
- 		fwrite(static::$stdout, $table);
- 	}
+            fwrite(static::$stdout, $table);
+        }
 }
\ No newline at end of file