Cosa fa lo strumento
- Targeting basato su MIME: elabora solo file il cui tipo MIME contiene
text/
ojson
(es.: HTML, CSS, JS, CSV, MD, XML, YAML, INI, JSON). - Ricerca e sostituzione precise: pattern di testo semplice o regex, opzioni di distinzione maiuscole/minuscole e corrispondenza parole intere.
- Anteprima di prova: mostra esattamente quali file e righe verranno modificati prima della scrittura.
- Ambito selettivo: includi/escludi percorsi, pattern glob e estensioni di file.
- Supporto codifiche: utf-8 di default con gestione corretta del BOM.
- Scritture sicure: backup opzionali e strategia di scrittura atomica per ridurre i rischi di corruzione.
- Rapporto modifiche: riepilogo per file con conteggio di corrispondenze e sostituzioni.
Casi d’uso comuni
- Rebranding & aggiornamenti di testo: nomi di prodotti, dettagli aziendali, testi legali.
- Migrazioni URL/domini: sostituire host legacy, percorsi CDN, prefissi risorse.
- Rotazione configurazioni & segreti: cambiare endpoint API o chiavi nei file non binari.
- Refactoring di codice: rinominare moduli, classi CSS e flag di funzionalità.
- Preparazione localizzazione: estrarre o normalizzare stringhe hardcoded.
- Igiene dei dati: correggere nomi proprietà JSON, intestazioni CSV o errori di schema.
Come funziona
- Scegli una cartella radice da analizzare.
- Imposta il tuo pattern (testo semplice o regex) e il valore di sostituzione.
- Affina l’ambito con glob di inclusione/esclusione e filtri di estensione.
- Esegui un’anteprima per vedere i file e frammenti corrispondenti.
- Applica le modifiche con backup abilitati per un facile ripristino.
- Consulta il rapporto con conteggio corrispondenze, file modificati e elementi ignorati.
Perché usare il filtraggio MIME?
I file binari spesso contengono sequenze di byte che sembrano testo. Il filtraggio MIME limita le operazioni ai formati testuali, riducendo i falsi positivi e prevenendo corruzione di file come immagini, font, archivi ed eseguibili.
Buone pratiche
- Fai un backup o usa il controllo di versione prima di sostituzioni di massa.
- Preferisci i confini regex (es.:
\b
) per evitare corrispondenze parziali. - Target ristretto con glob come
**/*.js
ocontent/**/*.md
. - Testa su un sottoinsieme quindi applica all’intero progetto.
- Verifica i diff per confermare nessuna modifica indesiderata.
Limitazioni
- Ignora formati binari per progettazione; se un file riporta un MIME non testuale, non verrà modificato.
- Pattern regex troppo ampi possono corrispondere a più del previsto — usa anteprima e ancore.
- File monolitici molto grandi possono richiedere più memoria; dividili o riduci l’ambito se necessario.
FAQ
- Quali file sono inclusi?
- Qualsiasi file il cui tipo MIME contiene
text/
(es.:text/html
,text/css
,text/markdown
) ojson
(es.:application/json
). - Posso annullare le modifiche?
- Sì. Abilita i backup per creare copie
.bak
, o usa il tuo VCS per ripristinare modifiche specifiche. - Cambia permessi o timestamp dei file?
- I permessi vengono mantenuti. I timestamp vengono aggiornati solo sui file modificati.
- Riscrive le terminazioni di riga?
- Conserva le terminazioni esistenti (LF/CRLF) salvo politiche diverse nel tuo ambiente.
- Come evitare di modificare variabili dentro blocchi di codice che non voglio toccare?
- Restringi l’ambito con glob di inclusione, e usa regex con ancore/contesti per colpire solo le regioni sicure.