Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openliberty/arquillian-liberty-dependencies
The Liberty dependency bundles for Arquillian make it easy for you to manage versions for your Arquillian installation, the Arquillian Liberty Managed and Remote containers, and JUnit and TestNG libraries.
https://github.com/openliberty/arquillian-liberty-dependencies
Last synced: 2 months ago
JSON representation
The Liberty dependency bundles for Arquillian make it easy for you to manage versions for your Arquillian installation, the Arquillian Liberty Managed and Remote containers, and JUnit and TestNG libraries.
- Host: GitHub
- URL: https://github.com/openliberty/arquillian-liberty-dependencies
- Owner: OpenLiberty
- License: apache-2.0
- Created: 2018-01-26T17:28:14.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T21:23:56.000Z (2 months ago)
- Last Synced: 2024-10-24T09:43:04.244Z (2 months ago)
- Language: Java
- Homepage:
- Size: 287 KB
- Stars: 2
- Watchers: 6
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arquillian Liberty Dependencies [](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22io.openliberty.arquillian%22%20AND%20a%3A%22arquillian-liberty-jakarta-dependencies%22) [](https://github.com/OpenLiberty/arquillian-liberty-dependencies/actions?branch=main) [](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22io.openliberty.arquillian%22%20AND%20a%3A%22arquillian-liberty-dependencies%22) [](https://github.com/OpenLiberty/arquillian-liberty-dependencies/actions?branch=1.x-maintenance)
The Liberty dependency bundles for Arquillian make it easy for you to manage versions for your Arquillian installation, the Arquillian Liberty Managed and Remote containers, and JUnit and TestNG libraries.
## Dependencies
In this repository, you'll find 6 artifacts that you can use in your Maven and Gradle projects with Jakarta EE 9 and 10. They are:
- `io.openliberty.arquillian:arquillian-liberty-managed-jakarta-junit` for using the Arquillian Liberty Managed container with JUnit
- `io.openliberty.arquillian:arquillian-liberty-managed-jakarta-junit5` for using the Arquillian Liberty Managed container with JUnit5
- `io.openliberty.arquillian:arquillian-liberty-managed-jakarta-testng` for using the Arquillian Liberty Managed container with TestNG
- `io.openliberty.arquillian:arquillian-liberty-remote-jakarta-junit` for using the Arquillian Liberty Remote container with JUnit
- `io.openliberty.arquillian:arquillian-liberty-remote-jakarta-junit5` for using the Arquillian Liberty Remote container with JUnit5
- `io.openliberty.arquillian:arquillian-liberty-remote-jakarta-testng` for using the Arquillian Liberty Remote container with TestNG
For Java EE 8 or below, the following 4 artifacts are available:
- `io.openliberty.arquillian:arquillian-liberty-managed-junit` for using the Arquillian Liberty Managed container with JUnit
- `io.openliberty.arquillian:arquillian-liberty-managed-testng` for using the Arquillian Liberty Managed container with TestNG
- `io.openliberty.arquillian:arquillian-liberty-remote-junit` for using the Arquillian Liberty Remote container with JUnit
- `io.openliberty.arquillian:arquillian-liberty-remote-testng` for using the Arquillian Liberty Remote container with TestNG
## Usage
**Notice:** There is currently a known issue with false positives test results when using certain versions of Arquillian with TestNG. [Here](docs/testng-false-positives.md) is more information about the issue and a fix.
### Maven
In order to prevent dependency conflicts, you'll need to use the `arquillian-bom` in conjunction with a dependency bundle. While the `arquillian-liberty-dependencies` parent POM already contains the `arquillian-bom`, this is used only to build the dependency bundle artifacts and will not be applied to your project when you include them. The version of the `arquillian-bom` that you specify will apply to transitive dependencies of your project.
**Jakarta EE 9 and 10 example:**
```
org.jboss.arquillian
arquillian-bom
1.9.1.Final
import
pom
org.jboss.arquillian.jakarta
arquillian-jakarta-bom
10.0.0.Final
import
pom
...
io.openliberty.arquillian
arquillian-liberty-managed-jakarta-junit
3.0.0
pom
test
...
```
**Java EE 8 or below example:**
```
org.jboss.arquillian
arquillian-bom
1.1.13.Final
import
pom
...
io.openliberty.arquillian
arquillian-liberty-managed-junit
1.0
pom
test
...
```
You can use the command `mvn dependency:list` to view transitive dependencies and their versions.
A complete Maven example, used as an integration test for this repository, is available in the `it/managed-tests` folder.
### Gradle
Unlike in Maven, the `arquillian-bom` is not required in Gradle in order to prevent dependency conflicts. When you add a dependency bundle artifact to your Gradle build, Gradle will resolve artifacts versions for transitive dependencies of the bundle using the `arquillian-bom` specified in the `arquillian-liberty-dependencies` parent POM. As of version `1.0`, the `arquillian-bom` version is set to `1.2.0`.
If you want to override the version of `arquillian-bom` specified in the `arquillian-liberty-dependencies` parent POM, you'll need to use Spring's [`dependency-management-plugin`](https://spring.io/blog/2015/02/23/better-dependency-management-for-gradle) to get Gradle to read and understand BOMs.
**Using the `dependency-management-plugin`:**
Step 1: Add the plugin as a buildscript dependency:
```
buildscript {
...
dependencies {
...
classpath "io.spring.gradle:dependency-management-plugin:1.0.4.RELEASE"
...
}
...
}
```
Step 2: Apply the plugin:
```
apply plugin: "io.spring.dependency-management"
```
Step 3: Add a `dependencyManagement` block that contains the `arquillian-bom` and `arquillian-jakarta-bom`:
```
dependencyManagement {
imports {
mavenBom "org.jboss.arquillian:arquillian-bom:1.9.1.Final"
mavenBom "org.jboss.arquillian.jakarta:arquillian-jakarta-bom:10.0.0.Final"
}
}
```
You can use the command `gradle dependencies` to view transitive dependencies and their versions.
The previous example uses version `1.7.0.Final` of the `arquillian-bom` for Jakarta EE 9 and 10 projects. If using Java EE 8 or below, use version `1.1.13.Final` of the `arquillian-bom`. A full Gradle example with Jakarta EE 9 is available in the `gradle-tests` folder.