atais / fixed-length

Scala library for parsing fixed length file format

Version Matrix

fixed-length Build Status codecov license

A simple Scala library for parsing fixed-length format.

A graceful playground for Shapeless and Cats libraries.


You can find the fixed-length library on Maven Central

Add the library to your dependencies:

libraryDependencies += "com.github.atais" %% "fixed-length" % "0.3"

Library is cross-compiled for Scala 2.10, 2.11 and 2.12.


Please find example test scenarios describing simple use cases:


Describe your class with an Encoder, Decoder or Codec typeclass and Parse away!


start: Int

A fixed position in line, where the field begins

end: Int

A fixed position in line, where the field ends

align: Alignment

(default value is Alignment.Left)

Alignment of the field's value in the given area of size end - start

Available options:

  • Alignment.Left
  • Alignment.Right

padding: Char

(default value is ' ')

Fills the remaining space in the given area with the padding Char.

Warning! Wrong selection of padding char may cause decoding issues!

defaultValue: A (Decoder only)

(default value is null)

The default value of a field, which will be used in case of any decoding error.

Warning! This will surpress any decoding errors!