Add Gruntfile.js

Author: mathiasbynens

.gitattributes

@@ -1 +1 @@
-* text=auto
+* text=auto

.gitignore

@@ -1 +1,17 @@
-.DS_Store
+# Coverage reports
+coverage
+
+# Installed npm modules
+node_modules
+
+# Folder view configuration files
+.DS_Store
+Desktop.ini
+
+# Thumbnail cache files
+._*
+Thumbs.db
+
+# Files that might appear on external disks
+.Spotlight-V100
+.Trashes

Gruntfile.js

@@ -0,0 +1,76 @@
+module.exports = function(grunt) {
+
+	var commandOptions = {
+		'stdout': true,
+		'stderr': true,
+		'failOnError': true
+	};
+
+	grunt.initConfig({
+		'meta': {
+			'testFile': 'tests/tests.js'
+		},
+		'uglify': {
+			'dist': {
+				'options': {
+					'report': 'gzip',
+					'preserveComments': 'some'
+				},
+				'files': {
+					'punycode.min.js': ['punycode.js']
+				}
+			}
+		},
+		'shell': {
+			'cover': {
+				'command': 'istanbul cover --report "html" --verbose --dir "coverage" "<%= meta.testFile %>"',
+				'options': commandOptions
+			},
+			// Rhino 1.7R4 has a bug that makes it impossible to test punycode.
+			// https://bugzilla.mozilla.org/show_bug.cgi?id=775566
+			// To test, use Rhino 1.7R3, or wait (heh) for the 1.7R5 release.
+			'test-rhino': {
+				'command': 'echo "Testing in Rhino..."; rhino -opt -1 "tests.js"',
+				'options': {
+					'stdout': true,
+					'stderr': true,
+					'failOnError': true,
+					'execOptions': {
+						'cwd': 'tests'
+					}
+				}
+			},
+			'test-ringo': {
+				'command': 'echo "Testing in Ringo..."; ringo -o -1 "<%= meta.testFile %>"',
+				'options': commandOptions
+			},
+			'test-narwhal': {
+				'command': 'echo "Testing in Narwhal..."; export NARWHAL_OPTIMIZATION=-1; narwhal "<%= meta.testFile %>"',
+				'options': commandOptions
+			},
+			'test-node': {
+				'command': 'echo "Testing in Node..."; node "<%= meta.testFile %>"',
+				'options': commandOptions
+			},
+			'test-browser': {
+				'command': 'echo "Testing in a browser..."; open "tests/index.html"',
+				'options': commandOptions
+			}
+		}
+	});
+
+	grunt.loadNpmTasks('grunt-shell');
+	grunt.loadNpmTasks('grunt-contrib-uglify');
+
+	grunt.registerTask('cover', 'shell:cover');
+	grunt.registerTask('test', [
+		'shell:test-rhino',
+		'shell:test-ringo',
+		'shell:test-narwhal',
+		'shell:test-node',
+		'shell:test-browser'
+	]);
+
+	grunt.registerTask('default', ['test', 'cover']);
+
+};

README.md

@@ -57,7 +57,6 @@ require(
 Usage example:
 
 ~~~js
-
 // encode/decode domain names
 punycode.toASCII('mañana.com'); // 'xn--maana-pta.com'
 punycode.toUnicode('xn--maana-pta.com'); // 'mañana.com'
@@ -73,24 +72,15 @@ punycode.decode('--dqo34k'); // '☃-⌘'
 
 [Full API documentation is available.](https://github.com/bestiejs/punycode.js/tree/master/docs#readme)
 
-## Cloning this repo
-
-To clone this repository including all submodules, using Git 1.6.5 or later:
+Feel free to fork if you see possible improvements!
 
-~~~ bash
-git clone --recursive https://github.com/bestiejs/punycode.js.git
-cd punycode.js
-~~~
+## Unit tests & code coverage
 
-For older Git versions, just use:
+After cloning this repository, run `npm install --dev` to install the dependencies needed for Punycode.js development and testing. You may want to install Istanbul _globally_ using `npm install istanbul -g`.
 
-~~~ bash
-git clone https://github.com/bestiejs/punycode.js.git
-cd punycode.js
-git submodule update --init
-~~~
+Once that’s done, you can run the unit tests in Node using `npm test` or `node tests/tests.js`. To run the tests in Rhino, Ringo, Narwhal, and web browsers as well, use `grunt test`.
 
-Feel free to fork if you see possible improvements!
+To generate the code coverage report, use `grunt cover`.
 
 ## Authors
 
@@ -104,4 +94,4 @@ Feel free to fork if you see possible improvements!
 
 ## License
 
-Punycode.js is dual licensed under the [MIT](http://mths.be/mit) and [GPL](http://mths.be/gpl) licenses.
+Punycode.js is dual licensed under the [MIT](http://mths.be/mit) and [GPL](http://mths.be/gpl) licenses.

package.json

@@ -59,6 +59,7 @@
 	"devDependencies": {
 		"istanbul": "~0.1.33",
 		"grunt": "~0.4.1",
+		"grunt-contrib-uglify": "~0.2.0",
 		"grunt-shell": "~0.2.1",
 		"qunitjs": "~1.11.0",
 		"qunit-clib": "~1.3.0",