Generate IR definitions by annotation processor - 1st step

[Akirathan]

This PR is the initial step for migrating all the IR elements implemented as Scala case classes to Java classes generated by an annotation processor.

This PR was created from the abandoned #11267 that tried to generated subclasses.

Pull Request Description

The overall description is the same as in #11267, but this approach tries to generate super classes as suggested in https://github.com/enso-org/enso/pull/11267/files#r1869342527

References

• New project runtime-parser-dsl contains new annotations for IR elements. The docs for these annotations are the most important. See org.enso.runtime.parser.dsl package
• New project runtime-parser-processor contains the implementation of the annotation processor. The entry point to annotation processing is in org.enso.runtime.parser.processor.IRProcessor.
• New project runtime-parser-processor-tests depends on aforementioned projects as well as on runtime-parser.
  • The main test is TestIRProcessorInline.java that tests the annotation processor by compiling snippets of code with the help of com.google.testing.compile:compile-testing library.
  • Another test is GeneratedIRTest.scala that test the usage of generated code.

Important Notes

Apart from the annotation processor implementation and tests, CallArgument.Specified was migrated to the new approach from Scala case class. I uploaded its generated class code in this gist so you can see it without compilation.

Checklist

Please ensure that the following checklist has been satisfied before submitting the PR:

• Benchmarks are OK
• The documentation has been updated, if necessary.
• Screenshots/screencasts have been attached, if there are any visual changes. For interactive or animated visual changes, a screencast is preferred.
• All code follows the
  Scala,
  Java,
  TypeScript,
  and
  Rust
  style guides. In case you are using a language not listed above, follow the Rust style guide.
• Unit tests have been written where possible.
• If meaningful changes were made to logic or tests affecting Enso Cloud integration in the libraries,
  or the Snowflake database integration, a run of the Extra Tests has been scheduled.
  • If applicable, it is suggested to paste a link to a successful run of the Extra Tests.

[JaroslavTulach]

Copy method generated in 1ceabfe

Great, this looks like the most elegant code to delegate to.

[JaroslavTulach]

A problem generating ScalaDoc for Java class that extends AP generated class breaks the CI:

[error] /home/runner/work/enso/enso/engine/runtime-parser/src/main/java/org/enso/compiler/core/ir/CallArgument.java:39:33: not found: type SpecifiedGen
[error]   final class Specified extends SpecifiedGen {
[error]                                 ^
[error] /home/runner/work/enso/enso/engine/runtime-parser/src/main/java/org/enso/compiler/core/ir/Empty.java:7:34: not found: type EmptyGen
[error] public final class Empty extends EmptyGen {
[error]                                  ^
[error] two errors found
[info] [FrgaalJavaCompiler] compiling 17 Java sources with module-info.java to /home/runner/work/enso/enso/engine/runtime-parser/target/classes ...
[info] done compiling
[error] Scaladoc generation failed
[error] 	at scala.tools.xsbt.Runner.run(ScaladocBridge.scala:54)
[error] 	at scala.tools.xsbt.ScaladocBridge.run(ScaladocBridge.scala:25)
[error] 	at sbt.internal.inc.AnalyzingCompiler.doc(AnalyzingCompiler.scala:154)
[error] 	at sbt.internal.inc.AnalyzingCompiler.doc(AnalyzingCompiler.scala:133)
[error] 	at sbt.Doc$.$anonfun$scaladoc$1(Doc.scala:53)
[error] 	at sbt.Doc$.$anonfun$scaladoc$1$adapted(Doc.scala:41)

[Akirathan]

Ensure that generated sources are removed before running sbt publishM2.

[Akirathan]

All the engine tests are green. Scheduling benchmarks:

• engine: https://github.com/enso-org/enso/actions/runs/12632937078
• stdlibs: https://github.com/enso-org/enso/actions/runs/12632946564

GitHub

Benchmark Engine · enso-org/enso@291e593

Enso Analytics is a self-service data prep and analysis platform designed for data teams. - Benchmark Engine · 291e593

GitHub

Benchmark Standard Libraries · enso-org/enso@291e593

Enso Analytics is a self-service data prep and analysis platform designed for data teams. - Benchmark Standard Libraries · 291e593