Add withErrorReporting

It's common to write the following boilerplate when working with code
that can throw errors:

```swift
do {
  try work()
} catch {
  reportIssue(error)
}
```

Let's extract this pattern to a helper that can save at least some
boilerplate:

```swift
withErrorReporting {
  try work()
}
```

Or even make it a 1-liner in some cases:

```swift
withErrorReporting(catching: work)
```

Author: stephencelis

Sources/IssueReporting/Documentation.docc/Extensions/withErrorReporting.md

@@ -0,0 +1,7 @@
+# ``IssueReporting/withErrorReporting(_:fileID:filePath:line:column:catching:)-3k8o``
+
+## Topics
+
+### Overloads
+
+- ``withErrorReporting(_:fileID:filePath:line:column:catching:)-r4f1``

Sources/IssueReporting/Documentation.docc/IssueReporting.md

@@ -53,6 +53,7 @@ that ship in the same target as the library itself.
 
 - ``reportIssue(_:fileID:filePath:line:column:)``
 - ``withExpectedIssue(_:isIntermittent:fileID:filePath:line:column:_:)-9pinm``
+- ``withErrorReporting(_:fileID:filePath:line:column:catching:)-3k8o``
 
 ### Issue reporters
 

Sources/IssueReporting/ErrorReporting.swift

@@ -0,0 +1,75 @@
+/// Evaluates a throwing closure and automatically catches and reports any error thrown.
+///
+/// - Parameters:
+///   - reporters: Issue reporters to notify during the operation.
+///   - fileID: The source `#fileID` associated with the error reporting.
+///   - filePath: The source `#filePath` associated with the error reporting.
+///   - line: The source `#line` associated with the error reporting.
+///   - column: The source `#column` associated with the error reporting.
+///   - body: A synchronous operation.
+/// - Returns: The optional result of the operation, or `nil` if an error was thrown.
+@_transparent
+public func withErrorReporting<R>(
+  _ reporters: [any IssueReporter]? = nil,
+  fileID: StaticString = #fileID,
+  filePath: StaticString = #filePath,
+  line: UInt = #line,
+  column: UInt = #column,
+  catching body: () throws -> R
+) -> R? {
+  if let reporters {
+    return withIssueReporters(reporters) {
+      do {
+        return try body()
+      } catch {
+        reportIssue(error, fileID: fileID, filePath: filePath, line: line, column: column)
+        return nil
+      }
+    }
+  } else {
+    do {
+      return try body()
+    } catch {
+      reportIssue(error, fileID: fileID, filePath: filePath, line: line, column: column)
+      return nil
+    }
+  }
+}
+
+/// Evaluates a throwing closure and automatically catches and reports any error thrown.
+///
+/// - Parameters:
+///   - reporters: Issue reporters to notify during the operation.
+///   - fileID: The source `#fileID` associated with the error reporting.
+///   - filePath: The source `#filePath` associated with the error reporting.
+///   - line: The source `#line` associated with the error reporting.
+///   - column: The source `#column` associated with the error reporting.
+///   - body: A synchronous operation.
+/// - Returns: The optional result of the operation, or `nil` if an error was thrown.
+@_transparent
+public func withErrorReporting<R>(
+  _ reporters: [any IssueReporter]? = nil,
+  fileID: StaticString = #fileID,
+  filePath: StaticString = #filePath,
+  line: UInt = #line,
+  column: UInt = #column,
+  catching body: () async throws -> R
+) async -> R? {
+  if let reporters {
+    return await withIssueReporters(reporters) {
+      do {
+        return try await body()
+      } catch {
+        reportIssue(error, fileID: fileID, filePath: filePath, line: line, column: column)
+        return nil
+      }
+    }
+  } else {
+    do {
+      return try await body()
+    } catch {
+      reportIssue(error, fileID: fileID, filePath: filePath, line: line, column: column)
+      return nil
+    }
+  }
+}