Builtins expose Enso methods

[Akirathan]

Closes #11589

Pull Request Description

Builtin types expose methods via the interop protocol. In fact, all types expose methods via interop protocol.

To get and invoke a method on a builtin object via interop protocol:

var meta = interop.getMetaObject(text);
meta.invokeMember(meta, "+", ...);

Example in InvokeBuiltinMethodViaInteropTest

To get and invoke a method on a builtin object via org.graalvm.polyglot.Value (this can be done, e.g., in std libs in Java code):

Value object;
Value meta = object.getMetaObject();
meta.invokeMember(...);

Example in BuiltinTypesExposeMethodsTest.

Important Notes

Method members are reported in Type.getMembers as internal members.
This has a side effect that in the debugger, types have method properties (but not atoms):

The first attempt to implement hasMember and getMembers on BuiltinObject abandoned - #11687 (comment)

Checklist

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

• 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.

[Akirathan]

Both TimeZone and Duration now have members, so we need to add these guards here.

[JaroslavTulach]

The whole EqualsXyzNode set of @Specialize annotation is fragile, unreadable, not fully testable and deserves a rewrite. At least that's the feeling I get every time I am changing the code.

Such a gentle change is OK, unless total rewrite is attempted.

[Akirathan]

See my answer in #11687 (comment) - yes it is a mess.

[Akirathan]

the
#11589 issue started with three examples of missing builtin methods
shall we not fix some of these cases in this PR?

@JaroslavTulach Ref.get, Vector.to_text, and File.path mentioned in #11589 (comment) tested in InvokeBuiltinMethodViaInteropTest

[Akirathan]

BuiltinObject super class split into a separate PR - #11861

[JaroslavTulach]

@Akirathan can you merge in the most recent develop branch? Then we can check and see what can be done with the rest...

[JaroslavTulach]

The idea of using static methods on Type seems to be a great solution to all the problems we had so far. The PR is simple and unlocks a functionality that was clearly missing.

• cannot call Ref.get: https://github.com/enso-org/enso/pull/11577/files#r1848224116
• cannot call File.path on EnsoFile
• cannot call to_text on Vector - discovered while working on Warnings displayed after main exit do not use defined to_text #11569

Can you simplify these three known workarounds in the production code as well? Then this PR will immediately be useful for Enso users!

[JaroslavTulach]

OK, so this is result of Ref.new 42.

[JaroslavTulach]

The Ref object has no members.

[JaroslavTulach]

One has to ask for Ref object's meta-object - e.g. Type

[JaroslavTulach]

and there is invocable method get on the Ref type.

[JaroslavTulach]

The method can be invoked as static method on the Ref type with first argument being the Ref object.

[Akirathan]

The approach to export methods as internal members of types and not on atoms/builtin objects was chosen because of #12043 - at the moment, it is not possible to implement hasMembers interop message on builtin objects.

[Akirathan]

Can you simplify these three known workarounds in the production code as well? Then this PR will immediately be useful for Enso users!

@JaroslavTulach Usages of Ref.get and Path.root simplified in 0c97057.

I tried to simplify Warning.to_text as well in WithWarnings like so:

diff --git a/engine/runtime/src/main/java/org/enso/interpreter/runtime/warning/WithWarnings.java b/engine/runtime/src/main/java/org/enso/interpreter/runtime/warning/WithWarnings.java
index 7b8dce1d6e..8acf02eedd 100644
--- a/engine/runtime/src/main/java/org/enso/interpreter/runtime/warning/WithWarnings.java
+++ b/engine/runtime/src/main/java/org/enso/interpreter/runtime/warning/WithWarnings.java
@@ -8,7 +8,9 @@ import com.oracle.truffle.api.dsl.Cached.Shared;
 import com.oracle.truffle.api.interop.ArityException;
 import com.oracle.truffle.api.interop.InteropLibrary;
 import com.oracle.truffle.api.interop.TruffleObject;
+import com.oracle.truffle.api.interop.UnknownIdentifierException;
 import com.oracle.truffle.api.interop.UnsupportedMessageException;
+import com.oracle.truffle.api.interop.UnsupportedTypeException;
 import com.oracle.truffle.api.library.CachedLibrary;
 import com.oracle.truffle.api.library.ExportLibrary;
 import com.oracle.truffle.api.library.ExportMessage;
@@ -201,6 +203,7 @@ public final class WithWarnings extends EnsoObject {
     for (var w : warns) {
       try {
         var wText = node.execute(toText, state, new Object[] {w.getValue()});
+        var myText = invokeToText(w, where);
         if (wText instanceof Text t) {
           if (prefix != null) {
             text = text.add(prefix);
@@ -214,6 +217,19 @@ public final class WithWarnings extends EnsoObject {
     return text;
   }
 
+  private static Object invokeToText(Warning warn, Node where) {
+    System.out.println("[mylog] invokeToText");
+    var interop = InteropLibrary.getUncached();
+    try {
+      var meta = interop.getMetaObject(warn);
+      var toTextRes = interop.invokeMember(meta, "to_text", warn);
+      return toTextRes;
+    } catch (UnsupportedMessageException | ArityException | UnknownIdentifierException |
+             UnsupportedTypeException e) {
+      throw EnsoContext.get(where).raiseAssertionPanic(where, e.getMessage(), e);
+    }
+  }
+
   @ExportMessage
   Object send(Message message, Object[] args, @CachedLibrary(limit = "3") ReflectionLibrary lib)
       throws Exception {

But that does not work, because to_text is defined on Any, and the Type.methods method discovery does not include methods from Any, neither extension methods. I have created issue for it to track it down - #12045

Let's merge this PR with the current changes.