Class LocalFilesystem

A Filesystem implementation that stores files on the local disk.

Todo

walk

Hierarchy

Filesystem
- LocalFilesystem

Index

Constructors

constructor

new LocalFilesystem(baseConfig: LocalFilesystemConfig): LocalFilesystem
Parameters
- baseConfig: LocalFilesystemConfig
Returns LocalFilesystem
Overrides Filesystem.constructor
- Defined in src/util/support/path/LocalFilesystem.ts:18

Properties

`Protected` `Readonly` baseConfig

baseConfig: LocalFilesystemConfig

Methods

close

close(): Awaitable<void>
Called when the Filesystem driver is destroyed. Do any cleanup here.

Returns Awaitable<void>
Inherited from Filesystem.close
- Defined in src/util/support/path/Filesystem.ts:96

getMetadata

getMetadata(storePath: string): Promise<FileMetadata>
Get the metadata object for the given file, if it exists.
Parameters
- storePath: string
Returns Promise<FileMetadata>
Overrides Filesystem.getMetadata
- Defined in src/util/support/path/LocalFilesystem.ts:57

getPath

getPath(storePath: string): UniversalPath
Get a UniversalPath that refers to a file on this filesystem.
Parameters
- storePath: string
Returns UniversalPath
Inherited from Filesystem.getPath
- Defined in src/util/support/path/Filesystem.ts:109

getPrefix

getPrefix(): string
Get the URI prefix for this filesystem.

Example
file://

Example
s3://

Returns string
Overrides Filesystem.getPrefix
- Defined in src/util/support/path/LocalFilesystem.ts:31

getStoreFileAsStream

getStoreFileAsStream(args: {
storePath: string;
}): ReadStream | Promise<ReadStream>
Open a readable stream for a file in the remote filesystem.
Parameters
- args: {
  storePath: string;
  }
  - storePath: string
Returns ReadStream | Promise<ReadStream>
Overrides Filesystem.getStoreFileAsStream
- Defined in src/util/support/path/LocalFilesystem.ts:49

getStoreFileAsTemp

getStoreFileAsTemp(__namedParameters: {
storePath: string;
}): Promise<UniversalPath>
Download a file in the remote filesystem to the local filesystem and return it as a UniversalPath.
Parameters
- __namedParameters: {
  storePath: string;
  }
  - storePath: string
Returns Promise<UniversalPath>
Overrides Filesystem.getStoreFileAsTemp
- Defined in src/util/support/path/LocalFilesystem.ts:43

list

list(storePath: string): Promise<Collection<string>>
List all immediate children of the given path.
Parameters
- storePath: string
Returns Promise<Collection<string>>
Overrides Filesystem.list
- Defined in src/util/support/path/LocalFilesystem.ts:179

`Protected` metadataPath

metadataPath(storePath: string): string
Protected
Given a relative path in the store, resolve it to an absolute path to the metadata JSON file for that path.
Parameters
- storePath: string
Returns string
- Defined in src/util/support/path/LocalFilesystem.ts:171

mkdir

mkdir(args: {
storePath: string;
}): Promise<void>
Create the given path on the store as a directory, recursively.
Parameters
- args: {
  storePath: string;
  }
  - storePath: string
Returns Promise<void>
Overrides Filesystem.mkdir
- Defined in src/util/support/path/LocalFilesystem.ts:152

`Protected` normalizeTags

normalizeTags(tag?: string, tags?: string[]): string[]
Protected
Normalize the input tags into a single array of strings. This is useful for implementing the fluent interface for putLocalFile().

Example
```
const tags: string[] = this._normalizeTags(args.tag, args.tags)
```
Parameters
- Optional tag: string
- Optional tags: string[]
Returns string[]
Inherited from Filesystem.normalizeTags
- Defined in src/util/support/path/Filesystem.ts:203

open

open(): Promise<void>
Called when the Filesystem driver is initialized. Do any standup here.

Returns Promise<void>
Overrides Filesystem.open
- Defined in src/util/support/path/LocalFilesystem.ts:24

putLocalFile

putLocalFile(__namedParameters: {
    localPath: string;
    mimeType?: string;
    storePath: string;
    tag?: string;
    tags?: string[];
}): Promise<void>
Store a file from the local filesystem into the remote filesystem.

Example
```
await store.putLocalFile({
    localPath: '/tmp/temp.file',
    storePath: 'my/upload-key/temp.file',
    mimeType: 'application/json',
    tags: ['json', 'user-data'],
})
```
Parameters
- __namedParameters: {
      localPath: string;
      mimeType?: string;
      storePath: string;
      tag?: string;
      tags?: string[];
  }
  - localPath: string
  - Optional mimeType?: string
  - storePath: string
  - Optional tag?: string
  - Optional tags?: string[]
