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
Press h or ? for help.
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 (and variables) instead of executing it:
gqt -qQuery:
query Query {
statistics {
numberOfGraphqlRequests
}
}
Variables:
{}YAML output:
gqt -ystatistics:
numberOfGraphqlRequests: 8Name queries:
gqt -n stats -ystatistics:
numberOfGraphqlRequests: 8gqt -n time -ystandardLibrary:
package:
latestRelease:
version: 0.20.0gqt -n stats -y -rstatistics:
numberOfGraphqlRequests: 9gqt -n time -y -rstandardLibrary:
package:
latestRelease:
version: 0.20.0List queries:
gqt -lEndpoint Query name
---------------------------- ------------
https://mys-lang.org/graphql <default>
https://mys-lang.org/graphql time
https://mys-lang.org/graphql statsMake arguments variables by pressing v and give them as -v <name>=<value> on the command line:
gqt -v name=time -ystandardLibrary:
package:
latestRelease:
version: 0.20.0gqt -r -qquery Query($name: String!) {
standardLibrary {
package(name: $name) {
latestRelease {
version
}
}
}
}Print the schema:
gqt --print-schematype 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 matchesAlias?
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: 600Optionally give schema path on command line. For endpoints that does not support schema introspection.
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.
