ember-rocks/src/utils/string.js

An Em(ber) command line utility to help you build an ambitious web application

// Credits/Thanks to Ember-Cli/Ember.js project
// https://github.com/ember-cli/ember-cli/blob/master/lib/utilities/string.js

'use strict';

// TODO: remove once Ember's version is on npm
var STRING_DASHERIZE_REGEXP = (/[ _]/g);
var STRING_DASHERIZE_CACHE = {};
var STRING_DECAMELIZE_REGEXP = (/([a-z\d])([A-Z])/g);
var STRING_CAMELIZE_REGEXP = (/(\-|_|\.|\s)+(.)?/g);
var STRING_UNDERSCORE_REGEXP_1 = (/([a-z\d])([A-Z]+)/g);
var STRING_UNDERSCORE_REGEXP_2 = (/\-|\s+/g);

module.exports = {

  /**
   Converts a camelized string into all lower case separated by underscores.

   ```javascript
   'innerHTML'.decamelize();           // 'inner_html'
   'action_name'.decamelize();        // 'action_name'
   'css-class-name'.decamelize();     // 'css-class-name'
   'my favorite items'.decamelize();  // 'my favorite items'
   ```

   @method decamelize
   @param {String} str The string to decamelize.
   @return {String} the decamelized string.
   */
  decamelize: function (str) {
    return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase();
  },

  /**
   Replaces underscores, spaces, or camelCase with dashes.

   ```javascript
   'innerHTML'.dasherize();          // 'inner-html'
   'action_name'.dasherize();        // 'action-name'
   'css-class-name'.dasherize();     // 'css-class-name'
   'my favorite items'.dasherize();  // 'my-favorite-items'
   ```

   @method dasherize
   @param {String} str The string to dasherize.
   @return {String} the dasherized string.
   */
  dasherize: function (str) {
    var cache = STRING_DASHERIZE_CACHE;
    var hit = cache.hasOwnProperty(str);
    var ret;

    if (hit) {
      return cache[str];
    } else {
      ret = this.decamelize(str).replace(STRING_DASHERIZE_REGEXP, '-');
      cache[str] = ret;
    }

    return ret;
  },

  /**
   Returns the lowerCamelCase form of a string.

   ```javascript
   'innerHTML'.camelize();          // 'innerHTML'
   'action_name'.camelize();        // 'actionName'
   'css-class-name'.camelize();     // 'cssClassName'
   'my favorite items'.camelize();  // 'myFavoriteItems'
   'My Favorite Items'.camelize();  // 'myFavoriteItems'
   ```

   @method camelize
   @param {String} str The string to camelize.
   @return {String} the camelized string.
   */
  camelize: function (str) {
    return str.replace(STRING_CAMELIZE_REGEXP, function (match, separator, chr) {
      return chr ? chr.toUpperCase() : '';
    }).replace(/^([A-Z])/, function (match) {
      return match.toLowerCase();
    });
  },

  /**
   Returns the UpperCamelCase form of a string.

   ```javascript
   'innerHTML'.classify();          // 'InnerHTML'
   'action_name'.classify();        // 'ActionName'
   'css-class-name'.classify();     // 'CssClassName'
   'my favorite items'.classify();  // 'MyFavoriteItems'
   ```

   @method classify
   @param {String} str the string to classify
   @return {String} the classified string
   */
  classify: function (str) {
    var parts = str.split('.');
    var out = [];

    for (var i = 0, l = parts.length; i < l; i++) {
      var camelized = this.camelize(parts[i]);
      out.push(camelized.charAt(0).toUpperCase() + camelized.substr(1));
    }

    return out.join('.');
  },

  /**
   More general than decamelize. Returns the lower\_case\_and\_underscored
   form of a string.

   ```javascript
   'innerHTML'.underscore();          // 'inner_html'
   'action_name'.underscore();        // 'action_name'
   'css-class-name'.underscore();     // 'css_class_name'
   'my favorite items'.underscore();  // 'my_favorite_items'
   ```

   @method underscore
   @param {String} str The string to underscore.
   @return {String} the underscored string.
   */
  underscore: function (str) {
    return str.replace(STRING_UNDERSCORE_REGEXP_1, '$1_$2').
      replace(STRING_UNDERSCORE_REGEXP_2, '_').toLowerCase();
  },

  /**
   Returns the Capitalized form of a string

   ```javascript
   'innerHTML'.capitalize()         // 'InnerHTML'
   'action_name'.capitalize()       // 'Action_name'
   'css-class-name'.capitalize()    // 'Css-class-name'
   'my favorite items'.capitalize() // 'My favorite items'
   ```

   @method capitalize
   @param {String} str The string to capitalize.
   @return {String} The capitalized string.
   */
  capitalize: function (str) {
    return str.charAt(0).toUpperCase() + str.substr(1);
  }
};