intraxia / jaxion

src/Contract/Core/Container.php

Indentation +66 added lines, -66 removed lines

@@ -2,75 +2,75 @@
 namespace Intraxia\Jaxion\Contract\Core;
 
 interface Container extends \ArrayAccess, \Iterator {
-	/**
-	 * Define a new service or value on the Container.
-	 *
-	 * The alias is the name that the value will be referenced by. This can be used by both
-	 * the `get` method to retrieve the value or through ArrayAccess (`$container['alias']`).
-	 * It should be a short name used to reference the defined value. The definition can be
-	 * any scalar value to assign to the alias, or it can define a service object to return.
-	 * This can be accomplished by passing in a closure, which takes the container and returns
-	 * a fully constructed object. This closure will be executed every time the class is fetched.
-	 * If an already-instantiated object is passed in, it will be returned when fetched. A
-	 * Definition object will be returned for additional manipulation. Scalar values will be
-	 * locked automatically and can't be overridden.
-	 *
-	 * @param string|array $alias
-	 * @param mixed        $definition
-	 *
-	 * @return $this
-	 */
-	public function define( $alias, $definition );
+    /**
+     * Define a new service or value on the Container.
+     *
+     * The alias is the name that the value will be referenced by. This can be used by both
+     * the `get` method to retrieve the value or through ArrayAccess (`$container['alias']`).
+     * It should be a short name used to reference the defined value. The definition can be
+     * any scalar value to assign to the alias, or it can define a service object to return.
+     * This can be accomplished by passing in a closure, which takes the container and returns
+     * a fully constructed object. This closure will be executed every time the class is fetched.
+     * If an already-instantiated object is passed in, it will be returned when fetched. A
+     * Definition object will be returned for additional manipulation. Scalar values will be
+     * locked automatically and can't be overridden.
+     *
+     * @param string|array $alias
+     * @param mixed        $definition
+     *
+     * @return $this
+     */
+    public function define( $alias, $definition );
 
-	/**
-	 * Defines a new singleton on the Container.
-	 *
-	 * Functions identically to Container::define, except closures passed in are only executed
-	 * once, and the return value is reused across multiple fetches.
-	 *
-	 * @param string|array $alias
-	 * @param mixed        $definition
-	 *
-	 * @return $this
-	 */
-	public function share( $alias, $definition );
+    /**
+     * Defines a new singleton on the Container.
+     *
+     * Functions identically to Container::define, except closures passed in are only executed
+     * once, and the return value is reused across multiple fetches.
+     *
+     * @param string|array $alias
+     * @param mixed        $definition
+     *
+     * @return $this
+     */
+    public function share( $alias, $definition );
 
-	/**
-	 * Fetches the value for the provided alias.
-	 *
-	 * @param string $alias
-	 *
-	 * @return mixed
-	 */
-	public function fetch( $alias );
+    /**
+     * Fetches the value for the provided alias.
+     *
+     * @param string $alias
+     *
+     * @return mixed
+     */
+    public function fetch( $alias );
 
-	/**
-	 * Checks whether the provided alias exists on the container.
-	 *
-	 * @param string $alias
-	 *
-	 * @return bool
-	 */
-	public function has( $alias );
+    /**
+     * Checks whether the provided alias exists on the container.
+     *
+     * @param string $alias
+     *
+     * @return bool
+     */
+    public function has( $alias );
 
-	/**
-	 * Removes the provided alias from the container.
-	 *
-	 * @param string $alias
-	 *
-	 * @return bool
-	 */
-	public function remove( $alias );
+    /**
+     * Removes the provided alias from the container.
+     *
+     * @param string $alias
+     *
+     * @return bool
+     */
+    public function remove( $alias );
 
-	/**
-	 * Registers a service provider with the container.
-	 *
-	 * A service provider is responsible for defining and generating services that will be bound
-	 * into the container. This keeps the container and Application responsible solely for maintaining
-	 * the generated services and the API for registering them and allows for a clean interface for
-	 * adding new services to the container.
-	 *
-	 * @param ServiceProvider $provider
-	 */
-	public function register( ServiceProvider $provider );
+    /**
+     * Registers a service provider with the container.
+     *
+     * A service provider is responsible for defining and generating services that will be bound
+     * into the container. This keeps the container and Application responsible solely for maintaining
+     * the generated services and the API for registering them and allows for a clean interface for
+     * adding new services to the container.
+     *
+     * @param ServiceProvider $provider
+     */
+    public function register( ServiceProvider $provider );
 }

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/Http/Endpoint.php

Indentation +137 added lines, -137 removed lines

@@ -14,141 +14,141 @@
  * @subpackage Http
  */
 class Endpoint {
-	/**
-	 * Endpoint's route.
-	 *
-	 * @var string
-	 */
-	protected $route;
-
-	/**
-	 * Endpoint's HTTP verb(s).
-	 *
-	 * @var string
-	 */
-	protected $method;
-
-	/**
-	 * Endpoint's callback.
-	 *
-	 * @var callable
-	 */
-	protected $callback;
-
-	/**
-	 * Endpoint's permission guard.
-	 *
-	 * @var GuardContract
-	 */
-	protected $guard;
-
-	/**
-	 * Endpoint's arguments filter.
-	 *
-	 * @var FilterContract
-	 */
-	protected $filter;
-
-	/**
-	 * Endpoint's route prefix.
-	 *
-	 * @var string
-	 */
-	protected $prefix;
-
-	/**
-	 * Instantiate a new endpoint with a provided route, method, and callback.
-	 *
-	 * @param string   $route
-	 * @param string   $method
-	 * @param callable $callback
-	 *
-	 * @throws MalformedRouteException
-	 */
-	public function __construct( $route, $method, $callback ) {
-		if ( ! Str::starts_with( $route, '/' ) || Str::ends_with( $route, '/' ) ) {
-			throw new MalformedRouteException;
-		}
-
-		$this->route    = $route;
-		$this->method   = $method;
-		$this->callback = $callback;
-	}
-
-	/**
-	 * Generates the endpoint's route.
-	 *
-	 * Combines the prefix with the route to generate the full route string.
-	 *
-	 * @return string
-	 */
-	public function get_route() {
-		return ( $this->prefix ?: '' ) . $this->route;
-	}
-
-	/**
-	 * Generates the endpoint's WP-API options array.
-	 *
-	 * @return array
-	 */
-	public function get_options() {
-		$options = array(
-			'methods'  => $this->method,
-			'callback' => $this->callback,
-		);
-
-		if ( $this->guard ) {
-			$options['permission_callback'] = array( $this->guard, 'authorized' );
-		}
-
-		if ( $this->filter ) {
-			$options['args'] = $this->filter->rules();
-		}
-
-		return $options;
-	}
-
-	/**
-	 * Sets the endpoint's permission guard.
-	 *
-	 * @param GuardContract $guard
-	 *
-	 * @return $this
-	 */
-	public function set_guard( GuardContract $guard ) {
-		$this->guard = $guard;
-
-		return $this;
-	}
-
-	/**
-	 * Sets the endpoint's arguments filter.
-	 *
-	 * @param FilterContract $filter
-	 *
-	 * @return $this
-	 */
-	public function set_filter( FilterContract $filter ) {
-		$this->filter = $filter;
-
-		return $this;
-	}
-
-	/**
-	 * Sets the endpoint's prefix.
-	 *
-	 * @param string $prefix
-	 *
-	 * @return $this
-	 * @throws MalformedRouteException
-	 */
-	public function set_prefix( $prefix ) {
-		if ( ! Str::starts_with( $prefix, '/' ) || Str::ends_with( $prefix, '/' ) ) {
-			throw new MalformedRouteException;
-		}
-
-		$this->prefix = $prefix;
-
-		return $this;
-	}
+    /**
+     * Endpoint's route.
+     *
+     * @var string
+     */
+    protected $route;
+
+    /**
+     * Endpoint's HTTP verb(s).
+     *
+     * @var string
+     */
+    protected $method;
+
+    /**
+     * Endpoint's callback.
+     *
+     * @var callable
+     */
+    protected $callback;
+
+    /**
+     * Endpoint's permission guard.
+     *
+     * @var GuardContract
+     */
+    protected $guard;
+
+    /**
+     * Endpoint's arguments filter.
+     *
+     * @var FilterContract
+     */
+    protected $filter;
+
+    /**
+     * Endpoint's route prefix.
+     *
+     * @var string
+     */
+    protected $prefix;
+
+    /**
+     * Instantiate a new endpoint with a provided route, method, and callback.
+     *
+     * @param string   $route
+     * @param string   $method
+     * @param callable $callback
+     *
+     * @throws MalformedRouteException
+     */
+    public function __construct( $route, $method, $callback ) {
+        if ( ! Str::starts_with( $route, '/' ) || Str::ends_with( $route, '/' ) ) {
+            throw new MalformedRouteException;
+        }
+
+        $this->route    = $route;
+        $this->method   = $method;
+        $this->callback = $callback;
+    }
+
+    /**
+     * Generates the endpoint's route.
+     *
+     * Combines the prefix with the route to generate the full route string.
+     *
+     * @return string
+     */
+    public function get_route() {
+        return ( $this->prefix ?: '' ) . $this->route;
+    }
+
+    /**
+     * Generates the endpoint's WP-API options array.
+     *
+     * @return array
+     */
+    public function get_options() {
+        $options = array(
+            'methods'  => $this->method,
+            'callback' => $this->callback,
+        );
+
+        if ( $this->guard ) {
+            $options['permission_callback'] = array( $this->guard, 'authorized' );
+        }
+
+        if ( $this->filter ) {
+            $options['args'] = $this->filter->rules();
+        }
+
+        return $options;
+    }
+
+    /**
+     * Sets the endpoint's permission guard.
+     *
+     * @param GuardContract $guard
+     *
+     * @return $this
+     */
+    public function set_guard( GuardContract $guard ) {
+        $this->guard = $guard;
+
+        return $this;
+    }
+
+    /**
+     * Sets the endpoint's arguments filter.
+     *
+     * @param FilterContract $filter
+     *
+     * @return $this
+     */
+    public function set_filter( FilterContract $filter ) {
+        $this->filter = $filter;
+
+        return $this;
+    }
+
+    /**
+     * Sets the endpoint's prefix.
+     *
+     * @param string $prefix
+     *
+     * @return $this
+     * @throws MalformedRouteException
+     */
+    public function set_prefix( $prefix ) {
+        if ( ! Str::starts_with( $prefix, '/' ) || Str::ends_with( $prefix, '/' ) ) {
+            throw new MalformedRouteException;
+        }
+
+        $this->prefix = $prefix;
+
+        return $this;
+    }
 }

src/Axolotl/Model.php

Doc Comments +1 added lines, -1 removed lines

@@ -825,7 +825,7 @@
 	 * @param string $type
 	 * @param string $local_key
 	 *
-	 * @return HasMany
+	 * @return BelongsToOne
 	 */
 	protected function belongs_to_one( $class, $type, $local_key = '' ) {
 		return new BelongsToOne( $this, $class, $type, $local_key );

Indentation +841 added lines, -841 removed lines

@@ -23,845 +23,845 @@
  * @since      0.1.0
  */
 abstract class Model implements Serializes {
-	/**
-	 * Memoized values for class methods.
-	 *
-	 * @var array
-	 */
-	private static $memo = array();
-
-	/**
-	 * Model attributes.
-	 *
-	 * @var array
-	 */
-	private $attributes = array(
-		'table'  => array(),
-		'object' => null,
-	);
-
-	/**
-	 * Model's original attributes.
-	 *
-	 * @var array
-	 */
-	private $original = array(
-		'table'  => array(),
-		'object' => null,
-	);
-
-	/**
-	 * Properties which are allowed to be set on the model.
-	 *
-	 * If this array is empty, any attributes can be set on the model.
-	 *
-	 * @var string[]
-	 */
-	protected $fillable = array();
-
-	/**
-	 * Properties which cannot be automatically filled on the model.
-	 *
-	 * If the model is unguarded, these properties can be filled.
-	 *
-	 * @var array
-	 */
-	protected $guarded = array();
-
-	/**
-	 * Properties which should not be serialized.
-	 *
-	 * @var array
-	 */
-	protected $hidden = array();
-
-	/**
-	 * Properties which should be serialized.
-	 *
-	 * @var array
-	 */
-	protected $visible = array();
-
-	/**
-	 * Relations saved on the Model.
-	 *
-	 * @var array
-	 */
-	protected $related = array();
-
-	/**
-	 * Whether the model's properties are guarded.
-	 *
-	 * When false, allows guarded properties to be filled.
-	 *
-	 * @var bool
-	 */
-	protected $is_guarded = true;
-
-	/**
-	 * Whether the Model is having its relations filled.
-	 *
-	 * @var bool
-	 */
-	protected $filling = false;
-
-	/**
-	 * Constructs a new model with provided attributes.
-	 *
-	 * If 'object' is passed as one of the attributes, the underlying post
-	 * will be overwritten.
-	 *
-	 * @param array <string, mixed> $attributes
-	 */
-	public function __construct( array $attributes = array() ) {
-		$this->maybe_boot();
-		$this->sync_original();
-
-		if ( $this->uses_wp_object() ) {
-			$this->create_wp_object();
-		}
-
-		$this->refresh( $attributes );
-	}
-
-	/**
-	 * Refreshes the model's current attributes with the provided array.
-	 *
-	 * The model's attributes will match what was provided in the array,
-	 * and any attributes not passed
-	 *
-	 * @param array $attributes
-	 *
-	 * @return $this
-	 */
-	public function refresh( array $attributes ) {
-		$this->clear();
-
-		return $this->merge( $attributes );
-	}
-
-	/**
-	 * Merges the provided attributes with the provided array.
-	 *
-	 * @param array $attributes
-	 *
-	 * @return $this
-	 */
-	public function merge( array $attributes ) {
-		foreach ( $attributes as $name => $value ) {
-			$this->set_attribute( $name, $value );
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Get the model's table attributes.
-	 *
-	 * Returns the array of for the model that will either need to be
-	 * saved in postmeta or a separate table.
-	 *
-	 * @return array
-	 */
-	public function get_table_attributes() {
-		return $this->attributes['table'];
-	}
-
-	/**
-	 * Get the model's original attributes.
-	 *
-	 * @return array
-	 */
-	public function get_original_table_attributes() {
-		return $this->original['table'];
-	}
-
-	/**
-	 * Retrieve an array of the attributes on the model
-	 * that have changed compared to the model's
-	 * original data.
-	 *
-	 * @return array
-	 */
-	public function get_changed_table_attributes() {
-		$changed = array();
-
-		foreach ( $this->get_table_attributes() as $attribute ) {
-			if ( $this->get_attribute( $attribute ) !==
-			     $this->get_original_attribute( $attribute )
-			) {
-				$changed[ $attribute ] = $this->get_attribute( $attribute );
-			}
-		}
-
-		return $changed;
-	}
-
-	/**
-	 * Get the model's underlying post.
-	 *
-	 * Returns the underlying WP_Post object for the model, representing
-	 * the data that will be save in the wp_posts table.
-	 *
-	 * @return false|WP_Post|WP_Term
-	 */
-	public function get_underlying_wp_object() {
-		if ( isset( $this->attributes['object'] ) ) {
-			return $this->attributes['object'];
-		}
-
-		return false;
-	}
-
-	/**
-	 * Get the model's original underlying post.
-	 *
-	 * @return WP_Post
-	 */
-	public function get_original_underlying_wp_object() {
-		return $this->original['object'];
-	}
-
-	/**
-	 * Get the model attributes on the WordPress object
-	 * that have changed compared to the model's
-	 * original attributes.
-	 *
-	 * @return array
-	 */
-	public function get_changed_wp_object_attributes() {
-		$changed = array();
-
-		foreach ( $this->get_wp_object_keys() as $key ) {
-			if ( $this->get_attribute( $key ) !==
-			     $this->get_original_attribute( $key )
-			) {
-				$changed[ $key ] = $this->get_attribute( $key );
-			}
-		}
-
-		return $changed;
-	}
-
-	/**
-	 * Magic __set method.
-	 *
-	 * Passes the name and value to set_attribute, which is where the magic happens.
-	 *
-	 * @param string $name
-	 * @param mixed  $value
-	 */
-	public function __set( $name, $value ) {
-		$this->set_attribute( $name, $value );
-	}
-
-	/**
-	 * Sets the model attributes.
-	 *
-	 * Checks whether the model attribute can be set, check if it
-	 * maps to the WP_Post property, otherwise, assigns it to the
-	 * table attribute array.
-	 *
-	 * @param string $name
-	 * @param mixed  $value
-	 *
-	 * @return $this
-	 *
-	 * @throws GuardedPropertyException
-	 */
-	public function set_attribute( $name, $value ) {
-		if ( 'object' === $name ) {
-			return $this->override_wp_object( $value );
-		}
-
-		if ( ! $this->is_fillable( $name ) ) {
-			throw new GuardedPropertyException;
-		}
-
-		if ( $method = $this->has_map_method( $name ) ) {
-			$this->attributes['object']->{$this->{$method}()} = $value;
-		} else {
-			$this->attributes['table'][ $name ] = $value;
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Retrieves all the attribute keys for the model.
-	 *
-	 * @return array
-	 */
-	public function get_attribute_keys() {
-		if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
-			return self::$memo[ get_called_class() ][ __METHOD__ ];
-		}
-
-		return self::$memo[ get_called_class() ][ __METHOD__ ]
-			= array_merge(
-				$this->fillable,
-				$this->guarded,
-				$this->get_compute_methods(),
-				$this->get_related_methods()
-			);
-	}
-
-	/**
-	 * Retrieves the attribute keys that aren't mapped to a post.
-	 *
-	 * @return array
-	 */
-	public function get_table_keys() {
-		if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
-			return self::$memo[ get_called_class() ][ __METHOD__ ];
-		}
-
-		$keys = array();
-
-		foreach ( $this->get_attribute_keys() as $key ) {
-			if ( ! $this->has_map_method( $key ) &&
-			     ! $this->has_compute_method( $key ) &&
-			     ! $this->has_related_method( $key )
-			) {
-				$keys[] = $key;
-			}
-		}
-
-		return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
-	}
-
-	/**
-	 * Retrieves the attribute keys that are mapped to a post.
-	 *
-	 * @return array
-	 */
-	public function get_wp_object_keys() {
-		if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
-			return self::$memo[ get_called_class() ][ __METHOD__ ];
-		}
-
-		$keys = array();
-
-		foreach ( $this->get_attribute_keys() as $key ) {
-			if ( $this->has_map_method( $key ) ) {
-				$keys[] = $key;
-			}
-		}
-
-		return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
-	}
-
-	/**
-	 * Returns the model's keys that are computed at call time.
-	 *
-	 * @return array
-	 */
-	public function get_computed_keys() {
-		if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
-			return self::$memo[ get_called_class() ][ __METHOD__ ];
-		}
-
-		$keys = array();
-
-		foreach ( $this->get_attribute_keys() as $key ) {
-			if ( $this->has_compute_method( $key ) ) {
-				$keys[] = $key;
-			}
-		}
-
-		return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
-	}
-
-	/**
-	 * Returns the model's keys that are related to other Models.
-	 *
-	 * @return array
-	 */
-	public function get_related_keys() {
-		if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
-			return self::$memo[ get_called_class() ][ __METHOD__ ];
-		}
-
-		$keys = array();
-
-		foreach ( $this->get_attribute_keys() as $key ) {
-			if ( $this->has_related_method( $key ) ) {
-				$keys[] = $key;
-			}
-		}
-
-		return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
-	}
-
-	/**
-	 * Serializes the model's public data into an array.
-	 *
-	 * @return array
-	 */
-	public function serialize() {
-		$attributes = array();
-
-		if ( $this->visible ) {
-			// If visible attributes are set, we'll only reveal those.
-			foreach ( $this->visible as $key ) {
-				$attributes[ $key ] = $this->get_attribute( $key );
-			}
-		} elseif ( $this->hidden ) {
-			// If hidden attributes are set, we'll grab everything and hide those.
-			foreach ( $this->get_attribute_keys() as $key ) {
-				if ( ! in_array( $key, $this->hidden ) ) {
-					$attributes[ $key ] = $this->get_attribute( $key );
-				}
-			}
-		} else {
-			// If nothing is hidden/visible, we'll grab and reveal everything.
-			foreach ( $this->get_attribute_keys() as $key ) {
-				$attributes[ $key ] = $this->get_attribute( $key );
-			}
-		}
-
-		return array_map( function ( $attribute ) {
-			if ( $attribute instanceof Serializes ) {
-				return $attribute->serialize();
-			}
-
-			return $attribute;
-		}, $attributes );
-	}
-
-	/**
-	 * Syncs the current attributes to the model's original.
-	 *
-	 * @return $this
-	 */
-	public function sync_original() {
-		$this->original = $this->attributes;
-
-		if ( $this->attributes['object'] ) {
-			$this->original['object'] = clone $this->attributes['object'];
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Checks if a given attribute is mass-fillable.
-	 *
-	 * Returns true if the attribute can be filled, false if it can't.
-	 *
-	 * @param string $name
-	 *
-	 * @return bool
-	 */
-	private function is_fillable( $name ) {
-		// If this model isn't guarded, everything is fillable.
-		if ( ! $this->is_guarded ) {
-			return true;
-		}
-
-		// If it's in the fillable array, then it's fillable.
-		if ( in_array( $name, $this->fillable ) ) {
-			return true;
-		}
-
-		// If it's explicitly guarded, then it's not fillable.
-		if ( in_array( $name, $this->guarded ) ) {
-			return false;
-		}
-
-		// If fillable hasn't been defined, then everything else fillable.
-		return ! $this->fillable;
-	}
-
-	/**
-	 * Overrides the current WP_Post with a provided one.
-	 *
-	 * Resets the post's default values and stores it in the attributes.
-	 *
-	 * @param WP_Post $value
-	 *
-	 * @return $this
-	 */
-	private function override_wp_object( $value ) {
-		$this->attributes['object'] = $this->set_wp_object_constants( $value );
-
-		return $this;
-	}
-
-	/**
-	 * Create and set with a new blank post.
-	 *
-	 * Creates a new WP_Post object, assigns it the default attributes,
-	 * and stores it in the attributes.
-	 *
-	 * @throws LogicException
-	 */
-	private function create_wp_object() {
-		switch ( true ) {
-			case $this instanceof UsesWordPressPost:
-				$object = new WP_Post( (object) array() );
-				break;
-			case $this instanceof UsesWordPressTerm:
-				$object = new WP_Term( (object) array() );
-				break;
-			default:
-				throw new LogicException;
-				break;
-		}
-
-		$this->attributes['object'] = $this->set_wp_object_constants( $object );
-	}
-
-	/**
-	 * Enforces values on the post that can't change.
-	 *
-	 * Primarily, this is used to make sure the post_type always maps
-	 * to the model's "$type" property, but this can all be overridden
-	 * by the developer to enforce other values in the model.
-	 *
-	 * @param object $object
-	 *
-	 * @return object
-	 */
-	protected function set_wp_object_constants( $object ) {
-		if ( $this instanceof UsesWordPressPost ) {
-			$object->post_type = $this::get_post_type();
-		}
-
-		if ( $this instanceof UsesWordPressTerm ) {
-			$object->taxonomy = $this::get_taxonomy();
-		}
-
-		return $object;
-	}
-
-	/**
-	 * Magic __get method.
-	 *
-	 * Passes the name and value to get_attribute, which is where the magic happens.
-	 *
-	 * @param string $name
-	 *
-	 * @return mixed
-	 */
-	public function __get( $name ) {
-		return $this->get_attribute( $name );
-	}
-
-	/**
-	 * Retrieves the model attribute.
-	 *
-	 * @param string $name
-	 *
-	 * @return mixed
-	 *
-	 * @throws PropertyDoesNotExistException If property isn't found.
-	 */
-	public function get_attribute( $name ) {
-		if ( $method = $this->has_map_method( $name ) ) {
-			$value = $this->attributes['object']->{$this->{$method}()};
-		} elseif ( $method = $this->has_compute_method( $name ) ) {
-			$value = $this->{$method}();
-		} else if ( $method = $this->has_related_method( $name ) ) {
-			$value = $this->get_related( $this->{$method}()->get_sha() );
-		} else {
-			if ( ! isset( $this->attributes['table'][ $name ] ) ) {
-				throw new PropertyDoesNotExistException;
-			}
-
-			$value = $this->attributes['table'][ $name ];
-		}
-
-		return $value;
-	}
-
-	/**
-	 * Retrieve the model's original attribute value.
-	 *
-	 * @param string $name
-	 *
-	 * @return mixed
-	 *
-	 * @throws PropertyDoesNotExistException If property isn't found.
-	 */
-	public function get_original_attribute( $name ) {
-		$original = new static( $this->original );
-
-		return $original->get_attribute( $name );
-	}
-
-	/**
-	 * Fetches the Model's primary ID, depending on the model
-	 * implementation.
-	 *
-	 * @return int
-	 *
-	 * @throws LogicException
-	 */
-	public function get_primary_id() {
-		if ( $this instanceof UsesWordPressPost ) {
-			return $this->get_underlying_wp_object()->ID;
-		}
-
-		if ( $this instanceof UsesWordPressTerm ) {
-			return $this->get_underlying_wp_object()->term_id;
-		}
-
-		// Model w/o wp_object not yet supported.
-		throw new LogicException;
-	}
-
-	/**
-	 * Generates the table foreign key, depending on the model
-	 * implementation.
-	 *
-	 * @return string
-	 *
-	 * @throws LogicException
-	 */
-	public function get_foreign_key() {
-		if ( $this instanceof UsesWordPressPost ) {
-			return 'post_id';
-		}
-
-		// Model w/o wp_object not yet supported.
-		throw new LogicException;
-	}
-
-	/**
-	 * Gets the related Model or Collection for the given sha.
-	 *
-	 * @param string $sha
-	 *
-	 * @return Model|Collection
-	 */
-	public function get_related( $sha ) {
-		return $this->related[ $sha ];
-	}
-
-	/**
-	 * Sets the related Model or Collection for the given sha.
-	 *
-	 * @param string           $sha
-	 * @param Model|Collection $target
-	 *
-	 * @throws RuntimeException
-	 */
-	public function set_related( $sha, $target ) {
-		if ( ! ( $target instanceof Model ) && ! ( $target instanceof Collection ) ) {
-			throw new RuntimeException;
-		}
-
-		$this->related[ $sha ] = $target;
-	}
-
-	/**
-	 * Checks whether the attribute has a map method.
-	 *
-	 * This is used to determine whether the attribute maps to a
-	 * property on the underlying WP_Post object. Returns the
-	 * method if one exists, returns false if it doesn't.
-	 *
-	 * @param string $name
-	 *
-	 * @return false|string
-	 */
-	protected function has_map_method( $name ) {
-		if ( method_exists( $this, $method = "map_{$name}" ) ) {
-			return $method;
-		}
-
-		return false;
-	}
-
-	/**
-	 * Checks whether the attribute has a compute method.
-	 *
-	 * This is used to determine if the attribute should be computed
-	 * from other attributes.
-	 *
-	 * @param string $name
-	 *
-	 * @return false|string
-	 */
-	protected function has_compute_method( $name ) {
-		if ( method_exists( $this, $method = "compute_{$name}" ) ) {
-			return $method;
-		}
-
-		return false;
-	}
-
-	/**
-	 * Checks whether the attribute has a compute method.
-	 *
-	 * This is used to determine if the attribute should be computed
-	 * from other attributes.
-	 *
-	 * @param string $name
-	 *
-	 * @return false|string
-	 */
-	protected function has_related_method( $name ) {
-		if ( method_exists( $this, $method = "related_{$name}" ) ) {
-			return $method;
-		}
-
-		return false;
-	}
-
-	/**
-	 * Clears all the current attributes from the model.
-	 *
-	 * This does not touch the model's original attributes, and will
-	 * only clear fillable attributes, unless the model is unguarded.
-	 *
-	 * @return $this
-	 */
-	public function clear() {
-		$keys = $this->get_attribute_keys();
-
-		foreach ( $keys as $key ) {
-			try {
-				$this->set_attribute( $key, null );
-			} catch ( GuardedPropertyException $e ) {
-				// We won't clear out guarded attributes.
-			}
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Unguards the model.
-	 *
-	 * Sets the model to be unguarded, allowing the filling of
-	 * guarded attributes.
-	 */
-	public function unguard() {
-		$this->is_guarded = false;
-	}
-
-	/**
-	 * Reguards the model.
-	 *
-	 * Sets the model to be guarded, preventing filling of
-	 * guarded attributes.
-	 */
-	public function reguard() {
-		$this->is_guarded = true;
-	}
-
-	/**
-	 * Retrieves all the compute methods on the model.
-	 *
-	 * @return array
-	 */
-	protected function get_compute_methods() {
-		$methods = get_class_methods( get_called_class() );
-		$methods = array_filter( $methods, function ( $method ) {
-			return strrpos( $method, 'compute_', - strlen( $method ) ) !== false;
-		} );
-		$methods = array_map( function ( $method ) {
-			return substr( $method, strlen( 'compute_' ) );
-		}, $methods );
-
-		return $methods;
-	}
-
-	/**
-	 * Retrieves all the related methods on the model.
-	 *
-	 * @return array
-	 */
-	protected function get_related_methods() {
-		$methods = get_class_methods( get_called_class() );
-		$methods = array_filter( $methods, function ( $method ) {
-			return strrpos( $method, 'related_', - strlen( $method ) ) !== false;
-		} );
-		$methods = array_map( function ( $method ) {
-			return substr( $method, strlen( 'related_' ) );
-		}, $methods );
-
-		return $methods;
-	}
-
-	/**
-	 * Returns whether this relation has already been filled on the model.
-	 *
-	 * @param string $relation
-	 *
-	 * @return bool
-	 */
-	public function relation_is_filled( $relation ) {
-		$sha = $this
-			->{$this->has_related_method( $relation )}()
-			->get_sha();
-
-		return isset( $this->related[ $sha ] );
-	}
-
-	/**
-	 * Returns whether the Model is currently having
-	 * its relationships filled.
-	 *
-	 * @return bool
-	 */
-	public function is_filling() {
-		return $this->filling;
-	}
-
-	/**
-	 * Sets whether the Model is having its relationships filled.
-	 *
-	 * @param bool $is_filling
-	 */
-	public function set_filling( $is_filling ) {
-		$this->filling = $is_filling;
-	}
-
-	/**
-	 * Returns a HasMany relationship for the model.
-	 *
-	 * @param string $class
-	 * @param string $type
-	 * @param string $foreign_key
-	 *
-	 * @return HasMany
-	 */
-	protected function has_many( $class, $type, $foreign_key ) {
-		return new HasMany( $this, $class, $type, $foreign_key );
-	}
-
-	/**
-	 * Returns a BelongsToOne relationship for the model.
-	 *
-	 * @param string $class
-	 * @param string $type
-	 * @param string $local_key
-	 *
-	 * @return HasMany
-	 */
-	protected function belongs_to_one( $class, $type, $local_key = '' ) {
-		return new BelongsToOne( $this, $class, $type, $local_key );
-	}
-
-	/**
-	 * Sets up the memo array for the creating model.
-	 */
-	private function maybe_boot() {
-		if ( ! isset( self::$memo[ get_called_class() ] ) ) {
-			self::$memo[ get_called_class() ] = array();
-		}
-	}
-
-	/**
-	 * Whether this Model uses an underlying WordPress object.
-	 *
-	 * @return bool
-	 */
-	protected function uses_wp_object() {
-		return $this instanceof UsesWordPressPost ||
-			$this instanceof UsesWordPressTerm;
-	}
+    /**
+     * Memoized values for class methods.
+     *
+     * @var array
+     */
+    private static $memo = array();
+
+    /**
+     * Model attributes.
+     *
+     * @var array
+     */
+    private $attributes = array(
+        'table'  => array(),
+        'object' => null,
+    );
+
+    /**
+     * Model's original attributes.
+     *
+     * @var array
+     */
+    private $original = array(
+        'table'  => array(),
+        'object' => null,
+    );
+
+    /**
+     * Properties which are allowed to be set on the model.
+     *
+     * If this array is empty, any attributes can be set on the model.
+     *
+     * @var string[]
+     */
+    protected $fillable = array();
+
+    /**
+     * Properties which cannot be automatically filled on the model.
+     *
+     * If the model is unguarded, these properties can be filled.
+     *
+     * @var array
+     */
+    protected $guarded = array();
+
+    /**
+     * Properties which should not be serialized.
+     *
+     * @var array
+     */
+    protected $hidden = array();
+
+    /**
+     * Properties which should be serialized.
+     *
+     * @var array
+     */
+    protected $visible = array();
+
+    /**
+     * Relations saved on the Model.
+     *
+     * @var array
+     */
+    protected $related = array();
+
+    /**
+     * Whether the model's properties are guarded.
+     *
+     * When false, allows guarded properties to be filled.
+     *
+     * @var bool
+     */
+    protected $is_guarded = true;
+
+    /**
+     * Whether the Model is having its relations filled.
+     *
+     * @var bool
+     */
+    protected $filling = false;
+
+    /**
+     * Constructs a new model with provided attributes.
+     *
+     * If 'object' is passed as one of the attributes, the underlying post
+     * will be overwritten.
+     *
+     * @param array <string, mixed> $attributes
+     */
+    public function __construct( array $attributes = array() ) {
+        $this->maybe_boot();
+        $this->sync_original();
+
+        if ( $this->uses_wp_object() ) {
+            $this->create_wp_object();
+        }
+
+        $this->refresh( $attributes );
+    }
+
+    /**
+     * Refreshes the model's current attributes with the provided array.
+     *
+     * The model's attributes will match what was provided in the array,
+     * and any attributes not passed
+     *
+     * @param array $attributes
+     *
+     * @return $this
+     */
+    public function refresh( array $attributes ) {
+        $this->clear();
+
+        return $this->merge( $attributes );
+    }
+
+    /**
+     * Merges the provided attributes with the provided array.
+     *
+     * @param array $attributes
+     *
+     * @return $this
+     */
+    public function merge( array $attributes ) {
+        foreach ( $attributes as $name => $value ) {
+            $this->set_attribute( $name, $value );
+        }
+
+        return $this;
+    }
+
+    /**
+     * Get the model's table attributes.
+     *
+     * Returns the array of for the model that will either need to be
+     * saved in postmeta or a separate table.
+     *
+     * @return array
+     */
+    public function get_table_attributes() {
+        return $this->attributes['table'];
+    }
+
+    /**
+     * Get the model's original attributes.
+     *
+     * @return array
+     */
+    public function get_original_table_attributes() {
+        return $this->original['table'];
+    }
+
+    /**
+     * Retrieve an array of the attributes on the model
+     * that have changed compared to the model's
+     * original data.
+     *
+     * @return array
+     */
+    public function get_changed_table_attributes() {
+        $changed = array();
+
+        foreach ( $this->get_table_attributes() as $attribute ) {
+            if ( $this->get_attribute( $attribute ) !==
+                    $this->get_original_attribute( $attribute )
+            ) {
+                $changed[ $attribute ] = $this->get_attribute( $attribute );
+            }
+        }
+
+        return $changed;
+    }
+
+    /**
+     * Get the model's underlying post.
+     *
+     * Returns the underlying WP_Post object for the model, representing
+     * the data that will be save in the wp_posts table.
+     *
+     * @return false|WP_Post|WP_Term
+     */
+    public function get_underlying_wp_object() {
+        if ( isset( $this->attributes['object'] ) ) {
+            return $this->attributes['object'];
+        }
+
+        return false;
+    }
+
+    /**
+     * Get the model's original underlying post.
+     *
+     * @return WP_Post
+     */
+    public function get_original_underlying_wp_object() {
+        return $this->original['object'];
+    }
+
+    /**
+     * Get the model attributes on the WordPress object
+     * that have changed compared to the model's
+     * original attributes.
+     *
+     * @return array
+     */
+    public function get_changed_wp_object_attributes() {
+        $changed = array();
+
+        foreach ( $this->get_wp_object_keys() as $key ) {
+            if ( $this->get_attribute( $key ) !==
+                    $this->get_original_attribute( $key )
+            ) {
+                $changed[ $key ] = $this->get_attribute( $key );
+            }
+        }
+
+        return $changed;
+    }
+
+    /**
+     * Magic __set method.
+     *
+     * Passes the name and value to set_attribute, which is where the magic happens.
+     *
+     * @param string $name
+     * @param mixed  $value
+     */
+    public function __set( $name, $value ) {
+        $this->set_attribute( $name, $value );
+    }
+
+    /**
+     * Sets the model attributes.
+     *
+     * Checks whether the model attribute can be set, check if it
+     * maps to the WP_Post property, otherwise, assigns it to the
+     * table attribute array.
+     *
+     * @param string $name
+     * @param mixed  $value
+     *
+     * @return $this
+     *
+     * @throws GuardedPropertyException
+     */
+    public function set_attribute( $name, $value ) {
+        if ( 'object' === $name ) {
+            return $this->override_wp_object( $value );
+        }
+
+        if ( ! $this->is_fillable( $name ) ) {
+            throw new GuardedPropertyException;
+        }
+
+        if ( $method = $this->has_map_method( $name ) ) {
+            $this->attributes['object']->{$this->{$method}()} = $value;
+        } else {
+            $this->attributes['table'][ $name ] = $value;
+        }
+
+        return $this;
+    }
+
+    /**
+     * Retrieves all the attribute keys for the model.
+     *
+     * @return array
+     */
+    public function get_attribute_keys() {
+        if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
+            return self::$memo[ get_called_class() ][ __METHOD__ ];
+        }
+
+        return self::$memo[ get_called_class() ][ __METHOD__ ]
+            = array_merge(
+                $this->fillable,
+                $this->guarded,
+                $this->get_compute_methods(),
+                $this->get_related_methods()
+            );
+    }
+
+    /**
+     * Retrieves the attribute keys that aren't mapped to a post.
+     *
+     * @return array
+     */
+    public function get_table_keys() {
+        if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
+            return self::$memo[ get_called_class() ][ __METHOD__ ];
+        }
+
+        $keys = array();
+
+        foreach ( $this->get_attribute_keys() as $key ) {
+            if ( ! $this->has_map_method( $key ) &&
+                 ! $this->has_compute_method( $key ) &&
+                 ! $this->has_related_method( $key )
+            ) {
+                $keys[] = $key;
+            }
+        }
+
+        return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
+    }
+
+    /**
+     * Retrieves the attribute keys that are mapped to a post.
+     *
+     * @return array
+     */
+    public function get_wp_object_keys() {
+        if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
+            return self::$memo[ get_called_class() ][ __METHOD__ ];
+        }
+
+        $keys = array();
+
+        foreach ( $this->get_attribute_keys() as $key ) {
+            if ( $this->has_map_method( $key ) ) {
+                $keys[] = $key;
+            }
+        }
+
+        return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
+    }
+
+    /**
+     * Returns the model's keys that are computed at call time.
+     *
+     * @return array
+     */
+    public function get_computed_keys() {
+        if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
+            return self::$memo[ get_called_class() ][ __METHOD__ ];
+        }
+
+        $keys = array();
+
+        foreach ( $this->get_attribute_keys() as $key ) {
+            if ( $this->has_compute_method( $key ) ) {
+                $keys[] = $key;
+            }
+        }
+
+        return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
+    }
+
+    /**
+     * Returns the model's keys that are related to other Models.
+     *
+     * @return array
+     */
+    public function get_related_keys() {
+        if ( isset( self::$memo[ get_called_class() ][ __METHOD__ ] ) ) {
+            return self::$memo[ get_called_class() ][ __METHOD__ ];
+        }
+
+        $keys = array();
+
+        foreach ( $this->get_attribute_keys() as $key ) {
+            if ( $this->has_related_method( $key ) ) {
+                $keys[] = $key;
+            }
+        }
+
+        return self::$memo[ get_called_class() ][ __METHOD__ ] = $keys;
+    }
+
+    /**
+     * Serializes the model's public data into an array.
+     *
+     * @return array
+     */
+    public function serialize() {
+        $attributes = array();
+
+        if ( $this->visible ) {
+            // If visible attributes are set, we'll only reveal those.
+            foreach ( $this->visible as $key ) {
+                $attributes[ $key ] = $this->get_attribute( $key );
+            }
+        } elseif ( $this->hidden ) {
+            // If hidden attributes are set, we'll grab everything and hide those.
+            foreach ( $this->get_attribute_keys() as $key ) {
+                if ( ! in_array( $key, $this->hidden ) ) {
+                    $attributes[ $key ] = $this->get_attribute( $key );
+                }
+            }
+        } else {
+            // If nothing is hidden/visible, we'll grab and reveal everything.
+            foreach ( $this->get_attribute_keys() as $key ) {
+                $attributes[ $key ] = $this->get_attribute( $key );
+            }
+        }
+
+        return array_map( function ( $attribute ) {
+            if ( $attribute instanceof Serializes ) {
+                return $attribute->serialize();
+            }
+
+            return $attribute;
+        }, $attributes );
+    }
+
+    /**
+     * Syncs the current attributes to the model's original.
+     *
+     * @return $this
+     */
+    public function sync_original() {
+        $this->original = $this->attributes;
+
+        if ( $this->attributes['object'] ) {
+            $this->original['object'] = clone $this->attributes['object'];
+        }
+
+        return $this;
+    }
+
+    /**
+     * Checks if a given attribute is mass-fillable.
+     *
+     * Returns true if the attribute can be filled, false if it can't.
+     *
+     * @param string $name
+     *
+     * @return bool
+     */
+    private function is_fillable( $name ) {
+        // If this model isn't guarded, everything is fillable.
+        if ( ! $this->is_guarded ) {
+            return true;
+        }
+
+        // If it's in the fillable array, then it's fillable.
+        if ( in_array( $name, $this->fillable ) ) {
+            return true;
+        }
+
+        // If it's explicitly guarded, then it's not fillable.
+        if ( in_array( $name, $this->guarded ) ) {
+            return false;
+        }
+
+        // If fillable hasn't been defined, then everything else fillable.
+        return ! $this->fillable;
+    }
+
+    /**
+     * Overrides the current WP_Post with a provided one.
+     *
+     * Resets the post's default values and stores it in the attributes.
+     *
+     * @param WP_Post $value
+     *
+     * @return $this
+     */
+    private function override_wp_object( $value ) {
+        $this->attributes['object'] = $this->set_wp_object_constants( $value );
+
+        return $this;
+    }
+
+    /**
+     * Create and set with a new blank post.
+     *
+     * Creates a new WP_Post object, assigns it the default attributes,
+     * and stores it in the attributes.
+     *
+     * @throws LogicException
+     */
+    private function create_wp_object() {
+        switch ( true ) {
+            case $this instanceof UsesWordPressPost:
+                $object = new WP_Post( (object) array() );
+                break;
+            case $this instanceof UsesWordPressTerm:
+                $object = new WP_Term( (object) array() );
+                break;
+            default:
+                throw new LogicException;
+                break;
+        }
+
+        $this->attributes['object'] = $this->set_wp_object_constants( $object );
+    }
+
+    /**
+     * Enforces values on the post that can't change.
+     *
+     * Primarily, this is used to make sure the post_type always maps
+     * to the model's "$type" property, but this can all be overridden
+     * by the developer to enforce other values in the model.
+     *
+     * @param object $object
+     *
+     * @return object
+     */
+    protected function set_wp_object_constants( $object ) {
+        if ( $this instanceof UsesWordPressPost ) {
+            $object->post_type = $this::get_post_type();
+        }
+
+        if ( $this instanceof UsesWordPressTerm ) {
+            $object->taxonomy = $this::get_taxonomy();
+        }
+
+        return $object;
+    }
+
+    /**
+     * Magic __get method.
+     *
+     * Passes the name and value to get_attribute, which is where the magic happens.
+     *
+     * @param string $name
+     *
+     * @return mixed
+     */
+    public function __get( $name ) {
+        return $this->get_attribute( $name );
+    }
+
+    /**
+     * Retrieves the model attribute.
+     *
+     * @param string $name
+     *
+     * @return mixed
+     *
+     * @throws PropertyDoesNotExistException If property isn't found.
+     */
+    public function get_attribute( $name ) {
+        if ( $method = $this->has_map_method( $name ) ) {
+            $value = $this->attributes['object']->{$this->{$method}()};
+        } elseif ( $method = $this->has_compute_method( $name ) ) {
+            $value = $this->{$method}();
+        } else if ( $method = $this->has_related_method( $name ) ) {
+            $value = $this->get_related( $this->{$method}()->get_sha() );
+        } else {
+            if ( ! isset( $this->attributes['table'][ $name ] ) ) {
+                throw new PropertyDoesNotExistException;
+            }
+
+            $value = $this->attributes['table'][ $name ];
+        }
+
+        return $value;
+    }
+
+    /**
+     * Retrieve the model's original attribute value.
+     *
+     * @param string $name
+     *
+     * @return mixed
+     *
+     * @throws PropertyDoesNotExistException If property isn't found.
+     */
+    public function get_original_attribute( $name ) {
+        $original = new static( $this->original );
+
+        return $original->get_attribute( $name );
+    }
+
+    /**
+     * Fetches the Model's primary ID, depending on the model
+     * implementation.
+     *
+     * @return int
+     *
+     * @throws LogicException
+     */
+    public function get_primary_id() {
+        if ( $this instanceof UsesWordPressPost ) {
+            return $this->get_underlying_wp_object()->ID;
+        }
+
+        if ( $this instanceof UsesWordPressTerm ) {
+            return $this->get_underlying_wp_object()->term_id;
+        }
+
+        // Model w/o wp_object not yet supported.
+        throw new LogicException;
+    }
+
+    /**
+     * Generates the table foreign key, depending on the model
+     * implementation.
+     *
+     * @return string
+     *
+     * @throws LogicException
+     */
+    public function get_foreign_key() {
+        if ( $this instanceof UsesWordPressPost ) {
+            return 'post_id';
+        }
+
+        // Model w/o wp_object not yet supported.
+        throw new LogicException;
+    }
+
+    /**
+     * Gets the related Model or Collection for the given sha.
+     *
+     * @param string $sha
+     *
+     * @return Model|Collection
+     */
+    public function get_related( $sha ) {
+        return $this->related[ $sha ];
+    }
+
+    /**
+     * Sets the related Model or Collection for the given sha.
+     *
+     * @param string           $sha
+     * @param Model|Collection $target
+     *
+     * @throws RuntimeException
+     */
+    public function set_related( $sha, $target ) {
+        if ( ! ( $target instanceof Model ) && ! ( $target instanceof Collection ) ) {
+            throw new RuntimeException;
+        }
+
+        $this->related[ $sha ] = $target;
+    }
+
+    /**
+     * Checks whether the attribute has a map method.
+     *
+     * This is used to determine whether the attribute maps to a
+     * property on the underlying WP_Post object. Returns the
+     * method if one exists, returns false if it doesn't.
+     *
+     * @param string $name
+     *
+     * @return false|string
+     */
+    protected function has_map_method( $name ) {
+        if ( method_exists( $this, $method = "map_{$name}" ) ) {
+            return $method;
+        }
+
+        return false;
+    }
+
+    /**
+     * Checks whether the attribute has a compute method.
+     *
+     * This is used to determine if the attribute should be computed
+     * from other attributes.
+     *
+     * @param string $name
+     *
+     * @return false|string
+     */
+    protected function has_compute_method( $name ) {
+        if ( method_exists( $this, $method = "compute_{$name}" ) ) {
+            return $method;
+        }
+
+        return false;
+    }
+
+    /**
+     * Checks whether the attribute has a compute method.
+     *
+     * This is used to determine if the attribute should be computed
+     * from other attributes.
+     *
+     * @param string $name
+     *
+     * @return false|string
+     */
+    protected function has_related_method( $name ) {
+        if ( method_exists( $this, $method = "related_{$name}" ) ) {
+            return $method;
+        }
+
+        return false;
+    }
+
+    /**
+     * Clears all the current attributes from the model.
+     *
+     * This does not touch the model's original attributes, and will
+     * only clear fillable attributes, unless the model is unguarded.
+     *
+     * @return $this
+     */
+    public function clear() {
+        $keys = $this->get_attribute_keys();
+
+        foreach ( $keys as $key ) {
+            try {
+                $this->set_attribute( $key, null );
+            } catch ( GuardedPropertyException $e ) {
+                // We won't clear out guarded attributes.
+            }
+        }
+
+        return $this;
+    }
+
+    /**
+     * Unguards the model.
+     *
+     * Sets the model to be unguarded, allowing the filling of
+     * guarded attributes.
+     */
+    public function unguard() {
+        $this->is_guarded = false;
+    }
+
+    /**
+     * Reguards the model.
+     *
+     * Sets the model to be guarded, preventing filling of
+     * guarded attributes.
+     */
+    public function reguard() {
+        $this->is_guarded = true;
+    }
+
+    /**
+     * Retrieves all the compute methods on the model.
+     *
+     * @return array
+     */
+    protected function get_compute_methods() {
+        $methods = get_class_methods( get_called_class() );
+        $methods = array_filter( $methods, function ( $method ) {
+            return strrpos( $method, 'compute_', - strlen( $method ) ) !== false;
+        } );
+        $methods = array_map( function ( $method ) {
+            return substr( $method, strlen( 'compute_' ) );
+        }, $methods );
+
+        return $methods;
+    }
+
+    /**
+     * Retrieves all the related methods on the model.
+     *
+     * @return array
+     */
+    protected function get_related_methods() {
+        $methods = get_class_methods( get_called_class() );
+        $methods = array_filter( $methods, function ( $method ) {
+            return strrpos( $method, 'related_', - strlen( $method ) ) !== false;
+        } );
+        $methods = array_map( function ( $method ) {
+            return substr( $method, strlen( 'related_' ) );
+        }, $methods );
+
+        return $methods;
+    }
+
+    /**
+     * Returns whether this relation has already been filled on the model.
+     *
+     * @param string $relation
+     *
+     * @return bool
+     */
+    public function relation_is_filled( $relation ) {
+        $sha = $this
+            ->{$this->has_related_method( $relation )}()
+            ->get_sha();
+
+        return isset( $this->related[ $sha ] );
+    }
+
+    /**
+     * Returns whether the Model is currently having
+     * its relationships filled.
+     *
+     * @return bool
+     */
+    public function is_filling() {
+        return $this->filling;
+    }
+
+    /**
+     * Sets whether the Model is having its relationships filled.
+     *
+     * @param bool $is_filling
+     */
+    public function set_filling( $is_filling ) {
+        $this->filling = $is_filling;
+    }
+
+    /**
+     * Returns a HasMany relationship for the model.
+     *
+     * @param string $class
+     * @param string $type
+     * @param string $foreign_key
+     *
+     * @return HasMany
+     */
+    protected function has_many( $class, $type, $foreign_key ) {
+        return new HasMany( $this, $class, $type, $foreign_key );
+    }
+
+    /**
+     * Returns a BelongsToOne relationship for the model.
+     *
+     * @param string $class
+     * @param string $type
+     * @param string $local_key
+     *
+     * @return HasMany
+     */
+    protected function belongs_to_one( $class, $type, $local_key = '' ) {
+        return new BelongsToOne( $this, $class, $type, $local_key );
+    }
+
+    /**
+     * Sets up the memo array for the creating model.
+     */
+    private function maybe_boot() {
+        if ( ! isset( self::$memo[ get_called_class() ] ) ) {
+            self::$memo[ get_called_class() ] = array();
+        }
+    }
+
+    /**
+     * Whether this Model uses an underlying WordPress object.
+     *
+     * @return bool
+     */
+    protected function uses_wp_object() {
+        return $this instanceof UsesWordPressPost ||
+            $this instanceof UsesWordPressTerm;
+    }
 }

