denv-cpp/README.md

Template for C++ based projects
- environment: **Docker** container
- IDE: **VsCode**
- build system: **CMake** 
- 3rd party libraries: **vcpkg**
- testing: **Catch2**

# Development Environment

```bash
./denv/build.sh    # create denv image
./denv/run-vsc.sh  # run container & attach VsCode instance to it
```
# CMake and CTests

CTest integration within VsCode is limited - it does not provide link between test case source and test shown in *TestExplorer* view.

**Solution**
1. Disable (CMake > CTest: `Test Explorer Integration` Enabled)
2. Install *TestMate* extension
   It scans the build tree for xxx_test binaries and has neat integration with Catch2. 
3. You need to enable `rebuild on save` in order for tests in *TestExplorer* to automatically reflect changes in the code. If none - use F7 to rebuild project.
first prototype 2024-05-26 17:59:17 +02:00			`Template for C++ based projects`
			`- environment: Docker container`
			`- IDE: VsCode`
			`- build system: CMake`
			`- 3rd party libraries: vcpkg`
			`- testing: Catch2`
Initial commit 2024-05-26 17:41:09 +02:00
first prototype 2024-05-26 17:59:17 +02:00			`# Development Environment`

			```bash
			`./denv/build.sh # create denv image`
			`./denv/run-vsc.sh # run container & attach VsCode instance to it`
			```
			`# CMake and CTests`

			`CTest integration within VsCode is limited - it does not provide link between test case source and test shown in TestExplorer view.`

			`Solution`
			1. Disable (CMake > CTest: `Test Explorer Integration` Enabled)
			`2. Install TestMate extension`
			`It scans the build tree for xxx_test binaries and has neat integration with Catch2.`
			3. You need to enable `rebuild on save` in order for tests in TestExplorer to automatically reflect changes in the code. If none - use F7 to rebuild project.