Merge pull request emberjs#3224 from sentientmonkey/master

Add Ember.String.humanize

Author: wagenet

packages/ember-runtime/lib/ext/string.js

@@ -18,6 +18,10 @@ var fmt = Ember.String.fmt,
     capitalize = Ember.String.capitalize,
     classify = Ember.String.classify;
 
+if (Ember.FEATURES.isEnabled("string-humanize")) {
+    var humanize = Ember.String.humanize;
+}
+
 if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.String) {
 
   /**
@@ -110,5 +114,17 @@ if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.String) {
     return capitalize(this);
   };
 
+  if (Ember.FEATURES.isEnabled("string-humanize")) {
+    /**
+      See [Ember.String.humanize](/api/classes/Ember.String.html#method_humanize).
+
+      @method humanize
+      @for String
+    */
+    String.prototype.humanize = function() {
+      return humanize(this);
+    };
+  }
+
 }
 

packages/ember-runtime/lib/system/string.js

@@ -245,5 +245,31 @@ Ember.String = {
   capitalize: function(str) {
     return str.charAt(0).toUpperCase() + str.substr(1);
   }
-
 };
+
+if (Ember.FEATURES.isEnabled("string-humanize")) {
+  /**
+    Returns the Humanized form of a string
+
+    Replaces underscores with spaces, and capitializes first character
+    of string. Also strips "_id" suffixes.
+
+    ```javascript
+    'first_name'.humanize()       // 'First name'
+    'user_id'.humanize()          // 'User'
+    ```
+
+    @method humanize
+    @param {String} str The string to humanize.
+    @return {String} The humanized string.
+  */
+
+  Ember.String.humanize = function(str) {
+    return str.replace(/_id$/, '').
+      replace(/_/g, ' ').
+      replace(/^\w/g, function(s){
+        return s.toUpperCase();
+      });
+  };
+}
+

packages/ember-runtime/tests/system/string/humanize.js

@@ -0,0 +1,31 @@
+if (Ember.FEATURES.isEnabled("string-humanize")) {
+  module('Ember.String.humanize');
+
+  test("with underscored string", function() {
+    deepEqual(Ember.String.humanize('first_name'), 'First name');
+    if (Ember.EXTEND_PROTOTYPES) {
+      deepEqual('first_name'.humanize(), 'First name');
+    }
+  });
+
+  test("with multiple underscored string", function() {
+    deepEqual(Ember.String.humanize('first_and_last_name'), 'First and last name');
+    if (Ember.EXTEND_PROTOTYPES) {
+      deepEqual('first_and_last_name'.humanize(), 'First and last name');
+    }
+  });
+
+  test("with underscored id string", function() {
+    deepEqual(Ember.String.humanize('user_id'), 'User');
+    if (Ember.EXTEND_PROTOTYPES) {
+      deepEqual('user_id'.humanize(), 'User');
+    }
+  });
+
+  test("with humanized string", function() {
+    deepEqual(Ember.String.humanize('First name'), 'First name');
+    if (Ember.EXTEND_PROTOTYPES) {
+      deepEqual('First name'.humanize(), 'First name');
+    }
+  });
+}