La definición del formato, como data.

Un layout es una lista de campos más tres decisiones globales: en qué encoding viene el archivo, si las posiciones se cuentan en bytes o en caracteres, y qué largo total se espera por línea. Cambiar de formato es cambiar este mapa, no escribir código.

iex> alias AnchoFijo.Layout
iex> {:ok, layout} = Layout.nuevo(
...>   nombre: "nómina banco X",
...>   encoding: :latin1,
...>   campos: [
...>     [nombre: :rut, largo: 10],
...>     [nombre: :beneficiario, largo: 30],
...>     [nombre: :monto, largo: 12, tipo: :decimal, precision: 2]
...>   ]
...> )
iex> Layout.largo(layout)
52

Las posiciones son 1-based porque así vienen en todas las especificaciones bancarias del mundo: cuando el anexo dice "posiciones 21 a 32", el layout dice lo mismo. Si se omiten, cada campo se encadena al anterior.

Validación de la definición misma

nuevo/1 revisa el layout antes de ver un archivo. Distingue dos gravedades, y la distinción es de dominio: un solapamiento es siempre un error de transcripción del anexo, mientras que un hueco suele ser una zona reservada legítima del formato. Los huecos quedan en :advertencias y no impiden parsear.

iex> alias AnchoFijo.Layout
iex> {:error, [diagnostico]} = Layout.nuevo(campos: [
...>   [nombre: :rut, posicion: 1, largo: 10],
...>   [nombre: :nombre, posicion: 8, largo: 20]
...> ])
iex> AnchoFijo.Diagnostico.mensaje(diagnostico)
"layout, campo :nombre (posiciones 8-27): se esperaba que empezara en la posición 11 o después, llegó 8; se solapa con el campo :rut (posiciones 1-10)"

iex> alias AnchoFijo.Layout
iex> {:ok, layout} = Layout.nuevo(campos: [
...>   [nombre: :rut, posicion: 1, largo: 10],
...>   [nombre: :nombre, posicion: 14, largo: 20]
...> ])
iex> AnchoFijo.Diagnostico.mensaje(hd(layout.advertencias))
"layout, campo :nombre (posiciones 14-33): se esperaba que empezara en la posición 11, llegó 14; quedan 3 posiciones sin declarar entre :rut y :nombre; si el formato tiene relleno ahí, ignore esta advertencia"

Opciones

• :campos — obligatorio. Lista de definiciones de AnchoFijo.Campo (keyword lists, mapas o structs ya construidos).
• :encoding — :utf8 (default) o :latin1.
• :unidad — :bytes (default) o :caracteres. Ver más abajo.
• :largo — largo total esperado por línea. Si se omite, se infiere del último campo.
• :nombre — etiqueta libre para identificar el layout en logs.

Bytes o caracteres

El default es :bytes porque un formato de ancho fijo se define sobre el archivo físico: cuando el banco dice "120 posiciones", cuenta bytes. Con latin-1 da lo mismo, un byte es un carácter. Con UTF-8 no: si el archivo trae acentos y el emisor contó caracteres, hay que declarar unidad: :caracteres o cada línea con una "ñ" se corre un byte.