vanderlee / PHPSwaggerGen

SwaggerGen/Swagger/AbstractObject.php

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 = [];
-
-    public function __construct(?AbstractObject $parent = null)
-    {
-        $this->parent = $parent;
-    }
-
-    /**
-     * Trim whitespace from a multibyte string
-     * @param string $string
-     * @return string
-     */
-    public static function trim($string): 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): array
-    {
-        return array_filter($array, static function ($value) {
-            return $value !== null && $value !== [];
-        });
-    }
-
-    /**
-     * Recursively call toArray() on all objects to return an array
-     * @param array $array
-     * @return array
-     */
-    public static function objectsToArray($array): array
-    {
-        return array_map(static function (AbstractObject $item) {
-            return $item->toArray();
-        }, $array);
-    }
-
-    /**
-     * @return array
-     */
-    public function toArray(): array
-    {
-        return $this->extensions;
-    }
-
-    /**
-     * 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)));
-    }
-
-    /**
-     * Translate consumes from shortcuts
-     * @param String[] $mimeTypes
-     * @return String[]
-     */
-    protected static function translateMimeTypes($mimeTypes): array
-    {
-        foreach ($mimeTypes as &$mimeType) {
-            if (isset(self::$mime_types[strtolower($mimeType)])) {
-                $mimeType = self::$mime_types[strtolower($mimeType)];
-            }
-        }
-
-        return $mimeTypes;
-    }
-
-    /**
-     * @param string $command
-     * @param string $data
-     * @return AbstractObject|boolean
-     */
-    public function handleCommand($command, $data = null)
-    {
-        if (stripos($command, 'x-') === 0) {
-            $this->extensions[$command] = empty($data) ? $data : trim($data);
-            return $this;
-        }
-
-        return false;
-    }
-
-    /**
-     * @return AbstractObject|null
-     */
-    protected function getParent(): ?AbstractObject
-    {
-        return $this->parent;
-    }
-
-    protected function getParentClass($classname): AbstractObject
-    {
-        if (is_a($this, $classname)) {
-            return $this;
-        }
-        return $this->parent->getParentClass($classname);
-    }
-
-    /**
-     * @return Swagger
-     */
-    protected function getSwagger(): Swagger
-    {
-        return $this->parent->getSwagger();
-    }
-
-    /**
-     * @return TypeRegistry
-     */
-    protected function getTypeRegistry(): TypeRegistry
-    {
-        return $this->parent->getTypeRegistry();
-    }
+	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 = [];
+
+	public function __construct(?AbstractObject $parent = null)
+	{
+		$this->parent = $parent;
+	}
+
+	/**
+	 * Trim whitespace from a multibyte string
+	 * @param string $string
+	 * @return string
+	 */
+	public static function trim($string): 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): array
+	{
+		return array_filter($array, static function ($value) {
+			return $value !== null && $value !== [];
+		});
+	}
+
+	/**
+	 * Recursively call toArray() on all objects to return an array
+	 * @param array $array
+	 * @return array
+	 */
+	public static function objectsToArray($array): array
+	{
+		return array_map(static function (AbstractObject $item) {
+			return $item->toArray();
+		}, $array);
+	}
+
+	/**
+	 * @return array
+	 */
+	public function toArray(): array
+	{
+		return $this->extensions;
+	}
+
+	/**
+	 * 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)));
+	}
+
+	/**
+	 * Translate consumes from shortcuts
+	 * @param String[] $mimeTypes
+	 * @return String[]
+	 */
+	protected static function translateMimeTypes($mimeTypes): array
+	{
+		foreach ($mimeTypes as &$mimeType) {
+			if (isset(self::$mime_types[strtolower($mimeType)])) {
+				$mimeType = self::$mime_types[strtolower($mimeType)];
+			}
+		}
+
+		return $mimeTypes;
+	}
+
+	/**
+	 * @param string $command
+	 * @param string $data
+	 * @return AbstractObject|boolean
+	 */
+	public function handleCommand($command, $data = null)
+	{
+		if (stripos($command, 'x-') === 0) {
+			$this->extensions[$command] = empty($data) ? $data : trim($data);
+			return $this;
+		}
+
+		return false;
+	}
+
+	/**
+	 * @return AbstractObject|null
+	 */
+	protected function getParent(): ?AbstractObject
+	{
+		return $this->parent;
+	}
+
+	protected function getParentClass($classname): AbstractObject
+	{
+		if (is_a($this, $classname)) {
+			return $this;
+		}
+		return $this->parent->getParentClass($classname);
+	}
+
+	/**
+	 * @return Swagger
+	 */
+	protected function getSwagger(): Swagger
+	{
+		return $this->parent->getSwagger();
+	}
+
+	/**
+	 * @return TypeRegistry
+	 */
+	protected function getTypeRegistry(): TypeRegistry
+	{
+		return $this->parent->getTypeRegistry();
+	}
 
 }

