Converting build to use grunt

Author: jgolla

.gitignore

@@ -1,3 +1 @@
-test/localize_test.js
-test/qunit_setup.js
-
+/node_modules/

.jshintrc

@@ -0,0 +1,14 @@
+{
+  "curly": true,
+  "eqeqeq": true,
+  "immed": true,
+  "latedef": true,
+  "newcap": true,
+  "noarg": true,
+  "sub": true,
+  "undef": true,
+  "unused": true,
+  "boss": true,
+  "eqnull": true,
+  "node": true
+}

.travis.yml

@@ -0,0 +1,5 @@
+language: node_js
+node_js:
+  - "0.11"
+before_script:
+  - npm install -g grunt-cli

CONTRIBUTING.md

@@ -0,0 +1,31 @@
+# Contributing
+
+## Important notes
+Please don't edit files in the `dist` subdirectory as they are generated via Grunt. You'll find source code in the `src` subdirectory!
+
+### Code style
+Regarding code style like indentation and whitespace, **follow the conventions you see used in the source already.**
+
+### PhantomJS
+While Grunt can run the included unit tests via [PhantomJS](http://phantomjs.org/), this shouldn't be considered a substitute for the real thing. Please be sure to test the `test/*.html` unit test file(s) in _actual_ browsers.
+
+## Modifying the code
+First, ensure that you have the latest [Node.js](http://nodejs.org/) and [npm](http://npmjs.org/) installed.
+
+Test that Grunt's CLI is installed by running `grunt --version`.  If the command isn't found, run `npm install -g grunt-cli`.  For more information about installing Grunt, see the [getting started guide](http://gruntjs.com/getting-started).
+
+1. Fork and clone the repo.
+1. Run `npm install` to install all dependencies (including Grunt).
+1. Run `grunt` to grunt this project.
+
+Assuming that you don't see any red, you're ready to go. Just be sure to run `grunt` after making any changes, to ensure that nothing is broken.
+
+## Submitting pull requests
+
+1. Create a new branch, please don't work in your `master` branch directly.
+1. Add failing tests for the change you want to make. Run `grunt` to see the tests fail.
+1. Fix stuff.
+1. Run `grunt` to see if the tests pass. Repeat steps 2-4 until done.
+1. Open `test/*.html` unit test file(s) in actual browser to ensure tests pass everywhere.
+1. Update the documentation to reflect any changes.
+1. Push to your fork and submit a pull request.

Gruntfile.js

@@ -0,0 +1,64 @@
+'use strict';
+
+module.exports = function(grunt) {
+
+  // Project configuration.
+  grunt.initConfig({
+    // Metadata.
+    pkg: grunt.file.readJSON('localize.jquery.json'),
+    banner: '/*! <%= pkg.title || pkg.name %> - v<%= pkg.version %> - ' +
+      '<%= grunt.template.today("yyyy-mm-dd") %>\n' +
+      '<%= pkg.homepage ? "* " + pkg.homepage + "\\n" : "" %>' +
+      '* Copyright (c) <%= grunt.template.today("yyyy") %> <%= pkg.author.name %>;' +
+      ' Licensed <%= _.pluck(pkg.licenses, "type").join(", ") %> */\n',
+    // Task configuration.
+    clean: {
+      files: ['dist']
+    },
+    coffee: {
+      compile: {
+        files: {
+          'dist/<%= pkg.name %>.js' : 'src/*.coffee',
+          'test/localize_test.js' : 'test/localize_test.coffee',
+          'test/qunit_setup.js' : 'test/qunit_setup.coffee'
+        }
+      }
+    },
+    uglify: {
+      options: {
+        banner: '<%= banner %>'
+      },
+      dist: {
+        src: 'dist/<%= pkg.name %>.js',
+        dest: 'dist/<%= pkg.name %>.min.js'
+      },
+    },
+    qunit: {
+      all: {
+        options: {
+          urls: ['1.7.2', '1.8.3', '1.9.1', '1.10.2', '1.11.0', '2.0.3', '2.1.0'].map(function(version) {
+            return 'http://localhost:<%= connect.server.options.port %>/test/localize.html?jquery=' + version;
+          })
+        }
+      }
+    },
+    connect: {
+      server: {
+        options: {
+          port: 8085 // This is a random port, feel free to change it.
+        }
+      }
+    },
+  });
+
+  // These plugins provide necessary tasks.
+  grunt.loadNpmTasks('grunt-contrib-clean');
+  grunt.loadNpmTasks('grunt-contrib-uglify');
+  grunt.loadNpmTasks('grunt-contrib-qunit');
+  grunt.loadNpmTasks('grunt-contrib-coffee');
+  grunt.loadNpmTasks('grunt-contrib-connect');
+
+  // Default task.
+  grunt.registerTask('default', ['connect', 'clean', 'coffee', 'uglify', 'qunit']);
+  grunt.registerTask('test', ['connect', 'qunit']);
+};

LICENSE-MIT

@@ -0,0 +1,22 @@
+Copyright (c) 2014 jgolla
+
+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.

README.markdown

@@ -0,0 +1,30 @@
+# Localize
+
+A jQuery plugin that makes it easy to i18n your static web site.
+
+## Getting Started
+Download the [production version][min] or the [development version][max].
+
+[min]: https://raw.github.com/jgolla/jquery-localize/master/dist/localize.min.js
+[max]: https://raw.github.com/jgolla/jquery-localize/master/dist/localize.js
+
+In your web page:
+
+```html
+<script src="jquery.js"></script>
+<script src="dist/localize.min.js"></script>
+<script>
+jQuery(function($) {
+  $.awesome(); // "awesome"
+});
+</script>
+```
+
+## Documentation
+_(Coming soon)_
+
+## Examples
+_(Coming soon)_
+
+## Release History
+_(Nothing yet)_

README.md

@@ -1,4 +1,13 @@
-// Generated by CoffeeScript 1.3.3
+
+/*
+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
+ */
+
 (function() {
   var $, normaliseLang;
 
@@ -51,7 +60,7 @@
       }
     };
     jsonCall = function(file, pkg, lang, level) {
-      var ajaxOptions, successFunc;
+      var ajaxOptions, errorFunc, successFunc;
       if (options.pathPrefix != null) {
         file = "" + options.pathPrefix + "/" + file;
       }
@@ -60,12 +69,18 @@
         notifyDelegateLanguageLoaded(intermediateLangData);
         return loadLanguage(pkg, lang, level + 1);
       };
+      errorFunc = function() {
+        if (options.fallback && options.fallback !== lang) {
+          return loadLanguage(pkg, options.fallback);
+        }
+      };
       ajaxOptions = {
         url: file,
         dataType: "json",
         async: false,
         timeout: options.timeout != null ? options.timeout : 500,
-        success: successFunc
+        success: successFunc,
+        error: errorFunc
       };
       if (window.location.protocol === "file:") {
         ajaxOptions.error = function(xhr) {