hoarder-js 0.0.1 → 0.0.2

data/CHANGELOG

@@ -1 +1,3 @@
+v0.0.2 removed all dependencies on jquery and update library API - version 1.0.0 pending successful use in a production project
+
 v0.0.1 new library

data/Gemfile.lock

@@ -1,6 +1,6 @@
 GIT
   remote: git://github.com/jpeace/keystone.git
-  revision: 3680c30328bf3b93af7c7f1b1bad685cbaec35dd
+  revision: 54627ade405d8b3307e349f36bab6e87b75fae84
   specs:
     keystone (0.0.1)
       closure-compiler
@@ -85,7 +85,7 @@ GEM
       multi_json (~> 1.0)
       rack (~> 1.0)
       tilt (~> 1.1, != 1.3.0)
-    tilt (1.3.7)
+    tilt (1.4.0)
     websocket (1.0.7)
 
 PLATFORMS

data/Manifest

@@ -6,13 +6,15 @@ Manifest
 README.rdoc
 Rakefile
 assets/scripts/coffee/hoarder/form/form.coffee
-assets/scripts/coffee/hoarder/form/form_element.coffee
+assets/scripts/coffee/hoarder/form/form_serializer.coffee
 assets/scripts/coffee/hoarder/form_manager.coffee
 assets/scripts/coffee/hoarder/submitter/form_submitter.coffee
+assets/scripts/coffee/hoarder/submitter/submitters/base_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/base_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
@@ -20,9 +22,12 @@ 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
+assets/scripts/coffee/hoarder/validator/rules/validation_rule.coffee
+assets/scripts/js/lib/bonzo.js
+assets/scripts/js/lib/qwery.js
+assets/scripts/js/lib/reqwest.js
+assets/scripts/js/patches/event_listeners.js
 bin/hoarder.js
 config/assets.rb
 lib/hoarder.rb
@@ -30,13 +35,19 @@ lib/hoarder/symbols.rb
 spec/jasmine.yml
 spec/runner.html
 spec/support/classes.coffee
+spec/support/fixtures.coffee
 spec/support/helpers.coffee
+spec/support/lib/jasmine-fixture.js
+spec/support/lib/jquery-1.7.1.min.js
 spec/support/mocks.coffee
 spec/support/objects.coffee
 spec/support/requirements.coffee
+spec/tests/form/form_serializer_spec.coffee
+spec/tests/form/form_spec.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
+spec/tests/validator/validation_rule_spec.coffee

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

@@ -1,48 +1,51 @@
-require "lib/jquery"
+FormSerializer = require 'hoarder/form/form_serializer'
 
-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()
+
+	constructor: (@formElement)->
+		@addedElements = [ ]
+
+	elements: -> (@formElement[index] for index in [0..@formElement.length] when @formElement[index]?.nodeName in [ 'INPUT', 'SELECT', 'TEXTAREA' ])
+
+	action: -> @formElement.action
+
+	method: -> @formElement.method
+
+	addElement: (name, value)->
+		throw new Error "'#{name}' already exists as an element on the form." if @hasElement name
+		element = createElement name, value
+		@formElement.appendChild element
+		@addedElements.push element
+		element
+
+	addElements: (elements)->
+		errors = [ ]
+		for element in elements
+			try @addElement(element.name, element.value) 
+			catch e 
+				errors.push e
+		throw errors[0] if errors.length
+
+	hasElement: (name)-> @getElement(name)?
+
+	getElement: (name)-> @formElement[name] if @formElement[name] instanceof HTMLElement
+
+	updateAddedElement: (name, value)-> if @formElement[name]? then @formElement[name].value = value else @addElement name, value
+
+	clearAddedElements: ->
+		@formElement.removeChild element for element in @addedElements
+		@addedElements = []
+
+	serialize: -> FormSerializer.toString @
+
+
+	# private
+
+	createElement = (name, value)->
+		element = document.createElement("input")
+		element.type = "hidden"
+		element.name = name
+		element.value = value
+		element
 
 return Form

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

