vanderlee / PHPSwaggerGen

SwaggerGen/Swagger/Type/ReferenceObjectType.php

Indentation +43 added lines, -43 removed lines

@@ -15,48 +15,48 @@
 class ReferenceObjectType extends AbstractType
 {
 
-    private $reference = null;
-
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $definition = self::trim($definition);
-
-        $match = array();
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_CONTENT . self::REGEX_RANGE . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
-            throw new Exception('Unparseable string definition: \'' . $definition . '\'');
-        }
-
-        $type = strtolower($match[1]);
-
-        $reference = null;
-        if ($type === 'refobject') {
-            if (isset($match[2])) {
-                $reference = $match[2];
-            }
-        } else {
-            $reference = $match[1];
-        }
-
-        if (empty($reference)) {
-            throw new Exception('Referenced object name missing: \'' . $definition . '\'');
-        }
-
-        $this->reference = $reference;
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            '$ref' => '#/definitions/' . $this->reference,
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__ . ' ' . $this->reference;
-    }
+	private $reference = null;
+
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$definition = self::trim($definition);
+
+		$match = array();
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_CONTENT . self::REGEX_RANGE . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
+			throw new Exception('Unparseable string definition: \'' . $definition . '\'');
+		}
+
+		$type = strtolower($match[1]);
+
+		$reference = null;
+		if ($type === 'refobject') {
+			if (isset($match[2])) {
+				$reference = $match[2];
+			}
+		} else {
+			$reference = $match[1];
+		}
+
+		if (empty($reference)) {
+			throw new Exception('Referenced object name missing: \'' . $definition . '\'');
+		}
+
+		$this->reference = $reference;
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'$ref' => '#/definitions/' . $this->reference,
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__ . ' ' . $this->reference;
+	}
 
 }

SwaggerGen/Swagger/Type/AllOfType.php

Indentation +47 added lines, -47 removed lines

@@ -14,54 +14,54 @@
  */
 class AllOfType extends AbstractType
 {
-    private $allOfItems = array();
-    private $mostRecentItem;
+	private $allOfItems = array();
+	private $mostRecentItem;
 
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $pattern = self::REGEX_START . 'allof' . self::REGEX_CONTENT . self::REGEX_END;
-        $inlineDef = '';
-        if (preg_match($pattern, $definition, $matches)) {
-            if (isset($matches[1])) {
-                $inlineDef = $matches[1];
-            }
-        }
-        if ($inlineDef) {
-            foreach ($this->parseList($inlineDef) as $item) {
-                $this->handleCommand('item', $item);
-            }
-        }
-    }
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$pattern = self::REGEX_START . 'allof' . self::REGEX_CONTENT . self::REGEX_END;
+		$inlineDef = '';
+		if (preg_match($pattern, $definition, $matches)) {
+			if (isset($matches[1])) {
+				$inlineDef = $matches[1];
+			}
+		}
+		if ($inlineDef) {
+			foreach ($this->parseList($inlineDef) as $item) {
+				$this->handleCommand('item', $item);
+			}
+		}
+	}
 
-    /**
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        if (strtolower($command) === 'item') {
-            $this->mostRecentItem = self::typeFactory($this, $data);
-            $this->allOfItems[] = $this->mostRecentItem;
-            return $this;
-        }
-        if (isset($this->mostRecentItem)) {
-            if ($this->mostRecentItem->handleCommand($command, $data)) {
-                return $this;
-            }
-        }
-        return parent::handleCommand($command, $data);
-    }
+	/**
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		if (strtolower($command) === 'item') {
+			$this->mostRecentItem = self::typeFactory($this, $data);
+			$this->allOfItems[] = $this->mostRecentItem;
+			return $this;
+		}
+		if (isset($this->mostRecentItem)) {
+			if ($this->mostRecentItem->handleCommand($command, $data)) {
+				return $this;
+			}
+		}
+		return parent::handleCommand($command, $data);
+	}
 
-    public function toArray()
-    {
-        $allOf = array();
-        foreach ($this->allOfItems as $item) {
-            $allOf[] = $item->toArray();
-        }
-        return self::arrayFilterNull(array_merge(array(
-            'allOf' => $allOf,
-        ), parent::toArray()));
-    }
+	public function toArray()
+	{
+		$allOf = array();
+		foreach ($this->allOfItems as $item) {
+			$allOf[] = $item->toArray();
+		}
+		return self::arrayFilterNull(array_merge(array(
+			'allOf' => $allOf,
+		), parent::toArray()));
+	}
 }

SwaggerGen/Swagger/Type/FileType.php

Indentation +40 added lines, -40 removed lines

@@ -17,45 +17,45 @@
 class FileType extends AbstractType
 {
 
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $type = strtolower($definition);
-
-        if ($type !== 'file') {
-            throw new Exception("Not a file: '{$definition}'");
-        }
-
-        $parent = $this->getParent();
-        if (!($parent instanceof Parameter) || !$parent->isForm()) {
-            throw new Exception("File type '{$definition}' only allowed on form parameter");
-        }
-
-        /** @var Operation $parentOperation */
-        $parentOperation = $this->getParentClass(Operation::class);
-        $consumes = $parentOperation->getConsumes();
-        if (empty($consumes)) {
-            $consumes = $this->getSwagger()->getConsumes();
-        }
-
-        $valid_consumes = ((int)in_array('multipart/form-data', $consumes)) + ((int)in_array('application/x-www-form-urlencoded', $consumes));
-        if (empty($consumes) || $valid_consumes !== count($consumes)) {
-            throw new Exception("File type '{$definition}' without valid consume");
-        }
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'type' => 'file',
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__;
-    }
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$type = strtolower($definition);
+
+		if ($type !== 'file') {
+			throw new Exception("Not a file: '{$definition}'");
+		}
+
+		$parent = $this->getParent();
+		if (!($parent instanceof Parameter) || !$parent->isForm()) {
+			throw new Exception("File type '{$definition}' only allowed on form parameter");
+		}
+
+		/** @var Operation $parentOperation */
+		$parentOperation = $this->getParentClass(Operation::class);
+		$consumes = $parentOperation->getConsumes();
+		if (empty($consumes)) {
+			$consumes = $this->getSwagger()->getConsumes();
+		}
+
+		$valid_consumes = ((int)in_array('multipart/form-data', $consumes)) + ((int)in_array('application/x-www-form-urlencoded', $consumes));
+		if (empty($consumes) || $valid_consumes !== count($consumes)) {
+			throw new Exception("File type '{$definition}' without valid consume");
+		}
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'type' => 'file',
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__;
+	}
 
 }

