Pattern = require './Pattern' # A bunch of utility methods # class Utils @REGEX_LEFT_TRIM_BY_CHAR: {} @REGEX_RIGHT_TRIM_BY_CHAR: {} @REGEX_SPACES: /\s+/g @REGEX_DIGITS: /^\d+$/ @REGEX_OCTAL: /[^0-7]/gi @REGEX_HEXADECIMAL: /[^a-f0-9]/gi # Precompiled date pattern @PATTERN_DATE: new Pattern '^'+ '(?[0-9][0-9][0-9][0-9])'+ '-(?[0-9][0-9]?)'+ '-(?[0-9][0-9]?)'+ '(?:(?:[Tt]|[ \t]+)'+ '(?[0-9][0-9]?)'+ ':(?[0-9][0-9])'+ ':(?[0-9][0-9])'+ '(?:\.(?[0-9]*))?'+ '(?:[ \t]*(?Z|(?[-+])(?[0-9][0-9]?)'+ '(?::(?[0-9][0-9]))?))?)?'+ '$', 'i' # Local timezone offset in ms @LOCAL_TIMEZONE_OFFSET: new Date().getTimezoneOffset() * 60 * 1000 # Trims the given string on both sides # # @param [String] str The string to trim # @param [String] _char The character to use for trimming (default: '\\s') # # @return [String] A trimmed string # @trim: (str, _char = '\\s') -> regexLeft = @REGEX_LEFT_TRIM_BY_CHAR[_char] unless regexLeft? @REGEX_LEFT_TRIM_BY_CHAR[_char] = regexLeft = new RegExp '^'+_char+''+_char+'*' regexLeft.lastIndex = 0 regexRight = @REGEX_RIGHT_TRIM_BY_CHAR[_char] unless regexRight? @REGEX_RIGHT_TRIM_BY_CHAR[_char] = regexRight = new RegExp _char+''+_char+'*$' regexRight.lastIndex = 0 return str.replace(regexLeft, '').replace(regexRight, '') # Trims the given string on the left side # # @param [String] str The string to trim # @param [String] _char The character to use for trimming (default: '\\s') # # @return [String] A trimmed string # @ltrim: (str, _char = '\\s') -> regexLeft = @REGEX_LEFT_TRIM_BY_CHAR[_char] unless regexLeft? @REGEX_LEFT_TRIM_BY_CHAR[_char] = regexLeft = new RegExp '^'+_char+''+_char+'*' regexLeft.lastIndex = 0 return str.replace(regexLeft, '') # Trims the given string on the right side # # @param [String] str The string to trim # @param [String] _char The character to use for trimming (default: '\\s') # # @return [String] A trimmed string # @rtrim: (str, _char = '\\s') -> regexRight = @REGEX_RIGHT_TRIM_BY_CHAR[_char] unless regexRight? @REGEX_RIGHT_TRIM_BY_CHAR[_char] = regexRight = new RegExp _char+''+_char+'*$' regexRight.lastIndex = 0 return str.replace(regexRight, '') # Checks if the given value is empty (null, undefined, empty string, string '0', empty Array, empty Object) # # @param [Object] value The value to check # # @return [Boolean] true if the value is empty # @isEmpty: (value) -> return not(value) or value is '' or value is '0' or (value instanceof Array and value.length is 0) or @isEmptyObject(value) # Checks if the given value is an empty object # # @param [Object] value The value to check # # @return [Boolean] true if the value is empty and is an object # @isEmptyObject: (value) -> return value instanceof Object and (k for own k of value).length is 0 # Counts the number of occurences of subString inside string # # @param [String] string The string where to count occurences # @param [String] subString The subString to count # @param [Integer] start The start index # @param [Integer] length The string length until where to count # # @return [Integer] The number of occurences # @subStrCount: (string, subString, start, length) -> c = 0 string = '' + string subString = '' + subString if start? string = string[start..] if length? string = string[0...length] len = string.length sublen = subString.length for i in [0...len] if subString is string[i...sublen] c++ i += sublen - 1 return c # Returns true if input is only composed of digits # # @param [Object] input The value to test # # @return [Boolean] true if input is only composed of digits # @isDigits: (input) -> @REGEX_DIGITS.lastIndex = 0 return @REGEX_DIGITS.test input # Decode octal value # # @param [String] input The value to decode # # @return [Integer] The decoded value # @octDec: (input) -> @REGEX_OCTAL.lastIndex = 0 return parseInt((input+'').replace(@REGEX_OCTAL, ''), 8) # Decode hexadecimal value # # @param [String] input The value to decode # # @return [Integer] The decoded value # @hexDec: (input) -> @REGEX_HEXADECIMAL.lastIndex = 0 input = @trim(input) if (input+'')[0...2] is '0x' then input = (input+'')[2..] return parseInt((input+'').replace(@REGEX_HEXADECIMAL, ''), 16) # Get the UTF-8 character for the given code point. # # @param [Integer] c The unicode code point # # @return [String] The corresponding UTF-8 character # @utf8chr: (c) -> ch = String.fromCharCode if 0x80 > (c %= 0x200000) return ch(c) if 0x800 > c return ch(0xC0 | c>>6) + ch(0x80 | c & 0x3F) if 0x10000 > c return ch(0xE0 | c>>12) + ch(0x80 | c>>6 & 0x3F) + ch(0x80 | c & 0x3F) return ch(0xF0 | c>>18) + ch(0x80 | c>>12 & 0x3F) + ch(0x80 | c>>6 & 0x3F) + ch(0x80 | c & 0x3F) # Returns the boolean value equivalent to the given input # # @param [String|Object] input The input value # @param [Boolean] strict If set to false, accept 'yes' and 'no' as boolean values # # @return [Boolean] the boolean value # @parseBoolean: (input, strict = true) -> if typeof(input) is 'string' lowerInput = input.toLowerCase() if not strict if lowerInput is 'no' then return false if lowerInput is '0' then return false if lowerInput is 'false' then return false if lowerInput is '' then return false return true return !!input # Returns true if input is numeric # # @param [Object] input The value to test # # @return [Boolean] true if input is numeric # @isNumeric: (input) -> @REGEX_SPACES.lastIndex = 0 return typeof(input) is 'number' or typeof(input) is 'string' and !isNaN(input) and input.replace(@REGEX_SPACES, '') isnt '' # Returns a parsed date from the given string # # @param [String] str The date string to parse # # @return [Date] The parsed date or null if parsing failed # @stringToDate: (str) -> unless str?.length return null # Perform regular expression pattern info = @PATTERN_DATE.exec str unless info return null # Extract year, month, day year = parseInt info.year, 10 month = parseInt(info.month, 10) - 1 # In javascript, january is 0, february 1, etc... day = parseInt info.day, 10 # If no hour is given, return a date with day precision unless info.hour? date = new Date Date.UTC(year, month, day) return date # Extract hour, minute, second hour = parseInt info.hour, 10 minute = parseInt info.minute, 10 second = parseInt info.second, 10 # Extract fraction, if given if info.fraction? fraction = info.fraction[0...3] while fraction.length < 3 fraction += '0' fraction = parseInt fraction, 10 else fraction = 0 # Compute timezone offset if given if info.tz? tz_hour = parseInt info.tz_hour, 10 if info.tz_minute? tz_minute = parseInt info.tz_minute, 10 else tz_minute = 0 # Compute timezone delta in ms tz_offset = (tz_hour * 60 + tz_minute) * 60000 if '-' is info.tz_sign tz_offset *= -1 # Compute date date = new Date Date.UTC(year, month, day, hour, minute, second, fraction) if tz_offset date.setTime date.getTime() - tz_offset return date # Repeats the given string a number of times # # @param [String] str The string to repeat # @param [Integer] number The number of times to repeat the string # # @return [String] The repeated string # @strRepeat: (str, number) -> res = '' i = 0 while i < number res += str i++ return res # Reads the data from the given file path and returns the result as string # # @param [String] path The path to the file # @param [Function] callback A callback to read file asynchronously (optional) # # @return [String] The resulting data as string # @getStringFromFile: (path, callback = null) -> xhr = null if window? if window.XMLHttpRequest xhr = new XMLHttpRequest() else if window.ActiveXObject for name in ["Msxml2.XMLHTTP.6.0", "Msxml2.XMLHTTP.3.0", "Msxml2.XMLHTTP", "Microsoft.XMLHTTP"] try xhr = new ActiveXObject(name) if xhr? # Browser if callback? # Async xhr.onreadystatechange = -> if xhr.readyState is 4 if xhr.status is 200 or xhr.status is 0 callback(xhr.responseText) else callback(null) xhr.open 'GET', path, true xhr.send null else # Sync xhr.open 'GET', path, false xhr.send null if xhr.status is 200 or xhr.status == 0 return xhr.responseText return null else # Node.js-like req = require fs = req('fs') # Prevent browserify from trying to load 'fs' module if callback? # Async fs.readFile path, (err, data) -> if err callback null else callback String(data) else # Sync data = fs.readFileSync path if data? return String(data) return null module.exports = Utils