vanderlee / PHPSwaggerGen

SwaggerGen/Swagger/Path.php

Indentation +97 added lines, -97 removed lines

@@ -16,102 +16,102 @@
 class Path extends AbstractObject
 {
 
-    private static $methods = array(
-        'get',
-        'put',
-        'post',
-        'delete',
-        'options',
-        'head',
-        'patch',
-    );
-
-    /**
-     * @var Operation[] $operation
-     */
-    private $operations = [];
-
-    /**
-     * @var Tag|null $tag ;
-     */
-    private $tag;
-
-    public function __construct(AbstractObject $parent, ?Tag $Tag = null)
-    {
-        parent::__construct($parent);
-        $this->tag = $Tag;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            case 'method': // alias
-            case 'operation':
-                $method = strtolower(self::wordShift($data));
-
-                if (!in_array($method, self::$methods)) {
-                    throw new Exception('Unrecognized operation method \'' . $method . '\'');
-                }
-
-                if (isset($this->operations[$method])) {
-                    $Operation = $this->operations[$method];
-                } else {
-                    $summary = $data;
-                    $Operation = new Operation($this, $summary, $this->tag);
-                    $this->operations[$method] = $Operation;
-                }
-
-                return $Operation;
-
-            case 'description':
-                if ($this->tag) {
-                    return $this->tag->handleCommand($command, $data);
-                }
-                break;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray(): array
-    {
-        $methods = self::$methods;
-        uksort($this->operations, static function ($a, $b) use ($methods) {
-            return array_search($a, $methods, true) - array_search($b, $methods, true);
-        });
-
-        return self::arrayFilterNull(array_merge(
-            self::objectsToArray($this->operations)
-            , parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        end($this->operations);
-        return __CLASS__ . ' ' . key($this->operations);
-    }
-
-    /**
-     * Check if an operation with the given id is registered to this Path.
-     *
-     * @param string $operationId
-     * @return boolean
-     */
-    public function hasOperationId($operationId): bool
-    {
-        foreach ($this->operations as $operation) {
-            if ($operation->getId() === $operationId) {
-                return true;
-            }
-        }
-
-        return false;
-    }
+	private static $methods = array(
+		'get',
+		'put',
+		'post',
+		'delete',
+		'options',
+		'head',
+		'patch',
+	);
+
+	/**
+	 * @var Operation[] $operation
+	 */
+	private $operations = [];
+
+	/**
+	 * @var Tag|null $tag ;
+	 */
+	private $tag;
+
+	public function __construct(AbstractObject $parent, ?Tag $Tag = null)
+	{
+		parent::__construct($parent);
+		$this->tag = $Tag;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			case 'method': // alias
+			case 'operation':
+				$method = strtolower(self::wordShift($data));
+
+				if (!in_array($method, self::$methods)) {
+					throw new Exception('Unrecognized operation method \'' . $method . '\'');
+				}
+
+				if (isset($this->operations[$method])) {
+					$Operation = $this->operations[$method];
+				} else {
+					$summary = $data;
+					$Operation = new Operation($this, $summary, $this->tag);
+					$this->operations[$method] = $Operation;
+				}
+
+				return $Operation;
+
+			case 'description':
+				if ($this->tag) {
+					return $this->tag->handleCommand($command, $data);
+				}
+				break;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray(): array
+	{
+		$methods = self::$methods;
+		uksort($this->operations, static function ($a, $b) use ($methods) {
+			return array_search($a, $methods, true) - array_search($b, $methods, true);
+		});
+
+		return self::arrayFilterNull(array_merge(
+			self::objectsToArray($this->operations)
+			, parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		end($this->operations);
+		return __CLASS__ . ' ' . key($this->operations);
+	}
+
+	/**
+	 * Check if an operation with the given id is registered to this Path.
+	 *
+	 * @param string $operationId
+	 * @return boolean
+	 */
+	public function hasOperationId($operationId): bool
+	{
+		foreach ($this->operations as $operation) {
+			if ($operation->getId() === $operationId) {
+				return true;
+			}
+		}
+
+		return false;
+	}
 
 }

Spacing +1 added lines, -1 removed lines

@@ -82,7 +82,7 @@
     public function toArray(): array
     {
         $methods = self::$methods;
-        uksort($this->operations, static function ($a, $b) use ($methods) {
+        uksort($this->operations, static function($a, $b) use ($methods) {
             return array_search($a, $methods, true) - array_search($b, $methods, true);
         });
 

SwaggerGen/Swagger/Schema.php

Indentation +83 added lines, -83 removed lines

@@ -17,88 +17,88 @@
 class Schema extends AbstractDocumentableObject implements IDefinition
 {
 
-    /**
-     * @var string
-     */
-    private $description;
-
-    /**
-     * @var string
-     */
-    private $title;
-
-    /**
-     * @var bool
-     */
-    private $readOnly;
-
-    /**
-     * @var AbstractType
-     */
-    private $type;
-
-    /**
-     * @param string $description
-     * @throws Exception
-     */
-    public function __construct(AbstractObject $parent, $definition = 'object', $description = null)
-    {
-        parent::__construct($parent);
-
-        // Check if definition set
-        if ($this->getSwagger()->hasDefinition($definition)) {
-            $this->type = new Type\ReferenceObjectType($this, $definition);
-        } else {
-            $this->type = Type\AbstractType::typeFactory($this, $definition);
-        }
-
-        $this->description = $description;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        // Pass through to Type
-        if ($this->type && $this->type->handleCommand($command, $data)) {
-            return $this;
-        }
-
-        // handle all the rest manually
-        switch (strtolower($command)) {
-            case 'description':
-                $this->description = $data;
-                return $this;
-
-            case 'title':
-                $this->title = $data;
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray(): array
-    {
-        return self::arrayFilterNull(array_merge($this->type->toArray(), array(
-            'title' => empty($this->title) ? null : $this->title,
-            'description' => empty($this->description) ? null : $this->description,
-            'readOnly' => $this->readOnly
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__;
-    }
-
-    public function setReadOnly(): void
-    {
-        $this->readOnly = true;
-    }
+	/**
+	 * @var string
+	 */
+	private $description;
+
+	/**
+	 * @var string
+	 */
+	private $title;
+
+	/**
+	 * @var bool
+	 */
+	private $readOnly;
+
+	/**
+	 * @var AbstractType
+	 */
+	private $type;
+
+	/**
+	 * @param string $description
+	 * @throws Exception
+	 */
+	public function __construct(AbstractObject $parent, $definition = 'object', $description = null)
+	{
+		parent::__construct($parent);
+
+		// Check if definition set
+		if ($this->getSwagger()->hasDefinition($definition)) {
+			$this->type = new Type\ReferenceObjectType($this, $definition);
+		} else {
+			$this->type = Type\AbstractType::typeFactory($this, $definition);
+		}
+
+		$this->description = $description;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		// Pass through to Type
+		if ($this->type && $this->type->handleCommand($command, $data)) {
+			return $this;
+		}
+
+		// handle all the rest manually
+		switch (strtolower($command)) {
+			case 'description':
+				$this->description = $data;
+				return $this;
+
+			case 'title':
+				$this->title = $data;
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray(): array
+	{
+		return self::arrayFilterNull(array_merge($this->type->toArray(), array(
+			'title' => empty($this->title) ? null : $this->title,
+			'description' => empty($this->description) ? null : $this->description,
+			'readOnly' => $this->readOnly
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__;
+	}
+
+	public function setReadOnly(): void
+	{
+		$this->readOnly = true;
+	}
 
 }

SwaggerGen/Swagger/Operation.php

Indentation +225 added lines, -225 removed lines

@@ -16,230 +16,230 @@
 class Operation extends AbstractDocumentableObject
 {
 
-    private $tags = [];
-    private $summary;
-    private $description;
-    private $consumes = [];
-    private $produces = [];
-
-    /**
-     * @var IParameter[]
-     */
-    private $parameters = [];
-    private $responses = [];
-    private $schemes = [];
-    private $deprecated = false;
-    private $security = [];
-
-    /**
-     * @var string
-     */
-    private $operationId;
-
-    /**
-     * @param string $summary
-     */
-    public function __construct(AbstractObject $parent, $summary = null, ?Tag $tag = null)
-    {
-        parent::__construct($parent);
-        $this->summary = $summary;
-        if ($tag) {
-            $this->tags[] = $tag->getName();
-        }
-    }
-
-    public function getConsumes(): array
-    {
-        return $this->consumes;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            // string
-            case 'summary':
-            case 'description':
-                $this->$command = $data;
-                return $this;
-
-            // string[]
-            case 'tags':
-            case 'schemes':
-                $this->$command = array_merge($this->$command, self::wordSplit($data));
-                return $this;
-
-            // MIME[]
-            case 'consumes':
-            case 'produces':
-                $this->$command = array_merge($this->$command, self::translateMimeTypes(self::wordSplit($data)));
-                return $this;
-
-            // boolean
-            case 'deprecated':
-                $this->deprecated = true;
-                return $this;
-
-            case 'error':
-                $code = self::wordShift($data);
-                $reasoncode = Response::getCode($code);
-                if ($reasoncode === null) {
-                    throw new Exception("Invalid error code: '$code'");
-                }
-                $description = $data;
-                $Error = new Error($this, $reasoncode, $description);
-                $this->responses[$reasoncode] = $Error;
-                return $Error;
-
-            case 'errors':
-                foreach (self::wordSplit($data) as $code) {
-                    $reasoncode = Response::getCode($code);
-                    if ($reasoncode === null) {
-                        throw new Exception("Invalid error code: '$code'");
-                    }
-                    $this->responses[$reasoncode] = new Error($this, $reasoncode);
-                }
-                return $this;
-
-            case 'path':
-            case 'query':
-            case 'query?':
-            case 'header':
-            case 'header?':
-            case 'form':
-            case 'form?':
-                $in = rtrim($command, '?');
-                $parameter = new Parameter($this, $in, $data, !str_ends_with($command, '?'));
-                $this->parameters[$parameter->getName()] = $parameter;
-                return $parameter;
-
-            case 'body':
-            case 'body?':
-                $parameter = new BodyParameter($this, $data, !str_ends_with($command, '?'));
-                $this->parameters[$parameter->getName()] = $parameter;
-                return $parameter;
-
-            case 'param':
-            case 'parameter':
-                $parameter = new ParameterReference($this, $data);
-                $this->parameters[$parameter->getName()] = $parameter;
-                return $this;
-
-            case 'response':
-                $code = self::wordShift($data);
-                $reasoncode = Response::getCode($code);
-                if ($reasoncode === null) {
-                    $reference = $code;
-                    $code = self::wordShift($data);
-                    $reasoncode = Response::getCode($code);
-                    if ($reasoncode === null) {
-                        throw new Exception("Invalid response code: '$reference'");
-                    }
-                    $this->responses[$reasoncode] = new ResponseReference($this, $reference);
-                    return $this;
-                }
-
-                $definition = self::wordShift($data);
-                $description = $data;
-                $Response = new Response($this, $reasoncode, $definition, $description);
-                $this->responses[$reasoncode] = $Response;
-                return $Response;
-
-            case 'require':
-                $name = self::wordShift($data);
-                if (empty($name)) {
-                    throw new Exception('Empty security requirement name');
-                }
-                $scopes = self::wordSplit($data);
-                sort($scopes);
-                $this->security[] = array(
-                    $name => empty($scopes) ? [] : $scopes,
-                );
-                return $this;
-
-            case 'id':
-                $operationId = self::trim($data);
-                if ($this->getSwagger()->hasOperationId($operationId)) {
-                    throw new Exception("Duplicate operation id '{$operationId}'");
-                }
-                $this->operationId = $operationId;
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    /**
-     * @throws Exception
-     */
-    public function toArray(): array
-    {
-        if (empty($this->responses)) {
-            throw new Exception('No response defined for operation');
-        }
-        ksort($this->responses);
-
-        $tags = array_unique($this->tags);
-        sort($tags);
-
-        $schemes = array_unique($this->schemes);
-        sort($schemes);
-
-        $consumes = array_unique($this->consumes);
-        sort($consumes);
-
-        $produces = array_unique($this->produces);
-        sort($produces);
-
-        foreach ($this->security as $security) {
-            foreach ($security as $name => $scope) {
-                if ($this->getSwagger()->getSecurity($name) === false) {
-                    throw new Exception("Required security scheme not defined: '{$name}'");
-                }
-            }
-        }
-
-        $parameters = $this->parameters ? array_values($this->parameters) : null;
-
-        return self::arrayFilterNull(array_merge(array(
-            'deprecated' => $this->deprecated ? true : null,
-            'tags' => $tags,
-            'summary' => empty($this->summary) ? null : $this->summary,
-            'description' => empty($this->description) ? null : $this->description,
-            'operationId' => $this->operationId,
-            'consumes' => $consumes,
-            'produces' => $produces,
-            'parameters' => $parameters ? self::objectsToArray($parameters) : null,
-            'schemes' => $schemes,
-            'responses' => $this->responses ? self::objectsToArray($this->responses) : null,
-            'security' => $this->security,
-        ), parent::toArray()));
-    }
-
-    /**
-     * Return the operation ID
-     *
-     * @return string|null
-     */
-    public function getId(): ?string
-    {
-        return $this->operationId;
-    }
-
-    public function __toString()
-    {
-        return __CLASS__ . ' ' . $this->summary;
-    }
+	private $tags = [];
+	private $summary;
+	private $description;
+	private $consumes = [];
+	private $produces = [];
+
+	/**
+	 * @var IParameter[]
+	 */
+	private $parameters = [];
+	private $responses = [];
+	private $schemes = [];
+	private $deprecated = false;
+	private $security = [];
+
+	/**
+	 * @var string
+	 */
+	private $operationId;
+
+	/**
+	 * @param string $summary
+	 */
+	public function __construct(AbstractObject $parent, $summary = null, ?Tag $tag = null)
+	{
+		parent::__construct($parent);
+		$this->summary = $summary;
+		if ($tag) {
+			$this->tags[] = $tag->getName();
+		}
+	}
+
+	public function getConsumes(): array
+	{
+		return $this->consumes;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			// string
+			case 'summary':
+			case 'description':
+				$this->$command = $data;
+				return $this;
+
+			// string[]
+			case 'tags':
+			case 'schemes':
+				$this->$command = array_merge($this->$command, self::wordSplit($data));
+				return $this;
+
+			// MIME[]
+			case 'consumes':
+			case 'produces':
+				$this->$command = array_merge($this->$command, self::translateMimeTypes(self::wordSplit($data)));
+				return $this;
+
+			// boolean
+			case 'deprecated':
+				$this->deprecated = true;
+				return $this;
+
+			case 'error':
+				$code = self::wordShift($data);
+				$reasoncode = Response::getCode($code);
+				if ($reasoncode === null) {
+					throw new Exception("Invalid error code: '$code'");
+				}
+				$description = $data;
+				$Error = new Error($this, $reasoncode, $description);
+				$this->responses[$reasoncode] = $Error;
+				return $Error;
+
+			case 'errors':
+				foreach (self::wordSplit($data) as $code) {
+					$reasoncode = Response::getCode($code);
+					if ($reasoncode === null) {
+						throw new Exception("Invalid error code: '$code'");
+					}
+					$this->responses[$reasoncode] = new Error($this, $reasoncode);
+				}
+				return $this;
+
+			case 'path':
+			case 'query':
+			case 'query?':
+			case 'header':
+			case 'header?':
+			case 'form':
+			case 'form?':
+				$in = rtrim($command, '?');
+				$parameter = new Parameter($this, $in, $data, !str_ends_with($command, '?'));
+				$this->parameters[$parameter->getName()] = $parameter;
+				return $parameter;
+
+			case 'body':
+			case 'body?':
+				$parameter = new BodyParameter($this, $data, !str_ends_with($command, '?'));
+				$this->parameters[$parameter->getName()] = $parameter;
+				return $parameter;
+
+			case 'param':
+			case 'parameter':
+				$parameter = new ParameterReference($this, $data);
+				$this->parameters[$parameter->getName()] = $parameter;
+				return $this;
+
+			case 'response':
+				$code = self::wordShift($data);
+				$reasoncode = Response::getCode($code);
+				if ($reasoncode === null) {
+					$reference = $code;
+					$code = self::wordShift($data);
+					$reasoncode = Response::getCode($code);
+					if ($reasoncode === null) {
+						throw new Exception("Invalid response code: '$reference'");
+					}
+					$this->responses[$reasoncode] = new ResponseReference($this, $reference);
+					return $this;
+				}
+
+				$definition = self::wordShift($data);
+				$description = $data;
+				$Response = new Response($this, $reasoncode, $definition, $description);
+				$this->responses[$reasoncode] = $Response;
+				return $Response;
+
+			case 'require':
+				$name = self::wordShift($data);
+				if (empty($name)) {
+					throw new Exception('Empty security requirement name');
+				}
+				$scopes = self::wordSplit($data);
+				sort($scopes);
+				$this->security[] = array(
+					$name => empty($scopes) ? [] : $scopes,
+				);
+				return $this;
+
+			case 'id':
+				$operationId = self::trim($data);
+				if ($this->getSwagger()->hasOperationId($operationId)) {
+					throw new Exception("Duplicate operation id '{$operationId}'");
+				}
+				$this->operationId = $operationId;
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	/**
+	 * @throws Exception
+	 */
+	public function toArray(): array
+	{
+		if (empty($this->responses)) {
+			throw new Exception('No response defined for operation');
+		}
+		ksort($this->responses);
+
+		$tags = array_unique($this->tags);
+		sort($tags);
+
+		$schemes = array_unique($this->schemes);
+		sort($schemes);
+
+		$consumes = array_unique($this->consumes);
+		sort($consumes);
+
+		$produces = array_unique($this->produces);
+		sort($produces);
+
+		foreach ($this->security as $security) {
+			foreach ($security as $name => $scope) {
+				if ($this->getSwagger()->getSecurity($name) === false) {
+					throw new Exception("Required security scheme not defined: '{$name}'");
+				}
+			}
+		}
+
+		$parameters = $this->parameters ? array_values($this->parameters) : null;
+
+		return self::arrayFilterNull(array_merge(array(
+			'deprecated' => $this->deprecated ? true : null,
+			'tags' => $tags,
+			'summary' => empty($this->summary) ? null : $this->summary,
+			'description' => empty($this->description) ? null : $this->description,
+			'operationId' => $this->operationId,
+			'consumes' => $consumes,
+			'produces' => $produces,
+			'parameters' => $parameters ? self::objectsToArray($parameters) : null,
+			'schemes' => $schemes,
+			'responses' => $this->responses ? self::objectsToArray($this->responses) : null,
+			'security' => $this->security,
+		), parent::toArray()));
+	}
+
+	/**
+	 * Return the operation ID
+	 *
+	 * @return string|null
+	 */
+	public function getId(): ?string
+	{
+		return $this->operationId;
+	}
+
+	public function __toString()
+	{
+		return __CLASS__ . ' ' . $this->summary;
+	}
 
 }

SwaggerGen/Swagger/Swagger.php

Indentation +374 added lines, -374 removed lines

@@ -16,379 +16,379 @@
 class Swagger extends AbstractDocumentableObject
 {
 
-    private $swagger = '2.0';
-    private $host;
-    private $basePath;
-
-    /**
-     * @var TypeRegistry
-     */
-    private $typeRegistry;
-
-    /**
-     * @var Info $Info
-     */
-    private $info;
-    private $schemes = [];
-    private $consumes = [];
-    private $produces = [];
-
-    /**
-     * @var Path[] $Paths
-     */
-    private $paths = [];
-
-    /**
-     * @var Schema[] $definitions
-     */
-    private $definitions = [];
-
-    /**
-     * @var IParameter[] $parameters
-     */
-    private $parameters = [];
-
-    /**
-     * @var Response[] $responses
-     */
-    private $responses = [];
-
-    /**
-     * @var Tag[] $Tags
-     */
-    private $tags = [];
-
-    /**
-     * Default tag for new endpoints/operations. Set by the api command.
-     *
-     * @var Tag
-     */
-    private $defaultTag;
-    private $securityDefinitions = [];
-    private $security = [];
-
-    /**
-     * @param string $host
-     * @param string $basePath
-     * @param TypeRegistry $typeRegistry
-     */
-    public function __construct($host = null, $basePath = null, $typeRegistry = null)
-    {
-        parent::__construct();
-
-        $this->host = $host;
-        $this->basePath = $basePath;
-
-        $this->info = new Info($this);
-
-        $this->typeRegistry = $typeRegistry ?: new TypeRegistry;
-    }
-
-    /**
-     * Return all consumes
-     *
-     * @return array
-     * @todo Deprecate in favour of a getConsume($name);
-     */
-    public function getConsumes(): array
-    {
-        return $this->consumes;
-    }
-
-    /**
-     * Return the named security if it exists, otherwise return FALSE
-     *
-     * @param string $name
-     *
-     * @return boolean|SecurityScheme
-     */
-    public function getSecurity($name)
-    {
-        return $this->securityDefinitions[$name] ?? false;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     *
-     * @return AbstractObject|boolean
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            // pass to Info
-            case 'title':
-            case 'description':
-            case 'version':
-            case 'terms': // alias
-            case 'tos': // alias
-            case 'termsofservice':
-            case 'contact':
-            case 'license':
-                return $this->info->handleCommand($command, $data);
-
-            // string[]
-            case 'scheme':
-            case 'schemes':
-                $this->schemes = array_unique(array_merge($this->schemes, self::wordSplit($data)));
-
-                return $this;
-
-            // MIME[]
-            case 'consume':
-            case 'consumes':
-                $this->consumes = array_merge($this->consumes, self::translateMimeTypes(self::wordSplit($data)));
-
-                return $this;
-
-            case 'produce':
-            case 'produces':
-                $this->produces = array_merge($this->produces, self::translateMimeTypes(self::wordSplit($data)));
-
-                return $this;
-
-            case 'model':
-            case 'model!':
-            case 'definition':
-            case 'definition!':
-                $name = self::wordShift($data);
-                if (empty($name)) {
-                    throw new Exception('Missing definition name');
-                }
-                $typeDef = self::wordShift($data);
-                if (empty($typeDef)) {
-                    $typeDef = 'object';
-                }
-
-                $definition = new Schema($this, $typeDef);
-                if (str_ends_with($command, '!')) {
-                    $definition->setReadOnly();
-                }
-                $this->definitions[$name] = $definition;
-
-                return $definition;
-
-            case 'path':
-            case 'query':
-            case 'query?':
-            case 'header':
-            case 'header?':
-            case 'form':
-            case 'form?':
-                $in = rtrim($command, '?');
-                $Parameter = new Parameter($this, $in, $data, !str_ends_with($command, '?'));
-                $this->parameters[$Parameter->getName()] = $Parameter;
-
-                return $Parameter;
-
-            case 'body':
-            case 'body?':
-                $Parameter = new BodyParameter($this, $data, !str_ends_with($command, '?'));
-                $this->parameters[$Parameter->getName()] = $Parameter;
-
-                return $Parameter;
-
-            case 'response':
-                $name = self::wordShift($data);
-                $definition = self::wordShift($data);
-                $description = $data;
-                if (empty($description)) {
-                    throw new Exception('Response definition missing description');
-                }
-                $Response = new Response($this, $name, $definition === 'null' ? null : $definition, $description);
-                $this->responses[$name] = $Response;
-
-                return $Response;
-
-            case 'api': // alias
-            case 'tag':
-                $tagname = self::wordShift($data);
-                if (empty($tagname)) {
-                    throw new Exception('Missing tag name');
-                }
-
-                $Tag = null;
-                foreach ($this->tags as $T) {
-                    if ($T->getName() === $tagname) {
-                        $Tag = $T;
-                        break;
-                    }
-                }
-                if (!$Tag) {
-                    $Tag = new Tag($this, $tagname, $data);
-                    $this->tags[] = $Tag;
-                }
-
-                // backwards compatibility
-                if ($command === 'api') {
-                    $this->defaultTag = $Tag;
-                }
-
-                return $Tag;
-
-            case 'endpoint':
-                $path = self::wordShift($data);
-                if (false === $path) {
-                    $path = '/';
-                } else if ($path[0] !== '/') {
-                    $path = '/' . $path;
-                }
-
-                $Tag = null;
-                if (($tagname = self::wordShift($data)) !== false) {
-                    foreach ($this->tags as $T) {
-                        if (strtolower($T->getName()) === strtolower($tagname)) {
-                            $Tag = $T;
-                            break;
-                        }
-                    }
-                    if (!$Tag) {
-                        $Tag = new Tag($this, $tagname, $data);
-                        $this->tags[] = $Tag;
-                    }
-                }
-
-                if (!isset($this->paths[$path])) {
-                    $this->paths[$path] = new Path($this, $Tag ?: $this->defaultTag);
-                }
-
-                return $this->paths[$path];
-
-            case 'security':
-                $name = self::wordShift($data);
-                if (empty($name)) {
-                    throw new Exception('Missing security name');
-                }
-                $type = self::wordShift($data);
-                if (empty($type)) {
-                    throw new Exception('Missing security type');
-                }
-                $SecurityScheme = new SecurityScheme($this, $type, $data);
-                $this->securityDefinitions[$name] = $SecurityScheme;
-
-                return $SecurityScheme;
-
-            case 'require':
-                $name = self::wordShift($data);
-                if (empty($name)) {
-                    throw new Exception('Missing require name');
-                }
-                $scopes = self::wordSplit($data);
-                sort($scopes);
-                $this->security[] = [
-                    $name => empty($scopes) ? [] : $scopes,
-                ];
-
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    /**
-     * @inheritDoc
-     * @throws Exception
-     * @throws Exception
-     */
-    public function toArray(): array
-    {
-        if (empty($this->paths)) {
-            throw new Exception('No path defined');
-        }
-
-        $schemes = array_unique($this->schemes);
-        sort($schemes);
-
-        $consumes = array_unique($this->consumes);
-        sort($consumes);
-
-        $produces = array_unique($this->produces);
-        sort($produces);
-
-        foreach ($this->security as $security) {
-            foreach ($security as $name => $scopes) {
-                if (!isset($this->securityDefinitions[$name])) {
-                    throw new Exception('Required security scheme not defined: \'' . $name . '\'');
-                }
-            }
-        }
-
-        return self::arrayFilterNull(array_merge([
-            'swagger' => $this->swagger,
-            'info' => $this->info->toArray(),
-            'host' => empty($this->host) ? null : $this->host,
-            'basePath' => empty($this->basePath) ? null : $this->basePath,
-            'consumes' => $consumes,
-            'produces' => $produces,
-            'schemes' => $schemes,
-            'paths' => self::objectsToArray($this->paths),
-            'definitions' => self::objectsToArray($this->definitions),
-            'parameters' => self::objectsToArray($this->parameters),
-            'responses' => self::objectsToArray($this->responses),
-            'securityDefinitions' => self::objectsToArray($this->securityDefinitions),
-            'security' => $this->security,
-            'tags' => self::objectsToArray($this->tags),
-        ], parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__;
-    }
-
-    /**
-     * Check if an operation with the given id exists.
-     *
-     * @param string $operationId
-     *
-     * @return boolean
-     */
-    public function hasOperationId($operationId): bool
-    {
-        foreach ($this->paths as $path) {
-            if ($path->hasOperationId($operationId)) {
-                return true;
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Check if a definition with the given name exists
-     *
-     * @param string $name
-     *
-     * @return boolean
-     */
-    public function hasDefinition($name): bool
-    {
-        return isset($this->definitions[$name]);
-    }
-
-    /**
-     * @inheritDoc
-     */
-    protected function getSwagger(): Swagger
-    {
-        return $this;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    protected function getTypeRegistry(): TypeRegistry
-    {
-        return $this->typeRegistry;
-    }
+	private $swagger = '2.0';
+	private $host;
+	private $basePath;
+
+	/**
+	 * @var TypeRegistry
+	 */
+	private $typeRegistry;
+
+	/**
+	 * @var Info $Info
+	 */
+	private $info;
+	private $schemes = [];
+	private $consumes = [];
+	private $produces = [];
+
+	/**
+	 * @var Path[] $Paths
+	 */
+	private $paths = [];
+
+	/**
+	 * @var Schema[] $definitions
+	 */
+	private $definitions = [];
+
+	/**
+	 * @var IParameter[] $parameters
+	 */
+	private $parameters = [];
+
+	/**
+	 * @var Response[] $responses
+	 */
+	private $responses = [];
+
+	/**
+	 * @var Tag[] $Tags
+	 */
+	private $tags = [];
+
+	/**
+	 * Default tag for new endpoints/operations. Set by the api command.
+	 *
+	 * @var Tag
+	 */
+	private $defaultTag;
+	private $securityDefinitions = [];
+	private $security = [];
+
+	/**
+	 * @param string $host
+	 * @param string $basePath
+	 * @param TypeRegistry $typeRegistry
+	 */
+	public function __construct($host = null, $basePath = null, $typeRegistry = null)
+	{
+		parent::__construct();
+
+		$this->host = $host;
+		$this->basePath = $basePath;
+
+		$this->info = new Info($this);
+
+		$this->typeRegistry = $typeRegistry ?: new TypeRegistry;
+	}
+
+	/**
+	 * Return all consumes
+	 *
+	 * @return array
+	 * @todo Deprecate in favour of a getConsume($name);
+	 */
+	public function getConsumes(): array
+	{
+		return $this->consumes;
+	}
+
+	/**
+	 * Return the named security if it exists, otherwise return FALSE
+	 *
+	 * @param string $name
+	 *
+	 * @return boolean|SecurityScheme
+	 */
+	public function getSecurity($name)
+	{
+		return $this->securityDefinitions[$name] ?? false;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 *
+	 * @return AbstractObject|boolean
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			// pass to Info
+			case 'title':
+			case 'description':
+			case 'version':
+			case 'terms': // alias
+			case 'tos': // alias
+			case 'termsofservice':
+			case 'contact':
+			case 'license':
+				return $this->info->handleCommand($command, $data);
+
+			// string[]
+			case 'scheme':
+			case 'schemes':
+				$this->schemes = array_unique(array_merge($this->schemes, self::wordSplit($data)));
+
+				return $this;
+
+			// MIME[]
+			case 'consume':
+			case 'consumes':
+				$this->consumes = array_merge($this->consumes, self::translateMimeTypes(self::wordSplit($data)));
+
+				return $this;
+
+			case 'produce':
+			case 'produces':
+				$this->produces = array_merge($this->produces, self::translateMimeTypes(self::wordSplit($data)));
+
+				return $this;
+
+			case 'model':
+			case 'model!':
+			case 'definition':
+			case 'definition!':
+				$name = self::wordShift($data);
+				if (empty($name)) {
+					throw new Exception('Missing definition name');
+				}
+				$typeDef = self::wordShift($data);
+				if (empty($typeDef)) {
+					$typeDef = 'object';
+				}
+
+				$definition = new Schema($this, $typeDef);
+				if (str_ends_with($command, '!')) {
+					$definition->setReadOnly();
+				}
+				$this->definitions[$name] = $definition;
+
+				return $definition;
+
+			case 'path':
+			case 'query':
+			case 'query?':
+			case 'header':
+			case 'header?':
+			case 'form':
+			case 'form?':
+				$in = rtrim($command, '?');
+				$Parameter = new Parameter($this, $in, $data, !str_ends_with($command, '?'));
+				$this->parameters[$Parameter->getName()] = $Parameter;
+
+				return $Parameter;
+
+			case 'body':
+			case 'body?':
+				$Parameter = new BodyParameter($this, $data, !str_ends_with($command, '?'));
+				$this->parameters[$Parameter->getName()] = $Parameter;
+
+				return $Parameter;
+
+			case 'response':
+				$name = self::wordShift($data);
+				$definition = self::wordShift($data);
+				$description = $data;
+				if (empty($description)) {
+					throw new Exception('Response definition missing description');
+				}
+				$Response = new Response($this, $name, $definition === 'null' ? null : $definition, $description);
+				$this->responses[$name] = $Response;
+
+				return $Response;
+
+			case 'api': // alias
+			case 'tag':
+				$tagname = self::wordShift($data);
+				if (empty($tagname)) {
+					throw new Exception('Missing tag name');
+				}
+
+				$Tag = null;
+				foreach ($this->tags as $T) {
+					if ($T->getName() === $tagname) {
+						$Tag = $T;
+						break;
+					}
+				}
+				if (!$Tag) {
+					$Tag = new Tag($this, $tagname, $data);
+					$this->tags[] = $Tag;
+				}
+
+				// backwards compatibility
+				if ($command === 'api') {
+					$this->defaultTag = $Tag;
+				}
+
+				return $Tag;
+
+			case 'endpoint':
+				$path = self::wordShift($data);
+				if (false === $path) {
+					$path = '/';
+				} else if ($path[0] !== '/') {
+					$path = '/' . $path;
+				}
+
+				$Tag = null;
+				if (($tagname = self::wordShift($data)) !== false) {
+					foreach ($this->tags as $T) {
+						if (strtolower($T->getName()) === strtolower($tagname)) {
+							$Tag = $T;
+							break;
+						}
+					}
+					if (!$Tag) {
+						$Tag = new Tag($this, $tagname, $data);
+						$this->tags[] = $Tag;
+					}
+				}
+
+				if (!isset($this->paths[$path])) {
+					$this->paths[$path] = new Path($this, $Tag ?: $this->defaultTag);
+				}
+
+				return $this->paths[$path];
+
+			case 'security':
+				$name = self::wordShift($data);
+				if (empty($name)) {
+					throw new Exception('Missing security name');
+				}
+				$type = self::wordShift($data);
+				if (empty($type)) {
+					throw new Exception('Missing security type');
+				}
+				$SecurityScheme = new SecurityScheme($this, $type, $data);
+				$this->securityDefinitions[$name] = $SecurityScheme;
+
+				return $SecurityScheme;
+
+			case 'require':
+				$name = self::wordShift($data);
+				if (empty($name)) {
+					throw new Exception('Missing require name');
+				}
+				$scopes = self::wordSplit($data);
+				sort($scopes);
+				$this->security[] = [
+					$name => empty($scopes) ? [] : $scopes,
+				];
+
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function toArray(): array
+	{
+		if (empty($this->paths)) {
+			throw new Exception('No path defined');
+		}
+
+		$schemes = array_unique($this->schemes);
+		sort($schemes);
+
+		$consumes = array_unique($this->consumes);
+		sort($consumes);
+
+		$produces = array_unique($this->produces);
+		sort($produces);
+
+		foreach ($this->security as $security) {
+			foreach ($security as $name => $scopes) {
+				if (!isset($this->securityDefinitions[$name])) {
+					throw new Exception('Required security scheme not defined: \'' . $name . '\'');
+				}
+			}
+		}
+
+		return self::arrayFilterNull(array_merge([
+			'swagger' => $this->swagger,
+			'info' => $this->info->toArray(),
+			'host' => empty($this->host) ? null : $this->host,
+			'basePath' => empty($this->basePath) ? null : $this->basePath,
+			'consumes' => $consumes,
+			'produces' => $produces,
+			'schemes' => $schemes,
+			'paths' => self::objectsToArray($this->paths),
+			'definitions' => self::objectsToArray($this->definitions),
+			'parameters' => self::objectsToArray($this->parameters),
+			'responses' => self::objectsToArray($this->responses),
+			'securityDefinitions' => self::objectsToArray($this->securityDefinitions),
+			'security' => $this->security,
+			'tags' => self::objectsToArray($this->tags),
+		], parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__;
+	}
+
+	/**
+	 * Check if an operation with the given id exists.
+	 *
+	 * @param string $operationId
+	 *
+	 * @return boolean
+	 */
+	public function hasOperationId($operationId): bool
+	{
+		foreach ($this->paths as $path) {
+			if ($path->hasOperationId($operationId)) {
+				return true;
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Check if a definition with the given name exists
+	 *
+	 * @param string $name
+	 *
+	 * @return boolean
+	 */
+	public function hasDefinition($name): bool
+	{
+		return isset($this->definitions[$name]);
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	protected function getSwagger(): Swagger
+	{
+		return $this;
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	protected function getTypeRegistry(): TypeRegistry
+	{
+		return $this->typeRegistry;
+	}
 
 }

SwaggerGen/Swagger/Type/ReferenceObjectType.php

Indentation +43 added lines, -43 removed lines

@@ -15,48 +15,48 @@
 class ReferenceObjectType extends AbstractType
 {
 
-    private $reference;
-
-    public function toArray(): array
-    {
-        return self::arrayFilterNull(array_merge(array(
-            '$ref' => '#/definitions/' . $this->reference,
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__ . ' ' . $this->reference;
-    }
-
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition): void
-    {
-        $definition = self::trim($definition);
-
-        $match = [];
-        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;
-    }
+	private $reference;
+
+	public function toArray(): array
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'$ref' => '#/definitions/' . $this->reference,
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__ . ' ' . $this->reference;
+	}
+
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition): void
+	{
+		$definition = self::trim($definition);
+
+		$match = [];
+		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;
+	}
 
 }

SwaggerGen/Swagger/Type/ObjectType.php

Indentation +255 added lines, -255 removed lines

@@ -15,286 +15,286 @@
 class ObjectType extends AbstractType
 {
 
-    /** @noinspection PhpRegExpUnsupportedModifierInspection */
-    private const REGEX_OBJECT_CONTENT = '(?:(\{)(.*)\})?';
-    public const REGEX_PROP_START = '/^';
-    private const REGEX_PROP_NAME = '([^?!:]+)';
-    /** @noinspection PhpRegExpUnsupportedModifierInspection */
-    private const REGEX_PROP_REQUIRED = '([\?!])?';
-    private const REGEX_PROP_ASSIGN = ':';
-    private const REGEX_PROP_DEFINITION = '(.+)';
-    /** @noinspection PhpRegExpUnsupportedModifierInspection
-     * @noinspection PhpRegExpInvalidDelimiterInspection
-     */
-    private const REGEX_PROP_ADDITIONAL = '\.\.\.(!|.+)?';
-    public const REGEX_PROP_END = '$/';
+	/** @noinspection PhpRegExpUnsupportedModifierInspection */
+	private const REGEX_OBJECT_CONTENT = '(?:(\{)(.*)\})?';
+	public const REGEX_PROP_START = '/^';
+	private const REGEX_PROP_NAME = '([^?!:]+)';
+	/** @noinspection PhpRegExpUnsupportedModifierInspection */
+	private const REGEX_PROP_REQUIRED = '([\?!])?';
+	private const REGEX_PROP_ASSIGN = ':';
+	private const REGEX_PROP_DEFINITION = '(.+)';
+	/** @noinspection PhpRegExpUnsupportedModifierInspection
+	 * @noinspection PhpRegExpInvalidDelimiterInspection
+	 */
+	private const REGEX_PROP_ADDITIONAL = '\.\.\.(!|.+)?';
+	public const REGEX_PROP_END = '$/';
 
-    private $minProperties;
-    private $maxProperties;
-    private $discriminator;
-    private $additionalProperties;
-    private $required = [];
+	private $minProperties;
+	private $maxProperties;
+	private $discriminator;
+	private $additionalProperties;
+	private $required = [];
 
-    /**
-     * @var Property[]
-     */
-    private $properties = [];
+	/**
+	 * @var Property[]
+	 */
+	private $properties = [];
 
-    /**
-     * @var Property
-     */
-    private $mostRecentProperty;
+	/**
+	 * @var Property
+	 */
+	private $mostRecentProperty;
 
-    /**
-     * @param string $command The comment command
-     * @param string $data Any data added after the command
-     * @return AbstractType|boolean
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            // type name description...
-            case 'additionalproperties':
-                $value = self::wordShift($data);
-                if (is_bool($value)) {
-                    $type = $value;
-                } else if ($value === 'false') {
-                    $type = false;
-                } else if ($value === 'true') {
-                    $type = true;
-                } else {
-                    $type = self::typeFactory($this, $value, "Unparseable additional properties definition: '%s'");
-                }
-                $this->setAdditionalProperties($type);
-                return $this;
-            case 'discriminator':
-                $discriminator = self::wordShift($data);
-                $this->setDiscriminator($discriminator);
-                return $this;
-            case 'property':
-            case 'property?':
-            case 'property!':
-                $definition = self::wordShift($data);
-                if (empty($definition)) {
-                    throw new Exception("Missing property definition");
-                }
+	/**
+	 * @param string $command The comment command
+	 * @param string $data Any data added after the command
+	 * @return AbstractType|boolean
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			// type name description...
+			case 'additionalproperties':
+				$value = self::wordShift($data);
+				if (is_bool($value)) {
+					$type = $value;
+				} else if ($value === 'false') {
+					$type = false;
+				} else if ($value === 'true') {
+					$type = true;
+				} else {
+					$type = self::typeFactory($this, $value, "Unparseable additional properties definition: '%s'");
+				}
+				$this->setAdditionalProperties($type);
+				return $this;
+			case 'discriminator':
+				$discriminator = self::wordShift($data);
+				$this->setDiscriminator($discriminator);
+				return $this;
+			case 'property':
+			case 'property?':
+			case 'property!':
+				$definition = self::wordShift($data);
+				if (empty($definition)) {
+					throw new Exception("Missing property definition");
+				}
 
-                $name = self::wordShift($data);
-                if (empty($name)) {
-                    throw new Exception("Missing property name: '{$definition}'");
-                }
+				$name = self::wordShift($data);
+				if (empty($name)) {
+					throw new Exception("Missing property name: '{$definition}'");
+				}
 
-                $readOnly = null;
-                $required = false;
-                $propertySuffix = substr($command, -1);
-                if ($propertySuffix === '!') {
-                    $readOnly = true;
-                } else if ($propertySuffix !== '?') {
-                    $required = true;
-                }
+				$readOnly = null;
+				$required = false;
+				$propertySuffix = substr($command, -1);
+				if ($propertySuffix === '!') {
+					$readOnly = true;
+				} else if ($propertySuffix !== '?') {
+					$required = true;
+				}
 
-                if (($name === $this->discriminator) && !$required) {
-                    throw new Exception("Discriminator must be a required property, "
-                        . "property '{$name}' is not required");
-                }
+				if (($name === $this->discriminator) && !$required) {
+					throw new Exception("Discriminator must be a required property, "
+						. "property '{$name}' is not required");
+				}
 
-                unset($this->required[$name]);
-                if ($required) {
-                    $this->required[$name] = true;
-                }
+				unset($this->required[$name]);
+				if ($required) {
+					$this->required[$name] = true;
+				}
 
-                $this->mostRecentProperty = new Property($this, $definition, $data, $readOnly);
-                $this->properties[$name] = $this->mostRecentProperty;
-                return $this;
+				$this->mostRecentProperty = new Property($this, $definition, $data, $readOnly);
+				$this->properties[$name] = $this->mostRecentProperty;
+				return $this;
 
-            case 'min':
-                $this->minProperties = (int)$data;
-                if ($this->minProperties < 0) {
-                    throw new Exception("Minimum less than zero: '{$data}'");
-                }
-                if ($this->maxProperties !== null && $this->minProperties > $this->maxProperties) {
-                    throw new Exception("Minimum greater than maximum: '{$data}'");
-                }
-                $this->minProperties = (int)$data;
-                return $this;
+			case 'min':
+				$this->minProperties = (int)$data;
+				if ($this->minProperties < 0) {
+					throw new Exception("Minimum less than zero: '{$data}'");
+				}
+				if ($this->maxProperties !== null && $this->minProperties > $this->maxProperties) {
+					throw new Exception("Minimum greater than maximum: '{$data}'");
+				}
+				$this->minProperties = (int)$data;
+				return $this;
 
-            case 'max':
-                $this->maxProperties = (int)$data;
-                if ($this->minProperties !== null && $this->minProperties > $this->maxProperties) {
-                    throw new Exception("Maximum less than minimum: '{$data}'");
-                }
-                if ($this->maxProperties < 0) {
-                    throw new Exception("Maximum less than zero: '{$data}'");
-                }
-                return $this;
-        }
+			case 'max':
+				$this->maxProperties = (int)$data;
+				if ($this->minProperties !== null && $this->minProperties > $this->maxProperties) {
+					throw new Exception("Maximum less than minimum: '{$data}'");
+				}
+				if ($this->maxProperties < 0) {
+					throw new Exception("Maximum less than zero: '{$data}'");
+				}
+				return $this;
+		}
 
-        // Pass through to most recent Property
-        if ($this->mostRecentProperty && $this->mostRecentProperty->handleCommand($command, $data)) {
-            return $this;
-        }
+		// Pass through to most recent Property
+		if ($this->mostRecentProperty && $this->mostRecentProperty->handleCommand($command, $data)) {
+			return $this;
+		}
 
-        return parent::handleCommand($command, $data);
-    }
+		return parent::handleCommand($command, $data);
+	}
 
-    /**
-     * @param AbstractType|bool $type
-     * @return void
-     * @throws Exception
-     */
-    private function setAdditionalProperties($type): void
-    {
-        if ($this->additionalProperties !== null) {
-            throw new Exception('Additional properties may only be set once');
-        }
-        $this->additionalProperties = $type;
-    }
+	/**
+	 * @param AbstractType|bool $type
+	 * @return void
+	 * @throws Exception
+	 */
+	private function setAdditionalProperties($type): void
+	{
+		if ($this->additionalProperties !== null) {
+			throw new Exception('Additional properties may only be set once');
+		}
+		$this->additionalProperties = $type;
+	}
 
-    /**
-     * @param string|false $discriminator
-     * @throws Exception
-     * @throws Exception
-     */
-    private function setDiscriminator($discriminator): void
-    {
-        if (!empty($this->discriminator)) {
-            throw new Exception("Discriminator may only be set once, "
-                . "trying to change it "
-                . "from '{$this->discriminator}' "
-                . "to '{$discriminator}'");
-        }
-        if (isset($this->properties[$discriminator]) && empty($this->required[$discriminator])) {
-            throw new Exception("Discriminator must be a required property, "
-                . "property '{$discriminator}' is not required");
-        }
-        $this->discriminator = $discriminator;
-    }
+	/**
+	 * @param string|false $discriminator
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	private function setDiscriminator($discriminator): void
+	{
+		if (!empty($this->discriminator)) {
+			throw new Exception("Discriminator may only be set once, "
+				. "trying to change it "
+				. "from '{$this->discriminator}' "
+				. "to '{$discriminator}'");
+		}
+		if (isset($this->properties[$discriminator]) && empty($this->required[$discriminator])) {
+			throw new Exception("Discriminator must be a required property, "
+				. "property '{$discriminator}' is not required");
+		}
+		$this->discriminator = $discriminator;
+	}
 
-    public function toArray(): array
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'type' => 'object',
-            'required' => array_keys($this->required),
-            'properties' => self::objectsToArray($this->properties),
-            'minProperties' => $this->minProperties,
-            'maxProperties' => $this->maxProperties,
-            'discriminator' => $this->discriminator,
-            'additionalProperties' => $this->additionalProperties instanceof AbstractType ? $this->additionalProperties->toArray() : $this->additionalProperties,
-        ), parent::toArray()));
-    }
+	public function toArray(): array
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'type' => 'object',
+			'required' => array_keys($this->required),
+			'properties' => self::objectsToArray($this->properties),
+			'minProperties' => $this->minProperties,
+			'maxProperties' => $this->maxProperties,
+			'discriminator' => $this->discriminator,
+			'additionalProperties' => $this->additionalProperties instanceof AbstractType ? $this->additionalProperties->toArray() : $this->additionalProperties,
+		), parent::toArray()));
+	}
 
-    public function __toString()
-    {
-        return __CLASS__;
-    }
+	public function __toString()
+	{
+		return __CLASS__;
+	}
 
-    /**
-     * @throws Exception
-     */
-    protected function parseDefinition($definition): void
-    {
-        $definition = self::trim($definition);
+	/**
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition): void
+	{
+		$definition = self::trim($definition);
 
-        $match = [];
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_CONTENT . self::REGEX_RANGE . self::REGEX_END, $definition, $match) === 1) {
-            $match[1] = strtolower($match[1]);
-        } elseif (preg_match(self::REGEX_START . self::REGEX_OBJECT_CONTENT . self::REGEX_RANGE . self::REGEX_END, $definition, $match) === 1) {
-            $match[1] = 'object';
-        } else {
-            throw new Exception('Unparseable object definition: \'' . $definition . '\'');
-        }
+		$match = [];
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_CONTENT . self::REGEX_RANGE . self::REGEX_END, $definition, $match) === 1) {
+			$match[1] = strtolower($match[1]);
+		} elseif (preg_match(self::REGEX_START . self::REGEX_OBJECT_CONTENT . self::REGEX_RANGE . self::REGEX_END, $definition, $match) === 1) {
+			$match[1] = 'object';
+		} else {
+			throw new Exception('Unparseable object definition: \'' . $definition . '\'');
+		}
 
-        $this->parseFormat($definition, $match);
-        $this->parseProperties($definition, $match);
-        $this->parseRange($definition, $match);
-    }
+		$this->parseFormat($definition, $match);
+		$this->parseProperties($definition, $match);
+		$this->parseRange($definition, $match);
+	}
 
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseFormat($definition, $match): void
-    {
-        if (strtolower($match[1]) !== 'object') {
-            throw new Exception("Not an object: '{$definition}'");
-        }
-    }
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseFormat($definition, $match): void
+	{
+		if (strtolower($match[1]) !== 'object') {
+			throw new Exception("Not an object: '{$definition}'");
+		}
+	}
 
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     * @throws Exception
-     */
-    private function parseProperties($definition, $match): void
-    {
-        if (empty($match[2])) {
-            return;
-        }
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 * @throws Exception
+	 */
+	private function parseProperties($definition, $match): void
+	{
+		if (empty($match[2])) {
+			return;
+		}
 
-        while (($property = self::parseListItem($match[2])) !== '') {
-            $prop_match = [];
-            if (preg_match(self::REGEX_PROP_START . self::REGEX_PROP_ADDITIONAL . self::REGEX_PROP_END, $property, $prop_match) === 1) {
-                if (empty($prop_match[1])) {
-                    $this->setAdditionalProperties(true);
-                } else if ($prop_match[1] === '!') {
-                    $this->setAdditionalProperties(false);
-                } else {
-                    $this->setAdditionalProperties(self::typeFactory($this, $prop_match[1], "Unparseable additional properties definition: '...%s'"));
-                }
-                continue;
-            }
-            if (preg_match(self::REGEX_PROP_START . self::REGEX_PROP_NAME . self::REGEX_PROP_REQUIRED . self::REGEX_PROP_ASSIGN . self::REGEX_PROP_DEFINITION . self::REGEX_PROP_END, $property, $prop_match) !== 1) {
-                throw new Exception("Unparseable property definition: '{$property}'");
-            }
-            $this->properties[$prop_match[1]] = new Property($this, $prop_match[3]);
-            if ($prop_match[2] !== '!' && $prop_match[2] !== '?') {
-                $this->required[$prop_match[1]] = true;
-            }
-        }
+		while (($property = self::parseListItem($match[2])) !== '') {
+			$prop_match = [];
+			if (preg_match(self::REGEX_PROP_START . self::REGEX_PROP_ADDITIONAL . self::REGEX_PROP_END, $property, $prop_match) === 1) {
+				if (empty($prop_match[1])) {
+					$this->setAdditionalProperties(true);
+				} else if ($prop_match[1] === '!') {
+					$this->setAdditionalProperties(false);
+				} else {
+					$this->setAdditionalProperties(self::typeFactory($this, $prop_match[1], "Unparseable additional properties definition: '...%s'"));
+				}
+				continue;
+			}
+			if (preg_match(self::REGEX_PROP_START . self::REGEX_PROP_NAME . self::REGEX_PROP_REQUIRED . self::REGEX_PROP_ASSIGN . self::REGEX_PROP_DEFINITION . self::REGEX_PROP_END, $property, $prop_match) !== 1) {
+				throw new Exception("Unparseable property definition: '{$property}'");
+			}
+			$this->properties[$prop_match[1]] = new Property($this, $prop_match[3]);
+			if ($prop_match[2] !== '!' && $prop_match[2] !== '?') {
+				$this->required[$prop_match[1]] = true;
+			}
+		}
 
-    }
+	}
 
-    /**
-     * @param string $definition
-     * @param string[] $match
-     * @throws Exception
-     */
-    private function parseRange($definition, $match): void
-    {
-        if (!empty($match[3])) {
-            if ($match[4] === '' && $match[5] === '') {
-                throw new Exception("Empty object range: '{$definition}'");
-            }
+	/**
+	 * @param string $definition
+	 * @param string[] $match
+	 * @throws Exception
+	 */
+	private function parseRange($definition, $match): void
+	{
+		if (!empty($match[3])) {
+			if ($match[4] === '' && $match[5] === '') {
+				throw new Exception("Empty object range: '{$definition}'");
+			}
 
-            $exclusiveMinimum = $match[3] === '<';
-            $this->minProperties = $match[4] === '' ? null : (int)$match[4];
-            $this->maxProperties = $match[5] === '' ? null : (int)$match[5];
-            $exclusiveMaximum = isset($match[6]) ? ($match[6] === '>') : null;
-            if ($this->minProperties && $this->maxProperties && $this->minProperties > $this->maxProperties) {
-                self::swap($this->minProperties, $this->maxProperties);
-                self::swap($exclusiveMinimum, $exclusiveMaximum);
-            }
-            $this->minProperties = $this->minProperties === null ? null : max(0, $exclusiveMinimum ? $this->minProperties + 1 : $this->minProperties);
-            $this->maxProperties = $this->maxProperties === null ? null : max(0, $exclusiveMaximum ? $this->maxProperties - 1 : $this->maxProperties);
-        }
-    }
+			$exclusiveMinimum = $match[3] === '<';
+			$this->minProperties = $match[4] === '' ? null : (int)$match[4];
+			$this->maxProperties = $match[5] === '' ? null : (int)$match[5];
+			$exclusiveMaximum = isset($match[6]) ? ($match[6] === '>') : null;
+			if ($this->minProperties && $this->maxProperties && $this->minProperties > $this->maxProperties) {
+				self::swap($this->minProperties, $this->maxProperties);
+				self::swap($exclusiveMinimum, $exclusiveMaximum);
+			}
+			$this->minProperties = $this->minProperties === null ? null : max(0, $exclusiveMinimum ? $this->minProperties + 1 : $this->minProperties);
+			$this->maxProperties = $this->maxProperties === null ? null : max(0, $exclusiveMaximum ? $this->maxProperties - 1 : $this->maxProperties);
+		}
+	}
 
 }

Spacing +5 added lines, -5 removed lines

@@ -120,18 +120,18 @@ 
                 return $this;
 
             case 'min':
-                $this->minProperties = (int)$data;
+                $this->minProperties = (int) $data;
                 if ($this->minProperties < 0) {
                     throw new Exception("Minimum less than zero: '{$data}'");
                 }
                 if ($this->maxProperties !== null && $this->minProperties > $this->maxProperties) {
                     throw new Exception("Minimum greater than maximum: '{$data}'");
                 }
-                $this->minProperties = (int)$data;
+                $this->minProperties = (int) $data;
                 return $this;
 
             case 'max':
-                $this->maxProperties = (int)$data;
+                $this->maxProperties = (int) $data;
                 if ($this->minProperties !== null && $this->minProperties > $this->maxProperties) {
                     throw new Exception("Maximum less than minimum: '{$data}'");
                 }
@@ -285,8 +285,8 @@ 
             }
 
             $exclusiveMinimum = $match[3] === '<';
-            $this->minProperties = $match[4] === '' ? null : (int)$match[4];
-            $this->maxProperties = $match[5] === '' ? null : (int)$match[5];
+            $this->minProperties = $match[4] === '' ? null : (int) $match[4];
+            $this->maxProperties = $match[5] === '' ? null : (int) $match[5];
             $exclusiveMaximum = isset($match[6]) ? ($match[6] === '>') : null;
             if ($this->minProperties && $this->maxProperties && $this->minProperties > $this->maxProperties) {
                 self::swap($this->minProperties, $this->maxProperties);

SwaggerGen/Swagger/Type/AllOfType.php

Indentation +45 added lines, -45 removed lines

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

SwaggerGen/Swagger/Type/Custom/EmailType.php

Indentation +72 added lines, -72 removed lines

@@ -17,77 +17,77 @@
 class EmailType extends StringType implements ICustomType
 {
 
-    public const PATTERN = '\A[a-z0-9!#$%&\'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&\'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\z';
-
-    /**
-     * List of formats recognized by this class
-     * @var string[]
-     */
-    private static $formats = array('email');
-
-    /**
-     * 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);
-    }
-
-    public static function getFormats(): array
-    {
-        return self::$formats;
-    }
-
-    public static function setFormats(array $formats): void
-    {
-        self::$formats = $formats;
-    }
-
-    /**
-     * Parse a type definition string, assuming it belongs to this type
-     *
-     * @param string $definition
-     * @throws Exception
-     */
-    protected function parseDefinition($definition): void
-    {
-        $definition = self::trim($definition);
-
-        $match = [];
-        if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
-            throw new Exception("Unparseable email definition: '{$definition}'");
-        }
-
-        if (!in_array(strtolower($match[1]), self::$formats)) {
-            throw new Exception("Not an email: '{$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): string
-    {
-        if (empty($value)) {
-            throw new Exception("Empty email default");
-        }
-
-        if (filter_var($value, FILTER_VALIDATE_EMAIL) === false) {
-            throw new Exception("Invalid email default value: '{$value}'");
-        }
-
-        return $value;
-    }
+	public const PATTERN = '\A[a-z0-9!#$%&\'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&\'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\z';
+
+	/**
+	 * List of formats recognized by this class
+	 * @var string[]
+	 */
+	private static $formats = array('email');
+
+	/**
+	 * 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);
+	}
+
+	public static function getFormats(): array
+	{
+		return self::$formats;
+	}
+
+	public static function setFormats(array $formats): void
+	{
+		self::$formats = $formats;
+	}
+
+	/**
+	 * Parse a type definition string, assuming it belongs to this type
+	 *
+	 * @param string $definition
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition): void
+	{
+		$definition = self::trim($definition);
+
+		$match = [];
+		if (preg_match(self::REGEX_START . self::REGEX_FORMAT . self::REGEX_DEFAULT . self::REGEX_END, $definition, $match) !== 1) {
+			throw new Exception("Unparseable email definition: '{$definition}'");
+		}
+
+		if (!in_array(strtolower($match[1]), self::$formats)) {
+			throw new Exception("Not an email: '{$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): string
+	{
+		if (empty($value)) {
+			throw new Exception("Empty email default");
+		}
+
+		if (filter_var($value, FILTER_VALIDATE_EMAIL) === false) {
+			throw new Exception("Invalid email default value: '{$value}'");
+		}
+
+		return $value;
+	}
 
 }

SwaggerGen/Swagger/Type/Custom/MacType.php

Indentation +72 added lines, -72 removed lines

@@ -16,77 +16,77 @@
  */
 class MacType extends StringType implements ICustomType
 {
-    public 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);
-    }
-
-    public static function getFormats(): array
-    {
-        return self::$formats;
-    }
-
-    public static function setFormats(array $formats): void
-    {
-        self::$formats = $formats;
-    }
-
-    /**
-     * Parse a type definition string, assuming it belongs to this type
-     *
-     * @param string $definition
-     * @throws Exception
-     */
-    protected function parseDefinition($definition): void
-    {
-        $definition = self::trim($definition);
-
-        $match = [];
-        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): string
-    {
-        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 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);
+	}
+
+	public static function getFormats(): array
+	{
+		return self::$formats;
+	}
+
+	public static function setFormats(array $formats): void
+	{
+		self::$formats = $formats;
+	}
+
+	/**
+	 * Parse a type definition string, assuming it belongs to this type
+	 *
+	 * @param string $definition
+	 * @throws Exception
+	 */
+	protected function parseDefinition($definition): void
+	{
+		$definition = self::trim($definition);
+
+		$match = [];
+		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): string
+	{
+		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;
+	}
 
 }