Programma Lezione 145 di 148 · Dieci porte e il kit da campo
Dieci porte e il kit da campo

Porta 2: un registro che sopravvive ai suoi utenti

Perché è importante I modelli dati veri falliscono in due modi: la prossima richiesta di modifica non ci sta, o un chiamante usa male l'API e i dati si rompono in silenzio. Questa porta li mette alla prova entrambi.

Una piccola azienda vuole un registro interno: conti per i team, denaro spostato tra loro, e depositi dall'esterno. Ricevi la prima specifica, due richieste di modifica già concordate, e lo script di uso sbagliato che il team di test eseguirà contro di esso. È tutto qui sotto e nell'esercizio.

Richieste di modifica

  • CR1: la finanza ha bisogno del saldo di qualsiasi conto in qualsiasi momento passato.
  • CR2: i team vengono rinominati. Un conto rinominato tiene id, saldo e cronologia; il suo vecchio nome torna libero.

Lo script di uso sbagliato

Ognuno di questi deve sollevare ValueError e non cambiare niente: un importo che non è un numero intero positivo di centesimi (0, -5, 2.5, 2.0, True, "10"); un conto sconosciuto; inviare allo stesso conto; un trasferimento che porterebbe il mittente sotto 0; un id di trasferimento già usato con dettagli diversi; aprire un conto con un nome già in uso. I chiamanti riprovano anche dopo un timeout: lo stesso id di trasferimento con gli stessi dettagli di nuovo non deve fare niente, in silenzio. Un nuovo tentativo arriva più tardi del primo, quindi il suo tempo può essere diverso: i dettagli che devono coincidere sono i due conti e l'importo.

Tocca a te

Scrivi sei funzioni su un registro che progetti tu (dati semplici o un oggetto):

  • new_ledger(): un registro vuoto.
  • open_account(ledger, name): restituisce un nuovo id di conto (qualsiasi valore tu voglia). I nuovi conti partono da 0.
  • rename(ledger, account_id, new_name): CR2.
  • find(ledger, name): l'id del conto che ora si chiama name, o ValueError.
  • transfer(ledger, transfer_id, from_id, to_id, cents, t): sposta cents al tempo t; from_id None significa un deposito dall'esterno. I tempi non scendono mai.
  • balance(ledger, account_id, t=None): il saldo contando i trasferimenti con tempo <= t, o tutti se t è None (CR1).
Ogni caso dello script di uso sbagliato solleva ValueError e non cambia niente. Un nuovo tentativo (stesso id di trasferimento, stessi conti e importo, qualsiasi tempo successivo) non fa niente e non solleva niente.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.