Testing
Testability is very important
Skinny Framework puts emphasis on testable application development and provides toolkit for testing.
How to run tests
Simply use skinny command or sbt directly.
# run all the tests
./skinny test
# run single test
./skinny testOnly model.MemberSpec
# run only failed tests
./skinny testQuick
# run multiple tests under controller package when changes are detected
./skinny ~testOnly controller.*Spec
ORM Tests
Here is some examples:
https://github.com/skinny-framework/skinny-framework/tree/master/orm/src/test/scala/blog
package model
import org.joda.time._
import org.scalatest._
import org.scalatest.fixture.FunSpec
import skinny._
import skinny.test._
import scalikejdbc._
import scalikejdbc.scalatest._
class MemberSpec extends FunSpec with AutoRollback with Matchers with DBSettings {
override def fixture(implicit session: DBSession) {
// do fixtures stuff
}
describe("Member") {
it("should find all entities") { implicit session =>
Member.findAll().size should be >(0)
}
}
}
NOTICE: AllRollback feature is supported by ScalikeJDBC. And this trait is incompatible with ScalaTest 2.x. Furthermore, Scalatra 2.2.x is also incompatible with ScalaTest 2.x. If you’d like to use ScalaTest 2.x, use Scalatra 2.3.0.RC1 and ScalikeJDBC 2.0.0-SNAPSHOT for now (This situation will be fixed in Skinny 1.1).
Mocked Controller Tests
Skinny provides MockController trait for light-weight controller tests.
package controller
class RootController extends ApplicationController {
def index = render("/root/index")
}
import org.scalatest._
import skinny.DBSettings
import skinny.test.MockController
class RootControllerSpec extends FunSpec with Matchers with DBSettings {
describe("RootController") {
it("shows top page") {
val controller = new RootController with MockController
controller.index
controller.contentType should equal("text/html; charset=utf-8")
controller.renderCall.map(_.path) should equal(Some("/root/index"))
}
}
}
Be aware of following points when you use MockController:
MockController cannot handle org.scalatra.HaltException
HaltException is very exceptional operation by Scalatra. HaltException is not an Exception but a Throwable. Furthermore, it mutes all the stack traces.
When you call halt method or redirect method, HaltException will be thrown.
We recommend you using redirect302 instead because it is excellent with MockController testing.
Integration Tests
Scalatra provides a great test toolkit with embedded Jetty server and easy-to-use DSL. Of course, you can use them without any problem.
Below is an integration test example with scalatra-test.
package integrationtest
import org.scalatra.test.scalatest._
import skinny.DBSettings
import skinny.test.SkinnyTestSupport
import _root_.controller.Controllers
import org.scalatest._
class IntegrationTestSpec extends ScalatraFlatSpec with Matchers with SkinnyTestSupport with DBSettings {
addFilter(Controllers.members, "/*")
it should "show index page" in {
withSession("userId" -> "Alice") {
get("/members") {
status should equal(200)
body should contain("something")
}
}
}
}
Coverage Report
If you need a code coverage report, use coverage test instead.
https://github.com/scoverage/sbt-scoverage
./skinny test:coverage
More Examples
It’s the fastest way to learn is seeing generated tests by scaffold command.
And also some examples here may be helpful for you:
See also: FactoryGirl