SwaggerGen/Swagger/Type/DateType.php

Indentation +92 added lines, -92 removed lines

@@ -16,97 +16,97 @@
 class DateType extends AbstractType
 {
 
-    const REGEX_DEFAULT = '(?:=(\S+))?';
-
-    /**
-     * Map of recognized format names to Swagger formats
-     * @var array
-     */
-    private static $formats = array(
-        'date' => 'date',
-        'date-time' => 'date-time',
-        'datetime' => 'date-time',
-    );
-    private static $datetime_formats = array(
-        'date' => 'Y-m-d',
-        'date-time' => DateTime::RFC3339,
-    );
-
-    /**
-     * @var String
-     */
-    private $format;
-
-    /**
-     * @var DateTime
-     */
-    private $default = null;
-
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $match = array();
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
-            throw new Exception("Unparseable date definition: '{$definition}'");
-        }
-
-        $type = strtolower($match[1]);
-
-        if (!isset(self::$formats[$type])) {
-            throw new Exception("Not a date: '{$definition}'");
-        }
-        $this->format = self::$formats[$type];
-
-        $this->default = isset($match[2]) && $match[2] !== '' ? $this->validateDefault($match[2]) : null;
-    }
-
-    /**
-     * @param string $command The comment command
-     * @param string $data Any data added after the command
-     * @return AbstractType|boolean
-     * @throws Exception
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        if (strtolower($command) === 'default') {
-            $this->default = $this->validateDefault($data);
-            return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'type' => 'string',
-            'format' => $this->format,
-            'default' => $this->default ? $this->default->format(self::$datetime_formats[$this->format]) : null,
-        ), parent::toArray()));
-    }
-
-    /**
-     * @throws Exception
-     */
-    private function validateDefault($value)
-    {
-        if (empty($value)) {
-            throw new Exception("Empty date default");
-        }
-
-        if (($DateTime = date_create($value)) !== false) {
-            return $DateTime;
-        }
-
-        throw new Exception("Invalid '{$this->format}' default: '{$value}'");
-    }
-
-    public function __toString()
-    {
-        return __CLASS__;
-    }
+	const REGEX_DEFAULT = '(?:=(\S+))?';
+
+	/**
+	 * Map of recognized format names to Swagger formats
+	 * @var array
+	 */
+	private static $formats = array(
+		'date' => 'date',
+		'date-time' => 'date-time',
+		'datetime' => 'date-time',
+	);
+	private static $datetime_formats = array(
+		'date' => 'Y-m-d',
+		'date-time' => DateTime::RFC3339,
+	);
+
+	/**
+	 * @var String
+	 */
+	private $format;
+
+	/**
+	 * @var DateTime
+	 */
+	private $default = null;
+
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$match = array();
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
+			throw new Exception("Unparseable date definition: '{$definition}'");
+		}
+
+		$type = strtolower($match[1]);
+
+		if (!isset(self::$formats[$type])) {
+			throw new Exception("Not a date: '{$definition}'");
+		}
+		$this->format = self::$formats[$type];
+
+		$this->default = isset($match[2]) && $match[2] !== '' ? $this->validateDefault($match[2]) : null;
+	}
+
+	/**
+	 * @param string $command The comment command
+	 * @param string $data Any data added after the command
+	 * @return AbstractType|boolean
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		if (strtolower($command) === 'default') {
+			$this->default = $this->validateDefault($data);
+			return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'type' => 'string',
+			'format' => $this->format,
+			'default' => $this->default ? $this->default->format(self::$datetime_formats[$this->format]) : null,
+		), parent::toArray()));
+	}
+
+	/**
+	 * @throws Exception
+	 */
+	private function validateDefault($value)
+	{
+		if (empty($value)) {
+			throw new Exception("Empty date default");
+		}
+
+		if (($DateTime = date_create($value)) !== false) {
+			return $DateTime;
+		}
+
+		throw new Exception("Invalid '{$this->format}' default: '{$value}'");
+	}
+
+	public function __toString()
+	{
+		return __CLASS__;
+	}
 
 }

SwaggerGen/Swagger/Type/StringUuidType.php

Indentation +10 added lines, -10 removed lines

@@ -15,15 +15,15 @@
 class StringUuidType extends AbstractRegexType
 {
 
-    /**
-     * Construct and set up the regular expression for this type
-     *
-     * @param AbstractObject $parent
-     * @param string $definition
-     */
-    public function __construct(AbstractObject $parent, $definition)
-    {
-        parent::__construct($parent, $definition, 'uuid', '[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[1-5][a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}');
-    }
+	/**
+	 * Construct and set up the regular expression for this type
+	 *
+	 * @param AbstractObject $parent
+	 * @param string $definition
+	 */
+	public function __construct(AbstractObject $parent, $definition)
+	{
+		parent::__construct($parent, $definition, 'uuid', '[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[1-5][a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}');
+	}
 
 }

