Repository Description: Quarkus extension providing Dev Services for Lorisgate. Automatically starts and configures a Lorisgate instance using Testcontainers for local development and integration testing, ensuring a seamless "zero-config" experience.
Lorisgate Dev Service is a Quarkus extension that manages a Lorisgate instance during development and testing. It leverages Testcontainers to spin up a Docker container automatically, so you don't have to manually install or manage Lorisgate processes.
When Quarkus starts in Dev Mode (quarkus dev) or Test Mode (maven test), the extension checks if a Lorisgate connection is already configured. If not, it pulls the image, starts the container, and injects the connection properties directly into your application.
- Zero-Config: Get up and running without touching
application.properties. - Lifecycle Management: Automatically starts on boot and stops when the Quarkus process ends.
- Shared Instances: Keeps the container running across live-reloads to save time.
- Customizable: Easily override the image version or port if needed.
Add the following dependency to your Quarkus project's pom.xml:
<dependency>
<groupId>org.lorislab.lorisgate</groupId>
<artifactId>lorisgate-quarkus</artifactId>
</dependency>- Detection: The extension looks for lorisgate.url.
- Provisioning: If missing, it starts a Lorisgate container via Docker.
- Injection: It dynamically provides the following properties to the Quarkus runtime:
- lorisgate.host
- lorisgate.port
Contributions are welcome!
- Fork the repository
- Create a feature branch (
git checkout -b feature/YourFeature) - Commit your changes
- Push to your fork
- Open a Pull Request
Licensed under the Apache License, Version 2.0.