Joshua Potter 27bc9f7283 | ||
---|---|---|
.. | ||
.githooks | ||
.clang-format | ||
.envrc | ||
.gitignore | ||
Doxyfile | ||
README.md | ||
default.nix | ||
flake.lock | ||
flake.nix | ||
main.c |
README.md
Clang Flake Template
This is a template for constructing a working environment for C development with the clang (version 16.0.6) toolchain.
direnv can be used to launch a dev shell upon entering
this directory (refer to .envrc
). Otherwise, run via:
nix develop
Language Server
The clangd LSP (version 14.0.6) is included in this flake. The codelldb VSCode plugin is also included to interface with the LSP. Note this plugin, despite its name, is compatible with other editors (e.g. neovim). To configure, refer to your editor's documentation.
To use the LSP across files, a compilation database
must be generated. For this reason, bear
(version 3.1.3) is included in this flake. Use as follows to generate a
compile_commands.json
file:
$> bear -- <your-build-command>
Documentation
Documentation is generated using Doxygen (version 1.9.7). The included Doxyfile was generated by running:
$> doxygen -g
(Re)generate documentation by editing the Doxyfile
and running:
$> doxygen
Formatting
Formatting depends on the clang-format
(version 14.0.6) tool. Refer to .clang-format
for default formatting options.
A pre-commit
hook is included in .githooks
that can be used to format all
*.c$
and *.h$
files prior to commit. Install via:
$> git config --local core.hooksPath .githooks/
If running direnv, this hook is installed automatically.