51369b610e
When an include is not surrounded by empty lines, its content is inlined on the same line as the adjacent content. That can lead to broken tags and other display issues. This PR fixes all such includes and introduces a validation step that forbids introducing the same problem again.
51 lines
1.0 KiB
Plaintext
51 lines
1.0 KiB
Plaintext
== Why is this an issue?
|
|
|
|
When verifying that code raises an exception, a good practice is to avoid having multiple method calls inside the tested code, to be explicit about what is exactly tested.
|
|
|
|
When two of the methods can raise the same exception, not respecting this good practice is a bug, since it is not possible to know what is really tested.
|
|
|
|
=== Noncompliant code example
|
|
|
|
[source,php]
|
|
----
|
|
public function testSomething()
|
|
{
|
|
try {
|
|
g(y(1)); // Noncompliant
|
|
$this->fail('RuntimeException is not thrown');
|
|
} catch (RuntimeException $e) {}
|
|
}
|
|
----
|
|
|
|
=== Compliant solution
|
|
|
|
[source,php]
|
|
----
|
|
public function testSomething()
|
|
{
|
|
$y = y(1);
|
|
try {
|
|
g($y);
|
|
$this->fail('RuntimeException is not thrown by g()');
|
|
} catch (RuntimeException $e) {}
|
|
}
|
|
----
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
include::../message.adoc[]
|
|
|
|
include::../highlighting.adoc[]
|
|
|
|
'''
|
|
== Comments And Links
|
|
(visible only on this page)
|
|
|
|
include::../comments-and-links.adoc[]
|
|
|
|
endif::env-github,rspecator-view[]
|