Spacing +2 added lines, -2 removed lines

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

SwaggerGen/SwaggerGen.php

Indentation +210 added lines, -210 removed lines

@@ -38,215 +38,215 @@
 class SwaggerGen
 {
 
-    public const FORMAT_ARRAY = '';
-    public const FORMAT_JSON = 'json';
-    public const FORMAT_JSON_PRETTY = 'json+';
-    public const FORMAT_YAML = 'yaml';
-
-    private string $host;
-    private string $basePath;
-    private array $dirs = [];
-    private array $defines = [];
-
-    /**
-     * @var TypeRegistry
-     */
-    private $typeRegistry;
-
-    /**
-     * Create a new SwaggerGen instance
-     *
-     * @param string $host
-     * @param string $basePath
-     * @param string[] $dirs
-     * @param TypeRegistry $typeRegistry
-     */
-    public function __construct($host = '', $basePath = '', $dirs = [], $typeRegistry = null)
-    {
-        $this->host = $host;
-        $this->basePath = $basePath;
-        $this->dirs = $dirs;
-        $this->typeRegistry = $typeRegistry;
-    }
-
-    /**
-     * Set a new type registry
-     *
-     * @param TypeRegistry $typeRegistry
-     */
-    public function setTypeRegistry($typeRegistry = null)
-    {
-        $this->typeRegistry = $typeRegistry;
-    }
-
-    /**
-     * @param string $name
-     */
-    public function define($name, $value = 1)
-    {
-        $this->defines[$name] = $value;
-    }
-
-    /**
-     * @param string $name
-     */
-    public function undefine($name)
-    {
-        unset($this->defines[$name]);
-    }
-
-    /**
-     * Get Swagger 2.x output
-     *
-     * @param string[] $files
-     * @param string[] $dirs
-     * @param string $format
-     * @return array|false|string
-     * @throws Exception
-     * @throws StatementException
-     */
-    public function getSwagger(array $files, array $dirs = [], string $format = self::FORMAT_ARRAY)
-    {
-        $dirs = array_merge($this->dirs, $dirs);
-
-        $statements = [];
-        foreach ($files as $file) {
-            switch (pathinfo($file, PATHINFO_EXTENSION)) {
-                case 'php':
-                    $fileStatements = $this->parsePhpFile($file, $dirs);
-                    break;
-
-                case 'txt':
-                    $fileStatements = $this->parseTextFile($file, $dirs);
-                    break;
-
-                default:
-                    $fileStatements = $this->parseText($file, $dirs);
-                    break;
-            }
-
-            $statements[] = $fileStatements;
-        }
-        $statements = array_merge(...$statements);
-
-        $output = $this->parseStatements($this->host, $this->basePath, $statements)->toArray();
-
-        switch ($format) {
-            case self::FORMAT_JSON:
-                $output = json_encode($output);
-                break;
-
-            case self::FORMAT_JSON_PRETTY:
-                $flags = (defined('JSON_PRETTY_PRINT') ? JSON_PRETTY_PRINT : 0); // Since PHP 5.4.0
-                $output = json_encode($output, $flags);
-                break;
-
-            case self::FORMAT_YAML:
-                if (!function_exists('yaml_emit')) {
-                    throw new Exception('YAML extension not installed.');
-                }
-                array_walk_recursive($output, static function (&$value) {
-                    if (is_object($value)) {
-                        $value = (array)$value;
-                    }
-                });
-                $output = yaml_emit($output, YAML_UTF8_ENCODING, YAML_LN_BREAK);
-                break;
-        }
-
-        return $output;
-    }
-
-    /**
-     * @param string $file
-     * @param string[] $dirs
-     * @return Statement[]
-     * @throws Exception
-     */
-    private function parsePhpFile(string $file, array $dirs): array
-    {
-        return (new Parser())->parse($file, $dirs, $this->defines);
-    }
-
-    /**
-     * @param string $file
-     * @param string[] $dirs
-     * @return Statement[]
-     */
-    private function parseTextFile($file, $dirs)
-    {
-        return (new TextParser())->parse($file, $dirs, $this->defines);
-    }
-
-    /**
-     * @param string $text
-     * @param string[] $dirs
-     * @return Statement[]
-     */
-    private function parseText(string $text, array $dirs): array
-    {
-        return (new TextParser())->parseText($text, $dirs, $this->defines);
-    }
-
-    /**
-     * Creates Swagger\Swagger object and populates it with statements
-     *
-     * This effectively converts the linear list of statements into parse-tree
-     * like structure, performing some checks (like rejecting unknown
-     * subcommands) during the process. Returned Swagger\Swagger object is
-     * ready for serialization with {@see Swagger\Swagger::toArray}
-     *
-     * @param string $host
-     * @param string $basePath
-     * @param Statement[] $statements
-     * @return Swagger
-     * @throws StatementException
-     */
-    public function parseStatements($host, $basePath, $statements)
-    {
-        $swagger = new Swagger($host, $basePath, $this->typeRegistry);
-
-        $stack = array($swagger);
-        /* @var AbstractObject[] $stack */
-        foreach ($statements as $statement) {
-            try {
-                $top = end($stack);
-
-                do {
-                    $result = $top->handleCommand($statement->getCommand(), $statement->getData());
-
-                    if ($result) {
-                        if ($result !== $top) {
-                            // Remove all similar classes from array first!
-                            $classname = get_class($result);
-                            $stack = array_filter($stack, static function ($class) use ($classname) {
-                                return !(is_a($class, $classname));
-                            });
-
-                            $stack[] = $result;
-                        }
-                    } else {
-                        $top = prev($stack);
-                    }
-                } while (!$result && $top);
-            } catch (Exception $e) {
-                throw new StatementException($e->getMessage(), $e->getCode(), $e, $statement);
-            }
-
-            if (!$result && !$top) {
-                $messages = array("Unsupported or unknown command: {$statement->getCommand()} {$statement->getData()}");
-
-                $stacktrace = [];
-                foreach ($stack as $object) {
-                    $stacktrace[] = (string)$object;
-                }
-                $messages[] = implode(', ' . PHP_EOL, $stacktrace);
-
-                throw new StatementException(implode('. ', $messages), 0, null, $statement);
-            }
-        }
-
-        return $swagger;
-    }
+	public const FORMAT_ARRAY = '';
+	public const FORMAT_JSON = 'json';
+	public const FORMAT_JSON_PRETTY = 'json+';
+	public const FORMAT_YAML = 'yaml';
+
+	private string $host;
+	private string $basePath;
+	private array $dirs = [];
+	private array $defines = [];
+
+	/**
+	 * @var TypeRegistry
+	 */
+	private $typeRegistry;
+
+	/**
+	 * Create a new SwaggerGen instance
+	 *
+	 * @param string $host
+	 * @param string $basePath
+	 * @param string[] $dirs
+	 * @param TypeRegistry $typeRegistry
+	 */
+	public function __construct($host = '', $basePath = '', $dirs = [], $typeRegistry = null)
+	{
+		$this->host = $host;
+		$this->basePath = $basePath;
+		$this->dirs = $dirs;
+		$this->typeRegistry = $typeRegistry;
+	}
+
+	/**
+	 * Set a new type registry
+	 *
+	 * @param TypeRegistry $typeRegistry
+	 */
+	public function setTypeRegistry($typeRegistry = null)
+	{
+		$this->typeRegistry = $typeRegistry;
+	}
+
+	/**
+	 * @param string $name
+	 */
+	public function define($name, $value = 1)
+	{
+		$this->defines[$name] = $value;
+	}
+
+	/**
+	 * @param string $name
+	 */
+	public function undefine($name)
+	{
+		unset($this->defines[$name]);
+	}
+
+	/**
+	 * Get Swagger 2.x output
+	 *
+	 * @param string[] $files
+	 * @param string[] $dirs
+	 * @param string $format
+	 * @return array|false|string
+	 * @throws Exception
+	 * @throws StatementException
+	 */
+	public function getSwagger(array $files, array $dirs = [], string $format = self::FORMAT_ARRAY)
+	{
+		$dirs = array_merge($this->dirs, $dirs);
+
+		$statements = [];
+		foreach ($files as $file) {
+			switch (pathinfo($file, PATHINFO_EXTENSION)) {
+				case 'php':
+					$fileStatements = $this->parsePhpFile($file, $dirs);
+					break;
+
+				case 'txt':
+					$fileStatements = $this->parseTextFile($file, $dirs);
+					break;
+
+				default:
+					$fileStatements = $this->parseText($file, $dirs);
+					break;
+			}
+
+			$statements[] = $fileStatements;
+		}
+		$statements = array_merge(...$statements);
+
+		$output = $this->parseStatements($this->host, $this->basePath, $statements)->toArray();
+
+		switch ($format) {
+			case self::FORMAT_JSON:
+				$output = json_encode($output);
+				break;
+
+			case self::FORMAT_JSON_PRETTY:
+				$flags = (defined('JSON_PRETTY_PRINT') ? JSON_PRETTY_PRINT : 0); // Since PHP 5.4.0
+				$output = json_encode($output, $flags);
+				break;
+
+			case self::FORMAT_YAML:
+				if (!function_exists('yaml_emit')) {
+					throw new Exception('YAML extension not installed.');
+				}
+				array_walk_recursive($output, static function (&$value) {
+					if (is_object($value)) {
+						$value = (array)$value;
+					}
+				});
+				$output = yaml_emit($output, YAML_UTF8_ENCODING, YAML_LN_BREAK);
+				break;
+		}
+
+		return $output;
+	}
+
+	/**
+	 * @param string $file
+	 * @param string[] $dirs
+	 * @return Statement[]
+	 * @throws Exception
+	 */
+	private function parsePhpFile(string $file, array $dirs): array
+	{
+		return (new Parser())->parse($file, $dirs, $this->defines);
+	}
+
+	/**
+	 * @param string $file
+	 * @param string[] $dirs
+	 * @return Statement[]
+	 */
+	private function parseTextFile($file, $dirs)
+	{
+		return (new TextParser())->parse($file, $dirs, $this->defines);
+	}
+
+	/**
+	 * @param string $text
+	 * @param string[] $dirs
+	 * @return Statement[]
+	 */
+	private function parseText(string $text, array $dirs): array
+	{
+		return (new TextParser())->parseText($text, $dirs, $this->defines);
+	}
+
+	/**
+	 * Creates Swagger\Swagger object and populates it with statements
+	 *
+	 * This effectively converts the linear list of statements into parse-tree
+	 * like structure, performing some checks (like rejecting unknown
+	 * subcommands) during the process. Returned Swagger\Swagger object is
+	 * ready for serialization with {@see Swagger\Swagger::toArray}
+	 *
+	 * @param string $host
+	 * @param string $basePath
+	 * @param Statement[] $statements
+	 * @return Swagger
+	 * @throws StatementException
+	 */
+	public function parseStatements($host, $basePath, $statements)
+	{
+		$swagger = new Swagger($host, $basePath, $this->typeRegistry);
+
+		$stack = array($swagger);
+		/* @var AbstractObject[] $stack */
+		foreach ($statements as $statement) {
+			try {
+				$top = end($stack);
+
+				do {
+					$result = $top->handleCommand($statement->getCommand(), $statement->getData());
+
+					if ($result) {
+						if ($result !== $top) {
+							// Remove all similar classes from array first!
+							$classname = get_class($result);
+							$stack = array_filter($stack, static function ($class) use ($classname) {
+								return !(is_a($class, $classname));
+							});
+
+							$stack[] = $result;
+						}
+					} else {
+						$top = prev($stack);
+					}
+				} while (!$result && $top);
+			} catch (Exception $e) {
+				throw new StatementException($e->getMessage(), $e->getCode(), $e, $statement);
+			}
+
+			if (!$result && !$top) {
+				$messages = array("Unsupported or unknown command: {$statement->getCommand()} {$statement->getData()}");
+
+				$stacktrace = [];
+				foreach ($stack as $object) {
+					$stacktrace[] = (string)$object;
+				}
+				$messages[] = implode(', ' . PHP_EOL, $stacktrace);
+
+				throw new StatementException(implode('. ', $messages), 0, null, $statement);
+			}
+		}
+
+		return $swagger;
+	}
 
 }

