Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anthonygauthier/axios-curlirize
axios plugin converting requests to cURL commands, saving and logging them.
https://github.com/anthonygauthier/axios-curlirize
axios curl debug debugging ecmascript6 http javascript log logging node shell
Last synced: 9 days ago
JSON representation
axios plugin converting requests to cURL commands, saving and logging them.
- Host: GitHub
- URL: https://github.com/anthonygauthier/axios-curlirize
- Owner: anthonygauthier
- License: mit
- Created: 2018-06-19T18:34:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-19T03:07:17.000Z (over 1 year ago)
- Last Synced: 2024-05-19T12:17:41.433Z (9 months ago)
- Topics: axios, curl, debug, debugging, ecmascript6, http, javascript, log, logging, node, shell
- Language: JavaScript
- Homepage:
- Size: 438 KB
- Stars: 183
- Watchers: 1
- Forks: 30
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://app.codacy.com/app/antho325/axios-curlirize?utm_source=github.com&utm_medium=referral&utm_content=delirius325/axios-curlirize&utm_campaign=Badge_Grade_Dashboard)
[](https://circleci.com/gh/delirius325/axios-curlirize)
[](https://badge.fury.io/js/axios-curlirize)
# Versions
* 2.0.0 - Uses ES Native Modules
* 1.3.7 - Uses CommonJS Modules
# Description
This module is an axios third-party module to log any axios request as a curl command in the console. It was originally posted as a suggestion on the axios repository, but since we believed it wasn't in the scope of axios to release such feature, we decided to make it as an independent module.
# How it works
The module makes use of axios' interceptors to log the request as a cURL command. It also stores it in the response's config object. Therefore, the command can be seen in the app's console, as well as in the `res.config.curlCommand` property of the response.
# How to use it
axios-curlirize is super easy to use. First you'll have to install it.
```shell
npm i --save axios-curlirize@latest
```
Then all you have to do is import and instanciate curlirize in your app. Here's a sample:
```javascript
import axios from 'axios';
import express from 'express';
import curlirize from 'axios-curlirize';
const app = express();
// initializing axios-curlirize with your axios instance
curlirize(axios);
// creating dummy route
app.post('/', (req, res) => {
res.send({ hello: 'world!' });
});
// starting server
app.listen(7500, () => {
console.log('Dummy server started on port 7500');
/*
The output of this in the console will be :
curl -X POST -H "Content-Type:application/x-www-form-urlencoded" --data {"dummy":"data"} http://localhost:7500/
*/
axios
.post('http://localhost:7500/', { dummy: 'data' })
.then(res => {
console.log('success');
})
.catch(err => {
console.log(err);
});
});
```
# Features
## Changing the logger
By default, axios-curlirize uses the `console.log/error()` functions. It is possible to change the logger by doing something similar to this:
```javascript
// when initiating your curlirize instance
curlirize(axios, (result, err) => {
const { command } = result;
if (err) {
// use your logger here
} else {
// use your logger here
}
});
```
## Curilirize additional axios instance
To curlirize any other instances of axios (aside from the base one), please call the `curlirize()` method on that instance.
```javascript
const instance = axios.create({ baseURL: 'https://some-domain.com/api/', timeout: 1000, headers: {'X-Custom-Header': 'foobar'} });
curlirize(instance);
```
## Disable the logger
By default, all requests will be logged. But you can disable this behaviour unitarily by setting the `curlirize` option to false within the axios request.
```javascript
axios
.post('http://localhost:7500/', { dummy: 'data' }, {
curlirize: false
})
.then(res => {
console.log('success');
})
.catch(err => {
console.log(err);
});
```
## Clear a request
```javascript
axios
.post('http://localhost:7500/', { dummy: 'data' })
.then(res => {
res.config.clearCurl();
})
.catch(err => {
console.log(err);
});
```