Ported to CoffeeScript

* src/jquery.localize.coffee is where the plugin src lives.
* build/jquery.localize.js is generated from the coffee, checked in for convenience.
* the included builder script runs coffee in watcher-mode and directs output to
  the build/ directory.
* tests updated to point at build/jquery.localize.js

Author: coderifous

README.markdown

@@ -6,20 +6,25 @@ Synopsis
 
 * Lazily loads JSON translation files based on a simple naming convention.
 * By default, applies the translations to your document based on simple attribute convention.
-* Recently updated for jQuery 1.5
+* Recently updated for jQuery 1.5 (tests use jQuery 1.5.2)
 
 Basic Usage
 -----------
 
+Step 0. Load the jquery-localize plugin on your page.
+-----------------------------------------------------
+
+It's the file located at `build/jquery.localize.js`
+
 Step 1. Use the "rel" attribute on tags whose content you want to be translated
---------------------------------------------------------------------------
+-------------------------------------------------------------------------------
 
 Somewhere in your html:
 
     <h1 rel="localize[greeting]"> Hello! </h1>
 
 Step 2. Provide a JSON language file that has translations:
-----------------------------------------------------------
+-----------------------------------------------------------
 
 example-fr.json:
 

build/README

@@ -0,0 +1,7 @@
+Files in this directory are generated.
+
+Do not edit any files in this directory.
+
+These files are only checked in to git for the convenience of people that want
+to use the javascript library without having to download the repository and
+build it on their machine.

build/jquery.localize.js

@@ -0,0 +1 @@
+coffee -wco build src/jquery.localize.coffee

builder

@@ -0,0 +1,99 @@
+# Copyright (c) Jim Garvin (http://github.com/coderifous), 2008.
+# Dual licensed under the GPL (http://dev.jquery.com/browser/trunk/jquery/GPL-LICENSE.txt) and MIT (http://dev.jquery.com/browser/trunk/jquery/MIT-LICENSE.txt) licenses.
+# Written by Jim Garvin (@coderifous) for use on LMGTFY.com.
+# http://github.com/coderifous/jquery-localize
+# Based off of Keith Wood's Localisation jQuery plugin.
+# http://keith-wood.name/localisation.html
+
+$ = jQuery
+
+# Ensures language code is in the format aa-AA.
+normaliseLang = (lang) ->
+  lang = lang.replace(/_/, '-').toLowerCase()
+  if lang.length > 3
+    lang = lang.substring(0, 3) + lang.substring(3).toUpperCase()
+  lang
+
+# Mozilla uses .language, IE uses .userLanguage
+$.defaultLanguage = normaliseLang(navigator.language || navigator.userLanguage)
+
+$.localize = (pkg, options = {}) ->
+  wrappedSet = this
+  intermediateLangData = {}
+
+  loadLanguage = (pkg, lang, level = 1) ->
+    switch level
+      when 1
+        intermediateLangData = {}
+        if options.loadBase
+          file = pkg + '.json'
+          jsonCall(file, pkg, lang, level)
+        else
+          loadLanguage(pkg, lang, 2)
+      when 2
+        if lang.length >= 2
+          file = "#{pkg}-#{lang.substring(0, 2)}.json"
+          jsonCall(file, pkg, lang, level)
+      when 3
+        if lang.length >= 5
+          file = "#{pkg}-#{lang.substring(0, 5)}.json"
+          jsonCall(file, pkg, lang, level)
+
+  jsonCall = (file, pkg, lang, level) ->
+    file = "#{options.pathPrefix}/#{file}" if options.pathPrefix?
+    successFunc = (d) ->
+      $.extend(intermediateLangData, d)
+      notifyDelegateLanguageLoaded(intermediateLangData)
+      loadLanguage(pkg, lang, level + 1)
+    ajaxOptions =
+      url: file
+      dataType: "json"
+      async: false
+      timeout: if options.timeout? then options.timeout else 500
+      success: successFunc
+    # hack to work with serving from local file system.
+    # local file:// urls won't work in chrome:
+    # http://code.google.com/p/chromium/issues/detail?id=40787
+    if window.location.protocol == "file:"
+      ajaxOptions.error = (xhr) -> successFunc($.parseJSON(xhr.responseText))
+    $.ajax(ajaxOptions)
+
+  defaultCallback = (data) ->
+    $.localize.data[pkg] = data
+    wrappedSet.each ->
+      elem = $(this)
+      key = elem.attr("rel").match(/localize\[(.*?)\]/)[1]
+      value = valueForKey(key, data)
+      if elem.is('input')
+        elem.val(value)
+      else if elem.is('optgroup')
+        elem.attr("label", value)
+      else
+        elem.html(value)
+
+  notifyDelegateLanguageLoaded = (data) ->
+    if options.callback?
+      options.callback(data, defaultCallback)
+    else
+      defaultCallback(data)
+
+  valueForKey = (key, data) ->
+    keys  = key.split(/\./)
+    value = data
+    for key in keys
+      value = if value? then value[key] else null
+    value
+
+  regexify = (string_or_regex_or_array) ->
+    if typeof(string_or_regex_or_array) == "string"
+      "^" + string_or_regex_or_array + "$"
+    else if string_or_regex_or_array.length?
+      (regexify(thing) for thing in string_or_regex_or_array).join("|")
+    else
+      string_or_regex_or_array
+
+  lang = normaliseLang(if options.language then options.language else $.defaultLanguage)
+  loadLanguage(pkg, lang, 1) unless (options.skipLanguage && lang.match(regexify(options.skipLanguage)))
+
+$.fn.localize = $.localize
+$.localize.data = {}