hamcrest4qunit 1.3.0

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.sublime-project
+*.sublime-workspace

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hamcrest4qunit.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 TODO: Write your name
+
+MIT License
+
+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/README.md

@@ -0,0 +1,38 @@
+# Hamcrest4qunit
+
+Hamcrest4QUnit is a port of the [Hamcrest](http://code.google.com/p/hamcrest/)
+matchers set intended to work with [QUnit](http://docs.jquery.com/Qunit).
+
+Sarting with the version 1.3.0, `hamcrest4qunit` is provided as a ruby gem.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'hamcrest4qunit'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hamcrest4qunit
+
+## Usage
+
+Add this line to your tests manifest:
+
+    //= require hamcrest4qunit
+
+To include the `hamcrest4qunit` test suite in your own tests, add this line to your tests manifest:
+
+    //= require hamcrest4qunit/test
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/app/assets/javascripts/hamcrest4qunit/description.js.coffee

@@ -0,0 +1,23 @@
+class h4q.Description
+  constructor: (@message="", @diff=null) ->
+
+  toString: -> @message
+  hasDiff: -> @diff?
+  clearMessage: -> @message = ""; this
+  appendText: (msg) -> @append msg; this
+
+  appendValue: (val) ->
+    @append "<span class='value'>#{QUnit.jsDump.parse val}</span>"
+    this
+
+  appendRawValue: (val) ->
+    @append "<span class='value'>#{val}</span>"
+    this
+
+  appendDescriptionOf: (matcher) ->
+    matcher.describeTo this
+    this
+
+  append: (s) ->
+    @message += " " if @message isnt ""
+    @message += s

data/app/assets/javascripts/hamcrest4qunit/h4q.js.coffee

@@ -0,0 +1,158 @@
+TAB_STRING = "   "
+
+h4q = {}
+window.h4q = h4q
+
+h4q.tokenReplace = (s) ->
+  args = h4q.argumentsToArray arguments
+  args.shift()
+
+  if args.length > 0 and args[0] instanceof Object
+    kwargs = args[0]
+    s = s.replace /\${([^}]+)}/g, ->
+      key = arguments[1]
+      if kwargs.hasOwnProperty(key) then kwargs[key] else arguments[0]
+
+    args.shift()
+
+  s.replace /\$([0-9]+)/g, ->
+    index = parseInt arguments[1]
+    if index < args.length then args[index] else arguments[0]
+
+h4q.argumentsToArray = (args) -> arg for arg in args
+
+h4q.sortProperties = (o) ->
+  b = (k for k of o)
+  b.sort()
+  b
+
+h4q.getType = (thing) ->
+  return "Null" unless thing?
+
+  results = /\[object (.{1,})\]/.exec Object.prototype.toString.call thing
+
+  if results and results.length > 1 then results[1] else ""
+
+h4q.getTypeName = (type) ->
+  results = /function (.{1,})\(/.exec type.toString()
+  if results and results.length > 1 then results[1] else ""
+
+h4q.aPrefix = (s) -> if s.substr(0,1) in "aeiouAEIOU" then "an" else "a"
+
+h4q.escapeHtml = (s) ->
+  return "" unless s?
+
+  s = String(s)
+  s.replace /[\&"<>\\]/g, (s) ->
+    switch s
+      when "&"  then "&amp"
+      when "\\" then "\\\\"
+      when '"'  then '\"'
+      when "<"  then "&lt"
+      when ">"  then "&gt"
+      else s
+
+h4q.nodeToString = (node, indent="") ->
+  unless node? and node instanceof Node
+    throw new Error
+      message: "nodeToString expect a valid node as argument"
+
+  isRootCall = indent is ""
+  tag = String(node.nodeName).toLowerCase()
+  attr = h4q.attrToString node
+  content = h4q.contentToString node, indent
+
+  s = "#{indent}<#{tag}#{attr}>#{content}</#{tag}>"
+
+  if isRootCall then h4q.escapeHtml s else s
+
+h4q.attrToString = (node) ->
+  exludedAttrs = [
+    "length",          "item",             "getNamedItem",
+    "setNamedItem",    "removeNamedItem",  "getNamedItemNS",
+    "setNamedItemNS",  "removeNamedItemNS"
+  ]
+
+  s = ""
+  alreadyPrinted = []
+  for attr of node.attributes
+    name = node.attributes[attr].name
+
+    unless attr in exludedAttrs or name in alreadyPrinted
+      s += " #{name}=\"#{node.attributes[attr].value}\""
+      alreadyPrinted.push name
+
+  return s
+
+h4q.contentToString = (node, indent) ->
+  s = ""
+  nodes = node.childNodes
+  return "" unless nodes?
+
+  l = nodes.length
+  contentIsOnlyText = true
+  res = []
+  for node in nodes
+
+    if node.nodeType is 3 then res.push node.textContent
+    else
+      res.push h4q.nodeToString node, indent + TAB_STRING
+      contentIsOnlyText = false
+
+  if contentIsOnlyText then s += res.join ""
+  else
+    res = res.map (o, i) ->
+      if /</.exec o then o else indent + TAB_STRING + o
+
+    s += "\n#{res.join "\n"}"
+
+  s + (if l > 0 and not contentIsOnlyText then "\n#{indent}" else "")
+
+h4q.push = (result, mismatchMsg, expectedMsg, message) ->
+  details =
+      result: result
+      message: message
+
+  resultMsg = "<tr class='test-actual'>
+                <th>#{if result? then "And:" else "But:"}</th>
+                <td><pre>#{mismatchMsg.message}</pre></td>
+              </tr>"
+
+  diffMsg = if mismatchMsg.hasDiff()
+    "<tr class='test-diff'>
+      <th>Diff: </th>
+      <td><pre>#{mismatchMsg.diff}</pre></td>
+    </tr>"
+  else
+    ""
+
+  output = "<span class='test-message'>#{message}</span>
+            <table>
+              <tr class='test-expected'>
+                <th>Expected: </th>
+                <td><pre>#{expectedMsg.message}</pre></td>
+              </tr>
+              #{resultMsg}
+              #{diffMsg}
+            </table>"
+
+  QUnit.log details
+  QUnit.config.current.assertions.push
+    result: result,
+    message: output
+
+h4q.assertThat = (target, matcher=h4q.equalTo(true), description=null) ->
+  throw new Error message: "Unsupported assertion" if arguments.length is 0
+
+  expectedMsg = new Description()
+  mismatchMsg = new Description()
+
+  matcher = h4q.equalTo matcher unless matcher instanceof Matcher
+
+  expectedMsg.appendDescriptionOf( matcher )
+  result = matcher.matches( target, mismatchMsg )
+
+  h4q.push result,
+           mismatchMsg,
+           expectedMsg,
+           if message? then message else if result? then "okay" else "failed"

data/app/assets/javascripts/hamcrest4qunit/index.js.coffee

@@ -0,0 +1,7 @@
+#= require ./h4q
+#= require ./description
+#= require ./matcher
+#= require ./matchers
+
+# Matchers are available as top level functions.
+window[k] = v for k,v of window.h4q

data/app/assets/javascripts/hamcrest4qunit/matcher.js.coffee

@@ -0,0 +1,31 @@
+class h4q.Matcher
+  constructor: (options) ->
+
+    unless options._matches
+      throw new Error
+        message: "Improperly configured matcher, the matcher
+                  expect a _matches method"
+
+    if typeof options._matches isnt "function"
+      throw new Error
+        message: "Improperly configured matcher, the _matches
+                  argument must be a function"
+
+    unless options._describeTo
+      throw new Error
+        message: "Improperly configured matcher, the matcher expect
+                  a _describeTo method"
+
+    if typeof options._describeTo isnt "function"
+      throw new Error
+        message: "Improperly configured matcher, the _describeTo
+                  argument must be a function"
+
+    @[k] = v for k, v of options
+
+  matches: (v, mismatchMsg) ->
+    @_matches.call this, v, mismatchMsg
+
+  describeTo: ( msg ) ->
+    @_describeTo.call this, msg
+

data/app/assets/javascripts/hamcrest4qunit/matchers/arrays.js.coffee

@@ -0,0 +1,221 @@
+h4q.arrayWithLength = (l) ->
+  if isNaN l
+    throw new Error message: "length argument must be a valid number"
+  if l < 0
+    throw new Error
+      message: "length argument must be greater than or equal to 0"
+
+  new Matcher
+    length: l
+    _matches: (v,msg) ->
+      msg.appendText("was").appendValue(v)
+      v? and
+      v instanceof Array and
+      v.length == @length
+
+    _describeTo: (msg) ->
+      msg.appendText("an Array with")
+         .appendValue(@length)
+         .appendText(if @length > 1 then "items" else "item")
+
+h4q.emptyArray = ->
+  new Matcher
+    _matches: (v,msg) ->
+      msg.appendText("was").appendValue(v)
+      v? and
+      v instanceof Array and
+      v.length is 0
+
+    _describeTo: (msg) ->
+      msg.appendText "an empty Array"
+
+h4q.array = ->
+  args = h4q.argumentsToArray arguments
+  matchers = []
+  l = args.length
+
+  return h4q.emptyArray() if l is 0
+
+  for m in args
+    if m instanceof Matcher
+      matchers.push m
+    else
+      matchers.push equalTo m
+
+  new Matcher
+    matchers: matchers
+    _matches: (v,msg) ->
+      l = @matchers.length
+
+      unless v?
+        msg.appendText("was").appendValue(null)
+        false
+      else unless v instanceof Array
+        msg.appendText("was").appendValue(v)
+        false
+      else if v.length isnt l
+        msg.appendText("was an Array with")
+           .appendValue(v.length)
+           .appendText(if v.length > 1 then "items" else "item")
+        false
+      else
+        a = @matchers
+        hasError = false
+        msg.appendText("was").appendRawValue("[").appendText("\n")
+
+        v.forEach (o,i) ->
+          msgtmp = new Description()
+          res = a[i].matches o, msgtmp
+          msg.appendText "  "
+          if res
+            msg.appendValue o
+          else
+            msg.appendText msgtmp.message
+            hasError = true
+
+          msg.appendText ",\n" if i < l-1
+
+        msg.appendRawValue "\n]"
+
+        not hasError
+
+    _describeTo: (msg) ->
+      l = @matchers.length
+
+      msg.appendText("an Array with")
+         .appendValue(l)
+         .appendText(if l > 1 then "items" else "item")
+         .appendText("like").appendRawValue("[").appendText("\n   ")
+
+      for matcher, i in @matchers
+        msg.appendDescriptionOf matcher
+        msg.appendText(",\n   ") if i < l-1
+
+      msg.appendRawValue("\n]")
+
+h4q.everyItem = (m) ->
+  unless m?
+    throw new Error message: "everyItem must receive an argument"
+
+  m = equalTo m unless m instanceof Matcher
+
+  new Matcher
+    matcher: m
+    _matches: (v, msg) ->
+      unless v?
+        msg.appendText("was").appendValue(null)
+        false
+      else unless v instanceof Array
+        msg.appendText("was").appendValue(v)
+        false
+      else
+        for val, i in v
+          msgtmp = new Description()
+          unless @matcher.matches val, msgtmp
+            msg.appendText(msgtmp.message)
+               .appendText("at index")
+               .appendValue(i)
+            return false
+
+        msg.appendText("was").appendValue(v)
+        true
+
+    _describeTo: (msg) ->
+      msg.appendText("an Array of which every item is")
+         .appendDescriptionOf( @matcher )
+
+h4q.hasItem = (m) ->
+  unless m?
+    throw new Error message: "hasItem must receive an argument"
+
+  m = equalTo m unless m instanceof Matcher
+
+  new Matcher
+    matcher: m
+    _matches: (v,msg) ->
+      unless v?
+        msg.appendText("was").appendValue(null)
+        false
+      unless v instanceof Array
+        msg.appendText("was").appendValue(v)
+        false
+      else
+        l = v.length
+        for val in v
+          msgtmp = new Description()
+          if @matcher.matches val, msgtmp
+            msg.appendText("was").appendValue(v)
+            return true
+
+        msg.appendText "can't find any"
+        false
+
+    _describeTo: (msg) ->
+      msg.appendText("an Array containing").appendDescriptionOf(@matcher)
+
+h4q.hasItems = ->
+  args = h4q.argumentsToArray arguments
+  if args.length is 0
+    throw new Error message: "hasItems must receive at least one argument"
+
+  matchers = []
+  for m in args
+    if m instanceof Matcher
+      matchers.push m
+    else
+      matchers.push equalTo m
+
+  new Matcher
+    matchers: matchers
+    _matches: (v,msg) ->
+      unless v?
+        msg.appendText("was").appendValue(null)
+        false
+      unless v instanceof Array
+        msg.appendText("was").appendValue(v)
+        false
+      else
+        l = @matchers.length
+        k = v.length
+        gres = true
+        mismsg = []
+        msgtmp = new Description()
+        for m in @matchers
+          res = false
+          for val, j in v
+            res = m.matches(val, msgtmp) or res
+
+          unless res
+            d = new Description()
+            d.appendDescriptionOf m
+            mismsg.push d
+
+          gres = res and gres
+
+        if gres
+          msg.appendText("was").appendValue(v)
+        else
+          l = mismsg.length
+          if l is 1
+            msg.appendText("can't find").appendText( mismsg )
+          else
+            msg.appendText("can't find neither")
+            for v, i in mismsg
+              if i is l-1
+                msg.appendText "nor"
+              else if i > 0
+                msg.appendText ","
+
+              msg.appendText v
+        gres
+
+    _describeTo: (msg) ->
+      msg.appendText "an Array containing"
+      for m, i in @matchers
+        if i is @matchers.length - 1
+          msg.appendText "and"
+        else if i > 0
+          msg.appendText ","
+
+        msg.appendDescriptionOf m
+