extension 0.2.0 → 1.1.1

package/lib/string.js

@@ -1,102 +0,0 @@
-'use strict';
-
-var objext = require('./object');
-
-exports.contains = function (source, string, options) {
-  return match.call(this, source, string, options, function(src, str) {
-    return src.indexOf(str) > -1;
-  });
-};
-
-exports.startsWith = function (source, string, options) {
-  return match.call(this, source, string, options, function(src, str) {
-    return src.indexOf(str) === 0;
-  });
-};
-
-exports.endsWith = function (source, string, options) {
-  return match.call(this, source, string, options, function(src, str) {
-    return src.lastIndexOf(str) === (src.length - str.length);
-  });
-};
-
-exports.capitalize = function (source) {
-  if (source === null) {
-    return null;
-  }
-  if (source === '') {
-    return source;
-  }
-
-  source = source || this;
-
-  if (source.length === 1) {
-    return source.toUpperCase();
-  }
-  return source.substring(0, 1).toUpperCase() + source.substring(1);
-};
-
-exports.decapitalize = function (source) {
-  if (source === null) {
-    return null;
-  }
-  if (source === '') {
-    return source;
-  }
-
-  source = source || this;
-
-  if (source.length === 1) {
-    return source.toLowerCase();
-  }
-  return source.substring(0, 1).toLowerCase() + source.substring(1);
-};
-
-exports.camelize = function (source) {
-  if (source === null) {
-    return null;
-  }
-  if (source === '') {
-    return source;
-  }
-
-  source = source || this;
-
-  if (source.length < 2) {
-    return source.toLowerCase();
-  }
-
-  var parts = source.split(/[-_]+/);
-  parts[0] = parts[0].substring(0, 1).toLowerCase() + parts[0].substring(1);
-
-  for (var i = 1; i < parts.length; i++) {
-    parts[i] = exports.capitalize(parts[i]);
-  }
-
-  return parts.join('');
-};
-
-function match(source, str, options, fn) {
-  if (isNotPresent(source)) {
-    return false;
-  }
-  if (this.constructor === String) {
-    options = str;
-    str = source;
-    source = this;
-  }
-  if (!objext.isString(str)) {
-    return false;
-  }
-
-  options = options || {};
-  source = options.ignoreCase ? source.toLowerCase() : source;
-  str = options.ignoreCase ? str.toLowerCase(): str;
-
-  return fn(source, str);
-}
-
-function isNotPresent(obj) {
-  return obj === null || obj === undefined;
-}
-

package/test/array.js

