add $.copy for 1.0.0

CHANGELOG.md

@@ -1,3 +1,9 @@
+1.0.0 / 2014-09-30
+==================
+  * Add `$.copy` to shallow copy an element
+  * `$.constant(n)` now uses `$.copy`
+  * `$.replicate(o)` now uses `$.copy` (thus will additionally copy objects)
+
 0.5.2 / 2014-09-02
 ==================
   * Move coverage to tests area to avoid confusing browserify

autonomy.js

@@ -27,9 +27,19 @@ $.id = function (x) {
 $.noop = function () {
 };
 
+$.copy = function (val) {
+  if (Array.isArray(val)) {
+    return val.slice();
+  }
+  if (val === Object(val)) {
+    return $.extend({}, val);
+  }
+  return val;
+};
+
 $.constant = function (val) {
   return function () {
-    return val;
+    return $.copy(val);
   };
 };
 
@@ -171,7 +181,7 @@ $.range = function (start, stop, step) {
 $.replicate = function (times, el) {
   var res = [];
   for (var i = 0; i < times; i += 1) {
-    res.push(Array.isArray(el) ? el.slice() : el);
+    res.push($.copy(el));
   }
   return res;
 };

test/basic.js

@@ -133,3 +133,29 @@ exports.get = function (t) {
   t.deepEqual(objs.map($.get('ZZ', 'AA')).filter(op.neq()), [], "harvest shallow undefs");
   t.done();
 };
+
+exports.constant = function (t) {
+  var o = {bah: 'woot'};
+  var fno = $.constant(o);
+  var ocpy = fno();
+  t.deepEqual(o, ocpy, 'constant copies properties');
+  ocpy.hi = 'there';
+  t.equal(o.hi, undefined, 'constant returns new copy of object');
+
+  var a = [1];
+  var fna = $.constant(a);
+  var acpy = fna();
+  t.deepEqual(acpy, a, 'constant copies array contents shallowly');
+  acpy.push(2);
+  t.equal(a.length, 1, 'constant slices arrays so leaves original unmodified');
+
+  // other types do not need copying as they are not returned by reference:
+  var s = "hi";
+  var fns = $.constant(s);
+  var scpy = fns();
+  t.equal(s, scpy, 'constant copies string');
+  scpy = 'bi';
+  t.equals(s, 'hi', 'we did not overwrite original');
+
+  t.done();
+};