Modest Angular module for handling nested REST resources.

With great 'inspiration' from:

• Angular Resource
• Angular nested resource

bower install --save angular-modest

and include angular-modest.js as a dependency

Requires the modest module to be installed

A factory that gives you the ability to create RESTful resources mapped to a JavaScript object.

Supports deeply nested resources.

new Resource(url, defaultParams)

Returns an instance of Resource

resource.getResourceUrl()

Returns the resource url for the current instance

resource.getResourceFor(params)

Returns an instance of the nested Resource

resource.get(params,queryParameters)

Return an $http object to interact with, making a request to the desired resource.

resource.VERB(params,payload)

Return an $http object to interact with, making a request to the desired resource.

See the tests for more detailed information and use cases.

var user = new Resource( '/users/:userId' );
expect( user.getResourceUrl() ).to.equal( '/users/:userId' );

var user = new Resource( '/users/:userId', {userId:1} );
expect( user.getResourceUrl() ).to.equal( '/users/1' );

var user = new Resource( '/users/:userId', {userId:1} );
user.get() // returns $http with GET request made to /users/1

var user = new Resource( '/users/:userId' );
user.get({userId:2}) // returns $http with GET request made to /users/2
user.get(2) // returns $http with GET request made to /users/2


var userBooks = new Resource( '/users/:userId/books/:bookId' );
userBooks.get({userId:1,bookId:1}); // returns $http with GET request made to /users/1/books/1

var users = new Resource( '/users/:userId' );
users.get() // returns $http with GET request made to /users/ 



// nested resources
var user1 = new Resource( '/users/:userId/books/:bookId', {userId:1} );
user1.get({bookId:1}); // returns $http with GET request made to /users/1/books/1
user1.books.get({bookId:1}); // returns $http with GET request made to /users/1/books/1
user1.books.get(1); // returns $http with GET request made to /users/1/books/1

• fix query parameters when performing request
• fix parameter duplication when requesting nested resource

To setup the environment

npm install
bower install

......

npm test

The best way to get your changes merged back into core is as follows:

1. Clone down your fork
2. Create a thoughtfully named topic branch to contain your change
3. Hack away
4. Add tests and make sure everything still passes by running npm test
5. If you are adding new functionality, document it in the README
6. Do not change the version number, we will do that on our end
7. If necessary, rebase your commits into logical chunks, without errors
8. Push the branch up to GitHub
9. Send a pull request for your branch