@@ -1,118 +0,0 @@
-var expect = require('chai').expect;
-var arrext = require('../lib/array');
-
-describe('array', function () {
-  describe('#contains', function () {
-    it('should return false when the array is empty', function (done) {
-      expect(arrext.contains([], 1)).to.be.false;
-      expect(arrext.contains.call([], 1)).to.be.false;
-      done();
-    });
-
-    it('should return false when the array does not contain the value', function (done) {
-      expect(arrext.contains([1, 2], 3)).to.be.false;
-      expect(arrext.contains.call([1, 2], 3)).to.be.false;
-      done();
-    });
-
-    it('should return true when the array contains the value', function (done) {
-      expect(arrext.contains([1, 2], 2)).to.be.true;
-      expect(arrext.contains.call([1, 2], 2)).to.be.true;
-      done();
-    });
-  });
-
-  describe('#isEmpty', function () {
-    it('should return true when empty', function (done) {
-      expect(arrext.isEmpty([])).to.be.true;
-      expect(arrext.isEmpty.call([])).to.be.true;
-      done();
-    });
-
-    it('should return false when not empty', function (done) {
-      expect(arrext.isEmpty([1])).to.be.false;
-      expect(arrext.isEmpty.call([1])).to.be.false;
-      done();
-    });
-  });
-
-  describe('#first', function () {
-    it('should return nothing when empty', function (done) {
-      expect(arrext.first([], function () {})).to.not.be.present;
-      expect(arrext.first.call([], function () {})).to.not.be.present;
-      done();
-    });
-
-    it('should return nothing when no match is found', function (done) {
-      expect(arrext.first([1, 2], function () { return false; })).to.not.be.present;
-      expect(arrext.first.call([1, 2], function () { return false; })).to.not.be.present;
-      done();
-    });
-
-    it('should the first value for which the passed function returns true', function (done) {
-      expect(arrext.first([1, 2, 3], function (item) { return item > 1; })).to.equal(2);
-      expect(arrext.first.call([1, 2, 3], function (item) { return item > 1; })).to.equal(2);
-      done();
-    });
-  });
-
-  describe('#sortCaseInsensitive', function () {
-    it('should return true when empty', function (done) {
-      var result = arrext.sortCaseInsensitive(['az', 'Ab', 'aa', 1]);
-      expect(result).to.eql([1, 'aa', 'Ab', 'az']);
-      done();
-    });
-  });
-
-  describe('#groupBy', function () {
-    it('should group by name', function (done) {
-      var result = arrext.groupBy([
-        { name: 'bin1', value: 1 },
-        { name: 'bin2', value: 2 },
-        { name: 'bin1', value: 3 },
-        { name: 'bin3', value: 4 },
-        { name: 'bin2', value: 5 }
-      ], function (item) { return item.name });
-
-      expect(result).to.eql({
-        'bin1': [
-          { name: 'bin1', value: 1 },
-          { name: 'bin1', value: 3 }
-        ],
-        'bin2': [
-          { name: 'bin2', value: 2 },
-          { name: 'bin2', value: 5 }
-        ],
-        'bin3': [
-          { name: 'bin3', value: 4 }
-        ]
-      });
-      done();
-    });
-
-    it('should group by name (this)', function (done) {
-      var result = arrext.groupBy.call([
-        { name: 'bin1', value: 1 },
-        { name: 'bin2', value: 2 },
-        { name: 'bin1', value: 3 },
-        { name: 'bin3', value: 4 },
-        { name: 'bin2', value: 5 }
-      ], function (item) { return item.name });
-
-      expect(result).to.eql({
-        'bin1': [
-          { name: 'bin1', value: 1 },
-          { name: 'bin1', value: 3 }
-        ],
-        'bin2': [
-          { name: 'bin2', value: 2 },
-          { name: 'bin2', value: 5 }
-        ],
-        'bin3': [
-          { name: 'bin3', value: 4 }
-        ]
-      });
-      done();
-    });
-  });
-});

package/test/extension.js

