Add .customDump strategy and deprecate .dump (#948)

* Add `.customDump` strategy and deprecate `.dump`

* Bump tools version

* wip

* wip

Author: stephencelis

.github/workflows/ci.yml

@@ -29,15 +29,13 @@ jobs:
     strategy:
       matrix:
         swift:
-          - "5.7"
+          - '5.9'
 
-    name: Ubuntu (Swift ${{ matrix.swift }})
-    runs-on: ubuntu-20.04
+    container: swift:${{ matrix.swift }}
+    name: Linux (Swift ${{ matrix.swift }})
+    runs-on: ubuntu-latest
     steps:
-      - uses: swift-actions/setup-swift@v1
-        with:
-          swift-version: ${{ matrix.swift }}
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - run: swift test
 
   windows:

Package.resolved

@@ -1,4 +1,4 @@
-// swift-tools-version:5.7
+// swift-tools-version:5.9
 
 import PackageDescription
 
@@ -19,18 +19,34 @@ let package = Package(
       name: "InlineSnapshotTesting",
       targets: ["InlineSnapshotTesting"]
     ),
+    .library(
+      name: "SnapshotTestingCustomDump",
+      targets: ["SnapshotTestingCustomDump"]
+    ),
   ],
   dependencies: [
-    .package(url: "https://github.com/swiftlang/swift-syntax", "509.0.0"..<"601.0.0-prerelease")
+    .package(url: "https://github.com/pointfreeco/swift-custom-dump", from: "1.3.3"),
+    .package(url: "https://github.com/swiftlang/swift-syntax", "509.0.0"..<"601.0.0"),
   ],
   targets: [
     .target(
       name: "SnapshotTesting"
     ),
+    .testTarget(
+      name: "SnapshotTestingTests",
+      dependencies: [
+        "SnapshotTesting",
+      ],
+      exclude: [
+        "__Fixtures__",
+        "__Snapshots__",
+      ]
+    ),
     .target(
       name: "InlineSnapshotTesting",
       dependencies: [
         "SnapshotTesting",
+        "SnapshotTestingCustomDump",
         .product(name: "SwiftParser", package: "swift-syntax"),
         .product(name: "SwiftSyntax", package: "swift-syntax"),
         .product(name: "SwiftSyntaxBuilder", package: "swift-syntax"),
@@ -42,14 +58,11 @@ let package = Package(
         "InlineSnapshotTesting"
       ]
     ),
-    .testTarget(
-      name: "SnapshotTestingTests",
+    .target(
+      name: "SnapshotTestingCustomDump",
       dependencies: [
-        "SnapshotTesting"
-      ],
-      exclude: [
-        "__Fixtures__",
-        "__Snapshots__",
+        "SnapshotTesting",
+        .product(name: "CustomDump", package: "swift-custom-dump"),
       ]
     ),
   ]

Package.swift

@@ -41,6 +41,26 @@ extension Snapshotting where Format == String {
   ///   - id: 1
   ///   - name: "Blobby"
   /// ```
+  @available(
+    iOS,
+    deprecated: 9999,
+    message: "Use '.customDump' from the 'SnapshotTestingCustomDump' module, instead."
+  )
+  @available(
+    macOS,
+    deprecated: 9999,
+    message: "Use '.customDump' from the 'SnapshotTestingCustomDump' module, instead."
+  )
+  @available(
+    tvOS,
+    deprecated: 9999,
+    message: "Use '.customDump' from the 'SnapshotTestingCustomDump' module, instead."
+  )
+  @available(
+    watchOS,
+    deprecated: 9999,
+    message: "Use '.customDump' from the 'SnapshotTestingCustomDump' module, instead."
+  )
   public static var dump: Snapshotting {
     return SimplySnapshotting.lines.pullback { snap($0) }
   }

Sources/SnapshotTesting/Snapshotting/Any.swift

@@ -0,0 +1,24 @@
+import CustomDump
+import SnapshotTesting
+
+extension Snapshotting where Format == String {
+  /// A snapshot strategy for comparing any structure based on a
+  /// [custom dump](https://github.com/pointfreeco/swift-custom-dump).
+  ///
+  /// ```swift
+  /// assertSnapshot(of: user, as: .customDump)
+  /// ```
+  ///
+  /// Records:
+  ///
+  /// ```
+  /// User(
+  ///   bio: "Blobbed around the world.",
+  ///   id: 1,
+  ///   name: "Blobby"
+  /// )
+  /// ```
+  public static var customDump: Snapshotting {
+    SimplySnapshotting.lines.pullback(String.init(customDumping:))
+  }
+}

Sources/SnapshotTestingCustomDump/CustomDump.swift

@@ -0,0 +1,26 @@
+#if canImport(Testing)
+  import Testing
+  import InlineSnapshotTesting
+  import SnapshotTestingCustomDump
+
+  @Suite(
+    .snapshots(
+      record: .missing
+    )
+  )
+  struct CustomDumpSnapshotTests {
+    @Test func basics() {
+      struct User { let id: Int, name: String, bio: String }
+      let user = User(id: 1, name: "Blobby", bio: "Blobbed around the world.")
+      assertInlineSnapshot(of: user, as: .customDump) {
+        """
+        CustomDumpSnapshotTests.User(
+          id: 1,
+          name: "Blobby",
+          bio: "Blobbed around the world."
+        )
+        """
+      }
+    }
+  }
+#endif