Programma Les 145 van 148 · Tien deuren en de veldkit
Tien deuren en de veldkit

Deur 2: een grootboek dat zijn gebruikers overleeft

Waarom dit ertoe doetEchte datamodellen falen op twee manieren: de volgende wijzigingsaanvraag past niet, of een aanroeper gebruikt de API verkeerd en de data breekt stilletjes. Deze deur test beide.

Een klein bedrijf wil een intern grootboek: rekeningen voor teams, geld dat tussen hen wordt verplaatst, en stortingen van buitenaf. Je krijgt de eerste specificatie, twee wijzigingsverzoeken die al zijn overeengekomen, en het misbruikscript dat het testteam erop zal draaien. Alles staat hieronder en in de oefening.

Wijzigingsverzoeken

  • CR1: finance heeft het saldo van elk account op elk willekeurig moment in het verleden nodig.
  • CR2: teams worden hernoemd. Een hernoemde account behoudt zijn id, balance en history; zijn oude naam wordt vrij.

Het misbruik script

Elk van deze moet ValueError oproepen en niets veranderen: een bedrag dat geen positief geheel getal van centen is (0, -5, 2.5, 2.0, True, "10"); een onbekend account; verzenden naar hetzelfde account; een overboeking die de verzender onder de 0 zou brengen; een transfer id die al gebruikt is met andere details; een account openen met een naam die al in gebruik is. Callers proberen het ook opnieuw bij timeouts: dezelfde transfer id met dezelfde details opnieuw moet niets doen, geruisloos. Een retry komt later aan dan de eerste poging, dus de tijd kan verschillen: de details die moeten overeenkomen zijn de twee accounts en het bedrag.

Jij bent aan de beurt

Schrijf zes functies over een ledger die je ontwerpt (platte data of een object):

  • new_ledger(): een leeg grootboek.
  • open_account(ledger, name): geeft een nieuwe account id terug (elke waarde die je wilt). Nieuwe accounts beginnen bij 0.
  • rename(ledger, account_id, new_name): CR2.
  • find(ledger, name): de id van het account dat nu name, of ValueError.
  • wordt genoemd.
  • transfer(ledger, transfer_id, from_id, to_id, cents, t): verplaatst cents op tijdstip t; from_id None betekent een storting van buitenaf. Tijden gaan nooit omlaag.
  • balance(ledger, account_id, t=None): de balans van overboekingen met tijd <= t, of alle overboekingen als t is None (CR1).
Elke situatie in het misuse script roept ValueError op en verandert niets. Een retry (dezelfde transfer id, dezelfde accounts en amount, een later tijdstip) doet niets en roept niets op.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.