Skip to main content

git_policy_cli/service/
mod.rs

1//! What:
2//!  The resident commit service:
3//!  protocol,
4//!  server,
5//!  client,
6//!  journal,
7//!  provisioning and logging.
8//! Why:
9//!  The service is a second program with its own life.
10//!
11//! In TS you'd write (pseudocode):
12//! ```ts
13//! // service/index.ts: one `export * from './file'` per module below.
14//! ```
15
16/// Messages between the wrapper and the resident commit service.
17pub mod service_protocol;
18
19/// The longest the wrapper waits for each thing it waits for, with the measurement beside each number.
20pub mod wait_ceilings;
21
22/// The connection of one waiting client, answered by the landing thread and kept alive by a beat from the reading thread.
23pub mod service_reply;
24
25/// The commit service's journal and its restart decisions.
26pub mod service_journal;
27
28/// Test-only fault points of the commit service.
29pub mod service_fault;
30
31/// The native journal protocol and the standard error fallback the service's entries go through.
32pub mod journald_native;
33
34/// The lines the commit service writes about its life and about the time each request took.
35pub mod service_timing;
36
37/// The line the commit service writes when a signal ends it.
38pub mod service_signal;
39
40/// The commit service's loop.
41pub mod service_server;
42
43/// The wrapper's side of a commit through the commit service.
44pub mod service_client;
45
46/// The wrapper's own provisioning of the commit service's socket activation.
47pub mod service_provision;
48
49/// A minimal D-Bus client for the user session bus, for the provisioning's two calls.
50pub mod systemd_dbus;
51
52/// Which commit service instance belongs to a worktree: its name, socket and unit instances.
53pub mod service_instance;
54
55/// One entry from the wrapper a person ran to the journal, sent without waiting.
56#[cfg(target_os = "linux")]
57pub mod client_journal;
58
59/// The service's handler for a review work item, bounded by a call deadline and a total budget.
60pub mod service_review;
61
62/// The standards-review credential: redacted when printed, read from the wrapper's environment, sent in the work message.
63pub mod service_review_key;