Normalizzare indentazione testo

Quando la stessa riga o l'intero documento mescola tabulazioni e spazi senza un pattern chiaro, l'attività fallisce con invalid_input invece di indovinare in silenzio. Il target_unit opzionale Le consente di riscalare i livelli basati sugli spazi (ad esempio da due a quattro) senza cambiare l'albero logico di profondità.

Come funzionano il rilevamento dell'unità di base e la riscrittura dei livelli

Il target_unit opzionale si applica solo ai documenti in stile spazi: i livelli sono preservati e l'output usa quel numero di spazi per livello, che è come convertire un albero a due spazi in uno a quattro in una sola chiamata. L'input in stile tabulazioni ignora target_unit così le tabulazioni non vengono espanse in silenzio.

Contratto di input, campi di risposta e comportamento degli errori

Preferisca inviare il corpo multilinea grezzo piuttosto che collassare le newline in anticipo quando vuole una semantica reale di indentazione per riga; una singola riga lunga ha solo un'indentazione da normalizzare. Invii con POST un corpo JSON con un campo stringa obbligatorio text (alias input, value, string, s, content e body). Il valore deve essere una stringa non vuota dopo il trim globale degli spazi bianchi e non deve superare centomila caratteri, così un singolo incolla non esaurisce la memoria del Worker o del browser. Il target_unit opzionale è un intero positivo da uno a trentadue; i non interi e i valori fuori intervallo falliscono la validazione. In caso di successo la risposta restituisce input come la stringa originale, text come il risultato multilinea riscritto unito con LF, indent_style come spaces, tabs o none, indent_unit come la dimensione effettiva dell'unità di output, detected_unit come l'unità dedotta prima di qualsiasi override di destinazione, line_count come il numero di righe incluse le vuote, indented_lines come quante righe avevano un livello positivo, max_level come il livello di indentazione più profondo, levels come l'array di profondità intera per riga allineato a lines, lines come l'array ordinato delle stringhe di riga riscritte, e message come un breve riepilogo di stile, unità, conteggio righe e livello massimo. La validazione fallita — text assente, valori non stringa, contenuto vuoto, payload eccessivo, target_unit non valido, mix tab/spazio sulla stessa riga, o mix di stili a livello di documento — restituisce invalid_input e non viene mai addebitata. Il prezzo è un fisso di $0.002 per richiesta riuscita con unità item. In integrazione, asserisca su text o lines per il contenuto pulito, confronti opzionalmente levels e indent_unit per le regressioni, e tratti invalid_input come un conflitto di stile lato client su incolli misti, non come un evento di fatturazione.

Quando usare questo strumento e come differisce da ricerche affini

Usi questa capacità quando l'intento di ricerca è normalizzare i livelli di indentazione del testo, correggere indentazione incoerente online, convertire un incolla irregolare di due e quattro spazi in un'unica unità, o rilevare lo stile di indentazione a tabulazione versus spazio prima di un commit. Tenga presenti gli spazi finali e le colonne di allineamento interne — questo strumento riscrive solo la sequenza di indentazione iniziale, non gli spazi di allineamento dentro la riga. Non è un formattatore di codice completo, né un pretty printer consapevole del linguaggio, né un eliminatore di righe vuote, né un String.trim globale che distruggerebbe la struttura intenzionale. I controlli di andata e ritorno per i test sono semplici: fornisca un blocco di tre righe con zero, due e quattro spazi iniziali e si aspetti indent_unit due con levels zero, uno e due; fornisca blocchi annidati indentati solo con tabulazioni e si aspetti indent_style tabs con livelli interi che corrispondono ai conteggi di tabulazioni; invii deliberatamente una riga che inizia con tabulazione e poi spazi, o una riga a tabulazione accanto a una sorella a spazi, e confermi invalid_input che menziona il mix di tabulazioni e spazi. Preferisca str.trim_lines quando deve solo rimuovere spazi iniziali e finali da ogni riga senza preservare un albero di profondità; preferisca data.json_format quando il payload è JSON da pretty-print con indentazione fissa; preferisca questa capacità quando gli esseri umani hanno già scritto testo gerarchico semplice o blocchi simili a codice e serve un'unità di base coerente. Le attività fallite che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economica la validazione dei form e i test negativi di CI.