GraphQL

Generate a GraphQL schema: types, interfaces, scalars and enums, but no queries.

Usage

CLI

ohi get w3c/prov-o
ohi linkml to graphql --pruning-mode schema \
  --to prov-o.graphql prov-o.linkml.yaml

Python

import ohi_linkml

with ohi_linkml.load_file("prov-o.linkml.yaml") as schema:
    output = schema.graphql(pruning_mode="schema")

JavaScript

import { readFileSync } from "node:fs";
import { LinkML } from "@neverblink/linkml";

const yaml = readFileSync("prov-o.linkml.yaml", "utf8");
const { view, report } = LinkML.loadFromString(yaml, {});
if (!view) throw new Error(JSON.stringify(report));
const output = view.graphql({ pruning_mode: "schema" });

Scala

import eu.neverblink.linkml.generator.options.*
import eu.neverblink.linkml.generator.graphql.GraphQlGenerator
import eu.neverblink.linkml.schemaview.{SchemaIssues, SchemaView}

val loaded = SchemaView.loadSchemaViewFromUri("prov-o.linkml.yaml")
given SchemaView = SchemaIssues.orThrow(loaded)
val output = GraphQlGenerator().serialize(
  GraphQlGeneratorOptions(pruningMode = PruningMode.Schema),
)

C

#include <stddef.h>
#include "ohi_linkml.h"

linkml_init_threads();
char *report = NULL, *error = NULL;
long long schema =
    linkml_load_file("prov-o.linkml.yaml", NULL, &report, &error);
char *output = linkml_graphql(
    schema,
    "{\"pruning_mode\": \"schema\"}",
    &error
);
linkml_free(output);
linkml_free(report);
linkml_free(error);
linkml_close(schema);

Try it in the playground, with PROV-O

Options

metadata_languagestringdefault en

CLI --metadata-languageScala metadataLanguage

The language of the titles and descriptions in the output, for schemas with text in more than one language.

pruning_modePruningModedefault schema

CLI --pruning-modeScala pruningMode

The elements of the schema to include in the output.

• tree_root The elements reachable from the tree root class. Without a tree root, the same as schema.
• schema Everything defined in the root schema, and every element reachable from it. This leaves out the unused parts of imported schemas, such as most of linkml:types.
• skip Every element of the root schema and of all its imports.

tree_rootstring

CLI --tree-rootScala treeRoot

The class to use as the tree root, instead of the class with tree_root: true in the schema. Only for the tree_root pruning mode.