scalatest-csv-table

A scalatest helper for table driven testing with csv

License	Apache-2.0
Categories	Scala Languages CSV Data Data Formats
GroupId	io.github.akiomik
ArtifactId	scalatest-csv-table_2.13
Last Version	1.2.1
Release Date	Apr 27, 2021
Type	jar
Description	scalatest-csv-table A scalatest helper for table driven testing with csv
Project URL	https://github.com/akiomik/scalatest-csv-table
Project Organization	io.github.akiomik
Source Code Management	https://github.com/akiomik/scalatest-csv-table

Download scalatest-csv-table_2.13

Filename	Size
scalatest-csv-table_2.13-1.2.1.pom
scalatest-csv-table_2.13-1.2.1-sources.jar	2 KB
scalatest-csv-table_2.13-1.2.1-javadoc.jar	1 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.akiomik/scalatest-csv-table_2.13/ -->
<dependency>
    <groupId>io.github.akiomik</groupId>
    <artifactId>scalatest-csv-table_2.13</artifactId>
    <version>1.2.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.akiomik/scalatest-csv-table_2.13/
implementation 'io.github.akiomik:scalatest-csv-table_2.13:1.2.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.akiomik/scalatest-csv-table_2.13/
implementation ("io.github.akiomik:scalatest-csv-table_2.13:1.2.1")

Apache Buildr

'io.github.akiomik:scalatest-csv-table_2.13:jar:1.2.1'

Apache Ivy

<dependency org="io.github.akiomik" name="scalatest-csv-table_2.13" rev="1.2.1">
  <artifact name="scalatest-csv-table_2.13" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.akiomik', module='scalatest-csv-table_2.13', version='1.2.1')
)

Scala SBT

libraryDependencies += "io.github.akiomik" % "scalatest-csv-table_2.13" % "1.2.1"

Leiningen

[io.github.akiomik/scalatest-csv-table_2.13 "1.2.1"]

Dependencies

compile (4)

Group / Artifact	Type	Version
org.scala-lang : scala-library	jar	2.13.4
org.scalatest : scalatest_2.13	jar	3.2.8
com.nrinaudo : kantan.csv_2.13	jar	0.6.1
com.nrinaudo : kantan.csv-generic_2.13	jar	0.6.1

Project Modules

There are no modules declared in this project.

scalatest-csv-table

A scalatest helper for loading csv files as Table.

Getting started

scalatest-csv-table is currently available for Scala 2.12 and 2.13.

Add the following lines to your build.sbt.

libraryDependencies += "io.github.akiomik" %% "scalatest-csv-table" % "1.2.1" % Test

NOTE: The groupid has been changed from com.github.akiomik to io.github.akiomik because the maven repository has been changed from bintray to sonatype.

All releases

scalatest-csv-table supports some different versions of scalatest.

scalatest-csv-table version	scalatest version	scala version
1.0.2	3.0.x	2.11.x/2.12.x
1.1.0	3.1.x	2.12.x/2.13.x
1.2.1	3.2.x	2.12.x/2.13.x

Basic usage

import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.prop.TableDrivenPropertyChecks._

import com.github.akiomik.scalatest._

class FizzBuzzSpec extends AnyFlatSpec {

  "A FizzBuzz" should "pass tests from a string" in {
    val csv =
      """n,expected
        |1,1
        |2,2
        |3,Fizz
        |4,4
        |5,Buzz""".stripMargin

    val tests = CsvTable.fromString[Int, String](csv)
    forAll (tests) { (n: Int, expected: String) => 
      assert(FizzBuzz(n) == expected)
    }
  }

  "A FizzBuzz" should "pass tests from a file" in {
    val tests = CsvTable.fromFile[Int, String]("src/test/resources/fizzbuzz.csv")
    forAll (tests) { (n: Int, expected: String) => 
      assert(FizzBuzz(n) == expected)
    }
  }

  "A FizzBuzz" should "pass tests from a resource file" in {
    val tests = CsvTable.fromResource[Int, String]("fizzbuzz.csv") // from `src/test/resouces`
    forAll (tests) { (n: Int, expected: String) => 
      assert(FizzBuzz(n) == expected)
    }
  }
}

Using case classes

Use RowDecoder of kantan.csv.

import com.github.akiomik.scalatest._
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.prop.TableDrivenPropertyChecks._
import kantan.csv._

case class Foo(i: Int, s: String, b: Boolean)

class FooSpec extends AnyFlatSpec {
  implicit val decoder = RowDecoder.decoder(0, 1, 2)(Foo.apply _) //

  "A Foo" should "pass tests from a string" in {
    val csv =
      """i,s,b
        |1,a,true
        |2,b,true
        |3,f,false
        |4,e,false
        |5,e,true""".stripMargin

    val tests = CsvTable.fromString[Foo](csv)
    forAll (tests) { (foo: Foo) => 
      // ...
    }
  }
}

Versions

Version
1.2.1 Apr 27, 2021
1.2.0 Apr 25, 2021
1.1.0 Apr 25, 2021