Sostituzione atomica di file UTF-8
Sostituisci un file UTF-8 tramite un file temporaneo nella stessa cartella.
import os
from pathlib import Path
from tempfile import NamedTemporaryFile
def replace_utf8(path, text):
if not isinstance(path, (str, Path)) or type(text) is not str:
raise ValueError("replace.input")
target, data = Path(path), text.encode("utf-8")
temporary = None
try:
with NamedTemporaryFile(dir=target.parent, prefix=".swap-", delete=False) as out:
temporary = Path(out.name)
out.write(data)
os.replace(temporary, target)
finally:
if temporary is not None:
temporary.unlink(missing_ok=True)Controlla prima di applicare
Confronta il comportamento effettivo con il risultato atteso. Se una verifica fallisce, indaga la causa prima di altre modifiche.
Modelli
Configura un endpoint compatibile con OpenAI o Anthropic usando URL di base e chiave API, se necessaria. Prova la connessione. Il server locale deve essere in esecuzione; gli strumenti remoti possono trasmettere dati separatamente.
Progetto
Prova testo vuoto, Unicode e un errore di sostituzione, chiudendo prima il temporaneo e rimuovendo i residui senza modificare il vecchio file in caso di tale errore.
import os
from pathlib import Path
from tempfile import NamedTemporaryFile
def replace_utf8(path, text):
if not isinstance(path, (str, Path)) or type(text) is not str:
raise ValueError("replace.input")
target, data = Path(path), text.encode("utf-8")
temporary = None
try:
with NamedTemporaryFile(dir=target.parent, prefix=".swap-", delete=False) as out:
temporary = Path(out.name)
out.write(data)
os.replace(temporary, target)
finally:
if temporary is not None:
temporary.unlink(missing_ok=True)Verifica cosa rimane quando un aggiornamento del file fallisce
Replacent è un ambiente di programmazione per Windows che permette di usare un modello IA per ragionare sulle modifiche ai file su disco. Parti dal codice del progetto e spiega cosa deve rimanere se un aggiornamento non può terminare. Chiedi all'assistente di esaminare preparazione, scrittura, sostituzione e pulizia come un'unica operazione. L'obiettivo è una proposta di cui tu sappia descrivere il comportamento in caso di errore prima di provarla su dati utili.
L'esempio replace_utf8.py propone un'attività con un file temporaneo e la sostituzione del file di destinazione. Puoi chiedere all'assistente di verificare quando avviene la codifica, dove viene collocato l'output temporaneo e quale pulizia viene eseguita dopo un'eccezione. Esamina il codice effettivo e l'ambiente di destinazione, senza presumere che una sola chiamata di sostituzione garantisca tutte le proprietà di durabilità necessarie all'applicazione.
Prova l'operazione modificata in una cartella di prova eliminabile, controllando il contenuto del file di destinazione e i file residui sia dopo un successo sia dopo errori controllati. Mantieni le osservazioni nella conversazione, così le modifiche successive affrontano comportamenti dimostrati. Replacent accetta connessioni supportate compatibili con OpenAI o Anthropic, con credenziali quando richieste. Se vi è disponibile un modello senza filtri, puoi sceglierlo per la discussione; limiti di contesto, strumenti e restrizioni delle risposte dipendono comunque dal modello e dal server. I controlli del progetto restano la prova del rispetto del contratto di aggiornamento dei file.
Domande su sostituzione e pulizia
- Cosa deve specificare una richiesta di aggiornamento dei file?
Descrivi il contenuto atteso del file di destinazione dopo il successo, cosa deve rimanere dopo un errore e se è consentito sostituire file esistenti. Includi l'ambiente di destinazione e il requisito di codifica, così la proposta può essere verificata rispetto a postcondizioni concrete.
- La sostituzione equivale a una memorizzazione durevole?
Non darlo per scontato. I requisiti di durabilità dipendono dall'intera implementazione e dall'ambiente. Se è importante sopravvivere a un arresto anomalo, dichiaralo separatamente ed esamina il comportamento pertinente, invece di dedurlo dall'uso di un file temporaneo.
- Come posso esaminare il comportamento della pulizia?
Usa file di prova eliminabili e casi di errore controllati adatti al progetto. Controlla poi sia il file di destinazione originale sia gli output temporanei. Leggi anche il percorso delle eccezioni: un'esecuzione riuscita non verifica la pulizia dopo un'operazione interrotta.
- Gli errori di pulizia dovrebbero nascondere l'errore originale?
Definisci il comportamento di segnalazione degli errori necessario al chiamante. Verifica se la pulizia può generare un'altra eccezione e oscurare il problema iniziale, poi prova quel percorso, quando possibile, prima di accettare una revisione dell'operazione.
Replacent · Aggiornato 2026-10-25