Package org.pkl.core.runtime

Class VmExceptionBuilder

java.lang.Object

org.pkl.core.runtime.VmExceptionBuilder

public final class VmExceptionBuilder
extends Object

Error message guidelines:

• Pkl strives to provide a great experience for casual users. Hence it must excel at error reporting.
• Be concrete and concise. Examples and explanations can help but must carry their weight.
• The source line is considered an integral part of the error message. Assume it's always presented to the user. Design the main message accordingly and avoid duplicated information.
• Use correct "natural language" spelling. Most messages should be sentences that start with an uppercase letter and end with a dot.
• The main message should typically be a single line and sentence. Try to make it both easy to understand for novices and easy to recognize for experienced users. Use withHint(java.lang.String) for longer explanations.
• Don't include arbitrary-size information in the main message but instead use withProgramValue(java.lang.String, java.lang.Object).
• Use withExternalMessage(java.lang.String, java.lang.Object...) whenever possible.
• Avoid abbreviations (i.e., e.g., etc., ...). Some users will not be familiar with them.
• Use backticks for inline code (cf. Markdown). (For identifiers, *emphasis* may be preferable but isn't currently used. One problem with special formatting is that error output doesn't always go to a terminal and hence may be rendered verbatim.)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	VmExceptionBuilder.MultilineValue

Constructor Summary

Constructors

Constructor	Description
VmExceptionBuilder()

Method Summary

Modifier and Type	Method	Description
VmExceptionBuilder	adhocEvalError(String message, Object... args)
VmExceptionBuilder	bug(String message, Object... args)
VmException	build()
VmExceptionBuilder	cannotFindKey(VmMap map, Object key)
VmExceptionBuilder	cannotFindMember(VmObjectLike receiver, Object memberKey)
VmExceptionBuilder	cannotFindMethod(VmObjectLike receiver, Identifier methodName, int arity, boolean isImplicitReceiver)
VmExceptionBuilder	cannotFindProperty(VmObjectLike receiver, Identifier propertyName, boolean isRead, boolean isImplicitReceiver)
VmExceptionBuilder	evalError(String messageKey, Object... args)
VmExceptionBuilder	typeMismatch(Object value, VmClass expectedType)
VmExceptionBuilder	typeMismatch(Object value, VmClass expectedType1, VmClass expectedType2)
VmExceptionBuilder	undefinedPropertyValue(Identifier propertyName, Object receiver)
VmExceptionBuilder	undefinedValue()
VmExceptionBuilder	unreachableCode()
VmExceptionBuilder	withCause(Throwable cause)
VmExceptionBuilder	withHint(@Nullable String hint)
VmExceptionBuilder	withInsertedStackFrames(Map<com.oracle.truffle.api.CallTarget,StackFrame> insertedStackFrames)
VmExceptionBuilder	withLocation(com.oracle.truffle.api.nodes.Node location)
VmExceptionBuilder	withMemberName(String memberName)
VmExceptionBuilder	withOptionalLocation(@Nullable com.oracle.truffle.api.nodes.Node location)
VmExceptionBuilder	withProgramValue(String name, Object value)
VmExceptionBuilder	withSourceSection(@Nullable com.oracle.truffle.api.source.SourceSection sourceSection)
VmExceptionBuilder	wrapping(VmException nestedException)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

VmExceptionBuilder

public VmExceptionBuilder()

Method Details

typeMismatch

public VmExceptionBuilder typeMismatch(Object value,
 VmClass expectedType)

typeMismatch

public VmExceptionBuilder typeMismatch(Object value,
 VmClass expectedType1,
 VmClass expectedType2)

unreachableCode

public VmExceptionBuilder unreachableCode()

undefinedValue

public VmExceptionBuilder undefinedValue()

undefinedPropertyValue

public VmExceptionBuilder undefinedPropertyValue(Identifier propertyName,
 Object receiver)

cannotFindMember

public VmExceptionBuilder cannotFindMember(VmObjectLike receiver,
 Object memberKey)

cannotFindProperty

public VmExceptionBuilder cannotFindProperty(VmObjectLike receiver,
 Identifier propertyName,
 boolean isRead,
 boolean isImplicitReceiver)

cannotFindMethod

public VmExceptionBuilder cannotFindMethod(VmObjectLike receiver,
 Identifier methodName,
 int arity,
 boolean isImplicitReceiver)

cannotFindKey

public VmExceptionBuilder cannotFindKey(VmMap map,
 Object key)

bug

public VmExceptionBuilder bug(String message,
 Object... args)

evalError

public VmExceptionBuilder evalError(String messageKey,
 Object... args)

adhocEvalError

public VmExceptionBuilder adhocEvalError(String message,
 Object... args)

withProgramValue

public VmExceptionBuilder withProgramValue(String name,
 Object value)

withLocation

public VmExceptionBuilder withLocation(com.oracle.truffle.api.nodes.Node location)

withOptionalLocation

public VmExceptionBuilder withOptionalLocation(@Nullable
 @Nullable com.oracle.truffle.api.nodes.Node location)

withSourceSection

public VmExceptionBuilder withSourceSection(@Nullable
 @Nullable com.oracle.truffle.api.source.SourceSection sourceSection)

withMemberName

public VmExceptionBuilder withMemberName(String memberName)

withCause

public VmExceptionBuilder withCause(Throwable cause)

withHint

public VmExceptionBuilder withHint(@Nullable
 @Nullable String hint)

wrapping

public VmExceptionBuilder wrapping(VmException nestedException)

withInsertedStackFrames

public VmExceptionBuilder withInsertedStackFrames(Map<com.oracle.truffle.api.CallTarget,StackFrame> insertedStackFrames)

build

public VmException build()