@@ -1,239 +0,0 @@
-var expect = require('chai').expect;
-var ext = require('../lib/extension');
-
-describe('extension', function () {
-  describe('#register', function () {
-    it('should throw an exception if given a null or undefined object to extend', function (done) {
-      expect(ext.register.bind(this, null)).to.
-      throw(Error);
-      expect(ext.register.bind(this, undefined)).to.
-      throw(Error);
-      done();
-    });
-
-    it('should throw an exception if given a null or undefined extension object', function (done) {
-      expect(ext.register.bind(this, String.prototype, null)).to.
-      throw(Error);
-      expect(ext.register.bind(this, String.prototype, undefined)).to.
-      throw(Error);
-      done();
-    });
-
-    it('should do nothing if passed an empty extension object', function (done) {
-      var obj = {};
-      ext.register(obj, {});
-      ext.use(obj);
-      expect(Object.keys(obj)).to.be.empty;
-      done();
-    });
-
-    it('should create a new empty set of extensions the first time an object is extended', function (done) {
-      var obj = {};
-      var exts = ext.find(obj);
-      expect(exts).to.be.undefined;
-      ext.register(obj, { hello: true });
-      exts = ext.find(obj);
-      expect(exts).to.have.keys('hello');
-      done();
-    });
-
-    it('should register the extension given valid arguments', function (done) {
-      var obj = {};
-      ext.register(obj, { hello: true });
-      ext.register(obj, { goodbye: true });
-      var exts = ext.find(obj);
-      expect(Object.keys(exts)).to.have.length(2);
-      expect(exts).to.have.keys('hello', 'goodbye');
-      expect(exts).to.have.keys('hello', 'goodbye');
-      expect(exts.hello).to.be.true;
-      expect(exts.goodbye).to.be.true;
-      done();
-    });
-  });
-
-  describe('#find', function () {
-    it('should throw an exception if passed a null or undefined value', function (done) {
-      expect(ext.find.bind(this, null)).to.
-      throw(Error);
-      expect(ext.find.bind(this, undefined)).to.
-      throw(Error);
-      done();
-    });
-
-    it('should return undefined if no extensions are registered for the object', function (done) {
-      expect(ext.find({})).to.be.undefined;
-      done();
-    });
-
-    it('should return the registered extensions as an object', function (done) {
-      var obj = {};
-      ext.register(obj, { hello: true });
-      ext.register(obj, { goodbye: true });
-      var exts = ext.find(obj);
-      expect(Object.keys(exts)).to.have.length(2);
-      expect(exts).to.have.keys('hello', 'goodbye');
-      expect(exts).to.have.keys('hello', 'goodbye');
-      expect(exts.hello).to.be.true;
-      expect(exts.goodbye).to.be.true;
-      done();
-    });
-  });
-
-  describe('#use', function () {
-    it('should throw an exception if given a null or undefined object on which to use extensions', function (done) {
-      expect(ext.use.bind(this, null)).to.
-      throw(Error);
-      expect(ext.use.bind(this, undefined)).to.
-      throw(Error);
-      done();
-    });
-
-    it('should permantly apply an extension to an object if not passed a scoping function', function (done) {
-      var obj = {};
-      ext.register(obj, { hello: function () {
-        done();
-      }});
-      expect(obj.hello).to.be.undefined;
-      ext.use(obj, 'hello');
-      expect(obj.hello).not.to.be.undefined;
-      obj.hello();
-    });
-
-    it('should remove used extensions from an object after the scoping function has executed', function (done) {
-      var obj = {};
-      var run = false;
-      ext.register(obj, { hello: function () {
-        run = true;
-      }});
-      expect(obj.hello).to.be.undefined;
-      ext.use(obj, 'hello', function () {
-        obj.hello();
-      });
-      expect(obj.hello).to.be.undefined;
-      expect(run).to.be.true;
-      done();
-    });
-
-    it('should not overwrite existing properties', function (done) {
-      var obj = {
-        hello: true
-      };
-      ext.register(obj, { hello: false });
-
-      ext.use(obj, 'hello');
-      expect(obj.hello).to.be.true;
-      ext.use(obj, 'hello', function () {
-        expect(obj.hello).to.be.true;
-      });
-      done();
-    });
-
-    it('should allow multiple property extensions to be applied at once within a scope', function (done) {
-      var obj = {};
-      var runHello = false;
-      var runWorld = false;
-
-      ext.register(obj, { hello: function () {
-        runHello = true;
-      }});
-      ext.register(obj, { world: function () {
-        runWorld = true;
-      }});
-
-      expect(obj.hello).to.be.undefined;
-      expect(obj.world).to.be.undefined;
-
-      ext.use(obj, ['hello', 'world'], function () {
-        obj.hello();
-        obj.world();
-      });
-
-      expect(obj.hello).to.be.undefined;
-      expect(obj.world).to.be.undefined;
-      expect(runHello).to.be.true;
-      expect(runWorld).to.be.true;
-      done();
-    });
-
-    it('should use all registered extensions if none are specified', function (done) {
-      var obj = {};
-      var runHello = false;
-      var runWorld = false;
-
-      ext.register(obj, { hello: function () {
-        runHello = true;
-      }});
-      ext.register(obj, { world: function () {
-        runWorld = true;
-      }});
-
-      expect(obj.hello).to.be.undefined;
-      expect(obj.world).to.be.undefined;
-
-      ext.use(obj, function () {
-        obj.hello();
-        obj.world();
-      });
-
-      expect(obj.hello).to.be.undefined;
-      expect(obj.world).to.be.undefined;
-      expect(runHello).to.be.true;
-      expect(runWorld).to.be.true;
-      done();
-    })
-
-    it('should not show up in a foreach', function (done) {
-      var obj = {};
-
-      ext.register(obj, { hello: function () {
-      }});
-
-      ext.use(obj, function () {
-        var keys = [];
-        for (var k in obj) {
-          keys.push(k);
-        }
-        expect(keys).to.be.eql([]);
-        expect(obj.hello).not.to.be.undefined;
-        done();
-      });
-    });
-  });
-
-  describe('#registerAndUse', function () {
-    it('should throw an exception if given a null or undefined object to extend', function (done) {
-      expect(ext.registerAndUse.bind(this, null)).to.
-      throw(Error);
-      expect(ext.registerAndUse.bind(this, undefined)).to.
-      throw(Error);
-      done();
-    });
-
-    it('should throw an exception if given a null or undefined extension object', function (done) {
-      expect(ext.registerAndUse.bind(this, String.prototype, null)).to.
-      throw(Error);
-      expect(ext.registerAndUse.bind(this, String.prototype, undefined)).to.
-      throw(Error);
-      done();
-    });
-
-    it('should do nothing if passed an empty extension object', function (done) {
-      var obj = {};
-      ext.registerAndUse(obj, {});
-      expect(Object.keys(obj)).to.be.empty;
-      done();
-    });
-
-    it('should not have a conflict with keys having the same toString value', function (done) {
-      var obj1 = {};
-      var obj2 = {};
-      ext.registerAndUse(obj1, { a: true });
-      ext.registerAndUse(obj2, { b: true });
-      expect(obj1.a).to.be.true;
-      expect(obj1.b).to.be.undefined;
-      expect(obj2.a).to.be.undefined;
-      expect(obj2.b).to.be.true;
-      done();
-    });
-  });
-});

