Struct apollo_compiler::ast::Document

pub struct Document {
    pub sources: SourceMap,
    pub definitions: Vec<Definition>,
}

Fields

sources: SourceMap

If this document was originally parsed from a source file, this map contains one entry for that file and its ID.

The document may have been modified since.

definitions: Vec<Definition>

Implementations

impl Document

pub fn new() -> Self

Create an empty document

pub fn parser() -> Parser

Return a new configurable parser

pub fn parse(source_text: impl Into<String>, path: impl AsRef<Path>) -> Self

Parse input with the default configuration

path is the filesystem path (or arbitrary string) used in diagnostics to identify this source file to users.

pub fn check_parse_errors(&self) -> Result<(), Diagnostics>

Returns Diagnostics for cases where parsed input does not match the GraphQL grammar or where the parser reached a token limit or recursion limit.

Does not perform any validation beyond this syntactic level.

pub fn validate_standalone_executable(&self) -> Result<(), Diagnostics>

Validate as an executable document, as much as possible without a schema

pub fn to_schema(&self) -> Schema

Build a schema with this AST document as its sole input.

pub fn to_schema_builder(&self, builder: &mut SchemaBuilder)

Add this AST document as an additional input to a schema builder.

This can be used to build a schema from multiple documents or source files.

pub fn to_executable(&self, schema: &Schema) -> ExecutableDocument

Build an executable document from this AST, with the given schema

pub fn to_mixed(&self) -> (Schema, ExecutableDocument)

Build a schema and executable document from this AST containing a mixture of type system definitions and executable definitions. This is mostly useful for unit tests.

pub fn serialize(&self) -> Serialize<'_, Self>

Returns a builder that has chaining methods for setting serialization configuration, and implements the Display and ToString traits by writing GraphQL syntax.

Trait Implementations

impl Clone for Document

fn clone(&self) -> Document

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl Default for Document

fn default() -> Self

Returns the “default value” for a type.

impl Display for Document

Serialize to GraphQL syntax with the default configuration

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

Formats the value using the given formatter.

impl Hash for Document

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Document

source is ignored for comparison

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Document