Codificatore e decodificatore yEnc

Questo codificatore yEnc converte testo UTF-8 semplice nel formato di trasferimento binario a basso sovraccarico a lungo usato su Usenet e decodifica payload yEnc inquadrati o grezzi di nuovo in testo leggibile. yEnc mantiene quasi ogni ottetto come un solo carattere stampabile o esteso dopo un offset fisso di quarantadue, sfuggendo solo a un piccolo insieme critico affinché i dati binari viaggino nei corpi degli articoli NNTP con ben meno espansione di Base64. Lo usi gratis nel browser per esercitarsi con strumenti Usenet e per il debug degli articoli, oppure chiami l’API a $0.002 per richiesta riuscita quando le pipeline necessitano di trasformazioni yEnc riproducibili in CI e servizi backend.

Che cos’è yEnc e che cosa restituisce questo strumento

yEnc è una codifica in stile content-transfer pensata affinché file binari viaggino dentro articoli Usenet senza la penalità di dimensione di un terzo di Base64. Ogni byte di ingresso è spostato di quarantadue modulo duecentocinquantasei; solo i valori critici null, line feed, carriage return e uguale sono escaped anteponendo un segno uguale e aggiungendo sessantaquattro prima dell’emissione. Questa pagina segue sempre quel contratto per testo UTF-8: la modalità encode codifica la Sua stringa in UTF-8, applica l’offset e gli escape critici, spezza le righe ed emette intestazioni con un CRC calcolato; la modalità decode rimuove le righe di controllo, ignora CR e LF nel corpo, inverte gli escape, verifica size e CRC quando presenti e rifiuta sequenze di uguale incomplete invece di indovinare. I codificatori inseriscono poi interruzioni di riga soft così che le righe dell’articolo restino vicine alla larghezza classica di centoventotto caratteri, e inquadrano il corpo con una riga =ybegin che porta size, lunghezza di riga opzionale e un nome file, più un trailer =yend che spesso include size e un checksum IEEE CRC-32. La risposta JSON include result per la stringa trasformata, mode che riecheggia encode o decode, encoding fisso a yenc, size per la lunghezza del payload binario, name e crc32 opzionali, framed true quando sono state usate o rilevate intestazioni, e input_bytes più output_bytes per affermare le dimensioni nei test. Non c’è percorso di streaming né riparazione silenziosa di yEnc rotto: o la stringa è valida secondo queste regole o la richiesta fallisce con invalid_input. Se Le serve un impacchettamento opaco sicuro per la posta, preferisca gli endpoint Base64 o quoted-printable; questa landing è per la codifica yEnc orientata a Usenet che i client di news e i poster binari già si aspettano.

Come vengono letti text, mode, name e line e come restano riproducibili i risultati

Encode accetta qualsiasi stringa Unicode, la converte con il TextEncoder della piattaforma in byte UTF-8 ed emette un frammento di articolo yEnc inquadrato con CRC-32 in maiuscolo. Dopo il recupero dei byte, una decodifica UTF-8 fatale assicura che spazzatura binaria non diventi testo mojibake. Il campo di payload preferito è text, con alias input, value e s così che form, query string e client SDK riutilizzino lo stesso contratto senza rinominare colonne. Mode ha predefinito encode e accetta decode in modo esplicito; gli alias op, direction e action mappano lo stesso interruttore per script che usano già quei nomi. Il name opzionale (alias filename, file) viene scritto sulla riga =ybegin in codifica e predefinito è data.bin; non deve contenere carriage return, line feed o segni uguale. Il line opzionale (alias line_length, linewidth) imposta la larghezza di wrap del corpo tra trentadue e cinquecentododici caratteri e predefinito è centoventotto, in linea con la prassi comune yEnc. Decode accetta testo inquadrato con =ybegin e =yend o un flusso solo corpo: un escape di uguale incompleto in coda, un uguale seguito da interruzione di riga, una discordanza di size rispetto al conteggio dei byte decodificati o una discordanza CRC-32 falliscono con un messaggio invalid_input chiaro. Abbini l’esecuzione gratuita nel browser di questa pagina all’API a pagamento quando Le serve lo stesso risultato matematico dentro una pipeline automatizzata senza reimplementare da sé le tabelle yEnc. Gli input non validi restituiscono invalid_input e non vengono addebitati, il che mantiene economica la validazione mentre le trasformazioni riuscite restano un prezzo fisso per elemento.

Dove yEnc si colloca in Usenet, binari e fixture di test

Gli educatori usano lo stesso strumento insegnando la differenza tra l’opacità di Base64 e la codifica Usenet a basso sovraccarico di yEnc per payload soprattutto binari. Su questa pagina il lavoro gira interamente nel Suo browser; tramite l’API ogni consultazione riuscita costa $0.002, la validazione fallita non viene addebitata e nulla viene memorizzato dopo la risposta. Quella divisione — esplorazione interattiva gratuita e API identica a pagamento — coincide con il resto del catalogo KIT di livello A e Le consente di passare da una demo in aula a una pipeline automatizzata senza cambiare il risultato codificato.