vanderlee / PHPSwaggerGen

SwaggerGen/Swagger/AbstractObject.php

Spacing +2 added lines, -2 removed lines

@@ -133,7 +133,7 @@ 
      */
     public static function arrayFilterNull($array)
     {
-        return array_filter($array, function ($value) {
+        return array_filter($array, function($value) {
             return $value !== null && $value !== array();
         });
     }
@@ -145,7 +145,7 @@ 
      */
     public static function objectsToArray($array)
     {
-        return array_map(function (AbstractObject $item) {
+        return array_map(function(AbstractObject $item) {
             return $item->toArray();
         }, $array);
     }

Indentation +157 added lines, -157 removed lines

@@ -16,162 +16,162 @@
 abstract class AbstractObject
 {
 
-    private static $mime_types = array(
-        'fileform' => 'multipart/form-data',
-        'form' => 'application/x-www-form-urlencoded',
-        'json' => 'application/json',
-        'text' => 'text/plain',
-        'utf8' => 'text/plain; charset=utf-8',
-        'yml' => 'application/x-yaml',
-        'yaml' => 'application/x-yaml',
-        'php' => 'text/x-php',
-        'xml' => 'text/xml',
-    );
-
-    /**
-     * @var AbstractObject
-     */
-    private $parent;
-
-    /**
-     * Map of extensions and their (trimmed) values
-     * @var string[]
-     */
-    private $extensions = array();
-
-    public function __construct(?AbstractObject $parent = null)
-    {
-        $this->parent = $parent;
-    }
-
-    /**
-     * @return AbstractObject
-     */
-    protected function getParent()
-    {
-        return $this->parent;
-    }
-
-    protected function getParentClass($classname)
-    {
-        if (is_a($this, $classname)) {
-            return $this;
-        }
-        return $this->parent->getParentClass($classname);
-    }
-
-    /**
-     * @return Swagger
-     */
-    protected function getSwagger()
-    {
-        return $this->parent->getSwagger();
-    }
-
-    /**
-     * @return TypeRegistry
-     */
-    protected function getTypeRegistry()
-    {
-        return $this->parent->getTypeRegistry();
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     */
-    public function handleCommand($command, $data = null)
-    {
-        if (strtolower(substr($command, 0, 2)) === 'x-') {
-            $this->extensions[$command] = empty($data) ? $data : trim($data);
-            return $this;
-        }
-
-        return false;
-    }
-
-    /**
-     * @return array
-     */
-    public function toArray()
-    {
-        return $this->extensions;
-    }
-
-    /**
-     * Translate consumes from shortcuts
-     * @param String[] $mimeTypes
-     * @return String[]
-     */
-    protected static function translateMimeTypes($mimeTypes)
-    {
-        foreach ($mimeTypes as &$mimeType) {
-            if (isset(self::$mime_types[strtolower($mimeType)])) {
-                $mimeType = self::$mime_types[strtolower($mimeType)];
-            }
-        }
-
-        return $mimeTypes;
-    }
-
-    /**
-     * Trim whitespace from a multibyte string
-     * @param string $string
-     * @return string
-     */
-    public static function trim($string)
-    {
-        return mb_ereg_replace('^\s*([\s\S]*?)\s*$', '\1', $string);
-    }
-
-    /**
-     * Filter all items from an array where the value is either null or an
-     * empty array.
-     * @param array $array
-     * @return array
-     */
-    public static function arrayFilterNull($array)
-    {
-        return array_filter($array, function ($value) {
-            return $value !== null && $value !== array();
-        });
-    }
-
-    /**
-     * Recursively call toArray() on all objects to return an array
-     * @param array $array
-     * @return array
-     */
-    public static function objectsToArray($array)
-    {
-        return array_map(function (AbstractObject $item) {
-            return $item->toArray();
-        }, $array);
-    }
-
-    /**
-     * Shifts the first word off a text line and returns it
-     * @param string $data
-     * @return string|bool Either the first word or false if no more words available
-     */
-    public static function wordShift(&$data)
-    {
-        if (preg_match('~^\s*(\S+)\s*(.*)$~s', $data, $matches) === 1) {
-            $data = $matches[2];
-            return $matches[1];
-        }
-        return false;
-    }
-
-    /**
-     * Splits a text line in all it's words
-     * @param string $data
-     * @return string[]
-     */
-    public static function wordSplit($data): array
-    {
-        return array_values(preg_grep('~\S~', preg_split('~\s+~', $data)));
-    }
+	private static $mime_types = array(
+		'fileform' => 'multipart/form-data',
+		'form' => 'application/x-www-form-urlencoded',
+		'json' => 'application/json',
+		'text' => 'text/plain',
+		'utf8' => 'text/plain; charset=utf-8',
+		'yml' => 'application/x-yaml',
+		'yaml' => 'application/x-yaml',
+		'php' => 'text/x-php',
+		'xml' => 'text/xml',
+	);
+
+	/**
+	 * @var AbstractObject
+	 */
+	private $parent;
+
+	/**
+	 * Map of extensions and their (trimmed) values
+	 * @var string[]
+	 */
+	private $extensions = array();
+
+	public function __construct(?AbstractObject $parent = null)
+	{
+		$this->parent = $parent;
+	}
+
+	/**
+	 * @return AbstractObject
+	 */
+	protected function getParent()
+	{
+		return $this->parent;
+	}
+
+	protected function getParentClass($classname)
+	{
+		if (is_a($this, $classname)) {
+			return $this;
+		}
+		return $this->parent->getParentClass($classname);
+	}
+
+	/**
+	 * @return Swagger
+	 */
+	protected function getSwagger()
+	{
+		return $this->parent->getSwagger();
+	}
+
+	/**
+	 * @return TypeRegistry
+	 */
+	protected function getTypeRegistry()
+	{
+		return $this->parent->getTypeRegistry();
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		if (strtolower(substr($command, 0, 2)) === 'x-') {
+			$this->extensions[$command] = empty($data) ? $data : trim($data);
+			return $this;
+		}
+
+		return false;
+	}
+
+	/**
+	 * @return array
+	 */
+	public function toArray()
+	{
+		return $this->extensions;
+	}
+
+	/**
+	 * Translate consumes from shortcuts
+	 * @param String[] $mimeTypes
+	 * @return String[]
+	 */
+	protected static function translateMimeTypes($mimeTypes)
+	{
+		foreach ($mimeTypes as &$mimeType) {
+			if (isset(self::$mime_types[strtolower($mimeType)])) {
+				$mimeType = self::$mime_types[strtolower($mimeType)];
+			}
+		}
+
+		return $mimeTypes;
+	}
+
+	/**
+	 * Trim whitespace from a multibyte string
+	 * @param string $string
+	 * @return string
+	 */
+	public static function trim($string)
+	{
+		return mb_ereg_replace('^\s*([\s\S]*?)\s*$', '\1', $string);
+	}
+
+	/**
+	 * Filter all items from an array where the value is either null or an
+	 * empty array.
+	 * @param array $array
+	 * @return array
+	 */
+	public static function arrayFilterNull($array)
+	{
+		return array_filter($array, function ($value) {
+			return $value !== null && $value !== array();
+		});
+	}
+
+	/**
+	 * Recursively call toArray() on all objects to return an array
+	 * @param array $array
+	 * @return array
+	 */
+	public static function objectsToArray($array)
+	{
+		return array_map(function (AbstractObject $item) {
+			return $item->toArray();
+		}, $array);
+	}
+
+	/**
+	 * Shifts the first word off a text line and returns it
+	 * @param string $data
+	 * @return string|bool Either the first word or false if no more words available
+	 */
+	public static function wordShift(&$data)
+	{
+		if (preg_match('~^\s*(\S+)\s*(.*)$~s', $data, $matches) === 1) {
+			$data = $matches[2];
+			return $matches[1];
+		}
+		return false;
+	}
+
+	/**
+	 * Splits a text line in all it's words
+	 * @param string $data
+	 * @return string[]
+	 */
+	public static function wordSplit($data): array
+	{
+		return array_values(preg_grep('~\S~', preg_split('~\s+~', $data)));
+	}
 
 }

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 = null;
-
-    /**
-     * @var bool
-     */
-    private $readOnly = null;
-
-    /**
-     * @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()
-    {
-        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()
-    {
-        $this->readOnly = true;
-    }
+	/**
+	 * @var string
+	 */
+	private $description;
+
+	/**
+	 * @var string
+	 */
+	private $title = null;
+
+	/**
+	 * @var bool
+	 */
+	private $readOnly = null;
+
+	/**
+	 * @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()
+	{
+		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()
+	{
+		$this->readOnly = true;
+	}
 
 }

SwaggerGen/Swagger/Swagger.php

Indentation +378 added lines, -378 removed lines

@@ -16,383 +16,383 @@
 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 = null;
-    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;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    protected function getSwagger()
-    {
-        return $this;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    protected function getTypeRegistry()
-    {
-        return $this->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)
-    {
-        if (isset($this->securityDefinitions[$name])) {
-            return $this->securityDefinitions[$name];
-        }
-
-        return 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 (substr($command, -1) === '!') {
-                    $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, substr($command, -1) !== '?');
-                $this->parameters[$Parameter->getName()] = $Parameter;
-
-                return $Parameter;
-
-            case 'body':
-            case 'body?':
-                $Parameter = new BodyParameter($this, $data, substr($command, -1) !== '?');
-                $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()
-    {
-        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)
-    {
-        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)
-    {
-        return isset($this->definitions[$name]);
-    }
+	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 = null;
+	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;
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	protected function getSwagger()
+	{
+		return $this;
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	protected function getTypeRegistry()
+	{
+		return $this->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)
+	{
+		if (isset($this->securityDefinitions[$name])) {
+			return $this->securityDefinitions[$name];
+		}
+
+		return 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 (substr($command, -1) === '!') {
+					$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, substr($command, -1) !== '?');
+				$this->parameters[$Parameter->getName()] = $Parameter;
+
+				return $Parameter;
+
+			case 'body':
+			case 'body?':
+				$Parameter = new BodyParameter($this, $data, substr($command, -1) !== '?');
+				$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()
+	{
+		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)
+	{
+		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)
+	{
+		return isset($this->definitions[$name]);
+	}
 
 }

SwaggerGen/Swagger/ExternalDocumentation.php

Indentation +39 added lines, -39 removed lines

@@ -14,44 +14,44 @@
 class ExternalDocumentation extends AbstractObject
 {
 
-    private $url;
-    private $description;
-
-    public function __construct(AbstractObject $parent, $url, $description = null)
-    {
-        parent::__construct($parent);
-        $this->url = $url;
-        $this->description = $description;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            case 'url':
-            case 'description':
-                $this->$command = $data;
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'url' => $this->url,
-            'description' => empty($this->description) ? null : $this->description,
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__ . ' ' . $this->url;
-    }
+	private $url;
+	private $description;
+
+	public function __construct(AbstractObject $parent, $url, $description = null)
+	{
+		parent::__construct($parent);
+		$this->url = $url;
+		$this->description = $description;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			case 'url':
+			case 'description':
+				$this->$command = $data;
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'url' => $this->url,
+			'description' => empty($this->description) ? null : $this->description,
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__ . ' ' . $this->url;
+	}
 
 }

SwaggerGen/Swagger/AbstractDocumentableObject.php

Indentation +30 added lines, -30 removed lines

@@ -14,38 +14,38 @@
 abstract class AbstractDocumentableObject extends AbstractObject
 {
 
-    /**
-     * External documentation
-     * @var ExternalDocumentation
-     */
-    private $externalDocs = null;
+	/**
+	 * External documentation
+	 * @var ExternalDocumentation
+	 */
+	private $externalDocs = null;
 
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            case 'doc':
-            case 'docs':
-                $url = self::wordShift($data);
-                $this->externalDocs = new ExternalDocumentation($this, $url, $data);
-                return $this->externalDocs;
-        }
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			case 'doc':
+			case 'docs':
+				$url = self::wordShift($data);
+				$this->externalDocs = new ExternalDocumentation($this, $url, $data);
+				return $this->externalDocs;
+		}
 
-        return parent::handleCommand($command, $data);
-    }
+		return parent::handleCommand($command, $data);
+	}
 
-    /**
-     * @return array
-     */
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'externalDocs' => $this->externalDocs ? $this->externalDocs->toArray() : null,
-        ), parent::toArray()));
-    }
+	/**
+	 * @return array
+	 */
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'externalDocs' => $this->externalDocs ? $this->externalDocs->toArray() : null,
+		), parent::toArray()));
+	}
 
 }

