a44f31b989
Read-only Pipelines screen for the Flutter client: - list_pipelines and list_runs with a last-run join, plus get_pipeline with an explicit version (0 = latest); no mutation requests. - Name, run-presence, last-run-status and schedule filters; six sort orders; clear filters; truthful loading, empty and error states. - Detail Summary, selectable Source and version history with selection and return to latest. - Sequenced list/detail requests so stale replies cannot replace a newer selection or open a cleared one; refresh keeps the selected pipeline and version. - Material controls on Android/desktop and Cupertino on iOS; a per-label segmented tab row at narrow widths and scaled text, with the native control kept wherever an equal share fits. - Fixture probe entry and Chrome scripts for the rendered evidence; widget tests cover filters, sorting, formatting, sequencing, layout and the tab row. Graph rendering remains P2: the Graph tab states that it is pending and exposes a host hook. PipelinesScreen is not yet registered in the shell. Evidence and limits: app/notes/P1.md.
106 lines
3.3 KiB
Dart
106 lines
3.3 KiB
Dart
/// Formatting shared by the pipeline list and detail.
|
|
///
|
|
/// The wording mirrors the web client (`src/pipelines.js`), which in turn
|
|
/// mirrors the Android app: one date shape, one duration shape, one status
|
|
/// vocabulary and one singular/plural rule.
|
|
library;
|
|
|
|
const _monthNames = <String>[
|
|
'Jan',
|
|
'Feb',
|
|
'Mar',
|
|
'Apr',
|
|
'May',
|
|
'Jun',
|
|
'Jul',
|
|
'Aug',
|
|
'Sep',
|
|
'Oct',
|
|
'Nov',
|
|
'Dec',
|
|
];
|
|
|
|
/// Parses an RFC3339 timestamp, or null when blank or unparseable.
|
|
DateTime? parseInstant(String? text) {
|
|
final trimmed = text?.trim() ?? '';
|
|
if (trimmed.isEmpty) return null;
|
|
return DateTime.tryParse(trimmed);
|
|
}
|
|
|
|
/// `d MMM HH:mm` in local time, e.g. `17 Oct 21:26`, or null when the
|
|
/// timestamp is unusable so callers omit the value instead of printing blank.
|
|
String? formatLocalTimestamp(String? text) {
|
|
final instant = parseInstant(text);
|
|
if (instant == null) return null;
|
|
final local = instant.toLocal();
|
|
final hour = local.hour.toString().padLeft(2, '0');
|
|
final minute = local.minute.toString().padLeft(2, '0');
|
|
return '${local.day} ${_monthNames[local.month - 1]} $hour:$minute';
|
|
}
|
|
|
|
/// `45s`, `2m 5s`, `1h 2m`. Negative values clamp to `0s`.
|
|
String formatDuration(int totalSeconds) {
|
|
final seconds = totalSeconds < 0 ? 0 : totalSeconds;
|
|
if (seconds < 60) return '${seconds}s';
|
|
if (seconds < 3600) return '${seconds ~/ 60}m ${seconds % 60}s';
|
|
return '${seconds ~/ 3600}h ${(seconds % 3600) ~/ 60}m';
|
|
}
|
|
|
|
/// Whole non-negative seconds between two timestamps, or null when either is
|
|
/// unusable or the end precedes the start.
|
|
int? durationSeconds(String? start, String? end) {
|
|
final from = parseInstant(start);
|
|
final to = parseInstant(end);
|
|
if (from == null || to == null) return null;
|
|
final seconds = to.difference(from).inSeconds;
|
|
return seconds >= 0 ? seconds : null;
|
|
}
|
|
|
|
/// `just now`, `Nm ago`, `Nh ago`, `Nd ago`; a future timestamp reads as
|
|
/// `just now`, never a negative age.
|
|
String? formatRanAgo(String? createdAt, DateTime now) {
|
|
final start = parseInstant(createdAt);
|
|
if (start == null) return null;
|
|
final seconds = now.difference(start).inSeconds;
|
|
if (seconds < 60) return 'just now';
|
|
if (seconds < 3600) return '${seconds ~/ 60}m ago';
|
|
if (seconds < 86400) return '${seconds ~/ 3600}h ago';
|
|
return '${seconds ~/ 86400}d ago';
|
|
}
|
|
|
|
/// `1 stage` / `n stages`.
|
|
String stageCountText(int count) => '$count ${count == 1 ? 'stage' : 'stages'}';
|
|
|
|
const _runStateAliases = <String, String>{
|
|
'running': 'running',
|
|
'queued': 'queued',
|
|
'waiting': 'waiting',
|
|
'active': 'active',
|
|
'succeeded': 'succeeded',
|
|
'success': 'succeeded',
|
|
'completed': 'succeeded',
|
|
'done': 'succeeded',
|
|
'failed': 'failed',
|
|
'error': 'failed',
|
|
'canceled': 'canceled',
|
|
'cancelled': 'canceled',
|
|
'interrupted': 'interrupted',
|
|
'blocked': 'blocked',
|
|
'skipped': 'skipped',
|
|
};
|
|
|
|
/// Maps a server status word to the shared run-state vocabulary. Unknown or
|
|
/// blank values become `unknown` rather than crashing a row.
|
|
String runStateOf(String? status) {
|
|
final key = (status ?? '').trim().toLowerCase();
|
|
return _runStateAliases[key] ?? 'unknown';
|
|
}
|
|
|
|
/// `Running`-style title for a run state.
|
|
String runStateLabel(String? status) {
|
|
final state = runStateOf(status);
|
|
return state.isEmpty
|
|
? state
|
|
: '${state[0].toUpperCase()}${state.substring(1)}';
|
|
}
|