Swiftpack.co -  Sherlouk/swift-snapshot-testing-stitch as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
Sherlouk/swift-snapshot-testing-stitch
Combine SnapshotTesting images into a single asset
.package(url: "https://github.com/Sherlouk/swift-snapshot-testing-stitch.git", from: "1.1.0")

SnapshotTesting Stitch

Compatible with the latest Swift versions Compatible with iOS Contact @JamesSherlouk on Twitter

An extension to SnapshotTesting which allows you to create images combining the output of multiple snapshot strategies, assuming they all output to UIImage.

In essence, this allows you to have a single image which represents a single view in your application, shown in multiple different configurations. This might be useful, for example, where you want to visualise the same UIViewController on multiple devices or in light and dark mode.

Images may also have titles, allowing you to easily identify each configuration within the image.

An image demonstrating an example output of the package. It shows seven views coloured in blue with red borders with titles above each of them naming each of the views.

Usage

Once installed, no additional configuration is required. You can import the SnapshotTestingStitch module, call SnapshotTesting following their usage guide and simply provide our stitch strategy as below.

import SnapshotTesting
import SnapshotTestingStitch
import XCTest

class MyViewControllerTests: XCTestCase {
  func testMyViewController() {
    let vc = MyViewController()

    assertSnapshot(matching: vc, as: .stitch(strategies: [
      .image(on: .iPhone8),
      .image(on: .iPhone8Plus),
    ]))
  }
}

Titles

By default, if you simply provide an array of strategies then these will be untitled. If you instead provide a tuple containing a string and the strategy then the string will be positioned as a title above the image in the snapshot.

assertSnapshot(matching: vc, as: .stitch(strategies: [
  ("iPhone 8", .image(on: .iPhone8)),
  ("iPhone 8 Plus", .image(on: .iPhone8Plus)),
]))

Customisation

An optional parameter of the stitch strategy is the "style". This value allows you to customise certain parts of the rendered snapshot generated by the package.

This includes the spacing around the images, the colors used, and an optional border which can surround each image. The border can be useful for clearly identifying the bounds of each image - especially if the image background is the same as the snapshot background.

Opinionated defaults have already been provided for you.

assertSnapshot(matching: vc, as: .stitch(strategies: [
  ("iPhone 8", .image(on: .iPhone8)),
  ("iPhone 8 Plus", .image(on: .iPhone8Plus)),
], style: .init(
  fontSize: 20,
  titleColor: .white,
  borderColor: .red,
  borderWidth: 5,
  itemSpacing: 32,
  framePadding: 32,
  titleSpacing: 32,
  backgroundColor: .black
)))

Installation

Xcode 11

⚠️ Warning: By default, Xcode will try to add the SnapshotTestingStitch package to your project's main application/framework target. Please ensure that SnapshotTestingStitch is added to a test target instead, as documented in the last step, below.

  1. From the File menu, navigate through Swift Packages and select Add Package Dependency….
  2. Enter package repository URL: https://github.com/Sherlouk/swift-snapshot-testing-stitch
  3. Confirm the version and let Xcode resolve the package
  4. On the final dialog, update SnapshotTestingStitch's Add to Target column to a test target that will contain snapshot tests (if you have more than one test target, you can later add SnapshotTestingStitch to them by manually linking the library in its build phase)

Swift Package Manager

If you want to use SnapshotTestingStitch in any other project that uses Swift Package Manager, add the package as a dependency in Package.swift:

dependencies: [
  .package(name: "SnapshotTestingStitch", url: "https://github.com/Sherlouk/swift-snapshot-testing-stitch.git", from: "1.0.0"),
]

Next, add SnapshotTestingStitch as a dependency of your test target:

targets: [
  .target(
    name: "MyApp"
  ),
  
  .testTarget(
    name: "MyAppTests", 
    dependencies: [
      .target(name: "MyApp"),
      .product(name: "SnapshotTestingStitch", package: "SnapshotTestingStitch"),
    ]
  ),
]

Other

We do not currently support distribution through CocoaPods or Carthage.

License

This library is released under the MIT license. See LICENSE for details.

GitHub

link
Stars: 3
Last commit: 1 week ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

Add Configure Block
1 week ago

This version adds a new StitchTask struct which can be used in replacement of the tuples which were required previously. The old method is still supported, so is entirely backwards compatible.

The new StitchTask struct also supports a new, optional, configuration block. If used, it allows you to mutate the underlying input value before the snapshot is taken for that task. This can be handy if you have functionality not controlled by traits and still want to visualise multiple variants.

Beware though, future stitches using the same value object will use the now mutated version. We would recommend that if you're configuring one task, that you reset/configure every task that uses the same object to prevent inconsistencies and inaccuracies.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API