SwaggerGen/Swagger/Header.php

Indentation +38 added lines, -38 removed lines

@@ -15,50 +15,50 @@
 class Header extends AbstractObject
 {
 
-    private $type;
-    private $description;
+	private $type;
+	private $description;
 
-    /**
-     * @throws Exception
-     */
-    public function __construct(AbstractObject $parent, $type, $description = null)
-    {
-        parent::__construct($parent);
+	/**
+	 * @throws Exception
+	 */
+	public function __construct(AbstractObject $parent, $type, $description = null)
+	{
+		parent::__construct($parent);
 
-        $this->type = strtolower($type);
-        if (!in_array($this->type, array('string', 'number', 'integer', 'boolean', 'array'))) {
-            throw new Exception('Header type not valid: \'' . $type . '\'');
-        }
+		$this->type = strtolower($type);
+		if (!in_array($this->type, array('string', 'number', 'integer', 'boolean', 'array'))) {
+			throw new Exception('Header type not valid: \'' . $type . '\'');
+		}
 
-        $this->description = $description;
-    }
+		$this->description = $description;
+	}
 
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     */
-    public function handleCommand($command, $data = null)
-    {
-        if (strtolower($command) === 'description') {
-            $this->description = $data;
-            return $this;
-        }
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		if (strtolower($command) === 'description') {
+			$this->description = $data;
+			return $this;
+		}
 
-        return parent::handleCommand($command, $data);
-    }
+		return parent::handleCommand($command, $data);
+	}
 
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'type' => $this->type,
-            'description' => empty($this->description) ? null : $this->description,
-        ), parent::toArray()));
-    }
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'type' => $this->type,
+			'description' => empty($this->description) ? null : $this->description,
+		), parent::toArray()));
+	}
 
