resolvetest

Overview ¶

Package resolvetest provides a way to define test data for resolvers.

Test data follows a simple format that describes universes (entire package ecosystems), resolved graphs, and test cases.

Below is the definition of two universes, one named sample, the other
named other, specified as a graph/schema definition.

-- Universe sample
alice
	1.0.0
		bob@1
bob
	1.0.0
	2.0.0
-- END

-- Universe other
eve
	1.0.0
		bob@1
-- END

Below is the definition of a test. It links a universe, a resolve root, a
graph for the expected resolution, and optionally sets flags.

-- Test alice
Resolve alice 1.0.0
Universe sample
Graph alice
Flag flag1 flag2
-- END

Below is the definition of a resolve.Graph, named alice, specified as a
graph/schema definition.
-- Graph alice
alice 1.0.0
└─ bob@1 1.0.0
-- END

Below is the definition of a test. It links two universes, a resolve root, a
graph for the expected resolution, and optionally sets flags. The first
universe, other, has no ID and is the default universe. The second has an
ID that is typically used in version attributes to refer to a registry.

-- Test eve
Resolve eve 1.0.0
Universe other, id_sample:sample
Graph eve
Flag flag1 flag2
-- END

Below is the definition of a resolve.Graph, named alice2, specified as a
prototext message.
alice 1.0.0
└─ bob@1 1.0.0
-- Graph prototext alice2
node: {
	version: {
		system: NPM
		package_name: "alice"
		version_type: CONCRETE
		version: "1.0.0"
	}
}
node: {
	version: {
		system: NPM
		package_name: "bob"
		version_type: CONCRETE
		version: "1.0.0"
	}
}
edge: {
	to: 1
	requirement: "1"
}
-- END