stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity

update of local deps cache

Browse Source
This commit is contained in:
master
2025-11-21 06:52:58 +00:00
parent 79b8e53441
commit ca35db9ef4
786 changed files with 1749002 additions and 1740601 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
offline/packages/microsoft.extensions.timeprovider.testing/9.10.0/Microsoft.Extensions.TimeProvider.Testing.nuspec vendored
View File

@@ -1,29 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
<metadata>
<id>Microsoft.Extensions.TimeProvider.Testing</id>
<version>9.10.0</version>
<authors>Microsoft</authors>
<requireLicenseAcceptance>true</requireLicenseAcceptance>
<license type="expression">MIT</license>
<licenseUrl>https://licenses.nuget.org/MIT</licenseUrl>
<icon>Icon.png</icon>
<readme>README.md</readme>
<projectUrl>https://dot.net/</projectUrl>
<description>Hand-crafted fakes to make time-related testing easier.
FakeTimeProvider implements the abstract TimeProvider class and is
specifically designed to be used for testing.</description>
<copyright>© Microsoft Corporation. All rights reserved.</copyright>
<tags>Testing TimeProvider FakeTimeProvider</tags>
<serviceable>true</serviceable>
<repository type="git" url="https://github.com/dotnet/extensions" commit="f8f779a6ea004bb1f26649719ca77d63a9d9417c" />
<dependencies>
<group targetFramework=".NETFramework4.6.2">
<dependency id="Microsoft.Bcl.TimeProvider" version="8.0.1" exclude="Build,Analyzers" />
</group>
<group targetFramework="net8.0" />
<group targetFramework="net9.0" />
</dependencies>
</metadata>
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
<metadata>
<id>Microsoft.Extensions.TimeProvider.Testing</id>
<version>9.10.0</version>
<authors>Microsoft</authors>
<requireLicenseAcceptance>true</requireLicenseAcceptance>
<license type="expression">MIT</license>
<licenseUrl>https://licenses.nuget.org/MIT</licenseUrl>
<icon>Icon.png</icon>
<readme>README.md</readme>
<projectUrl>https://dot.net/</projectUrl>
<description>Hand-crafted fakes to make time-related testing easier.
FakeTimeProvider implements the abstract TimeProvider class and is
specifically designed to be used for testing.</description>
<copyright>© Microsoft Corporation. All rights reserved.</copyright>
<tags>Testing TimeProvider FakeTimeProvider</tags>
<serviceable>true</serviceable>
<repository type="git" url="https://github.com/dotnet/extensions" commit="f8f779a6ea004bb1f26649719ca77d63a9d9417c" />
<dependencies>
<group targetFramework=".NETFramework4.6.2">
<dependency id="Microsoft.Bcl.TimeProvider" version="8.0.1" exclude="Build,Analyzers" />
</group>
<group targetFramework="net8.0" />
<group targetFramework="net9.0" />
</dependencies>
</metadata>
</package>

428
offline/packages/microsoft.extensions.timeprovider.testing/9.10.0/README.md vendored
View File

