Skip to content

graflo.rdf.cli

CLI commands for GraphManifest RDF conversion.

manifest_to_rdf(manifest_path, output_format, base_uri, output_path, include_ontology)

Convert a GraphManifest YAML file to RDF.

Source code in graflo/rdf/cli.py 
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
@click.command("manifest-to-rdf")
@click.argument(
    "manifest_path",
    type=click.Path(exists=True, dir_okay=False, path_type=pathlib.Path),
)
@click.option(
    "--format",
    "output_format",
    type=click.Choice(["turtle", "json-ld", "nt", "xml"], case_sensitive=False),
    default="turtle",
    show_default=True,
    help="RDF output format.",
)
@click.option(
    "--base-uri",
    required=True,
    help="Base URI for manifest resource IRIs (e.g. https://mygraph.dev/manifests/v1).",
)
@click.option(
    "--output",
    "output_path",
    type=click.Path(dir_okay=False, path_type=pathlib.Path),
    default=None,
    help="Output file path. Prints to stdout when omitted.",
)
@click.option(
    "--include-ontology/--no-include-ontology",
    default=True,
    show_default=True,
    help="Embed GraFlo meta-ontology triples in output.",
)
def manifest_to_rdf(
    manifest_path: pathlib.Path,
    output_format: str,
    base_uri: str,
    output_path: pathlib.Path | None,
    include_ontology: bool,
) -> None:
    """Convert a GraphManifest YAML file to RDF."""
    manifest = _load_manifest(manifest_path)
    serializer = ManifestRdfSerializer(include_ontology=include_ontology)
    graph = serializer.to_graph(manifest, base_uri)
    serialized = graph.serialize(format=output_format.lower())

    if output_path is None:
        click.echo(serialized)
        return

    output_path.parent.mkdir(parents=True, exist_ok=True)
    output_path.write_text(serialized, encoding="utf-8")

rdf_to_manifest(rdf_path, manifest_uri, input_format, output_path)

Convert RDF (GraFlo meta-ontology) back to GraphManifest YAML.

Source code in graflo/rdf/cli.py 
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
@click.command("rdf-to-manifest")
@click.argument(
    "rdf_path",
    type=click.Path(exists=True, dir_okay=False, path_type=pathlib.Path),
)
@click.option(
    "--manifest-uri",
    required=True,
    help="GraphManifest subject URI inside the RDF document.",
)
@click.option(
    "--input-format",
    type=click.Choice(["turtle", "json-ld", "nt", "xml", "n3"], case_sensitive=False),
    default="turtle",
    show_default=True,
    help="RDF input format.",
)
@click.option(
    "--output",
    "output_path",
    type=click.Path(dir_okay=False, path_type=pathlib.Path),
    default=None,
    help="Output manifest YAML path. Prints to stdout when omitted.",
)
def rdf_to_manifest(
    rdf_path: pathlib.Path,
    manifest_uri: str,
    input_format: str,
    output_path: pathlib.Path | None,
) -> None:
    """Convert RDF (GraFlo meta-ontology) back to GraphManifest YAML."""
    from rdflib import Graph

    graph = Graph()
    graph.parse(str(rdf_path), format=input_format.lower())
    manifest = ManifestRdfDeserializer().from_graph(graph, manifest_uri)

    if output_path is None:
        click.echo(
            yaml.safe_dump(manifest.to_minimal_canonical_dict(), sort_keys=False)
        )
        return

    _write_manifest(output_path, manifest)