zigcc 1.0.0

Util scripts aimed at simplifying the use of `zig cc` for compiling C, C++, Rust, and Go programs.

zigcc

Util scripts aimed at simplifying the use of zig cc{.verbatim} for compiling C, C++, Rust, and Go programs.

Why

In most cases, we can use following command to use Zig for compile

CC='zig cc' CXX='zig c++' ...

However in real world, there are many issues this way, such as:

• zig cc: parse -target and -mcpu/-march/-mtune flags according to clang #4911
• Targets compare: Rust to Zig
• unsupported linker arg
• Rust + `zig cc` CRT conflict. : rust

So this project was born, it will

• Convert target between Zig and Rust/Go
• Ignore link args when zig cc{.verbatim} throw errors, hopefully this will make compile successfully, WIP.

Install

pip3 install -U zigcc

This will install three executables:

• zigcc{.verbatim}, used for CC{.verbatim}
• zigcxx{.verbatim}, used for CXX{.verbatim}
• zigcargo{.verbatim} can used to replace cargo{.verbatim}, it will automatically set
  • CC{.verbatim} CARGO_TARGET_<triple>_LINKER{.verbatim} to zigcc{.verbatim}
  • CXX{.verbatim} to zigcxx{.verbatim}

Use in GitHub Action

Adding a step to your workflow like this:

- name: Install zigcc
  uses: jiacai2050/zigcc@v1
  with:
    zig-version: master

Then you can invoke zigcc{.verbatim} zigcxx{.verbatim} zigcargo{.verbatim} in following steps.

Config

There some are env variable to config zigcc:

• ZIGCC_FLAGS{.verbatim}, space separated flags, pass to zig cc. An example is set this to -fno-sanitize=undefined{.verbatim} to disable sanitize since they may break your programs. See Catching undefined behavior with zig cc

• ZIGCC_BLACKLIST_FLAGS{.verbatim}, space separated flags, used to filter flags zig cc{.verbatim} don't support, such as -Wl,-dylib{.verbatim} otherwise you could see errors below

  note: error: unsupported linker arg: -dylib
  

• ZIGCC_VERBOSE{.verbatim} Set to 1{.verbatim} enable verbose logs.