Modularization helper

[ArnaudBuchholz]

As a developer, I want a way to include resource files and be notified when it has been loaded and evaluated

Acceptance criteria:

• The api is named gpf.require.define, it accepts up to two parameters: a dictionary specifying the dependant resources and a factory function. The optional result of the factory function is associated to the resource file so that if the resource is required a second time, this result is recalled.
• The api must a return a promise that is resolved (to the result of the factory function if any) on success or rejected if the require fails
• Resources are referenced using their relative path. A root can be define through the API gpf.require.configure that is used for the first gpf.require call.
• JSON resources must be evaluated to their parsed result.
• A JavaScript resource may respect one of the following formats:
  • Use of require and module.exports from CommonJS. The resource is associated with the value assigned to module.exports.
  • Use of AMD's define operator. The resource is associated with the result value of the factory function.
  • Use of gpf.require. The resource is associated with the result value of the factory function.
  • None of the three formats above, no association will be made to the resource.

[ArnaudBuchholz]

First version of documentation finalized.