Backend Test

Acceptance test suite for the REST API provided by the backend service

Dependencies

• Java17+
• Docker

Usage

Run tests

./gradlew test

Maintenance

Re-generate Java SDK

TEMP_DIR=$(mktemp -d)

# Generate code
docker run --rm -v "${TEMP_DIR}:/local" openapitools/openapi-generator-cli generate \
    -i https://raw.githubusercontent.com/ksch-workflows/backend/main/docs/openapi.yml \
    -g java \
    --additional-properties=library=native,apiPackage=ksch,invokerPackage=ksch,modelPackage=ksch.model \
    -o /local
    
# Adopt generated code
rm -rf src/main/java && mkdir -p src/main && cp -r $TEMP_DIR/src/main/java src/main/

# Normalize generated code
find . -name "*.java" | xargs -I{} perl -pi -e 's/.*javax.*//g;' {}

Also see

• https://github.com/OpenAPITools/openapi-generator
• https://openapi-generator.tech/docs/generators/java/
• https://openapi-generator.tech/docs/configuration/

References

• https://api.experimental-software.com/