Zig Language Support plugin

This a plugin for KDevelop that adds language support for Zig. It uses zig's builtin parser via a library.

Features

Syntax error messages
Syntax highlighting of structs, fns, enums. Rainbow colored local vars
Goto decl, view doc comments on hover.
Highlight usages on hover, lookup uses of fns, vars, etc..
Resolve imports from zig std lib and user defined packages
Evalutate some comptime expressions (enum switches, if exprs, basic math exprs)
Basic typed fn resolution for fns that return structs or typed params (still WIP)
Hints for type mismatches, missing args, invalid enum/struct fields, etc..

Screenshots

Resolving basic math expressions

The following shows it is able to resolve methods of a USBCDC driver using zig's builtin buffered writer to print.

Compiling

First, build and install kdevelop from source so the test libraries are availble.

Build kdev-zig

You must have zig installed somewhere where FindZig.cmake will find it (eg ".local/bin").

To build use:

mkdir build
cd build
cmake -G ninja -DBUILD_TESTING=OFF ..
ninja install

Use zig test duchain/kdevzigastparser.zig to run zig tests. Comple with BUILD_TESTING=ON and run the duchaintest for kdev-zig tests. This may require require a locally built KDevelop for it to find the test dependencies.

In case you run into problems/crashing with it use ninja uninstall to remove it.

To enable debug logging set the following env var.

export QT_LOGGING_RULES="kdevelop.languages.zig.duchain.debug=true;"

Running

Note: Make sure you have a file assoication setup for zig in "File associations" or it will not parse files. In KDE Plasma add a new entrytext/x-zig for all *.zig files.

Build and install, set the zig file association, and then run KDevelop.

Versions

kdev-zig currently supports zig 0.12.0, 0.13.0, and 0.14.0 however due to ast changes in zig it cannot support all versions at once.

For zig 0.14.0 use the master branch
For zig 0.12.0 and 0.13.0 use the kdev-zig v0.13.0 tag.

License

It was forked from kdev-rust and borrows code from kdev-python so licensed under the GPL.

README