1.4.0 • Published 7 years ago

resource-path v1.4.0

Weekly downloads
6
License
MIT
Repository
github
Last release
7 years ago

/resource/:path

Travis npm Coverage Status npm npm

Tiny module to generate resource paths for APIs, with zero dependencies

This module implements Angular's resource URL definition, so that you can easily interact with an API.

Example:

import resource from 'resource-path';

const input = '/path/to/resource/:id';
const params = {
  id: 123
};

resource(input, params);
// Returns: /path/to/resource/123
const input = '/path/to/resource/:id/something/:param2';
const params = {
  id: 123
};

resource(input, params);
// Returns: /path/to/resource/123

Getting started

Install:

npm install --save resource-path
# or if you prefer yarn
yarn add resource-path

Usage

import resource from 'resource-path';

resource(path, [params]);
  • path {string} Is the path to the resource. Either a full URL or a relative path. It can contain identifiers in the form of :identifier in any part of the path.
  • params {Object} An object with key/value pairs, where the keys are identifiers in the path, and the value is what will be replaced in it.

The resource method will return the path, substituting the params whenever if finds an indentifier. As soon as it finds an identifier without a specified parameter it stops.This way you can define full API paths that are reusable.

Testing

Tests are located in the tests folder, and are written with ava.

Contributing

Feel free to send any PR with new features, more test cases...

License

This project is licensed under the MIT License.

Analytics

1.4.0

7 years ago

1.3.0

7 years ago

1.2.1

7 years ago

1.2.0

7 years ago

1.1.0

7 years ago

1.0.0

7 years ago