sbt-doctest
Plugin for sbt that generates tests from examples in ScalaDoc.
Install
To use this plugin, add it to your project/plugins.sbt,
addSbtPlugin("com.github.tkawachi" % "sbt-doctest" % "0.3.3")and add the following settings to your build.sbt.
doctestSettingsUsing ScalaTest or specs2
This plugin generates tests for ScalaCheck by default. If you use ScalaTest or specs2,
set doctestTestFramework to DoctestTestFramework.ScalaTest or DoctestTestFramework.Specs2 in build.sbt.
Then it will generate tests for the specified framework.
// To generate tests for ScalaTest
doctestTestFramework := DoctestTestFramework.ScalaTest
// Or specify DoctestTestFramework.Specs2 or DoctestTestFramework.ScalaCheckNote for libraryDependencies
doctestSettings adds specific version of testing libraries to libraryDependencies.
Set doctestWithDependencies to false when you explicitly specify testing library dependencies in build.sbt.
doctestWithDependencies := false
libraryDependencies ++= Seq(
"org.scalatest" %% "scalatest" % "2.2.0" % "test",
"org.scalacheck" %% "scalacheck" % "1.11.4" % "test"
// And other library dependencies.
)Usage
sbt-doctest will generate tests from
doctests in ScalaDoc comments. These tests are automatically generated and
run when sbt's test task is invoked.
Here is an example that shows the different doctest styles that are supported by the plugin:
object Test {
/**
* A sample function.
*
* {{{
* # Python style
* >>> Test.f(10)
* 20
*
* # Scala REPL style
* scala> Test.f(20)
* res1: Int = 40
*
* # Property based test
* prop> (i: Int) => Test.f(i) == (i * 2)
* }}}
*/
def f(x: Int) = x + x
}It also supports multi-line inputs:
/**
* {{{
* # Python style
* >>> Test.f(
* ... 10
* ... )
* 20
*
* # Scala REPL style
* scala> Test.f(
* | 20
* | )
* res1: Int = 40
*
* # Property based test
* prop> (i: Int) =>
* | Test.f(i) == (i * 2)
* }}}
*/
def f(x: Int) = x + xPlease use <BLANKLINE> when an output contains blank lines.
/**
* {{{
* # Python style
* >>> Test.helloWorld
* Hello
* <BLANKLINE>
* World
*
* # Scala REPL style
* scala> Test.helloWorld
* res0: String =
* Hello
* <BLANKLINE>
* World
* }}}
*/
def helloWorld = "Hello\n\nWorld"License
MIT
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent