# IDEA.md – en egen HTTP-klient för skrivbordet Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga en egen implementation. Den bygger på det som lärdes när Requester byggdes, en app för Windows och macOS skriven i Rust med Claude Code. ## 1. Vad som ska byggas En HTTP-klient för att skicka requests till API:er och granska svaren, i samma anda som Postman, Insomnia och Bruno – ett program för Windows och macOS, utan konto, med samlingarna som vanliga filer. Appen ska kunna: - **skriva ihop en request**: metod (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS och egna verb), URL, tabeller för params och headers med en kryssruta per rad, och body som none, raw (JSON/XML/HTML/text), form-urlencoded eller multipart (text och filer). URL-fältet och params-tabellen synkas åt båda hållen. - **skicka och avbryta**: Ctrl/Cmd+Enter, Enter i URL-fältet eller knappen; under sändning Cancel, snurra och tid. - **visa svaret** med status i färg (2xx/3xx/4xx/5xx), tid och storlek, och flikar för body (pretty med färg och raw, sök, kopiera, spara till fil, bildförhandsvisning, binärt som typ och storlek), headers som tabell och cookies tolkade ur `Set-Cookie`. - **samlingar på disk**: en samling är en katalog, en mapp en underkatalog och en request en JSON-fil. Träd i sidopanelen med skapa, byt namn, duplicera, flytta (dra) och ta bort, flikar för öppna requests med markering för osparat. - **miljöer och variabler**: `{{namn}}` i URL, params, headers, body och auth; samlingsvariabler, miljöer och miljösamlingar som kan kopplas till en samling eller mapp; hemliga variabler som visas maskerade; den upplösta URL:en under URL-fältet. - **auth**: None, Basic, Bearer, API-nyckel (header eller query), OAuth2 client credentials och Inherit från mapp eller samling. - **importera OpenAPI** 3.0 och 3.1 (JSON och YAML, fil eller URL) till en samling. - **cURL** åt båda hållen, **historik**, **inställningar per request** (timeout, redirects, TLS-verifiering), två layouter (svaret under eller till höger) och **export/import av allt** i en JSON-fil. **Ingår inte**: skript före och efter requests, testpåståenden, GraphQL, WebSocket, gRPC, molnsynk och konton, Swagger 2.0, externa `$ref` och andra OAuth2-flöden än client credentials. ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **Rust**, en workspace med en kärna utan gränssnitt (`core`: modell, HTTP, lagring, variabler, auth, OpenAPI, cURL, historik) och appen (eframe/egui). Logiken ska gå att testa utan fönster. - **reqwest med rustls**, inte native-tls: samma TLS-beteende på båda plattformarna. Verifiera certifikat mot systemets lager (`rustls-platform-verifier`), så att företags-CA:er fungerar. - **Kryptot är `ring`, inte `aws-lc`.** aws-lc kompilerar C som kräver Windows SDK:ns headers. ring har också C – kontrollera Windows med `cargo xwin check`, inte `cargo check --target`. - **Viktigt: nätverket på en egen tokio-runtime, aldrig i gränssnittstråden.** `send` ger ett väntande svar som gränssnittet frågar varje bildruta, och nätverkstråden väcker gränssnittet när svaret kommit. Avbryt = avbryt uppgiften. - reqwest bestämmer redirects och TLS-verifiering per klient: håll en klient per kombination av inställningar. - Inställningar, sessionen (öppna flikar), fönsterstorlekar, historik och hemliga värden i användarens konfigurationskatalog – aldrig i samlingen. ## 3. Beslut som visade sig avgörande **Filformatet.** En samling är en katalog med `collection.json` (namn, auth, variabler), varje mapp en underkatalog med `folder.json`, varje request en JSON-fil. Filnamnen härleds ur namnet (`List users` → `list-users.json`, åäö kvar, krockar får `-2`), men visningsnamnet ligger i filen så att `/` och `?` fungerar. Mappar först, sedan requests, i bokstavsordning. Skriv atomiskt (temporär fil + namnbyte). En trasig fil visas som fel i trädet och resten laddas. Radering går till papperskorgen. **Hemligheter stannar på datorn.** Hemliga variabler skrivs aldrig i samlingens filer. De sparas lokalt med samlingens (eller miljösamlingens) sökväg som nyckel, så att samlingen kan checkas in. **Variabler i tre lager.** Samlingens variabler, sedan den kopplade miljösamlingens gemensamma, sedan den valda miljön – en senare vinner. En variabel kan referera till en annan, i upp till 10 nivåer. Kända variabler är gröna, okända röda, och en okänd skickas som den står så att servern visar vad som saknades. **Miljösamlingar.** En fil `.environments.json` med gemensamma variabler och flera miljöer. Den kan ligga var som helst och kopplas till en samling eller en mapp med en relativ sökväg i `collection.json`/`folder.json`. Närmaste koppling uppåt gäller. **Varje request skickas för sig.** Ingen cookie-burk och ingen token-cache mellan requests: en tidigare request ska aldrig påverka nästa. Den enda cookie som skickas är en `Cookie`-header i requesten, och OAuth2 hämtar en ny token vid varje sändning. Anslutningar (keep-alive, TLS-sessioner) får återanvändas – de ändrar inte vad som skickas. **Det som står är det som skickas.** Synka URL och params utan att avkoda. Avstängda rader ligger bara i tabellen och överlever att URL:en redigeras. En egen `Content-Type` vinner över den automatiska. Alla fyra body-lägen sparas samtidigt, så att ett byte av läge inte tömmer något. **OpenAPI som ett generiskt JSON-träd.** Läs 3.0 och 3.1 utan typade modeller och följ `$ref` inom dokumentet. En mapp per tagg, en request per operation (summary, operationId eller "METHOD /path"). `servers[0]` blir `baseUrl` i en miljö – och **en relativ server räknas ut mot URL:en definitionen hämtades från**. Parametrar får exempel, default eller första enum; obligatoriska påslagna, valfria avslagna. Body ur exempel eller genererad ur schemat (allOf slås ihop, oneOf/anyOf tar första, readOnly hoppas över, stoppa rekursion efter några nivåer). Security schemes blir auth, och platshållarna (`{{bearerToken}}`, `{{apiKey}}` …) blir hemliga variabler. Det som inte går att importera listas i resultatdialogen. **cURL.** Copy as cURL ger requesten *som den skickas* (variabler och ärvd auth upplösta), citerad för skal. Ett cURL-kommando som klistras in i URL-fältet blir en request. Okända flaggor ger ett fel i stället för en tyst felaktig request. **Sessionen överlever en omstart.** Spara de öppna flikarna med osparade ändringar i en egen fil, atomiskt och högst var 500 ms. En flik vars fil försvunnit blir osparad men behåller innehållet. **Utvecklarkrokar från dag ett**: `_CONFIG_DIR` (egen inställningskatalog), `_SCREENSHOT=fil.png` från det riktiga fönstret, `_WINDOW`, och `_DEBUG_STATE` som ställer in ett läge vid start (metod, URL, body, flik, samling, öppna en request, välj miljö, skicka, öppna en dialog). Delar skilda med `;`, eftersom URL:er och JSON innehåller kommatecken. ## 4. Fallgropar - **I egui vinner den widget som registreras sist.** En flikram som registrerar sitt klick efter innehållet tar klicket från ×. En dragyta ovanpå en knapp sväljer högerklicket – gör knappen själv dragbar. - **Ge tabellrader fasta id:n**, annars tappar skrivmarkören fokus när den tomma raden längst ned blir en riktig rad. - **En panel sparar den höjd innehållet tog.** En tom flik krymper panelen till en remsa. Låt innehållet fylla panelens höjd oavsett flik. - **Glöm inte eframe:s funktion `links`.** Med `default-features = false` gör `ctx.open_url` ingenting. - **Rita tecken som inte finns i egui:s typsnitt** (●, pilar) i stället för att skriva dem – annars blir de tomma rutor. - **På macOS tar systemmenyn ⌘-tangenterna före egui.** Lägg ingen Edit-meny med systemets Cut/Copy/Paste, och gör inga menygenvägar utan modifierare. - **En skärmbild kommer inte om skärmen sover** – fönstret presenteras aldrig. Ge upp efter en tidsgräns, och ha en rendering utan skärm (`egui_kittest` med wgpu) som reserv. Be om bilden igen var 20:e bildruta tills den kommer. - **Låt aldrig testerna röra användarens inställningar** eller papperskorg – egen konfigurationskatalog och permanent radering i testerna. - **Bygg inte i en `target/` på en Windows-disk från WSL**, och skriv skärmbilder från Windows-binären till en katalog Windows når. ## 5. Krav och mätningar - GitHubs REST-definition (10 MB YAML, 1 242 operationer) ska tolkas på runt 185 ms och skrivas som samling på runt 145 ms. - Ett formaterat JSON-svar på några MB ska inte ta sekunder – optimera beroendena även i debug-bygget. - Requester har drygt hundra tester: kärnan, HTTP mot en lokal server och gränssnittet utan fönster. - Windows-binären runt 15–16 MB, installeraren runt 7 MB. ## 6. Så verifieras det - `cargo clippy --workspace --all-targets` utan varningar, `cargo test --workspace`, och för Windows `cargo xwin clippy --target x86_64-pc-windows-msvc`. - **HTTP-tester mot en egen server på 127.0.0.1** som ekar exakt vad den fått: query och headers som de skrevs, dubbla headers, avstängda rader, egen Content-Type, urlencoding, multipart med filinnehåll, egna metoder, redirects, timeout, Cancel mot en server som aldrig svarar, att andra requesten inte bär några cookies och att OAuth2 hämtar en ny token varje gång. - **UI-tester utan fönster** (`egui_kittest`) med riktiga klick, högerklick, tangenter och drag: spara, byt namn i trädet, dra till mapp, osparade ändringar efter omstart, OpenAPI-import, miljösamlingar. - **Riktiga dokument**, inte bara testernas: Swaggers Petstore och GitHubs REST-definition. - **Skärmbilder** av varje ny vy. ## 7. Arbetssätt - **Research först**: Postman, Insomnia, Bruno, Hoppscotch – vad de gör, hur de lagrar samlingar och vad användare klagar på. Markera vad som är kontrollerat mot en källa och vad som är bedömning. - **Ett ärende i taget**, med tolkningen före bygget och mätningen i den avslutande kommentaren. - **Provkör tidigt.** De flesta förbättringarna kom när appen användes på riktigt: klickytor, markerade förifyllda namn, marginaler i fälten, sessionen. ## 8. Prompten > Bygg en HTTP-klient för [Windows och macOS] i [Rust med eframe/egui och reqwest] för att skicka requests till API:er och granska svaren, som Postman eller Insomnia men utan konto. Samlingar ska sparas som vanliga filer – en katalog per samling och en JSON-fil per request – med miljöer och variabler, auth, OpenAPI-import och cURL åt båda hållen. > > Läs hela IDEA.md nedan först. Den beskriver funktionerna, arkitekturen, de beslut som visade sig avgörande och fallgroparna att undvika. > > Arbeta så här: > 1. Gör research på liknande program och skriv en plan uppdelad i ärenden. Fråga mig om det som är mina beslut. > 2. Kör nätverket på en egen runtime, aldrig i gränssnittstråden. > 3. Testa HTTP mot en egen lokal server och gränssnittet utan fönster. > 4. Granska varje ny vy med en skärmbild. > 5. Låt aldrig hemliga värden hamna i samlingens filer. > > [klistra in IDEA.md här]