@toa.io/extensions.exposition 1.0.0-alpha.27 → 1.0.0-alpha.270

package/features/octets.feature

@@ -8,32 +8,38 @@ Feature: Octets directive family
         auth:anonymous: true
         octets:context: octets
         POST:
-          octets:store: ~
-        GET:
-          octets:list: ~
+          octets:put: ~
         /*:
           GET:
-            octets:fetch: ~
+            octets:get: ~
           DELETE:
             octets:delete: ~
         /media:
           /jpeg:
             POST:
-              octets:store:
+              octets:put:
                 accept: image/jpeg
           /jpeg-or-png:
             POST:
-              octets:store:
+              octets:put:
                 accept:
                   - image/jpeg
                   - image/png
           /images:
             POST:
-              octets:store:
+              octets:put:
                 accept: image/*
             /*:
               GET:
-                octets:fetch: ~
+                octets:get: ~
+        /limit-1kb:
+          POST:
+            octets:put:
+              limit: 1kb
+        /limit-100kb:
+          POST:
+            octets:put:
+              limit: 100kb
       """
 
   Scenario: Basic storage operations
@@ -49,27 +55,27 @@ Feature: Octets directive family
       201 Created
       content-type: application/yaml
 
-      id: 10cf16b458f759e0d617f2f3d83599ff
-      type: application/octet-stream
+      id: ${{ id }}
       size: 8169
+      type: application/octet-stream
       """
     When the following request is received:
       """
-      GET /10cf16b458f759e0d617f2f3d83599ff HTTP/1.1
+      GET /${{ id }} HTTP/1.1
       host: nex.toa.io
       """
     Then the stream equals to `lenna.ascii` is sent with the following headers:
       """
       200 OK
-      content-type: application/octet-stream
       content-length: 8169
-      etag: ${{ ETAG }}
+      content-type: application/octet-stream
+      etag: "${{ ETAG }}"
       """
     When the following request is received:
       """
-      GET /10cf16b458f759e0d617f2f3d83599ff HTTP/1.1
+      GET /${{ id }} HTTP/1.1
       host: nex.toa.io
-      if-none-match: ${{ ETAG }}
+      if-none-match: "${{ ETAG }}"
       """
     Then the following reply is sent:
       """
@@ -77,20 +83,7 @@ Feature: Octets directive family
       """
     When the following request is received:
       """
-      GET / HTTP/1.1
-      host: nex.toa.io
-      accept: application/yaml
-      """
-    Then the following reply is sent:
-      """
-      200 OK
-      content-type: application/yaml
-
-      - 10cf16b458f759e0d617f2f3d83599ff
-      """
-    When the following request is received:
-      """
-      GET /10cf16b458f759e0d617f2f3d83599ff?foo=bar HTTP/1.1
+      GET /${{ id }}?foo=bar HTTP/1.1
       host: nex.toa.io
       """
     Then the following reply is sent:
@@ -99,7 +92,7 @@ Feature: Octets directive family
       """
     When the following request is received:
       """
-      DELETE /10cf16b458f759e0d617f2f3d83599ff HTTP/1.1
+      DELETE /${{ id }} HTTP/1.1
       host: nex.toa.io
       """
     Then the following reply is sent:
@@ -108,7 +101,7 @@ Feature: Octets directive family
       """
     When the following request is received:
       """
-      GET /10cf16b458f759e0d617f2f3d83599ff HTTP/1.1
+      GET /${{ id }} HTTP/1.1
       host: nex.toa.io
       """
     Then the following reply is sent:
@@ -146,6 +139,32 @@ Feature: Octets directive family
       201 Created
       """
 
+  Scenario: Size limit
+    When the stream of `albert.jpg` is received with the following headers:
+      """
+      POST /limit-1kb/ HTTP/1.1
+      host: nex.toa.io
+      content-type: image/jpeg
+      accept: text/plain
+      """
+    Then the following reply is sent:
+      """
+      413 Request Entity Too Large
+
+      Size limit is 1kb
+      """
+
+    When the stream of `albert.jpg` is received with the following headers:
+      """
+      POST /limit-100kb/ HTTP/1.1
+      host: nex.toa.io
+      content-type: image/jpeg
+      """
+    Then the following reply is sent:
+      """
+      201 Created
+      """
+
   Scenario Outline: Detecting `<type>`
     When the stream of `sample.<ext>` is received with the following headers:
       """
@@ -183,7 +202,7 @@ Feature: Octets directive family
       type: image/svg+xml
       """
 
-    Scenario: Rejection video/avi
+  Scenario: Rejection video/avi
     When the stream of `sample.avi` is received with the following headers:
       """
       POST /media/images/ HTTP/1.1
@@ -224,42 +243,5 @@ Feature: Octets directive family
       404 Not Found
       content-type: text/plain
 
-      Trailing slash is redundant.
-      """
-
-  Scenario: Original BLOB is not accessible
-    Given the annotation:
-      """yaml
-      /:
-        io:output: true
-        auth:anonymous: true
-        octets:context: octets
-        POST:
-          octets:store: ~
-        /*:
-          GET:
-            octets:fetch:
-              meta: true
-              blob: false
-      """
-    When the stream of `lenna.ascii` is received with the following headers:
-      """
-      POST / HTTP/1.1
-      host: nex.toa.io
-      """
-    Then the following reply is sent:
-      """
-      201 Created
-      """
-    When the following request is received:
-      """
-      GET /10cf16b458f759e0d617f2f3d83599ff HTTP/1.1
-      host: nex.toa.io
-      accept: text/plain
-      """
-    Then the following reply is sent:
-      """
-      403 Forbidden
-
-      BLOB variant must be specified.
+      Trailing slash is redundant
       """

package/features/octets.head.feature

@@ -0,0 +1,40 @@
+Feature: Octets headers
+
+  Scenario: Accessing headers
+    Given the annotation:
+      """yaml
+      /:
+        io:output: true
+        auth:anonymous: true
+        octets:context: octets
+        /*:
+          POST:
+            octets:put: ~
+          /*:
+            HEAD:
+              octets:head: ~
+      """
+    When the stream of `lenna.ascii` is received with the following headers:
+      """
+      POST /assets/ HTTP/1.1
+      host: nex.toa.io
+      accept: application/yaml
+      content-type: application/octet-stream
+      """
+    Then the following reply is sent:
+      """
+      201 Created
+
+      id: ${{ id }}
+      """
+    When the following request is received:
+      """
+      HEAD /assets/${{ id }} HTTP/1.1
+      host: nex.toa.io
+      """
+    Then the following reply is sent:
+      """
+      200 OK
+      content-length: 8169
+      content-type: application/octet-stream
+      """

package/features/octets.location.feature

@@ -0,0 +1,83 @@
+Feature: Octets location
+
+  Scenario Outline: Store octets in a specified location
+    Given the annotation:
+      """yaml
+      /:
+        /foo:
+          octets:context: octets
+          auth:anonymous: true
+          io:output: true
+          POST:
+            octets:put:
+              location: <location>
+          /bar:
+            /*:
+              GET:
+                octets:get: ~
+      """
+    When the stream of `lenna.ascii` is received with the following headers:
+      """
+      POST /foo/ HTTP/1.1
+      host: nex.toa.io
+      accept: application/yaml
+      content-type: application/octet-stream
+      """
+    Then the following reply is sent:
+      """
+      201 Created
+
+      id: ${{ id }}
+      """
+    When the following request is received:
+      """
+      HEAD /foo/bar/${{ id }} HTTP/1.1
+      """
+    Then the following reply is sent:
+      """
+      200 OK
+      """
+    Examples:
+      | location  |
+      | ./bar     |
+      | /foo/bar/ |
+
+  Scenario: Executing a workflow with specified location
+    Given the `octets.tester` is running
+    And the annotation:
+      """yaml
+      /:
+        auth:anonymous: true
+        octets:context: octets
+        POST:
+          octets:put:
+            location: /hello/world/
+            workflow:
+              echo: octets.tester.echo
+          io:output: true
+      """
+    When the stream of `lenna.ascii` is received with the following headers:
+      """
+      POST / HTTP/1.1
+      host: nex.toa.io
+      accept: application/yaml, multipart/yaml
+      content-type: application/octet-stream
+      """
+    Then the following reply is sent:
+      """
+      201 Created
+      content-type: multipart/yaml; boundary=cut
+
+      --cut
+
+      id: ${{ id }}
+      size: 8169
+      type: application/octet-stream
+      --cut
+
+      step: echo
+      status: completed
+      output:
+        path: /hello/world/${{ id }}
+      --cut--
+      """

package/features/octets.meta.feature

@@ -1,8 +1,51 @@
-Feature: Octets `content-meta` header
+Feature: Octets metadata
 
-  Scenario: Sending `content-meta` header
-    Given the `octets.tester` is running
-    And the annotation:
+  Scenario: Content-ID
+    Given the annotation:
+      """yaml
+      /:
+        io:output: true
+        auth:anonymous: true
+        octets:context: octets
+        /*:
+          POST:
+            octets:put: ~
+          /*:
+            GET:
+              octets:get:
+                meta: true
+      """
+    When the stream of `lenna.ascii` is received with the following headers:
+      """
+      POST /attributes/ HTTP/1.1
+      host: nex.toa.io
+      accept: application/yaml
+      content-type: application/octet-stream
+      content-id: hello
+      """
+    Then the following reply is sent:
+      """
+      201 Created
+
+      id: hello
+      """
+    When the stream of `lenna.ascii` is received with the following headers:
+      """
+      POST /attributes/ HTTP/1.1
+      host: nex.toa.io
+      accept: text/plain
+      content-type: application/octet-stream
+      content-id: hello.txt
+      """
+    Then the following reply is sent:
+      """
+      400 Bad Request
+
+      Invalid Content-ID
+      """
+
+  Scenario: Content-Attributes
+    Given the annotation:
       """yaml
       /:
         io:output: true
@@ -10,27 +53,30 @@ Feature: Octets `content-meta` header
         octets:context: octets
         /*:
           POST:
-            octets:store: ~
+            octets:put: ~
           /*:
             GET:
-              octets:fetch:
+              octets:get:
                 meta: true
       """
     When the stream of `lenna.ascii` is received with the following headers:
       """
-      POST /meta-header/ HTTP/1.1
+      POST /attributes/ HTTP/1.1
       host: nex.toa.io
+      accept: application/yaml
       content-type: application/octet-stream
-      content-meta: foo, bar=baz=1
-      content-meta: baz=1
+      content-attributes: foo, bar=baz=1
+      content-attributes: baz=1
       """
     Then the following reply is sent:
       """
       201 Created
+
+      id: ${{ id }}
       """
     When the following request is received:
       """
-      GET /meta-header/10cf16b458f759e0d617f2f3d83599ff HTTP/1.1
+      GET /attributes/${{ id }} HTTP/1.1
       host: nex.toa.io
       accept: application/vnd.toa.octets.entry+yaml
       """
@@ -38,22 +84,23 @@ Feature: Octets `content-meta` header
       """
       200 OK
 
-      id: 10cf16b458f759e0d617f2f3d83599ff
-      type: application/octet-stream
+      id: ${{ id }}
       size: 8169
-      meta:
+      type: application/octet-stream
+      checksum: 10cf16b458f759e0d617f2f3d83599ff
+      attributes:
         foo: 'true'
         bar: baz=1
         baz: '1'
       """
 
-  Scenario: CORS allows `content-meta` header
+  Scenario: CORS allows `content-attributes` header
     Given the annotation:
       """yaml
       /:
         octets:context: octets
         POST:
-          octets:store: ~
+          octets:put: ~
       """
     When the following request is received:
       """
@@ -64,6 +111,6 @@ Feature: Octets `content-meta` header
     Then the following reply is sent:
       """
       204 No Content
+      access-control-allow-headers: accept, authorization, content-attributes, content-location, content-type, if-match, if-none-match, origin
       access-control-allow-origin: https://example.com
-      access-control-allow-headers: accept, authorization, content-type, etag, if-match, if-none-match, content-meta
       """