fn_registry/python/functions/infra/read_file_with_encoding.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
read_file_with_encoding	function	py	infra	1.0.0	impure	read_file_with_encoding(path: str, encodings: list[str] | None = None) -> str	Lee un archivo de texto intentando multiples encodings en orden hasta encontrar uno que funcione. Util para archivos de origen desconocido (Windows, Latin-1, con BOM, etc.).	file encoding io text utf8 latin1 cp1252 decode pendiente-usar				false	error_go_core		name desc path ruta del archivo a leer name desc encodings lista opcional de encodings a intentar en orden (defecto: ['utf-8', 'utf-8-sig', 'latin-1', 'cp1252'])	string con el contenido del archivo decodificado	true	archivo utf-8 valido archivo utf-8 con BOM eliminado con utf-8-sig archivo latin-1 archivo binario falla con ValueError encodings personalizados archivo no existe lanza FileNotFoundError	python/functions/infra/read_file_with_encoding_test.py	python/functions/infra/read_file_with_encoding.py

Ejemplo

# Leer archivo de origen desconocido
content = read_file_with_encoding("/tmp/datos.csv")

# Leer archivo Windows con BOM explicitamente
content = read_file_with_encoding("/tmp/report.txt", encodings=["utf-8-sig", "cp1252"])

Notas

Los encodings por defecto son ["utf-8", "utf-8-sig", "latin-1", "cp1252"]. El orden importa: utf-8 se intenta primero porque es el mas comun. Si el archivo tiene BOM y se quiere que sea eliminado automaticamente, pasar encodings=["utf-8-sig"] o anteponerlo a utf-8 en la lista personalizada.

latin-1 nunca lanza UnicodeDecodeError porque mapea todos los bytes 0x00-0xFF, por lo que actua como fallback universal. Si latin-1 es el ultimo encoding y falla con cp1252 tambien, solo un archivo binario puro (sin mapeo posible) disparara el ValueError.

Raises FileNotFoundError u OSError nativas si el archivo no existe o hay error de I/O — estos no se envuelven en ValueError.