From be713f8a30788861806a74865b07403aa6774117 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Lassieur?= <clement@lassieur.org>
Date: Mon, 2 Jul 2018 17:25:31 +0200
Subject: database: Call a specification 'jobset' instead of 'project'.

This removes the possibility to filter specifications by branch, because
branches were previously called 'jobset'.  But it doesn't matter because later
on, specifications will have as many branches as inputs.  And people should
filter by specification name instead.

* doc/cuirass.texi (Build Information, Latest builds): Remove 'jobset',
replace 'project' with 'jobset'.
* src/cuirass/http.scm (build->hydra-build): Idem.
* tests/database.scm (db-get-builds): Idem.
* tests/http.scm (build-query-result, /api/latestbuilds?nr=1&jobset=guix,
/api/latestbuilds?nr=1&jobset=gnu): Idem.
* src/cuirass/database.scm (db-format-build, db-get-builds): Don't associate
builds with branches (which were called 'jobset' afterwards).
(db-get-builds): Remove the #:project filter.
---
 doc/cuirass.texi | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

(limited to 'doc')

diff --git a/doc/cuirass.texi b/doc/cuirass.texi
index b5b27e8..4dbb723 100644
--- a/doc/cuirass.texi
+++ b/doc/cuirass.texi
@@ -12,7 +12,8 @@ server.
 
 Copyright @copyright{} 2016, 2017 Mathieu Lirzin@*
 Copyright @copyright{} 2017 Mathieu Othacehe@*
-Copyright @copyright{} 2018 Ludovic Courtès
+Copyright @copyright{} 2018 Ludovic Courtès@*
+Copyright @copyright{} 2018 Clément Lassieur
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -438,8 +439,7 @@ $ curl -s "http://localhost:8080/build/2" | jq
 
 @{
   "id": 2,
-  "project": "guix",
-  "jobset": "master",
+  "jobset": "guix",
   "job": "acpica-20150410-job",
   "timestamp": 1501347493,
   "starttime": 1501347493,
@@ -477,11 +477,8 @@ hereafter.
 @item id
 The unique build id.
 
-@item project
-The associated specification name, as a string.
-
 @item jobset
-The associated specification branch, as a string.
+The associated specification name, as a string.
 
 @item job
 The associated job-name, as a string.
@@ -576,9 +573,6 @@ This request accepts a mandatory parameter and multiple optional ones.
 @item nr
 Limit query result to nr elements. This parameter is @emph{mandatory}.
 
-@item project
-Filter query result to builds with the given @code{project}.
-
 @item jobset
 Filter query result to builds with the given @code{jobset}.
 
@@ -596,10 +590,10 @@ For example, to ask for the ten last builds:
 $ curl "http://localhost:8080/api/latestbuilds?nr=10"
 @end example
 
-or the five last builds where project is ``guix'' and jobset ``master'':
+or the five last builds where jobset ``guix'':
 
 @example
-$ curl "http://localhost:8080/api/latestbuilds?nr=5&project=guix&jobset=master"
+$ curl "http://localhost:8080/api/latestbuilds?nr=5&jobset=guix"
 @end example
 
 If no builds matching given parameters are found, an empty JSON array is
-- 
cgit v1.2.3