Comment exécuter des cas de test JUnit à partir de la ligne de commande

Je voudrais exécuter des cas de test JUnit à partir de la ligne de commande. Comment puis-je faire ceci?

Pour JUnit 5.x, c'est:

java -jar junit-platform-console-standalone-<version>.jar <Options>

Trouvez un bref résumé sur https://stackoverflow.com/a/52373592/1431016 et tous les détails sur https://junit.org/junit5/docs/current/user-guide/#running-tests-console-launcher

Pour JUnit 4.X, c'est vraiment:

java -cp .:/usr/share/java/junit.jar org.junit.runner.JUnitCore [test class name]

Mais si vous utilisez JUnit 3.X, notez que le nom de la classe est différent:

java -cp .:/usr/share/java/junit.jar junit.textui.TestRunner [test class name]

Vous devrez peut-être ajouter d'autres fichiers JAR ou répertoires avec vos fichiers de classe au chemin de classe et les séparer avec des points-virgules (Windows) ou des deux-points (UNIX / Linux). Cela dépend de votre environnement.

Edit: j'ai ajouté le répertoire actuel comme exemple. Cela dépend de votre environnement et de la façon dont vous construisez votre application (peut être bin / ou build / ou même my_application.jar, etc.). Remarque Java 6+ prend en charge les globes dans classpath, vous pouvez faire:

java -cp lib/*.jar:/usr/share/java/junit.jar ...

J'espère que ça aide. Écrivez des tests! :-)

Chemin Maven

Si vous utilisez Maven, vous pouvez exécuter la commande suivante pour exécuter tous vos cas de test:

mvn clean test

Ou vous pouvez exécuter un test particulier comme ci-dessous

mvn clean test -Dtest=your.package.TestClassName
mvn clean test -Dtest=your.package.TestClassName#particularMethod

Si vous souhaitez voir la trace de la pile (le cas échéant) dans la console au lieu des fichiers de rapport dans le dossier target \ surefire-reports, définissez la propriété utilisateur surefire.useFile sur false. Par exemple:

mvn clean test -Dtest=your.package.TestClassName -Dsurefire.useFile=false

Façon Gradle

Si vous utilisez Gradle, vous pouvez exécuter la commande suivante pour exécuter tous vos cas de test:

gradle test

Ou vous pouvez exécuter un test particulier comme ci-dessous

gradle test --tests your.package.TestClassName
gradle test --tests your.package.TestClassName.particularMethod

Si vous souhaitez plus d'informations, vous pouvez envisager des options telles que --stacktrace, ou --info ou --debug.

Par exemple, lorsque vous exécutez Gradle avec le niveau d'enregistrement d'informations --info, il vous montrera le résultat de chaque test pendant leur exécution. S'il y a une exception, il vous montrera la trace de la pile, indiquant le problème.

gradle test --info

Si vous souhaitez voir les résultats globaux du test, vous pouvez par exemple ouvrir le rapport dans le navigateur (ouvrez-le à l'aide de Google Chrome dans Ubuntu):

google-chrome build/reports/tests/index.html

Fourmi façon

Une fois que vous avez configuré votre fichier de génération Ant build.xml, vous pouvez exécuter vos cas de test JUnit à partir de la ligne de commande comme ci-dessous:

ant -f build.xml <Your JUnit test target name>

Vous pouvez suivre le lien ci-dessous pour en savoir plus sur la configuration des tests JUnit dans le fichier de génération Ant: https://ant.apache.org/manual/Tasks/junit.html

Voie normale

Si vous n'utilisez pas Maven, Gradle ou Ant, vous pouvez suivre la procédure suivante:

Tout d'abord, vous devez compiler vos cas de test. Par exemple (sous Linux):

javac -d /absolute/path/for/compiled/classes -cp /absolute/path/to/junit-4.12.jar /absolute/path/to/TestClassName.java

Exécutez ensuite vos cas de test. Par exemple:

java -cp /absolute/path/for/compiled/classes:/absolute/path/to/junit-4.12.jar:/absolute/path/to/hamcrest-core-1.3.jar org.junit.runner.JUnitCore your.package.TestClassName

La réponse donnée par @lzap est une bonne solution. Cependant, je voudrais ajouter que vous devriez ajouter. dans le chemin d'accès aux classes, afin que votre répertoire actuel ne soit pas ignoré, ce qui entraînera la suppression de vos propres classes. Cela m'est arrivé sur certaines plateformes. Une version mise à jour pour JUnit 4.x serait donc:

java -cp .:/usr/share/java/junit.jar org.junit.runner.JUnitCore [test class name]

Assurez-vous que JUnit.jar se trouve dans votre chemin de classe, puis appelez le programme d'exécution de ligne de commande à partir de la console

java org.junit.runner.JUnitCore [nom de la classe de test]

Référence: junit FAQ

Avec JUnit 4.12, ce qui suit ne fonctionnait pas pour moi:

java -cp .:/usr/share/java/junit.jar org.junit.runner.JUnitCore [test class name]

Apparemment , à partir de JUnit 4.11, vous devriez également inclure hamcrest-core.jardans votre chemin de classe:

java -cp .:/usr/share/java/junit.jar:/usr/share/java/hamcrest-core.jar org.junit.runner.JUnitCore [test class name]

Dans les fenêtres, c'est

java -cp .;/path/junit.jar org.junit.runner.JUnitCore TestClass [nom de la classe de test sans extension .class]

par exemple: c:\>java -cp .;f:/libraries/junit-4.8.2 org.junit.runner.JUnitCore TestSample1 TestSample2 ... et ainsi de suite, si l'on a plus d'une classe de test.

-cp représente le chemin de classe et le point (.) représente le chemin de classe existant tandis que le point-virgule (;) ajoute le pot supplémentaire donné au chemin de classe, comme dans l'exemple ci-dessus junit-4.8.2 est maintenant disponible dans classpath pour exécuter la classe JUnitCore qui ici, nous avons utilisé pour exécuter nos classes de test.

L'instruction de ligne de commande ci-dessus vous aide à exécuter des tests junit (version 4+) à partir de l'invite de commande (c'est-à-dire MSDos).

Remarque: JUnitCore est une façade pour exécuter des tests de junit, cette façade est incluse dans 4+ versions de junit.

En fait, vous pouvez également faire du test Junit un pot exécutable et appeler le pot exécutable en tant que java -jar

Si votre projet est basé sur Maven, vous pouvez exécuter toutes les méthodes de test de la classe de test CustomTest qui appartient au module 'my-module' en utilisant la commande suivante:

mvn clean test -pl :my-module -Dtest=CustomTest

Ou exécutez une seule méthode de test myMethod à partir de la classe de test CustomTest à l'aide de la commande suivante:

mvn clean test -pl :my-module -Dtest=CustomTest#myMethod

Pour cette capacité, vous avez besoin du plug-in Maven Surefire v.2.7.3 + et Junit 4. Plus de détails sont ici: http://maven.apache.org/surefire/maven-surefire-plugin/examples/single-test.html

Personnellement, j'utiliserais le runner Maven surefire JUnit pour le faire.

Vous pouvez également utiliser les méthodes suivantes dans la classe JunitCore http://junit.sourceforge.net/javadoc/org/junit/runner/JUnitCore.html

exécutez (avec Request, Class classes et Runner) ou runClasses à partir de votre fichier java.

Si votre projet est basé sur une fourmi, vous devriez pouvoir faire quelque chose comme ça depuis la console:

ant test

Si cela ne fonctionne pas, mais que votre projet est basé sur des fourmis, vous pouvez exécuter ant -ppour répertorier les principales cibles du projet.