Note: "Query" is used broadly to mean both query and mutation
build GraphQL queries
batch execute those queries
Need quick batching? factory function is the answer
Need to split the query build and query batching process? Checkout builder and batcher
Sample project: graphql-query-factory-test
factory included as of 1.0.20 (shim around builder and batcher)batcher included as of 1.0.20 (executes array of queries)builder updated (this builds query strings from query/mutation and variables)
You can see TODOs and release plans in todo.md
npm install graphql-query-factory -S
When using factory or batcher you must include two environment variables:
GQL_SIMPLE_ENDPOINTGQL_AUTH_TOKEN
All of these examples can be seen at graphql-query-factory-test
All mock variables (e.g. "mock.template", "mock.variables") can be viewed here: .../tests/_mock.js
const { builder } = require ( ' graphql-query-factory ' ) ;
let queries = builder ( mock . template , mock . variables ) ;
log ( ` builder(mock.template, mock.variables): ${ queries } ` ) ;
NOTE: async version has been replaced here with sync version.
Will be adding async version of builder in future along with a stream. See todo.md for details.
const { factory } = require ( ' graphql-query-factory ' ) ;
factory ( mock . template , mock . variables )
. then ( data =>
log (
` factory(mock.template, mock.variables): ${ JSON . stringify ( data , null , 4 ) } `
)
)
. catch ( err => log ( ` factory(mock.template, mock.variables): ${ err } ` ) ) ;
const { batcher } = require ( ' graphql-query-factory ' ) ;
batcher
. batch ( mock . batchQuery )
. then ( data =>
log ( ` batcher.batch(mock.batchQuery): ${ JSON . stringify ( data , null , 4 ) } ` )
)
. catch ( err => log ( ` batcher.batch(mock.batchQuery): ${ err } ` ) ) ;
The following output is generated by the example project, graphql-query-factory-test
mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupA "
r a w : " rawA "
) {
m a r k u p
r a w
}
} ,mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupB "
r a w : " rawB "
) {
m a r k u p
r a w
}
} ,mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupC "
r a w : " rawC "
) {
m a r k u p
r a w
}
} ,mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupD "
r a w : " rawD "
) {
m a r k u p
r a w
}
} ,mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupE "
r a w : " rawE "
) {
m a r k u p
r a w
}
} ,mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupF "
r a w : " rawF "
) {
m a r k u p
r a w
}
} ,mutation {
c r e a t e C o n t e n t (
m a r k u p : " markupG "
r a w : " rawG "
) {
m a r k u p
r a w
}
}
[
{
" createContent " : {
" markup " : " markupA " ,
" raw " : " rawA "
}
} ,
{
" createContent " : {
" markup " : " markupB " ,
" raw " : " rawB "
}
} ,
{
" createContent " : {
" markup " : " markupC " ,
" raw " : " rawC "
}
} ,
{
" createContent " : {
" markup " : " markupD " ,
" raw " : " rawD "
}
} ,
{
" createContent " : {
" markup " : " markupE " ,
" raw " : " rawE "
}
} ,
{
" createContent " : {
" markup " : " markupF " ,
" raw " : " rawF "
}
} ,
{
" createContent " : {
" markup " : " markupG " ,
" raw " : " rawG "
}
}
]
[
{
" createContent " : {
" markup " : " markupA " ,
" raw " : " rawA "
}
} ,
{
" createContent " : {
" markup " : " markupB " ,
" raw " : " rawB "
}
} ,
{
" createContent " : {
" markup " : " markupC " ,
" raw " : " rawC "
}
} ,
{
" createContent " : {
" markup " : " markupD " ,
" raw " : " rawD "
}
} ,
{
" createContent " : {
" markup " : " markupE " ,
" raw " : " rawE "
}
} ,
{
" createContent " : {
" markup " : " markupF " ,
" raw " : " rawF "
}
} ,
{
" createContent " : {
" markup " : " markupG " ,
" raw " : " rawG "
}
}
]
