Derive C

Easy templated data structures in C

Elevator Pitch

When using C for complex projects, the lack of generics is frustrating:

• tradeoff performance and store runtime type information (e.g. size of items in a vector)
• tradeoff usability and restrict sizes of types, use unions (e.g. vector of only 8 byte items, user must cast to their own type, debuggers unaware of real type)
• tradeoff readability & development speed by outsourcing data structure generation to another language (cmake calling python to generate headers)
• tradeoff tooling for formatting, linting & intellisense with complex preprocessor macros to generate data structures

Derive-C aims to avoid these, and to get an experience close to simple templates in C++:

• templates are edittable (with intellisense), lintable, formattable independent of their usage.
• instances of templates should be clangd friendly / show types & completions
• no performance tradeoff
• easy to debug with in GDB

See examples in ./examples See the dev guide in in .github/CONTRIBUTING.md.

Use

In a CMakeLists.txt

include(FetchContent)

FetchContent_Declare(
    derive-c
    GIT_REPOSITORY https://github.com/OliverKillane/derive-C
    GIT_TAG <Chosen derive-c version>
)
FetchContent_MakeAvailable(derive-c)

target_compile_definitions(${my_target} PRIVATE
    # Enable free function mocking for tests
    ENABLE_MOCKING  

    # To override the default behaviour for `DC_PANIC`, `DC_ASSERT
    DC_PANIC_HEADER=<my-special-library/foo/derive_c_panic_overrides.h> 
)

References

• moving-fast-with-software-verification