!!! warning This is a prototype. There is a lot to do before it can be distributed and used in production, see the GitHub Issues and the project roadmap
This is not a standalone Testcontainers engine, but a C-style shared library adapter for native languages like C/C++, D, Lua, Swift, etc. It is an MVP SDK that can be later extended for the languages. The project is based on Testcontainers for Go which is one of the most powerful Testcontainers implementations.
Contributions and feedback are welcome!
Also join the #testcontainers-c channel on the Testcontainers Slack.
- Minimum viable Testcontainers API functionality: starting and terminating containers, passing files, exposing ports, accessing container logs, etc.
- Minimum HTTP client wrapper to simplify requests and assertions
- Testcontainers for Go under the hood, with all its reporting and resource management capabilities. Memory might leak a lot in the current versions, but we do not want containers to leak :)
- Support for C, C++, Swift and other native projects.
- C-style header file for the library. A fancy C++ wrapper is coming soon
- Support for Testcontainers Modules
This is what a very simple run without a test framework may look like.
Follow the Getting Started Guide.
It is advised to include CMake as a dependent module for now. If you like living dangerously until proper vcpkg and Conan packages are ready, you can optionally install the library to your system:
# NOT RECOMMENDED
cmake --install ..See the examples and demos for more examples.
TL;DR: You get the C header file, a shared library object or a DLL file from the Testcontainers C module, Then, you know the drill. Feel free to contribute examples or SDKs for the languages!
Using a complex Golang framework from C/C++ is not trivial. Neither the CMake files are. This project would not succeed without many quality articles and help from the community.
Kudos to:
- All Testcontainers, Golang C-Shared build mode, CGO and WireMock contributors!
- Manuel de la Peña for maintaining Testcontainers for Go and answering bizarre questions about the implementations
:-) - Vladimir Vivien for Calling Go Functions from Other Languages using C Shared Libraries
- Ben McClelland for An Adventure into CGO - Calling Go code with C
- Insu Jang for Implementing Kubernetes C++ Client Library using Go Client Library
- Infinite number of StackOverflow contributors