Hopp til innhold

Bygde repoets kontrollmotor med 268 kontroller

Bygde repoets kontrollmotor — 268 registrerte commit‑kontroller, 277 lint‑regler og 15 egne ESLint‑regler — pluss 146 tester av selve kontrollene, slik at det er bygget, ikke gjennomgangen, som holder standarden.

268 commit‑kontroller, og 146 tester av selve kontrollene

Situasjon. Standarder som er skrevet ned i en bidragsveiledning, er forslag. Alle er enige i dem, og så er det fredag, endringen er liten, og veiledningen taper. Kravet om null advarsler kom aldri til å holde med mindre noe annet enn velvilje holdt det oppe — og linterne som følger med hvert språk, stopper et godt stykke før de prosjektspesifikke reglene som faktisk betyr noe, de som handler om hvordan akkurat denne kodebasen er ment å fungere.

Oppgave. Reglene prosjektet brydde seg om, måtte være kjørbare, slik at et brudd på én av dem fikk en commit til å feile i stedet for å vente på en kodegjennomgåer med tid og hukommelse nok til å oppdage det.

Handling. Ut av dette vokste det frem en kontrollmotor. Det finnes 274 kontrollskript, 268 av dem registrert i commit‑hookene, sammen med 277 JavaScript‑lintere og 96 shell- og 17 Python‑validatorer som dekker det ferdigverktøy ikke har noen mening om — at en migrering kan rulles tilbake, at en oversettelsesnøkkel finnes i begge språkversjonene, at en registrert rute står i OpenAPI‑beskrivelsen, at ingen i det stille har lagt inn en inline‑undertrykkelse. Femten egne ESLint‑regler holder husets mønstre på plass i TypeScript. Én regel fortjener å nevnes for seg: enhver commit med prefikset fix: må ha med en test som feiler uten den, noe som gir en kjørbar sjekk for den regresjonen. Og fordi en ødelagt vakt er verre enn ingen vakt i det hele tatt — den slipper alt gjennom og ingen finner det ut — har vaktene 146 egne tester.

Resultat. De som gjennomgikk koden, kunne bruke mer tid på utformingen fordi automatiserte sjekker håndterte de formelle reglene som var kodet inn i dem, før en gren ble pushet. Avveiningen er reell og verdt å si høyt: det går tregt å committe, og en dårlig skrevet vakt er virkelig irriterende å jobbe seg rundt. De 146 testene finnes fordi nettopp det skjedde.

  • Utsiktstårn, snø, vinter
    Foto: schauhi / Pixabay
  • Veisving, autovern, kantstolper
    Foto: Monsterkoi / Pixabay

Bruk erfaringen i prosjektet deres

Bruk «Bygde repoets kontrollmotor med 268 kontroller» som utgangspunkt for en lignende utfordring i organisasjonen deres. Tjenestene bak arbeidet er tilgjengelige for prosjektet deres. Noen på din side av bordet når en leverandør, et budsjett eller en arkitekturbeslutning trenger en ny, kyndig vurdering.

Se tjenestene våre Ta kontakt

Se bak resultatet

Les om situasjonen, beslutningene og resultatet i eksemplet. Vi kan drøfte hva som passer deres rammer, og hva som krever en annen tilnærming. Bygde repoets kontrollmotor med 268 kontroller — 268 commit‑kontroller, og 146 tester av selve kontrollene

Se tjenestene våre Ta kontakt

Ett stykke av en lengre oversikt — og den ligger i sin helhet her.

Hver oppføring er skrevet på samme måte: situasjonen, oppgaven, hva vi gjorde, og hva som endret seg.

Se hele oversikten

Definer forbedringen dere trenger

Ta med beslutningen, menneskene som berøres og alternativene som er vurdert. Vi kan tydeliggjøre avveiningene og etterlate en dokumentert anbefaling.

Se hva det koster Ta kontakt

Vil du ha standardene dine håndhevet automatisk?

Spør om beslutningene bak «Bygde repoets kontrollmotor med 268 kontroller». Dere snakker med folk som kan forklare arbeidet og vurdere deres eget prosjekt.

Se tjenestene våre
welcome@engineer.company +45 50 10 61 84 København, Danmark
QR-kode for Bygde repoets kontrollmotor — 268 registrerte commit‑kontroller, 277 lint‑regler og 15 egne ESLint‑regler — pluss 146 tester av selve kontrollene, slik at det er bygget, ikke gjennomgangen, som holder standarden.
Ta med deg denne sidenhttps://advisory.engineer.company/nb/portfolio/built-a-268-check-guard-engine-for-the-repo/