(this page is for developing and maintaining this project)
Following instructions apply to Windows machines:
choco install -y temurin11
choco install -y git
choco install -y gpg4win
-- required for signing commitschoco install -y tortoisegit
-- optionalchoco install -y intellijidea-ultimate
or choco install eclipse-java-oxygen
There should be similar commands for Mac and various Linux distros.
Either copy development-maven-settings.xml to
your ~/.m2
as settings.xml
, or run Maven with
mvnw -settings development-maven-settings.xml
from this directory.
Project settings are shared via .idea
folder
see https://www.jetbrains.com/help/idea/creating-and-managing-projects.html#share-project-through-vcs
and https://www.jetbrains.com/help/idea/sharing-your-ide-settings.html#settings-repository
Screenshots and tracing logs require AspectJ instrumentation. AspectJ plugin is required in order to compile, run and debug in an IDE:
qa-testing-example
, qa-testing-utils
,
qa-testing-extra
and qa-jgiven-commons
mvnw
on the root project will run all tests.
By pushing or merging into main branch. See the deploy-site-for-jdk11.
We use SemVer for versioning.
To initiate a release, run the Release action.
The above has the following effects:
SNAPSHOT
suffix will be removedPlease read CONTRIBUTING.md for details on our process for submitting pull requests to us, and please ensure you follow the CODE_OF_CONDUCT.md.
This project is licensed under the Apache License - see the LICENSE file for details.
For validating published artifacts, use https://keys.openpgp.org/search?q=39F1B2495B0260B2D974C634F89B5DBA3AF082E0
Per OSSRH depolyment rules, all artifacts must be signed using gpg -- https://central.sonatype.org/publish/publish-maven/#gpg-signed-components
gpg --import 39F1B2495B0260B2D974C634F89B5DBA3AF082E0.gpg
and ensure your correct Maven Settings as described above.
Must add following environment variables before launching Maven:
SAUCELABS_USER
SAUCELABS_PASSWORD
These are available from https://app.saucelabs.com/