intraxia / jaxion

src/Contract/Core/HasActions.php

Indentation +9 added lines, -9 removed lines

@@ -2,13 +2,13 @@
 namespace Intraxia\Jaxion\Contract\Core;
 
 interface HasActions {
-	/**
-	 * Provides the array of actions the class wants to register with WordPress.
-	 *
-	 * These actions are retrieved by the Loader class and used to register the
-	 * correct service methods with WordPress.
-	 *
-	 * @return array[]
-	 */
-	public function action_hooks();
+    /**
+     * Provides the array of actions the class wants to register with WordPress.
+     *
+     * These actions are retrieved by the Loader class and used to register the
+     * correct service methods with WordPress.
+     *
+     * @return array[]
+     */
+    public function action_hooks();
 }
\ No newline at end of file

src/Contract/Assets/Register.php

Indentation +44 added lines, -44 removed lines

@@ -4,48 +4,48 @@
 use Intraxia\Jaxion\Contract\Core\HasActions;
 
 interface Register extends HasActions {
-	/**
-	 * Enable debug mode for the enqueued assets.
-	 *
-	 * Debug mode will enqueue unminified versions of the registered assets.
-	 * Primarily, this is intended to be used along with WordPress's `SCRIPT_DEBUG`
-	 * constant, which enables unminified core assets to be enqueued.
-	 *
-	 * @param bool $debug
-	 */
-	public function set_debug( $debug );
-
-	/**
-	 * Provides a method to register new scripts outside of the constructor.
-	 *
-	 * @param $script
-	 */
-	public function register_script( $script );
-
-	/**
-	 * Provides a method to register new styles outside of the constructor.
-	 *
-	 * @param $style
-	 */
-	public function register_style( $style );
-
-	/**
-	 * Enqueues the web & shared scripts on the Register.
-	 */
-	public function enqueue_web_scripts();
-
-	/**
-	 * Enqueues the web & shared styles on the Register.
-	 */
-	public function enqueue_web_styles();
-
-	/**
-	 * Enqueues the admin & shared scripts on the Register.
-	 */
-	public function enqueue_admin_scripts();
-
-	/**
-	 * Enqueues the admin & shared styles on the Register.
-	 */
-	public function enqueue_admin_styles();
+    /**
+     * Enable debug mode for the enqueued assets.
+     *
+     * Debug mode will enqueue unminified versions of the registered assets.
+     * Primarily, this is intended to be used along with WordPress's `SCRIPT_DEBUG`
+     * constant, which enables unminified core assets to be enqueued.
+     *
+     * @param bool $debug
+     */
+    public function set_debug( $debug );
+
+    /**
+     * Provides a method to register new scripts outside of the constructor.
+     *
+     * @param $script
+     */
+    public function register_script( $script );
+
+    /**
+     * Provides a method to register new styles outside of the constructor.
+     *
+     * @param $style
+     */
+    public function register_style( $style );
+
+    /**
+     * Enqueues the web & shared scripts on the Register.
+     */
+    public function enqueue_web_scripts();
+
+    /**
+     * Enqueues the web & shared styles on the Register.
+     */
+    public function enqueue_web_styles();
+
+    /**
+     * Enqueues the admin & shared scripts on the Register.
+     */
+    public function enqueue_admin_scripts();
+
+    /**
+     * Enqueues the admin & shared styles on the Register.
+     */
+    public function enqueue_admin_styles();
 }

src/Contract/Http/Filter.php

Indentation +9 added lines, -9 removed lines

@@ -10,13 +10,13 @@
  * @subpackage Contract\Http
  */
 interface Filter {
-	/**
-	 * Generates argument rules.
-	 *
-	 * Returns an array matching the WP-API format for argument rules,
-	 * including sanitization, validation, required, or defaults.
-	 *
-	 * @return array
-	 */
-	public function rules();
+    /**
+     * Generates argument rules.
+     *
+     * Returns an array matching the WP-API format for argument rules,
+     * including sanitization, validation, required, or defaults.
+     *
+     * @return array
+     */
+    public function rules();
 }

