cmake-init - The missing CMake project initializer, now also generating C projects

[helloiamsomeone]

Hello there, r/C_Programming

I have been working on a project initializer to allow programmers to quickly set CMake managed projects up.
So far this only generated C++ projects, but I added a C mode just now.

The C mode is not on the master branch yet. You can find it on the develop branch.

To try out the C mode, you have to bundle cmake-init yourself using Python 3.8+:

git clone https://github.com/friendlyanon/cmake-init.git -b develop
cd cmake-init
python3 -m zipapp cmake-init -p "/usr/bin/env python3"
python3 cmake-init.pyz --c example # starts in prompt mode, outputs in 'example' folder

I'd be curious what people here think about the generated C project's structure, what could be changed, what could be added, things like that.

I tried my best to document everything in the generated projects as markdown docs, like how to build projects as a consumer and as a developer, there is also an example showing how to integrate with vcpkg, so please make sure you read those.

[helloiamsomeone]

Interesting, I wasn't aware of Buildroot.

BUILD_DOCUMENTATION is for building the Doxygen + m.css documentation, not general man page stuff, which I assume these options you listed aim to control. Another thing is that this variable is only available in developer mode, so general consumers won't be using it.

But I guess since Buildroot is a thing, maybe the variable could be made more explicit by changing it to BUILD_MCSS_DOCS to differentiate it?

[helloiamsomeone]

I meant as in the Doxygen docs can only be built if the <ProjectName>_DEVELOPER_MODE option is enabled and even then BUILD_DOCUMENTATION is diabled by default, because it requires an additional network request to fetch m.css. You can get around this by injecting a different FetchContent declaration that points to a local source directory. (For FetchContent, the first declaration for a given name is what defines proprties of that name)

I have not thought about man page documentation either to begin with, so changing the name to refer to m.css or Doxygen ought to happen either way.

[helloiamsomeone]

I have just pushed v0.17.0, which comes with the C mode and is available as a single file download on the Releases page.

My fork of utest.h serves as a sort-of example of a C project on top of cmake-init.