pearlcd

pearlcd is a small compiler project for the Pearl language.

Current state:

• the project builds with CMake and Flex
• the project also builds with Bison for the parser
• the CLI accepts input files and a --lex mode
• the lexer prints tokens with line numbers
• the parser works in --parse mode and prints a simple AST
• the compiler now has a --check mode for basic symbol and scope checks
• the concept docs describe the current KISS-first direction

Quick start:

cmake -S . -B build
cmake --build build
./build/pearlcd --lex examples/hello.prl
./build/pearlcd --parse examples/test.prl
./build/pearlcd --check examples/test.prl

The current focus is cleaner grammar rules, a slightly richer AST shape, and a small semantic layer for names and scopes. After that, CI/CD and release builds will be added.

Parser status:

• Parser grammar cleanup is in progress to remove remaining Bison conflicts (see build/parser.output for details). The current changes add operator precedence and refactor call/primary productions to reduce ambiguity.

Repository note:

• build/ is ignored so generated files do not pollute the working tree.

Cross-platform build helper

A simple helper script is provided to configure and build the project using optional toolchain files in the toolchain/ directory. It can be used like:

# Configure+build with default system toolchain
bash scripts/build.sh

# Configure+build for macOS (uses toolchain/macos.cmake)
bash scripts/build.sh macos

# Configure+build with a different output directory
bash scripts/build.sh macos out/build-macos

Available toolchain names: linux, macos, mingw, msvc (map to files in toolchain/). If no toolchain is provided the system default compiler is used. For cross-compilation on Windows or other systems you can pass the appropriate toolchain file via this helper.

Packaging and Releases:

• Use scripts/package_release.sh to build a Release binary, create a compressed archive and a SHA256 checksum locally. Example:

bash scripts/package_release.sh dist
ls -l dist
cat dist/pearlcd-linux.tar.gz.sha256

• The Release GitHub Actions workflow will also produce archives and SHA256 checksums and attach them to the Release when published.

Documentation:

• Main docs live in docs/tr/index.md and docs/en/index.md.
• Build rendered HTML/PDF output with bash scripts/docs.sh [tr|en|all].