npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

consul-kv-object

v1.1.0

Published

Store and retrive POJsO from consul keystore

Downloads

168

Readme

consul-kv-object

Build Status Coverage Status

Store and retrive POJsO from consul keystore.

NPM

Usage

npm install --save consul-kv-object
var consul = require('consul')();
var kv = require('consul-kv-object')(consul.kv);

kv.set("test/key",{ pojo: true, nested: { yep: "asd" } });
kv.get("test/key", function( err, res ) { } );
kv.del("test/key");

Options

Options are passed as optional second parameter.

| Option | Default | Meaning | |--------------|-----------|---------| | mapTypes | true | Perform type mapping when setting and getting | guessTypes | false | Try to guess types when reading value with flags==0 | defaultType | see below | Default type to use when flag is not recognized | typeMapFlags | see below | Type mapping array | concurrency | 10 | Number of concurrent consul connections when setting values

Type mapping

Types are preserved using flags and flag mapping array. Each type has other flag value. When flag is not recognized or type mapping is disabled, consul-kv-object returns strings.

Type guessing

When using guessTypes: true consul-kv-object will try to convert consul keys to Numbers, Booleans and Dates based on built-in heuristic. Type guessing requires enabled type mapping. Types determined by flags have priority.

Aim of type guessing is to allow operator to manually instert value into consul keystore.

Default

By default consul-kv-object understands and maps following types:

  • String
  • Number
  • Boolean
  • Date

Custom

Other types can be mapped to be understood by consul-kv-object. To use custom types, pass a flag mapping array as typeMapFlags option. It should consits of:

[
    { match: Function, make: Function, guess: Function }, // flags: 0
    { match: Function, make: Function, guess: Function }, // flags: 1
    { match: Function, make: Function, guess: Function },    
    [...]   
]
  • match is the constructor function of your object, the one which is in instance.constructor.
  • make is a factory function which takes a string and returns instance of your object.
  • guess is a filter function, that takes a string and returns true if it is valid string representation of this type.

Objects used with consul-kv-object should have .toString method with enough representation to re-construct object with make call.

Build and testing

Basic tests:

npm test

Test coverage:

npm run coverage

Acceptance tests with live consul:

consul agent -bootstrap -server -advertise=127.0.0.1 -data-dir=/tmp/ &
npm run acceptance