C Compiler Wrapper

Archiver, defaults to `ar`.

If generating intermediate files, store them in this directory

Presets for compiler optimizations, can be :release, :develop, and :debug, defaults to :develop.

C++ compiler, defaults to `c++`.

C++ standard to use as a 2 digit number, defaults to 11 on GCC-like compilers, 14 on msvc.

Extra C++ compiler flags to use during compilation

C standard to use as a 2 digit number, defaults to 99 on GCC-like compilers, 11 on msvc.

C compiler, defaults to `cc`.

Extra C compiler flags to use during compilation

Map of extra defines to use when compiling

List of dynamic libraries to use when compiling

Extra linker flags

List of libraries to use when compiling - can be static or dynamic depending on system.

List of .lib libraries to use when compiling with msvc

Path to vcvarsall.bat to use initialize MSVC environment. If unset, `msvc-find` will try to guess using typical install locations.

Extra flags to pass to pkg-config

Try to resolve circular or out-of-order dependencies between libraries by using --start-group and --end-group.
Some linkers support this by default, but not at all. Defaults to true on linux and macos.

List of static libraries to use when compiling

Operating system to assume is being used for target compiler toolchain

Optional setting to enable using `-rdynamic` or `-Wl,-export_dynamic` when linking executables.
This is the preferred way on POSIX systems to let an executable load native modules dynamically at runtime.
Defaults to true

Optional setting to enable using `(dyn *syspath*)` as the runtime path to load for Shared Objects. Defaults to true

Optional callback to process each CLI command and its inputs and outputs

(check-library-exists libname &opt binding test-source-code)

Check if a library exists on the current POSIX system. Will run a test compilation and return true if the compilation succeeds. Libname is passed directly to the compiler/linker, such as `-lm` on GNU/Linux.

(compile-and-link-executable to & sources)

Compile and link an executable C/C++ program. Return an array of commands.

(compile-and-link-shared to & sources)

Compile and link a shared C/C++ library. Return an array of commands.

(compile-and-make-archive to & sources)

Compile and create a static archive. Return an array of commands.

(compile-c from to)

Compile a C program to an object file. Return the command arguments.

(compile-c++ from to)

Compile a C++ program to an object file. Return the command arguments.

(link-executable-c objects to)

Link a C program to make an executable. Return the command arguments.

(link-executable-c++ objects to)

Link a C++ program to make an executable. Return the command arguments.

(link-shared-c objects to)

Link a C program to make a shared library. Return the command arguments.

(link-shared-c++ objects to)

Link a C++ program to make a shared library. Return the command arguments.

(load-settings settings)

Load settings from a snapshot of settings saved with `save-settings`.

(make-archive objects to)

Make an archive file. Return the command arguments.

(msvc-compile-and-link-executable to & sources)

Compile and link an executable C/C++ program. Return an array of commands.

(msvc-compile-and-link-shared to & sources)

Compile and link a shared C/C++ library. Return an array of commands.

(msvc-compile-and-make-archive to & sources)

Compile and create a static archive. Return an array of commands.

(msvc-compile-c from to)

Compile a C program with MSVC. Return the command arguments.

(msvc-compile-c++ from to)

Compile a C++ program with MSVC. Return the command arguments.

(msvc-find)

Find vcvarsall.bat and run it to setup the current environment for building. Uses `(dyn *msvc-vcvars*)` to find the location of the setup script, otherwise defaults to checking typical install locations for Visual Studio. Supports VS 2017, 2019, and 2022, any edition. Will set environment variables such that invocations of cl.exe, link.exe, etc. will work as expected.

(msvc-janet-import-lib)

Get path to the installed Janet import lib. This import lib is needed when create dlls for natives.

(msvc-link-executable objects to)

Link a C/C++ program with MSVC to make an executable. Return the command arguments.

(msvc-link-shared objects to)

Link a C/C++ program with MSVC to make a shared library. Return the command arguments.

(msvc-make-archive objects to)

Make an archive file with MSVC. Return the command arguments.

(msvc-setup?)

Check if MSVC environment is already setup.

(pkg-config & pkg-config-libraries)

Setup defines, cflags, and library flags from pkg-config.

(save-settings)

Get a snapshot of the current settings for various compiler flags, libraries, defines, etc. that can be loaded later.

(search-dynamic-libraries & libs)

Search for dynamic libraries on the current POSIX system and configure `(dyn *dynamic-libraries*)`. This is done by checking for the existence of libraries with `check-library-exists`. Returns an array of libraries that were not found.

(search-libraries & libs)

Search for libraries on the current POSIX system and configure `(dyn *libs*)`. This is done by checking for the existence of libraries with `check-library-exists`. Returns an array of libraries that were not found.

(search-static-libraries & libs)

Search for static libraries on the current POSIX system and configure `(dyn *static-libs*)`. This is done by checking for the existence of libraries with `check-library-exists`. Returns an array of libraries that were not found.

(visit-clean cmd inputs outputs message)

A visiting function that will remove all outputs.

(visit-do-nothing &)

A visiting function that has no side effects and therefor does nothing.

(visit-execute cmd inputs outputs message)

A function that can be provided as `(dyn *visit*)` that will execute commands.

(visit-execute-if-stale cmd inputs outputs message)

A function that can be provided as `(dyn *visit*)` that will execute a command if inputs are newer than outputs, providing a simple, single-threaded, incremental build tool. This is not optimal for parallel builds, but is simple and works well for small projects.

(visit-execute-quiet cmd inputs outputs message)

A function that can be provided as `(dyn *visit*)` that will execute commands quietly.

(visit-generate-makefile cmd inputs outputs message)

A function that can be provided as `(dyn *visit*)` that will generate Makefile targets.