graphql-codegen-compiler

This package compiles the output of graphql-codegen-core along with GeneratorConfig and Settings, and compiles the template, returns an array of FileOutput.

The main entry point of the package is compile method, and you can import it directly and use it without the CLI package.

We are using Handlebars as template compiler, with some custom Handlebars helpers that helps to generate GraphQL related code easily.

GraphQL-related Template Helpers

$3

Accepts a string with a GraphQL type and converts it to the language primitive as specified in the template config, if the type isn't a primitive - it just returns it.

Example:
``graphql
type MyType {
f1: String
}
`
`handlebars
{{#each types}}
Type {{ name }} fields:
{{#each fields}}
Field {{ name }} type is: {{ toPrimitive type }}
{{/each}}
{{/each}}
`
Output:
`
Type MyType fields:
Field f1 type is: string
`

$3

Special GraphQL helper that accepts any GraphQL entity, and extracts the GraphQL Directives of the entity.

The compiled context is the arguments values of the entity.

Example:
`graphql
type MyType @addName(name: "Dotan") {
f1: String
}

directive @addName(name: String!) on OBJECT
`
`handlebars
{{#each types}}
Type name: {{ name }}
Extra name? {{#ifDirective this "addName"}}Yes! and the name is: {{ name }}{{/ifDirective}}

{{/each}}
`
Output:
`
Type name: MyType
Extra name? Yes! and the name is: Dotan
`

$3

The opposite of ifDirective.

Example:
`graphql
type MyType {
f1: String
}

directive @addName(name: String!) on OBJECT
`
`handlebars
{{#each types}}
Type name: {{ name }}
Extra name? {{#unlessDirective this "addName"}}No!{{/unlessDirective}}

{{/each}}
`
Output:
`
Type name: MyType
Extra name? No!
`

$3

Locates GraphQL element of type with name name, use it if you need to access GraphQL specific element, for example "MyType" of "type".

Super useful when you need to access the actual object inside withImports or in any other case.

`graphql
type MyType {
f1: String
}
`
`handlebars
{{#withGql "type" "MyType"}}
{{ name }}
{{/withGql}}
`
Output:
`
MyType
`

$3

Locates all external uses of context, and returns an array of: { name: string, type: string, filename: string }, so you can use it to create imports when generating multiple files.

context can be any GraphQL available object.

`graphql
type MyType {
f: OtherType
}
`
`handlebars
{{#eachImport this }}
import { {{ name }} } from './{{ file }}';
{{/eachImport}}
`
Output:
`
import { OtherType } from './othertype.type';
`

$3

Prints a string as comment with / ... /, and also trims multiple lines into a single line.

Useful for description field of GraphQL entities.

Example:
`handlebars
{{toComment "hi"}}
`
Output:
`
/ hi /
`

$3

Iterates over a calculated array of imports (file names) that in use by the element.

Example:
`handlebars
{{#eachImport type}}
import { {{ name }} } from './{{file}}';
{{/eachImport}}
`

Other Template Helpers

$3

Returns the template child string count times, the execution context of the child content is the i/times.

Example:
`handlebars
{{#times 3}}
Hello {{ this }}!
{{/times}}
`
Output:
`
Hello 0
Hello 1
Hello 2
`

$3

Similar to for loop.

Returns the template child string amount of times according to from to to by increasing incr, the execution context of the child content is the i/times.

Example:
`handlebars
{{#for 3 6 1}}
Hello {{ this }}!
{{/times}}
`
Output:
`
Hello 3
Hello 4
Hello 5
`

$3

Similar to for loop.

Returns the template child string amount of times according to from to to by increasing incr, the execution context of the child content is the i/times.

Example:
`handlebars
{{#for 3 6 1}}
Hello {{ this }}!
{{/times}}
`
Output:
`
Hello 3
Hello 4
Hello 5
`

$3

Return a lowercase version of the string.

Example:
`handlebars
{{toLowerCase "Hello" }}
`
Output:
`
hello
`

$3

Return an uppercase version of the string.

Example:
`handlebars
{{toUpperCase "Hello" }}
`
Output:
`
HELLO
`

$3

Return an snake case version of the string.

Example:
`handlebars
{{toSnakeCase "doSomething" }}
`
Output:
`
do-something
`

$3

Return an title case version of the string.

Example:
`handlebars
{{toTitleCase "doSomething" }}
`
Output:
`
Do Something
`

$3

Return an camel case version of the string.

Example:
`handlebars
{{toCamelCase "DoSomething" }}
`
Output:
`
doSomething
`

$3

Converts a multiline string into a string with line breaks, to prevent code from being broken.

Example:
`handlebars
{{toCamelCase "myString
other line" }}
`
Output:
`
"myString" +
"other line"
`

$3

Executes a simple if command of two parameters, using comparator.

Available comparators: ===, ==, !==, !=, <, <=, >, >=, &&, ||.

Example:
`handlebars
{{#ifCond "test" "===" "test"}}
Hi!
{{/ifCond}}
`
Output:
`
Hi!
``