Skip to content

Commit 166e8a3

Browse files
committed
generate CompatibilitySuppressions file for intentional breaking changes
1 parent b89463d commit 166e8a3

File tree

5 files changed

+42
-1
lines changed

5 files changed

+42
-1
lines changed

src/LocalStack.Client.Extensions/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,8 @@ The `RegionName` is important as LocalStack creates resources based on the speci
129129

130130
## Known Issues
131131

132+
- **SNS with LocalStack v3.7.2 and v3.8.0:** During development on the new version, it was discovered that SNS functional tests are not working in LocalStack versions v3.7.2 and v3.8.0. This issue was reported in LocalStack [issue #11652](https://github.com/localstack/localstack/issues/11652). The LocalStack team identified a bug related to handling SNS URIs and resolved it in [PR #11653](https://github.com/localstack/localstack/pull/11653). The fix will be included in an upcoming release of LocalStack. In the meantime, if you're using SNS, it is recommended to stick to version v3.7.1 of LocalStack until the fix is available.
133+
132134
- **LocalStack Versions v2.0.1 - v2.2:** In versions v2.0.1 through v2.2 of LocalStack, the URL routing logic was changed, causing issues with SQS and S3 operations. Two issues were opened in LocalStack regarding this: [issue #8928](https://github.com/localstack/localstack/issues/8928) and [issue #8924](https://github.com/localstack/localstack/issues/8924). LocalStack addressed this problem with [PR #8962](https://github.com/localstack/localstack/pull/8962). Therefore, when using LocalStack.NET, either use version v2.0 of LocalStack (there are no issues with the v1 series as well) or the upcoming v2.3 version, or use the latest v3 series container from Docker Hub.
133135

134136
- **AWS_SERVICE_URL Environment Variable:** Unexpected behaviors might occur in LocalStack.NET when the `AWS_SERVICE_URL` environment variable is set. This environment variable is typically set by LocalStack in the container when using AWS Lambda, and AWS also uses this environment variable in the live environment. Soon, just like in LocalStack's official Python library, this environment variable will be prioritized by LocalStack.NET when configuring the LocalStack host, and there will be a general simplification in the configuration. You can follow this in the issues [issue #27](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/27) and [issue #32](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/32). You set the `AWS_SERVICE_URL` to empty string until this issue is resolved.
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- https://learn.microsoft.com/en-us/dotnet/fundamentals/package-validation/diagnostic-ids -->
3+
<Suppressions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
4+
<Suppression>
5+
<DiagnosticId>CP0008</DiagnosticId>
6+
<Target>T:LocalStack.Client.Exceptions.LocalStackClientException</Target>
7+
<Left>lib/net461/LocalStack.Client.dll</Left>
8+
<Right>lib/netstandard2.0/LocalStack.Client.dll</Right>
9+
<IsBaselineSuppression>true</IsBaselineSuppression>
10+
</Suppression>
11+
<Suppression>
12+
<DiagnosticId>CP0008</DiagnosticId>
13+
<Target>T:LocalStack.Client.Exceptions.MisconfiguredClientException</Target>
14+
<Left>lib/net461/LocalStack.Client.dll</Left>
15+
<Right>lib/netstandard2.0/LocalStack.Client.dll</Right>
16+
<IsBaselineSuppression>true</IsBaselineSuppression>
17+
</Suppression>
18+
<Suppression>
19+
<DiagnosticId>CP0008</DiagnosticId>
20+
<Target>T:LocalStack.Client.Exceptions.NotSupportedClientException</Target>
21+
<Left>lib/net461/LocalStack.Client.dll</Left>
22+
<Right>lib/netstandard2.0/LocalStack.Client.dll</Right>
23+
<IsBaselineSuppression>true</IsBaselineSuppression>
24+
</Suppression>
25+
<Suppression>
26+
<DiagnosticId>CP0008</DiagnosticId>
27+
<Target>T:LocalStack.Client.Enums.AwsService</Target>
28+
<Left>lib/net7.0/LocalStack.Client.dll</Left>
29+
<Right>lib/net6.0/LocalStack.Client.dll</Right>
30+
<IsBaselineSuppression>true</IsBaselineSuppression>
31+
</Suppression>
32+
</Suppressions>

src/LocalStack.Client/Exceptions/LocalStackClientException.cs

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
namespace LocalStack.Client.Exceptions;
22

33
[Serializable]
4-
public abstract class LocalStackClientException : Exception
4+
#if NETFRAMEWORK
5+
public class LocalStackClientException : Exception, System.Runtime.InteropServices._Exception
6+
#else
7+
public class LocalStackClientException : Exception
8+
#endif
59
{
610
/// <summary>
711
/// Construct instance of ConfigurationException

src/LocalStack.Client/LocalStack.Client.csproj

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@
1515
<PackageReadmeFile>README.md</PackageReadmeFile>
1616
<EnablePackageValidation>true</EnablePackageValidation>
1717
<PackageValidationBaselineVersion>1.4.1</PackageValidationBaselineVersion>
18+
<!-- <GenerateCompatibilitySuppressionFile>true</GenerateCompatibilitySuppressionFile> -->
1819
<PublishRepositoryUrl>true</PublishRepositoryUrl>
1920
<EmbedUntrackedSources>true</EmbedUntrackedSources>
2021
<NoWarn>$(NoWarn);MA0006;CA1510</NoWarn>

src/LocalStack.Client/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,8 @@ The `RegionName` is important as LocalStack creates resources based on the speci
129129

130130
## Known Issues
131131

132+
- **SNS with LocalStack v3.7.2 and v3.8.0:** During development on the new version, it was discovered that SNS functional tests are not working in LocalStack versions v3.7.2 and v3.8.0. This issue was reported in LocalStack [issue #11652](https://github.com/localstack/localstack/issues/11652). The LocalStack team identified a bug related to handling SNS URIs and resolved it in [PR #11653](https://github.com/localstack/localstack/pull/11653). The fix will be included in an upcoming release of LocalStack. In the meantime, if you're using SNS, it is recommended to stick to version v3.7.1 of LocalStack until the fix is available.
133+
132134
- **LocalStack Versions v2.0.1 - v2.2:** In versions v2.0.1 through v2.2 of LocalStack, the URL routing logic was changed, causing issues with SQS and S3 operations. Two issues were opened in LocalStack regarding this: [issue #8928](https://github.com/localstack/localstack/issues/8928) and [issue #8924](https://github.com/localstack/localstack/issues/8924). LocalStack addressed this problem with [PR #8962](https://github.com/localstack/localstack/pull/8962). Therefore, when using LocalStack.NET, either use version v2.0 of LocalStack (there are no issues with the v1 series as well) or the upcoming v2.3 version, or use the latest v3 series container from Docker Hub.
133135

134136
- **AWS_SERVICE_URL Environment Variable:** Unexpected behaviors might occur in LocalStack.NET when the `AWS_SERVICE_URL` environment variable is set. This environment variable is typically set by LocalStack in the container when using AWS Lambda, and AWS also uses this environment variable in the live environment. Soon, just like in LocalStack's official Python library, this environment variable will be prioritized by LocalStack.NET when configuring the LocalStack host, and there will be a general simplification in the configuration. You can follow this in the issues [issue #27](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/27) and [issue #32](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/32). You set the `AWS_SERVICE_URL` to empty string until this issue is resolved.

0 commit comments

Comments
 (0)