Skip to content

Latest commit

 

History

History
195 lines (160 loc) · 23.1 KB

CHANGELOG.md

File metadata and controls

195 lines (160 loc) · 23.1 KB
Raw

GraalVM SDK Changelog

This changelog summarizes major changes between GraalVM SDK versions. The main focus is on APIs exported by GraalVM SDK.

Version 21.0.0

Version 20.3.0

  • Added a log.file option that allows redirection of all language, instrument or engine logging to a file. The handler configured with the Context.Builder.logHandler method has precedence over the new option.
  • The option -Dgraal.LogFile is no longer inherited by the polyglot engine. Use the log.file option or configure a log handler instead.
  • In host interop, null now adheres to Java semantics:
    • (Host interop's) null has no meta-object (e.g. Value.getMetaObject() returns null)
    • Value.isMetaInstance(Object) behaves like instanceof with respect to null (e.g. null is NOT an instance of any meta-object)
  • Removed handling of --jvm.* and --native.* launcher options, which were deprecated since 1.0.0 RC14.
  • Added the ability to specify a TargetMappingPrecedence of target type mappings for HostAccess configurations that influence conversion order and precedence in relation to default mappings and other target type mappings.
  • Added PolyglotException.isInterrupted() to determine if an error was caused by an interruption of an application thread. The interrupted exceptions are no longer PolyglotException.isCancelled() but PolyglotException.isInterrupted().
  • All Truffle Graal runtime options (-Dgraal.) which were deprecated in GraalVM 20.1 are removed. The Truffle runtime options are no longer specified as Graal options (-Dgraal.). The Graal options must be replaced by corresponding engine options specified using polyglot API.
  • Added Engine.getCachedSources() to return the sources that were previously cached by the engine.
  • Added support a default OptionType for Java enums. OptionType.defaultType(Class<?>) is now always supported for enum classes.
  • Added Context.interrupt(Duration) to interrupt a polyglot Context execution. The interrupt is non-destructive meaning that the polyglot Context can still be used for further execution.
  • Added Value.as(Class) support for converting values to abstract host classes with a default constructor.
  • Added HostAccess.Builder.allowAllClassImplementations to allow converting values to abstract host classes using Value.as and host interop (true by default for HostAccess.ALL, false otherwise).

Version 20.2.0

  • Added -Dpolyglot.engine.AllowExperimentalOptions=true to allow experimental options for all polyglot engines of a host VM. This system property is intended to be used for testing only and should not be enabled in production environments.
  • Added a factory method creating a FileSystem based on the host Java NIO. The obtained instance can be used as a delegate in a decorating filesystem.
  • Added PolyglotException.isResourceExhausted() to determine if an error was caused by a resource limit (e.g. OutOfMemoryError) that was exceeded.
  • Added Context.parse(Source) to parse but not evaluate a source. Parsing a source allows to trigger e.g. syntax validation prior to executing the code.
  • Added optional FileSystem.isSameFile method testing if the given paths refer to the same physical file. The method can be overridden by the FileSystem implementer with a more efficient test.
  • Added EconomicMap.putIfAbsent(K, V) to associate a value with the specified key if not already present in the map.

Version 20.1.0

  • The PerformanceWarningsAreFatal and TracePerformanceWarnings engine options take a comma separated list of performance warning types. Allowed warning types are call to enable virtual call warnings, instanceof to enable virtual instance of warnings and store to enables virtual store warnings. There are also all and none types to enable (disable) all performance warnings.
  • The <language-id>.home system property that can be used in some development scenarios to specify a language's directory is deprecated. The org.graalvm.language.<language-uid>.home property should be used instead. Setting this new system property is reflected by the HomeFinder API.
  • Added CompilationFailureAction engine option which deprecates CompilationExceptionsArePrinted , CompilationExceptionsAreThrown, CompilationExceptionsAreFatal and PerformanceWarningsAreFatal options.
  • Added TreatPerformanceWarningsAsErrors engine option which deprecates the PerformanceWarningsAreFatal option. To replace the PerformanceWarningsAreFatal option use the TreatPerformanceWarningsAsErrors with CompilationFailureAction set to ExitVM.
  • Added bailout into performance warning kinds used by TracePerformanceWarnings, PerformanceWarningsAreFatal and CompilationExceptionsAreFatal options.
  • Added OptionDescriptor.getDeprecationMessage returning the option deprecation reason. Added OptionDescriptor.Builder.deprecationMessage() to set the option deprecation reason.
  • Added Value.isMetaObject(), Value.getMetaQualifiedName(), Value.getMetaSimpleName() and Value.isMetaInstance(Object) to allow language agnostic access to meta-objects like classes or types.
  • The result of Value.getMetaObject() will now return always meta-objects. It is recommended but not required to change uses of meta-objects to use Value.getMetaQualifiedName() instead of Value.toString() to return a type name.
  • Added Context.Builder.hostClassLoader to allow an embedder to specify a context ClassLoader for code execution.

Version 20.0.0

  • The deprecated graalvm.home and graalvm.version system properties have been removed, use the HomeFinder instead.
  • Added EventContext.createError which allows to introduce guest application errors in execution listeners/nodes.
  • Deprecated Instrumenter.attachExecutionEventListener and ExecutionEventListener.onInputValue as explicit input filters are not supported by event listeners. Use ExecutionEventNodes instead.
  • Added Context.Builder.currentWorkingDirectory to set the current working directory used by the guest application to resolve relative paths.
  • The algorithm used to generate a unique URI for a Source built without an URI was changed to SHA-256.
  • All Truffle Graal runtime options (-Dgraal.) will be deprecated with 20.1. The Truffle runtime options are no longer specified as Graal options (-Dgraal.). The Graal options must be replaced by corresponding engine options specified using polyglot API. The TRUFFLE_STRICT_OPTION_DEPRECATION environment variable can be used to detect usages of deprecated Graal options. When the TRUFFLE_STRICT_OPTION_DEPRECATION is set to true and the deprecated Graal option is used the engine throws a PolyglotException listing the used deprecated options and corresponding replacements.

Version 19.3.0

  • The default temporary directory can be configured by FileSystem.
  • Added org.graalvm.polyglot.ResourceLimits that allows to specify context specific time and statement count execution limits.
  • Added HomeFinder, a utility class to find various paths of the running GraalVM.
  • Contexts can now be closed if they are still explicitly entered using Context.enter on the current thread. This allows for simpler error recovery code.
  • Added Value.getContext() to access the context a value is associated with.
  • Added org.graalvm.home.Version version utility that allows to create, validate and compare GraalVM versions.
  • Added Value API methods for interacting with exception objects: Value#isException and Value#throwException.
  • Added target type mapping from exception objects to PolyglotException.

Version 19.2.0

  • Added support for date, time, timezone and duration values in polyglot
    • Added methods to identify polyglot date, time, timezone and duration values in Value. See Value.isDate, Value.isTime, Value.isTimeZone, Value.isDuration.
    • Polyglot languages now interpret the java.time host values of type LocalDate, LocalTime, LocalDateTime, ZonedDateTime, Instant, ZoneId and Duration. They are mapped to the appropriate guest language types.
    • Added ProxyDate, ProxyTime, ProxyTimeZone, ProxyInstant and ProxyDuration to proxy date time and duration related guest values.
  • Added Context.Builder.timeZone(ZoneId) to configure the default timezone of polyglot contexts.
  • Added OptionKey.mapOf to group/accumulate key=value pairs for options whose keys are not known beforehand e.g. user-defined properties.
  • Added ability to configure custom polyglot access configuration with PolyglotAccess.newBuilder(). It allows to configure fine-grained access control for polyglot bindings and between polyglot languages.

Version 19.1.0

  • Restricting guest languages from sub-process creation by Context.Builder.allowCreateProcess. Use Context.newBuilder().allowCreateProcess(true) to allow guest languages to create a new sub-process.
  • Added a possibility to control sub-process creation using a custom ProcessHandler implementation. Use Context.newBuilder().processHandler(handler) to install a custom ProcessHandler.
  • Restricting access to the host environment variables via EnvironmentAccess configurations. Use EnvironmentAccess.INHERIT to allow guest languages to read process environment variables.
  • Deprecated OptionValues#set, OptionValues should be read-only. If the value needs to be changed, it can be stored in the language or instrument and read from there.
  • Removed deprecated OptionCategory.DEBUG (use OptionCategory.INTERNAL instead).
  • The path separator can now be configured by FileSystem.

Version 19.0.0

  • Value.as(Interface.class) now requires interface classes to be annotated with HostAccess.Implementable in EXPLICIT host access mode. Added new APIs to configure implementable behavior in HostAccess.

Version 1.0.0 RC16

  • --experimental-options can now also be passed after polyglot options on the command line.
  • --version changed default message to IMPLEMENTATION-NAME (ENGINE-NAME GRAALVM-VERSION)

Version 1.0.0 RC15

  • Renamed 'Graal SDK' to 'GraalVM SDK'
  • Added optional FileSystem.getMimeType and FileSystem.getEncoding methods. These methods can be used by FileSystem implementer to provide file MIME type and encoding.
  • Added a possibility to set an encoding in Source builder
  • (incompatible change) Restricting access to the host language via HostAccess configurations. Use Context.newBuilder().allowHostAccess(HostAccess.ALL) to get previous behavior. Configurations that use allowAllAccess(true) are not affected by this incompatible change.
  • Deprecated Context.Builder.hostClassFilter and added the new method Context.Builder.allowHostClassLookup as a replacement. The name was changed for clarity and now also accepts null to indicate that no host class lookup is allowed.
  • (incompatible change) Restricting polyglot access for guest languages via PolyglotAccess configurations. Use Context.newBuilder().allowPolyglotAccess(PolyglotAccess.ALL) to get previous behavior. Configurations that use allowAllAccess(true) are not affected by this incompatible change.
  • Removed deprecated API class ProxyPrimitive.
  • Started adding several options under --engine like --engine.TraceCompilation, which can also be set on the Engine. These options will progressively replace the -Dgraal.*Truffle* properties. The list can be seen by passing --help:expert to any language launcher.
  • Experimental options now require --experimental-options on the command line to be passed to GraalVM language launchers, or Context.Builder#allowExperimentalOptions and Engine.Builder#allowExperimentalOptions to be set in other scenarios.
  • Added new API for target type mappings using the new HostAccess API.
  • (incompatible change) Removed default lossy string coercions. Previous behavior can be restored using the following snippets.

Version 1.0.0 RC14

  • Added Context.Builder#allowExperimentalOptions to control whether experimental options can be passed to a Context.
  • Added Engine.Builder#allowExperimentalOptions to control whether experimental instrument and engine options can be passed.
  • Removed deprecated API class ProxyPrimitive.
  • Restricting access (incompatible change) to host interop via HostAccess configurations. Use Context.newBuilder().allowHostAccess(HostAccess.PUBLIC) to get previous behavior.
  • Restricting access (incompatible change) to the host language via HostAccess configurations. Use Context.newBuilder().allowHostAccess(HostAccess.ALL) to get previous behavior. Configurations that use allowAllAccess(true) are not affected by this incompatible change.
  • Deprecated Context.Builder.hostClassFilter and added the new method Context.Builder.allowHostClassLookup as a replacement. The name was changed change for clarity and now also allows null values to indicate that no host class lookup is allowed.
  • Deprecated defaultValue of OptionType. Default value of OptionKey is sufficient.
  • --vm.* should now be used instead of --native.* or --jvm.* to pass VM options in GraalVM language launchers (the old style of option is still supported but deprecated and shows warnings on stderr). --native and --jvm should still be used to select the VM mode.
  • --jvm.help or --native.help are deprecated in favor of --help:vm.

Version 1.0.0 RC13

  • OptionCategory.DEBUG has been renamed to OptionCategory.INTERNAL for clarity.
  • Added "static" member to class objects that provides access to the class's static members.
  • OptionStability has been added for specifying the stability of an option.

Version 1.0 RC11

Version 1.0 RC10

Version 1.0 RC9

  • Added a Context.Builder.logHandler and Engine.Builder.logHandler methods to install a logging handler writing into a given OutputStream.
  • Value.asValue(Object) now also works if no currently entered context is available.
  • Primitives, host and Proxy values can now be shared between multiple context and engine instances. They no longer throw an IllegalArgumentException when shared. Primitive types are Boolean, Byte, Short, Integer, Long, Float, Double, Character and String of the java.lang package. Non primitive values originating from guest languages are not sharable.

Version 1.0 RC8

  • Added MessageTransport and MessageEndpoint to virtualize transport of messages to a peer URI.
  • Added Value.canInvokeMember() and Value.invokeMember() to invoke a member of an object value.

Version 1.0 RC7

  • Graal SDK was relicensed from GPLv2 with CPE to Universal Permissive License (UPL).

Version 1.0 RC6

  • Added new ByteSequence utility to the IO package that is intended to be used as immutable byte sequence representation.
  • Added support for byte based sources:
    • Byte based sources may be constructed using a ByteSequence or from a File or URL. Whether sources are interpreted as character or byte based sources depends on the specified language.
    • Source.hasBytes() and Source.hasCharacters() may be used to find out whether a source is character or byte based.
    • Byte based sources throw an UnsupportedOperationException if methods that access characters, line numbers or column numbers.
    • Added Source.getBytes() to access the contents of byte based sources.
  • Added support for MIME types to sources:
    • MIME types can now be assigned using Source.Builder.mimeType(String) to sources in addition to the target language.
    • The MIME type of a source allows languages support different kinds of input.
    • Language instances allow access to the default and supported MIME types using Language.getMimeTypes() and Language.getDefaultMimeType().
    • MIME types are automatically detected if the source is constructed from a File or URL if it is not specified explicitly.
    • Deprecated Source.getInputStream(). Use Source.getCharacters() or Source.getBytes() instead.
  • Context methods now consistently throw IllegalArgumentException instead of IllegalStateException for unsupported sources or missing / inaccessible languages.
  • Added Engine.findHome() to find the GraalVM home folder.

Version 1.0 RC5

  • PolyglotException.getGuestObject() now returns null to indicate that no exception object is available instead of returning a Value instance that returns true for isNull().
  • Added new execution listener API that allows for simple, efficient and fine grained introspection of executed code.

Version 1.0 RC3

  • Added support for logging in Truffle languages and instruments.

Version 1.0 RC2

  • Added Value.asValue(Object) to convert a Java object into its value representation using the currently entered context.
  • Added Context.getCurrent() to lookup the current context to allow Java methods called by a Graal guest language to evaluate additional code in the current context.
  • Removed deprecated Context.exportSymbol and Context.importSymbol.
  • Removed deprecated Source.getCode.
  • The code cache for sources is now weak. Code can be garbage collected if a source is no longer referenced but the Context or Engine is still active.
  • Added Source.Builder.cached(boolean) to configure caching behavior by source.

Version 1.0 RC1

  • Added Context.Builder#allowHostClassLoading to allow loading of new classes by the guest language.
  • Added Value.getSourceLocation() to find a function SourceSection.

Version 0.33

  • Expose Runtime name as Engine#getImplementationName();
  • Deprecate Context#exportSymbol, Context#importSymbol, Context#lookup use Context#getBindings, Context#getPolyglotBindings instead.
  • Remove deprecated API Engine#getLanguage, Engine#getInstrument.
  • Remove deprecated Language#isHost.
  • Deprecate ProxyPrimitive without replacement.
  • Added Context.Builder#allAccess that allows to declare that a context has all access by default, also for new access rights.

Version 0.31

  • Added Value#as(Class) and Value.as(TypeLiteral) to convert to Java types.
  • Added Context#asValue(Object) to convert Java values back to the polyglot Value representation.
  • Added Value#isProxyObject() and Value#asProxyObject().

Version 0.29

  • Introduced Context.enter() and Context.leave() that allows explicitly entering and leaving the context to improve performance of performing many simple operations.
  • Introduced Value.executeVoid to allow execution of functions more efficiently if not return value is expected.

Version 0.26

  • Initial revision of the polyglot API introduced.
  • Initial revision of the native image API introduced.
  • Initial revision of the options API introduced.