Add configuration option to use plain() by default

Author: nihaux

README.md

@@ -49,6 +49,7 @@ You can also **check out [a video introduction of a talk I gave at Devoxx France
       - [setDefaultHeaders](#setdefaultheaders)
       - [setRequestSuffix](#setrequestsuffix)
       - [setUseCannonicalId](#setusecannonicalid)
+      - [setPlainByDefault](#setplainbydefault)
     - [How to configure them globally](#how-to-configure-them-globally)
       - [Configuring in the config](#configuring-in-the-config)
       - [Configuring in the run](#configuring-in-the-run)
@@ -552,6 +553,10 @@ If all of your requests require to send some suffix to work, you can set it here
 
 You can set this to either `true` or `false`. By default it's false. If set to true, then the cannonical ID from the element will be used for URL creation (in DELETE, PUT, POST, etc.). What this means is that if you change the ID of the element and then you do a put, if you set this to true, it'll use the "old" ID which was received from the server. If set to false, it'll use the new ID assigned to the element.
 
+#### setPlainByDefault
+
+You can set this to `true` or `false`. By default it's false. If set to true, data retrieved will be returned with no embed methods from restangular.
+
 #### setEncodeIds
 
 You can set here if you want to URL Encode IDs or not. By default, it's true.

src/restangular.js

@@ -55,6 +55,15 @@ restangular.provider('Restangular', function() {
       config.defaultHttpFields = values;
       return this;
     };
+    
+    /**
+     * Always return plain data, no restangularized object
+    **/
+    config.plainByDefault = config.plainByDefault || false;
+    object.setPlainByDefault = function(value) {
+      config.plainByDefault = value === true ? true : false;
+      return this;
+    }
 
     config.withHttpValues = function(httpLocalConfig, obj) {
       return _.defaults(obj, httpLocalConfig, config.defaultHttpFields);
@@ -1071,6 +1080,11 @@ restangular.provider('Restangular', function() {
           if (!_.isArray(data)) {
             throw new Error('Response for getList SHOULD be an array and not an object or something else');
           }
+
+          if (true === config.plainByDefault) {
+            return resolvePromise(deferred, response, data, filledArray);
+          }
+
           var processedData = _.map(data, function(elem) {
             if (!__this[config.restangularFields.restangularCollection]) {
               return restangularizeElem(__this, elem, what, true, data);
@@ -1161,8 +1175,14 @@ restangular.provider('Restangular', function() {
           var resData = response.data;
           var fullParams = response.config.params;
           var elem = parseResponse(resData, operation, route, fetchUrl, response, deferred);
+
           if (elem) {
             var data;
+
+            if (true === config.plainByDefault) {
+              return resolvePromise(deferred, response, elem, filledObject);
+            }
+
             if (operation === 'post' && !__this[config.restangularFields.restangularCollection]) {
               data = restangularizeElem(
                 __this[config.restangularFields.parentResource],

test/restangularSpec.js

@@ -1143,4 +1143,32 @@ describe("Restangular", function() {
       $httpBackend.flush();
     });
   });
+
+  describe("setPlainByDefault", function() {
+    
+    it("should not add restangularized methods to response object", function() {
+      var newRes = Restangular.withConfig(function(RestangularConfigurer) {
+        RestangularConfigurer.setPlainByDefault(true);
+      });
+
+      expect(newRes.configuration.plainByDefault).toEqual(true);
+
+      newRes.one('accounts',0).get().then(function(account) {
+        expect(account).toEqual(accountsModel[0]);
+      });
+
+      $httpBackend.flush();
+    });
+
+    it("shoud not add restangularized methods to response collection", function() {
+      var newRes = Restangular.withConfig(function(RestangularConfigurer) {
+        RestangularConfigurer.setPlainByDefault(true);
+      });
+
+      newRes.all('accounts').getList().then(function(accounts){
+        expect(accounts).toEqual(accountsModel);
+      });
+      $httpBackend.flush();
+    });
+  });
 });