🔗 glue

Make requests, select JSON responses, nest them in other requests: A magnificent syntax for blazingly fast cli HTTP calls, made for humans.

Table of Contents

• Getting started
  • Install & Update
  • Usage
• Syntax
  • Overview
  • Simple request
  • JSON Result selector
  • Body attributes
  • Headers
  • Nested requests
  • Run file
  • Save response in variable
• Examples
• Contributing
  • Code of conduct
  • Contributing Guide
  • Good First Issues
• License

Getting started

Install & Update

At the moment, you can install or update glue for your system by building it from source. It has been done quite easy by the script install.sh.

All build dependencies (including Rust) will be deleted right after the installation automatically if Rust wasn't already on your system.

1. Clone the repo

git clone https://github.com/mikesposito/glue

2. Go to glue root directory

cd glue

3. Add execute permission and run install.sh

chmod +x ./install.sh && ./install.sh

Usage

To start an interactive glue shell, simply run:

glue

alternatively, you can also execute a request directly:

glue <REQUEST>

The simplest request you can do with glue is using just the method and the url:

glue 'get https://dog.ceo/api/breeds/list/all'
# or in glue shell:
get https://dog.ceo/api/breeds/list/all

Syntax

Overview

The main gluescipt request syntax is the following:

[METHOD] [URL] [OPERATORS]

Methods available

Operators available

Operators allow to execute operations on requests (body, headers params, nesting), on responses (selectors, variables)

JSON result selector

If the response is of type JSON, you can add a jsonpath selector to the request with the char ^. Glue will only return the desired value from the response. This applies also for Nested requests.

get https://dog.ceo/api/breeds/list/all^$.message.terrier

# OUTPUT:
# > [GET] https://dog.ceo/api/breeds/list/all
# 
# 
# [
#   [
#     "american",
#     "australian",
#     "bedlington",
#     "border",
#     "cairn",
#     "dandie",
#     "fox",
#     "irish",
#     "kerryblue",
#     "lakeland",
#     "norfolk",
#     "norwich",
#     "patterdale",
#     "russell",
#     "scottish",
#     "sealyham",
#     "silky",
#     "tibetan",
#     "toy",
#     "welsh",
#     "westhighland",
#     "wheaten",
#     "yorkshire"
#   ]
# ]

Body attributes

You can use the char ~ to add body attributes to the request:

post https://example.com/user/add ~username=admin
# or
post https://example.com/user/add~username=admin

# glue will send a body of type JSON 
# with a key "username" with value "admin"

Raw JSON Body

Raw JSON values can also be used between ~#-JSON- instead of single attributes:

post https://example.com/users ~#-{ "name": "John" }-#
# or 
post https://example.com/users~#-{ "name": "John" }-#

Note

Body attributes can take their value from another request's response by using nested requests feature.

Headers

You can use the char * to set headers to the request:

post https://example.com/user/add*authorization=6a75d4d7-84c3
# or
post https://example.com/user/add *authorization=6a75d4d7-84c3

# glue will set Authorization header
# to value "6a75d4d7-84c3"

Quotes can also be use to escape special glue chars or spaces in attributes:

post https://example.com/user/add*authorization="Bearer 6a75d4d7-84c3"

Note

Headers can take their value from another request's response by using nested requests feature.

Nested requests

One of the most useful features of glue is the request nesting.

You can reuse response values (total or partial) from a request to build another request.

Glue supports infinite nesting and will build a dependency tree, divide it in layers and execute each layer on parallel for the maximum time optimization.

You can use request nesting delimiting the desired nested request with {}:

get api.com/users/{ get api.com/me^$.user.id }/

# glue will execute this two requests:

# 1. api.com/me - and will select user.id from the response (eg. 12345)

# 2. api.com/users/12345/

Request can also be nested inside body or headers parameters:

get api.com/me *authorization={get api.com/login^$.access_token}/

Run file

You can also create a file with request to run, and pass the file path to glue with flag -f to execute it. You can try with one of the sample requests in examples folder:

glue -f examples/sample-request.glue

Multiple requests

Files can also contain multiple sequential requests separated by ;. Take a look at ./examples/sequential-requests.glue.

Save response in variable

You can save a request response in a temporary variable with a name of your choice with the char >, to reuse it without executing the call again.

get https://dog.ceo/api/breeds/list/all >test_req

to use the saved response:

req test_req

You can also use a selector on the saved response with ^:

req test_req^$.message.terrier

Note: Variables are available only in the same glueshell session and dropped at the end of it.

Contributing

The main purpose of this repository is to continue evolving glue core, making it faster and easier to use. Development of glue happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving glue.

Code of Conduct

glue has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Contributing Guide

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to glue.

Good First Issues

To help you get your feet wet and get you familiar with our contribution process, we have a list of good first issues that contain bugs which have a relatively limited scope. This is a great place to get started.

License

glue is MIT licensed.