https://github.com/JohnnyHendriks/TestAdapter_Catch2

Visual Studio Test Adapter for Catch2
https://github.com/JohnnyHendriks/TestAdapter_Catch2

Last synced: about 2 months ago
JSON representation

Visual Studio Test Adapter for Catch2

• Host: GitHub
• URL: https://github.com/JohnnyHendriks/TestAdapter_Catch2
• Owner: JohnnyHendriks
• License: mit
• Created: 2018-06-24T09:45:48.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2023-12-12T07:58:45.000Z (about 1 year ago)
• Last Synced: 2024-08-04T02:11:08.076Z (5 months ago)
• Language: C++
• Size: 3.19 MB
• Stars: 106
• Watchers: 9
• Forks: 28
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• AwesomeCppGameDev - TestAdapter_Catch2

README

        
# Test Adapter for Catch2

Within Visual Studio, the Test Explorer is a convenient way to run and debug unit tests. This test adapter adds support for the [Catch2 C++ test framework](https://github.com/catchorg/Catch2) (version 2.x and 3.x). This adapter is for use in combination with Visual Studio 2017 and later.

## How to get it

The **Test Adapter for Catch2** is available via the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=JohnnyHendriks.ext01). It is available under the name "Catch Adapter for Catch2". The easiest way to get it is via "Extensions and Updates..." in the "Tools" menu. Of course you can also [build it yourself](Docs/Build.md).

## A note on usage

 Out of the box the extension does not discover tests. You need to add settings for the **Test Adapter for Catch2** to a _.runsettings_ file and use that as your test settings. This prevents the discovery mechanism from running non-Catch2 executables in your solution upon first use. See the [Walkthrough](Docs/Walkthrough-vs2022.md) for a detailed description on how to use the **Test Adapter for Catch2**.

## Documentation

For documentation on the **Test Adapter for Catch2** see the following links.

- [Overview (_all documentation_)](./Docs/Readme.md)

- [Walkthrough: using the Test Adapter for Catch2](./Docs/Walkthrough-vs2022.md)

- [Configure runsettings (_use cases_)](./Docs/Runsettings.md)

- [Troubleshooting guide](./Docs/Troubleshooting.md)

- [Change log](./Docs/CHANGELOG.md)