SwaggerGen/Swagger/Type/StringType.php

Indentation +182 added lines, -182 removed lines

@@ -15,187 +15,187 @@
 class StringType extends AbstractType
 {
 
-    private static $formats = array(
-        'string' => '',
-        'byte' => 'byte',
-        'binary' => 'binary',
-        'password' => 'password',
-        'enum' => '',
-    );
-
-    /**
-     * Name of the type
-     * @var string
-     */
-    protected $format = '';
-    protected $pattern = null;
-    protected $default = null;
-    protected $maxLength = null;
-    protected $minLength = null;
-    protected $enum = array();
-
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $definition = self::trim($definition);
-
-        $match = array();
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_CONTENT . self::REGEX_RANGE . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
-            throw new Exception("Unparseable string definition: '{$definition}'");
-        }
-
-        $this->parseFormat($definition, $match);
-        $this->parseContent($definition, $match);
-        $this->parseRange($definition, $match);
-        $this->parseDefault($definition, $match);
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseFormat($definition, $match)
-    {
-        $type = strtolower($match[1]);
-        if (!isset(self::$formats[$type])) {
-            throw new Exception("Not a string: '{$definition}'");
-        }
-        $this->format = self::$formats[$type];
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     */
-    private function parseContent($definition, $match)
-    {
-        if (strtolower($match[1]) === 'enum') {
-            $this->enum = explode(',', $match[2]);
-        } else {
-            $this->pattern = empty($match[2]) ? null : $match[2];
-        }
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     * @throws Exception
-     */
-    private function parseRange($definition, $match)
-    {
-
-        if (!empty($match[3])) {
-            if ($match[1] === 'enum') {
-                throw new Exception("Range not allowed in enumeration definition: '{$definition}'");
-            }
-            if ($match[4] === '' && $match[5] === '') {
-                throw new Exception("Empty string range: '{$definition}'");
-            }
-            $exclusiveMinimum = $match[3] == '<';
-            $this->minLength = $match[4] === '' ? null : $match[4];
-            $this->maxLength = $match[5] === '' ? null : $match[5];
-            $exclusiveMaximum = isset($match[6]) ? ($match[6] == '>') : null;
-            if ($this->minLength !== null && $this->maxLength !== null && $this->minLength > $this->maxLength) {
-                self::swap($this->minLength, $this->maxLength);
-                self::swap($exclusiveMinimum, $exclusiveMaximum);
-            }
-            $this->minLength = $this->minLength === null ? null : max(0, $exclusiveMinimum ? $this->minLength + 1 : $this->minLength);
-            $this->maxLength = $this->maxLength === null ? null : max(0, $exclusiveMaximum ? $this->maxLength - 1 : $this->maxLength);
-        }
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseDefault($definition, $match)
-    {
-        $this->default = isset($match[7]) && $match[7] !== '' ? $this->validateDefault($match[7]) : null;
-    }
-
-    /**
-     * @param string $command The comment command
-     * @param string $data Any data added after the command
-     * @return AbstractType|boolean
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            case 'default':
-                $this->default = $this->validateDefault($data);
-                return $this;
-
-            case 'pattern':
-                $this->pattern = $data;
-                return $this;
-
-            case 'enum':
-                if ($this->minLength !== null || $this->maxLength !== null) {
-                    throw new Exception("Enumeration not allowed in ranged string: '{$data}'");
-                }
-                $words = self::wordSplit($data);
-                $this->enum = is_array($this->enum) ? array_merge($this->enum, $words) : $words;
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'type' => 'string',
-            'format' => empty($this->format) ? null : $this->format,
-            'pattern' => $this->pattern,
-            'default' => $this->default,
-            'minLength' => $this->minLength ? intval($this->minLength) : null,
-            'maxLength' => $this->maxLength ? intval($this->maxLength) : null,
-            'enum' => $this->enum,
-        ), parent::toArray()));
-    }
-
-    /**
-     * Validate a default string value, depending on subtype
-     *
-     * @param string $value the value to validate
-     * @return string the value after validation (might become trimmed)
-     * @throws Exception
-     */
-    protected function validateDefault($value)
-    {
-        if (empty($value)) {
-            $type = $this->format ?: ($this->enum ? 'enum' : 'string');
-            throw new Exception("Empty {$type} default");
-        }
-
-        if (!empty($this->enum) && !in_array($value, $this->enum)) {
-            throw new Exception("Invalid enum default: '{$value}'");
-        }
-
-        if ($this->maxLength !== null && mb_strlen($value) > $this->maxLength) {
-            $type = $this->format ?: ($this->enum ? 'enum' : 'string');
-            throw new Exception("Default {$type} length beyond maximum: '{$value}'");
-        }
-
-        if ($this->minLength !== null && mb_strlen($value) < $this->minLength) {
-            $type = $this->format ?: ($this->enum ? 'enum' : 'string');
-            throw new Exception("Default {$type} length beyond minimum: '{$value}'");
-        }
-
-        return $value;
-    }
-
-    public function __toString()
-    {
-        return __CLASS__;
-    }
+	private static $formats = array(
+		'string' => '',
+		'byte' => 'byte',
+		'binary' => 'binary',
+		'password' => 'password',
+		'enum' => '',
+	);
+
+	/**
+	 * Name of the type
+	 * @var string
+	 */
+	protected $format = '';
+	protected $pattern = null;
+	protected $default = null;
+	protected $maxLength = null;
+	protected $minLength = null;
+	protected $enum = array();
+
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$definition = self::trim($definition);
+
+		$match = array();
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_CONTENT . self::REGEX_RANGE . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
+			throw new Exception("Unparseable string definition: '{$definition}'");
+		}
+
+		$this->parseFormat($definition, $match);
+		$this->parseContent($definition, $match);
+		$this->parseRange($definition, $match);
+		$this->parseDefault($definition, $match);
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseFormat($definition, $match)
+	{
+		$type = strtolower($match[1]);
+		if (!isset(self::$formats[$type])) {
+			throw new Exception("Not a string: '{$definition}'");
+		}
+		$this->format = self::$formats[$type];
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 */
+	private function parseContent($definition, $match)
+	{
+		if (strtolower($match[1]) === 'enum') {
+			$this->enum = explode(',', $match[2]);
+		} else {
+			$this->pattern = empty($match[2]) ? null : $match[2];
+		}
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	private function parseRange($definition, $match)
+	{
+
+		if (!empty($match[3])) {
+			if ($match[1] === 'enum') {
+				throw new Exception("Range not allowed in enumeration definition: '{$definition}'");
+			}
+			if ($match[4] === '' && $match[5] === '') {
+				throw new Exception("Empty string range: '{$definition}'");
+			}
+			$exclusiveMinimum = $match[3] == '<';
+			$this->minLength = $match[4] === '' ? null : $match[4];
+			$this->maxLength = $match[5] === '' ? null : $match[5];
+			$exclusiveMaximum = isset($match[6]) ? ($match[6] == '>') : null;
+			if ($this->minLength !== null && $this->maxLength !== null && $this->minLength > $this->maxLength) {
+				self::swap($this->minLength, $this->maxLength);
+				self::swap($exclusiveMinimum, $exclusiveMaximum);
+			}
+			$this->minLength = $this->minLength === null ? null : max(0, $exclusiveMinimum ? $this->minLength + 1 : $this->minLength);
+			$this->maxLength = $this->maxLength === null ? null : max(0, $exclusiveMaximum ? $this->maxLength - 1 : $this->maxLength);
+		}
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseDefault($definition, $match)
+	{
+		$this->default = isset($match[7]) && $match[7] !== '' ? $this->validateDefault($match[7]) : null;
+	}
+
+	/**
+	 * @param string $command The comment command
+	 * @param string $data Any data added after the command
+	 * @return AbstractType|boolean
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			case 'default':
+				$this->default = $this->validateDefault($data);
+				return $this;
+
+			case 'pattern':
+				$this->pattern = $data;
+				return $this;
+
+			case 'enum':
+				if ($this->minLength !== null || $this->maxLength !== null) {
+					throw new Exception("Enumeration not allowed in ranged string: '{$data}'");
+				}
+				$words = self::wordSplit($data);
+				$this->enum = is_array($this->enum) ? array_merge($this->enum, $words) : $words;
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'type' => 'string',
+			'format' => empty($this->format) ? null : $this->format,
+			'pattern' => $this->pattern,
+			'default' => $this->default,
+			'minLength' => $this->minLength ? intval($this->minLength) : null,
+			'maxLength' => $this->maxLength ? intval($this->maxLength) : null,
+			'enum' => $this->enum,
+		), parent::toArray()));
+	}
+
+	/**
+	 * Validate a default string value, depending on subtype
+	 *
+	 * @param string $value the value to validate
+	 * @return string the value after validation (might become trimmed)
+	 * @throws Exception
+	 */
+	protected function validateDefault($value)
+	{
+		if (empty($value)) {
+			$type = $this->format ?: ($this->enum ? 'enum' : 'string');
+			throw new Exception("Empty {$type} default");
+		}
+
+		if (!empty($this->enum) && !in_array($value, $this->enum)) {
+			throw new Exception("Invalid enum default: '{$value}'");
+		}
+
+		if ($this->maxLength !== null && mb_strlen($value) > $this->maxLength) {
+			$type = $this->format ?: ($this->enum ? 'enum' : 'string');
+			throw new Exception("Default {$type} length beyond maximum: '{$value}'");
+		}
+
+		if ($this->minLength !== null && mb_strlen($value) < $this->minLength) {
+			$type = $this->format ?: ($this->enum ? 'enum' : 'string');
+			throw new Exception("Default {$type} length beyond minimum: '{$value}'");
+		}
+
+		return $value;
+	}
+
+	public function __toString()
+	{
+		return __CLASS__;
+	}
 
 }

SwaggerGen/Swagger/Type/IntegerType.php

Indentation +158 added lines, -158 removed lines

@@ -15,163 +15,163 @@
 class IntegerType extends AbstractType
 {
 
-    const REGEX_RANGE = '(?:([[<])(-?\d*)?,(-?\d*)?([\\]>]))?';
-    const REGEX_DEFAULT = '(?:=(-?\d+))?';
-
-    private static $formats = array(
-        'int32' => 'int32',
-        'integer' => 'int32',
-        'int' => 'int32',
-        'int64' => 'int64',
-        'long' => 'int64',
-    );
-    private $format;
-    private $default = null;
-    private $maximum = null;
-    private $exclusiveMaximum = null;
-    private $minimum = null;
-    private $exclusiveMinimum = null;
-    private $enum = array();
-    private $multipleOf = null;
-
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $definition = self::trim($definition);
-
-        $match = array();
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_RANGE . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
-            throw new Exception("Unparseable integer definition: '{$definition}'");
-        }
-
-        $this->parseFormat($definition, $match);
-        $this->parseRange($definition, $match);
-        $this->parseDefault($definition, $match);
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseFormat($definition, $match)
-    {
-        $type = strtolower($match[1]);
-        if (!isset(self::$formats[$type])) {
-            throw new Exception("Not an integer: '{$definition}'");
-        }
-        $this->format = self::$formats[$type];
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseRange($definition, $match)
-    {
-        if (!empty($match[2])) {
-            if ($match[3] === '' && $match[4] === '') {
-                throw new Exception("Empty integer range: '{$definition}'");
-            }
-
-            $this->exclusiveMinimum = $match[2] == '<';
-            $this->minimum = $match[3] === '' ? null : intval($match[3]);
-            $this->maximum = $match[4] === '' ? null : intval($match[4]);
-            $this->exclusiveMaximum = isset($match[5]) ? ($match[5] == '>') : null;
-            if ($this->minimum && $this->maximum && $this->minimum > $this->maximum) {
-                self::swap($this->minimum, $this->maximum);
-                self::swap($this->exclusiveMinimum, $this->exclusiveMaximum);
-            }
-        }
-    }
-
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseDefault($definition, $match)
-    {
-        $this->default = isset($match[6]) && $match[6] !== '' ? $this->validateDefault($match[6]) : null;
-    }
-
-    /**
-     * @param string $command The comment command
-     * @param string $data Any data added after the command
-     * @return AbstractType|boolean
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            case 'default':
-                $this->default = $this->validateDefault($data);
-                return $this;
-
-            case 'enum':
-                $words = self::wordSplit($data);
-                foreach ($words as &$word) {
-                    $word = $this->validateDefault($word);
-                }
-                $this->enum = array_merge($this->enum, $words);
-                return $this;
-
-            case 'step':
-                if (($step = intval($data)) > 0) {
-                    $this->multipleOf = $step;
-                }
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'type' => 'integer',
-            'format' => $this->format,
-            'default' => $this->default,
-            'minimum' => $this->minimum,
-            'exclusiveMinimum' => ($this->exclusiveMinimum && !is_null($this->minimum)) ? true : null,
-            'maximum' => $this->maximum,
-            'exclusiveMaximum' => ($this->exclusiveMaximum && !is_null($this->maximum)) ? true : null,
-            'enum' => $this->enum,
-            'multipleOf' => $this->multipleOf,
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__;
-    }
-
-    /**
-     * @throws Exception
-     */
-    private function validateDefault($value)
-    {
-        if (preg_match('~^-?\d+$~', $value) !== 1) {
-            throw new Exception("Invalid integer default: '{$value}'");
-        }
-
-        if ($this->maximum) {
-            if (($value > $this->maximum) || ($this->exclusiveMaximum && $value == $this->maximum)) {
-                throw new Exception("Default integer beyond maximum: '{$value}'");
-            }
-        }
-        if ($this->minimum) {
-            if (($value < $this->minimum) || ($this->exclusiveMinimum && $value == $this->minimum)) {
-                throw new Exception("Default integer beyond minimum: '{$value}'");
-            }
-        }
-
-        return intval($value);
-    }
+	const REGEX_RANGE = '(?:([[<])(-?\d*)?,(-?\d*)?([\\]>]))?';
+	const REGEX_DEFAULT = '(?:=(-?\d+))?';
+
+	private static $formats = array(
+		'int32' => 'int32',
+		'integer' => 'int32',
+		'int' => 'int32',
+		'int64' => 'int64',
+		'long' => 'int64',
+	);
+	private $format;
+	private $default = null;
+	private $maximum = null;
+	private $exclusiveMaximum = null;
+	private $minimum = null;
+	private $exclusiveMinimum = null;
+	private $enum = array();
+	private $multipleOf = null;
+
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$definition = self::trim($definition);
+
+		$match = array();
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_RANGE . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
+			throw new Exception("Unparseable integer definition: '{$definition}'");
+		}
+
+		$this->parseFormat($definition, $match);
+		$this->parseRange($definition, $match);
+		$this->parseDefault($definition, $match);
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseFormat($definition, $match)
+	{
+		$type = strtolower($match[1]);
+		if (!isset(self::$formats[$type])) {
+			throw new Exception("Not an integer: '{$definition}'");
+		}
+		$this->format = self::$formats[$type];
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseRange($definition, $match)
+	{
+		if (!empty($match[2])) {
+			if ($match[3] === '' && $match[4] === '') {
+				throw new Exception("Empty integer range: '{$definition}'");
+			}
+
+			$this->exclusiveMinimum = $match[2] == '<';
+			$this->minimum = $match[3] === '' ? null : intval($match[3]);
+			$this->maximum = $match[4] === '' ? null : intval($match[4]);
+			$this->exclusiveMaximum = isset($match[5]) ? ($match[5] == '>') : null;
+			if ($this->minimum && $this->maximum && $this->minimum > $this->maximum) {
+				self::swap($this->minimum, $this->maximum);
+				self::swap($this->exclusiveMinimum, $this->exclusiveMaximum);
+			}
+		}
+	}
+
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseDefault($definition, $match)
+	{
+		$this->default = isset($match[6]) && $match[6] !== '' ? $this->validateDefault($match[6]) : null;
+	}
+
+	/**
+	 * @param string $command The comment command
+	 * @param string $data Any data added after the command
+	 * @return AbstractType|boolean
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			case 'default':
+				$this->default = $this->validateDefault($data);
+				return $this;
+
+			case 'enum':
+				$words = self::wordSplit($data);
+				foreach ($words as &$word) {
+					$word = $this->validateDefault($word);
+				}
+				$this->enum = array_merge($this->enum, $words);
+				return $this;
+
+			case 'step':
+				if (($step = intval($data)) > 0) {
+					$this->multipleOf = $step;
+				}
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'type' => 'integer',
+			'format' => $this->format,
+			'default' => $this->default,
+			'minimum' => $this->minimum,
+			'exclusiveMinimum' => ($this->exclusiveMinimum && !is_null($this->minimum)) ? true : null,
+			'maximum' => $this->maximum,
+			'exclusiveMaximum' => ($this->exclusiveMaximum && !is_null($this->maximum)) ? true : null,
+			'enum' => $this->enum,
+			'multipleOf' => $this->multipleOf,
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__;
+	}
+
+	/**
+	 * @throws Exception
+	 */
+	private function validateDefault($value)
+	{
+		if (preg_match('~^-?\d+$~', $value) !== 1) {
+			throw new Exception("Invalid integer default: '{$value}'");
+		}
+
+		if ($this->maximum) {
+			if (($value > $this->maximum) || ($this->exclusiveMaximum && $value == $this->maximum)) {
+				throw new Exception("Default integer beyond maximum: '{$value}'");
+			}
+		}
+		if ($this->minimum) {
+			if (($value < $this->minimum) || ($this->exclusiveMinimum && $value == $this->minimum)) {
+				throw new Exception("Default integer beyond minimum: '{$value}'");
+			}
+		}
+
+		return intval($value);
+	}
 
 }

SwaggerGen/Swagger/Type/AbstractType.php

Indentation +188 added lines, -188 removed lines

@@ -16,193 +16,193 @@
 abstract class AbstractType extends AbstractObject
 {
 
-    const REGEX_START = '/^';
-    const REGEX_FORMAT = '([a-z][a-z0-9]*)';
-    const REGEX_CONTENT = '(?:\((.*)\))?';
-    const REGEX_RANGE = '(?:([[<])(\\d*),(\\d*)([\\]>]))?';
-    const REGEX_DEFAULT = '(?:=(.+))?';
-    const REGEX_END = '$/i';
-
-    private static $classTypes = array(
-        'integer' => 'Integer',
-        'int' => 'Integer',
-        'int32' => 'Integer',
-        'int64' => 'Integer',
-        'long' => 'Integer',
-        'float' => 'Number',
-        'double' => 'Number',
-        'string' => 'String',
-        'uuid' => 'StringUuid',
-        'byte' => 'String',
-        'binary' => 'String',
-        'password' => 'String',
-        'enum' => 'String',
-        'boolean' => 'Boolean',
-        'bool' => 'Boolean',
-        'array' => 'Array',
-        'csv' => 'Array',
-        'ssv' => 'Array',
-        'tsv' => 'Array',
-        'pipes' => 'Array',
-        'date' => 'Date',
-        'datetime' => 'Date',
-        'date-time' => 'Date',
-        'object' => 'Object',
-        'refobject' => 'ReferenceObject',
-        'allof' => 'AllOf',
-    );
-
-    private $example = null;
-
-    /**
-     * Swap values of two variables.
-     * Used for sorting.
-     * @param mixed $a
-     * @param mixed $b
-     */
-    protected static function swap(&$a, &$b)
-    {
-        $tmp = $a;
-        $a = $b;
-        $b = $tmp;
-    }
-
-    /**
-     * @param string $list
-     * @return array
-     */
-    protected static function parseList($list)
-    {
-        $ret = array();
-        while ($item = self::parseListItem($list)) {
-            $ret[] = $item;
-        }
-        return $ret;
-    }
-
-    /**
-     * Extract an item from a comma-separated list of items.
-     *
-     * i.e. `a(x(x,x)),b(x)` returns `a(x(x,x))` and changes `$list` into `b(x)`.
-     * Note: brace nesting is not checked, e.g. `a{b(})` is a valid list item.
-     *
-     * @param string $list the list to parse
-     * @return string the extracted item
-     */
-    protected static function parseListItem(&$list)
-    {
-        $item = '';
-
-        $depth = 0;
-        $index = 0;
-        while ($index < strlen($list)) {
-            $c = $list[$index++];
-
-            if (strpos('{([<', $c) !== false) {
-                ++$depth;
-            } elseif (strpos('})]>', $c) !== false) {
-                --$depth;
-            } elseif ($c === ',' && $depth === 0) {
-                break;
-            }
-
-            $item .= $c;
-        }
-        $list = substr($list, $index);
-
-        return $item;
-    }
-
-    /**
-     * @param AbstractObject $parent
-     * @param $definition
-     * @constructor
-     */
-    public function __construct(AbstractObject $parent, $definition)
-    {
-        parent::__construct($parent);
-
-        $this->parseDefinition($definition);
-    }
-
-    abstract protected function parseDefinition($definition);
-
-    /**
-     * Overwrites default AbstractObject parser, since Types should not handle
-     * extensions themselves.
-     *
-     * @param string $command
-     * @param string $data
-     * @return AbstractType|boolean
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        if (strtolower($command) === 'example') {
-            if ($data === '') {
-                throw new Exception("Missing content for type example");
-            }
-            $json = preg_replace_callback('/([^{}:,]+)/', function ($match) {
-                json_decode($match[1]);
-                return json_last_error() === JSON_ERROR_NONE ? $match[1] : json_encode($match[1]);
-            }, trim($data));
-            $this->example = json_decode($json, true);
-
-            // In case input contains special chars, the above preg_replace would fail
-            //   Input could be a well-formed json already though
-            if ($this->example === null) {
-                $this->example = json_decode($data, true);
-            }
-            // If all fails, use input as-is
-            if ($this->example === null) {
-                $this->example = $data;
-            }
-
-            return $this;
-        }
-
-        return false;
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'example' => $this->example,
-        ), parent::toArray()));
-    }
-
-    /**
-     * @param AbstractObject $parent
-     * @param string $definition
-     * @param string $error
-     * @return self
-     * @throws Exception
-     */
-    public static function typeFactory($parent, $definition, $error = "Unparseable schema type definition: '%s'")
-    {
-        // Parse regex
-        $match = array();
-        if (preg_match('/^([a-z]+)/i', $definition, $match) === 1) {
-            $format = strtolower($match[1]);
-        } elseif (preg_match('/^(\[)(?:.*?)\]$/i', $definition, $match) === 1) {
-            $format = 'array';
-        } elseif (preg_match('/^(\{)(?:.*?)\}$/i', $definition, $match) === 1) {
-            $format = 'object';
-        } else {
-            throw new Exception(sprintf($error, $definition));
-        }
-
-        // Internal type if type known and not overwritten by definition
-        if ($parent->getTypeRegistry()->has($format)) {
-            $class = $parent->getTypeRegistry()->get($format);
-            return new $class($parent, $definition);
-        } elseif (isset(self::$classTypes[$format])) {
-            $type = self::$classTypes[$format];
-            $class = "\\SwaggerGen\\Swagger\\Type\\{$type}Type";
-            return new $class($parent, $definition);
-        } else {
-            return new ReferenceObjectType($parent, $definition);
-        }
-    }
+	const REGEX_START = '/^';
+	const REGEX_FORMAT = '([a-z][a-z0-9]*)';
+	const REGEX_CONTENT = '(?:\((.*)\))?';
+	const REGEX_RANGE = '(?:([[<])(\\d*),(\\d*)([\\]>]))?';
+	const REGEX_DEFAULT = '(?:=(.+))?';
+	const REGEX_END = '$/i';
+
+	private static $classTypes = array(
+		'integer' => 'Integer',
+		'int' => 'Integer',
+		'int32' => 'Integer',
+		'int64' => 'Integer',
+		'long' => 'Integer',
+		'float' => 'Number',
+		'double' => 'Number',
+		'string' => 'String',
+		'uuid' => 'StringUuid',
+		'byte' => 'String',
+		'binary' => 'String',
+		'password' => 'String',
+		'enum' => 'String',
+		'boolean' => 'Boolean',
+		'bool' => 'Boolean',
+		'array' => 'Array',
+		'csv' => 'Array',
+		'ssv' => 'Array',
+		'tsv' => 'Array',
+		'pipes' => 'Array',
+		'date' => 'Date',
+		'datetime' => 'Date',
+		'date-time' => 'Date',
+		'object' => 'Object',
+		'refobject' => 'ReferenceObject',
+		'allof' => 'AllOf',
+	);
+
+	private $example = null;
+
+	/**
+	 * Swap values of two variables.
+	 * Used for sorting.
+	 * @param mixed $a
+	 * @param mixed $b
+	 */
+	protected static function swap(&$a, &$b)
+	{
+		$tmp = $a;
+		$a = $b;
+		$b = $tmp;
+	}
+
+	/**
+	 * @param string $list
+	 * @return array
+	 */
+	protected static function parseList($list)
+	{
+		$ret = array();
+		while ($item = self::parseListItem($list)) {
+			$ret[] = $item;
+		}
+		return $ret;
+	}
+
+	/**
+	 * Extract an item from a comma-separated list of items.
+	 *
+	 * i.e. `a(x(x,x)),b(x)` returns `a(x(x,x))` and changes `$list` into `b(x)`.
+	 * Note: brace nesting is not checked, e.g. `a{b(})` is a valid list item.
+	 *
+	 * @param string $list the list to parse
+	 * @return string the extracted item
+	 */
+	protected static function parseListItem(&$list)
+	{
+		$item = '';
+
+		$depth = 0;
+		$index = 0;
+		while ($index < strlen($list)) {
+			$c = $list[$index++];
+
+			if (strpos('{([<', $c) !== false) {
+				++$depth;
+			} elseif (strpos('})]>', $c) !== false) {
+				--$depth;
+			} elseif ($c === ',' && $depth === 0) {
+				break;
+			}
+
+			$item .= $c;
+		}
+		$list = substr($list, $index);
+
+		return $item;
+	}
+
+	/**
+	 * @param AbstractObject $parent
+	 * @param $definition
+	 * @constructor
+	 */
+	public function __construct(AbstractObject $parent, $definition)
+	{
+		parent::__construct($parent);
+
+		$this->parseDefinition($definition);
+	}
+
+	abstract protected function parseDefinition($definition);
+
+	/**
+	 * Overwrites default AbstractObject parser, since Types should not handle
+	 * extensions themselves.
+	 *
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractType|boolean
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		if (strtolower($command) === 'example') {
+			if ($data === '') {
+				throw new Exception("Missing content for type example");
+			}
+			$json = preg_replace_callback('/([^{}:,]+)/', function ($match) {
+				json_decode($match[1]);
+				return json_last_error() === JSON_ERROR_NONE ? $match[1] : json_encode($match[1]);
+			}, trim($data));
+			$this->example = json_decode($json, true);
+
+			// In case input contains special chars, the above preg_replace would fail
+			//   Input could be a well-formed json already though
+			if ($this->example === null) {
+				$this->example = json_decode($data, true);
+			}
+			// If all fails, use input as-is
+			if ($this->example === null) {
+				$this->example = $data;
+			}
+
+			return $this;
+		}
+
+		return false;
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'example' => $this->example,
+		), parent::toArray()));
+	}
+
+	/**
+	 * @param AbstractObject $parent
+	 * @param string $definition
+	 * @param string $error
+	 * @return self
+	 * @throws Exception
+	 */
+	public static function typeFactory($parent, $definition, $error = "Unparseable schema type definition: '%s'")
+	{
+		// Parse regex
+		$match = array();
+		if (preg_match('/^([a-z]+)/i', $definition, $match) === 1) {
+			$format = strtolower($match[1]);
+		} elseif (preg_match('/^(\[)(?:.*?)\]$/i', $definition, $match) === 1) {
+			$format = 'array';
+		} elseif (preg_match('/^(\{)(?:.*?)\}$/i', $definition, $match) === 1) {
+			$format = 'object';
+		} else {
+			throw new Exception(sprintf($error, $definition));
+		}
+
+		// Internal type if type known and not overwritten by definition
+		if ($parent->getTypeRegistry()->has($format)) {
+			$class = $parent->getTypeRegistry()->get($format);
+			return new $class($parent, $definition);
+		} elseif (isset(self::$classTypes[$format])) {
+			$type = self::$classTypes[$format];
+			$class = "\\SwaggerGen\\Swagger\\Type\\{$type}Type";
+			return new $class($parent, $definition);
+		} else {
+			return new ReferenceObjectType($parent, $definition);
+		}
+	}
 
 }

SwaggerGen/Swagger/Type/Custom/MacType.php

Indentation +72 added lines, -72 removed lines

@@ -17,77 +17,77 @@
 class MacType extends StringType implements ICustomType
 {
 
-    const PATTERN = '^([0-9A-F]){2}(:[0-9A-F]{2}){5}$';
-
-    /**
-     * List of formats recognized by this class
-     * @var string[]
-     */
-    private static $formats = array('mac');
-
-    /**
-     * Construct and set up the regular expression for this type
-     *
-     * @param AbstractObject $parent
-     * @param string $definition
-     */
-    public function __construct(AbstractObject $parent, $definition)
-    {
-        $this->pattern = self::PATTERN;
-
-        parent::__construct($parent, $definition);
-    }
-
-    /**
-     * Parse a type definition string, assuming it belongs to this type
-     *
-     * @param string $definition
-     * @throws Exception
-     */
-    protected function parseDefinition($definition)
-    {
-        $definition = self::trim($definition);
-
-        $match = array();
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
-            throw new Exception("Unparseable MAC definition: '{$definition}'");
-        }
-
-        if (!in_array(strtolower($match[1]), self::$formats)) {
-            throw new Exception("Not a MAC: '{$definition}'");
-        }
-
-        $this->default = isset($match[2]) && $match[2] !== '' ? $this->validateDefault($match[2]) : null;
-    }
-
-    /**
-     * Check (and optionally reformat) a default value
-     *
-     * @param string $value
-     * @return string
-     * @throws Exception
-     */
-    protected function validateDefault($value)
-    {
-        if (empty($value)) {
-            throw new Exception("Empty MAC default");
-        }
-
-        if (preg_match('/^([0-9A-F]){2}(:[0-9A-F]{2}){5}$/', $value) !== 1) {
-            throw new Exception("Invalid MAC default value: '{$value}'");
-        }
-
-        return $value;
-    }
-
-    public static function getFormats()
-    {
-        return self::$formats;
-    }
-
-    public static function setFormats(array $formats)
-    {
-        self::$formats = $formats;
-    }
+	const PATTERN = '^([0-9A-F]){2}(:[0-9A-F]{2}){5}$';
+
+	/**
+	 * List of formats recognized by this class
+	 * @var string[]
+	 */
+	private static $formats = array('mac');
+
+	/**
+	 * Construct and set up the regular expression for this type
+	 *
+	 * @param AbstractObject $parent
+	 * @param string $definition
+	 */
+	public function __construct(AbstractObject $parent, $definition)
+	{
+		$this->pattern = self::PATTERN;
+
+		parent::__construct($parent, $definition);
+	}
+
+	/**
+	 * Parse a type definition string, assuming it belongs to this type
+	 *
+	 * @param string $definition
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition)
+	{
+		$definition = self::trim($definition);
+
+		$match = array();
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
+			throw new Exception("Unparseable MAC definition: '{$definition}'");
+		}
+
+		if (!in_array(strtolower($match[1]), self::$formats)) {
+			throw new Exception("Not a MAC: '{$definition}'");
+		}
+
+		$this->default = isset($match[2]) && $match[2] !== '' ? $this->validateDefault($match[2]) : null;
+	}
+
+	/**
+	 * Check (and optionally reformat) a default value
+	 *
+	 * @param string $value
+	 * @return string
+	 * @throws Exception
+	 */
+	protected function validateDefault($value)
+	{
+		if (empty($value)) {
+			throw new Exception("Empty MAC default");
+		}
+
+		if (preg_match('/^([0-9A-F]){2}(:[0-9A-F]{2}){5}$/', $value) !== 1) {
+			throw new Exception("Invalid MAC default value: '{$value}'");
+		}
+
+		return $value;
+	}
+
+	public static function getFormats()
+	{
+		return self::$formats;
+	}
+
+	public static function setFormats(array $formats)
+	{
+		self::$formats = $formats;
+	}
 
 }