squash-me! feat(Module): add info() method

The new `info()` method lets developers store arbitrary information about
their module for consumption later.

Author: petebacondarwin

src/loader.js

@@ -127,14 +127,20 @@ function setupModuleLoader(window) {
            *                          or `this` if called as a setter.
            *
            * @description
-           * Additional info about this module
+           * Read and write custom information about this module.
            * For example you could put the version of the module in here.
            *
            * ```js
            * angular.module('myModule', []).info({ version: '1.0.0' });
            * ```
            *
-           * You can retrieve this information during runtime via the
+           * The version could then be read back out by accessing the module elsewhere:
+           *
+           * ```
+           * var version = angular.module('myModule').info().version;
+           * ```
+           *
+           * You can also retrieve this information during runtime via the
            * {@link $injector#modules `$injector.modules`} property:
            *
            * ```js

test/loaderSpec.js

@@ -179,6 +179,12 @@ describe('module loader', function() {
           theModule.info('some text');
         }).toThrowMinErr('ng', 'aobj');
       });
+
+      it('should completely replace the previous info object', function() {
+        theModule.info({ value: 'X' });
+        theModule.info({ newValue: 'Y' });
+        expect(theModule.info()).toEqual({ newValue: 'Y' });
+      });
     });
   });
 });