@@ -0,0 +1,23 @@
+class Serializer
+
+	@toString: (form)-> removeNulls((serializeElement element for element in form.elements())).join("&")
+
+	# private
+
+	serializeElement = (element)->
+		return "#{element.name}=#{encodeURIComponent element.value}" unless isComplicated element
+		return "#{element.name}=#{encodeURIComponent element.value}" if isCheckable(element) and element.checked
+		return ("#{element.name}=#{encodeURIComponent option.value}" for option in element.options when option.selected).join("&") if isMultiSelect(element)
+		null
+
+	isComplicated = (element)-> isCheckable(element) or isMultiSelect(element) or isFile(element)
+
+	isCheckable = (element)-> element.nodeName is "INPUT" and element.type in [ "checkbox", "radio" ]
+
+	isMultiSelect = (element)-> element.nodeName is "SELECT" and element.type is "select-multiple"
+
+	isFile = (element)-> element.nodeName is "INPUT" and element.type is "file"
+
+	removeNulls = (array)-> array.filter((e)-> return e)
+
+return Serializer

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

@@ -1,32 +1,48 @@
+require 'patches/event_listeners'
+
 Signal = require "cronus/signal"
 SignalRelay = require "cronus/signal_relay"
 
+Form = require 'hoarder/form/form'
 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())
+	@create: (pollingUrl="", pollFrequency=1000)->
+		new @(FormSubmitter.create(pollingUrl, pollFrequency), FormValidator.create())
+
+	constructor: (@formSubmitter, @formValidator)->
+		@validatedWithErrors = new Signal()
+		@submittedWithSuccess = new SignalRelay(@formSubmitter.submittedWithSuccess)
+		@submittedWithError = new SignalRelay(@formSubmitter.submittedWithError)
+		@_forms = [ ]
+		@_listeners = { }
+
+	manage: (formId, type='simple')-> 
+		throw new Error "'#{formId}' is already a managed form." if getForm.call(@, formId)?
+		formElement = document.getElementById formId
+		form = new Form(formElement)
+		formElement.addEventListener 'submit', @_listeners[formId] = (event)=>
+			event.preventDefault()
+			submit.call @, form, type
+		@_forms.push form
+		form
 
-  validateForm: (form)->
-    @formValidator.validateForm(form)
+	release: (formId)->
+		form = getForm.call @, formId
+		form.formElement.removeEventListener 'submit', @_listeners[formId]
+		delete @_listeners[formId]
+		@_forms.splice @_forms.indexOf(form), 1
 
-  submitForm: (form)->
-    errors = @validateForm(form)
+	getForm = (formId)-> 
+		for form in @_forms 
+			return form if form.formElement.id is formId
 
-    if (errors.length > 0)
-      @validatedWithErrors.dispatch(errors)
-    else
-      @formSubmitter.submitForm(form)
+	submit = (form, type)-> 
+		if @formValidator.validateForm form
+			@formSubmitter.submit form, type
+		else 
+			@validatedWithErrors.dispatch form
 
 return FormManager

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

@@ -3,27 +3,22 @@ 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
+
+  @create: (pollingUrl, pollFrequency=1000)->
+    new @([ new SimpleSubmitter(), new PollingSubmitter(pollingUrl, pollFrequency)])
+
   constructor: (@submitters)->
-    successSignals = []
-    errorSignals = []
-    for submitter in @submitters
-      successSignals.push submitter.submittedWithSuccess
-      errorSignals.push submitter.submittedWithError
+    successSignals = (submitter.submittedWithSuccess for submitter in @submitters)
+    errorSignals = (submitter.submittedWithError for submitter in @submitters)
 
     @submittedWithSuccess = new MultiSignalRelay(successSignals)
     @submittedWithError = new MultiSignalRelay(errorSignals)
 
-  @default: (pollingUrl)->
-    new @([ new SimpleSubmitter(), new PollingSubmitter(pollingUrl, 1000)])
-
-  submitForm: (form)->
+  submit: (form, type)->
     for submitter in @submitters
