A sister trait to org.scalatest.Spec
that can pass multiple types of fixture objects into its tests.
This trait behaves similarly to trait org.scalatest.Spec
, except that tests may take a fixture object, and unlike
a FixtureSpec
, different tests may take different types of fixtures. This trait extends FixtureSpec
and mixes in ConfigMapFixture
, which defines the Fixture
type to be the configMap
's
type (Map[String, Any]
) and defines the withFixture
method to simply pass the configMap
to the test function. To write tests that take fixtures of types other than Fixture
(i.e.,
Map[String, Any]
), you can define implicit conversions from a function of type (
<the fixture type>) => Unit
to a function of type (FixtureParam) => Unit
. Each implicit conversion method serves as the with-fixture method for that type.
Subclasses of this trait must, therefore, do two things differently from a plain old org.scalatest.FixtureSpec
:
with<type>Fixture
methodsFixture
.)Here's an example that has two fixture types, String
and List[Int]
:
import org.scalatest.fixture.MultipleFixtureSpecclass MySpec extends MultipleFixtureSpec {
// The "with-fixture" method for tests that take a String fixture implicit def withStringFixture(testFunction: String => Unit): FixtureParam => Unit = testFunction("howdy")
// The "with-fixture" method for tests that take a List[Int] fixture implicit def withListFixture(testFunction: List[Int] => Unit): FixtureParam => Unit = configMap => testFunction(List(configMap.size))
// A test that takes a String fixture it("should take a string fixture") { (s: String) => assert(s === "howdy") }
// A test that takes a List[Int] fixture it("should take a list fixture") { (list: List[Int]) => assert(list.size === 1) }
// A test that takes no fixture it("should take no fixture") { () => assert(1 === 1) } }
The first method in this class, withStringFixture
, is the implicit conversion function for tests that take a fixture
of type String
. In this contrived example, the hard-coded string "howdy"
is passed into the test:
implicit def withStringFixture(testFunction: String => Unit): FixtureParam => Unit = testFunction("howdy")
Although the result type of this implicit conversion method is FixtureParam => Unit
, if a fixture doesn't need anything
from the configMap
, you can leave off the configMap =>
at the beginning of the result function. The
reason this works is that MultipleFixtureFeatureSpec
inherits an implicit conversion from a by-name parameter to
FixtureParam => Unit
from supertrait FixtureFeatureSpec
. This implicit conversion is used to enable
tests that take no fixture (such as the one named takes no fixture
in this example) to be included in the
same class as tests that take type Fixture
. That same implicit conversion is used here to allow you to leave off
the configMap =>
except when you actually need something from the configMap
. By leaving it off, you
indicte to readers of the code that this fixture doesn't require anything from the configMap
.
The next method in this class, withListFixture
, is the implicit conversion function for tests that take a
fixture of type List[Int]
. In this contrived example, a List[Int]
that contains one element, the
size of the configMap
, is passed to the test function. Because the fixture uses the configMap
,
it has an explicit configMap =>
parameter at the beginning of the result. (Remember, the Fixture
type is defined to be Map[String, Any]
, the type of the configMap
, in supertrait ConfigMapFixture
.
Following the implicit conversion methods are the test declarations. One test is written to take the String
fixture:
it("should take a string fixture") { (s: String) => assert(s === "howdy") }
What happens at compile time is that because the Fixture
type is Map[String, Any]
, the test
method
should be passed a function from type (Map[String, Any]) => Unit
, or using the type alias, (FixtureParam) => Unit
. Passing
a function of type String => Unit
as is attempted here is a type error. Thus the compiler will look around for an implicit
conversion that will fix the type error, and will find the withStringFixture
method. Because this is the only implicit
conversion that fixes the type error, it will apply it, effectively generating this code:
// after the implicit withStringFixture method is applied by the compiler it("should take a string fixture") { withStringFixture { (s: String) => assert(s === "howdy") } }
After passing the (String) => Unit
function to withStringFixture
, the result will be of
type (FixtureParam) => Unit
, which the test
method expects.
The next test is written to take the List[Int]
fixture:
it("should take a list fixture") { (list: List[Int]) => assert(list.size === 1) }
The compiler will apply the withListFixture
implicit conversion in this case, effectively generating the following
code:
it("should take a list fixture") { withListFixture { (list: List[Int]) => assert(list.size === 1) } }
Note that in a FixtureFeatureSpec
, you need to specify the type of the fixture explicitly so the compiler knows
the type to convert from. So you must, for example, write:
it("should take a list fixture") { (list: List[Int]) => assert(list.size === 1) }
The following attempt will fail to compile:
// won't compile, because list is inferred to be of type FixtureParam it("should take a list fixture") { list => assert(list.size === 1) }
Class used via an implicit conversion to enable any two objects to be compared with
===
in assertions in tests.
The type of the configMap
, which is Map[String, Any]
.
The type of the configMap
, which is Map[String, Any]
.
Assert that an Option[String]
is None
.
Assert that an Option[String]
is None
.
If the condition is None
, this method returns normally.
Else, it throws TestFailedException
with the String
value of the Some
included in the TestFailedException
's
detail message.
This form of assert
is usually called in conjunction with an
implicit conversion to Equalizer
, using a ===
comparison, as in:
assert(a === b)
For more information on how this mechanism works, see the documentation for
Equalizer
.
the Option[String]
to assert
Assert that an Option[String]
is None
.
Assert that an Option[String]
is None
.
If the condition is None
, this method returns normally.
Else, it throws TestFailedException
with the String
value of the Some
, as well as the
String
obtained by invoking toString
on the
specified message
,
included in the TestFailedException
's detail message.
This form of assert
is usually called in conjunction with an
implicit conversion to Equalizer
, using a ===
comparison, as in:
assert(a === b, "extra info reported if assertion fails")
For more information on how this mechanism works, see the documentation for
Equalizer
.
the Option[String]
to assert
An objects whose toString
method returns a message to include in a failure report.
Assert that a boolean condition, described in String
message
, is true.
Assert that a boolean condition, described in String
message
, is true.
If the condition is true
, this method returns normally.
Else, it throws TestFailedException
with the
String
obtained by invoking toString
on the
specified message
as the exception's detail message.
the boolean condition to assert
An objects whose toString
method returns a message to include in a failure report.
Assert that a boolean condition is true.
Assert that a boolean condition is true.
If the condition is true
, this method returns normally.
Else, it throws TestFailedException
.
the boolean condition to assert
Implicit conversion from Any
to Equalizer
, used to enable
assertions with ===
comparisons.
Implicit conversion from Any
to Equalizer
, used to enable
assertions with ===
comparisons.
For more information on this mechanism, see the documentation for </code>Equalizer</code>.
Because trait Suite
mixes in Assertions
, this implicit conversion will always be
available by default in ScalaTest Suite
s. This is the only implicit conversion that is in scope by default in every
ScalaTest Suite
. Other implicit conversions offered by ScalaTest, such as those that support the matchers DSL
or invokePrivate
, must be explicitly invited into your test code, either by mixing in a trait or importing the
members of its companion object. The reason ScalaTest requires you to invite in implicit conversions (with the exception of the
implicit conversion for ===
operator) is because if one of ScalaTest's implicit conversions clashes with an
implicit conversion used in the code you are trying to test, your program won't compile. Thus there is a chance that if you
are ever trying to use a library or test some code that also offers an implicit conversion involving a ===
operator,
you could run into the problem of a compiler error due to an ambiguous implicit conversion. If that happens, you can turn off
the implicit conversion offered by this convertToEqualizer
method simply by overriding the method in your
Suite
subclass, but not marking it as implicit:
// In your Suite subclass override def convertToEqualizer(left: Any) = new Equalizer(left)
the object whose type to convert to Equalizer
.
Executes the test specified as testName
in this Suite
with the specified configMap
, printing
results to the standard output.
Executes the test specified as testName
in this Suite
with the specified configMap
, printing
results to the standard output.
This method implementation calls run
on this Suite
, passing in:
testName
- Some(testName)
reporter
- a reporter that prints to the standard outputstopper
- a Stopper
whose apply
method always returns false
filter
- a Filter
constructed with None
for tagsToInclude
and Set()
for tagsToExclude
configMap
- the specified configMap
Map[String, Any]
distributor
- None
tracker
- a new Tracker
This method serves as a convenient way to execute a single test, passing in some objects via the configMap
, especially from
within the Scala interpreter.
Note: In ScalaTest, the terms "execute" and "run" basically mean the same thing and
can be used interchangably. The reason this convenience method and its three overloaded forms
aren't named run
is described the documentation of the overloaded form that
takes no parameters: execute().
the name of one test to run.
a Map
of key-value pairs that can be used by the executing Suite
of tests.
Executes the test specified as testName
in this Suite
, printing results to the standard output.
Executes the test specified as testName
in this Suite
, printing results to the standard output.
This method implementation calls run
on this Suite
, passing in:
testName
- Some(testName)
reporter
- a reporter that prints to the standard outputstopper
- a Stopper
whose apply
method always returns false
filter
- a Filter
constructed with None
for tagsToInclude
and Set()
for tagsToExclude
configMap
- an empty Map[String, Any]
distributor
- None
tracker
- a new Tracker
This method serves as a convenient way to run a single test, especially from within the Scala interpreter.
Note: In ScalaTest, the terms "execute" and "run" basically mean the same thing and
can be used interchangably. The reason this convenience method and its three overloaded forms
aren't named run
is described the documentation of the overloaded form that
takes no parameters: execute().
the name of one test to run.
Executes this Suite
with the specified configMap
, printing results to the standard output.
Executes this Suite
with the specified configMap
, printing results to the standard output.
This method implementation calls run
on this Suite
, passing in:
testName
- None
reporter
- a reporter that prints to the standard outputstopper
- a Stopper
whose apply
method always returns false
filter
- a Filter
constructed with None
for tagsToInclude
and Set()
for tagsToExclude
configMap
- the specified configMap
Map[String, Any]
distributor
- None
tracker
- a new Tracker
This method serves as a convenient way to execute a Suite
, passing in some objects via the configMap
, especially from within the Scala interpreter.
Note: In ScalaTest, the terms "execute" and "run" basically mean the same thing and
can be used interchangably. The reason this convenience method and its three overloaded forms
aren't named run
is described the documentation of the overloaded form that
takes no parameters: execute().
a Map
of key-value pairs that can be used by the executing Suite
of tests.
Executes this Suite
, printing results to the standard output.
Executes this Suite
, printing results to the standard output.
This method implementation calls run
on this Suite
, passing in:
testName
- None
reporter
- a reporter that prints to the standard outputstopper
- a Stopper
whose apply
method always returns false
filter
- a Filter
constructed with None
for tagsToInclude
and Set()
for tagsToExclude
configMap
- an empty Map[String, Any]
distributor
- None
tracker
- a new Tracker
This method serves as a convenient way to execute a Suite
, especially from
within the Scala interpreter.
Note: In ScalaTest, the terms "execute" and "run" basically mean the same thing and
can be used interchangably. The reason this convenience method and its three overloaded forms
aren't named run
is because junit.framework.TestCase
declares a run
method
that takes no arguments but returns a junit.framework.TestResult
. That
run
method would not overload with this method if it were named run
,
because it would have the same parameters but a different return type than the one
defined in TestCase
. To facilitate integration with JUnit 3, therefore,
these convenience "run" methods are named execute
. In particular, this allows trait
org.scalatest.junit.JUnit3Suite
to extend both org.scalatest.Suite
and
junit.framework.TestCase
, which enables the creating of classes that
can be run with either ScalaTest or JUnit 3.
Expect that the value passed as expected
equals the value passed as actual
.
Expect that the value passed as expected
equals the value passed as actual
.
If the actual
value equals the expected
value
(as determined by ==
), expect
returns
normally. Else, expect
throws an
TestFailedException
whose detail message includes the expected and actual values.
the expected value
the actual value, which should equal the passed expected
value
Expect that the value passed as expected
equals the value passed as actual
.
Expect that the value passed as expected
equals the value passed as actual
.
If the actual
equals the expected
(as determined by ==
), expect
returns
normally. Else, if actual
is not equal to expected
, expect
throws an
TestFailedException
whose detail message includes the expected and actual values, as well as the String
obtained by invoking toString
on the passed message
.
the expected value
An object whose toString
method returns a message to include in a failure report.
the actual value, which should equal the passed expected
value
The total number of tests that are expected to run when this Suite
's run
method is invoked.
The total number of tests that are expected to run when this Suite
's run
method is invoked.
This trait's implementation of this method returns the sum of:
testNames
List
, minus the number of tests marked as ignoredexpectedTestCount
on every nested Suite
contained in
nestedSuites
a Filter
with which to filter tests to count based on their tags
Throws TestFailedException
, with the passed
Throwable
cause, to indicate a test failed.
Throws TestFailedException
, with the passed
Throwable
cause, to indicate a test failed.
The getMessage
method of the thrown TestFailedException
will return cause.toString()
.
a Throwable
that indicates the cause of the failure.
Throws TestFailedException
, with the passed
String
message
as the exception's detail
message and Throwable
cause, to indicate a test failed.
Throws TestFailedException
, with the passed
String
message
as the exception's detail
message and Throwable
cause, to indicate a test failed.
A message describing the failure.
A Throwable
that indicates the cause of the failure.
Throws TestFailedException
, with the passed
String
message
as the exception's detail
message, to indicate a test failed.
Throws TestFailedException
, with the passed
String
message
as the exception's detail
message, to indicate a test failed.
A message describing the failure.
Throws TestFailedException
to indicate a test failed.
Throws TestFailedException
to indicate a test failed.
The groups
methods has been deprecated and will be removed in a future version of ScalaTest.
The groups
methods has been deprecated and will be removed in a future version of ScalaTest.
Please call (and override) tags
instead.
Intercept and return an exception that's expected to be thrown by the passed function value.
Intercept and return an exception that's expected to
be thrown by the passed function value. The thrown exception must be an instance of the
type specified by the type parameter of this method. This method invokes the passed
function. If the function throws an exception that's an instance of the specified type,
this method returns that exception. Else, whether the passed function returns normally
or completes abruptly with a different exception, this method throws TestFailedException
.
Note that the type specified as this method's type parameter may represent any subtype of
AnyRef
, not just Throwable
or one of its subclasses. In
Scala, exceptions can be caught based on traits they implement, so it may at times make sense
to specify a trait that the intercepted exception's class must mix in. If a class instance is
passed for a type that could not possibly be used to catch an exception (such as String
,
for example), this method will complete abruptly with a TestFailedException
.
the function value that should throw the expected exception
an implicit Manifest
representing the type of the specified
type parameter.
the intercepted exception, if it is of the expected type
A List
of this Suite
object's nested Suite
s. If this Suite
contains no nested Suite
s,
this method returns an empty List
. This trait's implementation of this method returns an empty List
.
A List
of this Suite
object's nested Suite
s. If this Suite
contains no nested Suite
s,
this method returns an empty List
. This trait's implementation of this method returns an empty List
.
Throws TestPendingException
to indicate a test is pending.
Throws TestPendingException
to indicate a test is pending.
A pending test is one that has been given a name but is not yet implemented. The purpose of pending tests is to facilitate a style of testing in which documentation of behavior is sketched out before tests are written to verify that behavior (and often, the before the behavior of the system being tested is itself implemented). Such sketches form a kind of specification of what tests and functionality to implement later.
To support this style of testing, a test can be given a name that specifies one
bit of behavior required by the system being tested. The test can also include some code that
sends more information about the behavior to the reporter when the tests run. At the end of the test,
it can call method pending
, which will cause it to complete abruptly with TestPendingException
.
Because tests in ScalaTest can be designated as pending with TestPendingException
, both the test name and any information
sent to the reporter when running the test can appear in the report of a test run. (In other words,
the code of a pending test is executed just like any other test.) However, because the test completes abruptly
with TestPendingException
, the test will be reported as pending, to indicate
the actual test, and possibly the functionality it is intended to test, has not yet been implemented.
Note: This method always completes abruptly with a TestPendingException
. Thus it always has a side
effect. Methods with side effects are usually invoked with parentheses, as in pending()
. This
method is defined as a parameterless method, in flagrant contradiction to recommended Scala style, because it
forms a kind of DSL for pending tests. It enables tests in suites such as FunSuite
or Spec
to be denoted by placing "(pending)
" after the test name, as in:
test("that style rules are not laws") (pending)
Readers of the code see "pending" in parentheses, which looks like a little note attached to the test name to indicate
it is pending. Whereas "(pending())
looks more like a method call, "(pending)
" lets readers
stay at a higher level, forgetting how it is implemented and just focusing on the intent of the programmer who wrote the code.
Execute the passed block of code, and if it completes abruptly, throw TestPendingException
, else
throw TestFailedException
.
Execute the passed block of code, and if it completes abruptly, throw TestPendingException
, else
throw TestFailedException
.
This method can be used to temporarily change a failing test into a pending test in such a way that it will
automatically turn back into a failing test once the problem originally causing the test to fail has been fixed.
At that point, you need only remove the pendingUntilFixed
call. In other words, a
pendingUntilFixed
surrounding a block of code that isn't broken is treated as a test failure.
The motivation for this behavior is to encourage people to remove pendingUntilFixed
calls when
there are no longer needed.
This method facilitates a style of testing in which tests are written before the code they test. Sometimes you may
encounter a test failure that requires more functionality than you want to tackle without writing more tests. In this
case you can mark the bit of test code causing the failure with pendingUntilFixed
. You can then write more
tests and functionality that eventually will get your production code to a point where the original test won't fail anymore.
At this point the code block marked with pendingUntilFixed
will no longer throw an exception (because the
problem has been fixed). This will in turn cause pendingUntilFixed
to throw TestFailedException
with a detail message explaining you need to go back and remove the pendingUntilFixed
call as the problem orginally
causing your test code to fail has been fixed.
a block of code, which if it completes abruptly, should trigger a TestPendingException
Runs this suite of tests.
Runs this suite of tests.
If testName
is None
, this trait's implementation of this method
calls these two methods on this object in this order:
runNestedSuites(report, stopper, tagsToInclude, tagsToExclude, configMap, distributor)
runTests(testName, report, stopper, tagsToInclude, tagsToExclude, configMap)
If testName
is defined, then this trait's implementation of this method
calls runTests
, but does not call runNestedSuites
. This behavior
is part of the contract of this method. Subclasses that override run
must take
care not to call runNestedSuites
if testName
is defined. (The
OneInstancePerTest
trait depends on this behavior, for example.)
Subclasses and subtraits that override this run
method can implement them without
invoking either the runTests
or runNestedSuites
methods, which
are invoked by this trait's implementation of this method. It is recommended, but not required,
that subclasses and subtraits that override run
in a way that does not
invoke runNestedSuites
also override runNestedSuites
and make it
final. Similarly it is recommended, but not required,
that subclasses and subtraits that override run
in a way that does not
invoke runTests
also override runTests
(and runTest
,
which this trait's implementation of runTests
calls) and make it
final. The implementation of these final methods can either invoke the superclass implementation
of the method, or throw an UnsupportedOperationException
if appropriate. The
reason for this recommendation is that ScalaTest includes several traits that override
these methods to allow behavior to be mixed into a Suite
. For example, trait
BeforeAndAfterEach
overrides runTests
s. In a Suite
subclass that no longer invokes runTests
from run
, the
BeforeAndAfterEach
trait is not applicable. Mixing it in would have no effect.
By making runTests
final in such a Suite
subtrait, you make
the attempt to mix BeforeAndAfterEach
into a subclass of your subtrait
a compiler error. (It would fail to compile with a complaint that BeforeAndAfterEach
is trying to override runTests
, which is a final method in your trait.)
an optional name of one test to run. If None
, all relevant tests should be run.
I.e., None
acts like a wildcard that means run all relevant tests in this Suite
.
the Reporter
to which results will be reported
the Stopper
that will be consulted to determine whether to stop execution early.
a Filter
with which to filter tests based on their tags
a Map
of key-value pairs that can be used by the executing Suite
of tests.
an optional Distributor
, into which to put nested Suite
s to be run
by another entity, such as concurrently by a pool of threads. If None
, nested Suite
s will be run sequentially.
a Tracker
tracking Ordinal
s being fired by the current thread.
A user-friendly suite name for this Suite
.
A user-friendly suite name for this Suite
.
This trait's
implementation of this method returns the simple name of this object's class. This
trait's implementation of runNestedSuites
calls this method to obtain a
name for Report
s to pass to the suiteStarting
, suiteCompleted
,
and suiteAborted
methods of the Reporter
.
this Suite
object's suite name.
A Map
whose keys are String
tag names to which tests in this Spec
belong, and values
the Set
of test names that belong to each tag. If this Spec
contains no tags, this method returns an empty Map
.
A Map
whose keys are String
tag names to which tests in this Spec
belong, and values
the Set
of test names that belong to each tag. If this Spec
contains no tags, this method returns an empty Map
.
This trait's implementation returns tags that were passed as strings contained in Tag
objects passed to
methods test
and ignore
.
An immutable Set
of test names. If this FixtureFeatureSpec
contains no tests, this method returns an
empty Set
.
An immutable Set
of test names. If this FixtureFeatureSpec
contains no tests, this method returns an
empty Set
.
This trait's implementation of this method will return a set that contains the names of all registered tests. The set's iterator will return those names in the order in which the tests were registered. Each test's name is composed of the concatenation of the text of each surrounding describer, in order from outside in, and the text of the example itself, with all components separated by a space.
Executes the block of code passed as the second parameter, and, if it
completes abruptly with a ModifiableMessage
exception,
prepends the "clue" string passed as the first parameter to the beginning of the detail message
of that thrown exception, then rethrows it.
Executes the block of code passed as the second parameter, and, if it
completes abruptly with a ModifiableMessage
exception,
prepends the "clue" string passed as the first parameter to the beginning of the detail message
of that thrown exception, then rethrows it. If clue does not end in a white space
character, one space will be added
between it and the existing detail message (unless the detail message is
not defined).
This method allows you to add more information about what went wrong that will be reported when a test fails. Here's an example:
withClue("(Employee's name was: " + employee.name + ")") { intercept[IllegalArgumentException] { employee.getTask(-1) } }
If an invocation of intercept
completed abruptly with an exception, the resulting message would be something like:
(Employee's name was Bob Jones) Expected IllegalArgumentException to be thrown, but no exception was thrown
Invoke the test function, passing to the the test function the configMap
obtained by invoking configMap
on the passed OneArgTest
.
Invoke the test function, passing to the the test function the configMap
obtained by invoking configMap
on the passed OneArgTest
.
A sister trait to
org.scalatest.Spec
that can pass multiple types of fixture objects into its tests.This trait behaves similarly to trait
org.scalatest.Spec
, except that tests may take a fixture object, and unlike aFixtureSpec
, different tests may take different types of fixtures. This trait extendsFixtureSpec
and mixes inConfigMapFixture
, which defines theFixture
type to be theconfigMap
's type (Map[String, Any]
) and defines thewithFixture
method to simply pass theconfigMap
to the test function. To write tests that take fixtures of types other thanFixture
(i.e.,Map[String, Any]
), you can define implicit conversions from a function of type(
<the fixture type>) => Unit
to a function of type(FixtureParam) => Unit
. Each implicit conversion method serves as the with-fixture method for that type.Subclasses of this trait must, therefore, do two things differently from a plain old
org.scalatest.FixtureSpec
:with<type>Fixture
methodsFixture
.)Here's an example that has two fixture types,
String
andList[Int]
:The first method in this class,
withStringFixture
, is the implicit conversion function for tests that take a fixture of typeString
. In this contrived example, the hard-coded string"howdy"
is passed into the test:Although the result type of this implicit conversion method is
FixtureParam => Unit
, if a fixture doesn't need anything from theconfigMap
, you can leave off theconfigMap =>
at the beginning of the result function. The reason this works is thatMultipleFixtureFeatureSpec
inherits an implicit conversion from a by-name parameter toFixtureParam => Unit
from supertraitFixtureFeatureSpec
. This implicit conversion is used to enable tests that take no fixture (such as the one namedtakes no fixture
in this example) to be included in the same class as tests that take typeFixture
. That same implicit conversion is used here to allow you to leave off theconfigMap =>
except when you actually need something from theconfigMap
. By leaving it off, you indicte to readers of the code that this fixture doesn't require anything from theconfigMap
.The next method in this class,
withListFixture
, is the implicit conversion function for tests that take a fixture of typeList[Int]
. In this contrived example, aList[Int]
that contains one element, the size of theconfigMap
, is passed to the test function. Because the fixture uses theconfigMap
, it has an explicitconfigMap =>
parameter at the beginning of the result. (Remember, theFixture
type is defined to beMap[String, Any]
, the type of theconfigMap
, in supertraitConfigMapFixture
.Following the implicit conversion methods are the test declarations. One test is written to take the
String
fixture:What happens at compile time is that because the
Fixture
type isMap[String, Any]
, thetest
method should be passed a function from type(Map[String, Any]) => Unit
, or using the type alias,(FixtureParam) => Unit
. Passing a function of typeString => Unit
as is attempted here is a type error. Thus the compiler will look around for an implicit conversion that will fix the type error, and will find thewithStringFixture
method. Because this is the only implicit conversion that fixes the type error, it will apply it, effectively generating this code:After passing the
(String) => Unit
function towithStringFixture
, the result will be of type(FixtureParam) => Unit
, which thetest
method expects.The next test is written to take the
List[Int]
fixture:The compiler will apply the
withListFixture
implicit conversion in this case, effectively generating the following code:Note that in a
FixtureFeatureSpec
, you need to specify the type of the fixture explicitly so the compiler knows the type to convert from. So you must, for example, write:The following attempt will fail to compile: