Elep

<?php
/**
 * File containing the ezcConsoleOptionRule class.
 *
 * @package ConsoleTools
 * @version 1.6.1
 * @copyright Copyright (C) 2005-2010 eZ Systems AS. All rights reserved.
 * @license http://ez.no/licenses/new_bsd New BSD License
 * @filesource
 */

/**
 * Struct class to store a parameter rule.
 *
 * This struct stores relation rules between parameters. A relation consists of
 * a parameter that the relation refers to and optionally the value(s) the 
 * referred parameter may have assigned. Rules may be used for dependencies and 
 * exclusions between parameters.
 *
 * The ezcConsoleOptionRule class has the following properties:
 * - option ezcConsoleOption, contains the parameter that this rule refers to.
 * - values array(string), contains a list of values that are accepted.
 *
 * @see ezcConsoleOption
 * 
 * @package ConsoleTools
 * @version 1.6.1
 */
class ezcConsoleOptionRule
{
 /**
 * Properties.
 *
 * @var array
 */
 protected $properties = array( 
 'option' => null,
 'values' => array(),
 'ifSet' => true
 );

/**
 * Creates a new option rule.
 *
 * Creates a new option rule. Per default the $values parameter
 * is an empty array, which determines that the option may accept any
 * value. To indicate that a option may only have certain values,
 * place them inside tha $values array. For example to indicate an option
 * may have the values 'a', 'b' and 'c' use:
 *
 * <code>
 * $rule = new ezcConsoleOptionRule( $option, array( 'a', 'b', 'c' ) );
 * </code>
 *
 * If you want to allow only 1 specific value for an option, you do not
 * need to wrap this into an array, when creating the rule. Simply use
 *
 * <code>
 * $rule = new ezcConsoleOptionRule( $option, 'a' );
 * </code>
 *
 * to create a rule, that allows the desired option only to accept the
 * value 'a'.
 *
 * The $ifSet parameter determines, if the rule is validated when its option
 * is set or left out. If $ifSet is true, the rule is validated when the 
 * option is set. Otherwise the rule is validated if the option was not set 
 * by the user.
 *
 * @param ezcConsoleOption $option The option to refer to.
 * @param mixed $values The affected values.
 * @param bool $ifSet
 */
 public function __construct( ezcConsoleOption $option, array $values = array(), $ifSet = true )
 {
 $this->__set( 'option', $option );
 $this->__set( 'values', $values );
 $this->__set( 'ifSet', $ifSet );
 }
 
 /**
 * Property read access.
 *
 * @throws ezcBasePropertyNotFoundException 
 * If the the desired property is not found.
 * 
 * @param string $propertyName Name of the property.
 * @return mixed Value of the property or null.
 * @ignore
 */
 public function __get( $propertyName ) 
 {
 switch ( $propertyName )
 {
 case 'option':
 return $this->properties['option'];
 case 'values':
 return $this->properties['values'];
 case 'ifSet':
 return $this->properties['ifSet'];
 }
 throw new ezcBasePropertyNotFoundException( $propertyName );
 }
 
 /**
 * Property write access.
 * 
 * @param string $propertyName Name of the property.
 * @param mixed $propertyValue The value for the property.
 *
 * @throws ezcBasePropertyPermissionException
 * If the property you try to access is read-only.
 * @throws ezcBasePropertyNotFoundException 
 * If the the desired property is not found.
 * @ignore
 */
 public function __set( $propertyName, $propertyValue ) 
 {
 switch ( $propertyName )
 {
 case 'option':
 if ( !( $propertyValue instanceof ezcConsoleOption ) )
 {
 throw new ezcBaseValueException( $propertyName, $propertyValue, 'ezcConsoleOption' );
 }
 $this->properties['option'] = $propertyValue;
 return;
 case 'values':
 if ( !is_array( $propertyValue ) )
 {
 throw new ezcBaseValueException( $propertyName, $propertyValue, 'array' );
 }
 $this->properties['values'] = $propertyValue;
 return;
 case 'ifSet':
 if ( !is_bool( $propertyValue ) )
 {
 throw new ezcBaseValueException( $propertyName, $propertyValue, 'bool' );
 }
 $this->properties['ifSet'] = $propertyValue;
 return;
 }
 throw new ezcBasePropertyNotFoundException( $propertyName );
 }
 
 /**
 * Property isset access.
 * 
 * @param string $propertyName Name of the property to check.
 * @return bool If the property exists or not.
 * @ignore
 */
 public function __isset( $propertyName )
 {
 switch ( $propertyName )
 {
 case 'option':
 case 'values':
 case 'ifSet':
 return true;
 }
 return false;
 }

}