Throw specific exceptions (#388)

Author: pascalberger

src/Cake.AzureDevOps.Tests/Repos/PullRequest/AzureDevOpsPullRequestTests.cs

@@ -571,7 +571,7 @@ public void Should_Throw_If_AzureDevOps_Pull_Request_State_Is_Invalid()
                 // Then
                 result.ShouldNotBe(null);
                 result.IsExpected("SetStatus");
-                result.Message.ShouldBe("Unknown value");
+                result.Message.ShouldBe("The value of argument 'state' (123) is invalid for Enum type 'AzureDevOpsPullRequestStatusState'. (Parameter 'state')");
             }
 
             [Fact]

src/Cake.AzureDevOps/Pipelines/ArtifactResourceExtensions.cs

@@ -20,7 +20,7 @@ public static AzureDevOpsArtifactResource ToAzureDevOpsArtifactResource(this Art
 
             if (!Enum.TryParse(artifactResource.Type, out AzurePipelinesArtifactType type))
             {
-                throw new Exception($"Unexpected value for artifact type '{artifactResource.Type}'");
+                throw new InvalidOperationException($"Unexpected value for artifact type '{artifactResource.Type}'");
             }
 
             return

src/Cake.AzureDevOps/Pipelines/AzureDevOpsBuildQueryOrderExtensions.cs

@@ -1,5 +1,6 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
 
     /// <summary>
@@ -22,7 +23,7 @@ public static BuildQueryOrder ToBuildQueryOrder(this AzureDevOpsBuildQueryOrder
                 AzureDevOpsBuildQueryOrder.QueueTimeAscending => BuildQueryOrder.QueueTimeAscending,
                 AzureDevOpsBuildQueryOrder.StartTimeDescending => BuildQueryOrder.StartTimeDescending,
                 AzureDevOpsBuildQueryOrder.StartTimeAscending => BuildQueryOrder.StartTimeAscending,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(queryOrder), (int)queryOrder, typeof(AzureDevOpsBuildQueryOrder)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/AzureDevOpsBuildResultExtensions.cs

@@ -1,5 +1,6 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
 
     /// <summary>
@@ -21,7 +22,7 @@ public static BuildResult ToBuildResult(this AzureDevOpsBuildResult result)
                 AzureDevOpsBuildResult.PartiallySucceeded => BuildResult.PartiallySucceeded,
                 AzureDevOpsBuildResult.Failed => BuildResult.Failed,
                 AzureDevOpsBuildResult.Canceled => BuildResult.Canceled,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(result), (int)result, typeof(AzureDevOpsBuildResult)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/AzureDevOpsBuildStatusExtensions.cs

@@ -1,6 +1,8 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
+    using Microsoft.VisualStudio.Services.TestManagement.TestPlanning.WebApi;
 
     /// <summary>
     /// Extensions for the <see cref="AzureDevOpsBuildStatus"/> class.
@@ -23,7 +25,7 @@ public static BuildStatus ToBuildStatus(this AzureDevOpsBuildStatus status)
                 AzureDevOpsBuildStatus.Postponed => BuildStatus.Postponed,
                 AzureDevOpsBuildStatus.NotStarted => BuildStatus.NotStarted,
                 AzureDevOpsBuildStatus.All => BuildStatus.All,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(status), (int)status, typeof(AzureDevOpsBuildStatus)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/BuildResultExtensions.cs

@@ -1,5 +1,6 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
 
     /// <summary>
@@ -21,7 +22,7 @@ public static AzureDevOpsBuildResult ToAzureDevOpsBuildResult(this BuildResult r
                 BuildResult.PartiallySucceeded => AzureDevOpsBuildResult.PartiallySucceeded,
                 BuildResult.Failed => AzureDevOpsBuildResult.Failed,
                 BuildResult.Canceled => AzureDevOpsBuildResult.Canceled,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(result), (int)result, typeof(BuildResult)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/BuildStatusExtensions.cs

@@ -1,6 +1,8 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
+    using Microsoft.VisualStudio.Services.TestManagement.TestPlanning.WebApi;
 
     /// <summary>
     /// Extensions for the <see cref="BuildStatus"/> class.
@@ -23,7 +25,7 @@ public static AzureDevOpsBuildStatus ToAzureDevOpsBuildStatus(this BuildStatus s
                 BuildStatus.Postponed => AzureDevOpsBuildStatus.Postponed,
                 BuildStatus.NotStarted => AzureDevOpsBuildStatus.NotStarted,
                 BuildStatus.All => AzureDevOpsBuildStatus.All,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(status), (int)status, typeof(BuildStatus)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/DefinitionQueueStatusExtensions.cs

@@ -1,5 +1,6 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
 
     /// <summary>
@@ -19,7 +20,7 @@ public static AzureDevOpsDefinitionQueueStatus ToAzureDevOpsDefinitionQueueStatu
                 DefinitionQueueStatus.Enabled => AzureDevOpsDefinitionQueueStatus.Enabled,
                 DefinitionQueueStatus.Paused => AzureDevOpsDefinitionQueueStatus.Paused,
                 DefinitionQueueStatus.Disabled => AzureDevOpsDefinitionQueueStatus.Disabled,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(status), (int)status, typeof(DefinitionQueueStatus)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/TaskResultExtensions.cs

@@ -1,5 +1,6 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
 
     /// <summary>
@@ -22,7 +23,7 @@ public static AzureDevOpsTaskResult ToAzureDevOpsTaskResult(this TaskResult resu
                 TaskResult.Canceled => AzureDevOpsTaskResult.Canceled,
                 TaskResult.Skipped => AzureDevOpsTaskResult.Skipped,
                 TaskResult.Abandoned => AzureDevOpsTaskResult.Abandoned,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(result), (int)result, typeof(TaskResult)),
             };
         }
     }

src/Cake.AzureDevOps/Pipelines/TimelineRecordStateExtensions.cs

@@ -1,6 +1,8 @@
 namespace Cake.AzureDevOps.Pipelines
 {
+    using System.ComponentModel;
     using Microsoft.TeamFoundation.Build.WebApi;
+    using Microsoft.VisualStudio.Services.TestManagement.TestPlanning.WebApi;
 
     /// <summary>
     /// Extensions for the <see cref="TimelineRecordState"/> class.
@@ -19,7 +21,7 @@ public static AzureDevOpsTimelineRecordState ToAzureDevOpsTimelineRecordState(th
                 TimelineRecordState.Pending => AzureDevOpsTimelineRecordState.Pending,
                 TimelineRecordState.InProgress => AzureDevOpsTimelineRecordState.InProgress,
                 TimelineRecordState.Completed => AzureDevOpsTimelineRecordState.Completed,
-                _ => throw new System.Exception("Unknown value"),
+                _ => throw new InvalidEnumArgumentException(nameof(state), (int)state, typeof(TimelineRecordState)),
             };
         }
     }