@dictadata/s3-filesystem v1.8.2

s3-filesystem 1.8.x

S3 filesystem plugin for @dictadata/storage-junctions.

Installation

npm i @dictadata/storage-junctions
npm i @dictadata/s3-filesystem

Registering the Plugin

const storage = require("@dictadata/storage-junctions");
const S3FileSystem = require("@dictadata/s3-filesystem");

storage.FileSystems.use("s3", S3FileSystem);

Usage in Storage Memory Trace

Example SMT string for accessing json files in an S3 bucket.

let smt = "json|s3:dictadata.org/data/|foofile.json|*"

Where:

• "json" - smt model of junction used to encode and query data in the storage source.
• "s3:dictadata.org/data/" - smt locus locator address for the storage source.
  • "S3" - filesystem model used to access data containers in the storage source.
  • "dictadata.org" - S3 bucket name.
  • "/data/" - S3 prefix for object names.
• "foo_*" - smt schema specification for S3 object names with wildcard.
• "*" - smt key * represents all constructs.

Support Junction Methods

Storage FileSystems support the following methods.

• list()
• createReadStream()
• createWriteStream()
• getFile()
• putFile()
• dull()