1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
// Copyright (c) 2010 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_COCOA_COCOA_TEST_HELPER_H_
#define CHROME_BROWSER_COCOA_COCOA_TEST_HELPER_H_
#pragma once
#import <Cocoa/Cocoa.h>
#import "base/chrome_application_mac.h"
#include "base/debug_util.h"
#include "base/mac_util.h"
#include "base/path_service.h"
#import "base/mac/scoped_nsautorelease_pool.h"
#import "base/scoped_nsobject.h"
#include "chrome/common/chrome_constants.h"
#include "testing/platform_test.h"
// Background windows normally will not display things such as focus
// rings. This class allows -isKeyWindow to be manipulated to test
// such things.
@interface CocoaTestHelperWindow : NSWindow {
@private
BOOL pretendIsKeyWindow_;
}
// Init a borderless non-deferred window with a backing store.
- (id)initWithContentRect:(NSRect)contentRect;
// Init with a default frame.
- (id)init;
// Sets the responder passed in as first responder, and sets the window
// so that it will return "YES" if asked if it key window. It does not actually
// make the window key.
- (void)makePretendKeyWindowAndSetFirstResponder:(NSResponder*)responder;
// Clears the first responder duty for the window and returns the window
// to being non-key.
- (void)clearPretendKeyWindowAndFirstResponder;
// Set value to return for -isKeyWindow.
- (void)setPretendIsKeyWindow:(BOOL)isKeyWindow;
- (BOOL)isKeyWindow;
@end
// A test class that all tests that depend on AppKit should inherit from.
// Sets up NSApplication and paths correctly, and makes sure that any windows
// created in the test are closed down properly by the test. If you need to
// inherit from a different test class, but need to set up the AppKit runtime
// environment, you can call BootstrapCocoa directly from your test class. You
// will have to deal with windows on your own though.
class CocoaTest : public PlatformTest {
public:
// Sets up AppKit and paths correctly for unit tests. If you can't inherit
// from CocoaTest but are going to be using any AppKit features directly,
// or indirectly, you should be calling this from the c'tor or SetUp methods
// of your test class.
static void BootstrapCocoa();
CocoaTest();
virtual ~CocoaTest();
// Must be called by subclasses that override TearDown. We verify that it
// is called in our destructor. Takes care of making sure that all windows
// are closed off correctly. If your tests open windows, they must be sure
// to close them before CocoaTest::TearDown is called. A standard way of doing
// this would be to create them in SetUp (after calling CocoaTest::Setup) and
// then close them in TearDown before calling CocoaTest::TearDown.
virtual void TearDown();
// Retuns a test window that can be used by views and other UI objects
// as part of their tests. Is created lazily, and will be closed correctly
// in CocoaTest::TearDown. Note that it is a CocoaTestHelperWindow which
// has special handling for being Key.
CocoaTestHelperWindow* test_window();
private:
// Return a set of currently open windows. Avoiding NSArray so
// contents aren't retained, the pointer values can only be used for
// comparison purposes. Using std::set to make progress-checking
// convenient.
static std::set<NSWindow*> ApplicationWindows();
// Return a set of windows which are in |ApplicationWindows()| but
// not |initial_windows_|.
std::set<NSWindow*> WindowsLeft();
bool called_tear_down_;
base::mac::ScopedNSAutoreleasePool pool_;
// Windows which existed at the beginning of the test.
std::set<NSWindow*> initial_windows_;
// Strong. Lazily created. This isn't wrapped in a scoped_nsobject because
// we want to call [close] to destroy it rather than calling [release]. We
// want to verify that [close] is actually removing our window and that it's
// not hanging around because releaseWhenClosed was set to "no" on the window.
// It isn't wrapped in a different wrapper class to close it because we
// need to close it at a very specific time; just before we enter our clean
// up loop in TearDown.
CocoaTestHelperWindow* test_window_;
};
// A macro defining a standard set of tests to run on a view. Since we can't
// inherit tests, this macro saves us a lot of duplicate code. Handles simply
// displaying the view to make sure it won't crash, as well as removing it
// from a window. All tests that work with NSView subclasses and/or
// NSViewController subclasses should use it.
#define TEST_VIEW(test_fixture, test_view) \
TEST_F(test_fixture, AddRemove##test_fixture) { \
scoped_nsobject<NSView> view([test_view retain]); \
EXPECT_EQ([test_window() contentView], [view superview]); \
[view removeFromSuperview]; \
EXPECT_FALSE([view superview]); \
} \
TEST_F(test_fixture, Display##test_fixture) { \
[test_view display]; \
}
// A macro which determines the proper float epsilon for a CGFloat.
#if CGFLOAT_IS_DOUBLE
#define CGFLOAT_EPSILON DBL_EPSILON
#else
#define CGFLOAT_EPSILON FLT_EPSILON
#endif
// A macro which which determines if two CGFloats are equal taking a
// proper epsilon into consideration.
#define CGFLOAT_EQ(expected, actual) \
(actual >= (expected - CGFLOAT_EPSILON) && \
actual <= (expected + CGFLOAT_EPSILON))
// A test support macro which ascertains if two CGFloats are equal.
#define EXPECT_CGFLOAT_EQ(expected, actual) \
EXPECT_TRUE(CGFLOAT_EQ(expected, actual)) << \
expected << " != " << actual
// A test support macro which compares two NSRects for equality taking
// the float epsilon into consideration.
#define EXPECT_NSRECT_EQ(expected, actual) \
EXPECT_TRUE(CGFLOAT_EQ(expected.origin.x, actual.origin.x) && \
CGFLOAT_EQ(expected.origin.y, actual.origin.y) && \
CGFLOAT_EQ(expected.size.width, actual.size.width) && \
CGFLOAT_EQ(expected.size.height, actual.size.height)) << \
"Rects do not match: " << \
[NSStringFromRect(expected) UTF8String] << \
" != " << [NSStringFromRect(actual) UTF8String]
#endif // CHROME_BROWSER_COCOA_COCOA_TEST_HELPER_H_
|
