Skip to content

august.io ​

Supplied with the compiler. Import public names from august.io.

Signatures show result types and checked errors. See packages to pin a release and language constructs for built-in types.

Console ​

text
capability Console

Permission to write to a console, provided by an explicitly selected adapter.

Source

Console.write ​

text
write<T>(T value)

Write one line of text.

Parameters

  • value: Text to display.

Uses Console.write.

Source

SystemConsole ​

text
SystemConsole() implements Console

The native standard-output adapter. Construction performs no output.

Source

SystemConsole.write ​

text
write<T>(T value)

Write one line of text.

Parameters

  • value: Text to display.

Uses Console.write.

Source

FileReader ​

text
capability FileReader

Read UTF-8 text through an explicitly selected filesystem adapter.

Source

FileReader.read ​

text
read(string path) returns string unless FileError

Read text.

Parameters

  • path: File path.

Throws

  • FileError: The file could not be read.

Uses FileReader.read.

Source

FileWriter ​

text
capability FileWriter

Write UTF-8 text through an explicitly selected filesystem adapter.

Source

FileWriter.write ​

text
write(string path, string content) unless FileError

Write text.

Parameters

  • path: File path.
  • content: Text.

Throws

  • FileError: Writing failed.

Uses FileWriter.write.

Source

LocalFiles ​

text
LocalFiles() implements FileReader, FileWriter

Native filesystem adapter. Construction opens no files.

Source

LocalFiles.read ​

text
read(string path) returns string unless FileError

Read text.

Parameters

  • path: File path.

Throws

  • FileError: The file could not be read.

Uses FileReader.read.

Source

LocalFiles.write ​

text
write(string path, string content) unless FileError

Write text.

Parameters

  • path: File path.
  • content: Text.

Throws

  • FileError: Writing failed.

Uses FileWriter.write.

Source

Arguments ​

text
capability Arguments

Read command-line input through an explicit dependency.

Source

Arguments.read ​

text
read() returns List<string>

Uses Arguments.read.

Source

ProcessArguments ​

text
ProcessArguments() implements Arguments

Native command-line arguments.

Source

ProcessArguments.read ​

text
read() returns List<string>

Uses Arguments.read.

Source

The world runs on language