Generate queries from graphql schema, used for writing api test.
# Install
npm install gql-generator -g
# see the usage
gqlg --help
# Generate sample queries from typeDefs
gqlg --schemaFilePath ./example/sampleTypeDef.graphql --destDirPath ./example/outputNow you can find the generated queries in the destDir: ./example/output.
# Sample schema
type Query {
user(id: Int!): User!
}
type User {
id: Int!
username: String!
email: String!
createdAt: String!
}# Sample query generated
query user($id: Int!) {
user(id: $id){
id
username
email
createdAt
}
}This tool will generate 3 folders holding the queries: mutations, queries and subscriptions. And generate a index.js exports the queries in each folder.
Also another index.js is generated in the root destPath to export all the queries (you can look into the example folder for details of generated files).
After generating the queries, you can require them like this:
// require all the queries
const queries = require('./example/output');
// require mutations only
const mutations = require('./example/output/mutations');
// sampe content
console.log(queries.mutations.signup);
console.log(mutations.signup);
/*
mutation signup($username: String!, email: String!, password: String!){
signup(username: $username, email: $email, password: $password){
token
user {
id
username
email
createdAt
}
}
}
*/The output folder inside example folder is generated from the sampleTypeDef.graphql by this command:
gqlg --schemaFilePath ./example/sampleTypeDef.graphql --destDirPath ./example/outputSay you have a graphql schema like this:
type Mutation {
signup(
email: String!
username: String!
password: String!
): UserToken!
}
type UserToken {
token: String!
user: User!
}
type User {
id: Int!
username: String!
email: String!
createdAt: String!
}Before this tool, you write graphql api test like this:
const { GraphQLClient } = require('graphql-request');
require('should');
const host = 'http://localhost:8080/graphql';
test('signup', async () => {
const gql = new GraphQLClient(host);
const query = `mutation signup($username: String!, email: String!, password: String!){
signup(username: $username, email: $email, password: $password){
token
user {
id
username
email
createdAt
}
}
}`;
const data = await gql.request(query, {
username: 'tim',
email: '[email protected]',
password: 'samplepass',
});
(typeof data.signup.token).should.equal('string');
);As gqlg generated the queries for you, you don't need to write the query yourself, so your test will becomes:
const { GraphQLClient } = require('graphql-request');
require('should');
const mutations = require('./example/output/mutations');
const host = 'http://localhost:8080/graphql';
test('signup', async () => {
const gql = new GraphQLClient(host);
const data = await gql.request(mutations.signup, {
username: 'tim',
email: '[email protected]',
password: 'samplepass',
});
(typeof data.signup.token).should.equal('string');
);As this tool is used for test, it expends all the fields in a query. And as we know, there might be recursive field in the query. So gqlg ignores the types which has been added in the parent queries already.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent