HTTP request client supporting shortcut urls
This library has the following purposes:
- provide shortcuts for urls the same way a curie would (e.g wiki:picasso instead of http://mywiki.com/picasso).
- provide contextualisation for urls (e.g env becomes stage in http://env.mywiki.com/picasso)
- provide automatic headers based on rules.
- provide automatic authentication based on rules.
- provide automatic SSL certificates based on rules.
- provide JSON support.
- provide support for request.js.
- provide support for (asynchronous) promises.
- provide support for piping.
The main idea is help to store urls in a compact form. It is very similar to the concept of curie.
For instance:
{
name: "Picasso",
websites: ["wikipedia:Picasso","bbc:Picasso","tate:Picasso"]
}
The exact urls, as well as all information concerning headers and authorisation are provided by the rules engine.
Install
$ npm install --save shortquest
Usage
All the possible rules are described in details in RULES.md. You should also consult the request.js documentation as this library is used under the hood. In addition, the unit tests (test.js) are also a good source of examples.
GET Request
var shortquest = ; var rulesConf = rules: when: trigger: "uri starts with" value: "wiki:" then: action: "replace start" values: "wiki:" "http://mywiki.com/" ;var myshortquest = ; myshortquest;
POST, PUT, DELETE Requests
You could perform any kind of requests by specifying the method with POST,PUT,DELETE,PATCH or HEAD. The body could be some json or a string. Note that for a good JSON support you will need to add a "set JSON" rule.
Example:
myshortquest;
Passing parameters
You can pass request parameters with parameterObj:
myshortquest;
Passing a form
You can pass a form with formObj:
myshortquest;
Passing tags
You can pass tags that can be used by the rule engine:
myshortquest;
Pipe a request
It is possible to pipe requests:
Example:
myshortquest;
Async
You can also do asynchronous requests using promises (we are using bluebird internally);
Example:
myshortquest;
License
MIT © Olivier Huin
Contributors
..and with the help of Aradhna ..