Generate code from cURL commands
Transpile curl
commands into Python, JavaScript, Java, C#, PHP, Go, Dart, R, Ruby, Rust, MATLAB, Elixir, Clojure, CFML, Ansible, HAR, or JSON.
Try it on curlconverter.com or from the command line as a drop-in replacement for curl
:
$ curlconverter --data "hello=world" example.com
import requests
data = {
'hello': 'world',
}
response = requests.post('http://example.com', data=data)
Features:
-O -v -X POST
to -OvXPOST
--data @filename
generates code that reads that file and @-
reads stdinLimitations:
-L
/--location
/--no-location
, the generated code will not handle redirects the same way as the curl commandcurl example.com?foo=bar&baz=$VAR
, if $VAR
contains =
or &
characters or percent encoded characters, that could make the generated code wrong. curlconverter assumes that environment variables don't contain characters that would affect parsingcurl $(echo example.com)
work, more complicated subcommands (such as nested commands or subcommands that redirect the output) won't generate valid codeInstall the command line tool with
npm install --global curlconverter
Install the JavaScript library for use in your own projects with
npm install curlconverter
curlconverter requires Node 12+.
The command line tool acts as a drop-in replacement for curl. Take a curl command, change "curl
" to "curlconverter
" and it will print code instead of making the request
$ curlconverter example.com
import requests
response = requests.get('http://example.com')
or pass -
to read the curl command from stdin
$ echo 'curl example.com' | curlconverter -
import requests
response = requests.get('http://example.com')
Choose the output language by passing --language <language>
. The options are
ansible
cfml
clojure
csharp
dart
elixir
go
har
java
javascript
, node
, node-axios
, node-got
, node-request
json
matlab
php
, php-requests
python
(the default)r
ruby
rust
--verbose
enables printing of conversion warnings and error tracebacks.
The JavaScript API is a bunch of functions that can take either a string of Bash code or an array of already-parsed arguments (like process.argv
) and return a string with the resulting program:
import * as curlconverter from 'curlconverter';
curlconverter.toPython('curl example.com');
curlconverter.toPython(['curl', 'example.com']);
// "import requests\n\nresponse = requests.get('http://example.com')\n"
Note: add "type": "module"
to your package.json for the import
statement above to work.
There's a corresponding set of functions that also return an array of warnings if there are any issues with the conversion:
curlconverter.toPythonWarn('curl ftp://example.com');
curlconverter.toPythonWarn(['curl', 'ftp://example.com']);
// [
// "import requests\n\nresponse = requests.get('ftp://example.com')\n",
// [ [ 'bad-scheme', 'Protocol "ftp" not supported' ] ]
// ]
If you want to host curlconverter yourself and use it in the browser, it needs two WASM files to work, tree-sitter.wasm
and tree-sitter-bash.wasm
, which it will request from the root directory of your web server. If you are hosting a static website and using Webpack, you need to copy these files from the node_modules/ directory to your server's root directory in order to serve them. You can look at the webpack.config.js for curlconverter.com to see how this is done. You will also need to set {module: {experiments: {topLevelAwait: true}}}
in your webpack.config.js.
There's a VS Code extension that adds a "Paste cURL as <language>" option to the right-click menu: https://marketplace.visualstudio.com/items?itemName=curlconverter.curlconverter. It has to use an old version of curlconverter, so it doesn't support the same languages, curl arguments or Bash syntax as the current version.
See CONTRIBUTING.md
MIT © Nick Carneiro