uttori-storage-provider-json-file v2.4.0

Uttori Storage Provider - JSON File

Uttori storage provider using JSON files on disk.

Install

npm install --save uttori-storage-provider-json-file

Config

{
  content_dir: '',
  history_dir: '',
  extension: 'json',
  spaces_document: null,
  spaces_history: null,
}

API Reference

StorageProvider

Storage for Uttori documents using JSON files stored on the local file system.

Kind: global class
Properties

• StorageProvider
  • new StorageProvider(config)
  • .all() ⇒ Promise
  • .tags() ⇒ Promise
  • .getQuery(query) ⇒ Promise
  • .get(slug) ⇒ Promise
  • .getHistory(slug) ⇒ Promise
  • .getRevision(slug, revision) ⇒ Promise
  • .add(document)
  • .updateValid(document, originalSlug) ℗
  • .update(document, originalSlug)
  • .delete(slug)
  • .refresh()
  • .updateHistory(slug, content, originalSlug)

new StorageProvider(config)

Creates an instance of StorageProvider.

Example (Init StorageProvider)

const storageProvider = new StorageProvider({ content_dir: 'content', history_dir: 'history', spaces_document: 2 });

storageProvider.all() ⇒ Promise

Returns all documents.

Kind: instance method of StorageProvider
Returns: Promise - Promise object represents all documents.
Example

storageProvider.all();
➜ [{ slug: 'first-document', ... }, ...]

storageProvider.tags() ⇒ Promise

Returns all unique tags.

Kind: instance method of StorageProvider
Returns: Promise - Promise object represents all documents.
Example

storageProvider.tags();
➜ ['first-tag', ...]

storageProvider.getQuery(query) ⇒ Promise

Returns all documents matching a given query.

Kind: instance method of StorageProvider
Returns: Promise - Promise object represents all matching documents.

storageProvider.get(slug) ⇒ Promise

Returns a document for a given slug.

Kind: instance method of StorageProvider
Returns: Promise - Promise object represents the returned UttoriDocument.

storageProvider.getHistory(slug) ⇒ Promise

Returns the history of edits for a given slug.

Kind: instance method of StorageProvider
Returns: Promise - Promise object represents the returned history.

storageProvider.getRevision(slug, revision) ⇒ Promise

Returns a specifc revision from the history of edits for a given slug and revision timestamp.

Kind: instance method of StorageProvider
Returns: Promise - Promise object represents the returned revision of the document.

storageProvider.add(document)

Saves a document to the file system.

Kind: instance method of StorageProvider

storageProvider.updateValid(document, originalSlug) ℗

Updates a document and saves to the file system.

Kind: instance method of StorageProvider
Access: private

storageProvider.update(document, originalSlug)

Updates a document and figures out how to save to the file system.

Kind: instance method of StorageProvider

storageProvider.delete(slug)

Removes a document from the file system.

Kind: instance method of StorageProvider

storageProvider.refresh()

Reloads all documents from the file system into the cache.

Kind: instance method of StorageProvider

storageProvider.updateHistory(slug, content, originalSlug)

Updates History for a given slug, renaming the store file and history folder as needed.

Kind: instance method of StorageProvider

Tests

To run the test suite, first install the dependencies, then run npm test:

npm install
npm test
DEBUG=Uttori* npm test

Contributors

• Matthew Callis

License

• MIT