Das Postfach aufräumen
Ein Postfach läuft voll. Einmal im Jahr schafft dieses Programm Platz: Der Ordner Archive des letzten Jahres bekommt die Jahreszahl in den Namen, ein neues leeres Archive beginnt, das Archiv von vor zwei Jahren wird gelöscht, und alte Dorfnachrichten, die du schon gelesen hast, verschwinden aus der INBOX. Am Ende zeigt es, wie voll die INBOX ist.
Funktionen: IMAP_LIST, IMAP_CREATE, IMAP_RENAME, IMAP_DELETE, IMAP_STORE, IMAP_EXPUNGE und IMAP_STATUS
Was du brauchst
- die Mod c0de net, ein Mailkonto mit IMAP und dein App-Passwort als Geheimnis
mailPasswordin deinem offenen Tresor, wie in Der Bestellschalter - einen Auslöserblock mit Knopf, einen Laptop und Variablenkarten
server(STRING) undport(INTEGER) - ein Postfach, das du aufräumen magst: IMAP_DELETE löscht einen Ordner mit allen Nachrichten, und IMAP_EXPUNGE entfernt Nachrichten endgültig. Probier es zuerst mit einem zweiten Konto.
Die Idee
Ordner verwalten fünf Funktionen:
- IMAP_LIST gibt die Namen der Ordner zurück. Sein Muster wählt aus, welche:
*steht für beliebigen Text,%für beliebigen Text innerhalb einer Ordnerebene.Archive*findet Archive, Archive 2024 und Archive 2025. - IMAP_CREATE, IMAP_RENAME und IMAP_DELETE legen einen Ordner an, benennen ihn um und löschen ihn.
- IMAP_STATUS gibt die MAILBOX eines Ordners zurück – wie viele Nachrichten, wie viele ungelesen –, ohne ihn auszuwählen.
Nachrichten löschen geht in IMAP in zwei Schritten, wie der Papierkorb eines Computers: IMAP_STORE gibt ihnen das Flag \Deleted, und IMAP_EXPUNGE entfernt alle Nachrichten des ausgewählten Ordners, die es haben. Bis dahin kann ein Mailprogramm sie noch zurückholen.
Das Programm
PROGRAM tidymail
NOOP
INCLUDE c0de_net/mail
NOOP
FUNCTION cleanup
PARAMETER server STRING "imap.example.com"
PARAMETER port INTEGER 0
PARAMETER year INTEGER 2026
RESULT removed INTEGER
BEGIN
SECRET mailPassword STRING
VARIABLE imap STRUCT c0de_net/mail/IMAP_SERVER
VARIABLE folders ARRAY STRING
VARIABLE box STRUCT c0de_net/mail/MAILBOX
VARIABLE uids ARRAY INTEGER
VARIABLE oldest STRING
VARIABLE last STRING
ASSIGN imap.server server ;
ASSIGN imap.port port ;
ASSIGN imap.user "steve@example.com" ;
ASSIGN imap.password mailPassword ;
ASSIGN oldest "Archive " ⊕ ( year - 2 ) ;
ASSIGN last "Archive " ⊕ ( year - 1 ) ;
CALL CLS
CALL c0de_net/mail/IMAP_LIST
PARAMETER server imap ;
PARAMETER pattern "Archive*" ;
RESULT result folders
EACH name folders
BEGIN
IF name = oldest ;
BEGIN
CALL c0de_net/mail/IMAP_DELETE
PARAMETER server imap ;
PARAMETER folder name ;
CALL PRINT
PARAMETER value "Deleted " ⊕ name ;
END IF
IF name = "Archive" ;
BEGIN
CALL c0de_net/mail/IMAP_RENAME
PARAMETER server imap ;
PARAMETER folder name ;
PARAMETER new_name last ;
CALL c0de_net/mail/IMAP_CREATE
PARAMETER server imap ;
PARAMETER folder "Archive" ;
CALL PRINT
PARAMETER value "Archive is now " ⊕ last ;
END IF
END EACH
CALL c0de_net/mail/IMAP_SELECT
PARAMETER server imap ;
RESULT result box
CALL c0de_net/mail/IMAP_SEARCH
PARAMETER server imap ;
PARAMETER criteria "SEEN SUBJECT \"Village news\"" ;
RESULT result uids
CALL c0de_net/mail/IMAP_STORE
PARAMETER server imap ;
PARAMETER uids uids ;
PARAMETER flags "\\Deleted" ;
CALL c0de_net/mail/IMAP_EXPUNGE
PARAMETER server imap ;
RESULT result removed
CALL PRINT
PARAMETER value "Removed " ⊕ removed ⊕ " old news" ;
CALL c0de_net/mail/IMAP_STATUS
PARAMETER server imap ;
PARAMETER folder "INBOX" ;
RESULT result box
CALL PRINT
PARAMETER value "INBOX: " ⊕ box.messages ⊕ " messages, " ⊕ box.unseen ⊕ " unseen" ;
END FUNCTIONAufbauen und ausführen
- Stelle den Auslöserblock auf
tidymail/cleanupund binde den Laptop daran. Leg die Variablenkartenserverundportin den Auslöserblock und eine nicht initialisierte Variablenkarte fürremoved. - Drück den Knopf. Mit den Ordnern Archive und Archive 2024 und alten Nachrichten in der INBOX zeigt der Laptop:
Archive is now Archive 2025
Deleted Archive 2024
Removed 1 old news
INBOX: 5 messages, 3 unseenDie Reihenfolge der ersten beiden Zeilen hängt davon ab, in welcher Reihenfolge der Server die Ordner auflistet. Ein zweiter Druck im selben Jahr findet Archive 2025, das jünger als zwei Jahre ist, und ein leeres Archive: Er benennt es in Archive 2025 um – das gibt es schon, also lehnt der Server ab, und das Programm hält mit MAIL_REJECTED an. Räum einmal im Jahr auf, oder probier die erste Übung.

