mix gaiia.introspect (Gaiia v0.2.0)

Copy Markdown View Source

Regenerate the bundled Gaiia schema dumps from a live introspection query.

The generated modules Gaiia.Queries and Gaiia.Mutations are built at compile time from priv/queries.json and priv/mutations.json, so the bundled dumps are the API surface: anything missing from them has no generated function. Run this task whenever Gaiia ships schema changes, then recompile.

GAIIA_API_KEY=... mix gaiia.introspect

Options

  • --endpoint — GraphQL endpoint (default https://api.gaiia.com/api/v1)
  • --api-key — API key; defaults to $GAIIA_API_KEY, then $GAIIA_KEY
  • --raw PATH — also write the untouched introspection response to PATH
  • --check — write nothing; exit non-zero if the dumps are out of date

Output

  • priv/queries.json, priv/mutations.json — operation specs consumed at compile time. Only the keys the generators need, so the compiled literals stay small.
  • docs/*.json — flattened, human-readable dumps of every type in the schema (objects, input objects, enums, unions, interfaces, scalars) plus the root operations, with types rendered in GraphQL syntax.