rules_xsd

bazel_dep(name = "rules_xsd", version = "0.0.1")

common --registry=https://registry.fastverk.com/
common --registry=https://bcr.bazel.build/

bazel_dep(name = "rules_xsd", version = "0.0.1")

Real usage, taken from the module’s examples/.

examples/BUILD.bazel

load("//xsd:defs.bzl", "xsd_schema", "xsd_to_vocab", "xsd_validate_test")

package(default_visibility = ["//visibility:public"])

# A two-schema closure: person.xsd imports common.xsd by namespace. The import's
# schemaLocation is a remote URL that is never fetched — xsd_validate resolves it
# from this local closure (matched on targetNamespace), so the gate is offline.

xsd_schema(
    name = "common",
    srcs = ["common.xsd"],
)

xsd_schema(
    name = "person",
    srcs = ["person.xsd"],
    deps = [":common"],
)

# Gate: the instance validates against the person schema + its closure.
xsd_validate_test(
    name = "person_valid",
    schema = ":person",
    xml = "person.xml",
)

# XSD → RDF/OWL: generate a Turtle vocabulary (person → owl:Class, id → property).
xsd_to_vocab(
    name = "person_vocab",
    namespace = "https://example.org/person#",
    schema = ":person",
)

from docs/defs.md

User-facing XSD rules (the rules_xsd seed).

Two rules, deliberately shaped like rules_rdf’s rdf_dataset + rdf_validate_test so the whole package lifts into a standalone rules_xsd ruleset once the shape settles (legislative-kg §11):

• xsd_schema(name, srcs, deps) — declare an XSD plus the schemas it imports (as other xsd_schema targets). Produces XsdInfo carrying the transitive import closure, the XSD analog of an rdf_dataset closure.

• xsd_validate_test(name, schema, xml) — assert an XML instance validates against an XsdInfo’s schema (resolving every <xsd:import> from the local closure, never the network). The first correct-by-construction gate.

load("//xsd:defs.bzl", "xsd_schema", "xsd_validate_test")

xsd_schema(name = "xml_ns", srcs = ["@uslm_schema//:xml.xsd"])
xsd_schema(name = "uslm",   srcs = ["@uslm_schema//:USLM-1.0.15.xsd"], deps = [":xml_ns", ...])

xsd_validate_test(name = "slice_valid", schema = ":uslm", xml = "//data:usc_t26_slice.xml")

Next step (the owl:imports-strict-manifest analog): an aspect that parses each schema’s <xsd:import namespace=…> and fails unless every imported namespace is covered by a declared dep’s targetNamespace — a closure-completeness gate. For the first cut, deps are explicit and the validator fails loudly if a needed namespace is absent from the closure.

xsd_schema

load("@rules_xsd//xsd:defs.bzl", "xsd_schema")

xsd_schema(name, deps, srcs, root)

Declare an XSD schema + its transitive import closure.

ATTRIBUTES

Name	Description	Type	Mandatory	Default
name	A unique name for this target.	Name	required
deps	Imported schemas (other xsd_schema targets); their closures fold into this one’s transitive_files.	List of labels	optional	[]
srcs	This schema’s own .xsd file(s).	List of labels	required
root	Entry-point schema to validate / generate against (defaults to srcs[0]).	Label	optional	None

xsd_to_vocab

load("@rules_xsd//xsd:defs.bzl", "xsd_to_vocab")

xsd_to_vocab(name, namespace, schema)

Generate a Turtle RDF/OWL vocabulary from an XSD — the ‘XSD -> RDF, first instance’. Feed the output to jena_schemagen for typed views.

ATTRIBUTES

Name	Description	Type	Mandatory	Default
name	A unique name for this target.	Name	required
namespace	Ontology namespace IRI for the generated terms (defaults to the schema’s targetNamespace + ’#’).	String	optional	""
schema	The xsd_schema whose root is translated to an RDF/OWL vocabulary.	Label	required

xsd_validate_test

load("@rules_xsd//xsd:defs.bzl", "xsd_validate_test")

xsd_validate_test(name, schema, xml)

Assert an XML instance validates against an XSD closure (offline).

ATTRIBUTES

Name	Description	Type	Mandatory	Default
name	A unique name for this target.	Name	required
schema	The xsd_schema to validate against (its closure resolves imports).	Label	required
xml	The XML instance to validate.	Label	required

from docs/providers.md

Providers for the generic XSD layer (the rules_xsd seed).

XsdInfo is the XSD analog of rules_rdf’s RdfDatasetInfo: a schema plus the transitive closure of the schemas it imports, so a validator (or, later, an XSD→emitter generator) sees the whole closure with no network access. An XSD is rarely standalone — USLM-1.0 imports XML, Dublin Core terms, and XHTML — so the closure is first-class, exactly as RDF graphs carry their owl:imports closure.

XsdInfo

load("@rules_xsd//xsd:providers.bzl", "XsdInfo")

XsdInfo(schema_root, transitive_files)

A declared XSD schema and its transitive import closure.

FIELDS

Name	Description
schema_root	File: the entry-point .xsd to validate / generate against.
transitive_files	depset[File]: schema_root plus the full import closure (this schema’s own srcs + every dep’s closure).