Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add retry support #33230

Merged
merged 11 commits into from
Jun 8, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@

namespace Templates.Test
{
[Retry]
public class BlazorServerTemplateTest : BlazorTemplateTest
{
public BlazorServerTemplateTest(ProjectFactoryFixture projectFactory)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@

namespace Templates.Test
{
[Retry]
public class BlazorWasmTemplateTest : BlazorTemplateTest
{
public BlazorWasmTemplateTest(ProjectFactoryFixture projectFactory)
Expand Down
7 changes: 7 additions & 0 deletions src/ProjectTemplates/Shared/Project.cs
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,13 @@ public class Project : IDisposable
try
{
Output.WriteLine("Acquired DotNetNewLock");

if (Directory.Exists(TemplateOutputDir))
Copy link
Member

@dougbu dougbu Jun 3, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't TemplateOutputDir already very unique❔ If Path.GetRandomFileName() isn't unique enough use Guid.NewGuid() in ProjectFactoryFixture.GetOrCreateProject(...). If instead this is new needed because the retries reuse existing projects, we may want to completely remove that aspect of the fixture i.e. switch to ProjectFactoryFixture.CreateProject(...).

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can file a separate issue to track changing that if you want, but I don't really want to do additional major surgery (prefer making this PR just about adding/using retries)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's additional complications about switching from reusing projects since our longer term hope was to actually switch to one test creating/building the template project, and a second (ordered) test would be in charge of running/verifying the tests, we were hoping that would also reduce the flakiness, or at least help us isolate which part of the test is flaky. Unfortunately we didn't get to that point yet, but that was the longer term goal

{
Output.WriteLine($"Template directory already exists, deleting contents of {TemplateOutputDir}");
Directory.Delete(TemplateOutputDir, recursive: true);
}

// Temporary while investigating why this process occasionally never runs or exits on Debian 9
environmentVariables.Add("COREHOST_TRACE", "1");
using var execution = ProcessEx.Run(Output, AppContext.BaseDirectory, DotNetMuxer.MuxerPathOrDefault(), argString, environmentVariables);
Expand Down
27 changes: 27 additions & 0 deletions src/Testing/src/RetryAttribute.cs
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
// Copyright (c) .NET Foundation. All rights reserved.
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.

using System;
using System.ComponentModel;

namespace Microsoft.AspNetCore.Testing
{
/// <summary>
/// Runs a test multiple times when it fails
/// This can be used on an assembly, class, or method name. Requires using the AspNetCore test framework.
/// </summary>
[EditorBrowsable(EditorBrowsableState.Never)]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this because this ships in a user visible package? Making it Never makes it really hard to type this in regular code and gives some people PTSD (@rynowak).

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just copied

[EditorBrowsable(EditorBrowsableState.Never)]
as a starting point so it wasn't specifically intentional by me

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class | AttributeTargets.Assembly, AllowMultiple = false)]
public sealed class RetryAttribute : Attribute
{
public RetryAttribute(int maxRetries = 3)
{
MaxRetries = maxRetries;
}

/// <summary>
/// The maximum number of times to retry a failed test. Defaults to 3.
/// </summary>
public int MaxRetries { get; }
}
}
50 changes: 49 additions & 1 deletion src/Testing/src/xunit/AspNetTestInvoker.cs
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,16 @@ protected override async Task<decimal> InvokeTestMethodAsync(object testClassIns
}
});

var time = await base.InvokeTestMethodAsync(testClassInstance);
var retryAttribute = GetRetryAttribute(TestMethod);
var time = 0.0M;
if (retryAttribute == null)
{
time = await base.InvokeTestMethodAsync(testClassInstance);
}
else
{
time = await RetryAsync(retryAttribute, testClassInstance);
}

await Aggregator.RunAsync(async () =>
{
Expand All @@ -59,6 +68,45 @@ protected override async Task<decimal> InvokeTestMethodAsync(object testClassIns
return time;
}

protected async Task<decimal> RetryAsync(RetryAttribute retryAttribute, object testClassInstance)
{
var attempts = 0;
var timeTaken = 0.0M;
for (attempts = 0; attempts < retryAttribute.MaxRetries; attempts++)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remind me: Will this loop retry an entire [Theory] even if only one data set hits a problem❔

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a per test case/fact (at least that's the intent), I'm pretty certain of that, since there was a different extensibility point I was looking at in a different iteration of trying to implement this.

{
timeTaken = await base.InvokeTestMethodAsync(testClassInstance);
if (!Aggregator.HasExceptions)
JamesNK marked this conversation as resolved.
Show resolved Hide resolved
{
return timeTaken;
}
else if (attempts < retryAttribute.MaxRetries - 1)
{
_testOutputHelper.WriteLine($"Retrying test, attempt {attempts} of {retryAttribute.MaxRetries} failed.");
await Task.Delay(5000);
Aggregator.Clear();
HaoK marked this conversation as resolved.
Show resolved Hide resolved
HaoK marked this conversation as resolved.
Show resolved Hide resolved
}
}

return timeTaken;
}

private RetryAttribute GetRetryAttribute(MethodInfo methodInfo)
{
var attributeCandidate = methodInfo.GetCustomAttribute<RetryAttribute>();
if (attributeCandidate != null)
{
return attributeCandidate;
}

attributeCandidate = methodInfo.DeclaringType.GetCustomAttribute<RetryAttribute>();
if (attributeCandidate != null)
{
return attributeCandidate;
}

return methodInfo.DeclaringType.Assembly.GetCustomAttribute<RetryAttribute>();
}

private static IEnumerable<ITestMethodLifecycle> GetLifecycleHooks(object testClassInstance, Type testClass, MethodInfo testMethod)
{
foreach (var attribute in testMethod.GetCustomAttributes(inherit: true).OfType<ITestMethodLifecycle>())
Expand Down
31 changes: 31 additions & 0 deletions src/Testing/test/RetryTest.cs
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
// Copyright (c) .NET Foundation. All rights reserved.
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.

using System;
using Xunit;

namespace Microsoft.AspNetCore.Testing
{
[Retry]
public class RetryTest
{
private static int _retryFailsUntil3 = 0;

[Fact]
public void RetryFailsUntil3()
{
_retryFailsUntil3++;
if (_retryFailsUntil3 != 2) throw new Exception("NOOOOOOOO");
}

private static int _canOverrideRetries = 0;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: Move to the top of the class

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I departed from the usual pattern here because these are doing a bad thing in that each test has its own static int, but I felt that was cleaner than adding some kind of internal context that we can look at since this is just test code. So the grouping is really a static field per test, it would be really bad if the tests mucked with another one of these fields.


[Fact]
[Retry(5)]
public void CanOverrideRetries()
{
_canOverrideRetries++;
if (_canOverrideRetries != 5) throw new Exception("NOOOOOOOO");
}
}
}