second_curtain 0.2.2 → 0.2.3

data/Demo/Pods/Expecta+Snapshots/EXPMatchers+FBSnapshotTest.m

@@ -0,0 +1,308 @@
+//
+//  EXPMatchers+FBSnapshotTest.h
+//  Artsy
+//
+//  Created by Daniel Doubrovkine on 1/14/14.
+//  Copyright (c) 2014 Artsy Inc. All rights reserved.
+//
+
+#import "EXPMatchers+FBSnapshotTest.h"
+#import <Expecta/EXPMatcherHelpers.h>
+#import <FBSnapshotTestCase/FBSnapshotTestController.h>
+
+@interface EXPExpectFBSnapshotTest()
+@property (nonatomic, strong) NSString *referenceImagesDirectory;
+@end
+
+@implementation EXPExpectFBSnapshotTest
+
++ (id)instance
+{
+    static EXPExpectFBSnapshotTest *instance = nil;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        instance = [[self alloc] init];
+    });
+    return instance;
+}
+
++ (BOOL)compareSnapshotOfViewOrLayer:(id)viewOrLayer snapshot:(NSString *)snapshot testCase:(id)testCase record:(BOOL)record referenceDirectory:(NSString *)referenceDirectory error:(NSError **)error
+
+{
+    FBSnapshotTestController *snapshotController = [[FBSnapshotTestController alloc] initWithTestClass:[testCase class]];
+    snapshotController.recordMode = record;
+    snapshotController.referenceImagesDirectory = referenceDirectory;
+
+    if (! snapshotController.referenceImagesDirectory) {
+        [NSException raise:@"Missing value for referenceImagesDirectory" format:@"Call [[EXPExpectFBSnapshotTest instance] setReferenceImagesDirectory"];
+    }
+
+    return [snapshotController compareSnapshotOfViewOrLayer:viewOrLayer
+                                                   selector:NSSelectorFromString(snapshot)
+                                                 identifier:nil
+                                                      error:error];
+}
+
++ (NSString *)combinedError:(NSString *)message test:(NSString *)test error:(NSError *)error
+{
+    NSAssert(message, @"missing message");
+    NSAssert(test, @"missing test name");
+
+    NSMutableArray *ary = [NSMutableArray array];
+
+    [ary addObject:[NSString stringWithFormat:@"%@ %@", message, test]];
+
+    for(NSString *key in error.userInfo.keyEnumerator) {
+        [ary addObject:[NSString stringWithFormat:@" %@: %@", key, [error.userInfo valueForKey:key]]];
+    }
+
+    return [ary componentsJoinedByString:@"\n"];
+}
+
+@end
+
+void setGlobalReferenceImageDir(char *reference) {
+    NSString *referenceImagesDirectory = [NSString stringWithFormat:@"%s", reference];
+    [[EXPExpectFBSnapshotTest instance] setReferenceImagesDirectory:referenceImagesDirectory];
+};
+
+@interface EXPExpect(ReferenceDirExtension)
+- (NSString *)_getDefaultReferenceDirectory;
+@end
+
+@implementation EXPExpect(ReferenceDirExtension)
+
+- (NSString *)_getDefaultReferenceDirectory
+{
+    NSString *globalReference = [[EXPExpectFBSnapshotTest instance] referenceImagesDirectory];
+    if (globalReference) {
+        return globalReference;
+    }
+
+    // Search the test file's path to find the first folder with the substring "tests"
+    // then append "/ReferenceImages" and use that
+
+    NSString *testFileName = [NSString stringWithCString:self.fileName encoding:NSUTF8StringEncoding];
+    NSArray *pathComponents = [testFileName pathComponents];
+
+    for (NSString *folder in pathComponents) {
+        if ([folder.lowercaseString rangeOfString:@"tests"].location != NSNotFound) {
+
+            NSArray *folderPathComponents = [pathComponents subarrayWithRange:NSMakeRange(0, [pathComponents indexOfObject:folder] + 1)];
+            return [NSString stringWithFormat:@"%@/ReferenceImages", [folderPathComponents componentsJoinedByString:@"/"]];
+
+        }
+    }
+
+    [NSException raise:@"Could not infer reference image folder" format:@"You should provide a reference dir using setGlobalReferenceImageDir(FB_REFERENCE_IMAGE_DIR);"];
+    return nil;
+}
+@end
+
+
+
+// If you're bringing in Speca via CocoaPods
+// use the test path to get the test's image file URL
+
+#ifdef COCOAPODS_POD_AVAILABLE_Specta
+#import <Specta/Specta.h>
+#import <Specta/SpectaUtility.h>
+#import <Specta/SPTExample.h>
+
+NSString *sanitizedTestPath();
+
+NSString *sanitizedTestPath(){
+    SPTXCTestCase *test = [[NSThread currentThread] threadDictionary][SPTCurrentTestCaseKey];
+
+    SPTExample *compiledExample = [test spt_getCurrentExample];
+    NSCharacterSet *charSet = [NSCharacterSet characterSetWithCharactersInString:@"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_"];
+    NSString *currentTestName = [[compiledExample.name componentsSeparatedByCharactersInSet:[charSet invertedSet]] componentsJoinedByString:@"_"];
+
+    return [NSString stringWithFormat:@"%@", currentTestName];
+}
+
+EXPMatcherImplementationBegin(haveValidSnapshot, (void)){
+    __block NSError *error = nil;
+
+    match(^BOOL{
+        NSString *referenceImageDir = [self _getDefaultReferenceDirectory];
+        NSString *name = sanitizedTestPath();
+        if ([actual isKindOfClass:UIViewController.class]) {
+            actual = [actual view];
+        }
+
+        return [EXPExpectFBSnapshotTest compareSnapshotOfViewOrLayer:actual snapshot:name testCase:[self testCase] record:NO referenceDirectory:referenceImageDir error:&error];
+    });
+
+    failureMessageForTo(^NSString *{
+        return [EXPExpectFBSnapshotTest combinedError:@"expected a matching snapshot in" test:sanitizedTestPath() error:error];
+    });
+
+    failureMessageForNotTo(^NSString *{
+        return [EXPExpectFBSnapshotTest combinedError:@"expected to not have a matching snapshot in" test:sanitizedTestPath() error:error];
+    });
+}
+EXPMatcherImplementationEnd
+
+EXPMatcherImplementationBegin(recordSnapshot, (void)) {
+    __block NSError *error = nil;
+
+    BOOL actualIsViewLayerOrViewController = ([actual isKindOfClass:UIView.class] || [actual isKindOfClass:CALayer.class] || [actual isKindOfClass:UIViewController.class]);
+
+    prerequisite(^BOOL{
+        return actualIsViewLayerOrViewController;
+    });
+
+    match(^BOOL{
+        NSString *referenceImageDir = [self _getDefaultReferenceDirectory];
+
+        // For view controllers do the viewWill/viewDid dance, then pass view through
+        if ([actual isKindOfClass:UIViewController.class]) {
+
+            [actual beginAppearanceTransition:YES animated:NO];
+            [actual endAppearanceTransition];
+            actual = [actual view];
+        }
+
+        [EXPExpectFBSnapshotTest compareSnapshotOfViewOrLayer:actual snapshot:sanitizedTestPath() testCase:[self testCase] record:YES referenceDirectory:referenceImageDir error:&error];
+        return NO;
+    });
+
+    failureMessageForTo(^NSString *{
+        if (!actualIsViewLayerOrViewController) {
+            return [EXPExpectFBSnapshotTest combinedError:@"Expected a View, Layer or View Controller." test:sanitizedTestPath() error:nil];
+        }
+        if (error) {
+            return [EXPExpectFBSnapshotTest combinedError:@"expected to record a snapshot in" test:sanitizedTestPath() error:error];
+        } else {
+            return [NSString stringWithFormat:@"snapshot %@ successfully recorded, replace recordSnapshot with a check", sanitizedTestPath()];
+        }
+    });
+
+    failureMessageForNotTo(^NSString *{
+        if (error) {
+            return [EXPExpectFBSnapshotTest combinedError:@"expected to record a snapshot in" test:sanitizedTestPath() error:error];
+        } else {
+            return [NSString stringWithFormat:@"snapshot %@ successfully recorded, replace recordSnapshot with a check", sanitizedTestPath()];
+        }
+    });
+}
+EXPMatcherImplementationEnd
+
+#else
+
+// If you don't have Speca stub the functions
+
+EXPMatcherImplementationBegin(haveValidSnapshot, (void)){
+
+    prerequisite(^BOOL{
+        return NO;
+    });
+
+    failureMessageForTo(^NSString *{
+        return @"you need Specta installed via CocoaPods to use haveValidSnapshot, use haveValidSnapshotNamed instead";
+    });
+
+    failureMessageForNotTo(^NSString *{
+        return @"you need Specta installed via CocoaPods to use haveValidSnapshot, use haveValidSnapshotNamed instead";
+    });
+}
+EXPMatcherImplementationEnd
+
+
+EXPMatcherImplementationBegin(recordSnapshot, (void)) {
+    __block NSError *error = nil;
+
+    prerequisite(^BOOL{
+        return NO;
+    });
+
+    failureMessageForTo(^NSString *{
+        return @"you need Specta installed via CocoaPods to use recordSnapshot, use recordSnapshotNamed instead";
+    });
+
+    failureMessageForNotTo(^NSString *{
+        return @"you need Specta installed via CocoaPods to use recordSnapshot, use recordSnapshotNamed instead";
+    });
+}
+EXPMatcherImplementationEnd
+
+
+#endif
+
+
+
+EXPMatcherImplementationBegin(haveValidSnapshotNamed, (NSString *snapshot)){
+    BOOL snapshotIsNil = (snapshot == nil);
+    __block NSError *error = nil;
+
+    prerequisite(^BOOL{
+        return !(snapshotIsNil);
+    });
+
+    match(^BOOL{
+        NSString *referenceImageDir = [self _getDefaultReferenceDirectory];
+        if ([actual isKindOfClass:UIViewController.class]) {
+            actual = [actual view];
+        }
+        return [EXPExpectFBSnapshotTest compareSnapshotOfViewOrLayer:actual snapshot:snapshot testCase:[self testCase] record:NO referenceDirectory:referenceImageDir error:&error];
+    });
+
+    failureMessageForTo(^NSString *{
+        return [EXPExpectFBSnapshotTest combinedError:@"expected a matching snapshot named" test:snapshot error:error];
+
+    });
+
+    failureMessageForNotTo(^NSString *{
+        return [EXPExpectFBSnapshotTest combinedError:@"expected not to have a matching snapshot named" test:snapshot error:error];
+    });
+}
+EXPMatcherImplementationEnd
+
+EXPMatcherImplementationBegin(recordSnapshotNamed, (NSString *snapshot)) {
+    BOOL snapshotExists = (snapshot != nil);
+    BOOL actualIsViewLayerOrViewController = ([actual isKindOfClass:UIView.class] || [actual isKindOfClass:CALayer.class] || [actual isKindOfClass:UIViewController.class]);
+    __block NSError *error = nil;
+    id actualRef = actual;
+
+    prerequisite(^BOOL{
+        return actualRef && snapshotExists && actualIsViewLayerOrViewController;
+    });
+
+    match(^BOOL{
+        NSString *referenceImageDir = [self _getDefaultReferenceDirectory];
+
+        // For view controllers do the viewWill/viewDid dance, then pass view through
+        if ([actual isKindOfClass:UIViewController.class]) {
+            [actual beginAppearanceTransition:YES animated:NO];
+            [actual endAppearanceTransition];
+            actual = [actual view];
+        }
+
+        [EXPExpectFBSnapshotTest compareSnapshotOfViewOrLayer:actual snapshot:snapshot testCase:[self testCase] record:YES referenceDirectory:referenceImageDir error:&error];
+        return NO;
+    });
+
+    failureMessageForTo(^NSString *{
+        if (!actualIsViewLayerOrViewController) {
+            return [EXPExpectFBSnapshotTest combinedError:@"Expected a View, Layer or View Controller." test:snapshot error:nil];
+        }
+        if (error) {
+            return [EXPExpectFBSnapshotTest combinedError:@"expected to record a matching snapshot named" test:snapshot error:error];
+        } else {
+            return [NSString stringWithFormat:@"snapshot %@ successfully recorded, replace recordSnapshot with a check", snapshot];
+        }
+    });
+
+    failureMessageForNotTo(^NSString *{
+        if (!actualIsViewLayerOrViewController) {
+            return [EXPExpectFBSnapshotTest combinedError:@"Expected a View, Layer or View Controller." test:snapshot error:nil];
+        }
+        if (error) {
+            return [EXPExpectFBSnapshotTest combinedError:@"expected to record a matching snapshot named" test:snapshot error:error];
+        } else {
+            return [NSString stringWithFormat:@"snapshot %@ successfully recorded, replace recordSnapshot with a check", snapshot];
+        }
+    });
+}
+EXPMatcherImplementationEnd

