implement fix for color mode default
ci/woodpecker/push/build Pipeline was successful

This commit is contained in:
juergen committed 2026-10-20 15:59:53 +02:00
1 parent b22e82a8c2
commit 509af2a410
5 files changed
+238 -35

No files matched your search

@@ -5,7 +5,7 @@ Aufteilung: 1. Ursache feststellen (blockierend), 2. Testschicht, 3. Spec/README
## 1. Ursache feststellen (Verifikation des Ist-Zustands)
- [ ] 1.1 Jobpfad reproduzieren: Image bauen, Testcontainer mit
- [x] 1.1 Jobpfad reproduzieren: Image bauen, Testcontainer mit
`PRINTER_OPTIONS="BRColorMode=None TonerSaveMode=True"` starten, einen Job
einreichen (`podman exec <c> lp -d <queue> -o raw <sample>` oder
`cupsfilter <sample>`), und im versandten PostScript
@@ -14,19 +14,19 @@ Aufteilung: 1. Ursache feststellen (blockierend), 2. Testschicht, 3. Spec/README
(`statusdict/tonersave` … `true`) enthalten ist.
Verifikation: Ergebnis (enthalten/nicht enthalten) mit dem ausgelesenen
Spool-Pfad und der CUPS-Version in design.md notieren.
- [ ] 1.2 Zweiten Messpunkt gegen die Queue-Defaults aufnehmen: denselben Job
- [x] 1.2 Zweiten Messpunkt gegen die Queue-Defaults aufnehmen: denselben Job
zusätzlich mit explizitem `-o BRColorMode=Vivid` einreichen und die
`UseCIEColor`-Zeile im Spool mit der des ersten Jobs vergleichen.
Verifikation: dokumentierter Unterschied (oder dessen Fehlen) zeigt, ob
per-Job-Optionen im selben Pfad sichtbar werden — belegt, dass die
Messmethode aus 1.1 trägt.
- [ ] 1.3 Queue-Zustand desselben Containers gegengelesen:
- [x] 1.3 Queue-Zustand desselben Containers gegengelesen:
`lpoptions -p <queue> -l` (Sternchen) und
`grep '^Default' /etc/cups/ppd/<queue>.ppd`.
Verifikation: die Abweichung aus dem Ausgangsbefund ist entweder
bestätigt (`*False` bei `DefaultTonerSaveMode True`) oder widerlegt;
Ergebnis in design.md festhalten.
- [ ] 1.4 Ergebnis einordnen und die Entscheidung nach Design D3 treffen:
- [x] 1.4 Ergebnis einordnen und die Entscheidung nach Design D3 treffen:
erreicht der Queue-Default den Job (Szenario in specs/… bleibt) oder nicht
(design.md um das Resultat ergänzen, Szenario auf das verifizierte
Verhalten umformulieren, Limitation explizit benennen).
@@ -36,14 +36,14 @@ Aufteilung: 1. Ursache feststellen (blockierend), 2. Testschicht, 3. Spec/README
## 2. Automatisierter Nachweis (neue Testschicht)
- [ ] 2.1 `tests/test-queue-defaults.sh` anlegen: baut das Image, startet einen
- [x] 2.1 `tests/test-queue-defaults.sh` anlegen: baut das Image, startet einen
Container mit `PRINTER_OPTIONS="BRColorMode=Vivid TonerSaveMode=False"`,
wartet auf `ready: CUPS on 631/tcp`, reicht einen Job ohne
`print-quality`/Preset-Attribute ein und liest das letzte Spool-File
(`lpstat -W completed -o` → `/var/spool/cups/d<JobId>-*`).
Verifikation: Skript läuft lokal durch (`bash tests/test-queue-defaults.sh`),
Ausgabe zeigt den Spool-Pfad und die gefundenen PostScript-Zeilen.
- [ ] 2.2 Assertions gemäß Ergebnis aus 1.4 einbauen: `UseCIEColor true` für den
- [x] 2.2 Assertions gemäß Ergebnis aus 1.4 einbauen: `UseCIEColor true` für den
Queue-Default `Vivid` und der Tonerspar-Zustand aus dem verifizierten
Verhalten für `TonerSaveMode=False`; zusätzlich muss die
`UseCIEColor`-Zeile bei explizitem `-o BRColorMode=None` abweichen
@@ -52,7 +52,7 @@ Aufteilung: 1. Ursache feststellen (blockierend), 2. Testschicht, 3. Spec/README
Verifikation: Skript endet mit Exit 0 und einer PASS-Zeile pro Assertion;
eine absichtlich falsch gesetzte Erwartung lässt es mit Exit ≠ 0 und
Klartextzeile scheitern.
- [ ] 2.3 Lebensdauer/Umgebung absichern: Container immer aufräumen (Trap),
- [x] 2.3 Lebensdauer/Umgebung absichern: Container immer aufräumen (Trap),
kurze Wiederholung des Spool-Lesens statt Polling, und im Skriptkopf die
verifizierte CUPS-Version notieren.
Verifikation: `podman ps -a` zeigt nach einem Lauf keinen Testcontainer;
@@ -60,13 +60,13 @@ Aufteilung: 1. Ursache feststellen (blockierend), 2. Testschicht, 3. Spec/README
## 3. Spec und README angleichen
- [ ] 3.1 `README.md`, Abschnitt *Environment variables* / `PRINTER_OPTIONS`:
- [x] 3.1 `README.md`, Abschnitt *Environment variables* / `PRINTER_OPTIONS`:
eine Zeile ergänzen, was ein Queue-Default für den Ausdruck bedeutet
(Queue-Default schlägt den PPD-Default, sichtbar im versandten
PostScript), mit Verweis auf das Testskript.
Verifikation: `grep -n 'PRINTER_OPTIONS' README.md` zeigt den neuen Satz;
die genannte Assertion stimmt mit 2.2 überein.
- [ ] 3.2 `entrypoint.sh`-Hinweis prüfen: der bestehende Kommentar bei
- [x] 3.2 `entrypoint.sh`-Hinweis prüfen: der bestehende Kommentar bei
`apply_printer_options` (Zeile ~341–345) behauptet, `lpadmin` würde
unbekannte Zuweisungen speichern — mit dem Befund aus 1.x abgleichen und
nur bei Bedarf präzisieren.