Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andreineculau/kurl
curl wrapper for simplicity
https://github.com/andreineculau/kurl
Last synced: 24 days ago
JSON representation
curl wrapper for simplicity
- Host: GitHub
- URL: https://github.com/andreineculau/kurl
- Owner: andreineculau
- Created: 2012-07-12T09:39:34.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2012-07-12T13:02:52.000Z (over 12 years ago)
- Last Synced: 2023-03-12T09:48:06.664Z (over 1 year ago)
- Size: 93.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# kurl
is a [`curl`](http://curl.haxx.se/) wrapper to simplify some of the most common usage of curl for API requests
> curl is a command line tool for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, Gopher, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, Telnet and TFTP. curl supports SSL certificates, HTTP POST, HTTP PUT, FTP uploading, HTTP form based upload, proxies, cookies, user+password authentication (Basic, Digest, NTLM, Negotiate, kerberos...), file transfer resume, proxy tunneling and a busload of other useful tricks.
# Usage examples
> Example, whether it be good or bad, has a powerful influence. *George Washington*
## --data-json
```bash
kurl \
--include \
--headers "Accept: application/json" \
--headers "Content-Type: application/json" \
--request POST \
--data-json number1:123 \
--data-json "number2:123" \
--data-json "string1:'123'" \
--data-json string2:\"123\" \
--data-json "boolean1:true" \
--data-json string3:\"true\" \
--data-json "string4:qwe" \
--data-json string5:\"qwe\" \
--data-json "string6:'qwe'" \
--url https://com.com/test
```
is equivalent to
```apiary
POST https://com.com/test
> Accept: application/json
> Content-Type: application/json
{
"number1": 123,
"number2": 123,
"string1": "123",
"string2": "123",
"boolean1": true,
"string3": "true",
"string4": "qwe",
"string5": "qwe",
"string6": "qwe"
}
```
## --query
```bash
kurl \
--include \
--headers "Accept: application/json" \
--request GET \
--query "name=Andrei" \
--query "likes=['apples', 'pie']" \
--url https://com.com/test
```
is equivalent to
```apiary
GET https://com.com/test?name=Andrei&likes=%5b'apples',%2520'pies'%5d
> Accept: application/json
```