@@ -1,214 +1,214 @@
# Microsoft.Extensions.TimeProvider.Testing
Provides a `FakeTimeProvider` for testing components that depend on `System.TimeProvider`.
## Install the package
From the command-line:
```console
dotnet add package Microsoft.Extensions.TimeProvider.Testing
```
Or directly in the C# project file:
```xml
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.TimeProvider.Testing" Version="[CURRENTVERSION]" />
</ItemGroup>
```
## Usage Example
`FakeTimeProvider` can be used to manually adjust time to test time dependent components in a deterministic way.
`FakeTimeProvider` derives from [TimeProvider](https://learn.microsoft.com/dotnet/api/system.timeprovider) and adds the following APIs:
```csharp
public FakeTimeProvider(DateTimeOffset startDateTime)
public DateTimeOffset Start { get; }
public TimeSpan AutoAdvanceAmount { get; set; }
public void SetUtcNow(DateTimeOffset value)
public void Advance(TimeSpan delta)
public void SetLocalTimeZone(TimeZoneInfo localTimeZone)
```
### `ExpiryCache` with `TimeProvider`
The example below demonstrates the `ExpiryCache` class and how it can be tested using `FakeTimeProvider` in `ExpiryCacheTests`.
The `TimeProvider` abstraction is injected into the `ExpiryCache` class, allowing the cache to rely on `GetUtcNow()` to determine whether cache entries should be evicted based on the current time. This abstraction provides flexibility by enabling different time-related behaviors in test environments.
By using `FakeTimeProvider` in testing, we can simulate the passage of time with methods like `Advance()` and `SetUtcNow()`. This makes it possible to emulate the system's time in a controlled and predictable way during tests, ensuring that cache eviction works as expected.
```csharp
public class ExpiryCache<TKey, TValue>
{
private readonly TimeProvider _timeProvider;
private readonly ConcurrentDictionary<TKey, CacheItem> _cache = new();
private readonly TimeSpan _expirationDuration;
public ExpiryCache(TimeProvider timeProvider, TimeSpan expirationDuration)
{
_timeProvider = timeProvider ?? throw new ArgumentNullException(nameof(timeProvider));
_expirationDuration = expirationDuration;
}
public void Add(TKey key, TValue value)
{
var expirationTime = _timeProvider.GetUtcNow() + _expirationDuration;
var cacheItem = new CacheItem(value, expirationTime);
_cache[key] = cacheItem;
}
public bool TryGetValue(TKey key, out TValue value)
{
value = default;
if (_cache.TryGetValue(key, out TValue cacheItem))
{
if (cacheItem.ExpirationTime > _timeProvider.GetUtcNow())
{
value = cacheItem.Value;
return true;
}
// Remove expired item
_cache.TryRemove(key, out _);
}
return false;
}
private class CacheItem
{
public TValue Value { get; }
public DateTimeOffset ExpirationTime { get; }
public CacheItem(TValue value, DateTimeOffset expirationTime)
{
Value = value;
ExpirationTime = expirationTime;
}
}
}
using Microsoft.Extensions.Time.Testing;
public class ExpiryCacheTests
{
[Fact]
public void ExpiryCache_ShouldRemoveExpiredItems()
{
var timeProvider = new FakeTimeProvider();
var cache = new ExpiryCache<string, string>(timeProvider, TimeSpan.FromSeconds(3));
cache.Add("key1", "value1");
// Simulate time passing
timeProvider.SetUtcNow(timeProvider.GetUtcNow() + TimeSpan.FromSeconds(2));
// The item should still be in the cache
bool found = cache.TryGetValue("key1", out string value);
Assert.True(found);
Assert.Equal("value1", value);
// Simulate further time passing to be after expiration time
timeProvider.SetUtcNow(timeProvider.GetUtcNow() + TimeSpan.FromSeconds(2));
// The item should now be expired
found = cache.TryGetValue("key1", out value);
Assert.False(found);
}
}
```
## `SynchronizationContext` in xUnit Tests
### xUnit v2
Some testing libraries such as xUnit v2 provide custom `SynchronizationContext` for running tests. xUnit v2, for instance, provides `AsyncTestSyncContext` that allows to properly manage asynchronous operations within the test execution. However, it brings an issue when we test asynchronous code that uses `ConfigureAwait(false)` in combination with class like `FakeTimeProvider`. In such cases, the xUnit context may lose track of the continuation, causing the test to become unresponsive, whether the test itself is asynchronous or not.
To prevent this issue, remove the xUnit context for tests dependent on `FakeTimeProvider` by setting the synchronization context to `null`:
```csharp
SynchronizationContext.SetSynchronizationContext(null)
```
The `Advance` method is used to simulate the passage of time. Below is an example how to create a test for a code that uses `ConfigureAwait(false)` that ensures that the continuation of the awaited task (i.e., the code that comes after the await statement) works correctly. For a more realistic example, consider the following test using Polly:
```csharp
using Polly;
using Polly.Retry;
public class SomeService(TimeProvider timeProvider)
{
// Don't do this in real life, not thread safe
public int Tries { get; private set; }
private readonly ResiliencePipeline _retryPipeline = new ResiliencePipelineBuilder { TimeProvider = timeProvider }
.AddRetry(
new RetryStrategyOptions
{
ShouldHandle = new PredicateBuilder().Handle<InvalidOperationException>(),
Delay = TimeSpan.FromSeconds(1),
MaxRetryAttempts = 2,
BackoffType = DelayBackoffType.Linear,
})
.Build();
public async Task<int> PollyRetry(double taskDelay, double cancellationSeconds)
{
Tries = 0;
return await _retryPipeline.ExecuteAsync(
async _ =>
{
Tries++;
// Simulate a task that takes some time to complete
// With xUnit Context this would fail.
await timeProvider.Delay(TimeSpan.FromSeconds(taskDelay)).ConfigureAwait(false);
if (Tries < 2)
{
throw new InvalidOperationException();
}
return Tries;
},
CancellationToken.None);
}
}
using Microsoft.Extensions.Time.Testing;
public class SomeServiceTests
{
[Fact]
public void PollyRetry_ShouldHave2Tries()
{
// Arrange
// Remove xUnit Context for this test
SynchronizationContext.SetSynchronizationContext(null);
var timeProvider = new FakeTimeProvider();
var someService = new SomeService(timeProvider);
// Act
var result = someService.PollyRetry(taskDelay: 1, cancellationSeconds: 6);
// Advancing the time more than one second should resolves the first execution delay.
timeProvider.Advance(TimeSpan.FromMilliseconds(1001));
// Advancing the time more than the retry delay time of 1s,
// and less then the task execution delay should start the second try
timeProvider.Advance(TimeSpan.FromMilliseconds(1050));
// Assert
result.IsCompleted.Should().BeFalse();
someService.Tries.Should().Be(2);
}
}
```
### xUnit v3
`AsyncTestSyncContext` has been removed, more info [here](https://xunit.net/docs/getting-started/v3/migration), so above issue is no longer a problem.
## Feedback & Contributing
We welcome feedback and contributions in [our GitHub repo](https://github.com/dotnet/extensions).
# Microsoft.Extensions.TimeProvider.Testing
Provides a `FakeTimeProvider` for testing components that depend on `System.TimeProvider`.
## Install the package
From the command-line:
```console
dotnet add package Microsoft.Extensions.TimeProvider.Testing
```
Or directly in the C# project file:
```xml
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.TimeProvider.Testing" Version="[CURRENTVERSION]" />
</ItemGroup>
```
## Usage Example
`FakeTimeProvider` can be used to manually adjust time to test time dependent components in a deterministic way.
`FakeTimeProvider` derives from [TimeProvider](https://learn.microsoft.com/dotnet/api/system.timeprovider) and adds the following APIs:
```csharp
public FakeTimeProvider(DateTimeOffset startDateTime)
public DateTimeOffset Start { get; }
public TimeSpan AutoAdvanceAmount { get; set; }
public void SetUtcNow(DateTimeOffset value)
public void Advance(TimeSpan delta)
public void SetLocalTimeZone(TimeZoneInfo localTimeZone)
```
### `ExpiryCache` with `TimeProvider`
The example below demonstrates the `ExpiryCache` class and how it can be tested using `FakeTimeProvider` in `ExpiryCacheTests`.
The `TimeProvider` abstraction is injected into the `ExpiryCache` class, allowing the cache to rely on `GetUtcNow()` to determine whether cache entries should be evicted based on the current time. This abstraction provides flexibility by enabling different time-related behaviors in test environments.
By using `FakeTimeProvider` in testing, we can simulate the passage of time with methods like `Advance()` and `SetUtcNow()`. This makes it possible to emulate the system's time in a controlled and predictable way during tests, ensuring that cache eviction works as expected.
```csharp
public class ExpiryCache<TKey, TValue>
{
private readonly TimeProvider _timeProvider;
private readonly ConcurrentDictionary<TKey, CacheItem> _cache = new();
private readonly TimeSpan _expirationDuration;
public ExpiryCache(TimeProvider timeProvider, TimeSpan expirationDuration)
{
_timeProvider = timeProvider ?? throw new ArgumentNullException(nameof(timeProvider));
_expirationDuration = expirationDuration;
}
public void Add(TKey key, TValue value)
{
var expirationTime = _timeProvider.GetUtcNow() + _expirationDuration;
var cacheItem = new CacheItem(value, expirationTime);
_cache[key] = cacheItem;
}
public bool TryGetValue(TKey key, out TValue value)
{
value = default;
if (_cache.TryGetValue(key, out TValue cacheItem))
{
if (cacheItem.ExpirationTime > _timeProvider.GetUtcNow())
{
value = cacheItem.Value;
return true;
}
// Remove expired item
_cache.TryRemove(key, out _);
}
return false;
}
private class CacheItem
{
public TValue Value { get; }
public DateTimeOffset ExpirationTime { get; }
public CacheItem(TValue value, DateTimeOffset expirationTime)
{
Value = value;
ExpirationTime = expirationTime;
}
}
}
using Microsoft.Extensions.Time.Testing;
public class ExpiryCacheTests
{
[Fact]
public void ExpiryCache_ShouldRemoveExpiredItems()
{
var timeProvider = new FakeTimeProvider();
var cache = new ExpiryCache<string, string>(timeProvider, TimeSpan.FromSeconds(3));
cache.Add("key1", "value1");
// Simulate time passing
timeProvider.SetUtcNow(timeProvider.GetUtcNow() + TimeSpan.FromSeconds(2));
// The item should still be in the cache
bool found = cache.TryGetValue("key1", out string value);
Assert.True(found);
Assert.Equal("value1", value);
// Simulate further time passing to be after expiration time
timeProvider.SetUtcNow(timeProvider.GetUtcNow() + TimeSpan.FromSeconds(2));
// The item should now be expired
found = cache.TryGetValue("key1", out value);
Assert.False(found);
}
}
```
## `SynchronizationContext` in xUnit Tests
### xUnit v2
Some testing libraries such as xUnit v2 provide custom `SynchronizationContext` for running tests. xUnit v2, for instance, provides `AsyncTestSyncContext` that allows to properly manage asynchronous operations within the test execution. However, it brings an issue when we test asynchronous code that uses `ConfigureAwait(false)` in combination with class like `FakeTimeProvider`. In such cases, the xUnit context may lose track of the continuation, causing the test to become unresponsive, whether the test itself is asynchronous or not.
To prevent this issue, remove the xUnit context for tests dependent on `FakeTimeProvider` by setting the synchronization context to `null`:
```csharp
SynchronizationContext.SetSynchronizationContext(null)
```
The `Advance` method is used to simulate the passage of time. Below is an example how to create a test for a code that uses `ConfigureAwait(false)` that ensures that the continuation of the awaited task (i.e., the code that comes after the await statement) works correctly. For a more realistic example, consider the following test using Polly:
```csharp
using Polly;
using Polly.Retry;
public class SomeService(TimeProvider timeProvider)
{
// Don't do this in real life, not thread safe
public int Tries { get; private set; }
private readonly ResiliencePipeline _retryPipeline = new ResiliencePipelineBuilder { TimeProvider = timeProvider }
.AddRetry(
new RetryStrategyOptions
{
ShouldHandle = new PredicateBuilder().Handle<InvalidOperationException>(),
Delay = TimeSpan.FromSeconds(1),
MaxRetryAttempts = 2,
BackoffType = DelayBackoffType.Linear,
})
.Build();
public async Task<int> PollyRetry(double taskDelay, double cancellationSeconds)
{
Tries = 0;
return await _retryPipeline.ExecuteAsync(
async _ =>
{
Tries++;
// Simulate a task that takes some time to complete
// With xUnit Context this would fail.
await timeProvider.Delay(TimeSpan.FromSeconds(taskDelay)).ConfigureAwait(false);
if (Tries < 2)
{
throw new InvalidOperationException();
}
return Tries;
},
CancellationToken.None);
}
}
using Microsoft.Extensions.Time.Testing;
public class SomeServiceTests
{
[Fact]
public void PollyRetry_ShouldHave2Tries()
{
// Arrange
// Remove xUnit Context for this test
SynchronizationContext.SetSynchronizationContext(null);
var timeProvider = new FakeTimeProvider();
var someService = new SomeService(timeProvider);
// Act
var result = someService.PollyRetry(taskDelay: 1, cancellationSeconds: 6);
// Advancing the time more than one second should resolves the first execution delay.
timeProvider.Advance(TimeSpan.FromMilliseconds(1001));
// Advancing the time more than the retry delay time of 1s,
// and less then the task execution delay should start the second try
timeProvider.Advance(TimeSpan.FromMilliseconds(1050));
// Assert
result.IsCompleted.Should().BeFalse();
someService.Tries.Should().Be(2);
}
}
```
### xUnit v3
`AsyncTestSyncContext` has been removed, more info [here](https://xunit.net/docs/getting-started/v3/migration), so above issue is no longer a problem.
## Feedback & Contributing
We welcome feedback and contributions in [our GitHub repo](https://github.com/dotnet/extensions).

14
offline/packages/microsoft.extensions.timeprovider.testing/9.10.0/buildTransitive/net462/Microsoft.Extensions.TimeProvider.Testing.targets vendored
View File

@@ -1,7 +1,7 @@
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_TimeProvider_Testing_net8_0">
<Target Name="NETStandardCompatError_Microsoft_Extensions_TimeProvider_Testing_net8_0"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.TimeProvider.Testing 9.10.0 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net8.0 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_TimeProvider_Testing_net8_0">
<Target Name="NETStandardCompatError_Microsoft_Extensions_TimeProvider_Testing_net8_0"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.TimeProvider.Testing 9.10.0 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net8.0 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>

2184
offline/packages/microsoft.extensions.timeprovider.testing/9.10.0/lib/net462/Microsoft.Extensions.TimeProvider.Testing.xml vendored
View File

File diff suppressed because it is too large Load Diff

1124
offline/packages/microsoft.extensions.timeprovider.testing/9.10.0/lib/net8.0/Microsoft.Extensions.TimeProvider.Testing.xml vendored
View File

File diff suppressed because it is too large Load Diff

1124
offline/packages/microsoft.extensions.timeprovider.testing/9.10.0/lib/net9.0/Microsoft.Extensions.TimeProvider.Testing.xml vendored
View File

File diff suppressed because it is too large Load Diff