Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/s00d/request-templater
https://github.com/s00d/request-templater
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/s00d/request-templater
- Owner: s00d
- Created: 2023-03-24T12:45:29.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-01T19:57:44.000Z (7 months ago)
- Last Synced: 2024-11-10T20:45:02.408Z (about 2 months ago)
- Language: JavaScript
- Size: 2.15 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://badge.fury.io/js/request-templater)
[](https://badge.fury.io/js/request-templater)
[](https://github.com/sood/request-templater/blob/master/LICENSE)
[](https://github.com/sood/request-templater)
[](https://www.paypal.me/s00d)
[](https://github.com/sood/request-templater)
# RequestTemplater
RequestTemplater is a class for generating HTTP request examples based on templates for different programming languages.
# Example
[Show](https://s00d.github.io/request-templater/)
## Installation
To install RequestTemplater, run the following command:
```npm install request-templater```
## Usage
To get started with RequestTemplater, create an instance of the class:
```js
import RequestTemplater from 'request-templater';
const requestTemplater = new RequestTemplater();
```
Then you can set the base URL and other request parameters:
```js
requestTemplater.baseUrl('https://example.com/api')
.method('GET')
.url('users/123')
.params([
{ in: 'query', name: 'page', value: '1' },
{ in: 'query', name: 'limit', value: '10' },
{ in: 'headers', name: 'Authorization', value: 'Bearer xxxxxxxxxxxx' }
]);
```
After that, you can generate a request example for the desired language:
```js
const code = requestTemplater.lang('javascript').library('axios').generate();
console.log(code);
In this example, code in the JavaScript language will be generated using the Axios library.
```
## Methods
### baseUrl(value: string): RequestTemplater
Method for setting the base URL for requests.
### method(value: 'GET'|'POST'|'PUT'|'DELETE'|'PATCH'|'HEAD'|'OPTIONS'): RequestTemplater
Method for setting the HTTP method for requests.
### url(value: string): RequestTemplater
Method for setting the path for requests.
### params(value: Array): RequestTemplater
Method for setting request parameters.
### mimeType(value: "application/x-www-form-urlencoded"|"application/json"|'multipart/form-data'): RequestTemplater
Method for setting the MIME type for requests.
### lang(value: string): RequestTemplater
Method for setting the programming language for which a request example will be generated.
### library(value: string): RequestTemplater
Method for setting the library that will be used to send the request.
### generate(): string
Method for generating a request example based on the specified parameters.
### generateHighlight(): string
Method for generating a request example based on the specified parameters with highlight.js tags.
Need add style, for example: ``````
### config(): Object
Method for getting a list of available templates for generating request examples.
## Language and Libraries
| Language | Libraries |
|-------------|--------------------------------------|
| Swift | URLSession, Alamofire |
| Shell | wget, httpie, curl |
| Scala | scalaj-http, http4s, akka |
| Rust | surf, reqwest, hyper |
| Ruby | RestClient, http |
| Python | requests, http |
| PowerShell | WebRequest, RestMethod |
| PHP | http2, http1, Guzzle, curl |
| Perl | UserAgent, Tiny, Request |
| OCaml | httpaf, cohttp_lwt |
| Objective-C | NSURLSession, AFNetworking |
| Lua | httpclient, http, curl |
| Kotlin | OkHttp3, Java, Fuel |
| JavaScript | jQuery, Fetch, Axios, XMLHttpRequest |
| Java | Unirest, OkHttp, NetHttp, AsyncHttp |
| HTTP | RFC7230 |
| Go | http, fasthttp |
| Dart | http_client, http, Dio |
| C# | RestSharp, HttpClient |
| C++ | iostream, curl, Arduino |
| Clojure | Ring-Client, clj-http |
| C | ghttp, curl |
| Brainfuck | Brainfuck |
| R | RCurl, httr |
## cli
Install the request-templater package globally using npm:
```bash
npm install -g request-templater
```
To use Request Templater, run the request-templater command in your terminal, specifying the necessary parameters. For example:
request-templater --url https://api.example.com/users --method POST --lang bash --library curl --params '[{in: "query", name: "param", value: 1}]'
In this example, we're specifying the URL, request method, programming language (javascript), and request parameters in JSON format.
Request Templater supports the following parameters:
`-u, --url `: The URL of the request (required)
`-m, --method `: The HTTP method (defaults to GET)
`-l, --language `: The programming language to generate code in (defaults to javascript)
`-t, --mimeType `: The MIME type of the request (optional)
`-p, --params `: The request parameters (optional)
`-b, --baseUrl `: The base URL for the request (optional)
`-r, --library `: The HTTP library to use for making the request (defaults to xhr)
To get help on the command line parameters, run the request-templater -h command:
```bash
request-templater -h
```