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 instead of executing it:
gqt -qquery Query {
statistics {
numberOfGraphqlRequests
}
}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.0Make arguments variables by pressing v or $ 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
}
...Known issues
Unions and interfaces are not implemented.
And much more.
There is one query cache per gqt version. Would be nice to keep the cache after upgrading gqt.
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 │ ■ nameAlias?
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: 600Keep valid parts of any existing query when reloading the schema.
Cache across updates.
Save introspection response.
Save last query.
Save cursor and possibly other state.
-- ~/.cache/gqt/cache/generic/ +-- <endpoint 1> +-- schema.json +-- query.graphql +-- state.json +-- query_names/ +-- stats/ +-- schema.json +-- query.graphql +-- state.jsonOptionally 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.