-    public function __toString()
-    {
-        return __CLASS__ . ' ' . $this->type;
-    }
+	public function __toString()
+	{
+		return __CLASS__ . ' ' . $this->type;
+	}
 
 }

SwaggerGen/Swagger/ResponseReference.php

Indentation +20 added lines, -20 removed lines

@@ -13,25 +13,25 @@
 class ResponseReference extends AbstractObject
 {
 
-    private $reference;
-
-    public function __construct(AbstractObject $parent, $reference)
-    {
-        parent::__construct($parent);
-
-        $this->reference = $reference;
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array(
-            '$ref' => '#/responses/' . $this->reference,
-        ));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__ . ' `' . $this->reference . '`';
-    }
+	private $reference;
+
+	public function __construct(AbstractObject $parent, $reference)
+	{
+		parent::__construct($parent);
+
+		$this->reference = $reference;
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array(
+			'$ref' => '#/responses/' . $this->reference,
+		));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__ . ' `' . $this->reference . '`';
+	}
 
 }

SwaggerGen/Swagger/Contact.php

Indentation +44 added lines, -44 removed lines

@@ -14,49 +14,49 @@
 class Contact extends AbstractObject
 {
 
-    private $name;
-    private $url;
-    private $email;
-
-    public function __construct(AbstractObject $parent, $name = null, $url = null, $email = null)
-    {
-        parent::__construct($parent);
-
-        $this->name = empty($name) ? null : $name;
-        $this->url = empty($url) ? null : $url;
-        $this->email = empty($email) ? null : $email;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     */
-    public function handleCommand($command, $data = null)
-    {
-        switch (strtolower($command)) {
-            case 'name':
-            case 'url':
-            case 'email':
-                $this->$command = $data;
-                return $this;
-        }
-
-        return parent::handleCommand($command, $data);
-    }
-
-    public function toArray()
-    {
-        return self::arrayFilterNull(array_merge(array(
-            'name' => $this->name,
-            'url' => $this->url,
-            'email' => $this->email,
-        ), parent::toArray()));
-    }
-
-    public function __toString()
-    {
-        return __CLASS__ . " {$this->name} <{$this->email}>, {$this->url}";
-    }
+	private $name;
+	private $url;
+	private $email;
+
+	public function __construct(AbstractObject $parent, $name = null, $url = null, $email = null)
+	{
+		parent::__construct($parent);
+
+		$this->name = empty($name) ? null : $name;
+		$this->url = empty($url) ? null : $url;
+		$this->email = empty($email) ? null : $email;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		switch (strtolower($command)) {
+			case 'name':
+			case 'url':
+			case 'email':
+				$this->$command = $data;
+				return $this;
+		}
+
+		return parent::handleCommand($command, $data);
+	}
+
+	public function toArray()
+	{
+		return self::arrayFilterNull(array_merge(array(
+			'name' => $this->name,
+			'url' => $this->url,
+			'email' => $this->email,
+		), parent::toArray()));
+	}
+
+	public function __toString()
+	{
+		return __CLASS__ . " {$this->name} <{$this->email}>, {$this->url}";
+	}
 
 }

SwaggerGen/Swagger/Error.php

Indentation +4 added lines, -4 removed lines

@@ -14,9 +14,9 @@
 class Error extends Response
 {
 
-    public function __construct(AbstractObject $parent, $code, $description = null)
-    {
-        parent::__construct($parent, $code, null, $description);
-    }
+	public function __construct(AbstractObject $parent, $code, $description = null)
+	{
+		parent::__construct($parent, $code, null, $description);
+	}
 
 }