TegralSubjectTest

Base class for testing Tegral DI-applications.

The basic idea behind this class is to provide testing facilities around a single "subject". Let's say we wanted to test a service and its interactivity with a repository. Our subject here would be the service.

The class itself provides a wrapper around an UnsafeMutableEnvironment that is well-suited for test scenarios.

Here is what a typical use of this class could look like, with the MockK library for mocking our repository.

// Main code
interface Repository {
    fun storeThis(text: String)
}

class Service(scope: InjectionScope) {
    private val repository: Repository by scope()

    fun incomingText(text: String) {
        // ...
        repository.storeThis(text)
        // ...
    }
}

// Test code
class TestService : TegralDiBaseTest<Service>(::Service) {
    @Test
    fun `Accepts incoming text properly`() = test {
        put<Repository> {
            mockk { every { storeThis("hello") } just runs }
        }

        subject.incomingText("hello")

        verify { get<Repository>().storeThis("hello") }
    }
}

The class defines the environment using a base module that usually only contains the test subject's entry, but may also contain additional dependencies as you see fit. Refer to the different constructors for more information.

Parameters