Add asymmetric equality tester to match a string against a regexp

- Also move the asymmetric testers into their own dir for easier
  locating.

[#58120558] Fix #243

spec/core/asymmetric_equality/AnySpec.js

@@ -0,0 +1,46 @@
+describe("Any", function() {
+  it("matches a string", function() {
+    var any = new j$.Any(String);
+
+    expect(any.asymmetricMatch("foo")).toBe(true);
+  });
+
+  it("matches a number", function() {
+    var any = new j$.Any(Number);
+
+    expect(any.asymmetricMatch(1)).toBe(true);
+  });
+
+  it("matches a function", function() {
+    var any = new j$.Any(Function);
+
+    expect(any.asymmetricMatch(function(){})).toBe(true);
+  });
+
+  it("matches an Object", function() {
+    var any = new j$.Any(Object);
+
+    expect(any.asymmetricMatch({})).toBe(true);
+  });
+  
+  it("matches a Boolean", function() {
+    var any = new j$.Any(Boolean);
+
+    expect(any.asymmetricMatch(true)).toBe(true);
+  });
+
+  it("matches another constructed object", function() {
+    var Thing = function() {},
+      any = new j$.Any(Thing);
+
+    expect(any.asymmetricMatch(new Thing())).toBe(true);
+  });
+
+  it("jasmineToString's itself", function() {
+    var any = new j$.Any(Number);
+
+    expect(any.jasmineToString()).toMatch('<jasmine.any');
+    expect(any.jasmineToString()).toMatch('Number');
+  });
+
+});

spec/core/asymmetric_equality/AnythingSpec.js

@@ -0,0 +1,38 @@
+describe("Anything", function() {
+  it("matches a string", function() {
+    var anything = new j$.Anything();
+
+    expect(anything.asymmetricMatch('foo')).toBe(true);
+  });
+
+  it("matches a number", function() {
+    var anything = new j$.Anything();
+
+    expect(anything.asymmetricMatch(42)).toBe(true);
+  });
+
+  it("matches an object", function() {
+    var anything = new j$.Anything();
+
+    expect(anything.asymmetricMatch({ foo: 'bar' })).toBe(true);
+  });
+
+  it("matches an array", function() {
+    var anything = new j$.Anything();
+
+    expect(anything.asymmetricMatch([1,2,3])).toBe(true);
+  });
+
+  it("doesn't match undefined", function() {
+    var anything = new j$.Anything();
+
+    expect(anything.asymmetricMatch()).toBe(false);
+    expect(anything.asymmetricMatch(undefined)).toBe(false);
+  });
+
+  it("doesn't match null", function() {
+    var anything = new j$.Anything();
+
+    expect(anything.asymmetricMatch(null)).toBe(false);
+  });
+});

spec/core/asymmetric_equality/ObjectContainingSpec.js

@@ -0,0 +1,58 @@
+describe("ObjectContaining", function() {
+
+  it("matches any actual to an empty object", function() {
+    var containing = new j$.ObjectContaining({});
+
+    expect(containing.asymmetricMatch("foo")).toBe(true);
+  });
+
+  it("does not match an empty object actual", function() {
+    var containing = new j$.ObjectContaining("foo");
+
+    expect(function() {
+      containing.asymmetricMatch({})
+    }).toThrowError(/not 'foo'/)
+  });
+
+  it("matches when the key/value pair is present in the actual", function() {
+    var containing = new j$.ObjectContaining({foo: "fooVal"});
+
+    expect(containing.asymmetricMatch({foo: "fooVal", bar: "barVal"})).toBe(true);
+  });
+
+  it("does not match when the key/value pair is not present in the actual", function() {
+    var containing = new j$.ObjectContaining({foo: "fooVal"});
+
+    expect(containing.asymmetricMatch({bar: "barVal", quux: "quuxVal"})).toBe(false);
+  });
+
+  it("does not match when the key is present but the value is different in the actual", function() {
+    var containing = new j$.ObjectContaining({foo: "other"});
+
+    expect(containing.asymmetricMatch({foo: "fooVal", bar: "barVal"})).toBe(false);
+  });
+
+  it("jasmineToString's itself", function() {
+    var containing = new j$.ObjectContaining({});
+
+    expect(containing.jasmineToString()).toMatch("<jasmine.objectContaining");
+  });
+
+  it("matches recursively", function() {
+    var containing = new j$.ObjectContaining({one: new j$.ObjectContaining({two: {}})});
+
+    expect(containing.asymmetricMatch({one: {two: {}}})).toBe(true);
+  });
+
+  it("matches when key is present with undefined value", function() {
+    var containing = new j$.ObjectContaining({ one: undefined });
+
+    expect(containing.asymmetricMatch({ one: undefined })).toBe(true);
+  });
+
+  it("does not match when key with undefined value is not present", function() {
+    var containing = new j$.ObjectContaining({ one: undefined });
+
+    expect(containing.asymmetricMatch({})).toBe(false);
+  });
+});

spec/core/asymmetric_equality/StringMatchingSpec.js

@@ -0,0 +1,21 @@
+describe("StringMatching", function() {
+  it("matches a string against a provided regexp", function() {
+    var matcher = new j$.StringMatching(/foo/);
+
+    expect(matcher.asymmetricMatch('barfoobaz')).toBe(true);
+    expect(matcher.asymmetricMatch('barbaz')).toBe(false);
+  });
+
+  it("matches a string against provided string", function() {
+    var matcher = new j$.StringMatching('foo');
+
+    expect(matcher.asymmetricMatch('barfoobaz')).toBe(true);
+    expect(matcher.asymmetricMatch('barbaz')).toBe(false);
+  });
+
+  it("raises an Error when the expected is not a String or RegExp", function() {
+    expect(function() {
+      new j$.StringMatching({});
+    }).toThrowError(/not a String or a RegExp/);
+  });
+});