Skip to main content

hyc

hyc is the Hylang compiler. It compiles .hy files and .hyproj projects to native binaries via a C backend.

Usage​

hyc build <file.hy | project.hyproj> [options]

Options​

OptionDescription
-o <path>Output path for the binary or library
--target libBuild a static library (.a) instead of an executable

Examples​

# Compile a single file to an executable
build/hyc build hello.hy -o build/hello
./build/hello

# Compile a project
build/hyc build MyApp.hyproj -o build/myapp
./build/myapp

# Build a static library
build/hyc build Math.hyproj --target lib -o build/libmath.a

How it works​

  1. The source is parsed, bound, and type-checked by the shared compiler pipeline.
  2. The bound IR is lowered to a single C translation unit.
  3. The host C compiler (cc) is invoked to produce the final binary.

The C backend is the primary output path for the current bootstrap. A native x64 backend is planned for a later phase.

Runtime notes​

  • Compiled output uses the current bootstrap managed runtime.
  • Managed strings and general T[] arrays are supported.
  • Runtime stress/debug controls:
HYLANG_GC_STRESS=1 ./build/myapp
HYLANG_GC_THRESHOLD=128 ./build/myapp