revampjs v0.2.0

revampjs

Inspired by ES6 deconstruct. A safe extract of js object properties into a new object

I am still working on the ergonomics of this helper library so breaking changes are to be expected at the moment. Please feel free to open an issue if you have any suggestion.

Why revampjs?

ES6 brings to javascript a whole load of cool new features. Among them I find myself using the deconstruct operator pretty often. However, I also often want to group the extracted variables within one object so I wish there was this kind of syntax available:

// do not try this, it will not work!
const myNewObject = {a, b, c} = mySourceObject

So I ended up writing helper functions to do the result object wrapping. As it was becoming repetitive, I tried to wrap it up into this library. I hope it can useful for others as well.

Features

• Safely extract any value(s) (nested or not) from a source object
• Rename extracted properties in destination object

• Ligh-version for simply picking properties

• Travis CI to run test suite

Changelog (0.2.0)

• Support for ImmutableJS objects

Plan

• Finaliwe syntax of parameter for values extraction
• Add test cases to demo the usage with ImmutableJS
• Support of an equivalent of {...rest} from ES6 (maybe)
• Add warning when attempting to access a palsy key

Getting started

install revampjs

• with npm

npm install --save revampjs

• or with yarn

yarn add revampjs

import and use revampjs

• using require

const revamp = require('revampjs');

• or using ES6 import (not tested yet)

import * as revamp from 'revampjs';

const sourceObject = {
  a: 42,
  b: 'hello',
  c: 'world',
  d: '!',
  e: {
    f: 'nested value'
  }
}

const myNewObject = revamp.pick(sourceObject, ['b', 'c']);

const myNewObjectRevamped = revamp.extract(sourceObject, {
  newKey: 'b',
  newKeyForNested: 'e.f'
});

using with ImmutableJS

Both functions pick and extract accept a third optional parameter isSrcImmutable. If you pass true to this value, then the functions will consider the src parameter as an ImmutableJS object.

Please note that:

• this feature has just been added and test coverage has not been updated yet.
• this library itself does not use ImmutableJS. Therefore the returned object is never an ImmutableJS object (though each extracted value is).
• the extract function assumes that the whole src object and its properties are immutable.