Help needed: how to contribute to the cpp project? Missing 'CONTRIBUTING' kind of guide.

[daantimmer]

🤔 What's the problem you've observed?

I would like to contribute to the cpp project. But am not able to spin up a development environment (easily).

We don't have a development environment on our machines. All development is done through devcontainers. Setting up a container for the cpp project seems tedious and there are undocumented dependencies in order to build the cpp project.

✨ Do you have a proposal for making it better?

Add a devcontainer configuration for the cpp project. With dependencies either pre-installed or through a shell script.

📚 Any additional context?

No response

[daantimmer]

Tagging @chybz since they are the original authors of the cpp project.

@chybz I would like to contribute some possible improvements on an API/structure level. But setting up an environment where I can build and test the cpp project seems quite tedious. Please advice :-)

[chybz]

Hey @daantimmer ! Thanks for your message and suggestion. While I may not have the time right now to author a CONTRIBUTING.md(should be possible at the end of this week), do you think looking at test-cpp.yml could help you in any way ?

[daantimmer]

Hello @chybz do you happen to have a more direct way of contact not via github? I have some thoughts I would like to discuss, but preferably via some other medium.

To respond to your suggestion. Yes, test-cpp.yml was of help. Although for some reason the cc build failed with linker errors. clang worked fine. Probably the (g)cc issue is on my side. Something something PEBKAC.

Some questions regarding the build environment:

• what is cmate, google isn't helpful

• instead of using cmate, you can use FetchContent(_Declare) to get both the cucumber_messages and nlohmann_json dependencies.

  • this allows configuring/building directly without the need for an additional 'get dependency' step.

• in general it is ill advised to use globbing for source/header files

• in some preliminary testing I've found it is easier to not use the cmake/cmate tools, and use what cmake has to offer directly:

  • use fetchcontent as above
  • use CMakePreset.json. Example:
  • cmake --preset host. <- to configure for:
  • cmake --build --preset host-release. (Build only) or
  • cmake --build --preset host-install. (Build and install)

• The code/api suggestions that I have are more related to the way cucumber/messages/cpp works. Shall I discuss those here or there?