Unofficial mirror of https://github.com/ziglang/zig
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
LemonBoy 8516ee392c Fix parsing of DW_AT_Ranges debug entry 15 hours ago
.builds ci: avoid leaking oauth access token 2 months ago
.github funding: I've been accepted into the GitHub Sponsors program 6 months ago
ci CI: update llvm apt sources to correct ubuntu version 1 month ago
cmake cmake: support `make` and `make install` 1 week ago
deps Revert LLD patch 3 months ago
doc Merge pull request #4191 from Vexu/non-exhaustive-enums 1 week ago
lib Fix parsing of DW_AT_Ranges debug entry 7 hours ago
src translate-c: Don't make const parameters mutable. (#4273) 1 day ago
src-self-hosted translate-c: Don't make const parameters mutable. (#4273) 1 day ago
test translate-c: Don't make const parameters mutable. (#4273) 1 day ago
tools Fix remaining variadic formatted prints 2 weeks ago
.gitattributes git, I love you, but please stop mangling my files 4 months ago
.gitignore fix .gitignore file and add commit missing std lib file 11 months ago
CMakeLists.txt cmake: support `make` and `make install` 1 week ago
CONTRIBUTING.md cmake: support `make` and `make install` 1 week ago
LICENSE add license 4 years ago
README.md update readme tagline 3 weeks ago
build.zig add test harness for "run translated C" tests 3 weeks ago

README.md

ZIG

A general-purpose programming language and toolchain for maintaining robust, optimal, and reusable software.

Resources

Building from Source

Build Status

Note that you can download a binary of master branch.

Stage 1: Build Zig from C++ Source Code

Dependencies

POSIX
  • cmake >= 2.8.5
  • gcc >= 5.0.0 or clang >= 3.6.0
  • LLVM, Clang, LLD development libraries == 9.x, compiled with the same gcc or clang version above
Windows
  • cmake >= 3.15.3
  • Microsoft Visual Studio. Supported versions:
    • 2015 (version 14)
    • 2017 (version 15.8)
    • 2019 (version 16)
  • LLVM, Clang, LLD development libraries == 9.x

Instructions

POSIX
mkdir build
cd build
cmake ..
make install
MacOS
brew install cmake [email protected]
brew outdated [email protected] || brew upgrade [email protected]
mkdir build
cd build
cmake .. -DCMAKE_PREFIX_PATH=$(brew --prefix llvm)
make install
Windows

See https://github.com/ziglang/zig/wiki/Building-Zig-on-Windows

Stage 2: Build Self-Hosted Zig from Zig Source Code

Note: Stage 2 compiler is not complete. Beta users of Zig should use the Stage 1 compiler for now.

Dependencies are the same as Stage 1, except now you can use stage 1 to compile Zig code.

bin/zig build --prefix $(pwd)/stage2

This produces ./stage2/bin/zig which can be used for testing and development. Once it is feature complete, it will be used to build stage 3 - the final compiler binary.

Stage 3: Rebuild Self-Hosted Zig Using the Self-Hosted Compiler

Note: Stage 2 compiler is not yet able to build Stage 3. Building Stage 3 is not yet supported.

Once the self-hosted compiler can build itself, this will be the actual compiler binary that we will install to the system. Until then, users should use stage 1.

Debug / Development Build

./stage2/bin/zig build --prefix $(pwd)/stage3

Release / Install Build

./stage2/bin/zig build install -Drelease