ultimate-helpers 0.1.0.0

data/app/assets/javascripts/ultimate/helpers/tag.js.coffee

@@ -0,0 +1,91 @@
+#= require ./base
+
+@Ultimate.Helpers.Tag =
+
+  BOOLEAN_ATTRIBUTES: "disabled readonly multiple checked autobuffer
+                       autoplay controls loop selected hidden scoped async
+                       defer reversed ismap seemless muted required
+                       autofocus novalidate formnovalidate open pubdate itemscope".split(/\s+/)
+
+  PRE_CONTENT_STRINGS:
+    textarea: "\n"
+
+  tag: (tag_name, options = {}, open = false, escape = true) ->
+    "<#{tag_name}#{@tag_options(options, escape)}#{if open then '>' else ' />'}"
+
+  content_tag: (name, content_or_options_with_block = null, options = null, escape = true, block = null) ->
+    if block = _.outcasts.blockGiven(arguments)
+      options = content_or_options_with_block
+      @content_tag_string(name, block(), options, escape)
+    else
+      @content_tag_string(name, content_or_options_with_block, options, escape)
+
+  cdata_section: (content) ->
+    splitted = content.replace(/\]\]>/g, ']]]]><![CDATA[>')
+    "<![CDATA[#{splitted}]]>"
+
+  content_tag_string: (name, content = '', options = {}, escape = true, _escapeContent = escape) ->
+    content = _.string.escapeHTML(content)  if _escapeContent
+    "<#{name}#{@tag_options(options, escape)}>#{@PRE_CONTENT_STRINGS[name] ? ''}#{content}</#{name}>"
+
+  html_options_to_s: (html_options, escape = false, prefix = "") ->
+    deprecate 'html_options_to_s()', "tag_options()"
+    @tag_options arguments...
+
+  tag_options: (options, escape = true) ->
+    return ""  if _.isEmpty(options)
+    attrs = []
+    for key, value of options
+      if key is "data" and _.isObject(value)
+        for k, v of value
+          attrs.push @data_tag_option(k, v, escape)
+      else if _.include(@BOOLEAN_ATTRIBUTES, key)
+        attrs.push @boolean_tag_option(key)  if value
+      else if value?
+        attrs.push @tag_option(key, value, escape)
+    if _.isEmpty(attrs) then "" else " #{attrs.sort().join(' ')}"
+
+  data_tag_option: (key, value, escape) ->
+    key = "data-#{_.string.dasherize(key)}"
+    value = JSON.stringify(value)  if JSON? and _.isObject(value)
+    @tag_option(key, value, escape)
+
+  boolean_tag_option: (key) ->
+    "#{key}=\"#{key}\""
+
+  tag_option: (key, value, escape) ->
+    value = value.join(" ")  if _.isArray(value)
+    value = _.string.escapeHTML(value)  if escape
+    "#{key}=\"#{value}\""
+
+  concat_class: ->
+    flatten_classes = _.filter( _.flatten(arguments), (e) -> _.isString(e) ).join(' ')
+    _.uniq( _.string.words(flatten_classes) ).join(' ')
+
+
+
+  selfClosedTags: _.string.words('area base br col command embed hr img input keygen link meta param source track wbr')
+
+  # Generate html from zen-selector. Ninja tool.
+  # TODO more zen features: +, *x, {content}
+  # TODO cache
+  selectorToHtml: (selector) ->
+    if matches = selector.match(/^[\s>]*([\w\-\.#]+)(.*)$/)
+      selector = matches[1]
+      continuation = matches[2]   # in v1 {(if continuation then ">" + content else " />")}
+      tag_name = selector.match(/^\w+/)?[0] or 'div'
+      id = selector.match(/#([\w\-]+)/)?[1]
+      classes = _.map( selector.match(/\.[\w\-]+/g), (c) -> _.string.ltrim(c, '.') )
+      html_options = {}
+      html_options['id'] = id  if id
+      html_options['class'] = classes.join(' ')  if classes.length
+      if _.contains(@selfClosedTags, tag_name)
+        @tag(tag_name, html_options)
+      else
+        continuation = @selectorToHtml(continuation)  if continuation
+        @content_tag(tag_name, continuation, html_options)
+#    else if matches = selector.match(/^\s*\+\s*(.*)$/)       # /^\s*\+\s*([\w\.#]+)(.*)$/)
+#      continuation = matches[1]
+#      if continuation then @selectorToHtml(continuation) else continuation
+    else
+      ''

data/app/assets/javascripts/ultimate/helpers/url.js.coffee

@@ -0,0 +1,152 @@
+#= require ./base
+#= require ./tag
+#= require ./javascript
+
+__char_encode = (char) -> "%#{char.charCodeAt(0).toString(16)}"
+__escape_path = (str) -> str.replace(/[^*\-.0-9A-Z_a-z]/g, __char_encode).replace(/\+/g, '%20')
+__string_encode = (str) -> _.map(str, (char) -> "&##{char.charCodeAt(0)};" ).join('')
+
+@Ultimate.Helpers.Url =
+
+  url_for: (options = null) ->
+    if _.isString(options)
+      if options is 'back'
+        'javascript:history.back();'
+      else
+        options
+    else unless _.isEmpty(options)
+      url = _.result(options, 'url') ? ''
+      if $.isPlainObject(options)
+        options = _.clone(options)
+        delete options['url']
+        anchor = _.outcasts.delete(options, 'anchor')
+        url += "?#{_.map(options, (value, key) -> "#{key}=#{value}").sort().join('&')}"  unless _.isEmpty(options)
+        url += "##{anchor}"  if anchor
+      url
+    else
+      'javascript:;'
+
+  link_to: (name = null, options = null, html_options = null, block = null) ->
+    [html_options, options] = [options, name]  if block = _.outcasts.blockGiven(arguments)
+    options ||= {}
+    url = @url_for(options)
+    html_options = @_convert_options_to_data_attributes(options, html_options)
+    html_options['href'] ||= url
+    if block
+      Ultimate.Helpers.Tag.content_tag('a', html_options, null, false, block)
+    else
+      Ultimate.Helpers.Tag.content_tag('a', name ? url, html_options, false)
+
+  link_to_js: (name = null, html_options = null, block = null) ->
+    [options, name] = [name, null]  if block = _.outcasts.blockGiven(arguments)
+    @link_to [name, options, html_options, block]...
+
+  # TODO tests
+  link_to_unless_current_span: (name, options = null, html_options = null, block = null) ->
+    [html_options, options] = [options, name]  if block = _.outcasts.blockGiven(arguments)
+    url = @url_for(options)
+    if @current_page_(url)
+      if block
+        Ultimate.Helpers.Tag.content_tag('span', html_options, null, false, block)
+      else
+        Ultimate.Helpers.Tag.content_tag('span', name ? url, html_options, false)
+    else
+      if block
+        @link_to options, html_options, block
+      else
+        @link_to name, options, html_options
+
+  # TODO tests
+  link_to_unless_current: (name, options = {}, html_options = {}, block = null) ->
+    @link_to_unless @current_page_(options), name, options, html_options, block
+
+  # TODO tests
+  link_to_unless: (condition, name, options = {}, html_options = {}, block = null) ->
+    if condition
+      if block = _.outcasts.blockGiven(arguments)
+        block(name, options, html_options)
+      else
+        name
+    else
+      @link_to name, options, html_options, block
+
+  # TODO tests
+  link_to_if: (condition, name, options = {}, html_options = {}, block = null) ->
+    @link_to_unless not condition, name, options, html_options, block
+
+  mail_to: (email_address, name = null, html_options = {}) ->
+    email_address = _.string.escapeHTML(email_address)
+    encode = _.outcasts.delete(html_options, 'encode')
+    extras = _.compact _.map _.string.words('cc bcc body subject'), (item) ->
+      option = _.outcasts.delete(html_options, item)
+      if option?
+        "#{item}=#{__escape_path(option)}"
+    extras = if _.isEmpty(extras) then '' else '?' + _.string.escapeHTML(extras.join('&'))
+    email_address_obfuscated = email_address
+    email_address_obfuscated = email_address_obfuscated.replace('@', _.outcasts.delete(html_options, 'replace_at'))   if 'replace_at' of html_options
+    email_address_obfuscated = email_address_obfuscated.replace('.', _.outcasts.delete(html_options, 'replace_dot'))  if 'replace_dot' of html_options
+    switch encode
+      when 'javascript'
+        html   = @link_to(name or email_address_obfuscated, "mailto:#{email_address}#{extras}", html_options)
+        html   = Ultimate.Helpers.Javascript.escape_javascript(html)
+        string = _.map("document.write('#{html}');", __char_encode).join('')
+        "<script>eval(decodeURIComponent('#{string}'))</script>"
+      when 'hex'
+        email_address_encoded = __string_encode(email_address_obfuscated)
+        string = __string_encode('mailto:') + _.map(email_address, (char) -> if /\w/.test(char) then __char_encode(char) else char).join('')
+        @link_to name or email_address_encoded, "#{string}#{extras}", html_options
+      else
+        @link_to name or email_address_obfuscated, "mailto:#{email_address}#{extras}", html_options
+
+  # TODO tests
+  current_page_: (options) ->
+    url_string = @url_for(options)
+    request_uri = location.pathname
+    if /^\w+:\/\//.test(url_string)
+      url_string == "#{location.protocol}#{location.host}#{request_uri}"
+    else
+      url_string == request_uri
+
+
+
+  _convert_options_to_data_attributes: (options, html_options) ->
+    if html_options
+      html_options['data-remote'] = 'true'  if @_link_to_remote_options(options) or @_link_to_remote_options(html_options)
+      method = _.outcasts.delete(html_options, 'method')
+      @_add_method_to_attributes(html_options, method)  if method
+      html_options
+    else
+      if @_link_to_remote_options(options) then {'data-remote': 'true'} else {}
+
+  _link_to_remote_options: (options) ->
+    _.isObject(options) and _.outcasts.delete(options, 'remote')
+
+  _add_method_to_attributes: (html_options, method) ->
+    if _.isString(method) and method.toLowerCase() isnt 'get' and not /nofollow/.test(html_options['rel'])
+      html_options['rel'] = Ultimate.Helpers.Tag.concat_class(html_options['rel'], 'nofollow')
+    html_options['data-method'] = method
+
+  _convert_boolean_attributes: (html_options, bool_attrs) ->
+    html_options[x] = x  for x in bool_attrs  when _.outcasts.delete(html_options, x)
+    html_options
+
+  __protect_against_forgery: false
+  __request_forgery_protection_token: 'form_token'
+  __form_authenticity_token: 'secret'
+
+  __init_request_forgery_protection: ->
+    param = $('head meta[name="csrf-param"]').attr('content')
+    token = $('head meta[name="csrf-token"]').attr('content')
+    if param and token
+      @__protect_against_forgery = true
+      @__request_forgery_protection_token = param
+      @__form_authenticity_token = token
+
+  _token_tag: (token = @__form_authenticity_token) ->
+    if token isnt false and @__protect_against_forgery
+      Ultimate.Helpers.Tag.tag 'input', type: 'hidden', name: @__request_forgery_protection_token, value: token
+    else
+      ''
+
+  _method_tag: (method) ->
+    Ultimate.Helpers.Tag.tag 'input', type: 'hidden', name: '_method', value: method

data/app/assets/javascripts/ultimate/helpers.js.coffee

@@ -0,0 +1,122 @@
+###
+ *  front-end js helpers
+ *    0.3.3.alpha / 2010-2011
+ *    Karpunin Dmitry / Evrone.com
+ *    koderfunk_at_gmail_dot_com
+###
+
+@DEBUG_MODE ?= false
+@TEST_MODE ?= false
+@LOG_TODO ?= true
+
+@cout = =>
+  args = _.toArray(arguments)
+  method = if args[0] in ['log', 'info', 'warn', 'error', 'assert', 'clear'] then args.shift() else 'log'
+  if @DEBUG_MODE and console?
+    method = console[method]
+    if method.apply?
+      method.apply(console, args)
+    else
+      method(args)
+  return args[0]
+
+@_cout = =>
+  console.log(arguments)  if console?
+  arguments[0]
+
+@deprecate = (subject, instead = null) =>
+  @cout 'error', "`#{subject}` DEPRECATED!#{if instead then " Use instead `#{instead}`" else ''}"
+
+@todo = (subject, location = null, numberOrString = null) =>
+  if @LOG_TODO
+    @cout 'warn', "TODO: #{subject}#{if location then " ### #{location}" else ''}#{if numberOrString then (if _.isNumber(numberOrString) then ":#{numberOrString}" else " > #{numberOrString}") else ''}"
+
+@args = (a) ->
+  @deprecate 'arg()', '_.toArray()'
+  r = []
+  Array::push.apply(r, a)  if a.length > 0
+  r
+
+@logicalXOR = (a, b) ->
+  ( a and not b ) or ( not a and b )
+
+@bound = (number, min, max) ->
+  Math.max(min, Math.min(max, number))
+
+
+
+@getParams = ->
+  q = location.search.substring(1).split('&')
+  r = {}
+  for e in q
+    t = e.split('=')
+    r[t[0]] = t[1]
+  r
+
+@respondFormat = (url, format = null) ->
+  aq = url.split('?')
+  ah = aq[0].split('#')
+  ad = ah[0].split('.')
+  currentFormat = if ad.length > 1 and not /\//.test(ad[ad.length - 1]) then ad.pop() else ''
+  return currentFormat  unless format?
+  return url  if format is currentFormat
+  ad.push format  if format
+  ah[0] = ad.join('.')
+  aq[0] = ah.join('#')
+  aq.join('?')
+
+
+
+###########   Deprecated   ###########
+
+# Helper function to get a value from a object as a property or as a function.
+@getValue = (object, prop) ->
+  @deprecate "getValue()", "_.result()"
+  return null  unless object and object[prop]
+  return if _.isFunction(object[prop]) then object[prop]() else object[prop]
+
+@isset = (obj) =>
+  @deprecate 'isset(obj)', '_.isUndefined(obj) OR "obj isnt undefined" OR "obj?'
+  obj isnt undefined
+
+@isString = (v) =>
+  @deprecate 'isString(v)', '_.isString(v)'
+  _.isString v
+
+@isNumber = (v) =>
+  @deprecate 'isNumber(v)', '_.isNumber(v)'
+  not isNaN(parseInt(v))
+
+@isJQ = (obj) ->
+  @deprecate 'isJQ(obj)', 'obj instanceof jQuery'
+  _.isObject(obj) and _.isString(obj.jquery)
+
+@uniq = (arrOrString) ->
+  @deprecate 'uniq(a)', '_.uniq(a)'
+  isStr = _.isString(arrOrString)
+  return arrOrString  unless isStr or _.isArray(arrOrString)
+  r = []
+  r.push(e)  for e in arrOrString  when not _.include(r, e)
+  if isStr then r.join('') else r
+
+@regexpSpace = /^\s*$/
+@regexpTrim = /^\s*(.*?)\s*$/
+
+@strTrim = (s) =>
+  @deprecate "strTrim(s)", "_.trim(s)"
+  s.match(@regexpTrim)[1]
+
+
+
+@rails_data = {}
+
+@rails_scope = (controller_name, action_name, scopedCloasure = null, scopedCloasureArguments...) =>
+  @deprecate 'rails_scope'
+  return false if _.isString(controller_name) and controller_name isnt @rails_data['controller_name']
+  return false if _.isString(action_name)     and action_name     isnt @rails_data['action_name']
+  if _.isFunction(scopedCloasure)
+    arguments[2] scopedCloasureArguments...
+  true
+
+$ =>
+  @rails_data = $('body').data()

data/app/assets/javascripts/ultimate/jquery.base.js.coffee

@@ -0,0 +1,85 @@
+# TODO: register components
+
+do ($ = jQuery) =>
+
+  $.regexp ||= {}
+
+  $.regexp.rorId ||= /(\w+)_(\d+)$/
+
+  @ror_id = (jObjOrString) ->
+    if jObjOrString instanceof jQuery
+      id = jObjOrString.data("rorId") # Maybe use "id"
+      unless id?
+        id = ror_id(jObjOrString.attr("id"))
+        jObjOrString.data("rorId", id)  if id?
+      id
+    else if _.isString(jObjOrString)
+      matchResult = jObjOrString.match($.regexp.rorId)
+      if matchResult then matchResult[2] else null
+    else
+      null
+
+  $.fn.rorId = (id = null, prefix = null) ->
+    if arguments.length
+      jThis = @first()
+      thisId = @attr("id")
+      if not prefix? and _.isString(thisId)
+        prefix = matchResult[1]  if matchResult = thisId.match($.regexp.rorId)
+      @data("rorId", id)
+      if prefix?
+        jThis.attr "id", "#{prefix}_#{id}"
+      jThis
+    else
+      ror_id @
+
+  $.fn.getClasses = ->
+    _.string.words @attr("class")
+
+  # Get hash of html-dom attributes from first matched element or false, if no elements
+  $.fn.getAttributes = ->
+    attrs = {}
+    if @length
+      attrs[attr.nodeName] = attr.nodeValue  for attr in this[0].attributes
+    attrs
+
+  # [showOrHide[, duration[, callback]]]
+  $.fn.slideToggleByState = ->
+    if @length
+      if arguments.length > 0
+        a = _.toArray(arguments)
+        if a.shift()
+          @slideDown.apply @, a
+        else
+          @slideUp.apply @, a
+      else
+        @slideToggle()
+    @
+
+  unless $.isHTML
+    $.regexp.HTML = /^\s*<(\w+)[\S\s]*<\/(\w+)>\s*$/
+    $.isHTML = (content, strong = false) ->
+      return false  unless _.isString(content)
+      matches = content.match($.regexp.HTML)
+      return false  unless matches?
+      not strong or matches[1] is matches[2]
+
+  # TODO replace usages to underscore methods and using distribution
+  unless $.isRegExp
+    $.isRegExp = (candidate) ->
+      deprecate '$.isRegExp', '_.isRegExp'
+      typeof candidate is "object" and typeof candidate.test is "function"
+
+  unless $.isBoolean
+    $.isBoolean = (v) ->
+      deprecate '$.isBoolean', '_.isBoolean'
+      typeof v is "boolean"
+
+  unless $.isString
+    $.isString = (v) ->
+      deprecate '$.isString', '_.isString'
+      typeof v is "string"
+
+  if typeof $.isEmptyString is "undefined"
+    $.isEmptyString = (v) ->
+      deprecate '$.isEmptyString', '_.isBlank'
+      regexpSpace.test v

data/app/assets/javascripts/ultimate/underscore/underscore.inflection.js

@@ -0,0 +1,176 @@
+//  Underscore.inflection.js
+//  (c) 2011 Jeremy Ruppel
+//  Underscore.inflection is freely distributable under the MIT license.
+//  Portions of Underscore.inflection are inspired or borrowed from ActiveSupport
+//  Version 1.0.0
+
+( function( _, undefined )
+{
+  var
+    plurals = [ ],
+
+    singulars = [ ],
+
+    uncountables = [ ];
+
+  /**
+   * Inflector
+   */
+  var inflector = {
+
+    gsub : function( word, rule, replacement )
+    {
+      var pattern = new RegExp( rule.source || rule, 'gi' );
+
+      return pattern.test( word ) ? word.replace( pattern, replacement ) : null;
+    },
+
+    plural : function( rule, replacement )
+    {
+      plurals.unshift( [ rule, replacement ] );
+    },
+
+    pluralize : function( word, count, includeNumber )
+    {
+      var result;
+      
+      if( count !== undefined )
+      {
+        result = ( count === 1 ) ? this.singularize( word ) : this.pluralize( word );
+        result = ( includeNumber ) ? [ count, result ].join( ' ' ) : result;
+      }
+      else
+      {
+        if( _( uncountables ).include( word ) )
+        {
+          return word;
+        }
+
+        result = word;
+
+        _( plurals ).detect( function( rule )
+        {
+          var gsub = this.gsub( word, rule[ 0 ], rule[ 1 ] );
+
+          return gsub ? ( result = gsub ) : false;
+        },
+        this );
+      }
+      
+      return result;
+    },
+
+    singular : function( rule, replacement )
+    {
+      singulars.unshift( [ rule, replacement ] );
+    },
+
+    singularize : function( word )
+    {
+      if( _( uncountables ).include( word ) )
+      {
+        return word;
+      }
+
+      var result = word;
+
+      _( singulars ).detect( function( rule )
+      {
+        var gsub = this.gsub( word, rule[ 0 ], rule[ 1 ] );
+
+        return gsub ? ( result = gsub ) : false;
+      },
+      this );
+
+      return result;
+    },
+
+    irregular : function( singular, plural )
+    {
+      this.plural( '\\b' + singular + '\\b', plural );
+      this.singular( '\\b' + plural + '\\b', singular );
+    },
+
+    uncountable : function( word )
+    {
+      uncountables.unshift( word );
+    },
+
+    resetInflections : function( )
+    {
+      plurals      = [ ];
+      singulars    = [ ];
+      uncountables = [ ];
+
+      this.plural( /$/,                         's'       );
+      this.plural( /s$/,                        's'       );
+      this.plural( /(ax|test)is$/,              '$1es'    );
+      this.plural( /(octop|vir)us$/,            '$1i'     );
+      this.plural( /(octop|vir)i$/,             '$1i'     );
+      this.plural( /(alias|status)$/,           '$1es'    );
+      this.plural( /(bu)s$/,                    '$1ses'   );
+      this.plural( /(buffal|tomat)o$/,          '$1oes'   );
+      this.plural( /([ti])um$/,                 '$1a'     );
+      this.plural( /([ti])a$/,                  '$1a'     );
+      this.plural( /sis$/,                      'ses'     );
+      this.plural( /(?:([^f])fe|([lr])f)$/,     '$1$2ves' );
+      this.plural( /(hive)$/,                   '$1s'     );
+      this.plural( /([^aeiouy]|qu)y$/,          '$1ies'   );
+      this.plural( /(x|ch|ss|sh)$/,             '$1es'    );
+      this.plural( /(matr|vert|ind)(?:ix|ex)$/, '$1ices'  );
+      this.plural( /([m|l])ouse$/,              '$1ice'   );
+      this.plural( /([m|l])ice$/,               '$1ice'   );
+      this.plural( /^(ox)$/,                    '$1en'    );
+      this.plural( /^(oxen)$/,                  '$1'      );
+      this.plural( /(quiz)$/,                   '$1zes'   );
+
+      this.singular( /s$/,                                                            ''        );
+      this.singular( /(n)ews$/,                                                       '$1ews'   );
+      this.singular( /([ti])a$/,                                                      '$1um'    );
+      this.singular( /((a)naly|(b)a|(d)iagno|(p)arenthe|(p)rogno|(s)ynop|(t)he)ses$/, '$1$2sis' );
+      this.singular( /(^analy)ses$/,                                                  '$1sis'   );
+      this.singular( /([^f])ves$/,                                                    '$1fe'    );
+      this.singular( /(hive)s$/,                                                      '$1'      );
+      this.singular( /(tive)s$/,                                                      '$1'      );
+      this.singular( /([lr])ves$/,                                                    '$1f'     );
+      this.singular( /([^aeiouy]|qu)ies$/,                                            '$1y'     );
+      this.singular( /(s)eries$/,                                                     '$1eries' );
+      this.singular( /(m)ovies$/,                                                     '$1ovie'  );
+      this.singular( /(x|ch|ss|sh)es$/,                                               '$1'      );
+      this.singular( /([m|l])ice$/,                                                   '$1ouse'  );
+      this.singular( /(bus)es$/,                                                      '$1'      );
+      this.singular( /(o)es$/,                                                        '$1'      );
+      this.singular( /(shoe)s$/,                                                      '$1'      );
+      this.singular( /(cris|ax|test)es$/,                                             '$1is'    );
+      this.singular( /(octop|vir)i$/,                                                 '$1us'    );
+      this.singular( /(alias|status)es$/,                                             '$1'      );
+      this.singular( /^(ox)en/,                                                       '$1'      );
+      this.singular( /(vert|ind)ices$/,                                               '$1ex'    );
+      this.singular( /(matr)ices$/,                                                   '$1ix'    );
+      this.singular( /(quiz)zes$/,                                                    '$1'      );
+      this.singular( /(database)s$/,                                                  '$1'      );
+
+      this.irregular( 'person', 'people'   );
+      this.irregular( 'man',    'men'      );
+      this.irregular( 'child',  'children' );
+      this.irregular( 'sex',    'sexes'    );
+      this.irregular( 'move',   'moves'    );
+      this.irregular( 'cow',    'kine'     );
+
+      _( 'equipment information rice money species series fish sheep jeans'.split( /\s+/ ) ).each( function( word )
+      {
+        this.uncountable( word );
+      },
+      this );
+
+      return this;
+    }
+
+  };
+
+  /**
+   * Underscore integration
+   */
+  _.mixin( inflector.resetInflections( ) );
+  
+} )( _ );