Returns Promise<void>
Overrides Filesystem.putLocalFile
- Defined in src/util/support/path/LocalFilesystem.ts:35

putStoreFileAsStream

putStoreFileAsStream(args: {
storePath: string;
}): WriteStream | Promise<WriteStream>
Open a writable stream for a file in the remote filesystem.
Parameters
- args: {
  storePath: string;
  }
  - storePath: string
Returns WriteStream | Promise<WriteStream>
Overrides Filesystem.putStoreFileAsStream
- Defined in src/util/support/path/LocalFilesystem.ts:53

remove

remove(args: {
recursive?: boolean;
storePath: string;
}): Promise<void>
Remove the given resource(s) from the remote filesystem.
Parameters
- args: {
  recursive?: boolean;
  storePath: string;
  }
  - Optional recursive?: boolean
  - storePath: string
Returns Promise<void>
Overrides Filesystem.remove
- Defined in src/util/support/path/LocalFilesystem.ts:134

setMetadata

setMetadata(storePath: string, meta: FileMetadata): Promise<void>
Set the metadata object for the given file, if the file exists.
Parameters
- storePath: string
- meta: FileMetadata
Returns Promise<void>
Overrides Filesystem.setMetadata
- Defined in src/util/support/path/LocalFilesystem.ts:68

stat

stat(args: {
storePath: string;
}): Promise<Stat>
Fetch some information about a file that may or may not be in the remote filesystem without fetching the entire file.
Parameters
- args: {
  storePath: string;
  }
  - storePath: string
Returns Promise<Stat>
Overrides Filesystem.stat
- Defined in src/util/support/path/LocalFilesystem.ts:77

`Protected` storePath

storePath(storePath: string): string
Protected
Given a relative path in the store, resolve it to an absolute path.
Parameters
- storePath: string
Returns string
- Defined in src/util/support/path/LocalFilesystem.ts:161

`Protected` tempName

tempName(): string
Protected
Generate the name of a temp-file on the LOCAL filesystem.

Returns string
Inherited from Filesystem.tempName
- Defined in src/util/support/path/Filesystem.ts:217

touch

touch(args: {
storePath: string;
}): Promise<void>
If the file does not exist in the remote filesystem, create it. If it does exist, update the modify timestamps.
Parameters
- args: {
  storePath: string;
  }
  - storePath: string
Returns Promise<void>
Overrides Filesystem.touch
- Defined in src/util/support/path/LocalFilesystem.ts:110

Class LocalFilesystem

Todo

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

baseConfig: LocalFilesystemConfig

Returns LocalFilesystem

Properties

Protected Readonly baseConfig

Methods

close

Returns Awaitable<void>

getMetadata

Parameters

storePath: string

Returns Promise<FileMetadata>

getPath

Parameters

storePath: string

Returns UniversalPath

getPrefix

Example

Example

Returns string

getStoreFileAsStream

Parameters

args: { storePath: string; }

storePath: string

Returns ReadStream | Promise<ReadStream>

getStoreFileAsTemp

Parameters

__namedParameters: { storePath: string; }

storePath: string

Returns Promise<UniversalPath>

list

Parameters

storePath: string

Returns Promise<Collection<string>>

Protected metadataPath

Parameters

storePath: string

Returns string

mkdir

Parameters

args: { storePath: string; }

storePath: string

Returns Promise<void>

Protected normalizeTags

Example

Parameters

Optional tag: string

Optional tags: string[]

Returns string[]

open

Returns Promise<void>

putLocalFile

Example

Parameters

__namedParameters: { localPath: string; mimeType?: string; storePath: string; tag?: string; tags?: string[]; }

localPath: string

Optional mimeType?: string

storePath: string

Optional tag?: string

Optional tags?: string[]

Returns Promise<void>

putStoreFileAsStream

Parameters

args: { storePath: string; }

storePath: string

Returns WriteStream | Promise<WriteStream>

remove

Parameters

args: { recursive?: boolean; storePath: string; }

Optional recursive?: boolean

storePath: string

`Protected` `Readonly` baseConfig

args: {
storePath: string;
}

__namedParameters: {
storePath: string;
}

`Protected` metadataPath

args: {
storePath: string;
}

`Protected` normalizeTags

`Optional` tag: string

`Optional` tags: string[]

__namedParameters: {
localPath: string;
mimeType?: string;
storePath: string;
tag?: string;
tags?: string[];
}

`Optional` mimeType?: string

`Optional` tag?: string

`Optional` tags?: string[]

args: {
storePath: string;
}

args: {
recursive?: boolean;
storePath: string;
}

`Optional` recursive?: boolean

args: {
storePath: string;
}

`Protected` storePath

`Protected` tempName

args: {
storePath: string;
}