a command line http client built on top of undici.
bbgurl is distributed on npm. you can install it with npm i -g bbgurl, or
use it with npx:
npx bbgurl https://google.com
$ bbgurl https://google.com
[♥] Downloading: ======================================== 100% (220/220)
<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">
<TITLE>301 Moved</TITLE></HEAD><BODY>
<H1>301 Moved</H1>
The document has moved
<A HREF="https://www.google.com/">here</A>.
</BODY></HTML>
(this example does not work as that service no longer exists.)
$ bbgurl http://whatismyip.jit.su -H '{ "accept": "application/json" }'
{ "ip": "71.198.76.200" }
(this example also needs to be updated, but the functionality hasn't changed here at all so it should work!)
$ bbgurl -u josh:supersekritpw http://localhost:8080
{ "success": true, "message": "Welcome to the inner sanctum." }
(yes, this ancient url still works!! this is an up-to-date example!)
$ bbgurl --verbose http://nodejs.org/dist/v0.8.4/node-v0.8.4.tar.gz -o node-v0.8.4.tar.gz
[♥] data written to /home/josh/joshiverse/old-memes/bbgurl/node-v0.8.4.tar.gz
here's the current output of the help, which I think is uncharacteristically comprehensive:
[♥] bbgurl: a cli http client using undici
[♥]
[♥] USAGE: bbgurl [URL]
[♥]
[♥] make an HTTP request using undici.request.
[♥]
[♥] most undici options are bled straight through the args, using conventions
[♥] from the optimist and minimist libraries.
[♥]
[♥] for more information on undici, see: https://npm.im/undici
[♥]
[♥] OPTIONS:
[♥] --help print this message.
[♥]
[♥] -Q/--quiet suppress logging.
[♥]
[♥] -X/--method METHOD an http method. defaults to GET.
[♥]
[♥] --body BODY the request body. if the first character is a @,
[♥] will read from file. defaults to stdin.
[♥]
[♥] --headers HEADERS a JSON blob representing an undici headers
[♥] argument. defaults to null.
[♥]
[♥] --upgrade UPGRADE optionally upgrade the request with the specified
[♥] upgrade type.
[♥]
[♥] --bodyTimeout MILLIS how long to wait for the body before timing out.
[♥] defaults to 30 seconds.
[♥]
[♥] --headersTimeout MILLIS how long to wait for the headers before timing
[♥] out. defaults to 30 seconds.
[♥]
[♥] --maxRedirections N the maximum number of redirects to follow.
[♥]
[♥] --mixin MIXIN if specified, call the appropriate fetch mixin on the body.
[♥]
[♥] -i/--include include response status, headers and trailers.
[♥]
[♥] --logfile FILE an optional file to write logs to.
[♥]
[♥] -o/--output FILE a file to write the response to. defaults to stdout.
[♥]
[♥] -U/--user CREDENTIALS specify basic auth credentials. ex: '-u user:pass'
[♥]
There are tests using bats. To run
them, execute npm test.
a previous version of this client was written as a thin wrapper around mikeal/request; however, request is no longer maintained, and I saw no reason not to upgrade.
MIT/X11.
FAQs
a cli http client using undici
The npm package bbgurl receives a total of 22 weekly downloads. As such, bbgurl popularity was classified as not popular.
We found that bbgurl demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Security experts warn that recent classification changes obscure the true scope of the NVD backlog as CVE volume hits all-time highs.
Security Fundamentals
Attackers use obfuscation to hide malware in open source packages. Learn how to spot these techniques across npm, PyPI, Maven, and more.
Security News
Join Socket for exclusive networking events, rooftop gatherings, and one-on-one meetings during BSidesSF and RSA 2025 in San Francisco.