12. System resources

Canonical source: protos/tutorials/12-system-resources/ at locked revision e99b712ecf658a527b1fe82c8beba2c1286d8dc9.

These are the executable tutorial sources from the exact Protos revision consumed by this website. The fenced program bodies are copied without modification. The tutorials are explanatory and non-normative; the applicable specification remains authoritative.

01 — Process stream output

Canonical source protos/tutorials/12-system-resources/01-process-stream-output.protos

/*
 * THE LICENSED WORK IS PROVIDED UNDER THE TERMS OF THE ADAPTIVE PUBLIC LICENSE
 * ("LICENSE") AS FIRST COMPLETED BY: Guillermo Adrián Molina. ANY USE, PUBLIC
 * DISPLAY, PUBLIC PERFORMANCE, REPRODUCTION OR DISTRIBUTION OF, OR PREPARATION OF
 * DERIVATIVE WORKS BASED ON, THE LICENSED WORK CONSTITUTES RECIPIENT'S ACCEPTANCE
 * OF THIS LICENSE AND ITS TERMS, WHETHER OR NOT SUCH RECIPIENT READS THE TERMS OF
 * THE LICENSE. "LICENSED WORK" AND "RECIPIENT" ARE DEFINED IN THE LICENSE. A COPY
 * OF THE LICENSE IS LOCATED IN THE TEXT FILE ENTITLED "LICENSE.TXT" ACCOMPANYING
 * THE CONTENTS OF THIS FILE.
 */

ProcessStreams: import("std:io/ProcessStreams")

// ProcessStreams consumes the Process-selected Encoding. Closing this borrowing
// TextWriter closes only the wrapper, so later Process output remains available.
writer: ProcessStreams.stdoutWriter(process)
writer.writeLine("Process output uses explicit Process authority").value()
writer.close().value()

print(process.args().size())

02 — Filesystem text roundtrip

Canonical source protos/tutorials/12-system-resources/02-filesystem-text-roundtrip.protos

/*
 * THE LICENSED WORK IS PROVIDED UNDER THE TERMS OF THE ADAPTIVE PUBLIC LICENSE
 * ("LICENSE") AS FIRST COMPLETED BY: Guillermo Adrián Molina. ANY USE, PUBLIC
 * DISPLAY, PUBLIC PERFORMANCE, REPRODUCTION OR DISTRIBUTION OF, OR PREPARATION OF
 * DERIVATIVE WORKS BASED ON, THE LICENSED WORK CONSTITUTES RECIPIENT'S ACCEPTANCE
 * OF THIS LICENSE AND ITS TERMS, WHETHER OR NOT SUCH RECIPIENT READS THE TERMS OF
 * THE LICENSE. "LICENSED WORK" AND "RECIPIENT" ARE DEFINED IN THE LICENSE. A COPY
 * OF THE LICENSE IS LOCATED IN THE TEXT FILE ENTITLED "LICENSE.TXT" ACCOMPANYING
 * THE CONTENTS OF THIS FILE.
 */

Files: import("std:io/Files")

// This lesson requires the host to provision the bootstrap-local `filesystem`
// capability. The ordinary standalone application CLI intentionally does not do so.
path: Path.relative().child("tutorial-system-resource.txt")
Files.writeAllText(
    filesystem,
    path,
    "explicit filesystem authority",
    Encoding.UTF8
).value()

Files.readAllText(filesystem, path, Encoding.UTF8).value() ==
    "explicit filesystem authority"

← Actor groups · Tutorials index