@patrtorg/quibusdam-minima NPM

@patrtorg/quibusdam-minima

Transpile curl commands into C, C#, ColdFusion, Clojure, Dart, Elixir, Go, HTTPie, Java, JavaScript, Julia, Kotlin, Lua, MATLAB, Objective-C, OCaml, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Swift, Wget, Ansible, HAR, HTTP or JSON.

Try it on @patrtorg/quibusdam-minima.com or as a drop-in curl replacement:

$ @patrtorg/quibusdam-minima --data "hello=world" example.com
import requests

data = {
    'hello': 'world',
}

response = requests.post('http://example.com', data=data)

Features:

Implements a lot of curl's argument parsing logic
- Knows about all 255 curl arguments but most are ignored
- Supports shortening -O -v -X POST to -OvXPOST
- --data @filename generates code that reads that file and @- reads stdin
Understands Bash syntax
- ANSI-C quoted strings
- stdin redirects and heredocs
- Generated code reads environment variables and runs subcommands
- Ignores comments
- Reports syntax errors
Converts JSON data to native objects
Warns about issues with the conversion

Limitations:

Only HTTP is supported
Code generators for other languages are less thorough than the Python generator
curl doesn't follow redirects or decompress gzip-compressed responses by default, but the generated code will do whatever the default is for that runtime, to keep it shorter. For example Python's Requests library follows redirects by default, so unless you explicitly set the redirect policy with -L/--location/--no-location, the generated code will not handle redirects the same way as the curl command
Shell variables can arbitrarily change how the command would be parsed at runtime. The command curl $VAR can do anything, depending on what's in $VAR. @patrtorg/quibusdam-minima assumes that environment variables don't contain characters that would affect parsing
Only simple subcommands such as curl $(echo example.com) work, more complicated subcommands (such as nested commands or subcommands that redirect the output) won't generate valid code
The Bash parser doesn't support all Bash syntax
and much more

Install

Install the command line tool with

npm install --global @patrtorg/quibusdam-minima

Install the JavaScript library for use in your own projects with

npm install @patrtorg/quibusdam-minima

@patrtorg/quibusdam-minima requires Node 12+.

Usage

Usage from the command line

@patrtorg/quibusdam-minima acts as a drop-in replacement for curl. Take any curl command, change "curl" to "@patrtorg/quibusdam-minima" and it will print code instead of making the request

$ @patrtorg/quibusdam-minima example.com
import requests

response = requests.get('http://example.com')

To read the curl command from stdin, pass -

$ echo 'curl example.com' | @patrtorg/quibusdam-minima -
import requests

response = requests.get('http://example.com')

Choose the output language by passing --language <language>. The options are

ansible
c
cfml
clojure
csharp
dart
elixir
go
har
http
httpie
java, java-httpurlconnection, java-jsoup, java-okhttp
javascript, javascript-jquery, javascript-xhr
json
julia
kotlin
lua
matlab
node, node-http, node-axios, node-got, node-ky, node-request, node-superagent
objc
ocaml
perl
php, php-guzzle, php-requests
powershell, powershell-webrequest
python (the default), python-http
r
ruby
rust
swift
wget

--verbose enables printing of conversion warnings and error tracebacks.

Usage as a library

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 @patrtorg/quibusdam-minima from '@patrtorg/quibusdam-minima';

@patrtorg/quibusdam-minima.toPython('curl example.com');
@patrtorg/quibusdam-minima.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. @patrtorg/quibusdam-minima must be imported as an ES module with import this way and not with require() because it uses top-level await.

There's a corresponding set of functions that also return an array of warnings if there are any issues with the conversion:

@patrtorg/quibusdam-minima.toPythonWarn('curl ftp://example.com');
@patrtorg/quibusdam-minima.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 @patrtorg/quibusdam-minima 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 @patrtorg/quibusdam-minima.com to see how this is done. You will also need to set {module: {experiments: {topLevelAwait: true}}} in your webpack.config.js.