Каталог примеров

Все примеры-программы на flang лежат в одном каталоге — docs/examples/: 348 файлов в двадцати пяти наборах и одном полноразмерном проекте. Второго каталога с примерами в репозитории нет.

Число пересчитывается одной командой: git -c core.quotepath=false ls-files docs/examples | grep -c '\.flang$' → 348.

Наборы

Как прогонять

Примеры объявлены внутри функций, а не в отдельных файлах проверок, и прогоняются двоичным:

bootstrap/flang test docs/examples/rosetta/   # один набор
bootstrap/flang test docs/examples/           # весь каталог

Наборы считаются очень по-разному, и это стоит знать до запуска. На общей машине: leetcode — 82 файла, 806 примеров, около 14 секунд; crypto — 8 файлов, 1802 примера (своих 77, остальные — из модулей библиотеки, которые набор подключает), около 19 минут, потому что считает настоящие контрольные векторы AES и ECDSA. Файл, который двоичный не взял, он называет вместе с кодом отказа, а не пропускает молча.

Про library-api

library-api стоит в этом ряду особняком. Остальные наборы — программы: файл, а в нём объявления со своими примерами (у frameworks/ рядом с такими файлами лежит хозяин на TypeScript, см. ниже). library-api — проект: семь модулей на flang, из них один свой, со своей раскладкой каталогов. Пример показывает не HTTP, а границу: что уезжает в язык, где у куска логики есть выполняемый пример, и что остаётся хозяину. Хозяина в дереве нет: остаётся половина на flang, и она проверяется командой. Правила, выведенные из этой раскладки, собраны в Раскладке репозитория.

Под JS-фреймворками

docs/examples/frameworks/ — три приложения с одной границей: ядро логики написано на flang и напечатано в JavaScript (bootstrap/flang emit … --target js), а хозяин — JS-фреймворк. Хозяин держит сокет, HTTP, состояние формы и рендер, а решение зовёт у ядра. Признак границы тот же, что у docs/examples/host-boundary/ с хозяином на C: на flang пишется то, что решает; хозяину остаётся то, что ждёт и держит управление между решениями.

Напечатанный модуль лежит в printed/ каждого примера и самодостаточен: без зависимостей, идёт и в Node, и в браузере. Хозяин импортирует его напрямую (src/orders.controller.ts, src/App.tsx, src/App.vue). Значения на стыке: список → массив, запись → объект; записи строятся фабриками sozdat… из объектов с русскими ключами. Имена функций — транслитерация русских: «Обработать запрос» → obrabotatZapros, «Сумма корзины» → summaKorziny, «В римские» → vRimskie.

Что проверено на дереве: каждое ядро проходит bootstrap/flang check; у кода в printed/ стоит шапка с лицензией и командой переиздания; напечатанный модуль отвечает верно под node прямым вызовом:

cd docs/examples/frameworks/vue-roman && node --input-type=module -e \
  'import("./printed/roman_numerals.js").then(m => console.log(m.vRimskie(2024), m.izRimskih("MCMLXXXIV")))'
# MMXXIV 1984

Сборка хозяина — командами фреймворка из package.json каждого примера: npm install, npm run typecheck, npm run build. На дереве она не проверяется: ей нужны пакеты из сети. node_modules/ и dist/ в примеры не входят. Переиздать ядро — из корня дерева, например bootstrap/flang emit docs/examples/frameworks/vue-roman/core/roman-numerals.flang --target js --out docs/examples/frameworks/vue-roman/printed; файлы в printed/ печатает компилятор, руками их не правят.

Куда идти дальше

• Как учить язык дальше — порядок чтения, в котором примеры стоят четвёртым шагом;
• Разбор: 82 задачи с leetcode — что доказалось на живом коде, а что нет;
• Сокращатель ссылок и приложение в браузере — две программы, разобранные целиком.