docs: Slightly expand the usage examples in the README

README.md

@@ -46,9 +46,13 @@ const s3client = new S3Client({
   pathStyle: false,
 });
 
+// Log data about each object found under the 'data/concepts/' prefix:
 for await (const obj of s3client.listObjects({ prefix: "data/concepts/" })) {
   console.log(obj);
 }
+
+// Or, to get all the keys (paths) as an array:
+const keys = await Array.fromAsync(s3client.listObjects(), (entry) => entry.key);
 ```
 
 Upload a file to a local MinIO server:
@@ -70,6 +74,14 @@ const s3client = new S3Client({
 
 // Upload a file:
 await s3client.putObject("test.txt", "This is the contents of the file.");
+
+// Now download it
+const result = await s3client.getObject("test.txt");
+// and stream the results to a local file:
+const localOutFile = await Deno.open("test-out.txt", {write: true, createNew: true});
+await result.body!.pipeTo(localOutFile.writable);
+// or instead of streaming, you can consume the whole file into memory by awaiting
+// result.text(), result.blob(), result.arrayBuffer(), or result.json()
 ```
 
 For more examples, check out the tests in [`integration.ts`](./integration.ts)