GraphQL client in the terminal

Build and execute GraphQL queries in the terminal.

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

Installation

pip3 install gqt

It's recommended to install bat for pretty output.

Controls

Press h or ? for help.

Examples

Set default GraphQL endpoint:

export GQT_ENDPOINT=https://mys-lang.org/graphql

Interactively create a query and execute it:

gqt

{
    "statistics": {
        "numberOfGraphqlRequests": 3
    }
}

Repeat last query:

gqt -r

{
    "statistics": {
        "numberOfGraphqlRequests": 4
    }
}

Print the query (and variables) instead of executing it:

gqt -q

Query:
query Query {
  statistics {
    numberOfGraphqlRequests
  }
}

Variables:
{}

YAML output:

gqt -y

statistics:
  numberOfGraphqlRequests: 8

Name queries:

gqt -n stats -y

statistics:
  numberOfGraphqlRequests: 8

gqt -n time -y

standardLibrary:
  package:
    latestRelease:
      version: 0.20.0

gqt -n stats -y -r

statistics:
  numberOfGraphqlRequests: 9

gqt -n time -y -r

standardLibrary:
  package:
    latestRelease:
      version: 0.20.0

List queries:

gqt -l

Endpoint                      Query name
----------------------------  ------------
https://mys-lang.org/graphql  <default>
https://mys-lang.org/graphql  time
https://mys-lang.org/graphql  stats

Make arguments variables by pressing v and give them as -v <name>=<value> on the command line:

gqt -v name=time -y

standardLibrary:
  package:
    latestRelease:
      version: 0.20.0

gqt -r -q

query Query($name: String!) {
  standardLibrary {
    package(name: $name) {
      latestRelease {
        version
      }
    }
  }
}

Print the schema:

gqt --print-schema

type Query {
  standardLibrary: StandardLibrary!
  statistics: Statistics!
  activities: [Activity!]!
}

type StandardLibrary {
  package(name: String!): Package!
  packages: [Package!]
  numberOfPackages: Int
  numberOfDownloads: Int
}
...

Enpoint option and bearer token in HTTP auth header:

gqt -e https://api.github.com/graphql -H "Authorization: bearer ghp_<value>"

Ideas

Press c for compact view, hiding fields that are not selected.
Search:

Press / to search for visible fields. Press <Up> and <Down> to move to the previous and next search hit. Highlight all hits. Press <Enter> to end the search and move the cursor to the current hit. Press <Esc> to abort the search and restore the cursor to its pre-search position. Show number of hits.
```
╭─ Query
│ ▼ search
│   ▶ Book
│     ■ title
│   ▶ Author
│     ■ name
│ ▶ film
│ ▶ films

/fil                                                1 of 2 matches
```

Alias?

Press a to create an alias.
Press d to delete an alias.

smallPicture and mediumPicture are aliases of picture.

╭─ Query
│ ▶ Book
│   ▶ picture
│   ▼ smallPicture: picture
│     ■ width: 320
│     ■ height: 240
│   ▼ mediumPicture: picture
│     ■ width: 800
│     ■ height: 600

Optionally give schema path on command line. For endpoints that does not support schema introspection.

eerimoq/gqt

GraphQL client in the terminal

Installation

Controls

Examples

Ideas