src/Axolotl/Relationship/BelongsToOne.php

Doc Comments +1 added lines, -1 removed lines

@@ -90,7 +90,7 @@
 	/**
 	 * Gets the ID value for the target model to search by.
 	 *
-	 * @return int|false
+	 * @return integer
 	 *
 	 * @throws LogicException
 	 */

Indentation +106 added lines, -106 removed lines

@@ -13,110 +13,110 @@
  * @subpackage Axolotl\Relationship
  */
 class BelongsToOne extends Root {
-	/**
-	 * Relationship's primary key name
-	 * on related model.
-	 *
-	 * @var string
-	 */
-	protected $local_key = '';
-
-	/**
-	 * HasMany constructor.
-	 *
-	 * @param Model  $model
-	 * @param string $class
-	 * @param string $type
-	 * @param string $local_key
-	 */
-	public function __construct( Model $model, $class, $type, $local_key ) {
-		$this->local_key = $local_key;
-
-		parent::__construct( $model, $class, $type );
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @param EntityManager $database
-	 *
-	 * @throws LogicException
-	 */
-	public function attach_relation( EntityManager $database ) {
-		if ( $this->get_model()->is_filling() ) {
-			return;
-		}
-
-		$this->get_model()->set_filling( true );
-
-		$id = $this->make_target_id();
-
-		if ( $id ) {
-			$target = $database->find(
-				$this->get_class(),
-				$id
-			);
-
-			$this->set_target( $target );
-		}
-
-		$this->get_model()->set_filling( false );
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @return string
-	 */
-	public function get_sha() {
-		return sha1(
-			__CLASS__ .
-			get_class( $this->model ) .
-			$this->class .
-			$this->type .
-			$this->local_key
-		);
-	}
-
-	/**
-	 * Get the relationship's local key.
-	 *
-	 * @return string
-	 */
-	public function get_local_key() {
-		return $this->local_key;
-	}
-
-	/**
-	 * Gets the ID value for the target model to search by.
-	 *
-	 * @return int|false
-	 *
-	 * @throws LogicException
-	 */
-	protected function make_target_id() {
-		$class = $this->get_class();
-
-		switch ( $this->get_relationship_type() ) {
-			case 'post_post':
-				return $this->get_model()
-					->get_underlying_wp_object()
-					->{$this->local_key};
-			case 'post_term':
-				$terms = wp_get_post_terms(
-					$this->get_model()
-						->get_underlying_wp_object()
-						->ID,
-					$class::get_taxonomy()
-				);
-
-				if ( ! $terms || is_wp_error( $terms ) ) {
-					return false;
-				}
-
-				return $terms[0]->term_id;
-			default:
-				throw new LogicException;
-		}
-	}
+    /**
+     * Relationship's primary key name
+     * on related model.
+     *
+     * @var string
+     */
+    protected $local_key = '';
+
+    /**
+     * HasMany constructor.
+     *
+     * @param Model  $model
+     * @param string $class
+     * @param string $type
+     * @param string $local_key
+     */
+    public function __construct( Model $model, $class, $type, $local_key ) {
+        $this->local_key = $local_key;
+
+        parent::__construct( $model, $class, $type );
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @param EntityManager $database
+     *
+     * @throws LogicException
+     */
+    public function attach_relation( EntityManager $database ) {
+        if ( $this->get_model()->is_filling() ) {
+            return;
+        }
+
+        $this->get_model()->set_filling( true );
+
+        $id = $this->make_target_id();
+
+        if ( $id ) {
+            $target = $database->find(
+                $this->get_class(),
+                $id
+            );
+
+            $this->set_target( $target );
+        }
+
+        $this->get_model()->set_filling( false );
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @return string
+     */
+    public function get_sha() {
+        return sha1(
+            __CLASS__ .
+            get_class( $this->model ) .
+            $this->class .
+            $this->type .
+            $this->local_key
+        );
+    }
+
+    /**
+     * Get the relationship's local key.
+     *
+     * @return string
+     */
+    public function get_local_key() {
+        return $this->local_key;
+    }
+
+    /**
+     * Gets the ID value for the target model to search by.
+     *
+     * @return int|false
+     *
+     * @throws LogicException
+     */
+    protected function make_target_id() {
+        $class = $this->get_class();
+
+        switch ( $this->get_relationship_type() ) {
+            case 'post_post':
+                return $this->get_model()
+                    ->get_underlying_wp_object()
+                    ->{$this->local_key};
+            case 'post_term':
+                $terms = wp_get_post_terms(
+                    $this->get_model()
+                        ->get_underlying_wp_object()
+                        ->ID,
+                    $class::get_taxonomy()
+                );
+
+                if ( ! $terms || is_wp_error( $terms ) ) {
+                    return false;
+                }
+
+                return $terms[0]->term_id;
+            default:
+                throw new LogicException;
+        }
+    }
 }

src/Axolotl/Repository/AbstractRepository.php

Doc Comments +1 added lines, -1 removed lines

@@ -159,7 +159,7 @@
 	/**
 	 * Fills the provided Model with attributes from its custom table.
 	 *
-	 * @param Model|UsesCustomTable $model
+	 * @param Model $model
 	 */
 	protected function fill_table_attrs_from_table( Model $model ) {
 		$sql[] = "SELECT * FROM {$this->make_table_name( $model )}";

Indentation +196 added lines, -196 removed lines

@@ -17,200 +17,200 @@
  * @subpackage Axolotl\Repository
  */
 abstract class AbstractRepository {
-	/**
-	 * All models found by Repositories.
-	 *
-	 * @var array
-	 */
-	protected static $found = array();
-
-	/**
-	 * Reset the array of found model
-	 */
-	public static function free() {
-		self::$found = array();
-	}
-
-	/**
-	 * Retrieves the retrieved model by class and id.
-	 *
-	 * @param string $class
-	 * @param int    $id
-	 *
-	 * @return bool
-	 */
-	protected static function get_found( $class, $id ) {
-		if ( isset( self::$found[ $class ][ $id ] ) ) {
-			return self::$found[ $class ][ $id ];
-		}
-
-		return false;
-	}
-
-	/**
-	 * EntityManger service.
-	 *
-	 * @var EntityManager
-	 */
-	protected $database;
-
-	/**
-	 * Model class for this repository.
-	 *
-	 * @var string
-	 */
-	protected $class;
-
-	/**
-	 * EntityManager prefix.
-	 *
-	 * @var string
-	 */
-	protected $prefix;
-
-	/**
-	 * WP_Query instance.
-	 *
-	 * @var WP_Query
-	 */
-	protected $main;
-
-	/**
-	 * WordPress Database connection.
-	 *
-	 * @var wpdb
-	 */
-	protected $wpdb;
-
-	/**
-	 * AbstractRepository constructor.
-	 *
-	 * @param EntityManager $database
-	 * @param string        $class
-	 */
-	public function __construct( EntityManager $database, $class ) {
-		$this->database = $database;
-		$this->class    = $class;
-		$this->prefix   = $database->get_prefix();
-		$this->main     = $database->get_main_query();
-		$this->wpdb     = $database->get_wpdb();
-
-		if ( ! isset( self::$found[ $class ] ) ) {
-			self::$found[ $class ] = array();
-		}
-	}
-
-	/**
-	 * Get a single model of the repository class with the given ID.
-	 *
-	 * @param int $id ID of the model.
-	 *
-	 * @return Model|WP_Error
-	 */
-	abstract public function find( $id );
-
-	/**
-	 * Finds all the models of the repository class for the given params.
-	 *
-	 * @param array $params Params to constrain the find.
-	 *
-	 * @return Collection|WP_Error
-	 */
-	abstract public function find_by( array $params = array() );
-
-	/**
-	 * Create and saves a new model of the repository class
-	 * with the given data.
-	 *
-	 * @param array $data
-	 *
-	 * @return Model|WP_Error
-	 */
-	abstract public function create( array $data = array() );
-
-	/**
-	 * Updates a model with its latest data.
-	 *
-	 * @param Model $model
-	 *
-	 * @return Model|WP_Error
-	 */
-	abstract public function persist( Model $model );
-
-	/**
-	 * Delete the provided Model.
-	 *
-	 * @param Model $model
-	 * @param bool  $force
-	 *
-	 * @return Model|WP_Error
-	 */
-	abstract public function delete( Model $model, $force = false );
-
-	/**
-	 * Registers the found Model with the EntityManager.
-	 *
-	 * @param Model $model
-	 */
-	public function register_model( Model $model ) {
-		self::$found[ $this->class ][ $model->get_primary_id() ] = $model;
-	}
-
-	/**
-	 * Fills the provided Model with attributes from its custom table.
-	 *
-	 * @param Model|UsesCustomTable $model
-	 */
-	protected function fill_table_attrs_from_table( Model $model ) {
-		$sql[] = "SELECT * FROM {$this->make_table_name( $model )}";
-		$sql[] = "WHERE {$model->get_foreign_key()} = %d";
-
-		$sql = $this->wpdb->prepare(
-			implode( ' ', $sql ),
-			$model->get_primary_id()
-		);
-
-		$row = $this->wpdb->get_row( $sql, ARRAY_A );
-
-		$model->unguard();
-
-		foreach ( $row as $key => $value ) {
-			$model->set_attribute( $key, $value );
-		}
-
-		$model->reguard();
-	}
-
-	/**
-	 * Saves the Model's changed table attributes to its table.
-	 *
-	 * @param Model $model
-	 *
-	 * @throws LogicException
-	 */
-	protected function save_table_attributes_to_table( Model $model ) {
-		throw new LogicException;
-	}
-
-	/**
-	 * Deletes the Model's table attributes from its table.
-	 *
-	 * @param Model $model
-	 *
-	 * @throws LogicException
-	 */
-	protected function delete_table_attributes_from_table( Model $model ) {
-		throw new LogicException;
-	}
-
-	/**
-	 * Creates the table name string for the provided Model.
-	 *
-	 * @param UsesCustomTable $model
-	 *
-	 * @return string
-	 */
-	protected function make_table_name( UsesCustomTable $model ) {
-		return "{$this->wpdb->prefix}{$this->prefix}_{$model::get_table_name()}";
-	}
+    /**
+     * All models found by Repositories.
+     *
+     * @var array
+     */
+    protected static $found = array();
+
+    /**
+     * Reset the array of found model
+     */
+    public static function free() {
+        self::$found = array();
+    }
+
+    /**
+     * Retrieves the retrieved model by class and id.
+     *
+     * @param string $class
+     * @param int    $id
+     *
+     * @return bool
+     */
+    protected static function get_found( $class, $id ) {
+        if ( isset( self::$found[ $class ][ $id ] ) ) {
+            return self::$found[ $class ][ $id ];
+        }
+
+        return false;
+    }
+
+    /**
+     * EntityManger service.
+     *
+     * @var EntityManager
+     */
+    protected $database;
+
+    /**
+     * Model class for this repository.
+     *
+     * @var string
+     */
+    protected $class;
+
+    /**
+     * EntityManager prefix.
+     *
+     * @var string
+     */
+    protected $prefix;
+
+    /**
+     * WP_Query instance.
+     *
+     * @var WP_Query
+     */
+    protected $main;
+
+    /**
+     * WordPress Database connection.
+     *
+     * @var wpdb
+     */
+    protected $wpdb;
+
+    /**
+     * AbstractRepository constructor.
+     *
+     * @param EntityManager $database
+     * @param string        $class
+     */
+    public function __construct( EntityManager $database, $class ) {
+        $this->database = $database;
+        $this->class    = $class;
+        $this->prefix   = $database->get_prefix();
+        $this->main     = $database->get_main_query();
+        $this->wpdb     = $database->get_wpdb();
+
+        if ( ! isset( self::$found[ $class ] ) ) {
+            self::$found[ $class ] = array();
+        }
+    }
+
+    /**
+     * Get a single model of the repository class with the given ID.
+     *
+     * @param int $id ID of the model.
+     *
+     * @return Model|WP_Error
+     */
+    abstract public function find( $id );
+
+    /**
+     * Finds all the models of the repository class for the given params.
+     *
+     * @param array $params Params to constrain the find.
+     *
+     * @return Collection|WP_Error
+     */
+    abstract public function find_by( array $params = array() );
+
+    /**
+     * Create and saves a new model of the repository class
+     * with the given data.
+     *
+     * @param array $data
+     *
+     * @return Model|WP_Error
+     */
+    abstract public function create( array $data = array() );
+
+    /**
+     * Updates a model with its latest data.
+     *
+     * @param Model $model
+     *
+     * @return Model|WP_Error
+     */
+    abstract public function persist( Model $model );
+
+    /**
+     * Delete the provided Model.
+     *
+     * @param Model $model
+     * @param bool  $force
+     *
+     * @return Model|WP_Error
+     */
+    abstract public function delete( Model $model, $force = false );
+
+    /**
+     * Registers the found Model with the EntityManager.
+     *
+     * @param Model $model
+     */
+    public function register_model( Model $model ) {
+        self::$found[ $this->class ][ $model->get_primary_id() ] = $model;
+    }
+
+    /**
+     * Fills the provided Model with attributes from its custom table.
+     *
+     * @param Model|UsesCustomTable $model
+     */
+    protected function fill_table_attrs_from_table( Model $model ) {
+        $sql[] = "SELECT * FROM {$this->make_table_name( $model )}";
+        $sql[] = "WHERE {$model->get_foreign_key()} = %d";
+
+        $sql = $this->wpdb->prepare(
+            implode( ' ', $sql ),
+            $model->get_primary_id()
+        );
+
+        $row = $this->wpdb->get_row( $sql, ARRAY_A );
+
+        $model->unguard();
+
+        foreach ( $row as $key => $value ) {
+            $model->set_attribute( $key, $value );
+        }
+
+        $model->reguard();
+    }
+
+    /**
+     * Saves the Model's changed table attributes to its table.
+     *
+     * @param Model $model
+     *
+     * @throws LogicException
+     */
+    protected function save_table_attributes_to_table( Model $model ) {
+        throw new LogicException;
+    }
+
+    /**
+     * Deletes the Model's table attributes from its table.
+     *
+     * @param Model $model
+     *
+     * @throws LogicException
+     */
+    protected function delete_table_attributes_from_table( Model $model ) {
+        throw new LogicException;
+    }
+
+    /**
+     * Creates the table name string for the provided Model.
+     *
+     * @param UsesCustomTable $model
+     *
+     * @return string
+     */
+    protected function make_table_name( UsesCustomTable $model ) {
+        return "{$this->wpdb->prefix}{$this->prefix}_{$model::get_table_name()}";
+    }
 }

src/Axolotl/Repository/AbstractWordPress.php

Doc Comments +1 added lines, -1 removed lines

@@ -239,7 +239,7 @@
 	 *
 	 * @param Model $model
 	 *
-	 * @return int|WP_Error
+	 * @return integer
 	 */
 	abstract protected function save_wp_object( Model $model );
 

Indentation +276 added lines, -276 removed lines

@@ -16,280 +16,280 @@
  * @subpackage Axolotl\Repository
  */
 abstract class AbstractWordPress extends AbstractRepository {
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @param int $id
-	 */
-	public function find( $id ) {
-		if ( $model = self::get_found( $this->class, $id ) ) {
-			return $model;
-		}
-
-		$object = $this->get_wp_object_by_id( $id );
-
-		if ( ! $object ) {
-			return new WP_Error(
-				'not_found',
-				__( 'Entity not found', 'jaxion' )
-			);
-		}
-
-		return $this->make_model_from_wp_object( $object );
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @param array $params
-	 *
-	 * @return Collection
-	 */
-	public function find_by( array $params = array() ) {
-		$collection = new Collection(
-			array(),
-			array( 'model' => $this->class )
-		);
-
-		foreach ( $this->get_wp_objects_by_params( $params ) as $object ) {
-			$collection->add(
-				$this->make_model_from_wp_object( $object )
-			);
-		}
-
-		return $collection;
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @param array $data
-	 *
-	 * @return Model|WP_Error
-	 */
-	public function create( array $data = array() ) {
-		/**
-		 * Model object.
-		 *
-		 * @var Model $model
-		 */
-		$model = new $this->class( $data );
-
-		$id = $this->save_wp_object( $model );
-
-		if ( is_wp_error( $id ) ) {
-			return $id;
-		}
-
-		$model->set_attribute(
-			'object',
-			$this->get_wp_object_by_id( $id )
-		);
-
-		$this->save_table_attributes( $model );
-		$model->sync_original();
-
-		return $model;
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @param Model $model
-	 *
-	 * @return Model|WP_Error
-	 */
-	public function persist( Model $model ) {
-		$id = $this->save_wp_object( $model );
-
-		if ( is_wp_error( $id ) ) {
-			return $id;
-		}
-
-		$model->set_attribute(
-			'object',
-			$this->get_wp_object_by_id( $id )
-		);
-
-		$this->save_table_attributes( $model );
-		$model->sync_original();
-
-		return $model;
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @param Model $model
-	 * @param bool  $force
-	 *
-	 * @return Model|WP_Error
-	 */
-	public function delete( Model $model, $force = false ) {
-		$result = $this->delete_wp_object( $model, $force );
-
-		if ( is_wp_error( $result ) ) {
-			return $result;
-		}
-
-		if ( $force ) {
-			$this->delete_table_attributes( $model );
-		}
-
-		return $model;
-	}
-
-	/**
-	 * Builds the provided model class from the a wp object.
-	 *
-	 * @param WP_Post|WP_Term $object
-	 *
-	 * @return Model
-	 */
-	protected function make_model_from_wp_object( $object ) {
-		if ( $model = self::get_found( $this->class, $this->get_wp_object_id( $object ) ) ) {
-			return $model;
-		}
-
-		/**
-		 * Found Model.
-		 *
-		 * @var Model $model
-		 */
-		$model = new $this->class( array( 'object' => $object ) );
-
-		if ( $model instanceof UsesCustomTable ) {
-			$this->fill_table_attrs_from_table( $model );
-		} else {
-			$this->fill_table_attrs_from_meta( $model );
-		}
-
-		return $model;
-	}
-
-	/**
-	 * Save the table attributes for the provided model
-	 * to either a custom table or the Model's object's
-	 * metadata.
-	 *
-	 * @param Model $model
-	 */
-	protected function save_table_attributes( Model $model ) {
-		if ( $model instanceof UsesCustomTable ) {
-			$this->save_table_attributes_to_table( $model );
-		} else {
-			$this->save_table_attributes_to_meta( $model );
-		}
-	}
-
-	/**
-	 * Delete the table attributes for the provided model
-	 * from either a custom table or the Model's object's
-	 * metadata.
-	 *
-	 * @param Model $model
-	 */
-	protected function delete_table_attributes( Model $model ) {
-		if ( $model instanceof UsesCustomTable ) {
-			$this->delete_table_attributes_from_table( $model );
-		} else {
-			$this->delete_table_attributes_from_meta( $model );
-		}
-	}
-
-	/**
-	 * Generates the unique meta key for
-	 * a WordPress model's data.
-	 *
-	 * @param string $key
-	 *
-	 * @return string
-	 */
-	protected function make_meta_key( $key ) {
-		return "_{$this->prefix}_{$key}";
-	}
-
-	/**
-	 * Retrieves an WordPress object by the provided id.
-	 *
-	 * @param int $id
-	 *
-	 * @return object|false
-	 */
-	abstract protected function get_wp_object_by_id( $id );
-
-	/**
-	 * Retrieves an array of WordPress objects by the provided params.
-	 *
-	 * @param array $params
-	 *
-	 * @return array
-	 */
-	abstract protected function get_wp_objects_by_params( $params );
-
-	/**
-	 * Fills the provided Model with its meta attributes.
-	 *
-	 * @param Model $model
-	 */
-	abstract protected function fill_table_attrs_from_meta( Model $model );
-
-	/**
-	 * Save the provided WordPress object to the WordPress database.
-	 *
-	 * @param Model $model
-	 *
-	 * @return int|WP_Error
-	 */
-	abstract protected function save_wp_object( Model $model );
-
-	/**
-	 * Saves the provided Model's changed table attributes
-	 * to the appropriate meta table.
-	 *
-	 * @param Model $model
-	 */
-	abstract protected function save_table_attributes_to_meta( Model $model );
-
-	/**
-	 * Delete the WordPress object associated with the
-	 * provided model. If `$force` is true, the object
-	 * will be deleted directly rather than
-	 *
-	 * @param Model $model
-	 * @param bool  $force
-	 */
-	abstract protected function delete_wp_object( Model $model, $force = false );
-
-	/**
-	 * Delete all of the metadata associated with the object on
-	 * the provided model.
-	 *
-	 * @param Model $model
-	 */
-	abstract protected function delete_table_attributes_from_meta( Model $model );
-
-	/**
-	 * Gets the primary ID of the provided WordPress object.
-	 *
-	 * @param WP_Post|WP_Term $object
-	 *
-	 * @return int|null
-	 *
-	 * @throws LogicException
-	 */
-	protected function get_wp_object_id( $object ) {
-		if ( $object instanceof WP_Post ) {
-			return $object->ID;
-		}
-
-		if ( $object instanceof WP_Term ||
-		     // This is required for WP4.3- compatibility, when they returned stdClass.
-		     ( $object instanceof \stdClass && property_exists( $object, 'term_id' ) )
-		) {
-			return $object->term_id;
-		}
-
-		throw new LogicException;
-	}
+    /**
+     * {@inheritDoc}
+     *
+     * @param int $id
+     */
+    public function find( $id ) {
+        if ( $model = self::get_found( $this->class, $id ) ) {
+            return $model;
+        }
+
+        $object = $this->get_wp_object_by_id( $id );
+
+        if ( ! $object ) {
+            return new WP_Error(
+                'not_found',
+                __( 'Entity not found', 'jaxion' )
+            );
+        }
+
+        return $this->make_model_from_wp_object( $object );
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @param array $params
+     *
+     * @return Collection
+     */
+    public function find_by( array $params = array() ) {
+        $collection = new Collection(
+            array(),
+            array( 'model' => $this->class )
+        );
+
+        foreach ( $this->get_wp_objects_by_params( $params ) as $object ) {
+            $collection->add(
+                $this->make_model_from_wp_object( $object )
+            );
+        }
+
+        return $collection;
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @param array $data
+     *
+     * @return Model|WP_Error
+     */
+    public function create( array $data = array() ) {
+        /**
+         * Model object.
+         *
+         * @var Model $model
+         */
+        $model = new $this->class( $data );
+
+        $id = $this->save_wp_object( $model );
+
+        if ( is_wp_error( $id ) ) {
+            return $id;
+        }
+
+        $model->set_attribute(
+            'object',
+            $this->get_wp_object_by_id( $id )
+        );
+
+        $this->save_table_attributes( $model );
+        $model->sync_original();
+
+        return $model;
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @param Model $model
+     *
+     * @return Model|WP_Error
+     */
+    public function persist( Model $model ) {
+        $id = $this->save_wp_object( $model );
+
+        if ( is_wp_error( $id ) ) {
+            return $id;
+        }
+
+        $model->set_attribute(
+            'object',
+            $this->get_wp_object_by_id( $id )
+        );
+
+        $this->save_table_attributes( $model );
+        $model->sync_original();
+
+        return $model;
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @param Model $model
+     * @param bool  $force
+     *
+     * @return Model|WP_Error
+     */
+    public function delete( Model $model, $force = false ) {
+        $result = $this->delete_wp_object( $model, $force );
+
+        if ( is_wp_error( $result ) ) {
+            return $result;
+        }
+
+        if ( $force ) {
+            $this->delete_table_attributes( $model );
+        }
+
+        return $model;
+    }
+
+    /**
+     * Builds the provided model class from the a wp object.
+     *
+     * @param WP_Post|WP_Term $object
+     *
+     * @return Model
+     */
+    protected function make_model_from_wp_object( $object ) {
+        if ( $model = self::get_found( $this->class, $this->get_wp_object_id( $object ) ) ) {
+            return $model;
+        }
+
+        /**
+         * Found Model.
+         *
+         * @var Model $model
+         */
+        $model = new $this->class( array( 'object' => $object ) );
+
+        if ( $model instanceof UsesCustomTable ) {
+            $this->fill_table_attrs_from_table( $model );
+        } else {
+            $this->fill_table_attrs_from_meta( $model );
+        }
+
+        return $model;
+    }
+
+    /**
+     * Save the table attributes for the provided model
+     * to either a custom table or the Model's object's
+     * metadata.
+     *
+     * @param Model $model
+     */
+    protected function save_table_attributes( Model $model ) {
+        if ( $model instanceof UsesCustomTable ) {
+            $this->save_table_attributes_to_table( $model );
+        } else {
+            $this->save_table_attributes_to_meta( $model );
+        }
+    }
+
+    /**
+     * Delete the table attributes for the provided model
+     * from either a custom table or the Model's object's
+     * metadata.
+     *
+     * @param Model $model
+     */
+    protected function delete_table_attributes( Model $model ) {
+        if ( $model instanceof UsesCustomTable ) {
+            $this->delete_table_attributes_from_table( $model );
+        } else {
+            $this->delete_table_attributes_from_meta( $model );
+        }
+    }
+
+    /**
+     * Generates the unique meta key for
+     * a WordPress model's data.
+     *
+     * @param string $key
+     *
+     * @return string
+     */
+    protected function make_meta_key( $key ) {
+        return "_{$this->prefix}_{$key}";
+    }
+
+    /**
+     * Retrieves an WordPress object by the provided id.
+     *
+     * @param int $id
+     *
+     * @return object|false
+     */
+    abstract protected function get_wp_object_by_id( $id );
+
+    /**
+     * Retrieves an array of WordPress objects by the provided params.
+     *
+     * @param array $params
+     *
+     * @return array
+     */
+    abstract protected function get_wp_objects_by_params( $params );
+
+    /**
+     * Fills the provided Model with its meta attributes.
+     *
+     * @param Model $model
+     */
+    abstract protected function fill_table_attrs_from_meta( Model $model );
+
+    /**
+     * Save the provided WordPress object to the WordPress database.
+     *
+     * @param Model $model
+     *
+     * @return int|WP_Error
+     */
+    abstract protected function save_wp_object( Model $model );
+
+    /**
+     * Saves the provided Model's changed table attributes
+     * to the appropriate meta table.
+     *
+     * @param Model $model
+     */
+    abstract protected function save_table_attributes_to_meta( Model $model );
+
+    /**
+     * Delete the WordPress object associated with the
+     * provided model. If `$force` is true, the object
+     * will be deleted directly rather than
+     *
+     * @param Model $model
+     * @param bool  $force
+     */
+    abstract protected function delete_wp_object( Model $model, $force = false );
+
+    /**
+     * Delete all of the metadata associated with the object on
+     * the provided model.
+     *
+     * @param Model $model
+     */
+    abstract protected function delete_table_attributes_from_meta( Model $model );
+
+    /**
+     * Gets the primary ID of the provided WordPress object.
+     *
+     * @param WP_Post|WP_Term $object
+     *
+     * @return int|null
+     *
+     * @throws LogicException
+     */
+    protected function get_wp_object_id( $object ) {
+        if ( $object instanceof WP_Post ) {
+            return $object->ID;
+        }
+
+        if ( $object instanceof WP_Term ||
+             // This is required for WP4.3- compatibility, when they returned stdClass.
+             ( $object instanceof \stdClass && property_exists( $object, 'term_id' ) )
+        ) {
+            return $object->term_id;
+        }
+
+        throw new LogicException;
+    }
 }

src/Http/Filter.php

Indentation +130 added lines, -130 removed lines

@@ -12,134 +12,134 @@
  * @subpackage Http
  */
 class Filter implements FilterContract {
-	/**
-	 * 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;
-	}
-
-	/**
-	 * 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;
-			}
-
-			$args[ $arg ] = $this->parse_validation( $validation );
-		}
-
-		return $args;
-	}
-
-	/**
-	 * Parses a validation string into a WP-API compatible rule.
-	 *
-	 * @param string $validation
-	 *
-	 * @return array
-	 *
-	 * @todo The next rule added needs to refactor this process.
-	 */
-	protected function parse_validation( $validation ) {
-		$validation = explode( '|', $validation );
-
-		$rules = array();
-
-		foreach ( $validation as $rule ) {
-			if ( 0 === strpos( $rule, 'default' ) ) {
-				$rule_arr = explode( ':', $rule );
-
-				$rules['default'] = count( $rule_arr ) === 2 ? array_pop( $rule_arr ) : '';
-			}
-
-			if ( 0 === strpos( $rule, 'oneof' ) ) {
-				list( $rule, $values ) = explode( ':', $rule );
-
-				$values   = explode( ',', $values );
-				$callback = function ( $value ) use ( $values ) {
-					if ( in_array( $value, $values, true ) ) {
-						return true;
-					}
-
-					return false;
-				};
-
-				$rules['validate_callback'] = isset( $rules['validate_callback'] ) ? $this->add_callback( $rules['validate_callback'], $callback ) : $callback;
-			}
-
-			switch ( $rule ) {
-				case 'required':
-					$rules['required'] = true;
-					break;
-				case 'integer':
-					$callback                   = array( $this, 'validate_integer' );
-					$rules['validate_callback'] = isset( $rules['validate_callback'] ) ? $this->add_callback( $rules['validate_callback'], $callback ) : $callback;
-
-					$callback                   = array( $this, 'make_integer' );
-					$rules['sanitize_callback'] = isset( $rules['sanitize_callback'] ) ? $this->add_callback( $rules['sanitize_callback'], $callback ) : $callback;
-					break;
-			}
-		}
-
-		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;
-	}
-
-	/**
-	 * Casts a provided value to an integer.
-	 *
-	 * @param mixed $value
-	 *
-	 * @return int
-	 */
-	public function make_integer( $value ) {
-		return (int) $value;
-	}
-
-	/**
-	 * Creates a new callback that connects the previous and next callback.
-	 *
-	 * @param callable $previous
-	 * @param callable $next
-	 *
-	 * @return \Closure;
-	 */
-	private function add_callback( $previous, $next ) {
-		return function ( $value ) use ( $previous, $next ) {
-			if ( call_user_func( $previous, $value ) ) {
-				return call_user_func( $next, $value );
-			}
-
-			return false;
-		};
-	}
+    /**
+     * 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;
+    }
+
+    /**
+     * 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;
+            }
+
+            $args[ $arg ] = $this->parse_validation( $validation );
+        }
+
+        return $args;
+    }
+
+    /**
+     * Parses a validation string into a WP-API compatible rule.
+     *
+     * @param string $validation
+     *
+     * @return array
+     *
+     * @todo The next rule added needs to refactor this process.
+     */
+    protected function parse_validation( $validation ) {
+        $validation = explode( '|', $validation );
+
+        $rules = array();
+
+        foreach ( $validation as $rule ) {
+            if ( 0 === strpos( $rule, 'default' ) ) {
+                $rule_arr = explode( ':', $rule );
+
+                $rules['default'] = count( $rule_arr ) === 2 ? array_pop( $rule_arr ) : '';
+            }
+
+            if ( 0 === strpos( $rule, 'oneof' ) ) {
+                list( $rule, $values ) = explode( ':', $rule );
+
+                $values   = explode( ',', $values );
+                $callback = function ( $value ) use ( $values ) {
+                    if ( in_array( $value, $values, true ) ) {
+                        return true;
+                    }
+
+                    return false;
+                };
+
+                $rules['validate_callback'] = isset( $rules['validate_callback'] ) ? $this->add_callback( $rules['validate_callback'], $callback ) : $callback;
+            }
+
+            switch ( $rule ) {
+                case 'required':
+                    $rules['required'] = true;
+                    break;
+                case 'integer':
+                    $callback                   = array( $this, 'validate_integer' );
+                    $rules['validate_callback'] = isset( $rules['validate_callback'] ) ? $this->add_callback( $rules['validate_callback'], $callback ) : $callback;
+
+                    $callback                   = array( $this, 'make_integer' );
+                    $rules['sanitize_callback'] = isset( $rules['sanitize_callback'] ) ? $this->add_callback( $rules['sanitize_callback'], $callback ) : $callback;
+                    break;
+            }
+        }
+
+        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;
+    }
+
+    /**
+     * Casts a provided value to an integer.
+     *
+     * @param mixed $value
+     *
+     * @return int
+     */
+    public function make_integer( $value ) {
+        return (int) $value;
+    }
+
+    /**
+     * Creates a new callback that connects the previous and next callback.
+     *
+     * @param callable $previous
+     * @param callable $next
+     *
+     * @return \Closure;
+     */
+    private function add_callback( $previous, $next ) {
+        return function ( $value ) use ( $previous, $next ) {
+            if ( call_user_func( $previous, $value ) ) {
+                return call_user_func( $next, $value );
+            }
+
+            return false;
+        };
+    }
 }