🏆Eindproject: Laat ze samen draaien

Elke helft is apart bewezen, en de twee hebben nog nooit met elkaar gepraat. Deze les voert elf opdrachten van je client uit tegen je server, beginnend bij reading_server.sample_state() met de now-waarden die een test zou meegeven, en elke stap moet bij het contract passen:

Elke rij van “Not built yet” zit erin. Stap 6, 7 en 10 gaan via het oude pad, stap 5 hervalideert, stap 2 drukt een location af, en de statussen van de server bepalen elke exitcode.

Een doorverwijzing die je kunt zien

In stap 6, 7 en 10 volgt requests de 308 voor je, zoals hoofdstuk 10 liet zien: het stuurt dezelfde methode en body naar de nieuwe URL en geeft het laatste antwoord terug. Een doorverwijzing laat wel een spoor na. response.history is een lijst van de antwoorden die vóór het laatste kwamen, één per hop, de oudste eerst, en response.url is waar requests uitkwam. Voor stap 7 bevat history één 308 waarvan de url de /v0-URL is.

Het contract vraagt de client om dat te melden: één regel op standard error per gevolgde doorverwijzing, followed STATUS from URL, vóór elke andere regel. Standard output blijft voor resultaten, dus een script dat de boekenlijst leest, ziet de regel nooit. Schrijf report_redirects(response), een lus van twee regels over response.history die van elk item de status_code en url afdrukt met file=sys.stderr. Roep die dan in run aan voor elke opdracht die een antwoord kreeg: direct na call voor list, add, update en delete, en voor show als cached_show een antwoord teruggaf, op beide plekken vóór de foutcontrole.

Kijk hoe het draait

pl_http.py start je server op een poort die het systeem kiest en voert de elf opdrachten uit met jouw main, de now-waarden hierboven en een cachebestand in een tijdelijke map. De URL’s luiden http://books.test, omdat dat requests naar je server stuurt zonder een naam op te zoeken.

python pl_http.py capstone

Voor elke opdracht drukt het de verzoeken af die je server ontving, dan de opdrachtregel, de exitstatus en wat je client op elke stream afdrukte. Stap 4 en 5 zien er zo uit:

--- requests and replies ---
--- your reading_client.py show 3 --base-url http://books.test  (now 30) ---
exit status: 0
standard output: ['3: Piranesi by Susanna Clarke']
standard error: []
--- requests and replies ---
request 1  GET /books/3  (If-None-Match: "6a584f0c2da517c8750cdd3157f9d6f9cc07bbd19955c92a953fcc8cb494f8a9")  ->  304 Not Modified  (connection 1)

Het eerste blok heeft helemaal geen verzoek: het item dat bij stap 3 was opgeslagen, was vers. Stap 6 gaat via het oude pad met een token dat alleen mag lezen:

request 1  PUT /v0/books/3  ->  308 Permanent Redirect  (connection 1)
request 2  PUT /books/3  ->  403 Forbidden  (connection 1)
--- your reading_client.py update 3 --base-url http://books.test/v0 --token tok-ben-reads-K9pz --title "Piranesi (paperback)" --author "Susanna Clarke"  (now 60) ---
exit status: 2
standard output: []
standard error: ['followed 308 from http://books.test/v0/books/3', '403 this token may read the list but not change it']

Twee verzoeken bereikten je server voor één opdracht. Het tweede kreeg een 403, geen 401, dus requests stuurde het token na de doorverwijzing opnieuw mee: het houdt authorization als de nieuwe URL op dezelfde host staat. De lijst voor standard error begint met je followed-regel en eindigt met de ene foutregel. Bij elk verzoek staat connection 1: requests hield één verbinding open over alle elf opdrachten, zoals hoofdstuk 9 je server leerde toestaan. Aan het eind opent pl_http twee lege verbindingen, zodat serve() zijn telling van drie bereikt en terugkeert.

Vers is niet hetzelfde als actueel

Stap 8 is degene die er verkeerd uitziet:

--- your reading_client.py show 3 --base-url http://books.test  (now 90) ---
exit status: 0
standard output: ['3: Piranesi by Susanna Clarke']

Bij stap 7 werd de titel Piranesi (paperback), en je server weet dat. Je client drukte toch de oude titel af, en stuurde niets. Terecht. Bij stap 5 zei de 304 van de server max-age=60: je mag deze kopie 60 seconden hergebruiken zonder te vragen. Die belofte liep tot 120, en de wijziging bij stap 7 kan een kopie waar de client nooit naar vraagt niet bereiken. Stap 9, op 120, is het moment dat de belofte afloopt: de client stuurt de oude tag, de tag komt niet meer overeen, en de 200 brengt de nieuwe titel. max-age ruilt actualiteit in voor bespaarde verzoeken, en de server kiest die ruil.

Wat er bewezen wordt, en hoe

Check my work leest die run niet. Hij herhaalt elke controle van les 1 en 2 en voert dan elf opdrachten uit in het geheugen: een echte requests.Session waarvan de enige adapter de bytes van elk verzoek in hetzelfde proces aan de handlerklasse van je server geeft, zodat requests de 308’s volgt en de 304 leest zoals het over een netwerk zou doen. De boeken, titels, tokens en basis-URL zijn nieuw, MAX_AGE is 45, en elke exitstatus, uitvoerregel, followed-regel en elk aantal verzoeken moet kloppen, met TIMEOUT bij elke hop.

Je opdracht

1. Schrijf report_redirects.

2. Roep die in run aan voor elke opdracht, vóór de foutcontrole.

3. Voer python -m pytest -q en python pl_http.py capstone uit.

4. Klik op Check my work.

De twee helften zijn het nu eens over elke opdracht van het contract. De volgende les schrijft de tests die zouden merken als een van beide daarmee ophield.