So funktioniert es
- Die Namen der Archive entstehen aus dem Parameter
year:"Archive " ⊕ ( year - 2 )ist"Archive 2024". Die Klammern sorgen dafür, dass das Jahr ausgerechnet wird, bevor es an den Text gehängt wird. - IMAP_LIST mit
Archive*gibt nur die Namen der Archive zurück. EACH geht sie durch: Das älteste wird gelöscht, und Archive wird auf das Vorjahr umbenannt und mit IMAP_CREATE neu angelegt. - IMAP_SELECT wählt INBOX, damit die Funktionen für Nachrichten wissen, wo sie arbeiten. Die Kriterien
SEEN SUBJECT "Village news"finden die Nachrichten, die du gelesen hast; die Anführungszeichen halten die beiden Wörter zusammen. Im Dialog des Literals tippst du sie, wie sie sind; die Textschreibweise des Programms schreibt sie\". - IMAP_STORE fügt ihnen
\Deletedhinzu – im Dialog als\Deletedgetippt, in der Textschreibweise"\\Deleted"geschrieben – und IMAP_EXPUNGE entfernt sie und gibt zurück, wie viele – das Ergebnisremoved. - IMAP_STATUS liest am Ende die MAILBOX der INBOX. Anders als IMAP_SELECT ändert es
imap.foldernicht.
Probier es selbst
- Mach das Programm sicher gegen zweimal Drücken: Benenne Archive nur um, wenn es noch kein Archiv des letzten Jahres gibt.
Lösung
Such vor der EACH-Schleife nach last in folders: eine zweite EACH-Schleife, die ein BOOLEAN done setzt, wenn ein Name gleich last ist. Benenne Archive dann nur um, IF name = "Archive" AND NOT done. Ein zweiter Druck zeigt nur Removed 0 old news und den Status.
- Zeig vor dem Löschen des ältesten Archivs, wie viele Nachrichten mit ihm verloren gehen.
Lösung
Rufe vor IMAP_DELETE IMAP_STATUS mit PARAMETER folder name ; und einer MAILBOX-Variablen auf und gib ihr messages aus: "Deleted " ⊕ name ⊕ " with " ⊕ box.messages ⊕ " messages".
Mehr dazu
- IMAP_LIST, IMAP_STATUS und IMAP_EXPUNGE
- Der Bestellschalter: Ordner auswählen und Flags
- Wenn Mails scheitern: MAIL_REJECTED und die anderen Fehler