This repo provides a template for Project Euler participants using Zig. It contains a main file for each problem, a build.zig file set up with targets for each problem, and Visual Studio Code files for debugging.
This template has been tested with Zig 0.12.0-dev.1754+2a3226453. It may not work with other versions.
The src/ directory contains a main file for each problem. Put your code there. The build command zig build problemXXX [target and mode options] -- [program args] will build and run the specified problem. You can also use zig build install_problemXXX [target and mode options] to build the executable for a problem and put it into zig-out/bin without executing it. By default this template does not link libc, but you can set should_link_libc to true in build.zig to change that. If you add new files with tests, add those files to the list of test files in test_all.zig. The command zig build test will run tests in all of these files. You can also use zig build test_problemXXX to run tests in a specific problem, or zig build install_tests_problemXXX to create a debuggable test executable in zig-out/bin.
This repo also contains Visual Studio Code project files for debugging. These are meant to work with the C/C++ plugin. There is a debug configuration for each problem. By default all problems are built in debug mode, but this can be changed by editing .vscode/tasks.json if you have a need for speed.
If you would like to contribute project files for other development environments, please send a PR.
You can modify the template to add your own changes across all problems. To do so, modify template/template.zig and then run zig build generate. The $ character in the template will be replaced by the three-digit problem number (e.g. 004 or 107). This step will only overwrite files which have not been modified, so you will not lose work if you update the template after implementing several problems. After updating the template and generating, you should commit the changes to template/hashes.bin in addition to the updated template and source files. This will ensure that the newly generated files are not considered modified if you update the template again.
Zig has a reasonably robust language server, which can provide autocomplete for VSCode and many other editors. It can help significantly with exploring the std lib and suggesting parameter completions. The VSCode extension (augusterame.zls-vscode) will automatically install the language server in the background. If you are using a different editor, follow their install instructions. If you want to install a specific version of the language server (for example for maximum compatibility with 0.10.0), check their releases page or follow their instructions to build from source. Note that ZLS tracks master, so if you are using Zig 0.10.0 you may need to download a newer version to build ZLS.
Thanks to Martin Wickham for the Zig AoC Template that this is based off of.