Localdrive
A file system API that is similar to Hyperdrive. This tool comes in handy when you want to mirror files from your filesystem to a drive, and vice-versa.
npm install localdrive
const Localdrive = require('localdrive')
const drive = new Localdrive('./my-project')
await drive.put('/blob.txt', Buffer.from('example'))
await drive.put('/images/logo.png', Buffer.from('..'))
await drive.put('/images/old-logo.png', Buffer.from('..'))
const buffer = await drive.get('/blob.txt')
console.log(buffer) // => <Buffer ..> 'example'
const entry = await drive.entry('/blob.txt')
console.log(entry) // => { key, value: { executable, linkname, blob, metadata } }
await drive.del('/images/old-logo.png')
await drive.symlink('/images/logo.shortcut', '/images/logo.png')
for await (const file of drive.list('/images')) {
console.log('list', file) // => { key, value }
}
const rs = drive.createReadStream('/blob.txt')
for await (const chunk of rs) {
console.log('rs', chunk) // => <Buffer ..>
}
const ws = drive.createWriteStream('/blob.txt')
ws.write('new example')
ws.end()
ws.once('close', () => console.log('file saved'))
const drive = new Localdrive(root, [options])Creates a drive based on a
root directory. root can be relative or absolute.options include:Property | Description | Type | Default |
|---|---|---|---|
followLinks | followLinks does entry(key) to follow the linkname. | Boolean | false |
metadata | metadata hook functions are called accordingly. del() could be called with non-existing metadata keys. | Object | null |
drive.rootString with the resolved (absolute) drive path.
drive.supportsMetadataBoolean that indicates if the drive handles or not metadata. Default
false.If you pass
options.metadata hooks then supportsMetadata becomes true.await drive.put(key, buffer, [options])Creates a file at
key path in the drive. options are the same as in createWriteStream.const buffer = await drive.get(key)Returns the blob at
key path in the drive. If no blob exists, returns null.It also returns null for symbolic links.
const entry = await drive.entry(key)Returns the entry at
key path in the drive. It looks like this:{
key: String,
value: {
executable: Boolean,
linkname: null,
blob: {
blockOffset: Number,
blockLength: Number,
byteOffset: Number,
byteLength: Number
},
metadata: null
}
}
await drive.del(key)Deletes the file at
key path from the drive.await drive.symlink(key, linkname)Creates an entry in drive at
key path that points to the entry at linkname.If a blob entry currently exists at
key path then it will be overwritten and drive.get(key) will return null, while drive.entry(key) will return the entry with symlink information.const iterator = drive.list([folder])Returns a stream of all entries in the drive inside of specified
folder.const iterator = drive.readdir([folder])Returns a stream of all subpaths of entries in drive stored at paths prefixed by
folder.const mirror = drive.mirror(out, [options])Efficiently mirror this drive into another. Returns a MirrorDrive instance constructed with
options.const rs = drive.createReadStream(key, [options])Returns a stream to read out the blob stored in the drive at
key path.options include:Property | Description | Type | Default |
|---|---|---|---|
start | Starting offset of the desired readstream interval | Integer | null |
end | Ending offset of the desired readstream interval | Integer | null |
length | Length of the desired readstream interval | Integer | null |
startandendare inclusive.lengthoverridesend, they're not meant to be used together.
const ws = drive.createWriteStream(key, [options])Stream a blob into the drive at
key path.options include:Property | Description | Type | Default |
|---|---|---|---|
executable | whether the blob is executable or not | Boolean | true |
Metadata backed by
Map:const meta = new Map()
const metadata = {
get: (key) => meta.has(key) ? meta.get(key) : null,
put: (key, value) => meta.set(key, value),
del: (key) => meta.delete(key)
}
const drive = new Localdrive('./my-app', { metadata })
// ...
metadata.del() will also be called when metadata is nullawait drive.put('/file.txt', Buffer.from('a')) // Default metadata is null
Last modified 16d ago