MDAT 1.3.1
dotnet add package MDAT --version 1.3.1
NuGet\Install-Package MDAT -Version 1.3.1
<PackageReference Include="MDAT" Version="1.3.1" />
paket add MDAT --version 1.3.1
#r "nuget: MDAT, 1.3.1"
// Install MDAT as a Cake Addin #addin nuget:?package=MDAT&version=1.3.1 // Install MDAT as a Cake Tool #tool nuget:?package=MDAT&version=1.3.1
mdAT - Tests automatiques en Markdown
mdAT
est une bibliothèque simple qui remplace les tests unitaires et d'intégration. Avec mdAT
, les développeurs peuvent écrire des tests unitaires de manière traditionnelle, mais sans avoir besoin d'ajouter de nombreuses données de test à partir de fichiers JSON, XML, YAML, ou d'utiliser manuellement [InlideData]
avec des objets JSON échappés.
Pour utiliser mdAT, suivez ces étapes :
- Créez un test MSTestV2 normal avec
[TestClass]
,[TestMethod]
. - Codez votre test unitaire de manière traditionnelle en utilisant Moq, si nécessaire, puis appelez la méthode que vous souhaitez tester.
- Ajoutez tous les paramètres souhaités à votre méthode de test, ils seront exposés pour être remplacés par le fichier de test Markdown de
mdAT
. - Ajoutez
[MarkdownTest("~/Tests/{method}.md")]
avec votre dossierTests
comme référentiel de cas (laissez-le vide au départ). - Assurez-vous d'entourer votre méthode testée avec
Verify.Assert()
, cela validera automatiquement le résultat JSON attendu, même s'il s'agit d'une exception. - Votre fichier de test
.md
sera généré automatiquement lors de la première exécution. Modifiez votre fichier.md
comme vous le souhaitez. - Profitez-en !
[TestClass]
public class Calc
{
[TestMethod]
[MarkdownTest("~/Tests/{method}.md")]
public async Task Add(int val1, int val2, string expected)
{
_ = await Verify.Assert(() => Task.FromResult(Add(val1, val2)), expected);
}
// Cas d'utilisation fictif
public static int Add(int val1, int val2)
{
return val1 + val2;
}
}
Tous les cas de test peuvent être stockés dans un seul fichier Markdown :
# Test de la méthode Add
Cas de test simple pour des tests d'addition.
## Cas 1
Essayons une simple addition `1 + 1` avec un résultat attendu de `2`
``````yaml
val1: 1
val2: 1
expected:
verify:
- type: match
data: 2
``````
## Case 2
``````yaml
val1: 212
val2: 2444
expected:
verify:
- type: match
data: 2656
``````
Avec mdAT
, les analystes et les développeurs peuvent travailler ensemble avec une source unique de tests, et les mainteneurs peuvent modifier et valider tous les tests localement ou sur un serveur de build.
mdAT - Markdown Auto-Tests
mdAT
is a simple library that replaces unit and integration tests. With mdAT
, developers can write unit tests in the traditional way, but without the need to add many test data from JSON, XML, YAML files, or use manual [InlideData]
with escaped JSON object.
To use mdAT
, follow these steps:
- Create a normal MSTestV2 with
[TestClass]
,[TestMethod]
. - Code your unit test in the traditional way using
Moq
, if needed, then call your method you want to test. - Add all your desired parameters to your test method, theses will be exposed to be replaced by
mdAT
markdown test file. - Add
[MarkdownTest("~/Tests/{method}.md")]
with yourTests
folder as cases repository (let it being empty in first place). - Ensure to surround your tested method with
Verify.Assert()
, it will automatically validate the JSON expected result, even if it is an exception. - Your
.md
test file will be autogenerated during the first run. - Edit your
.md
file as you wish. - Enjoy!
[TestClass]
public class Calc
{
[TestMethod]
[MarkdownTest("~/Tests/{method}.md")]
public async Task Add(int val1, int val2, string expected)
{
_ = await Verify.Assert(() => Task.FromResult(Add(val1, val2)), expected);
}
// Fake usecase
public static int Add(int val1, int val2)
{
return val1 + val2;
}
}
All test cases can be stored in a single markdown file:
# Test Add method
Simple test case for addition tests.
## Case 1
Let's try simple `1 + 1` expected to return `2`
``````yaml
val1: 1
val2: 1
expected:
verify:
- type: match
data: 2
``````
## Case 2
``````yaml
val1: 212
val2: 2444
expected:
verify:
- type: match
data: 2656
``````
Using mdAT
, analysts and developers can work together with a unique source of tests, and maintainers can edit and validate all tests locally or on a build server.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- LoxSmoke.DocXml (>= 3.6.1)
- Markdig (>= 0.37.0)
- Moq (>= 4.18.4)
- MSTest.TestFramework (>= 3.0.2)
- Newtonsoft.Json (>= 13.0.3)
- Quibble.Xunit (>= 0.2.51)
- System.Data.SqlClient (>= 4.8.6)
- YamlDotNet (>= 15.1.2)
-
net7.0
- LoxSmoke.DocXml (>= 3.6.1)
- Markdig (>= 0.37.0)
- Moq (>= 4.18.4)
- MSTest.TestFramework (>= 3.0.2)
- Newtonsoft.Json (>= 13.0.3)
- Quibble.Xunit (>= 0.2.51)
- System.Data.SqlClient (>= 4.8.6)
- YamlDotNet (>= 15.1.2)
-
net8.0
- LoxSmoke.DocXml (>= 3.6.1)
- Markdig (>= 0.37.0)
- Moq (>= 4.18.4)
- MSTest.TestFramework (>= 3.0.2)
- Newtonsoft.Json (>= 13.0.3)
- Quibble.Xunit (>= 0.2.51)
- System.Data.SqlClient (>= 4.8.6)
- YamlDotNet (>= 15.1.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.3.1 | 452 | 4/20/2024 |
1.3.0 | 112 | 4/20/2024 |
1.2.4 | 199 | 9/28/2023 |
1.2.3 | 130 | 9/28/2023 |
1.2.2 | 156 | 9/23/2023 |
1.2.1 | 150 | 9/8/2023 |
1.2.0 | 195 | 6/15/2023 |
1.1.6 | 181 | 5/29/2023 |
1.1.5 | 167 | 5/19/2023 |
1.1.4 | 161 | 5/11/2023 |
1.1.3 | 178 | 5/11/2023 |
1.1.2 | 191 | 5/5/2023 |
1.1.1 | 199 | 4/25/2023 |
1.1.0 | 186 | 4/25/2023 |
1.0.0 | 201 | 4/21/2023 |
1.0.0-rc7 | 149 | 4/21/2023 |
1.0.0-rc6 | 139 | 4/20/2023 |
1.0.0-rc4 | 126 | 4/20/2023 |
1.0.0-rc3 | 140 | 4/20/2023 |
1.0.0-rc2 | 143 | 4/19/2023 |
1.0.0-rc1 | 139 | 4/16/2023 |
1.0.0-beta7 | 148 | 4/14/2023 |
1.0.0-beta6 | 147 | 4/14/2023 |
1.0.0-beta5 | 144 | 4/14/2023 |
1.0.0-beta4 | 144 | 4/5/2023 |
1.0.0-beta3 | 137 | 4/5/2023 |
1.0.0-beta2 | 142 | 4/3/2023 |
1.0.0-beta1 | 122 | 4/3/2023 |