Struct artemis_build::CodegenBuilder

pub struct CodegenBuilder { /* fields omitted */ }

Configuration object for code generation

This is used to generate the query structs and modules that are required as well as TypeScript definitions and some static analysis info.

Methods

impl CodegenBuilder

pub fn new() -> Self

Create a new codegen builder with default configuration values. Note that a schema must be set, either by setting a file or introspecting it. All other configuration is optional, though it won't do much if you don't add any queries.

pub fn add_query<T: AsRef<Path>>(self, query_path: T) -> Self

Add a query to have the code generator generate a module for it. This is currently opt-in for each file to prevent accidentally generating unneeded code, but a directory based approach may be added later.

pub fn with_derives_on_variables<T: Into<String>>(self, derives: T) -> Self

A comma-separated list of derives to add to the generated Variables and input structs. The default derives are Serialize and Clone, with Deserialize added if the target arch is wasm32. Adding these here won't break anything, but it's redundant.

pub fn with_derives_on_response<T: Into<String>>(self, derives: T) -> Self

A comma-separated list of derives to add to the generated ResponseData and output structs. The default derives are Deserialize and Clone, with Serialize added if the target arch is wasm32. Adding these here won't break anything, but it's redundant.

pub fn with_deprecation_strategy(self, strategy: DeprecationStrategy) -> Self

Set the deprecation strategy used for codegen. Can be used to either warn or completely fail the build if any of your GraphQL queries contain deprecated fields.

pub fn with_out_dir<T: AsRef<Path>>(self, out_dir: T) -> Self

Set the output directory for the query module. Defaults to OUT_DIR, but it's recommended to put this in an otherwise empty folder in src.

pub fn with_schema<T: AsRef<Path>>(self, schema_path: T) -> Self

Sets the schema from a JSON or GraphQL file. The schema should be the result of an introspection query done against the API you're generating code for. If this isn't set, introspect_schema must be used.

pub fn build(self) -> Result<(), BuildError>

Finish the configuration and generate the queries module. It will generate a exchanges and a file for each query in the selected output directory. It's recommended for that to be an empty directory in src.

This returns an error if an output directory was not set and OUT_DIR could not be read, a schema was not found or an error occurred during codegen or IO.

Trait Implementations

impl Debug for CodegenBuilder

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for CodegenBuilder

fn default() -> CodegenBuilder

Returns the "default value" for a type.