hoarder-js 0.0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.0.1 new library

data/Gemfile

@@ -0,0 +1,9 @@
+source :rubygems
+
+gem "echoe"
+gem 'rake'
+gem 'jasmine'
+gem 'jasmine-headless-webkit'
+
+gem 'keystone', git: "git://github.com/jpeace/keystone.git"
+gem 'cronus', git: "git://github.com/tshelburne/cronus-js.git"

data/Gemfile.lock

@@ -0,0 +1,100 @@
+GIT
+  remote: git://github.com/jpeace/keystone.git
+  revision: 3680c30328bf3b93af7c7f1b1bad685cbaec35dd
+  specs:
+    keystone (0.0.1)
+      closure-compiler
+      coffee-script
+      sass
+      sinatra
+
+GIT
+  remote: git://github.com/tshelburne/cronus-js.git
+  revision: c2cb5da182efb6c3742518dabda93f48b5281126
+  specs:
+    cronus (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    allison (2.0.3)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    closure-compiler (1.1.8)
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.6.2)
+    diff-lcs (1.2.4)
+    echoe (4.6.3)
+      allison (>= 2.0.3)
+      gemcutter (>= 0.7.0)
+      rake (>= 0.9.2)
+      rdoc (>= 3.6.1)
+      rubyforge (>= 2.0.4)
+    execjs (1.4.0)
+      multi_json (~> 1.0)
+    ffi (1.8.1)
+    gemcutter (0.7.1)
+    hike (1.2.2)
+    jasmine (1.3.2)
+      jasmine-core (~> 1.3.1)
+      rack (~> 1.0)
+      rspec (>= 1.3.1)
+      selenium-webdriver (>= 0.1.3)
+    jasmine-core (1.3.1)
+    jasmine-headless-webkit (0.8.4)
+      coffee-script
+      jasmine-core (~> 1.1)
+      multi_json
+      rainbow
+      sprockets (~> 2)
+    json (1.7.7)
+    json_pure (1.7.7)
+    multi_json (1.7.2)
+    rack (1.5.2)
+    rack-protection (1.5.0)
+      rack
+    rainbow (1.1.4)
+    rake (10.0.4)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.1)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+    rubyzip (0.9.9)
+    sass (3.2.8)
+    selenium-webdriver (2.32.1)
+      childprocess (>= 0.2.5)
+      multi_json (~> 1.0)
+      rubyzip
+      websocket (~> 1.0.4)
+    sinatra (1.4.2)
+      rack (~> 1.5, >= 1.5.2)
+      rack-protection (~> 1.4)
+      tilt (~> 1.3, >= 1.3.4)
+    sprockets (2.9.3)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    tilt (1.3.7)
+    websocket (1.0.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cronus!
+  echoe
+  jasmine
+  jasmine-headless-webkit
+  keystone!
+  rake

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Tim Shelburne
+
+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/Manifest

@@ -0,0 +1,42 @@
+CHANGELOG
+Gemfile
+Gemfile.lock
+LICENSE
+Manifest
+README.rdoc
+Rakefile
+assets/scripts/coffee/hoarder/form/form.coffee
+assets/scripts/coffee/hoarder/form/form_element.coffee
+assets/scripts/coffee/hoarder/form_manager.coffee
+assets/scripts/coffee/hoarder/submitter/form_submitter.coffee
+assets/scripts/coffee/hoarder/submitter/submitters/polling_submitter.coffee
+assets/scripts/coffee/hoarder/submitter/submitters/simple_submitter.coffee
+assets/scripts/coffee/hoarder/validator/constraints/alpha_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/alphanumeric_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/credit_card_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/email_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/max_length_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/min_length_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/numeric_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/phone_constraint.coffee
+assets/scripts/coffee/hoarder/validator/constraints/required_constraint.coffee
+assets/scripts/coffee/hoarder/validator/error/validation_error.coffee
+assets/scripts/coffee/hoarder/validator/form_validator.coffee
+assets/scripts/js/lib/jquery.js
+bin/hoarder.js
+config/assets.rb
+lib/hoarder.rb
+lib/hoarder/symbols.rb
+spec/jasmine.yml
+spec/runner.html
+spec/support/classes.coffee
+spec/support/helpers.coffee
+spec/support/mocks.coffee
+spec/support/objects.coffee
+spec/support/requirements.coffee
+spec/tests/form_manager_spec.coffee
+spec/tests/submitter/form_submitter_spec.coffee
+spec/tests/submitter/submitters/polling_submitter_spec.coffee
+spec/tests/submitter/submitters/simple_submitter_spec.coffee
+spec/tests/validator/constraints_spec.coffee
+spec/tests/validator/form_validator_spec.coffee

data/Rakefile

@@ -0,0 +1,38 @@
+$: << File.expand_path("#{File.dirname(__FILE__)}/lib")
+
+require 'hoarder'
+require 'cronus'
+
+require 'rake'
+require 'jasmine-headless-webkit'
+require 'keystone'
+require 'echoe'
+
+Echoe.new("hoarder-js") do |p|
+  p.author = "Tim Shelburne"
+  p.email = "shelburt02@gmail.com"
+  p.url = "https://github.com/tshelburne/hoarder-js"
+
+  p.ignore_pattern = FileList[".gitignore"]
+  p.development_dependencies = [ "jasmine", "jasmine-headless-webkit" ]
+end
+
+desc "Default"
+task default: :'test:jasmine'
+
+namespace :test do
+
+	desc "Run Jasmine tests"
+	Jasmine::Headless::Task.new(jasmine: :assets) do |t|
+	  t.colors = true
+	  t.keep_on_error = true
+	  t.jasmine_config = './spec/jasmine.yml'
+	end
+	
+end
+
+desc "Build assets"
+Keystone::RakeTask.new :assets do |t|
+  t.config_file = "config/assets.rb"
+  t.output_path = 'bin'
+end

data/assets/scripts/coffee/hoarder/form/form.coffee

@@ -0,0 +1,48 @@
+require "lib/jquery"
+
+FormElement = require "hoarder/form/form_element"
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# wraps an HTML form for easier form management
+#
+class Form
+  constructor: (formId, @type = "simple")->
+    @form = $("##{formId}")
+    @form.submit (e)-> e.preventDefault()
+    @action = @form.attr("action")
+    @method = @form.attr("method")
+    @addedElements = []
+
+  elements: ->
+    elements = []
+    inputs = @form.find("input")
+    elements = elements.concat inputs.toArray() if inputs.length > 0
+    selects = @form.find("select")
+    elements = elements.concat selects.toArray() if selects.length > 0
+    textareas = @form.find("textarea")
+    elements = elements.concat textareas.toArray() if textareas.length > 0
+
+    formElements = []
+    for element in elements
+      validationRules = if element.getAttribute("data-validation")? then (rule.trim() for rule in element.getAttribute("data-validation").split(',')) else []
+      selector = "#{element.nodeName}[data-bind='#{element.getAttribute("data-bind")}']"
+      formElements.push new FormElement(element.name, element.value, selector, validationRules)
+    formElements
+
+  addElement: (name, value, isRemovable = true)->
+    @form.append "<input type='hidden' name='#{name}' value='#{value}'/>"
+    @addedElements.push $("input[name='#{name}']", @form) if isRemovable
+
+  addElements: (elements)-> @addElement(element.name, element.value) for element in elements
+
+  updateAddedElement: (name, value)->  @form.find("input[name='#{name}']").val(value)
+
+  clearAddedElements: ->
+    element.remove() for element in @addedElements
+    @addedElements = []
+
+  serialize: -> @form.serialize()
+
+return Form

data/assets/scripts/coffee/hoarder/form/form_element.coffee

@@ -0,0 +1,22 @@
+require "lib/jquery"
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# represents a single element in a form
+#
+class FormElement
+  constructor: (@name, @value, @selector, @validationRules = [])->
+
+  addError: (error)->
+    $(@selector).closest("li").addClass("invalid")
+    $(@selector).closest("li").find("aside.tooltip").html(error.message)
+    $(@selector).focus -> $(this).closest("li").addClass("focused")
+    $(@selector).blur -> $(this).closest("li").removeClass("focused")
+
+  clearError: ->
+    $(@selector).closest("li").removeClass("invalid")
+    $(@selector).closest("li").find("aside.tooltip").html("")
+    $(@selector).unbind("focus").unbind("blur")
+
+return FormElement

data/assets/scripts/coffee/hoarder/form_manager.coffee

@@ -0,0 +1,32 @@
+Signal = require "cronus/signal"
+SignalRelay = require "cronus/signal_relay"
+
+FormSubmitter = require 'hoarder/submitter/form_submitter'
+FormValidator = require 'hoarder/validator/form_validator'
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# abstracts submitting and validating forms from the validator and submitter
+#
+class FormManager
+  constructor: (@formSubmitter, @formValidator)->
+    @validatedWithErrors = new Signal()
+    @submittedWithSuccess = new SignalRelay(@formSubmitter.submittedWithSuccess)
+    @submittedWithError = new SignalRelay(@formSubmitter.submittedWithError)
+
+  @default: (pollingUrl="")->
+    new @(FormSubmitter.default(pollingUrl), FormValidator.default())
+
+  validateForm: (form)->
+    @formValidator.validateForm(form)
+
+  submitForm: (form)->
+    errors = @validateForm(form)
+
+    if (errors.length > 0)
+      @validatedWithErrors.dispatch(errors)
+    else
+      @formSubmitter.submitForm(form)
+
+return FormManager

data/assets/scripts/coffee/hoarder/submitter/form_submitter.coffee

@@ -0,0 +1,29 @@
+MultiSignalRelay = require "cronus/multi_signal_relay"
+
+SimpleSubmitter = require "hoarder/submitter/submitters/simple_submitter"
+PollingSubmitter = require "hoarder/submitter/submitters/polling_submitter"
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# a class to handle submitting forms
+#
+class FormSubmitter
+  constructor: (@submitters)->
+    successSignals = []
+    errorSignals = []
+    for submitter in @submitters
+      successSignals.push submitter.submittedWithSuccess
+      errorSignals.push submitter.submittedWithError
+
+    @submittedWithSuccess = new MultiSignalRelay(successSignals)
+    @submittedWithError = new MultiSignalRelay(errorSignals)
+
+  @default: (pollingUrl)->
+    new @([ new SimpleSubmitter(), new PollingSubmitter(pollingUrl, 1000)])
+
+  submitForm: (form)->
+    for submitter in @submitters
+      submitter.submitForm(form) if submitter.canSubmit(form)
+
+return FormSubmitter

data/assets/scripts/coffee/hoarder/submitter/submitters/polling_submitter.coffee

@@ -0,0 +1,36 @@
+SimpleSubmitter = require "hoarder/submitter/submitters/simple_submitter"
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# handles executing a delayed
+#
+class PollingSubmitter extends SimpleSubmitter
+  constructor: (@pollUrl, @pollFrequency)->
+    super()
+
+  canSubmit: (form)-> form.type is "polling"
+
+  submitSuccess: (form, data)->
+    @interval = setInterval( =>
+      @queryPoll(form, data.pollId)
+    , @pollFrequency)
+    @queryPoll(form, data.pollId)
+
+  queryPoll: (form, pollId)=>
+    unless @executing
+      @executing = true
+      $.ajax
+        url: @pollUrl
+        type: "POST"
+        data: "pollId=#{pollId}"
+        success: (data)=> @pollSuccess(form, pollId, data)
+        error: (xhr, text)=> @submitError(form, xhr, text)
+
+  pollSuccess: (form, pollId, data)=>
+    @executing = false
+    if data.pollCompleted
+      clearInterval(@interval)
+      @submittedWithSuccess.dispatch(form, data.pollData)
+
+return PollingSubmitter

data/assets/scripts/coffee/hoarder/submitter/submitters/simple_submitter.coffee

@@ -0,0 +1,30 @@
+require "lib/jquery"
+
+Signal = require "cronus/signal"
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# handles submitting a form and waiting for a response
+#
+class SimpleSubmitter
+  constructor: ->
+    @submittedWithSuccess = new Signal()
+    @submittedWithError = new Signal()
+
+  canSubmit: (form)-> form.type is "simple"
+
+  submitForm: (form)->
+    $.ajax
+      url: form.action
+      type: form.method
+      data: form.serialize()
+      success: (data)=>
+        @submitSuccess(form, data)
+      error: (xhr, text)=> @submitError(form, xhr, text)
+
+  submitSuccess: (form, data)-> @submittedWithSuccess.dispatch(form, data)
+
+  submitError: (form, xhr, text)-> @submittedWithError.dispatch(form, text)
+
+return SimpleSubmitter

data/assets/scripts/coffee/hoarder/validator/constraints/alpha_constraint.coffee

@@ -0,0 +1,18 @@
+ValidationError = require "hoarder/validator/error/validation_error"
+
+#
+# @author - Tim Shelburne <tim@musiconelive.com>
+#
+# 
+#
+class AlphaConstraint
+  canHandle: (type)->
+    type is "alpha"
+
+  handle: (element)->
+#    if element.value.match(/^[A-Za-z0-9\s]*$/)
+#      return []
+#    else
+#      return [ new ValidationError "This field only accepts numbers and characters (0-9, A-Z, a-z)." ]
+
+return AlphaConstraint