AutoFixture / AutoMoq ignore l’instance injectée / fausse gelée

En supposant que la propriété SettingKey soit définie comme suit, je peux maintenant reproduire le problème:

 public ssortingng SettingKey { get; set; } 

En réalité, les doublons de test injectés dans l’instance SettingMappingXml conviennent parfaitement. Cependant, comme SettingKey est accessible en écriture, la fonction Auto-Properties d’AutoFixture Auto-Properties active et modifie la valeur.

Considérons ce code:

 var fixture = new Fixture().Customize(new AutoMoqCustomization()); var sut = fixture.CreateAnonymous(); Console.WriteLine(sut.SettingKey); 

Cela affiche quelque chose comme ceci:

ParamétrageKey83b75965-2886-4308-bcc4-eb0f8e63de09

Même si tous les doublons de test sont correctement injectés, l’attente de la méthode d’ Setup n’est pas remplie.

Il existe de nombreuses façons de résoudre ce problème.

Protéger les invariants

La bonne façon de résoudre ce problème consiste à utiliser le test unitaire et la correction automatique comme mécanisme de retour. C’est l’un des points essentiels du GOOS : les problèmes liés aux tests unitaires sont souvent le symptôme d’une faille de conception plutôt que la faute du test unitaire (ou de la fixation automatique) lui-même.

Dans ce cas, cela m’indique que la conception n’est pas assez solide . Est-il vraiment approprié qu’un client puisse manipuler la SettingKey à sa SettingKey ?

Au minimum, je recommanderais une implémentation alternative comme celle-ci:

 public ssortingng SettingKey { get; private set; } 

Avec ce changement, mon repro passe.

Omettre SettingKey

Si vous ne pouvez pas (ou ne voudrez pas) changer votre conception, vous pouvez indiquer à AutoFixture de ne pas définir la propriété SettingKey :

 IMappingXml sut = fixture .Build() .Without(s => s.SettingKey) .CreateAnonymous(); 

Personnellement, je trouve contre-productif de devoir écrire une expression Build chaque fois que j’ai besoin d’une instance d’une classe particulière. Vous pouvez découpler la SettingMappingXml instance SettingMappingXml partir de l’instanciation réelle:

 fixture.Customize( c => c.Without(s => s.SettingKey)); IMappingXml sut = fixture.CreateAnonymous(); 

Pour aller plus loin, vous pouvez encapsuler cet appel de méthode Customize dans une personnalisation .

 public class SettingMappingXmlCustomization : ICustomization { public void Customize(IFixture fixture) { fixture.Customize( c => c.Without(s => s.SettingKey)); } } 

Cela nécessite que vous créiez votre instance Fixture avec cette personnalisation:

 IFixture fixture = new Fixture() .Customize(new SettingMappingXmlCustomization()) .Customize(new AutoMoqCustomization()); 

Une fois que vous avez plus de deux ou trois personnalisations à chaîner, vous risquez de vous lasser d’écrire cette chaîne de méthodes tout le temps. Il est temps d’encapsuler ces personnalisations dans un ensemble de conventions pour votre bibliothèque particulière:

 public class TestConventions : CompositeCustomization { public TestConventions() : base( new SettingMappingXmlCustomization(), new AutoMoqCustomization()) { } } 

Cela vous permet de toujours créer l’instance Fixture comme ceci:

 IFixture fixture = new Fixture().Customize(new TestConventions()); 

TestConventions vous offre un emplacement central où vous pouvez modifier vos conventions pour la suite de tests, lorsque vous en avez besoin. Il réduit la taxe de maintenabilité de vos tests unitaires et consortingbue à la cohérence de la conception de votre code de production.

Enfin, comme il semble que vous utilisiez xUnit.net, vous pouvez utiliser l’intégration xUnit.net d’AutoFixture , mais vous devez utiliser un style moins impératif de manipulation du Fixture . Il s’avère que le code qui crée, configure et injecte ISettings Test Double est si idiomatique qu’il dispose d’un raccourci appelé Freeze :

 fixture.Freeze>() .Setup(s => s.Get(settingKey)).Returns(xmlSsortingng); 

Cela fait, l’étape suivante consiste à définir un AutoDataAtsortingbute personnalisé:

 public class AutoConventionDataAtsortingbute : AutoDataAtsortingbute { public AutoConventionDataAtsortingbute() : base(new Fixture().Customize(new TestConventions())) { } } 

Vous pouvez maintenant réduire le test à l’essentiel, en éliminant tout le bruit, en permettant au test d’exprimer uniquement ce qui compte:

 [Theory, AutoConventionData] public void ReducedTheory( [Frozen]Mock settingsStub, SettingMappingXml sut) { ssortingng xmlSsortingng = @"    "; ssortingng settingKey = "gcCreditApplicationUsdFieldMappings"; settingsStub.Setup(s => s.Get(settingKey)).Returns(xmlSsortingng); XElement actualXml = sut.GetXml(); XElement expectedXml = XElement.Parse(xmlSsortingng); Assert.True(XNode.DeepEquals(expectedXml, actualXml)); } 

Autres options

Pour que le test initial réussisse, vous pouvez également simplement désactiver les propriétés automatiques:

 fixture.OmitAutoProperties = true; 

Dans le premier test, vous pouvez créer une instance de la classe Fixture avec AutoMoqCustomization appliqué:

 var fixture = new Fixture() .Customize(new AutoMoqCustomization()); 

Ensuite, les seuls changements sont les suivants:

Étape 1

 // The following line: Mock settingsMock = new Mock(); // Becomes: Mock settingsMock = fixture.Freeze>(); 

Étape 2

 // The following line: ITracingService tracing = new Mock().Object; // Becomes: ITracingService tracing = fixture.Freeze>().Object; 

Étape 3

 // The following line: IMappingXml sut = new SettingMappingXml(settings, tracing); // Becomes: IMappingXml sut = fixture.CreateAnonymous(); 

C’est tout!

Voici comment cela fonctionne:

En interne, Freeze crée une instance du type demandé (par exemple, Mock ), puis l’ injecte de manière à ce qu’elle retourne toujours cette instance lorsque vous le demandez à nouveau.

C’est ce que nous faisons aux Step 1 et Step 2 .

À l’ Step 3 nous demandons une instance du type SettingMappingXml qui dépend de ISettings et ITracingService . Comme nous utilisons Auto Mocking, la classe Fixture fournira des modèles pour ces interfaces. Cependant, nous leur avons précédemment injecté Freeze afin que les Freeze déjà créés soient automatiquement fournis.