URI segment attributes now have enum support in generated Blueprints.

resources/examples/Showtimes/blueprints/1.0/api.apib

@@ -3,15 +3,15 @@ FORMAT: 1A
 # Mill unit test API, Showtimes
 This is the API Blueprint file for Mill unit test API, Showtimes.
 
-It was automatically generated by [Mill](https://github.com/vimeo/mill) on 2017-04-20 11:43:54.
+It was automatically generated by [Mill](https://github.com/vimeo/mill) on 2017-04-20 13:56:37.
 
 # Group Movies
 ## Movies [/movies/{id}]
 Information on a specific movie.
 
 ### Get a single movie. [GET]
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 200 (application/json)
     + Attributes (Movie)
 + Response 304 (application/json)
@@ -22,7 +22,7 @@ Information on a specific movie.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)
@@ -84,7 +84,7 @@ Information on a specific movie theater.
 
 ### Get a single movie theater [GET]
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 200 (application/json)
     + Attributes (Theater)
 + Response 304 (application/json)
@@ -95,7 +95,7 @@ Information on a specific movie theater.
 This action requires a bearer token with `create` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Request
     + Headers
 
@@ -116,7 +116,7 @@ This action requires a bearer token with `create` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.0/resources/Movies.apib

@@ -4,7 +4,7 @@ Information on a specific movie.
 
 ### Get a single movie. [GET]
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 200 (application/json)
     + Attributes (Movie)
 + Response 304 (application/json)
@@ -15,7 +15,7 @@ Information on a specific movie.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.0/resources/Theaters.apib

@@ -4,7 +4,7 @@ Information on a specific movie theater.
 
 ### Get a single movie theater [GET]
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 200 (application/json)
     + Attributes (Theater)
 + Response 304 (application/json)
@@ -15,7 +15,7 @@ Information on a specific movie theater.
 This action requires a bearer token with `create` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Request
     + Headers
 
@@ -36,7 +36,7 @@ This action requires a bearer token with `create` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.1.1/api.apib

@@ -3,15 +3,15 @@ FORMAT: 1A
 # Mill unit test API, Showtimes
 This is the API Blueprint file for Mill unit test API, Showtimes.
 
-It was automatically generated by [Mill](https://github.com/vimeo/mill) on 2017-04-20 11:43:54.
+It was automatically generated by [Mill](https://github.com/vimeo/mill) on 2017-04-20 13:56:37.
 
 # Group Movies
 ## Movies [/movies/{id}]
 Information on a specific movie.
 
 ### Get a single movie. [GET]
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 200 (application/json)
     + Attributes (Movie)
 + Response 304 (application/json)
@@ -22,7 +22,7 @@ Information on a specific movie.
 This action requires a bearer token with `edit` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Request
     + Headers
 
@@ -63,7 +63,7 @@ This action requires a bearer token with `edit` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)
@@ -127,7 +127,7 @@ Information on a specific movie theater.
 
 ### Get a single movie theater [GET]
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 200 (application/json)
     + Attributes (Theater)
 + Response 304 (application/json)
@@ -138,7 +138,7 @@ Information on a specific movie theater.
 This action requires a bearer token with `create` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Request
     + Headers
 
@@ -159,7 +159,7 @@ This action requires a bearer token with `create` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.1.1/resources/Movies.apib

@@ -4,7 +4,7 @@ Information on a specific movie.
 
 ### Get a single movie. [GET]
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 200 (application/json)
     + Attributes (Movie)
 + Response 304 (application/json)
@@ -15,7 +15,7 @@ Information on a specific movie.
 This action requires a bearer token with `edit` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Request
     + Headers
 
@@ -56,7 +56,7 @@ This action requires a bearer token with `edit` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.1.1/resources/Theaters.apib

@@ -4,7 +4,7 @@ Information on a specific movie theater.
 
 ### Get a single movie theater [GET]
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 200 (application/json)
     + Attributes (Theater)
 + Response 304 (application/json)
@@ -15,7 +15,7 @@ Information on a specific movie theater.
 This action requires a bearer token with `create` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Request
     + Headers
 
@@ -36,7 +36,7 @@ This action requires a bearer token with `create` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.1/api.apib

@@ -3,15 +3,15 @@ FORMAT: 1A
 # Mill unit test API, Showtimes
 This is the API Blueprint file for Mill unit test API, Showtimes.
 
-It was automatically generated by [Mill](https://github.com/vimeo/mill) on 2017-04-20 11:43:54.
+It was automatically generated by [Mill](https://github.com/vimeo/mill) on 2017-04-20 13:56:37.
 
 # Group Movies
 ## Movies [/movies/{id}]
 Information on a specific movie.
 
 ### Get a single movie. [GET]
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 200 (application/json)
     + Attributes (Movie)
 + Response 304 (application/json)
@@ -22,7 +22,7 @@ Information on a specific movie.
 This action requires a bearer token with `edit` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Request
     + Headers
 
@@ -62,7 +62,7 @@ This action requires a bearer token with `edit` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)
@@ -126,7 +126,7 @@ Information on a specific movie theater.
 
 ### Get a single movie theater [GET]
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 200 (application/json)
     + Attributes (Theater)
 + Response 304 (application/json)
@@ -137,7 +137,7 @@ Information on a specific movie theater.
 This action requires a bearer token with `create` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Request
     + Headers
 
@@ -158,7 +158,7 @@ This action requires a bearer token with `create` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.1/resources/Movies.apib

@@ -4,7 +4,7 @@ Information on a specific movie.
 
 ### Get a single movie. [GET]
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 200 (application/json)
     + Attributes (Movie)
 + Response 304 (application/json)
@@ -15,7 +15,7 @@ Information on a specific movie.
 This action requires a bearer token with `edit` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Request
     + Headers
 
@@ -55,7 +55,7 @@ This action requires a bearer token with `edit` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Movie ID
+    - `id` (number, required) - Movie ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

resources/examples/Showtimes/blueprints/1.1/resources/Theaters.apib

@@ -4,7 +4,7 @@ Information on a specific movie theater.
 
 ### Get a single movie theater [GET]
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 200 (application/json)
     + Attributes (Theater)
 + Response 304 (application/json)
@@ -15,7 +15,7 @@ Information on a specific movie theater.
 This action requires a bearer token with `create` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Request
     + Headers
 
@@ -36,7 +36,7 @@ This action requires a bearer token with `create` scope.
 This action requires a bearer token with `delete` scope.
 
 + Parameters
-    + `id` (integer, required) - Theater ID
+    - `id` (number, required) - Theater ID
 + Response 204 (application/json)
 + Response 404 (application/json)
     + Attributes (Error)

src/Generator/Blueprint.php

@@ -206,15 +206,30 @@ protected function processParameters(Action\Documentation $action)
                 $field = str_replace($from, $to, $field);
             }
 
+            $values = $segment->getValues();
+            $type = $this->convertTypeToCompatibleType($segment->getType());
+
             $blueprint .= $this->tab();
             $blueprint .= sprintf(
-                '+ `%s` (%s, required) - %s',
+                '- `%s` (%s, required) - %s',
                 $field,
-                $segment->getType(),
+                (!empty($values)) ? 'enum[' . $type . ']' : $type,
                 $segment->getDescription()
             );
 
             $blueprint .= $this->line();
+
+            if (!empty($values)) {
+                $blueprint .= $this->tab(2);
+                $blueprint .= '+ Members';
+                $blueprint .= $this->line();
+
+                foreach ($values as $value) {
+                    $blueprint .= $this->tab(3);
+                    $blueprint .= '+ `' . $value . '`';
+                    $blueprint .= $this->line();
+                }
+            }
         }
 
         return $blueprint;