README.md

Arcturus

Java compiler plugin.

Usage

Intrinsic

Implements JEP 303, a.k.a. user defined intrinsics.

Example usage:

public class UltimateAnswer {

  public static void main(String[] args) {
    int i = (int) UltimateAnswer.getAnswer();
    System.out.println(i);
  }

  private static final Intrinsic ANSWER = new Intrinsic(
    "answer",
    (lookup, methodType, args) -> {
      MethodHandle handle = MethodHandles.dropArguments(
        MethodHandles.constant(int.class, 42),
        0,
        methodType.parameterList()
      );
      return new ConstantCallSite(handle);
    });

  @Intrinsic.Link("ANSWER")
  public static native Object getAnswer(Object... args);
}

Outputs:

42

The call to getAnswer is translated to a invokedynamic call using ANSWER as bootstrap method.

Tailrec

Implements tail call elimination.

Example:

public static void main(String[] args) {
    System.out.println(fact(4, 1));
}

@Tailrec
private static int fact(int i, int acc) {
    return i > 1 ? fact(i - 1, i * acc) : acc;
}

Outputs:

24

Please refer to test sources for more details.

Gradle

repositories {
  maven { url 'https://maven.izzel.io/releases' }
}
dependencies {
  implementation 'io.izzel:arcturus:VERSION'
  annotationProcessor 'io.izzel:arcturus:VERSION:processor'
}

License

This project is licensed under the MIT License.