#156 Allow built-in type ANY (#157)

Author: martin-georgiev

src/ApiDefinition.php

@@ -604,6 +604,7 @@ public static function getStraightForwardTypes()
             'file',
             'array',
             'object',
+            'any',
         ];
     }
 

src/NamedParameter.php

@@ -12,6 +12,11 @@ class NamedParameter implements ArrayInstantiationInterface
 {
     // Type constants
 
+    /**
+     * @var string
+     */
+    const TYPE_ANY = 'any';
+
     /**
      * @var string
      */
@@ -140,6 +145,7 @@ class NamedParameter implements ArrayInstantiationInterface
      * @var string[]
      */
     protected $validTypes = [
+        self::TYPE_ANY,
         self::TYPE_STRING,
         self::TYPE_NUMBER,
         self::TYPE_INTEGER,
@@ -602,12 +608,12 @@ public function getMinimum()
      *
      * @param int $minimum
      *
-     * @throws \Exception
+     * @throws \InvalidArgumentException
      */
     public function setMinimum($minimum)
     {
         if (!\in_array($this->type, [self::TYPE_INTEGER, self::TYPE_NUMBER], true)) {
-            throw new \Exception('minimum can only be set on type "integer" or "number');
+            throw new \InvalidArgumentException('minimum can only be set on type "integer" or "number');
         }
 
         $this->minimum = (int) $minimum;
@@ -630,12 +636,12 @@ public function getMaximum()
      *
      * @param int $maximum
      *
-     * @throws \Exception
+     * @throws \InvalidArgumentException
      */
     public function setMaximum($maximum)
     {
         if (!\in_array($this->type, [self::TYPE_INTEGER, self::TYPE_NUMBER], true)) {
-            throw new \Exception('maximum can only be set on type "integer" or "number');
+            throw new \InvalidArgumentException('maximum can only be set on type "integer" or "number');
         }
 
         $this->maximum = (int) $maximum;

src/Types/ObjectType.php

@@ -106,7 +106,7 @@ public static function createFromArray($name, array $data = [])
     }
 
     /**
-     * @param string $value
+     * @param array $value
      * @return bool
      */
     public function discriminate($value)
@@ -153,7 +153,7 @@ public function setProperties(array $properties)
      * Returns a property by name
      *
      * @param string $name
-     * @return null|Type
+     * @return void|Type
      */
     public function getPropertyByName($name)
     {

tests/ParseTest.php

@@ -794,6 +794,7 @@ public function shouldThrowExceptionOnBadQueryParameter()
             $this->assertEquals('invalid', $e->getType());
             $this->assertEquals(
                 [
+                    'any',
                     'string',
                     'number',
                     'integer',