@jsvfs/core

The JavaScript Virtual File System - an extensible engine for file operations.

Usage no npm install needed!

<script type="module">
  import jsvfsCore from 'https://cdn.skypack.dev/@jsvfs/core';
</script>

README

JSVFS Core: JavaScript Virtual File System

The core module for JS Virtual File System. Provides the main VirtualFileSystem class with just enough back-end to get started with in-memory file hierarchy.

Installation

Get it from npm:

npm install --save @jsvfs/core

Supported adapters

Without an adapter which implements a persistent storage, the JS Virtual File System will simply be a non-persistent store. These are the officially supported adapters.

Other adapters

Other adapters can be found using the keyword "jsvfs adapter".

Using adapters

Adapters should be constructed first and passed to the VirtualFileSystem class when constructing it. Make sure to read the documentation closely for a given adapter so that it has the appropriate options for accessing and manipulating the persistent storage it implements.

import { NodeFSAdapter } from '@jsvfs/adapter-node-fs'
import { VirtualFileSystem } from '@jsvfs/core'

const adapter = new NodeFSAdapter({ cwd: '/my/path/' })
const vfs = new VirtualFileSystem(adapter)

Developing adapters

Work on complete documentation for writing adapters is coming. For now, start with the code for @jsvfs/types and read through the interface provided for adapters. Consider the Node fs adapter to be the reference implementation and take a look at how it implements the interface.

If the adapter implements a storage which is widely used, consider forking the jsvfs repository and contributing the adapter as a module. Assuming that this is the route you take, familiarity with TypeScript and Lerna are a must.

Otherwise, you can simply release your module on NPM or another package repository. If you'd like it to be discoverable relative to jsvfs, please use the keyword "jsvfs adapter" in your package.json.

Documentation

Complete documentation of jsvfs can be found at the jsvfs site.