Various improvements.

Author: jmdobry

Gruntfile.js

@@ -239,6 +239,17 @@ module.exports = function (grunt) {
 								storage: 5
 							}
 						},
+						{
+							id: 'angular-data-mocks',
+							title: 'angular-data-mocks',
+							docs: ['guide/angular-data-mocks/'],
+							rank: {
+								index: 1,
+								overview: 2,
+								setup: 3,
+								testing: 4
+							}
+						},
 						{
 							id: 'angular-data-resource',
 							title: 'Defining Resources',
@@ -248,7 +259,8 @@ module.exports = function (grunt) {
 								overview: 2,
 								basic: 3,
 								advanced: 4,
-								lifecycle: 5
+								lifecycle: 5,
+								custom: 6
 							}
 						},
 						{

bower.json

@@ -28,8 +28,8 @@
   "devDependencies": {
     "angular": "~1.2.16",
     "angular-mocks": "~1.2.16",
-    "angular-data-mocks": "0.2.0",
     "angular-cache": "~3.0.0-beta.4",
-    "observe-js": "~0.2.0"
+    "observe-js": "~0.2.0",
+    "angular-data-mocks": "~0.3.1"
   }
 }

dist/angular-data.js

@@ -3956,7 +3956,15 @@ function _inject(definition, resource, attrs) {
 				item = this.get(definition.name, id);
 
 			if (!item) {
-				item = definition.class ? new definition[definition.class]() : {};
+				if (definition.class) {
+					if (attrs instanceof definition[definition.class]) {
+						item = attrs;
+					} else {
+						item = new definition[definition.class]();
+					}
+				} else {
+					item = {};
+				}
 				resource.previousAttributes[id] = {};
 
 				_this.utils.deepMixIn(item, attrs);

dist/angular-data.min.js

@@ -0,0 +1,8 @@
+@doc overview
+@id index
+@name Overview
+@description
+
+# Overview
+
+<page-list></page-list>

guide/angular-data-mocks/index.doc

@@ -0,0 +1,12 @@
+@doc overview
+@id overview
+@name Overview
+@description
+
+Angular-data is a fake angular-data implementation suitable for unit testing angular applications that use the `angular-data.DS` module.
+
+__Version:__ 0.3.0
+
+__angular-data-mocks requires [sinon](http://sinonjs.org/) to be loaded in order to work.__
+
+Refer to the [angular-data-mocks API](/documentation/api/angular-data-mocks/angular-data-mocks) for more detailed information.

guide/angular-data-mocks/overview.doc

@@ -0,0 +1,8 @@
+@doc overview
+@id setup
+@name Setting Up
+@description
+
+TODO: Explain how to set up angular tests to use angular-data-mocks.
+
+Refer to the [angular-data-mocks API](/documentation/api/angular-data-mocks/angular-data-mocks) for more detailed information.

guide/angular-data-mocks/setup.doc

@@ -0,0 +1,8 @@
+@doc overview
+@id testing
+@name Testing
+@description
+
+TODO: Explain how to use angular-data-mocks in angular tests.
+
+Refer to the [angular-data-mocks API](/documentation/api/angular-data-mocks/angular-data-mocks) for more detailed information.

guide/angular-data-mocks/testing.doc

@@ -1,13 +1,17 @@
 body {
     background-size: auto;
     background: url(/resources/img/cream_dust.png) repeat repeat;
-    font-family:'Open sans',Arial,Helvetica,sans-serif;
+    font-family: 'Open sans', Arial, Helvetica, sans-serif;
 }
 
 .main-nav {
     border-bottom: 2px solid #0088cc;
 }
 
+.main-nav .dropdown-menu {
+    min-width: 250px;
+}
+
 .main-nav:before {
     content: " ";
     position: absolute;

guide/angular-data.css

@@ -167,3 +167,33 @@ angular.module('myApp', ['angular-data.DS'])
 
 	});
 ```
+
+@doc overview
+@id custom
+@name Custom Model Behavior
+@description
+
+If you provide a `methods` field in the options passed to `DS.defineResource`, angular-data wrap items of that resource
+with an empty constructor function. The `methods` option should be an object where the keys are method names and the
+values are functions. This object will be mixed in to the prototype empty constructor function used to wrap items of the
+new resource. In this way you can add custom behavior to what will now be "instances" of the new resource.
+
+## Example:
+```js
+DS.defineResource({
+	name: 'user',
+	methods: {
+		fullName: function () {
+			return this.first + ' ' + this.last;
+		}
+	}
+});
+
+DS.inject('user', { id: 1, first: 'John', last: 'Anderson' });
+
+var user = DS.get('user', 1);
+
+user.fullName(); // "John Anderson"
+
+user.constructor; // function User() { ... }
+```