HelpersUnit 1.0.0

HelpersUnit

Il a pour but d'aider dans la création des tests unitaires. C'est un ensemble d'outils (helpers, extensions,...).

Docs - Helpers

MoqHelper

La class MoqHelper est une aide pour la création de Mock.

• public IEnumerable<Mock> CreateMockParamsConstructor<T>(params Type[] constructorTypes)
  Crée les Mock des paramètres du constructeur du type passé. Si la liste params est vide, il prendra le premier constructeur qu'il trouve.
  Pour selectionner le constructeur (si plusieurs), il faut passer la liste de type qui sont présent dans ce constructeur.
  Ensuite, il suffit de récupérer le Mock voulu pour lui ajouter des comportements.

Exemple complet :

#region Arrange
    
MoqHelper moqHelper = new MoqHelper();
// Permet de créer une liste de mock de chaque paramètre du constructeur.
// la class UnSuperController a 24 paramètres.
IEnumerable<Mock> allMockParams = moqHelper.CreateMockParamsConstructor<UnSuperController>();

// Méthode d'extension pour récupérer un Mock particulier de la liste.
Mock<IWebDetailsService> mockOffre = allMockParams.GetMock<IWebDetailsService>();
mockOffre.Setup(x => x.GetDetailViewModel(123, 666, false, false))
         .Returns(new DetailViewModel());

// même code, mais avec une écriture "fluide"
allMockParams.GetMock<IWebDetailsService>()
             .Setup(x => x.GetDetailViewModel(123, 666, false, false))
             .Returns(new OffreViewModel());

#endregion

ObjectHelpers

La class ObjectHelpers permet de faire des actions sur un objet/instance.

• public static void ReplaceFieldValue<T>(T obj, string namePrivateField, object newValue)
  Permet de modifier la valeur d'un champ privé (field) par une nouvelle valeur.

// ...methode de test...

#region Arrange

// [..du code..]

Mock<IAuthService> mockAuth = new Mock<IAuthService>();
mockAuth.Setup(x => x.GetEmailFailedHistory(It.IsAny<string>()))
       .Returns(new Common.Result.InfoResult<int>() { Result = 2 });
mockAuth.Setup(x => x.GetByEmail(It.IsAny<string>()))
       .Returns(new InfoResult<AuthUser>()
          {
             Success = false
          });

#endregion

#region Act

ResourceOwnerPasswordValidator resourceOwner = new ResourceOwnerPasswordValidator(config, mockLogger.Object);

// Remplace le field "_authManager" par notre Mock.
ObjectHelpers.ReplaceFieldValue<ResourceOwnerPasswordValidator>(resourceOwner, "_authManager", mockAuth.Object);

var result = resourceOwner.ValidateAsync(context);

#endregion

ObjectFillerHelper

La class ObjectFillerHelper permet de faire de "nourrir" un objet, via des paramètres.

• public static T FillConstructorOf<T>(IEnumerable<Mock> mockList)
  En passant une liste de Mock, cette méthode va construire un objet.

[Test]
public async Task UserBlocked_Then_NoLogin()
{
    #region Arrange

    MoqHelper moqHelper = new MoqHelper();
    var paramsMock = moqHelper.CreateMockParamsConstructor<CompteController>();
    // [... code pour mock les comportements...]
    
    #endregion
    
    #region Act
    
    CompteController controller = ObjectFillerHelper.FillConstructorOf<CompteController>(paramsMock);
        
    #endregion

Generate

La class Generate permet de générer du contenu (string, email) :

• public static string GenerateString(int longueur)
  Permet de créer un string aléatoirement avec une longueur spécifiée.

string random = Generate.GenerateString(12);
// output : "AsIU1g4Vcp4";

• public static string GenerateString(int longueur, string caractresUtilisatble)
  Permet de créer un string aléatoirement avec une longueur spécifiée et les caractères voulus.

string random = Generate.GenerateString(5, "ABCDefgh");
// output : "AeCfg";

• public static string GenerateRandomEmail()
  Permet de générer un mail par rapport aux constantes de la lib.

string email = Generate.GenerateRandomEmail();
// output : "Kai-Haley866@yahoo.com