axeing trailing whitespace

This commit is contained in:
Jeremy Ashkenas
2009-11-08 10:07:56 -05:00
parent 9d4e34e19e
commit cda4612a00

View File

@@ -1,37 +1,37 @@
// Underscore.js // Underscore.js
// (c) 2009 Jeremy Ashkenas, DocumentCloud Inc. // (c) 2009 Jeremy Ashkenas, DocumentCloud Inc.
// Underscore is freely distributable under the terms of the MIT license. // Underscore is freely distributable under the terms of the MIT license.
// Portions of Underscore are inspired by or borrowed from Prototype.js, // Portions of Underscore are inspired by or borrowed from Prototype.js,
// Oliver Steele's Functional, and John Resig's Micro-Templating. // Oliver Steele's Functional, and John Resig's Micro-Templating.
// For all details and documentation: // For all details and documentation:
// http://documentcloud.github.com/underscore/ // http://documentcloud.github.com/underscore/
(function() { (function() {
/*------------------------- Baseline setup ---------------------------------*/ /*------------------------- Baseline setup ---------------------------------*/
// Establish the root object, "window" in the browser, or "global" on the server. // Establish the root object, "window" in the browser, or "global" on the server.
var root = this; var root = this;
// Save the previous value of the "_" variable. // Save the previous value of the "_" variable.
var previousUnderscore = root._; var previousUnderscore = root._;
// If Underscore is called as a function, it returns a wrapped object that // If Underscore is called as a function, it returns a wrapped object that
// can be used OO-style. This wrapper holds altered versions of all the // can be used OO-style. This wrapper holds altered versions of all the
// underscore functions. Wrapped objects may be chained. // underscore functions. Wrapped objects may be chained.
var wrapper = function(obj) { this._wrapped = obj; }; var wrapper = function(obj) { this._wrapped = obj; };
// Create a safe reference to the Underscore object for reference below. // Create a safe reference to the Underscore object for reference below.
var _ = root._ = function(obj) { return new wrapper(obj); }; var _ = root._ = function(obj) { return new wrapper(obj); };
// Export the Underscore object for CommonJS. // Export the Underscore object for CommonJS.
if (typeof exports !== 'undefined') _ = exports; if (typeof exports !== 'undefined') _ = exports;
// Current version. // Current version.
_.VERSION = '0.4.0'; _.VERSION = '0.4.0';
/*------------------------ Collection Functions: ---------------------------*/ /*------------------------ Collection Functions: ---------------------------*/
// The cornerstone, an each implementation. // The cornerstone, an each implementation.
// Handles objects implementing forEach, arrays, and raw objects. // Handles objects implementing forEach, arrays, and raw objects.
_.each = function(obj, iterator, context) { _.each = function(obj, iterator, context) {
@@ -51,7 +51,7 @@
} }
return obj; return obj;
}; };
// Return the results of applying the iterator to each element. Use JavaScript // Return the results of applying the iterator to each element. Use JavaScript
// 1.6's version of map, if possible. // 1.6's version of map, if possible.
_.map = function(obj, iterator, context) { _.map = function(obj, iterator, context) {
@@ -62,7 +62,7 @@
}); });
return results; return results;
}; };
// Reduce builds up a single result from a list of values. Also known as // Reduce builds up a single result from a list of values. Also known as
// inject, or foldl. Uses JavaScript 1.8's version of reduce, if possible. // inject, or foldl. Uses JavaScript 1.8's version of reduce, if possible.
_.reduce = function(obj, memo, iterator, context) { _.reduce = function(obj, memo, iterator, context) {
@@ -72,8 +72,8 @@
}); });
return memo; return memo;
}; };
// The right-associative version of reduce, also known as foldr. Uses // The right-associative version of reduce, also known as foldr. Uses
// JavaScript 1.8's version of reduceRight, if available. // JavaScript 1.8's version of reduceRight, if available.
_.reduceRight = function(obj, memo, iterator, context) { _.reduceRight = function(obj, memo, iterator, context) {
if (obj && obj.reduceRight) return obj.reduceRight(_.bind(iterator, context), memo); if (obj && obj.reduceRight) return obj.reduceRight(_.bind(iterator, context), memo);
@@ -83,7 +83,7 @@
}); });
return memo; return memo;
}; };
// Return the first value which passes a truth test. // Return the first value which passes a truth test.
_.detect = function(obj, iterator, context) { _.detect = function(obj, iterator, context) {
var result; var result;
@@ -95,7 +95,7 @@
}); });
return result; return result;
}; };
// Return all the elements that pass a truth test. Use JavaScript 1.6's // Return all the elements that pass a truth test. Use JavaScript 1.6's
// filter(), if it exists. // filter(), if it exists.
_.select = function(obj, iterator, context) { _.select = function(obj, iterator, context) {
@@ -106,7 +106,7 @@
}); });
return results; return results;
}; };
// Return all the elements for which a truth test fails. // Return all the elements for which a truth test fails.
_.reject = function(obj, iterator, context) { _.reject = function(obj, iterator, context) {
var results = []; var results = [];
@@ -115,7 +115,7 @@
}); });
return results; return results;
}; };
// Determine whether all of the elements match a truth test. Delegate to // Determine whether all of the elements match a truth test. Delegate to
// JavaScript 1.6's every(), if it is present. // JavaScript 1.6's every(), if it is present.
_.all = function(obj, iterator, context) { _.all = function(obj, iterator, context) {
@@ -127,7 +127,7 @@
}); });
return result; return result;
}; };
// Determine if at least one element in the object matches a truth test. Use // Determine if at least one element in the object matches a truth test. Use
// JavaScript 1.6's some(), if it exists. // JavaScript 1.6's some(), if it exists.
_.any = function(obj, iterator, context) { _.any = function(obj, iterator, context) {
@@ -139,8 +139,8 @@
}); });
return result; return result;
}; };
// Determine if a given value is included in the array or object, // Determine if a given value is included in the array or object,
// based on '==='. // based on '==='.
_.include = function(obj, target) { _.include = function(obj, target) {
if (_.isArray(obj)) return _.indexOf(obj, target) != -1; if (_.isArray(obj)) return _.indexOf(obj, target) != -1;
@@ -150,7 +150,7 @@
}); });
return found; return found;
}; };
// Invoke a method with arguments on every item in a collection. // Invoke a method with arguments on every item in a collection.
_.invoke = function(obj, method) { _.invoke = function(obj, method) {
var args = _.toArray(arguments).slice(2); var args = _.toArray(arguments).slice(2);
@@ -158,12 +158,12 @@
return (method ? value[method] : value).apply(value, args); return (method ? value[method] : value).apply(value, args);
}); });
}; };
// Convenience version of a common use case of map: fetching a property. // Convenience version of a common use case of map: fetching a property.
_.pluck = function(obj, key) { _.pluck = function(obj, key) {
return _.map(obj, function(value){ return value[key]; }); return _.map(obj, function(value){ return value[key]; });
}; };
// Return the maximum item or (item-based computation). // Return the maximum item or (item-based computation).
_.max = function(obj, iterator, context) { _.max = function(obj, iterator, context) {
if (!iterator && _.isArray(obj)) return Math.max.apply(Math, obj); if (!iterator && _.isArray(obj)) return Math.max.apply(Math, obj);
@@ -174,7 +174,7 @@
}); });
return result.value; return result.value;
}; };
// Return the minimum element (or element-based computation). // Return the minimum element (or element-based computation).
_.min = function(obj, iterator, context) { _.min = function(obj, iterator, context) {
if (!iterator && _.isArray(obj)) return Math.min.apply(Math, obj); if (!iterator && _.isArray(obj)) return Math.min.apply(Math, obj);
@@ -185,7 +185,7 @@
}); });
return result.value; return result.value;
}; };
// Sort the object's values by a criteria produced by an iterator. // Sort the object's values by a criteria produced by an iterator.
_.sortBy = function(obj, iterator, context) { _.sortBy = function(obj, iterator, context) {
return _.pluck(_.map(obj, function(value, index, list) { return _.pluck(_.map(obj, function(value, index, list) {
@@ -198,7 +198,7 @@
return a < b ? -1 : a > b ? 1 : 0; return a < b ? -1 : a > b ? 1 : 0;
}), 'value'); }), 'value');
}; };
// Use a comparator function to figure out at what index an object should // Use a comparator function to figure out at what index an object should
// be inserted so as to maintain order. Uses binary search. // be inserted so as to maintain order. Uses binary search.
_.sortedIndex = function(array, obj, iterator) { _.sortedIndex = function(array, obj, iterator) {
@@ -210,36 +210,36 @@
} }
return low; return low;
}; };
// Convert anything iterable into a real, live array. // Convert anything iterable into a real, live array.
_.toArray = function(iterable) { _.toArray = function(iterable) {
if (!iterable) return []; if (!iterable) return [];
if (_.isArray(iterable)) return iterable; if (_.isArray(iterable)) return iterable;
return _.map(iterable, function(val){ return val; }); return _.map(iterable, function(val){ return val; });
}; };
// Return the number of elements in an object. // Return the number of elements in an object.
_.size = function(obj) { _.size = function(obj) {
return _.toArray(obj).length; return _.toArray(obj).length;
}; };
/*-------------------------- Array Functions: ------------------------------*/ /*-------------------------- Array Functions: ------------------------------*/
// Get the first element of an array. // Get the first element of an array.
_.first = function(array) { _.first = function(array) {
return array[0]; return array[0];
}; };
// Get the last element of an array. // Get the last element of an array.
_.last = function(array) { _.last = function(array) {
return array[array.length - 1]; return array[array.length - 1];
}; };
// Trim out all falsy values from an array. // Trim out all falsy values from an array.
_.compact = function(array) { _.compact = function(array) {
return _.select(array, function(value){ return !!value; }); return _.select(array, function(value){ return !!value; });
}; };
// Return a completely flattened version of an array. // Return a completely flattened version of an array.
_.flatten = function(array) { _.flatten = function(array) {
return _.reduce(array, [], function(memo, value) { return _.reduce(array, [], function(memo, value) {
@@ -248,13 +248,13 @@
return memo; return memo;
}); });
}; };
// Return a version of the array that does not contain the specified value(s). // Return a version of the array that does not contain the specified value(s).
_.without = function(array) { _.without = function(array) {
var values = array.slice.call(arguments, 0); var values = array.slice.call(arguments, 0);
return _.select(array, function(value){ return !_.include(values, value); }); return _.select(array, function(value){ return !_.include(values, value); });
}; };
// Produce a duplicate-free version of the array. If the array has already // Produce a duplicate-free version of the array. If the array has already
// been sorted, you have the option of using a faster algorithm. // been sorted, you have the option of using a faster algorithm.
_.uniq = function(array, isSorted) { _.uniq = function(array, isSorted) {
@@ -263,18 +263,18 @@
return memo; return memo;
}); });
}; };
// Produce an array that contains every item shared between all the // Produce an array that contains every item shared between all the
// passed-in arrays. // passed-in arrays.
_.intersect = function(array) { _.intersect = function(array) {
var rest = _.toArray(arguments).slice(1); var rest = _.toArray(arguments).slice(1);
return _.select(_.uniq(array), function(item) { return _.select(_.uniq(array), function(item) {
return _.all(rest, function(other) { return _.all(rest, function(other) {
return _.indexOf(other, item) >= 0; return _.indexOf(other, item) >= 0;
}); });
}); });
}; };
// Zip together multiple lists into a single array -- elements that share // Zip together multiple lists into a single array -- elements that share
// an index go together. // an index go together.
_.zip = function() { _.zip = function() {
@@ -284,16 +284,16 @@
for (var i=0; i<length; i++) results[i] = _.pluck(args, String(i)); for (var i=0; i<length; i++) results[i] = _.pluck(args, String(i));
return results; return results;
}; };
// If the browser doesn't supply us with indexOf (I'm looking at you, MSIE), // If the browser doesn't supply us with indexOf (I'm looking at you, MSIE),
// we need this function. Return the position of the first occurence of an // we need this function. Return the position of the first occurence of an
// item in an array, or -1 if the item is not included in the array. // item in an array, or -1 if the item is not included in the array.
_.indexOf = function(array, item) { _.indexOf = function(array, item) {
if (array.indexOf) return array.indexOf(item); if (array.indexOf) return array.indexOf(item);
for (i=0, l=array.length; i<l; i++) if (array[i] === item) return i; for (i=0, l=array.length; i<l; i++) if (array[i] === item) return i;
return -1; return -1;
}; };
// Provide JavaScript 1.6's lastIndexOf, delegating to the native function, // Provide JavaScript 1.6's lastIndexOf, delegating to the native function,
// if possible. // if possible.
_.lastIndexOf = function(array, item) { _.lastIndexOf = function(array, item) {
@@ -302,9 +302,9 @@
while (i--) if (array[i] === item) return i; while (i--) if (array[i] === item) return i;
return -1; return -1;
}; };
/* ----------------------- Function Functions: -----------------------------*/ /* ----------------------- Function Functions: -----------------------------*/
// Create a function bound to a given object (assigning 'this', and arguments, // Create a function bound to a given object (assigning 'this', and arguments,
// optionally). Binding with arguments is also known as 'curry'. // optionally). Binding with arguments is also known as 'curry'.
_.bind = function(func, context) { _.bind = function(func, context) {
@@ -315,8 +315,8 @@
return func.apply(context, a); return func.apply(context, a);
}; };
}; };
// Bind all of an object's methods to that object. Useful for ensuring that // Bind all of an object's methods to that object. Useful for ensuring that
// all callbacks defined on an object belong to it. // all callbacks defined on an object belong to it.
_.bindAll = function() { _.bindAll = function() {
var args = _.toArray(arguments); var args = _.toArray(arguments);
@@ -325,22 +325,22 @@
context[methodName] = _.bind(context[methodName], context); context[methodName] = _.bind(context[methodName], context);
}); });
}; };
// Delays a function for the given number of milliseconds, and then calls // Delays a function for the given number of milliseconds, and then calls
// it with the arguments supplied. // it with the arguments supplied.
_.delay = function(func, wait) { _.delay = function(func, wait) {
var args = _.toArray(arguments).slice(2); var args = _.toArray(arguments).slice(2);
return setTimeout(function(){ return func.apply(func, args); }, wait); return setTimeout(function(){ return func.apply(func, args); }, wait);
}; };
// Defers a function, scheduling it to run after the current call stack has // Defers a function, scheduling it to run after the current call stack has
// cleared. // cleared.
_.defer = function(func) { _.defer = function(func) {
return _.delay.apply(_, [func, 1].concat(_.toArray(arguments).slice(1))); return _.delay.apply(_, [func, 1].concat(_.toArray(arguments).slice(1)));
}; };
// Returns the first function passed as an argument to the second, // Returns the first function passed as an argument to the second,
// allowing you to adjust arguments, run code before and after, and // allowing you to adjust arguments, run code before and after, and
// conditionally execute the original function. // conditionally execute the original function.
_.wrap = function(func, wrapper) { _.wrap = function(func, wrapper) {
return function() { return function() {
@@ -348,7 +348,7 @@
return wrapper.apply(wrapper, args); return wrapper.apply(wrapper, args);
}; };
}; };
// Returns a function that is the composition of a list of functions, each // Returns a function that is the composition of a list of functions, each
// consuming the return value of the function that follows. // consuming the return value of the function that follows.
_.compose = function() { _.compose = function() {
@@ -360,31 +360,31 @@
return arguments[0]; return arguments[0];
}; };
}; };
/* ------------------------- Object Functions: ---------------------------- */ /* ------------------------- Object Functions: ---------------------------- */
// Retrieve the names of an object's properties. // Retrieve the names of an object's properties.
_.keys = function(obj) { _.keys = function(obj) {
return _.map(obj, function(value, key){ return key; }); return _.map(obj, function(value, key){ return key; });
}; };
// Retrieve the values of an object's properties. // Retrieve the values of an object's properties.
_.values = function(obj) { _.values = function(obj) {
return _.map(obj, _.identity); return _.map(obj, _.identity);
}; };
// Extend a given object with all of the properties in a source object. // Extend a given object with all of the properties in a source object.
_.extend = function(destination, source) { _.extend = function(destination, source) {
for (var property in source) destination[property] = source[property]; for (var property in source) destination[property] = source[property];
return destination; return destination;
}; };
// Create a (shallow-cloned) duplicate of an object. // Create a (shallow-cloned) duplicate of an object.
_.clone = function(obj) { _.clone = function(obj) {
if (_.isArray(obj)) return obj.slice(0); if (_.isArray(obj)) return obj.slice(0);
return _.extend({}, obj); return _.extend({}, obj);
}; };
// Perform a deep comparison to check if two objects are equal. // Perform a deep comparison to check if two objects are equal.
_.isEqual = function(a, b) { _.isEqual = function(a, b) {
// Check object identity. // Check object identity.
@@ -406,46 +406,46 @@
for (var key in a) if (!_.isEqual(a[key], b[key])) return false; for (var key in a) if (!_.isEqual(a[key], b[key])) return false;
return true; return true;
}; };
// Is a given array or object empty? // Is a given array or object empty?
_.isEmpty = function(obj) { _.isEmpty = function(obj) {
return (_.isArray(obj) ? obj : _.values(obj)).length == 0; return (_.isArray(obj) ? obj : _.values(obj)).length == 0;
}; };
// Is a given value a DOM element? // Is a given value a DOM element?
_.isElement = function(obj) { _.isElement = function(obj) {
return !!(obj && obj.nodeType == 1); return !!(obj && obj.nodeType == 1);
}; };
// Is a given value a real Array? // Is a given value a real Array?
_.isArray = function(obj) { _.isArray = function(obj) {
return Object.prototype.toString.call(obj) == '[object Array]'; return Object.prototype.toString.call(obj) == '[object Array]';
}; };
// Is a given value a Function? // Is a given value a Function?
_.isFunction = function(obj) { _.isFunction = function(obj) {
return Object.prototype.toString.call(obj) == '[object Function]'; return Object.prototype.toString.call(obj) == '[object Function]';
}; };
// Is a given variable undefined? // Is a given variable undefined?
_.isUndefined = function(obj) { _.isUndefined = function(obj) {
return typeof obj == 'undefined'; return typeof obj == 'undefined';
}; };
/* -------------------------- Utility Functions: -------------------------- */ /* -------------------------- Utility Functions: -------------------------- */
// Run Underscore.js in noConflict mode, returning the '_' variable to its // Run Underscore.js in noConflict mode, returning the '_' variable to its
// previous owner. Returns a reference to the Underscore object. // previous owner. Returns a reference to the Underscore object.
_.noConflict = function() { _.noConflict = function() {
root._ = previousUnderscore; root._ = previousUnderscore;
return this; return this;
}; };
// Keep the identity function around for default iterators. // Keep the identity function around for default iterators.
_.identity = function(value) { _.identity = function(value) {
return value; return value;
}; };
// Generate a unique integer id (unique within the entire client session). // Generate a unique integer id (unique within the entire client session).
// Useful for temporary DOM ids. // Useful for temporary DOM ids.
var idCounter = 0; var idCounter = 0;
@@ -453,32 +453,32 @@
var id = idCounter++; var id = idCounter++;
return prefix ? prefix + id : id; return prefix ? prefix + id : id;
}; };
// Return a sorted list of the function names available in Underscore. // Return a sorted list of the function names available in Underscore.
_.functions = function() { _.functions = function() {
var functions = []; var functions = [];
for (var key in _) if (Object.prototype.hasOwnProperty.call(_, key)) functions.push(key); for (var key in _) if (Object.prototype.hasOwnProperty.call(_, key)) functions.push(key);
return _.without(functions, 'VERSION', 'prototype', 'noConflict').sort(); return _.without(functions, 'VERSION', 'prototype', 'noConflict').sort();
}; };
// JavaScript templating a-la ERB, pilfered from John Resig's // JavaScript templating a-la ERB, pilfered from John Resig's
// "Secrets of the JavaScript Ninja", page 83. // "Secrets of the JavaScript Ninja", page 83.
_.template = function(str, data) { _.template = function(str, data) {
var fn = new Function('obj', var fn = new Function('obj',
'var p=[],print=function(){p.push.apply(p,arguments);};' + 'var p=[],print=function(){p.push.apply(p,arguments);};' +
'with(obj){p.push(\'' + 'with(obj){p.push(\'' +
str str
.replace(/[\r\t\n]/g, " ") .replace(/[\r\t\n]/g, " ")
.split("<%").join("\t") .split("<%").join("\t")
.replace(/((^|%>)[^\t]*)'/g, "$1\r") .replace(/((^|%>)[^\t]*)'/g, "$1\r")
.replace(/\t=(.*?)%>/g, "',$1,'") .replace(/\t=(.*?)%>/g, "',$1,'")
.split("\t").join("');") .split("\t").join("');")
.split("%>").join("p.push('") .split("%>").join("p.push('")
.split("\r").join("\\'") .split("\r").join("\\'")
+ "');}return p.join('');"); + "');}return p.join('');");
return data ? fn(data) : fn; return data ? fn(data) : fn;
}; };
/*------------------------------- Aliases ----------------------------------*/ /*------------------------------- Aliases ----------------------------------*/
_.forEach = _.each; _.forEach = _.each;
@@ -488,9 +488,9 @@
_.every = _.all; _.every = _.all;
_.some = _.any; _.some = _.any;
_.methods = _.functions; _.methods = _.functions;
/*------------------------ Setup the OOP Wrapper: --------------------------*/ /*------------------------ Setup the OOP Wrapper: --------------------------*/
// Add all of the Underscore functions to the wrapper object. // Add all of the Underscore functions to the wrapper object.
_.each(_.functions(), function(name) { _.each(_.functions(), function(name) {
wrapper.prototype[name] = function() { wrapper.prototype[name] = function() {
@@ -499,13 +499,13 @@
return this._chain ? _(result).chain() : result; return this._chain ? _(result).chain() : result;
}; };
}); });
// Start chaining a wrapped Underscore object. // Start chaining a wrapped Underscore object.
wrapper.prototype.chain = function() { wrapper.prototype.chain = function() {
this._chain = true; this._chain = true;
return this; return this;
}; };
// Extracts the result from a wrapped and chained object. // Extracts the result from a wrapped and chained object.
wrapper.prototype.get = function() { wrapper.prototype.get = function() {
return this._wrapped; return this._wrapped;