-      submitter.submitForm(form) if submitter.canSubmit(form)
+      if submitter.canSubmit(type)
+        submitter.submit form 
+        break
 
 return FormSubmitter

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

@@ -0,0 +1,11 @@
+Signal = require 'cronus/signal'
+
+class BaseSubmitter
+
+	constructor: ->
+    @submittedWithSuccess = new Signal()
+    @submittedWithError = new Signal()
+
+  canSubmit: (type)-> type is @type
+
+return BaseSubmitter

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

@@ -1,36 +1,39 @@
-SimpleSubmitter = require "hoarder/submitter/submitters/simple_submitter"
+require 'lib/reqwest'
 
-#
-# @author - Tim Shelburne <tim@musiconelive.com>
-#
-# handles executing a delayed
-#
-class PollingSubmitter extends SimpleSubmitter
+BaseSubmitter = require "hoarder/submitter/submitters/base_submitter"
+
+class PollingSubmitter extends BaseSubmitter
+  
   constructor: (@pollUrl, @pollFrequency)->
     super()
+    @type = 'polling'
 
-  canSubmit: (form)-> form.type is "polling"
+  submit: (form)->
+    reqwest(
+      url: form.action
+      type: form.method
+      data: form.serialize()
+      success: (data)=> @poll(form, data.processId)
+      error: (xhr, text)=> @submittedWithError.dispatch(form, text)
+    )
 
-  submitSuccess: (form, data)->
-    @interval = setInterval( =>
-      @queryPoll(form, data.pollId)
-    , @pollFrequency)
-    @queryPoll(form, data.pollId)
+  poll: (form, processId)=>  
+    reqwest(
+      url: @pollUrl
+      type: "POST"
+      data: "processId=#{processId}"
+      success: (data)=> pollSuccess.call @, form, processId, data
+      error: (xhr, text)=> @submittedWithError.dispatch(form, text)
+    )
 
-  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)
+  # private
 
-  pollSuccess: (form, pollId, data)=>
-    @executing = false
-    if data.pollCompleted
-      clearInterval(@interval)
-      @submittedWithSuccess.dispatch(form, data.pollData)
+  pollSuccess = (form, processId, data)->
+    if data.processCompleted
+      @submittedWithSuccess.dispatch(form, data.processData)
+    else
+      setTimeout( =>
+        @poll(form, data.processId)
+      , @pollFrequency)
 
 return PollingSubmitter

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

@@ -1,30 +1,20 @@
-require "lib/jquery"
+require 'lib/reqwest'
 
-Signal = require "cronus/signal"
+BaseSubmitter = require 'hoarder/submitter/submitters/base_submitter'
 
-#
-# @author - Tim Shelburne <tim@musiconelive.com>
-#
-# handles submitting a form and waiting for a response
-#
-class SimpleSubmitter
-  constructor: ->
-    @submittedWithSuccess = new Signal()
-    @submittedWithError = new Signal()
+class SimpleSubmitter extends BaseSubmitter
 
-  canSubmit: (form)-> form.type is "simple"
+  constructor: ->
+    super()
+    @type = 'simple'
 
-  submitForm: (form)->
-    $.ajax
+  submit: (form)->
+    reqwest(
       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)
+      success: (data)=> @submittedWithSuccess.dispatch(form, data)
+      error: (xhr, text)=> @submittedWithError.dispatch(form, text)
+    )
 
 return SimpleSubmitter

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

@@ -1,18 +1,12 @@
-ValidationError = require "hoarder/validator/error/validation_error"
+BaseConstraint = require 'hoarder/validator/constraints/base_constraint'
 
-#
-# @author - Tim Shelburne <tim@musiconelive.com>
-#
-# 
-#
-class AlphaConstraint
-  canHandle: (type)->
-    type is "alpha"
+class AlphaConstraint extends BaseConstraint
 
-  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)." ]
+  constructor: ->
+    @type = "alpha"
+
+  rulePasses: (element)-> element.value.match(/^[A-Za-z\s]*$/)
+
+  errorMessage: -> "This field only accepts numbers and characters (0-9, A-Z, a-z)."
 
 return AlphaConstraint