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
  • keys: Array
  • value: Any
  • 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
  • keys: Array
  • value: Any
  • data: Object, Array

Cycni.add(opt)

Errors if any key in the keys does not exists on the collection or if the you try to set a key that already exists.

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

Cycni.remove(opt)

Returns any removed data.

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

Cycni.has(opt)

Returns true or false.

• opt: Object
  • keys: Array
  • value: Any
  • 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
  • keys: Array if the value is ['.'] then the size of the top level element will be provided
  • value: Any
  • 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
  • keys: Array
  • value: Any
  • 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