gqt 0.84.0

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 instead of executing it:

$ gqt -q
query Query {
  statistics {
    numberOfGraphqlRequests
  }
}

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

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
}
...

Known issues

• Unions and interfaces are not implemented.

• And much more.

Ideas

• Unions:

  Always query __typename.

  union SearchResult = Book | Author
  
  type Book {
    title: String!
  }
  
  type Author {
    name: String!
  }
  
  type Query {
    search(contains: String): [SearchResult!]
  }
  
  Unselected:
  
  ╭─ Query
  │ ▶ search
  
  Selected:
  
  ╭─ Query
  │ ▼ search
  │   ▶ Book
  │     ■ title
  │   ▶ Author
  │     ■ name

• 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

• Check for schema modifications when starting. Do it in the background and notify the user if it was modified.

  New schema fetched from the server. Use it? y/n

• Variables example:

  ╭─ Query
  │ ▼ standardLibrary
  │   ▼ package
  │     $ name: name
  │     ■ id: 5
  │     $ kind: kind
  │     □ name
  │   □ numberOfDownloads
  │ ▶ statistics
  
  ╭─ Variables
  │ name: time
  │ kind:
  │   [0] ■ a: bar
  │       ■ b: ne
  │       □ c:
  │   [1]

• Print variables:

  $ gqt -v
  {"name": "foo", "kind": [{"a": "bar", "b": "ne"}]}

• Subscriptions. Probably out of scope.