1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
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
80
81
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
// file : mod/mod-ci-github-service-data.hxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#ifndef MOD_MOD_CI_GITHUB_SERVICE_DATA_HXX
#define MOD_MOD_CI_GITHUB_SERVICE_DATA_HXX
#include <libbrep/types.hxx>
#include <libbrep/utility.hxx>
#include <mod/mod-ci-github-gh.hxx>
namespace brep
{
// Service data associated with the tenant (corresponds to GH check suite).
//
// It is always a top-level JSON object and the first member is always the
// schema version.
// Unsynchronized state means we were unable to (conclusively) notify
// GitHub about the last state transition (e.g., due to a transient
// network error). The "conclusively" part means that the notification may
// or may not have gone through. Note: node_id can be absent for the same
// reason.
//
struct check_run
{
string build_id; // Full build id.
string name; // Potentially shortened build id.
optional<string> node_id; // GitHub id.
build_state state;
bool state_synced;
optional<result_status> status; // Only present if state is built.
string
state_string () const
{
string r (to_string (state));
if (!state_synced)
r += "(unsynchronized)";
return r;
}
};
// We have two kinds of service data that correspond to the following two
// typical scenarios (until/unless we add support for merge queues):
//
// 1. Branch push (via check_suite) plus zero or more local PRs (via
// pull_request) that share the same head commit id.
//
// 2. One or more remote PRs (via pull_request) that share the same head
// commit id (from a repository in another organization).
//
// Plus, for PRs, the service data may be in the pre-check phase while we
// are in the process of requesting the test merge commit and making sure it
// can be created and is not behind base. We do all this before we actually
// create the CI tenant.
//
// Note that the above two cases are typical but not the only possible
// scenarios. Specifically, it is possible to have a mixture of all three
// kinds (branch push, local PR, and remote PR) since the same head commit
// id can be present in both local and remote branches. There is no way to
// handle this case perfectly and we do the best we can (see
// build_unloaded_pre_check() for details).
//
struct service_data
{
// The data schema version. Note: must be first member in the object.
//
uint64_t version = 1;
// Kind and phase.
//
// @@ TODO Serialize these fields.
//
enum kind {local, remote /*, queue */} kind;
bool pre_check;
bool re_request; // Re-requested (rebuild).
// Check suite settings.
//
bool warning_success; // See gh_to_conclusion().
// Check suite-global data.
//
gh_installation_access_token installation_access;
uint64_t installation_id;
string repository_node_id; // GitHub-internal opaque repository id.
// The following two are only used for pull requests.
//
// @@ TODO/LATER: maybe put them in a struct?
//
optional<string> repository_clone_url;
optional<uint32_t> pr_number;
// The GitHub ID of the synthetic PR merge check run or absent if it
// hasn't been created yet.
//
// @@ TODO Remove once merge check run code has been removed.
//
optional<string> merge_node_id;
// The commit ID the branch push or pull request (and its check runs) are
// building. This will be the head commit for the branch push as well as
// local pull requests and the test merge commit for remote pull requests.
//
string check_sha;
// The commit ID the branch push or pull request (and its check runs) are
// reporting to. Note that in the case of a pull request this will be the
// head commit (`pull_request.head.sha`) as opposed to the test merge
// commit.
//
string report_sha;
vector<check_run> check_runs;
// The GitHub ID of the synthetic conclusion check run or absent if it
// hasn't been created yet. See also merge_node_id above.
//
optional<string> conclusion_node_id;
// Return the check run with the specified build ID or nullptr if not
// found.
//
check_run*
find_check_run (const string& build_id);
// Construct from JSON.
//
// Throw invalid_argument if the schema version is not supported.
//
explicit
service_data (const string& json);
// The check_suite constructor.
//
// Note that check_sha and report_sha are both the SHA of the
// check_suite's head commit.
//
service_data (bool warning_success,
string iat_token,
timestamp iat_expires_at,
uint64_t installation_id,
string repository_node_id,
enum kind kind,
bool pre_check,
bool re_request,
string head_sha);
// The pull_request constructor.
//
service_data (bool warning_success,
string iat_token,
timestamp iat_expires_at,
uint64_t installation_id,
string repository_node_id,
enum kind kind,
bool pre_check,
bool re_request,
string report_sha,
string repository_clone_url,
uint32_t pr_number);
service_data () = default;
// Serialize to JSON.
//
string
json () const;
};
ostream&
operator<< (ostream&, const check_run&);
}
#endif // MOD_MOD_CI_GITHUB_SERVICE_DATA_HXX
|
