gqt 0.26.0

GraphQL query builder.

This project is inspired by https://graphiql-online.com.

Installation

$ pip3 install gqt

Usage

Set default GraphQL end-point URL:

$ export GQT_URL=https://mys-lang.org/graphql

Interactively create a query and execute it:

$ gqt
{
    "statistics": {
        "start_date_time": "2022-05-29 20:54:48",
        "number_of_graphql_requests": 234
    }
}

Repeat last query:

$ gqt -r
{
    "statistics": {
        "start_date_time": "2022-05-29 20:54:48",
        "number_of_graphql_requests": 234
    }
}

Print the query instead of executing it:

$ gqt -q
{"query":"{statistics {start_date_time number_of_graphql_requests}}"}

Use jq for colors (not seen below) and extracting field values:

$ gqt | jq
{
  "statistics": {
    "start_date_time": "2022-05-29 20:54:48",
    "number_of_graphql_requests": 235
  }
}
$ gqt | jq .statistics.number_of_graphql_requests
236

Ideas

• Print built query instead of executing it.

• Contols:

  • Use / to fuzzy find field.

• Variables:

  ╭─ Query
  │ ▼ standard_library
  │   ▼ package
  │     $ name*: name
  │     ■ id*: 5
  │     □ name
  │   □ number_of_downloads
  │ ▶ statistics
  
  ╭─ Variables
  │ ■ name: "foo"

• Arguments:

  Marked with *, or possibly color, or a combination.

  □: null
  ■: not null
  $: variable

  Scalar example:

  ╭─ Query
  │ ▼ standard_library
  │   ▼ package
  │     ■ name*: ""             # Cannot be unselected as it cannot be null.
  │     □ name
  │   ▶ packages

  List example:

  ╭─ Query
  │ ▼ item
  │   □ kinds*:                 # Argument is null.
  │   ■ kinds2*:                # List with two elements.
  │     [0] ■ a: "foo"
  │         ■ b: "eq"
  │         ■ c:
  │           [0] ■ a: "x"
  │               ■ b: "y"
  │           [1]
  │     [1] ■ a: "bar"
  │         ■ b: "ne"
  │         □ c:
  │     [2]