Zekken Documentation

Examples

Core Examples#

• examples/syntax.zk - language walkthrough (declarations, control flow, calls, casts, modules).
• examples/file.zk - file read/write example.
• examples/donut.zk - ASCII spinning donut animation.
• examples/fibonacci.zk - recursive Fibonacci.
• examples/bmi_calc.zk - input + numeric calculation.

Test Scripts#

• tests/type_methods.zk - method and cast coverage.
• tests/errors.zk - syntax/type/reference/runtime failures.
• tests/test.zk - general runtime test script.
• tests/input.zk - input handling.
• tests/json_data.zk - JSON parsing via @parse_json.
• tests/include/main.zk - include/export usage (pairs with tests/include/export.zk).

Benchmarks#

These are runnable, repeatable scripts used to track performance over time:

• benchmarks/cpu_numeric.zk - numeric CPU loop throughput.
• benchmarks/branch_calls.zk - branch-heavy logic + calls.
• benchmarks/queue_cleanup.zk - queue growth + cleanup behavior.
• benchmarks/file_io_transform.zk - file I/O + transformations.
• benchmarks/matrix_mixed.zk - mixed numeric + loop workload.

Run Any Example#

zekken run examples/syntax.zk
zekken run tests/type_methods.zk
zekken run tests/include/main.zk
zekken run benchmarks/cpu_numeric.zk