data/Demo/Pods/Expecta+Snapshots/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2014 Daniel Doubrovkine, Artsy Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Demo/Pods/Expecta+Snapshots/README.md

@@ -0,0 +1,85 @@
+Expecta Matchers for FBSnapshotTestCase
+==============================
+
+[Expecta](https://github.com/specta/expecta) matchers for [ios-snapshot-test-case](https://github.com/facebook/ios-snapshot-test-case).
+
+[![Build Status](https://travis-ci.org/dblock/ios-snapshot-test-case-expecta.png)](https://travis-ci.org/dblock/ios-snapshot-test-case-expecta)
+
+### Usage
+
+Add `EXPMatchers+FBSnapshotTest` to your Podfile, the latest `FBSnapshotTestCase` will come in as a dependency.
+
+``` ruby
+pod 'Expecta+Snapshots', '~> 1.0'
+```
+
+### App setup
+
+Use `expect(view).to.recordSnapshotNamed(@"unique snapshot name")` to record a snapshot and `expect(view).to.haveValidSnapshotNamed(@"unique snapshot name")` to check it.
+
+If you project was compiled with Specta included, you have two extra methods that use the spec hierarchy to generate the snapshot name for you: `recordSnapshot()` and `haveValidSnapshot()`. You should only call these once per `it()` block.
+
+``` Objective-C
+#define EXP_SHORTHAND
+#include <Specta/Specta.h>
+#include <Expecta/Expecta.h>
+#include <EXPMatchers+FBSnapshotTest/EXPMatchers+FBSnapshotTest.h>
+#include "FBExampleView.h"
+
+SpecBegin(FBExampleView)
+
+describe(@"manual matching", ^{
+
+    it(@"matches view", ^{
+        FBExampleView *view = [[FBExampleView alloc] initWithFrame:CGRectMake(0, 0, 64, 64)];
+        expect(view).to.recordSnapshotNamed(@"FBExampleView");
+        expect(view).to.haveValidSnapshotNamed(@"FBExampleView");
+    });
+
+    it(@"doesn't match a view", ^{
+        FBExampleView *view = [[FBExampleView alloc] initWithFrame:CGRectMake(0, 0, 64, 64)];
+        expect(view).toNot.haveValidSnapshotNamed(@"FBExampleViewDoesNotExist");
+    });
+
+});
+
+describe(@"test name derived matching", ^{
+
+    it(@"matches view", ^{
+        FBExampleView *view = [[FBExampleView alloc] initWithFrame:CGRectMake(0, 0, 64, 64)];
+        expect(view).to.recordSnapshot();
+        expect(view).to.haveValidSnapshot();
+    });
+
+    it(@"doesn't match a view", ^{
+        FBExampleView *view = [[FBExampleView alloc] initWithFrame:CGRectMake(0, 0, 64, 64)];
+        expect(view).toNot.haveValidSnapshot();
+    });
+
+});
+
+SpecEnd
+```
+
+### Sane defaults
+
+`EXPMatchers+FBSnapshotTest` will automatically figure out the tests folder, and [add a reference image](https://github.com/dblock/ios-snapshot-test-case-expecta/blob/master/EXPMatchers%2BFBSnapshotTest.m#L84-L85) directory, if you'd like to override this, you should include a `beforeAll` block setting the `setGlobalReferenceImageDir` in each file containing tests.
+
+```
+beforeAll(^{
+    setGlobalReferenceImageDir(FB_REFERENCE_IMAGE_DIR);
+});
+```
+
+
+### Example
+
+A complete project can be found in [FBSnapshotTestCaseDemo](FBSnapshotTestCaseDemo).
+
+Notably, take a look at [FBSnapshotTestCaseDemoSpecs.m](FBSnapshotTestCaseDemo/FBSnapshotTestCaseDemoTests/FBSnapshotTestCaseDemoSpecs.m) for a complete example, which is an expanded Specta version version of [FBSnapshotTestCaseDemoTests.m](https://github.com/facebook/ios-snapshot-test-case/blob/master/FBSnapshotTestCaseDemo/FBSnapshotTestCaseDemoTests/FBSnapshotTestCaseDemoTests.m).
+
+Finally you can consult the tests for [ARTiledImageView](https://github.com/dblock/ARTiledImageView/tree/master/Demo/DemoTests) or [NAMapKit](https://github.com/neilang/NAMapKit/tree/master/Demo/DemoTests).
+
+### License
+
+MIT, see [LICENSE](LICENSE.md)

data/Demo/Pods/FBSnapshotTestCase/FBSnapshotTestCase.h

@@ -0,0 +1,87 @@
+/*
+ *  Copyright (c) 2013, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ *
+ */
+
+#import <QuartzCore/QuartzCore.h>
+
+#import <UIKit/UIKit.h>
+
+#import <XCTest/XCTest.h>
+
+#ifndef FB_REFERENCE_IMAGE_DIR
+#define FB_REFERENCE_IMAGE_DIR "\"$(SOURCE_ROOT)/$(PROJECT_NAME)Tests/ReferenceImages\""
+#endif
+
+/**
+ Similar to our much-loved XCTAssert() macros. Use this to perform your test. No need to write an explanation, though.
+ @param view The view to snapshot
+ @param identifier An optional identifier, used is there are multiple snapshot tests in a given -test method.
+ */
+#define FBSnapshotVerifyView(view__, identifier__) \
+{ \
+  NSError *error__ = nil; \
+  NSString *referenceImagesDirectory__ = [NSString stringWithFormat:@"%s", FB_REFERENCE_IMAGE_DIR]; \
+  BOOL comparisonSuccess__ = [self compareSnapshotOfView:(view__) referenceImagesDirectory:referenceImagesDirectory__ identifier:(identifier__) error:&error__]; \
+  XCTAssertTrue(comparisonSuccess__, @"Snapshot comparison failed: %@", error__); \
+}
+
+/**
+ Similar to our much-loved XCTAssert() macros. Use this to perform your test. No need to write an explanation, though.
+ @param layer The layer to snapshot
+ @param identifier An optional identifier, used is there are multiple snapshot tests in a given -test method.
+ */
+#define FBSnapshotVerifyLayer(layer__, identifier__) \
+{ \
+  NSError *error__ = nil; \
+  NSString *referenceImagesDirectory__ = [NSString stringWithFormat:@"%s", FB_REFERENCE_IMAGE_DIR]; \
+  BOOL comparisonSuccess__ = [self compareSnapshotOfLayer:(layer__) referenceImagesDirectory:referenceImagesDirectory__ identifier:(identifier__) error:&error__]; \
+  XCTAssertTrue(comparisonSuccess__, @"Snapshot comparison failed: %@", error__); \
+}
+
+/**
+ The base class of view snapshotting tests. If you have small UI component, it's often easier to configure it in a test
+ and compare an image of the view to a reference image that write lots of complex layout-code tests.
+
+ In order to flip the tests in your subclass to record the reference images set `recordMode` to YES before calling
+ -[super setUp].
+ */
+@interface FBSnapshotTestCase : XCTestCase
+
+/**
+ When YES, the test macros will save reference images, rather than performing an actual test.
+ */
+@property (readwrite, nonatomic, assign) BOOL recordMode;
+
+/**
+ Performs the comparisong or records a snapshot of the layer if recordMode is YES.
+ @param layer The Layer to snapshot
+ @param referenceImagesDirectory The directory in which reference images are stored.
+ @param identifier An optional identifier, used is there are muliptle snapshot tests in a given -test method.
+ @param error An error to log in an XCTAssert() macro if the method fails (missing reference image, images differ, etc).
+ @returns YES if the comparison (or saving of the reference image) succeeded.
+ */
+- (BOOL)compareSnapshotOfLayer:(CALayer *)layer
+      referenceImagesDirectory:(NSString *)referenceImagesDirectory
+                    identifier:(NSString *)identifier
+                         error:(NSError **)errorPtr;
+
+/**
+ Performs the comparisong or records a snapshot of the view if recordMode is YES.
+ @param view The view to snapshot
+ @param referenceImagesDirectory The directory in which reference images are stored.
+ @param identifier An optional identifier, used is there are muliptle snapshot tests in a given -test method.
+ @param error An error to log in an XCTAssert() macro if the method fails (missing reference image, images differ, etc).
+ @returns YES if the comparison (or saving of the reference image) succeeded.
+ */
+- (BOOL)compareSnapshotOfView:(UIView *)view
+     referenceImagesDirectory:(NSString *)referenceImagesDirectory
+                   identifier:(NSString *)identifier
+                        error:(NSError **)errorPtr;
+
+@end

data/Demo/Pods/FBSnapshotTestCase/FBSnapshotTestCase.m

@@ -0,0 +1,82 @@
+/*
+ *  Copyright (c) 2013, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ *
+ */
+
+#import "FBSnapshotTestCase.h"
+
+#import "FBSnapshotTestController.h"
+
+@interface FBSnapshotTestCase ()
+
+@property (readwrite, nonatomic, retain) FBSnapshotTestController *snapshotController;
+
+@end
+
+@implementation FBSnapshotTestCase
+
+- (void)setUp
+{
+  [super setUp];
+  self.snapshotController = [[FBSnapshotTestController alloc] initWithTestClass:[self class]];
+}
+
+- (void)tearDown
+{
+  self.snapshotController = nil;
+  [super tearDown];
+}
+
+- (BOOL)recordMode
+{
+  return self.snapshotController.recordMode;
+}
+
+- (void)setRecordMode:(BOOL)recordMode
+{
+  self.snapshotController.recordMode = recordMode;
+}
+
+- (BOOL)compareSnapshotOfLayer:(CALayer *)layer
+      referenceImagesDirectory:(NSString *)referenceImagesDirectory
+                    identifier:(NSString *)identifier
+                         error:(NSError **)errorPtr
+{
+  return [self _compareSnapshotOfViewOrLayer:layer
+                    referenceImagesDirectory:referenceImagesDirectory
+                                  identifier:identifier
+                                       error:errorPtr];
+}
+
+- (BOOL)compareSnapshotOfView:(UIView *)view
+     referenceImagesDirectory:(NSString *)referenceImagesDirectory
+                   identifier:(NSString *)identifier
+                        error:(NSError **)errorPtr
+{
+  return [self _compareSnapshotOfViewOrLayer:view
+                    referenceImagesDirectory:referenceImagesDirectory
+                                  identifier:identifier
+                                       error:errorPtr];
+}
+
+#pragma mark -
+#pragma mark Private API
+
+- (BOOL)_compareSnapshotOfViewOrLayer:(id)viewOrLayer
+             referenceImagesDirectory:(NSString *)referenceImagesDirectory
+                           identifier:(NSString *)identifier
+                                error:(NSError **)errorPtr
+{
+  _snapshotController.referenceImagesDirectory = referenceImagesDirectory;
+  return [_snapshotController compareSnapshotOfViewOrLayer:viewOrLayer
+                                                  selector:self.selector
+                                                identifier:identifier
+                                                     error:errorPtr];
+}
+
+@end