src/Contract/Http/Guard.php

Indentation +9 added lines, -9 removed lines

@@ -10,13 +10,13 @@
  * @subpackage Contract\Http
  */
 interface Guard {
-	/**
-	 * Validates when the user is authorized for the route.
-	 *
-	 * Returns a boolean based on whether the current user is authorized
-	 * to interact with the given route.
-	 *
-	 * @return bool
-	 */
-	public function authorized();
+    /**
+     * Validates when the user is authorized for the route.
+     *
+     * Returns a boolean based on whether the current user is authorized
+     * to interact with the given route.
+     *
+     * @return bool
+     */
+    public function authorized();
 }

src/Assets/Register.php

Indentation +194 added lines, -194 removed lines

@@ -12,198 +12,198 @@
  * @subpackage Register
  */
 class Register implements RegisterContract {
-	/**
-	 * Minification string for enqueued assets.
-	 *
-	 * @var string
-	 */
-	private $min = '';
-
-	/**
-	 * Url to the plugin directory.
-	 *
-	 * @var string
-	 */
-	protected $url;
-
-	/**
-	 * Script/plugin version.
-	 *
-	 * @var string
-	 */
-	protected $version;
-
-	/**
-	 * Array of script definition arrays.
-	 *
-	 * @var array
-	 */
-	private $scripts = array();
-
-	/**
-	 * Array of style definition arrays.
-	 *
-	 * @var array
-	 */
-	private $styles = array();
-
-	/**
-	 * Instantiates a new instance of the Register class.
-	 *
-	 * The URL param should be relative to the plugin directory. The URL
-	 * form should always end with a '/'. All asset location definitions
-	 * should not begin with a slash and should be relative to the plugin's
-	 * root directory. The URL provided by default from the Application
-	 * class is compatible.
-	 *
-	 * @param string $url
-	 * @param string $version
-	 */
-	public function __construct( $url, $version = null ) {
-		$this->url = $url;
-		$this->version = $version;
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param bool $debug
-	 */
-	public function set_debug( $debug ) {
-		if ( $debug ) {
-			$this->min = '.min';
-		} else {
-			$this->min = '';
-		}
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param array $script
-	 */
-	public function register_script( $script ) {
-		$this->scripts[] = $script;
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param array $style
-	 */
-	public function register_style( $style ) {
-		$this->styles[] = $style;
-	}
-
-	/**
-	 * {@inheritDoc}
-	 */
-	public function enqueue_web_scripts() {
-		foreach ( $this->scripts as $script ) {
-			if ( in_array( $script['type'], array( 'web', 'shared' ) ) ) {
-				$this->enqueue_script( $script );
-			}
-		}
-	}
-
-	/**
-	 * {@inheritDoc}
-	 */
-	public function enqueue_web_styles() {
-		foreach ( $this->styles as $style ) {
-			if ( in_array( $style['type'], array( 'web', 'shared' ) ) ) {
-				$this->enqueue_style( $style );
-			}
-		}
-	}
-
-	/**
-	 * {@inheritDoc}
-	 */
-	public function enqueue_admin_scripts() {
-		foreach ( $this->scripts as $script ) {
-			if ( in_array( $script['type'], array( 'admin', 'shared' ) ) ) {
-				$this->enqueue_script( $script );
-			}
-		}
-	}
-
-	/**
-	 * {@inheritDoc}
-	 */
-	public function enqueue_admin_styles() {
-		foreach ( $this->styles as $style ) {
-			if ( in_array( $style['type'], array( 'admin', 'shared' ) ) ) {
-				$this->enqueue_style( $style );
-			}
-		}
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @return array[]
-	 */
-	public function action_hooks() {
-		return array(
-			array(
-				'hook'   => 'wp_enqueue_scripts',
-				'method' => 'enqueue_web_scripts',
-			),
-			array(
-				'hook'   => 'wp_enqueue_scripts',
-				'method' => 'enqueue_web_styles',
-			),
-			array(
-				'hook'   => 'admin_enqueue_scripts',
-				'method' => 'enqueue_admin_scripts',
-			),
-			array(
-				'hook'   => 'admin_enqueue_scripts',
-				'method' => 'enqueue_admin_styles',
-			),
-		);
-	}
-
-	/**
-	 * Enqueues an individual script if the style's condition is met.
-	 *
-	 * @param array $script
-	 */
-	protected function enqueue_script( $script ) {
-		if ( $script['condition']() ) {
-			wp_enqueue_script(
-				$script['handle'],
-				$this->url . $script['src'] . '.js',
-				isset( $script['deps'] ) ? $script['deps'] : array(),
-				$this->version,
-				isset( $script['footer'] ) ? $script['footer'] : false
-			);
-
-			if ( isset( $script['localize'] ) ) {
-				wp_localize_script(
-					$script['handle'],
-					$script['localize']['name'],
-					$script['localize']['data']
-				);
-			}
-		}
-	}
-
-	/**
-	 * Enqueues an individual stylesheet if the style's condition is met.
-	 *
-	 * @param array $style
-	 */
-	protected function enqueue_style( $style ) {
-		if ( $style['condition']() ) {
-			wp_enqueue_style(
-				$style['handle'],
-				$this->url . $style['src'] . '.css',
-				isset( $style['deps'] ) ? $style['deps'] : array(),
-				$this->version,
-				isset( $style['media'] ) ? $style['media'] : 'all'
-			);
-		}
-	}
+    /**
+     * Minification string for enqueued assets.
+     *
+     * @var string
+     */
+    private $min = '';
+
+    /**
+     * Url to the plugin directory.
+     *
+     * @var string
+     */
+    protected $url;
+
+    /**
+     * Script/plugin version.
+     *
+     * @var string
+     */
+    protected $version;
+
+    /**
+     * Array of script definition arrays.
+     *
+     * @var array
+     */
+    private $scripts = array();
+
+    /**
+     * Array of style definition arrays.
+     *
+     * @var array
+     */
+    private $styles = array();
+
+    /**
+     * Instantiates a new instance of the Register class.
+     *
+     * The URL param should be relative to the plugin directory. The URL
+     * form should always end with a '/'. All asset location definitions
+     * should not begin with a slash and should be relative to the plugin's
+     * root directory. The URL provided by default from the Application
+     * class is compatible.
+     *
+     * @param string $url
+     * @param string $version
+     */
+    public function __construct( $url, $version = null ) {
+        $this->url = $url;
+        $this->version = $version;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param bool $debug
+     */
+    public function set_debug( $debug ) {
+        if ( $debug ) {
+            $this->min = '.min';
+        } else {
+            $this->min = '';
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param array $script
+     */
+    public function register_script( $script ) {
+        $this->scripts[] = $script;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param array $style
+     */
+    public function register_style( $style ) {
+        $this->styles[] = $style;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function enqueue_web_scripts() {
+        foreach ( $this->scripts as $script ) {
+            if ( in_array( $script['type'], array( 'web', 'shared' ) ) ) {
+                $this->enqueue_script( $script );
+            }
+        }
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function enqueue_web_styles() {
+        foreach ( $this->styles as $style ) {
+            if ( in_array( $style['type'], array( 'web', 'shared' ) ) ) {
+                $this->enqueue_style( $style );
+            }
+        }
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function enqueue_admin_scripts() {
+        foreach ( $this->scripts as $script ) {
+            if ( in_array( $script['type'], array( 'admin', 'shared' ) ) ) {
+                $this->enqueue_script( $script );
+            }
+        }
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function enqueue_admin_styles() {
+        foreach ( $this->styles as $style ) {
+            if ( in_array( $style['type'], array( 'admin', 'shared' ) ) ) {
+                $this->enqueue_style( $style );
+            }
+        }
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @return array[]
+     */
+    public function action_hooks() {
+        return array(
+            array(
+                'hook'   => 'wp_enqueue_scripts',
+                'method' => 'enqueue_web_scripts',
+            ),
+            array(
+                'hook'   => 'wp_enqueue_scripts',
+                'method' => 'enqueue_web_styles',
+            ),
+            array(
+                'hook'   => 'admin_enqueue_scripts',
+                'method' => 'enqueue_admin_scripts',
+            ),
+            array(
+                'hook'   => 'admin_enqueue_scripts',
+                'method' => 'enqueue_admin_styles',
+            ),
+        );
+    }
+
+    /**
+     * Enqueues an individual script if the style's condition is met.
+     *
+     * @param array $script
+     */
+    protected function enqueue_script( $script ) {
+        if ( $script['condition']() ) {
+            wp_enqueue_script(
+                $script['handle'],
+                $this->url . $script['src'] . '.js',
+                isset( $script['deps'] ) ? $script['deps'] : array(),
+                $this->version,
+                isset( $script['footer'] ) ? $script['footer'] : false
+            );
+
+            if ( isset( $script['localize'] ) ) {
+                wp_localize_script(
+                    $script['handle'],
+                    $script['localize']['name'],
+                    $script['localize']['data']
+                );
+            }
+        }
+    }
+
+    /**
+     * Enqueues an individual stylesheet if the style's condition is met.
+     *
+     * @param array $style
+     */
+    protected function enqueue_style( $style ) {
+        if ( $style['condition']() ) {
+            wp_enqueue_style(
+                $style['handle'],
+                $this->url . $style['src'] . '.css',
+                isset( $style['deps'] ) ? $style['deps'] : array(),
+                $this->version,
+                isset( $style['media'] ) ? $style['media'] : 'all'
+            );
+        }
+    }
 }

src/Assets/RegisterServiceProvider.php

Indentation +23 added lines, -23 removed lines

@@ -5,29 +5,29 @@
 use Intraxia\Jaxion\Contract\Core\ServiceProvider;
 
 class RegisterServiceProvider implements ServiceProvider {
-	/**
-	 * {@inheritDoc}
-	 */
-	public function register( Container $container ) {
-		$container->define(
-			array( 'register' => 'Intraxia\Jaxion\Contract\Assets\Register' ),
-			$register = new Register( $container->fetch( 'url' ), $container->fetch( 'version' ) )
-		);
+    /**
+     * {@inheritDoc}
+     */
+    public function register( Container $container ) {
+        $container->define(
+            array( 'register' => 'Intraxia\Jaxion\Contract\Assets\Register' ),
+            $register = new Register( $container->fetch( 'url' ), $container->fetch( 'version' ) )
+        );
 
-		$this->add_assets( $register );
-	}
+        $this->add_assets( $register );
+    }
 
-	/**
-	 * Registers the assets on the generated Register.
-	 *
-	 * This is a no-op by default by can be overwritten by the implementing developer
-	 * to provide a single, clean location to register their assets.
-	 *
-	 * @param Register $register
-	 *
-	 * @codeCoverageIgnore
-	 */
-	protected function add_assets( Register $register ) {
-		// no-op
-	}
+    /**
+     * Registers the assets on the generated Register.
+     *
+     * This is a no-op by default by can be overwritten by the implementing developer
+     * to provide a single, clean location to register their assets.
+     *
+     * @param Register $register
+     *
+     * @codeCoverageIgnore
+     */
+    protected function add_assets( Register $register ) {
+        // no-op
+    }
 }
\ No newline at end of file

src/Utility/Str.php

Indentation +32 added lines, -32 removed lines

@@ -11,39 +11,39 @@
  * @subpackage Utility
  */
 class Str {
-	/**
-	 * Determine if a given string starts with a given substring.
-	 *
-	 * @param  string       $haystack
-	 * @param  string|array $needles
-	 *
-	 * @return bool
-	 */
-	public static function starts_with( $haystack, $needles ) {
-		foreach ( (array) $needles as $needle ) {
-			if ( $needle != '' && strpos( $haystack, $needle ) === 0 ) {
-				return true;
-			}
-		}
+    /**
+     * Determine if a given string starts with a given substring.
+     *
+     * @param  string       $haystack
+     * @param  string|array $needles
+     *
+     * @return bool
+     */
+    public static function starts_with( $haystack, $needles ) {
+        foreach ( (array) $needles as $needle ) {
+            if ( $needle != '' && strpos( $haystack, $needle ) === 0 ) {
+                return true;
+            }
+        }
 
-		return false;
-	}
+        return false;
+    }
 
-	/**
-	 * Determine if a given string ends with a given substring.
-	 *
-	 * @param  string       $haystack
-	 * @param  string|array $needles
-	 *
-	 * @return bool
-	 */
-	public static function ends_with( $haystack, $needles ) {
-		foreach ( (array) $needles as $needle ) {
-			if ( (string) $needle === substr( $haystack, - strlen( $needle ) ) ) {
-				return true;
-			}
-		}
+    /**
+     * Determine if a given string ends with a given substring.
+     *
+     * @param  string       $haystack
+     * @param  string|array $needles
+     *
+     * @return bool
+     */
+    public static function ends_with( $haystack, $needles ) {
+        foreach ( (array) $needles as $needle ) {
+            if ( (string) $needle === substr( $haystack, - strlen( $needle ) ) ) {
+                return true;
+            }
+        }
 
-		return false;
-	}
+        return false;
+    }
 }

src/Http/Router.php

Indentation +198 added lines, -198 removed lines

@@ -21,202 +21,202 @@
  * @method Endpoint all(string $route, callable $callback, array $options = array())
  */
 class Router implements HasActions {
-	/**
-	 * Resource's vendor prefix.
-	 *
-	 * @var string
-	 */
-	protected $vendor;
-
-	/**
-	 * Resource's version.
-	 *
-	 * @var int
-	 */
-	protected $version;
-
-	/**
-	 * Valid methods and their HTTP verb(s).
-	 *
-	 * @var array
-	 */
-	private $methods = array(
-		'get'      => 'GET',
-		'post'     => 'POST',
-		'put'      => 'PUT',
-		'patch'    => 'PATCH',
-		'delete'   => 'DELETE',
-		'editable' => 'POST, PUT, PATCH',
-		'all'      => 'GET, POST, PUT, PATCH, DELETE',
-	);
-
-	/**
-	 * Endpoints registered for the resource.
-	 *
-	 * @var Endpoint[]
-	 */
-	protected $endpoints = array();
-
-	/**
-	 * Returns all the resource endpoints.
-	 *
-	 * @return Endpoint[]
-	 */
-	public function get_endpoints() {
-		return $this->endpoints;
-	}
-
-	/**
-	 * Sets the resource's vendor prefix.
-	 *
-	 * @param string $vendor
-	 */
-	public function set_vendor( $vendor ) {
-		$this->vendor = $vendor;
-	}
-
-	/**
-	 * Sets the resource's version.
-	 *
-	 * @param int $version
-	 */
-	public function set_version( $version ) {
-		$this->version = $version;
-	}
-
-	/**
-	 * Registers all of the routes with the WP-API.
-	 *
-	 * Runs on the `rest_api_init` hook. Registers all of the routes loaded
-	 * on the router into the WordPress REST API.
-	 *
-	 * @throws VendorNotSetException
-	 * @throws VersionNotSetException
-	 */
-	public function register() {
-		if ( ! $this->vendor ) {
-			throw new VendorNotSetException;
-		}
-
-		if ( ! $this->version ) {
-			throw new VersionNotSetException;
-		}
-
-		foreach ( $this->endpoints as $endpoint ) {
-			register_rest_route(
-				$this->get_namespace(),
-				$endpoint->get_route(),
-				$endpoint->get_options()
-			);
-		}
-	}
-
-	/**
-	 * Registers a set of routes with a shared set of options.
-	 *
-	 * Allows you to group routes together with shared set of options, including
-	 * a route prefix, shared guards, and common parameter validation or sanitization.
-	 *
-	 * @param array    $options
-	 * @param callable $callback
-	 */
-	public function group( array $options, $callback ) {
-		$router = new static;
-
-		call_user_func( $callback, $router );
-
-		foreach ( $router->get_endpoints() as $endpoint ) {
-			$this->endpoints[] = $this->set_options( $endpoint, $options );
-		}
-	}
-
-	/**
-	 * Magic __call method.
-	 *
-	 * All of the endpoints registration method calls pass through here. This validates whether the method
-	 * is a valid endpoint type to register, and creates a new endpoint with the passed options.
-	 *
-	 * @param string $name
-	 * @param array  $arguments
-	 *
-	 * @return Endpoint
-	 *
-	 * @throws UnknownMethodException
-	 * @throws MissingArgumentException
-	 * @throws InvalidArgumentException
-	 */
-	public function __call( $name, $arguments ) {
-		if ( ! in_array( $name, array_keys( $this->methods ) ) ) {
-			throw new UnknownMethodException;
-		}
-
-		// array_merge ensures we have 3 elements
-		list( $route, $callback, $options ) = array_merge( $arguments, array( null, null, null ) );
-
-		if ( ! $route || ! $callback ) {
-			throw new MissingArgumentException;
-		}
-
-		if ( ! is_callable( $callback ) ) {
-			throw new InvalidArgumentException;
-		}
-
-		$endpoint = new Endpoint( $route, $this->methods[ $name ], $callback );
-
-		if ( $options && is_array( $options ) ) {
-			$endpoint = $this->set_options( $endpoint, $options );
-		}
-
-		return $this->endpoints[] = $endpoint;
-	}
-
-	/**
-	 * Sets the passed options on the endpoint.
-	 *
-	 * Only sets endpoints matching setters in the Endpoint class.
-	 *
-	 * @param Endpoint $endpoint
-	 * @param array    $options
-	 *
-	 * @return Endpoint
-	 * @throws MalformedRouteException
-	 */
-	protected function set_options( Endpoint $endpoint, array $options ) {
-		if ( isset( $options['guard'] ) ) {
-			$endpoint->set_guard( $options['guard'] );
-		}
-
-		if ( isset( $options['filter'] ) ) {
-			$endpoint->set_filter( $options['filter'] );
-		}
-
-		if ( isset( $options['prefix'] ) ) {
-			$endpoint->set_prefix( $options['prefix'] );
-		}
-
-		return $endpoint;
-	}
-
-	/**
-	 * Generates the resource's namespace.
-	 *
-	 * @return string
-	 */
-	protected function get_namespace() {
-		return $this->vendor . '/v' . $this->version;
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @return array[]
-	 */
-	public function action_hooks() {
-		return array(
-			array(
-				'method' => 'register',
-				'hook'   => 'rest_api_init',
-			),
-		);
-	}
+    /**
+     * Resource's vendor prefix.
+     *
+     * @var string
+     */
+    protected $vendor;
+
+    /**
+     * Resource's version.
+     *
+     * @var int
+     */
+    protected $version;
+
+    /**
+     * Valid methods and their HTTP verb(s).
+     *
+     * @var array
+     */
+    private $methods = array(
+        'get'      => 'GET',
+        'post'     => 'POST',
+        'put'      => 'PUT',
+        'patch'    => 'PATCH',
+        'delete'   => 'DELETE',
+        'editable' => 'POST, PUT, PATCH',
+        'all'      => 'GET, POST, PUT, PATCH, DELETE',
+    );
+
+    /**
+     * Endpoints registered for the resource.
+     *
+     * @var Endpoint[]
+     */
+    protected $endpoints = array();
+
+    /**
+     * Returns all the resource endpoints.
+     *
+     * @return Endpoint[]
+     */
+    public function get_endpoints() {
+        return $this->endpoints;
+    }
+
+    /**
+     * Sets the resource's vendor prefix.
+     *
+     * @param string $vendor
+     */
+    public function set_vendor( $vendor ) {
+        $this->vendor = $vendor;
+    }
+
+    /**
+     * Sets the resource's version.
+     *
+     * @param int $version
+     */
+    public function set_version( $version ) {
+        $this->version = $version;
+    }
+
+    /**
+     * Registers all of the routes with the WP-API.
+     *
+     * Runs on the `rest_api_init` hook. Registers all of the routes loaded
+     * on the router into the WordPress REST API.
+     *
+     * @throws VendorNotSetException
+     * @throws VersionNotSetException
+     */
+    public function register() {
+        if ( ! $this->vendor ) {
+            throw new VendorNotSetException;
+        }
+
+        if ( ! $this->version ) {
+            throw new VersionNotSetException;
+        }
+
+        foreach ( $this->endpoints as $endpoint ) {
+            register_rest_route(
+                $this->get_namespace(),
+                $endpoint->get_route(),
+                $endpoint->get_options()
+            );
+        }
+    }
+
+    /**
+     * Registers a set of routes with a shared set of options.
+     *
+     * Allows you to group routes together with shared set of options, including
+     * a route prefix, shared guards, and common parameter validation or sanitization.
+     *
+     * @param array    $options
+     * @param callable $callback
+     */
+    public function group( array $options, $callback ) {
+        $router = new static;
+
+        call_user_func( $callback, $router );
+
+        foreach ( $router->get_endpoints() as $endpoint ) {
+            $this->endpoints[] = $this->set_options( $endpoint, $options );
+        }
+    }
+
+    /**
+     * Magic __call method.
+     *
+     * All of the endpoints registration method calls pass through here. This validates whether the method
+     * is a valid endpoint type to register, and creates a new endpoint with the passed options.
+     *
+     * @param string $name
+     * @param array  $arguments
+     *
+     * @return Endpoint
+     *
+     * @throws UnknownMethodException
+     * @throws MissingArgumentException
+     * @throws InvalidArgumentException
+     */
+    public function __call( $name, $arguments ) {
+        if ( ! in_array( $name, array_keys( $this->methods ) ) ) {
+            throw new UnknownMethodException;
+        }
+
+        // array_merge ensures we have 3 elements
+        list( $route, $callback, $options ) = array_merge( $arguments, array( null, null, null ) );
+
+        if ( ! $route || ! $callback ) {
+            throw new MissingArgumentException;
+        }
+
+        if ( ! is_callable( $callback ) ) {
+            throw new InvalidArgumentException;
+        }
+
+        $endpoint = new Endpoint( $route, $this->methods[ $name ], $callback );
+
+        if ( $options && is_array( $options ) ) {
+            $endpoint = $this->set_options( $endpoint, $options );
+        }
+
+        return $this->endpoints[] = $endpoint;
+    }
+
+    /**
+     * Sets the passed options on the endpoint.
+     *
+     * Only sets endpoints matching setters in the Endpoint class.
+     *
+     * @param Endpoint $endpoint
+     * @param array    $options
+     *
+     * @return Endpoint
+     * @throws MalformedRouteException
+     */
+    protected function set_options( Endpoint $endpoint, array $options ) {
+        if ( isset( $options['guard'] ) ) {
+            $endpoint->set_guard( $options['guard'] );
+        }
+
+        if ( isset( $options['filter'] ) ) {
+            $endpoint->set_filter( $options['filter'] );
+        }
+
+        if ( isset( $options['prefix'] ) ) {
+            $endpoint->set_prefix( $options['prefix'] );
+        }
+
+        return $endpoint;
+    }
+
+    /**
+     * Generates the resource's namespace.
+     *
+     * @return string
+     */
+    protected function get_namespace() {
+        return $this->vendor . '/v' . $this->version;
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @return array[]
+     */
+    public function action_hooks() {
+        return array(
+            array(
+                'method' => 'register',
+                'hook'   => 'rest_api_init',
+            ),
+        );
+    }
 }

src/Http/Filter.php

Indentation +79 added lines, -79 removed lines

@@ -12,96 +12,96 @@
  * @subpackage Http
  */
 class Filter implements FilterContract {
-	/**
-	 * Filter rules.
-	 *
-	 * @var array
-	 */
-	protected $rules;
+    /**
+     * Filter rules.
+     *
+     * @var array
+     */
+    protected $rules;
 
-	/**
-	 * Instantiates a new filter with the provided rules array.
-	 *
-	 * @param array $rules
-	 */
-	public function __construct( $rules = array() ) {
-		$this->rules = $rules;
-	}
+    /**
+     * Instantiates a new filter with the provided rules array.
+     *
+     * @param array $rules
+     */
+    public function __construct( $rules = array() ) {
+        $this->rules = $rules;
+    }
 
-	/**
-	 * Generates argument rules.
-	 *
-	 * Returns an array matching the WP-API format for argument rules,
-	 * including sanitization, validation, required, or defaults.
-	 *
-	 * @return array
-	 */
-	public function rules() {
-		$args = array();
+    /**
+     * Generates argument rules.
+     *
+     * Returns an array matching the WP-API format for argument rules,
+     * including sanitization, validation, required, or defaults.
+     *
+     * @return array
+     */
+    public function rules() {
+        $args = array();
 
-		foreach ( $this->rules as $arg => $validation ) {
-			if ( ! $validation || ! is_string( $validation ) ) {
-				continue;
-			}
+        foreach ( $this->rules as $arg => $validation ) {
+            if ( ! $validation || ! is_string( $validation ) ) {
+                continue;
+            }
 
-			$args[ $arg ] = $this->parse_validation( $validation );
-		}
+            $args[ $arg ] = $this->parse_validation( $validation );
+        }
 
-		return $args;
-	}
+        return $args;
+    }
 
-	/**
-	 * Parses a validation string into a WP-API compatible rule.
-	 *
-	 * @param string $validation
-	 *
-	 * @return array
-	 */
-	protected function parse_validation( $validation ) {
-		$validation = explode( '|', $validation );
+    /**
+     * Parses a validation string into a WP-API compatible rule.
+     *
+     * @param string $validation
+     *
+     * @return array
+     */
+    protected function parse_validation( $validation ) {
+        $validation = explode( '|', $validation );
 
-		$rules = array();
+        $rules = array();
 
-		foreach ( $validation as $rule ) {
-			if ( 0 === strpos( $rule, 'default' ) ) {
-				$ruleArr = explode( ':', $rule );
+        foreach ( $validation as $rule ) {
+            if ( 0 === strpos( $rule, 'default' ) ) {
+                $ruleArr = explode( ':', $rule );
 
-				$rules['default'] = count( $ruleArr ) === 2 ? array_pop( $ruleArr ) : '';
-			}
+                $rules['default'] = count( $ruleArr ) === 2 ? array_pop( $ruleArr ) : '';
+            }
 
-			switch ( $rule ) {
-				case 'required':
-					$rules['required'] = true;
-					break;
-				case 'integer':
-					$rules['validate_callback'] = array( $this, 'validate_integer' );
-					$rules['sanitize_callback'] = array( $this, 'make_integer' );
-					break;
-			}
-		}
+            switch ( $rule ) {
+                case 'required':
+                    $rules['required'] = true;
+                    break;
+                case 'integer':
+                    $rules['validate_callback'] = array( $this, 'validate_integer' );
+                    $rules['sanitize_callback'] = array( $this, 'make_integer' );
+                    break;
+            }
+        }
 
-		return $rules;
-	}
+        return $rules;
+    }
 
-	/**
-	 * Validate that provided value is an integer.
-	 *
-	 * @param mixed $value
-	 *
-	 * @return bool
-	 */
-	public function validate_integer( $value ) {
-		return filter_var( $value, FILTER_VALIDATE_INT ) !== false;
-	}
+    /**
+     * Validate that provided value is an integer.
+     *
+     * @param mixed $value
+     *
+     * @return bool
+     */
+    public function validate_integer( $value ) {
+        return filter_var( $value, FILTER_VALIDATE_INT ) !== false;
+    }
 
-	/**
-	 * Casts a provided value to an integer.
-	 *
-	 * @param mixed $value
-	 *
-	 * @return int
-	 */
-	public function make_integer( $value ) {
-		return (int) $value;
-	}
+    /**
+     * Casts a provided value to an integer.
+     *
+     * @param mixed $value
+     *
+     * @return int
+     */
+    public function make_integer( $value ) {
+        return (int) $value;
+    }
 }