Компилятор qumirc

qumirc — компилятор языка Qumir. Преобразует исходный код в машинный код, ассемблер, LLVM IR или WebAssembly.

Использование

qumirc [опции] <входной_файл.kum>

Опции командной строки

Режимы компиляции

Нативный исполняемый файл

По умолчанию компилятор создаёт исполняемый файл для текущей платформы:

qumirc программа.kum
./a.out

С указанием имени:

qumirc программа.kum -o программа
./программа

Объектный файл

qumirc -c программа.kum
# Создаёт программа.o

Ассемблер

qumirc -S программа.kum
# Создаёт программа.s

LLVM IR

qumirc --llvm программа.kum
# Создаёт программа.ll

Или с указанием имени:

qumirc --llvm -o output.ll программа.kum

WebAssembly

qumirc --wasm программа.kum -o программа.wasm

Требования: установленный wasm-ld (часть LLVM).

Уровни оптимизации

Пример:

qumirc -O3 программа.kum -o программа_opt

Примеры

Компиляция простой программы

# Создаём файл hello.kum
cat > hello.kum << 'EOF'
алг
нач
    вывод "Привет, мир!", нс
кон
EOF

# Компилируем
qumirc hello.kum -o hello

# Запускаем
./hello

Просмотр промежуточных представлений

# AST (абстрактное синтаксическое дерево)
qumirc --ast программа.kum
cat программа.ast

# IR (внутреннее представление)
qumirc --ir программа.kum
cat программа.ir

# LLVM IR
qumirc --llvm программа.kum
cat программа.ll

Компиляция для веба

qumirc --wasm программа.kum -o программа.wasm

Полученный .wasm файл можно использовать в браузере с JavaScript:

const bytes = await fetch('программа.wasm').then(r => r.arrayBuffer());
const { instance } = await WebAssembly.instantiate(bytes, imports);
instance.exports.main();

Оптимизированная сборка

# Максимальная оптимизация
qumirc -O3 benchmark.kum -o benchmark

# Сравнение размера
qumirc -O0 benchmark.kum -o benchmark_O0
qumirc -O3 benchmark.kum -o benchmark_O3
ls -la benchmark_O0 benchmark_O3

Выходные файлы

Коды возврата

Интеграция с другими инструментами

Использование объектных файлов

# Компиляция в объектный файл
qumirc -c модуль1.kum
qumirc -c модуль2.kum

# Линковка с помощью clang/gcc
clang модуль1.o модуль2.o -o программа

Просмотр ассемблера

qumirc -S -O3 программа.kum
less программа.s

См. также

• Интерпретатор qumiri
• Синтаксис языка