# IDEA.md – en namnbytare för många filer, på Windows och macOS 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å erfarenheterna från File Renamer, ett skrivbordsprogram för Windows och macOS byggt i Rust med Claude Code. ## 1. Vad som ska byggas Ett skrivbordsprogram som **byter namn på många filer på en gång** enligt regler, med förhandsgranskning innan något händer och möjlighet att ångra efteråt. Förebilden är Bulk Rename Utility (BRU), som bara finns för Windows. Målet är samma verktyg på Windows och macOS – samma regler, samma regelfiler, samma säkerhet – och det ska gå att kompilera för Linux. Programmet ska ha: - **Ett sökvägsfält och ett mappträd** (enheter och volymer, hemkatalogen; undermappar läses in först när de fälls ut). Det ska gå att dra in en mapp i fönstret. - **En fillista** med kolumnerna Name, New Name, Size, Modified och Status. Ändrade namn markeras, konflikter visas i rött med orsaken. Sortering på varje kolumn, **naturlig sortering** på namn (`rapport2` före `rapport10`). - **Ett enkelt filter**: mask med jokertecken (`*.jpg;*.png`), skiftläge, filer, mappar, dolda, undermappar. - **Elva paneler** under listan, var och en med en av/på-ruta och en återställningsknapp (R). De körs i nummerordning på varje markerad fil: | # | Panel | Gör | |---|---|---| | 1 | RegEx | Reguljärt uttryck med `\1` (även `$1`, `${namn}`). *Simple*: jokertecken `*`/`?` som fångar. *Inc. Ext.* tar med ändelsen | | 2 | Name | Keep / Remove / Fixed / Reverse | | 3 | Replace | Bokstavlig sök och ersätt, *Match Case*, *First* (bara första träffen) | | 4 | Case | Same / lower / UPPER / Title / Sentence, med undantagsord (`PDF:iPhone`) | | 5 | Remove | Första n, sista n, från–till, tecken, ord, beskärning före/efter, siffror, bokstäver, symboler, accenter, högt ASCII, trim, dubbla mellanslag, inledande punkter | | 6 | Move/Copy Parts | Flytta eller kopiera de första/sista n tecknen till början, slutet eller en position, med avgränsare | | 7 | Add | Prefix, infoga på position (negativ räknas från slutet), suffix, *Word Space* (mellanslag före versaler) | | 8 | Auto Date | Skapad, ändrad, öppnad, nu eller EXIF *Picture taken*; prefix eller suffix; fasta format (DMY, MDY, YMD …) eller eget strftime-format; avgränsare inom datumet och mot namnet; fyrsiffrigt år; tidsförskjutning i timmar | | 9 | Append Folder Name | Mappnamnet, en eller flera nivåer, som prefix eller suffix, med avgränsare | | 10 | Numbering | Prefix / suffix / båda / infoga; start, steg, utfyllnad, avgränsare; *Break* (börja om när de n första tecknen byts); per mapp; bas 10, 2, 8, 16, 36, bokstäver (A … Z, AA …), romerska siffror | | 11 | Extension | Same / lower / UPPER / Title / New / Extra / Remove | - **Förhandsgranskning** som räknas om medan man skriver. - **Rename**, **Reset** och **Revert** (ångra senaste omgången, även efter omstart), med en bekräftelsedialog före bytet. - **Regelfiler**: alla panelerna och filtret sparas som en `.renamer`-fil i TOML. Filnamnet syns i titelraden. De senaste inställningarna återställs vid start. - **Statusrad** med antal objekt, markerade, att byta och konflikter. Ingår **inte**: BRU:s panel 12–14 (avancerade filter, kopiera/flytta till annan plats, attribut, tidsstämplar, JavaScript), import av BRU:s `.bru`-filer, ljust tema. ## 2. Stack och arkitektur Det som är **viktigt** är markerat; resten går att byta. - **Rust** (edition 2024), en Cargo-workspace med två crates. - **Viktigt: en UI-fri kärna** (`core`) med reglerna, kontrollen, bytet, skanningen, regelfilerna och den naturliga sorteringen. Allt testas utan fönster. En fil per panel under `rules/`. `Rules` är inställningarna (serde), `Compiled` kör dem i nummerordning. - **Stegen ser namnet utan ändelse.** Bara RegEx med *Inc. Ext.* och Extension rör ändelsen. - **eframe/egui** (0.36) med wgpu för fönstret. Går att byta. - **Förhandsgranskningen räknas bara om när reglerna eller en generationsräknare ändras.** Räkna upp generationen när listan eller markeringen ändras, annars visar listan gamla namn. - **Menyn som data**, egui i fönstret på Windows och systemets menyrad på macOS (`muda`), med tangentgenvägar från en enda källa. Meny och tangentbord ger samma `Action`. - `regex`, `chrono` för datum, en EXIF-läsare för *Picture taken*, `serde` + `toml` för regelfilerna. - **Data per användare**: inställningarna och loggen (`journal.json`) i användarens datakatalog. - Paketering: Windows korskompilerat med `cargo xwin` från Linux/WSL, NSIS-installerare och portabel zip; macOS `aarch64-apple-darwin`, `.app` och dmg. ## 3. Beslut som visade sig avgörande **Positioner räknas i tecken, aldrig i byte.** "Ta bort de tre första" ska ta `Års` av `Årsmöte`. I UTF-8 tar å två byte. Samla all positionsräkning i en hjälpmodul (`text.rs`) och använd den i varje panel. **Inget byte körs om någon markerad rad har ett fel.** Ett halvt genomfört byte, där hälften av filerna fått nya namn, är svårare att reda ut än inget alls. Kontrollera alla rader mot varandra och mot filsystemet före bytet: - dubbletter bland de nya namnen - namn som redan finns på disk (och inte är en av filerna som själv byter namn) - tomt namn - ogiltiga namn på Windows: `<>:"/\|?*`, kontrolltecken, reserverade namn `CON`, `PRN`, `AUX`, `NUL`, `COM1`–`COM9`, `LPT1`–`LPT9` (även med ändelse), avslutande punkt eller mellanslag, inledande mellanslag (tillåtet men nästan alltid en rest av en borttagen del), `.` och `..`, och över 255 – räknat både i UTF-16-enheter (NTFS) och i byte i UTF-8 (APFS) **Jämför namn utan hänsyn till skiftläge.** NTFS och APFS skiljer normalt inte på `Bild.jpg` och `bild.jpg`. På ett skiftlägeskänsligt filsystem blir kontrollen strängare än den behöver, men aldrig för slapp. **Windows regler för namn gäller på alla plattformar.** En fil med kolon i namnet går att skapa på en Mac, men inte att kopiera till en Windows-disk eller ett USB-minne. **Bytet i två steg.** Varje fil får först ett tillfälligt namn och sedan sitt nya. Det är vad som gör att `a`→`b` och `b`→`a` i samma omgång fungerar, och att `bild.jpg`→`Bild.jpg` fungerar på ett filsystem som inte skiljer på skiftläge – där säger systemet annars att målet redan finns, eftersom det är filen själv. **Djupast först.** Med undermappar kan både en mapp och filer i den byta namn. Ta filerna först, medan sökvägen till dem stämmer, och mappen sist. Dela bytena i grupper per mapp; varje grupp gör sina två steg. **Allt eller inget.** Misslyckas ett byte rullas de redan gjorda tillbaka i omvänd ordning, även tidigare gruppers, och felet rapporteras med filens namn. **Loggen och Revert.** Spara varje genomförd omgång i `journal.json`. Revert byter tillbaka i omvänd ordning (mapparna, som bytte sist, byts tillbaka först), även efter en omstart – men först efter en kontroll av att varje fil finns kvar under sitt nya namn och att inget annat tagit dess gamla. Annars vägrar Revert och säger vilka rader som inte stämmer. **Numreringen följer listans ordning** bland de markerade filerna, och listan sorterar naturligt. Då blir numren de man ser. **Regelfiler som går att läsa.** TOML med `#[serde(default)]` på varje panel, så att fält som saknas får sitt standardvärde och äldre filer går att öppna. **Utvecklarhjälp från dag ett**, så att en agent kan granska gränssnittet utan att någon sitter vid skärmen: - `_WINDOW=1440x900@10,30` – storlek och position - `_SCREENSHOT=fil.ppm`, `_SCREENSHOT_DELAY=N` – spara en bild av fönstret och avsluta - `_DATA_DIR=katalog` – inställningar och logg åt sidan - `_DEBUG_MENU=File` – fäll upp en meny i fönstret - `_DEBUG_STATE=…` – steg i ordning: `folder=väg`, `rules=fil.renamer`, `select=all` eller `select=a.jpg+b.jpg`, `sort=size|modified|new`, `notree`, `do=rename|revert`, `do=confirm` ## 4. Fallgropar - **Räkna inte positioner i byte.** Använd teckenräkning överallt (se avsnitt 3), och testa med å, ä och ö. - **Lita inte på att `rename` vägrar skriva över.** På macOS ersätter `rename` tyst en fil som redan finns. Om en fil har dykt upp under det nya namnet sedan förhandsgranskningen skulle den försvinna. Kontrollera målet och skriv aldrig över; ha ett test för det. - **Låt inte ett eget datumformat få programmet att krascha.** chrono får panik på en okänd `%`-kod, och formatet skrivs medan förhandsgranskningen körs – en halvskriven kod räcker. Validera formatet först och visa ett okänt format som det står. - **Glöm inte reserverade namn med ändelse.** `CON.txt` är lika ogiltigt som `CON` på Windows. - **Byt inte mappen före filerna i den.** Då stämmer inte sökvägarna till filerna längre. Djupast först. - **Räkna upp generationen när listan eller markeringen ändras**, annars visar förhandsgranskningen gamla namn. - **Ta inte med systemets Klipp ut/Kopiera/Klistra in i macOS-menyn**; den nativa menyn tar ⌘C/⌘V från textfälten. - **En tom läsarenhet (A:, en DVD utan skiva) får inte göra mappträdet segt.** Läs in undermappar först när de fälls ut. - **Ett helt täckt fönster ritas inte på macOS**, och då tas ingen skärmbild. Placera fönstret synligt. - **Kontrollera tecknen i gränssnittet på Windows.** Ett tecken som typsnittet saknar (t.ex. `→`) ritas som en tom ruta. Se det i en skärmbild från Windows, inte bara från macOS. ## 5. Krav och mått - Kärnan: File Renamer har 75 enhetstester. Varje panel har egna tester, och bytet testas mot riktiga filer i en temporär katalog. - Exempel att testa mot: - Remove first 3 på `Årsmöte` ger `möte` - Numbering med bokstäver: 27 → `AA`; romerska: 1994 → `MCMXCIV` - Replace `BR`→`BRU4` följt av Remove first 3 på `BR_setup…` ger `4U_setup…` (stegen körs i ordning) - `a`↔`b` i samma omgång, med kontroll av innehållet efteråt - `bild.jpg`→`Bild.jpg` på ett skiftlägesokänsligt filsystem - en regelfil där en panel saknas går att läsa - Ett byte av 11 objekt följt av Revert ska ge exakt samma fillista som före bytet (`diff` tom), och loggen ska vara tom. ## 6. Så verifieras det - `cargo clippy --workspace --all-targets` utan varningar, `cargo test --workspace --release`, och `cargo check --target` för den plattform man inte sitter på (fångar fel i `#[cfg(windows)]`-kod). - **Tester i kärnan**: varje panel, positioner i tecken, kontrollen (dubbletter, finns redan, ogiltiga namn, skiftläge), bytet (korsande byten, skiftlägesbyte, mapp och fil i samma omgång, misslyckat byte rullas tillbaka, ingen överskrivning), Revert (vägrar när det gamla namnet tagits), regelfiler fram och tillbaka. - **Gränssnittet granskas med skärmbilder** från den riktiga binären med utvecklarhjälpen. - **Bytet och Revert provas mot riktiga filer genom appen**, med datakatalogen åt sidan och en jämförelse av mappens innehåll före och efter. - Använd **påhittade filer och en neutral sökväg** i skärmbilder som ska visas för andra – inte hemkatalogen. ## 7. Arbetssätt - **Plan först**: gå igenom förebilden (Bulk Rename Utility) panel för panel och skriv en tabell över vad varje panel gör och vad som medvetet lämnas utanför. Dela upp bygget i ärenden: skelett, reglerna, fillistan, säkerheten, gränssnittet, regelfilerna, verifiering på den andra plattformen. - **Fråga om verkliga beslut**, till exempel vilka paneler som ska med och hur avvikelser från förebilden ska hanteras. - **Ett ärende i taget**, med mätningen i avslutskommentaren. - **Det som kräver en människa** – installeraren, menyn och tangenterna på den andra plattformen, mappträdet med riktiga enheter – blir ett eget verifieringsärende. ## 8. Prompten > Bygg ett skrivbordsprogram för [Windows och macOS, och det ska gå att kompilera för Linux] i [Rust med eframe/egui] som byter namn på många filer på en gång, med Bulk Rename Utility som förebild: en fillista med gammalt och nytt namn sida vid sida, och elva regelpaneler som körs i ordning på varje markerad fil. > > Läs hela IDEA.md nedan först. Den beskriver panelerna, säkerhetsreglerna, de beslut som visade sig avgörande och fallgroparna att undvika. > > Arbeta så här: > 1. Gå igenom förebilden och skriv en plan. Dela upp arbetet i ärenden och säg vad som inte ingår. > 2. Bygg reglerna, kontrollen och bytet i ett bibliotek utan gränssnitt, med tester, innan fönstret byggs. Positioner räknas i tecken. > 3. Inget byte får köras om någon rad har ett fel, bytet görs i två steg, och Revert ska fungera även efter en omstart. > 4. Bygg utvecklarhjälpen (fönsterstorlek, skärmbild, datakatalog, debugsteg) tidigt och granska varje gränssnittsändring med en skärmbild från den riktiga binären. > 5. Prova bytet och Revert mot riktiga filer i en temporär mapp, och jämför mappens innehåll före och efter. > > Paneler jag vill ha utöver eller i stället för de elva: [lista, eller "de elva i IDEA.md"]. > > [klistra in IDEA.md här]