node package manager
It’s your turn. Help us improve JavaScript. Take the 2017 JavaScript Ecosystem Survey »

cycni

Cycni

A collection manipulation tool

Overview

Cycni enables the ability to manipulation and interact with an infinitely deep collection. It provides an interface to manipulate Objects and Arrays in a seamless and consistent method. Now using async/await.

Install

  • npm i cycni --save
  • UMD dist/cycni.js
  • ESMD src/cycni.js

Examples

let data =  {
    id: '0',
    name: 'Cake',
    batters: [
        { id: 'zero', type: 'Regular' },
        { id: 'one', type: 'Chocolate' },
        { id: 'two', type: 'Blueberry' }
    ]
};
 
let res, opt = {
    data: data,
    keys: ['batters', 0]
};
 
try {
    res = await Cycni.remove(opt);
} catch (e) {
    console.error(e);
}
 
console.log(data); /*
    {
        id: '0',
        name: 'Cake',
        batters: [
            { id: 'one', type: 'Chocolate' },
            { id: 'two', type: 'Blueberry' }
        ]
   }
*/
 
console.log(res); /*
    { id: 'zero', type: 'Regular' }
*/

Api

Cycni.get(opt)

Returns the retrieved value.

  • opt: Object
    • value: Any
    • keys: Array
    • data: Object, Array

Cycni.set(opt)

If a key does not exists and the key is a String then an Object is created. If a key does not exists and the key is a Number then an Array is created. If the key already exists it overwrites that value.

  • opt: Object
    • value: Any
    • keys: Array
    • data: Object, Array

Cycni.add(opt)

If a key in the keys does not exist or if you try to set a key that already exists this will throw an error.

  • opt: Object
    • value: Any
    • keys: Array
    • data: Object, Array

Cycni.push(opt)

Dynamically pushes data to an Array or Object. If pushing to an Object then a key will auto generate in the form of _N N being the length.

  • opt: Object
    • value: Any
    • keys: Array
      • ['.'] top level reference
    • data: Object, Array

Cycni.remove(opt)

Returns any removed data.

  • opt: Object
  • value: Any
    • keys: Array
    • data: Object, Array

Cycni.has(opt)

Returns true or false.

  • opt: Object
    • value: Any
    • keys: Array
    • data: Object, Array

Cycni.size(opt)

Returns the length of the Array or the length of the Keys if it is an object.

  • opt: Object
    • value: Any
    • keys: Array
      • ['.'] top level reference
    • data: Object, Array

Cycni.traverse(opt)

Returns an Object with two properties. The last key in the keys array res.key. The parent of the last key in the keys array res.data.

  • opt: Object
    • value: Any
    • keys: Array
    • data: Object, Array

Cycni.clone(Any)

Returns a clone.

Authors

AlexanderElias

License

Why You Should Choose MPL-2.0 This project is licensed under the MPL-2.0 License