Enum TranscriptLine 

pub enum TranscriptLine {
    Alert {
        title: String,
        message: String,
        icon: i32,
        button: i32,
    },
    Beep(i32),
    Response {
        question: String,
        title: String,
        default_value: String,
        label: String,
        password: bool,
    },
    MailMsg {
        ui: bool,
        to: String,
        cc: String,
        bcc: String,
        subject: String,
        body: String,
    },
    Print {
        ui: bool,
        start: i32,
        end: i32,
        silent: bool,
        shrink_to_fit: bool,
        print_as_image: bool,
        reverse: bool,
        annotations: bool,
    },
    SubmitForm {
        url: String,
        data: Vec<u8>,
    },
    GotoPage(i32),
    NamedAction(String),
    ConsolePrintln(String),
    FunctionAlert {
        caller: String,
        message: String,
    },
}

Available on crate feature javascript only.

One thing a script asked the host to do.

Ten shapes, because the goldens carry ten. Each variant’s render output is quoted from the callback that produces it.

Variants

Alert

app.alert — 1933 of the 2004 golden lines.

The message is printed with a conditional decoration: see TranscriptLine::render.

Fields

title: String

cTitle, defaulting to the literal "Alert".

message: String

cMsg. An array argument is joined first — see app.alert.

icon: i32

nIcon, defaulting to 0.

button: i32

nType, defaulting to 0.

Beep(i32)

app.beep(n) — ExampleAppBeep.

Response

app.response(...) — ExampleAppResponse. The host answers with the empty string; nothing is prompted.

Fields

question: String

cQuestion.

title: String

cTitle.

default_value: String

cDefault.

label: String

cLabel.

password: bool

bPassword.

MailMsg

app.mailMsg / Doc.mailDoc / Doc.mailForm — ExampleDocMail. Nothing is sent: no network, no MAPI, no process spawn.

Fields

ui: bool

bUI.

to: String

To.

cc: String

cc.

bcc: String

bcc.

subject: String

cSubject.

body: String

cMsg.

Print

Doc.print — ExampleDocPrint. Nothing is printed.

Fields

ui: bool

bUI.

start: i32

nStart.

end: i32

nEnd.

silent: bool

bSilent.

shrink_to_fit: bool

bShrinkToFit.

print_as_image: bool

bPrintAsImage.

reverse: bool

bReverse.

annotations: bool

bAnnotations.

SubmitForm

Doc.submitForm — ExampleDocSubmitForm.

The most dangerous entry point in the object model, and the one where “hand back the data, do not act on it” matters most. No request is made; the URL and the bytes come back here for a host to decide about.

Fields

url: String

Where the script wanted to post.

data: Vec<u8>

What it wanted to post.

GotoPage(i32)

Doc.gotoNamedDest and page navigation — ExampleDocGotoPage.

NamedAction(String)

A named action fired from a non-JavaScript callback — ExampleNamedAction. named_action.in is its one fixture.

ConsolePrintln(String)

console.println. The oracle discards it, so this variant renders to nothing and is carried only so a host can see what a script logged.

FunctionAlert

An AF* function’s own alert, which is not routed through app.alert.

The function’s own name is the title, always with icon = 3 and button = 0 — so these render in the decorated form and appear unprefixed by Alert:, interleaved with the plain lines. Getting that interleaving right is a scoring requirement.

Fields

caller: String

The function’s own name, e.g. AFNumber_Keystroke.

message: String

The message.

Implementations

impl TranscriptLine

pub fn render(&self) -> Option<String>

The line the oracle would print, without its newline.

None for a shape that prints nothing — TranscriptLine::ConsolePrintln alone, because the oracle’s console methods are empty.

The alert decoration is conditional, and it is exact

Three forms, chosen by what differs from the default:

condition	line
default title, icon and type	Alert: <msg>
non-default title only	<title>: <msg>
non-default icon or type	<title>[icon=N,type=N]: <msg>

An AF* alert always takes the third form with icon=3,type=0, so it reads AFNumber_Keystroke[icon=3,type=0]: The input value is invalid. with no Alert: prefix.

pub fn alert(message: impl Into<String>) -> TranscriptLine

A default-decoration alert: the shape 1922 of the 2004 golden lines take.

Trait Implementations

impl Clone for TranscriptLine

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TranscriptLine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for TranscriptLine

impl PartialEq for TranscriptLine

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TranscriptLine