Enable jbang integration in Quarkus

[maxandersen]

This PR started out as trying to run a jar directly via quarkus; but after talking with @stuartwdouglas
taking another approach where jbang has a SPI to let quarkus (or any other framework) hook into the build process.

With this PR + jbang PR you can take the following file, save in quarkus.java and do:

jbang quarkus.java to run it
jbang --debug quarkus.java to debug it
jbang --native quarkus.java to get native image built (currently rely on docker; TBD use graalvm if available)

//usr/bin/env jbang "$0" "$@" ; exit $?
// //DEPS <dependency1> <dependency2>
//DEPS io.quarkus:quarkus-arc:999-SNAPSHOT

import io.quarkus.runtime.Quarkus;
import io.quarkus.runtime.QuarkusApplication;

import static java.lang.System.*;

public class quarkus {

    public static void main(String... args) {
        Quarkus.run(MyApp.class, args);
    }

    public static class MyApp implements QuarkusApplication {

        @Override
        public int run(String... args) throws Exception {
            System.out.println("Inside Quarkus!");
            return 0;
        }
    }
}

you can also do configuration using //CONFIG

//DEPS io.quarkus:quarkus-resteasy:999-SNAPSHOT
//DEPS io.quarkus:quarkus-container-image-jib:999-SNAPSHOT
//CONFIG quarkus.http.port=7777
//CONFIG quarkus.native.container-build=true
//CONFIG quarkus.container-image.build=true
//CONFIG quarkus.container-image.name=jbang-test

import io.quarkus.runtime.Quarkus;

import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/hello")
public class quarkus {

    public static void main(String... args) {
        Quarkus.run(args);
    }

    @GET
    public String sayHello() {
        return "hello";
    }
}

Things yet to do/being considered:

• release jbang 0.40 with SPI enabled
• transformation missing thus things like panache does not work (trivial fix)
• Consider if //CONFIG should be //QCONFIG as it is quarkus specific
• remove dependency on intermediate pom.xml and just work based on dependency list
• enable dev:mode (package as mutable-jar and this should "just work")
• enable run from IDE (currently it requires it to be packaged as jar)
  (work around is to do jbang --debug app.java and connect with debugger from there.)
• consider if we should allow triggering thngs like openshift/kubernetes/funky deploy (all technical possible; just a question on if can make the UX experience sane from jbang side)

In addition this PR also try and make it possible to run app directly without having
pom.xml/build.gradle but not yet complete.

for now added .jar to zipfilesystem to avoid FileSystemNotFoundException and
then avoided introspection as if a gradle project.

But then hitting that appmodel is null.

[gastaldi]

@maxandersen try removing the main if you implement QuarkusApplication or add @QuarkusMain

[maxandersen]

@maxandersen try removing the main if you implement QuarkusApplication or add @QuarkusMain

what would that help/change ? (without it you can't run it from the IDE easily)

updated the example as missing arc and not passing class to run. now it works ;)

[maxandersen]

Pushed some changes from @stuartwdouglas enabling this level of crazyiness:

//DEPS io.quarkus:quarkus-resteasy:999-SNAPSHOT
//DEPS io.quarkus:quarkus-container-image-jib:999-SNAPSHOT
//CONFIG quarkus.http.port=7777
//CONFIG quarkus.native.container-build=true
//CONFIG quarkus.container-image.build=true
//CONFIG quarkus.container-image.name=jbang-test

import io.quarkus.runtime.Quarkus;

import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/hello")
public class quarkus {

    public static void main(String... args) {
        Quarkus.run(args);
    }

    @GET
    public String sayHello() {
        return "hello";
    }
}

This wont (yet) let jbang just run the jar standalone; but what it does do is letting quarkus participate during jbang build without a hard coupling between the two. Allowing you to have speedy startup AND generate native images ...

This relies on this jbang PR to work: jbangdev/jbang#261

[maxandersen]

@gastaldi @aloubyansky would like to see this enabled in 1.8 thus a fast review would be great - pretty please!

There are a bunch of files changed here but bulk of it is the jbang handler code which shouldnt affect anything as its completely isolated and only engaged when run inside jbang.

The others are just gotchas/issues jbang usage found that needed fixing anyway (TCCL classloader and non-default package name assumptions)

[gastaldi]

Found some minor issues, but otherwise LGTM

[gastaldi]

Avoid star imports

[maxandersen]

yeah, I don't use them but recently the formatter seem to make them happen.

[gastaldi]

Mind squashing before merging this PR?

[maxandersen]

Mind squashing before merging this PR?

sure - pushed with co-authors intact.

[gastaldi]

Thanks, merged

[maxandersen]

Proposal for release blog:

Experimental Quarkus Scripting via JBang

jbang lets you write and build single source java applications - requiring no maven nor gradle to build and it will even download Java for you.

We've added experimental support to let you take the following code, save it as quarkus.java and run it using jbang quarkus.java.

//usr/bin/env jbang "$0" "$@" ; exit $?
//REPOS xamdk=https://xam.dk/maven
//DEPS io.quarkus:quarkus-resteasy:1.8.0.CR1
//DEPS io.quarkus:quarkus-smallrye-openapi:1.8.0.CR1
//DEPS io.quarkus:quarkus-swagger-ui:1.8.0.CR1

//JAVA_OPTIONS -Djava.util.logging.manager=org.jboss.logmanager.LogManager
//Q:CONFIG quarkus.swagger-ui.always-include=true

import io.quarkus.runtime.Quarkus;
import javax.enterprise.context.ApplicationScoped;
import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/hello")
@ApplicationScoped
public class quarkus {

    @GET
    public String sayHello() {
        return "hello from Quarkus with jbang.dev";
    }

    public static void main(String[] args) {
        Quarkus.run(args);
    }
}

You can even run jbang --native quarkus.java to get a native image build assuming you have native-image installed.

This initial version has all the basics working making it possible to write full blown Quarkus applications - some features like devmode is not there yet nor resources (like initial index.html). Still, with the above you have the full REST example application and you can access https://0.0.0.0:8080/hello for the API and even https://0.0.0.0:8080/swaggeer-ui for OpenAPI browsing.

Provide feedback and let us see where it goes.

[gastaldi]

Hey, what if we added that snippet in the jbang-catalog? It would be easier to run with jbang quarkus@quarkusio :)

[gastaldi]

Maybe we can migrate the quickstarts to that too in the future

[maxandersen]

Hey, what if we added that snippet in the jbang-catalog? It would be easier to run with jbang quarkus@quarkusio :)

once some version with quarkus in it is released we can do some interesting things in the catalog for sure. Just that in jbangs current form it only allows for single files thus not all quickstarts "fits".

I'm about to submit PR with basic docs for the jbang integration and you'll see the slight differences/limits there are when using single file.