Document all_builds (/eval/{eval-id}/builds) endpoint

[sternenseemann]

The endpoint is implemented here:

hydra/src/lib/Hydra/Controller/JobsetEval.pm

Lines 188 to 196 in 00d3087

	# Return full info about all the builds in this evaluation.
	sub all_builds : Chained('evalChain') PathPart('builds') Args(0) {
	my ($self, $c) = @_;
	my @builds = $c->stash->{eval}->builds;
	$self->status_ok(
	$c,
	entity => [@builds],
	);
	}

[Mindavi]

Tried this out on my local instance and on hydra.nixos.org, and indeed this endpoint exists! Thanks for documenting it, it's a very useful endpoint and prevents having to scrape html or do hundreds of thousands of requests (if you want to check all builds in a nixpkgs eval...)

[sternenseemann]

I think it has a lot of potential, especially for e.g. nix-review-tools which currently scrapes the jobset overview HTML with ?full=1 passed. However, the endpoint is very slow at the moment which can hopefully be helped somehow, though.

It is actively used by hydra-report.hs in maintainers/scripts/haskell.