@dimerapp/context

Context to be passed around dimer low level libraries

Stats

StarsIssuesVersionUpdatedCreatedSize
@dimerapp/context
302.0.03 years ago3 years agoMinified + gzip package size for @dimerapp/context in KB

Readme

Dimer App

Dimer is an open source project and CMS to help you publish your documentation online.


We believe every project/product is incomplete without documentation.
We want to help you publish user facing documentation, without worrying about tools or code to write.


Dimer Context

Runtime context for dimer

travis-image npm-image

Dimer is a combination of several small modules, joining together to build the final app. Passing user options from top-level to all these libraries can be daunting and hence a context is used to read and write runtime values.

At the lowest level, context starts with the basePath and new values are added, as it is passed through several modules. Also you can debug the actions taken on the context by defining DEBUG environment variable.

DEBUG=dimer:context node yourapp.js

Installation

npm i @dimerapp/context

# Yarn
yarn add @dimerapp/context

Usage

const Context = require('@dimerapp/context')
const ctx = new Context(__dirname)

// later pass around other libs
const config = new (require('@dimerapp/config-parser'))(ctx)
const store = new (require('@dimerapp/datastore'))(ctx)

API

The following methods are available to read/write to the context.

constructor(basePath, [distPath = 'dist'])
const ctx = new Context(__dirname, 'dist')

set(lib, key, value)

The lib option is required for debugging, so that context can log name of the library, which has mutated the state.

ctx.set('config-parser', 'config', value)

get(key)

Get value for a given key. We recommend you not to mutate the return value and instead transform it.

ctx.get('config')

remove(key)

Remove value for a given key

ctx.remove('config')

Change log

The change log can be found in the CHANGELOG.md file.

Contributing

Everyone is welcome to contribute. Please take a moment to review the contributing guidelines.

Authors & License

thetutlage and contributors.

MIT License, see the included MIT file.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.