mergee - npm Package Compare versions

Comparing version 0.2.2 to 0.2.3

index.js

@@ -104,2 +104,3 @@ /**
 exports.extend = extend;
+exports.assign = extend;
 
@@ -106,0 +107,0 @@ /**

package.json

 {
   "name": "mergee",
   "description": "Utilities for objects",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "main": "index.js",
@@ -6,0 +6,0 @@ "engines": {

README.md

@@ -10,3 +10,4 @@ # mergee
 
-* extend - extends a target object with multiple sources
+* assign - assigns multiple sources to a target object
+* extend - (same as assign) extends a target object with multiple sources
 * merge - merge multiple sources into a target object
@@ -26,2 +27,3 @@ * mergeExt - same as merge but with options
 * [Methods](#methods)
+  * [assign(target, source)](#assigntarget-source)
   * [extend(target, source)](#extendtarget-source)
@@ -44,5 +46,40 @@ * [merge(target, source)](#mergetarget-source)
 
+### assign(target, source)
 
+assign multiple `source` objects to object `target`
+
+#### Example
+
+````js
+var assign  = require('mergee').assign,
+    target  = { a:{A:1}, b:{A:1} },
+    source1 = { b:{B:2}, c:{B:2} },
+    source2 = { d:{C:3} };
+assign(target, source1, source2);
+// target === { a:{A:1}, b:{B:2}, c:{B:2}, d:{C:3} };
+````
+
+**Parameters**
+
+**target**: `Object | Array | function`, assign multiple `source` objects to object `target`
+
+#### Example
+
+````js
+var assign  = require('mergee').assign,
+    target  = { a:{A:1}, b:{A:1} },
+    source1 = { b:{B:2}, c:{B:2} },
+    source2 = { d:{C:3} };
+assign(target, source1, source2);
+// target === { a:{A:1}, b:{B:2}, c:{B:2}, d:{C:3} };
+````
+
+**source**: `Any`, arguments 2 ... n
+
+**Returns**: `Object`, assigned target
+
 ### extend(target, source)
 
+Same as `assign`.
+
 extend object `target` with multiple `source` objects
@@ -314,7 +351,1 @@
 [LICENSE]: ./LICENSE
-
-
-
-
-
-

test/index.mocha.js

@@ -159,3 +159,12 @@ 'use strict';
 	});
-
+	it('assigning arrays of objects',function(){
+		var s1 = { a: [ {a: 1} , {b: 2}, 3 ] };
+		var s2 = { b: [ 3, {e: 4}, {f: 5} ] };
+		var s3 = { b: [ {g: 6} ] };
+		var res = M.assign (s1, s2, s3);
+		assert.deepEqual(res, {
+			a: [ {a: 1} , {b: 2}, 3 ],
+			b: [ {g: 6} ]
+		});
+	});
 });
@@ -162,0 +171,0 @@

No alert changes

Improved metrics

Total package byte prevSize

47349

increased by2.63%

Lines of code

1355

increased by0.82%

Number of lines in readme file

348

increased by9.78%

No dependency changes