A cross-platform Scala 3 library for importing typed tabular data from a simple, human-readable text format. Supports JVM, Scala.js (Node.js), and Scala Native.

importer parses a lightweight whitespace-delimited text format into structured tables with typed columns. Headers declare column names and types; the library automatically converts each cell value to the appropriate Scala type. Supported types include integers, floats, decimals, currencies, booleans, dates, timestamps, UUIDs, and arbitrary text. Custom enum types and user-defined converters are also supported.

Add to your build.sbt:

libraryDependencies += "io.github.edadma" %%% "importer" % "0.1.0"

Data files consist of one or more table blocks. Each block starts with a table name, followed by a header row of typed column definitions, then data rows:

users
id:integer  name  email           active:boolean  joined:date
1           Alice [email protected]  true          2023-01-15
2           Bob   [email protected]    false         2023-03-22

Column headers use the syntax name:type. Omitting the type defaults to text. Multiple column args are separated by commas.

The special value null in any cell produces a null value regardless of column type.

Declare named enum types before the tables that use them:

status: active, inactive, pending

orders
id:integer  status  amount:currency
1           active  19.99
2           pending  5.00

When doubleSpaces = true, two or more consecutive spaces act as a column delimiter, allowing single spaces within values:

products
name                    price:currency
Widget Deluxe           9.99
Super Gadget Pro Max    49.99

import io.github.edadma.importer.Importer

// From a string
val result = Importer.importFromString(data, doubleSpaces = false)

// From a file
val result = Importer.importFromFile("data.txt", doubleSpaces = false)

// Access results
result.tables.foreach { table =>
  println(s"Table: ${table.name}")
  table.header.foreach(col => print(s"  ${col.name}:${col.typ}"))
  println()
  table.data.foreach(row => println(s"  $row"))
}

result.enums.foreach { e =>
  println(s"Enum ${e.name}: ${e.labels.mkString(", ")}")
}

Importer.addConverter("percent", s =>
  if s.endsWith("%") then s.dropRight(1).toDoubleOption else None
)

Requirements: JDK 11+, sbt 1.12.1+, Node.js (for JS), LLVM/Clang (for Native)

# Compile all platforms
sbt compile

# Run tests on all platforms
sbt test

# Run tests on a specific platform
sbt "importerJVM/test"
sbt "importerJS/test"
sbt "importerNative/test"

ISC — see LICENSE