save

Author: jcbhmr

error/error.wasm.go

@@ -1,4 +1,4 @@
-package wasi:io@0.2.6;
+package wasi:io@0.2.7;
 
 @since(version = 0.2.0)
 interface error {
@@ -210,27 +210,13 @@ interface streams {
     /// Perform a write of up to 4096 bytes, and then flush the stream. Block
     /// until all of these operations are complete, or an error occurs.
     ///
-    /// This is a convenience wrapper around the use of `check-write`,
-    /// `subscribe`, `write`, and `flush`, and is implemented with the
-    /// following pseudo-code:
-    ///
-    /// ```text
-    /// let pollable = this.subscribe();
-    /// while !contents.is_empty() {
-    ///     // Wait for the stream to become writable
-    ///     pollable.block();
-    ///     let Ok(n) = this.check-write(); // eliding error handling
-    ///     let len = min(n, contents.len());
-    ///     let (chunk, rest) = contents.split_at(len);
-    ///     this.write(chunk  );            // eliding error handling
-    ///     contents = rest;
-    /// }
-    /// this.flush();
-    /// // Wait for completion of `flush`
-    /// pollable.block();
-    /// // Check for any errors that arose during `flush`
-    /// let _ = this.check-write();         // eliding error handling
-    /// ```
+    /// Returns success when all of the contents written are successfully
+    /// flushed to output. If an error occurs at any point before all
+    /// contents are successfully flushed, that error is returned as soon as
+    /// possible. If writing and flushing the complete contents causes the
+    /// stream to become closed, this call should return success, and
+    /// subsequent calls to check-write or other interfaces should return
+    /// stream-error::closed.
     @since(version = 0.2.0)
     blocking-write-and-flush: func(contents: list<u8>) -> result<_, stream-error>;
     /// Request to flush buffered output. This function never blocks.
@@ -273,26 +259,8 @@ interface streams {
     /// Block until all of these operations are complete, or an error
     /// occurs.
     ///
-    /// This is a convenience wrapper around the use of `check-write`,
-    /// `subscribe`, `write-zeroes`, and `flush`, and is implemented with
-    /// the following pseudo-code:
-    ///
-    /// ```text
-    /// let pollable = this.subscribe();
-    /// while num_zeroes != 0 {
-    ///     // Wait for the stream to become writable
-    ///     pollable.block();
-    ///     let Ok(n) = this.check-write(); // eliding error handling
-    ///     let len = min(n, num_zeroes);
-    ///     this.write-zeroes(len);         // eliding error handling
-    ///     num_zeroes -= len;
-    /// }
-    /// this.flush();
-    /// // Wait for completion of `flush`
-    /// pollable.block();
-    /// // Check for any errors that arose during `flush`
-    /// let _ = this.check-write();         // eliding error handling
-    /// ```
+    /// Functionality is equivelant to `blocking-write-and-flush` with
+    /// contents given as a list of len containing only zeroes.
     @since(version = 0.2.0)
     blocking-write-zeroes-and-flush: func(len: u64) -> result<_, stream-error>;
     /// Read from one stream and write to another.

error/error.wit.go

@@ -1,5 +1,5 @@
-package jcbhmr:go-wasi-io@0.2.6;
+package jcbhmr:go-wasi-io@0.2.7;
 
 world go-wasi-io {
-    include wasi:io/imports@0.2.6;
+    include wasi:io/imports@0.2.7;
 }

poll/poll.wasm.go

@@ -7,6 +7,6 @@ name = "wasi:io"
 registry = "wasi.dev"
 
 [[packages.versions]]
-requirement = "=0.2.6"
-version = "0.2.6"
-digest = "sha256:8e8ebc63a7670203b2a4868c2d0ba1d73b0ed0caa1c576edfd68762d7225a312"
+requirement = "=0.2.7"
+version = "0.2.7"
+digest = "sha256:4c23f92381d6f012bc0c6b2bae062c3ed12b701d66e1229fca9a2dbacc239c49"