https://github.com/andrewpillar/req

A simple and opinionated HTTP scripting language
https://github.com/andrewpillar/req

go http scripting-languages

Last synced: 7 days ago
JSON representation

A simple and opinionated HTTP scripting language

• Host: GitHub
• URL: https://github.com/andrewpillar/req
• Owner: andrewpillar
• License: apache-2.0
• Created: 2021-12-26T15:26:39.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-12-18T20:04:36.000Z (about 1 year ago)
• Last Synced: 2025-01-17T13:09:37.568Z (14 days ago)
• Topics: go, http, scripting-languages
• Language: Go
• Homepage: https://andrewpillar.com/programming/2022/02/26/req-an-http-scripting-language/
• Size: 260 KB
• Stars: 161
• Watchers: 5
• Forks: 12
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# req

req is an opinionated HTTP scripting language. It is designed for easily making

HTTP requests, and working with their responses. Below is an example that calls

out to the GitHub API and displays the user making the call,

    $ cat gh.req

    Stderr = open "/dev/stderr";

    Endpoint = "https://api.github.com";

    Token = env "GH_TOKEN";

    if $Token == "" {

        writeln $Stderr "GH_TOKEN not set";

        exit 1;

    }

    Headers = (

        Authorization: "Bearer $(Token)",

    );

    Resp = GET "$(Endpoint)/user" $Headers -> send;

    match $Resp.StatusCode {

        200 -> {

            User = decode json $Resp.Body;

            writeln _ "Hello $(User["login"])";

        }

        _   -> {

            writeln $Stderr "Unexpected response: $(Resp.Status)";

            exit 1;

        }

    }

    $ GH_TOKEN=1a2b3c4d5ef req gh.req

This language hopes to fill in a gap when it comes to writing scripts for

working with an HTTP service. Typically, you have a choice between a shell

script that utilizes cURL, or a programmaing language and any HTTP library

that may come with it.

The cURL approach can work, for simple one off requests, but when you want to

do something more with the response you're left with having to munge that data

with jq, grep, sed, or awk (or all of the above). Using a programming language

gives you more control, but can be more cumbersome as you have far many more

knobs to turn.

req provides a middleground between the two. A limited syntax, with builtin

commands for working with any data you want to send/received. For more details

on how to start working with req, then refer to the [documentation](docs), or

you can dive right in by looking over the [examples](examples).