package/test/object.js

@@ -1,160 +0,0 @@
-var expect = require('chai').expect;
-var objext = require('../lib/object');
-
-describe('object', function () {
-  describe('#isString', function () {
-    it('should return false when passed a null or undefined value', function (done) {
-      expect(objext.isString(null)).to.be.false;
-      expect(objext.isString(undefined)).to.be.false;
-      done();
-    });
-
-    it('should return true when passed a string', function (done) {
-      expect(objext.isString('')).to.be.true;
-      expect(objext.isString.call('')).to.be.true;
-      done();
-    });
-
-    it('should return false when passed anything other than a string', function (done) {
-      expect(objext.isString(4)).to.be.false;
-      expect(objext.isString([])).to.be.false;
-      expect(objext.isString(function () {})).to.be.false;
-      expect(objext.isString({})).to.be.false;
-      done();
-    });
-  });
-
-  describe('#isFunction', function () {
-    it('should return false when passed a null or undefined value', function (done) {
-      expect(objext.isFunction(null)).to.be.false;
-      expect(objext.isFunction(undefined)).to.be.false;
-      done();
-    });
-
-    it('should return true when passed a function', function (done) {
-      expect(objext.isFunction(function () {})).to.be.true;
-      expect(objext.isFunction.call(function () {})).to.be.true;
-      done();
-    });
-
-    it('should return false when passed anything other than a function', function (done) {
-      expect(objext.isFunction(4)).to.be.false;
-      expect(objext.isFunction([])).to.be.false;
-      expect(objext.isFunction({})).to.be.false;
-      expect(objext.isFunction('')).to.be.false;
-      done();
-    });
-  });
-
-  describe('#isArray', function () {
-    it('should return false when passed a null or undefined value', function (done) {
-      expect(objext.isArray(null)).to.be.false;
-      expect(objext.isArray(undefined)).to.be.false;
-      done();
-    });
-
-    it('should return true when passed an array', function (done) {
-      expect(objext.isArray([])).to.be.true;
-      expect(objext.isArray.call([])).to.be.true;
-      done();
-    });
-
-    it('should return false when passed anything other than an array', function (done) {
-      expect(objext.isArray(4)).to.be.false;
-      expect(objext.isArray(function () {})).to.be.false;
-      expect(objext.isArray({})).to.be.false;
-      expect(objext.isArray('')).to.be.false;
-      done();
-    });
-  });
-
-  describe('#isNumber', function () {
-    it('should return false when passed a null or undefined value', function (done) {
-      expect(objext.isNumber(null)).to.be.false;
-      expect(objext.isNumber(undefined)).to.be.false;
-      done();
-    });
-
-    it('should return true when passed a number', function (done) {
-      expect(objext.isNumber(7)).to.be.true;
-      expect(objext.isNumber.call(7)).to.be.true;
-      done();
-    });
-
-    it('should return false when passed anything other than a number', function (done) {
-      expect(objext.isNumber(function () {})).to.be.false;
-      expect(objext.isNumber([])).to.be.false;
-      expect(objext.isNumber({})).to.be.false;
-      expect(objext.isNumber('')).to.be.false;
-      done();
-    });
-  });
-
-  describe('#isObject', function () {
-    it('should return false when passed a null or undefined value', function (done) {
-      expect(objext.isObject(null)).to.be.false;
-      expect(objext.isObject(undefined)).to.be.false;
-      done();
-    });
-
-    it('should return true when passed an object', function (done) {
-      expect(objext.isObject({})).to.be.true;
-      expect(objext.isObject.call({})).to.be.true;
-      done();
-    });
-
-    it('should return false when passed anything other than an object', function (done) {
-      expect(objext.isObject(function () {})).to.be.false;
-      expect(objext.isObject([])).to.be.false;
-      expect(objext.isObject(4)).to.be.false;
-      expect(objext.isObject('')).to.be.false;
-      done();
-    });
-  });
-
-  describe('#isEmpty', function () {
-    it('should return true if passed a null or undefined value', function (done) {
-      expect(objext.isEmpty(null)).to.be.true;
-      expect(objext.isEmpty.call(null)).to.be.true;
-      expect(objext.isEmpty(undefined)).to.be.true;
-      expect(objext.isEmpty.call(undefined)).to.be.true;
-      done();
-    });
-
-    it('should return true if the object has no keys', function (done) {
-      expect(objext.isEmpty({})).to.be.true;
-      expect(objext.isEmpty.call({})).to.be.true;
-      expect(objext.isEmpty({ a: 1 })).to.be.false;
-      expect(objext.isEmpty.call({ a: 1 })).to.be.false;
-      done();
-    });
-
-    it('should return false if not null, undefined, an array, or an object containing keys', function (done) {
-      expect(objext.isEmpty(4)).to.be.false;
-      expect(objext.isEmpty(function () {})).to.be.false;
-      done();
-    });
-
-    it('should return true for an empty array', function (done) {
-      expect(objext.isEmpty([])).to.be.true;
-      expect(objext.isEmpty.call([])).to.be.true;
-      expect(objext.isEmpty([1])).to.be.false;
-      expect(objext.isEmpty.call([1])).to.be.false;
-      done();
-    });
-  });
-
-  describe('#toArray', function () {
-    it('should create an array of key, value objects', function (done) {
-      expect(objext.toArray({ a: 1, b: 2 })).to.be.eql([
-        { key: 'a', value: 1 },
-        { key: 'b', value: 2 }
-      ]);
-      expect(objext.toArray.call({ a: 1, b: 2 })).to.be.eql([
-        { key: 'a', value: 1 },
-        { key: 'b', value: 2 }
-      ]);
-      done();
-    });
-  });
-});