awsum-examples

Example programs for the Awsum programming language (.aww files).

Examples

• hello/ — basic string concatenation, helper function, IO.Stdout.print + IO.Args.getArgs. Reads the first command-line argument from the IO chain (with the missing-arg case handled explicitly), decodes through the platform validator, prints the greeting.

Running

Install the Awsum compiler (see awsum-lang/awsum) and ensure awsum is on your PATH. Then from a checkout:

awsum run hello/Main.aww --program-type cli -t llvm -- "world"

Replace -t llvm with jvm / clr / wasm / js to compile through any other backend — the same program produces identical stdout on every target (see the language guarantees).

just test runs every example through all five backends in one step. just format formats every .aww in place via awsum format -i. just fix chains both.

Related

• Compiler: awsum-lang/awsum
• VSCode extension: awsum-lang/awsum-vscode
• Zed extension: awsum-lang/awsum-zed
• Tree-sitter grammar: awsum-lang/tree-sitter-awsum
• Website: awsum-lang.org

AI use

These example programs are developed with substantial usage of generative AI. Every generated change is reviewed, edited, and accepted by a human before it lands in the repository, and no output is shipped unedited.

License

Apache 2.0 — see LICENSE and NOTICE.