mureinik opened a new pull request #23: FILEUPLOAD-302: JUnit Jupiter migration
URL: https://github.com/apache/commons-fileupload/pull/23
 
 
   This PR upgrades the project's testing framework from JUnit 4.12 to the 
modern JUnit Jupiter 5.5.2.
   
   Since JUnit 5 Jupiter is not backwards compatible to JUnit 4.x (or even 
JUnit Vintage), this PR is a bit large, even though most of the changes are 
merely cosmetic (such as changing the argument order,
   see details below). In order to make the reviewer's task as easy as 
possible, this PR does not presume to use JUnit Jupiter's best practices and 
all its new functionality, but only to migrate the
   existing tests with as little change as possible. Following PRs may want to 
improve the tests by using some of JUnit Jupiter's new features.
   
   This PR includes the following changes:
   
   1. Maven dependency changes:
        1. `junit:junit` was replaced with `org.junit.jupiter:junit-jupiter`.
   
   2. Annotations:
        1. `org.junit.jupiter.api.Test` was used as a drop in replacement for 
`org.juit.Test` without arguments. See 3.i. for handling of `@Test` annotations 
with an `expected` argument.
        1. `org.junit.jupiter.api.BeforeEach` was used as an drop in 
replacement for `org.junit.Before`.
        1. `org.junit.jupiter.api.AfterEach` was used as an drop in replacement 
for `org.junit.After`.
   
   3. Assertions:
        1. `org.junit.jupiter.api.Assertions`' methods were used as drop in 
replacements for `org.junit.Assert`'s methods with the same name in the simple 
case of an assertion without a message. In the case of an assertion with a 
message, `org.junit.jupiter.api.Assertions`' methods were used, but the 
argument order was changed - `Assert`'s methods take the message as the first 
argument, while `Assertions`' methods take the message as the last argument.
        1. `org.junit.jupiter.api.Assertions`' methods were used as drop in 
replacements for `junit.framework.TestCase`'s methods with the same name in the 
simple case of an assertion without a message.
        1. `org.junit.jupiter.api.Assertions#assertThrows` was used to assert 
that a specific exception was throws instead of an `org.junit.Test` annotation 
with an `expected` argument. As a side bonus, this change makes the tests 
slightly stricter, as now they can assert the exception was thrown from a 
specific line and prevent false positives where the test's "set-up" code 
accidentally threw that exception.
   
   
   4. Parameterized tests:
        1. `FileUploadTest` was rewritten with `@ParameterizedTest` and 
`@MethodSource` in order to gain an equivalent functionality of JUnit 4's 
`Parameterized` runner.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


With regards,
Apache Git Services

Reply via email to