GraphQL client in the terminal.
Project description
Build and execute GraphQL queries in the terminal.
This project is inspired by https://graphiql-online.com.
Installation
pip3 install gqtIt’s recommended to install bat for pretty output.
Controls
Navigate with arrow keys.
Select fields with <Space>.
Toggle between argument selection and its value with <Tab>.
End with <Enter>.
Examples
Set default GraphQL endpoint:
$ export GQT_ENDPOINT=https://mys-lang.org/graphqlInteractively 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
{statistics {numberOfGraphqlRequests}}YAML output:
$ gqt -y
statistics:
numberOfGraphqlRequests: 8Print 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
Arguments does not work very well.
Fragments and unions are not implemented.
Mutations and subscriptions are not implemented.
And much more.
Ideas
Show GraphQL API documentation.
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
Mutations?
Subscriptions?
Arguments and variables:
For required arguments without default value:
■: non-null value $: variableFor required arguments with default value:
□: omit ■: non-null value $: variableFor optional arguments:
□: omit ■: non-null value $: variable n: nullScalar example:
╭─ Query │ ▼ standard_library │ ▼ package │ ■ name: "" │ □ name │ ▶ packagesList example:
╭─ Query │ ▼ item │ □ kinds: │ ■ kinds2: │ [0] ■ a: "foo" │ ■ b: "eq" │ ■ c: │ [0] ■ a: "x" │ ■ b: "y" │ [1] │ [1] ■ a: "bar" │ ■ b: "ne" │ □ c: │ [2]Input example:
╭─ Query │ ▼ item │ ■ config: │ ■ unit: "metric" │ □ width: │ □ length │ □ weightVariables example:
╭─ Query │ ▼ standardLibrary │ ▼ package │ $ name: name │ ■ id: 5 │ $ kind: kind │ □ name │ □ numberOfDownloads │ ▶ statistics ╭─ Variables │ name: "foo" │ kind: │ [0] ■ a: "bar" │ ■ b: "ne" │ □ c: │ [1]Print the variables:
$ gqt -v {"name": "foo", "kind": [{"a": "bar", "b": "ne"}]}
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
