move functions to commonjs modules

closes #355

Author: Christoph Hermann

.gitignore

@@ -3,3 +3,4 @@
 .project
 .tmp_*
 node_modules
+underscore.string.compiled.js

.travis.yml

@@ -1,8 +1,3 @@
 language: node_js
 node_js:
   - "0.11"
-
-before_script:
-  - "export DISPLAY=:99.0"
-  - "sh -e /etc/init.d/xvfb start"
-  - sleep 2

README.markdown

@@ -22,7 +22,7 @@ _("   epeli  ").chain().trim().capitalize().value()
 
 ## Download ##
 
-  * [Development version](https://raw.github.com/epeli/underscore.string/master/lib/underscore.string.js) *Uncompressed with Comments 18kb*
+  * [Development version](https://raw.github.com/epeli/underscore.string/master/underscore.string.js) *Uncompressed with Comments 18kb*
   * [Production version](https://github.com/epeli/underscore.string/raw/master/dist/underscore.string.min.js) *Minified 7kb*
 
 
@@ -38,6 +38,16 @@ _("   epeli  ").chain().trim().capitalize().value()
 var _s = require('underscore.string');
 ```
 
+**Import specific modules (browserify/node)**:
+
+```javascript
+var capitalize = require('underscore.string/capitalize');
+var trim = require('underscore.string/trim');
+
+capitalize(trim("   epeli  "));
+=> "Epeli"
+```
+
 **Integrate with Underscore.js**:
 
 ```javascript

bower.json

@@ -17,7 +17,7 @@
     "underscore",
     "string"
   ],
-  "main": "./lib/underscore.string.js",
+  "main": "./underscore.string.js",
   "repository": {
     "type": "git",
     "url": "https://github.com/epeli/underscore.string.git"

camelize.js

@@ -0,0 +1,7 @@
+var trim = require('./trim');
+
+module.exports = function camelize(str) {
+  return trim(str).replace(/[-_\s]+(.)?/g, function(match, c) {
+    return c ? c.toUpperCase() : "";
+  });
+};

capitalize.js

@@ -0,0 +1,6 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function capitalize(str) {
+  str = makeString(str);
+  return str.charAt(0).toUpperCase() + str.slice(1);
+};

chars.js

@@ -0,0 +1,5 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function chars(str) {
+  return makeString(str).split('');
+};

chop.js

@@ -0,0 +1,6 @@
+module.exports = function chop(str, step) {
+  if (str == null) return [];
+  str = String(str);
+  step = ~~step;
+  return step > 0 ? str.match(new RegExp('.{1,' + step + '}', 'g')) : [str];
+};

classify.js

@@ -0,0 +1,6 @@
+var capitalize = require('./capitalize');
+var camelize = require('./camelize');
+
+module.exports = function classify(str) {
+  return capitalize(camelize(String(str).replace(/[\W_]/g, ' ')).replace(/\s/g, ''));
+};

clean.js

@@ -0,0 +1,5 @@
+var trim = require('./trim');
+
+module.exports = function clean(str) {
+  return trim(str).replace(/\s+/g, ' ');
+};

component.json

@@ -6,6 +6,6 @@
   "keywords": ["underscore", "string"],
   "dependencies": {},
   "development": {},
-  "main": "lib/underscore.string.js",
-  "scripts": ["lib/underscore.string.js"]
+  "main": "underscore.string.js",
+  "scripts": ["underscore.string.js"]
 }

count.js

@@ -0,0 +1,19 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function(str, substr) {
+  str = makeString(str);
+  substr = makeString(substr);
+
+  var count = 0,
+    pos = 0,
+    length = substr.length;
+
+  while (true) {
+    pos = str.indexOf(substr, pos);
+    if (pos === -1) break;
+    count++;
+    pos += length;
+  }
+
+  return count;
+};

dasherize.js

@@ -0,0 +1,5 @@
+var trim = require('./trim');
+
+module.exports = function dasherize(str) {
+  return trim(str).replace(/([A-Z])/g, '-$1').replace(/[-_\s]+/g, '-').toLowerCase();
+};

decapitalize.js

@@ -0,0 +1,6 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function decapitalize(str) {
+  str = makeString(str);
+  return str.charAt(0).toLowerCase() + str.slice(1);
+};

endsWith.js

@@ -0,0 +1,13 @@
+var makeString = require('./helper/makeString');
+var toPositive = require('./helper/toPositive');
+
+module.exports = function endsWith(str, ends, position) {
+  str = makeString(str);
+  ends = '' + ends;
+  if (typeof position == 'undefined') {
+    position = str.length - ends.length;
+  } else {
+    position = Math.min(toPositive(position), str.length) - ends.length;
+  }
+  return position >= 0 && str.indexOf(ends, position) === position;
+};

escapeHTML.js

@@ -0,0 +1,12 @@
+var makeString = require('./helper/makeString');
+var escapeChars = require('./helper/escapeChars');
+var reversedEscapeChars = {};
+
+for(var key in escapeChars) reversedEscapeChars[escapeChars[key]] = key;
+reversedEscapeChars["'"] = '#39';
+
+module.exports = function escapeHTML(str) {
+  return makeString(str).replace(/[&<>"']/g, function(m) {
+    return '&' + reversedEscapeChars[m] + ';';
+  });
+};

exports.js

@@ -0,0 +1,10 @@
+module.exports = function() {
+  var result = {};
+
+  for (var prop in this) {
+    if (!this.hasOwnProperty(prop) || prop.match(/^(?:include|contains|reverse)$/)) continue;
+    result[prop] = this[prop];
+  }
+
+  return result;
+};

gulpfile.js

@@ -1,50 +1,62 @@
 var gulp = require('gulp-param')(require('gulp'), process.argv),
-    qunit = require("gulp-qunit"),
-    uglify = require('gulp-uglify'),
-    clean = require('gulp-clean'),
-    bump = require('gulp-bump'),
-    replace = require('gulp-replace'),
-    rename = require('gulp-rename'),
-    SRC = 'lib/underscore.string.js',
-    DEST = 'dist',
-    MIN_FILE = 'underscore.string.min.js',
-    TEST_SUITES = ['test/test.html', 'test/test_underscore/index.html'],
-    VERSION_FILES = ['./package.json', './component.json'];
+  qunit = require("gulp-qunit"),
+  uglify = require('gulp-uglify'),
+  clean = require('gulp-clean'),
+  bump = require('gulp-bump'),
+  replace = require('gulp-replace'),
+  rename = require('gulp-rename'),
+  browserify = require('gulp-browserify'),
+  SRC = 'underscore.string.js',
+  SRC_COMPILED = 'underscore.string.compiled.js',
+  DEST = 'dist',
+  MIN_FILE = 'underscore.string.min.js',
+  TEST_SUITES = ['test/test.html', 'test/test_standalone.html', 'test/test_underscore/index.html'],
+  VERSION_FILES = ['./package.json', './component.json'];
 
-gulp.task('test', function() {
-    return gulp.src(TEST_SUITES)
-        .pipe(qunit());
+gulp.task('test', ['browserify'], function() {
+  return gulp.src(TEST_SUITES)
+    .pipe(qunit());
+});
+
+gulp.task('browserify', function() {
+  return gulp.src(SRC)
+    .pipe(browserify({
+      detectGlobals: true,
+      standalone: 'underscore.string'
+    }))
+    .pipe(rename('underscore.string.compiled.js'))
+    .pipe(gulp.dest('./'));
 });
 
 gulp.task('clean', function() {
-    return gulp.src(DEST)
-        .pipe(clean());
+  return gulp.src(DEST)
+    .pipe(clean());
 });
 
 gulp.task('bump-in-js', function(semver) {
-    gulp.src(SRC)
-        .pipe(replace(/(version:?\s\')([\d\.]*)\'/gi, '$1' + semver + "'"))
-        .pipe(gulp.dest('./lib'));
+  return gulp.src(SRC)
+    .pipe(replace(/(version:?\s\')([\d\.]*)\'/gi, '$1' + semver + "'"))
+    .pipe(gulp.dest('./'));
 });
 
 // usage: gulp bump -s <% Version %>
 // usage: gulp bump --semver <% Version %>
 gulp.task('bump', ['bump-in-js'], function(semver) {
-    if (typeof semver !== 'string' || semver.length <= 0) {
-        console.error('pass a new version `gulp bump --semver 2.4.1`');
-        process.exit(1);
-    }
+  if (typeof semver !== 'string' || semver.length <= 0) {
+    console.error('pass a new version `gulp bump --semver 2.4.1`');
+    process.exit(1);
+  }
 
-    return gulp.src(VERSION_FILES)
-        .pipe(bump({
-            version: semver
-        }))
-        .pipe(gulp.dest('./'));
+  return gulp.src(VERSION_FILES)
+    .pipe(bump({
+      version: semver
+    }))
+    .pipe(gulp.dest('./'));
 });
 
 gulp.task('build', ['test', 'clean'], function() {
-    return gulp.src(SRC)
-        .pipe(uglify())
-        .pipe(rename(MIN_FILE))
-        .pipe(gulp.dest(DEST));
+  return gulp.src(SRC_COMPILED)
+    .pipe(uglify())
+    .pipe(rename(MIN_FILE))
+    .pipe(gulp.dest(DEST));
 });

helper/defaultToWhiteSpace.js

@@ -0,0 +1,10 @@
+var escapeRegExp = require('./escapeRegExp');
+
+module.exports = function defaultToWhiteSpace(characters) {
+  if (characters == null)
+    return '\\s';
+  else if (characters.source)
+    return characters.source;
+  else
+    return '[' + escapeRegExp(characters) + ']';
+};

helper/escapeChars.js

@@ -0,0 +1,9 @@
+var escapeChars = {
+  lt: '<',
+  gt: '>',
+  quot: '"',
+  amp: '&',
+  apos: "'"
+};
+
+module.exports = escapeChars;

helper/escapeRegExp.js

@@ -0,0 +1,5 @@
+var makeString = require('./makeString');
+
+module.exports = function escapeRegExp(str) {
+  return makeString(str).replace(/([.*+?^=!:${}()|[\]\/\\])/g, '\\$1');
+};

helper/makeString.js

@@ -0,0 +1,7 @@
+/**
+ * Ensure some object is a coerced to a string
+ **/
+module.exports = function makeString(object) {
+  if (object == null) return '';
+  return '' + object;
+};

helper/strRepeat.js

@@ -0,0 +1,9 @@
+module.exports = function strRepeat(str, qty){
+  if (qty < 1) return '';
+  var result = '';
+  while (qty > 0) {
+    if (qty & 1) result += str;
+    qty >>= 1, str += str;
+  }
+  return result;
+};

helper/toPositive.js

@@ -0,0 +1,3 @@
+module.exports = function toPositive(number) {
+  return number < 0 ? 0 : (+number || 0);
+};

humanize.js

@@ -0,0 +1,6 @@
+var capitalize = require('./capitalize');
+var underscored = require('./underscored');
+
+module.exports = function humanize(str) {
+  return capitalize(underscored(str).replace(/_id$/, '').replace(/_/g, ' '));
+};

include.js

@@ -0,0 +1,6 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function include(str, needle) {
+  if (needle === '') return true;
+  return makeString(str).indexOf(needle) !== -1;
+};

insert.js

@@ -0,0 +1,5 @@
+var splice = require('./splice');
+
+module.exports = function insert(str, i, substr) {
+  return splice(str, i, 0, substr);
+};

isBlank.js

@@ -0,0 +1,5 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function isBlank(str) {
+  return (/^\s*$/).test(makeString(str));
+};

join.js

@@ -0,0 +1,9 @@
+var makeString = require('./helper/makeString');
+var slice = [].slice;
+
+module.exports = function join() {
+  var args = slice.call(arguments),
+    separator = args.shift();
+
+  return args.join(makeString(separator));
+};

levenshtein.js

@@ -0,0 +1,25 @@
+var makeString = require('./helper/makeString');
+
+module.exports = function levenshtein(str1, str2) {
+  str1 = makeString(str1);
+  str2 = makeString(str2);
+
+  var current = [],
+    prev, value;
+
+  for (var i = 0; i <= str2.length; i++)
+    for (var j = 0; j <= str1.length; j++) {
+      if (i && j)
+        if (str1.charAt(j - 1) === str2.charAt(i - 1))
+          value = prev;
+        else
+          value = Math.min(current[j], current[j - 1], prev) + 1;
+        else
+          value = i + j;
+
+      prev = current[j];
+      current[j] = value;
+    }
+
+  return current.pop();
+};