Spacing +4 added lines, -4 removed lines

@@ -145,9 +145,9 @@ 
                 if (!function_exists('yaml_emit')) {
                     throw new Exception('YAML extension not installed.');
                 }
-                array_walk_recursive($output, static function (&$value) {
+                array_walk_recursive($output, static function(&$value) {
                     if (is_object($value)) {
-                        $value = (array)$value;
+                        $value = (array) $value;
                     }
                 });
                 $output = yaml_emit($output, YAML_UTF8_ENCODING, YAML_LN_BREAK);
@@ -219,7 +219,7 @@ 
                         if ($result !== $top) {
                             // Remove all similar classes from array first!
                             $classname = get_class($result);
-                            $stack = array_filter($stack, static function ($class) use ($classname) {
+                            $stack = array_filter($stack, static function($class) use ($classname) {
                                 return !(is_a($class, $classname));
                             });
 
@@ -238,7 +238,7 @@ 
 
                 $stacktrace = [];
                 foreach ($stack as $object) {
-                    $stacktrace[] = (string)$object;
+                    $stacktrace[] = (string) $object;
                 }
                 $messages[] = implode(', ' . PHP_EOL, $stacktrace);
 

SwaggerGen/TypeRegistry.php

Indentation +48 added lines, -48 removed lines

@@ -15,57 +15,57 @@
 class TypeRegistry

 {

 

-    /**

-     * Map of format-name => class-name

-     *

-     * @var array

-     */

-    private $formats = [];

+	/**

+	 * Map of format-name => class-name

+	 *

+	 * @var array

+	 */

+	private $formats = [];

 

-    /**

-     * Add a type name from classname

-     *

-     * @param string $classname

-     */

-    public function add(string $classname): void

-    {

-        if (is_subclass_of($classname, ICustomType::class)) {

-            foreach ($classname::getFormats() as $format) {

-                $this->formats[$format] = $classname;

-            }

-        }

-    }

+	/**

+	 * Add a type name from classname

+	 *

+	 * @param string $classname

+	 */

+	public function add(string $classname): void

+	{

+		if (is_subclass_of($classname, ICustomType::class)) {

+			foreach ($classname::getFormats() as $format) {

+				$this->formats[$format] = $classname;

+			}

+		}

+	}

 

-    /**

-     * Remove type format by explicitly nulling it (disables it)

-     *

-     * @param string $name

-     */

-    public function remove($name)

-    {

-        $this->formats[$name] = null;

-    }

+	/**

+	 * Remove type format by explicitly nulling it (disables it)

+	 *

+	 * @param string $name

+	 */

+	public function remove($name)

+	{

+		$this->formats[$name] = null;

+	}

 

-    /**

-     * Is a type format known?

-     *

-     * @return bool

-     */

-    public function has($name)

-    {

-        return !empty($this->formats[$name]);

-    }

+	/**

+	 * Is a type format known?

+	 *

+	 * @return bool

+	 */

+	public function has($name)

+	{

+		return !empty($this->formats[$name]);

+	}

 

-    /**

-     * Get the format class name

-     *

-     * @return null|string

-     */

-    public function get($name)

-    {

-        return !empty($this->formats[$name])

-            ? $this->formats[$name]

-            : null;

-    }

+	/**

+	 * Get the format class name

+	 *

+	 * @return null|string

+	 */

+	public function get($name)

+	{

+		return !empty($this->formats[$name])

+			? $this->formats[$name]

+			: null;

+	}

 

 }

Braces +10 added lines, -10 removed lines

@@ -12,8 +12,8 @@ 
  * @copyright  2014-2025 Martijn van der Lee

  * @license    https://opensource.org/licenses/MIT MIT

  */

-class TypeRegistry

-{

+class TypeRegistry
+{
 

     /**

      * Map of format-name => class-name

@@ -29,8 +29,8 @@ 
      */

     public function add(string $classname): void

     {

-        if (is_subclass_of($classname, ICustomType::class)) {

-            foreach ($classname::getFormats() as $format) {

+        if (is_subclass_of($classname, ICustomType::class)) {
+            foreach ($classname::getFormats() as $format) {
                 $this->formats[$format] = $classname;

             }

         }

@@ -41,8 +41,8 @@ 
      *

      * @param string $name

      */

-    public function remove($name)

-    {

+    public function remove($name)
+    {
         $this->formats[$name] = null;

     }

 

@@ -51,8 +51,8 @@ 
      *

      * @return bool

      */

-    public function has($name)

-    {

+    public function has($name)
+    {
         return !empty($this->formats[$name]);

     }

 

@@ -61,8 +61,8 @@ 
      *

      * @return null|string

      */

-    public function get($name)

-    {

+    public function get($name)
+    {
         return !empty($this->formats[$name])

             ? $this->formats[$name]

             : null;