hem/src/utils.coffee

stitches CommonJS, and ties up other lose ends of web-app development.

path   = require('path')
fs     = require('fs-extra')
utils  = {}

# check for windows :o(...
isWin = !!require('os').platform().match(/^win/)

utils.flatten = flatten = (array, results = []) ->
  for item in array
    if Array.isArray(item)
      flatten(item, results)
    else if item
      results.push(item)
  results

utils.arrayToString = (value) ->
  if Array.isArray(value)
    result = ""
    for line in value
      result += line + "\n"
    result
  else
    value

utils.removeDuplicateValues = (array) ->
  newArray = []
  for value in array
    if value not in newArray
      newArray.push(value)
  newArray

utils.toArray = (value = []) ->
  if Array.isArray(value) then value else [value]

utils.startsWith = (str, value) ->
  str?.slice(0, value.length) is value

utils.endsWith = (str, value) ->
  str?.slice(-value.length) is value

utils.extend = extend = (a, b) ->
  for x of b
    if typeof b[x] is 'object' and not Array.isArray(b[x])
      a[x] or= {}
      extend(a[x], b[x])
    else
      a[x] = b[x]
  return a

utils.loadAsset = (asset) ->
  require("../assets/" + asset)

utils.copyFile = (from, to) ->
  # make sure target files exists
  fs.createFileSync(to)
  # constants
  BUF_LENGTH = 64 * 1024
  _buff = new Buffer(BUF_LENGTH)
  # perform copy
  fdr = fs.openSync(from, 'r')
  fdw = fs.openSync(to, 'w')
  bytesRead = 1
  pos = 0
  while bytesRead > 0
    bytesRead = fs.readSync(fdr, _buff, 0, BUF_LENGTH, pos)
    fs.writeSync(fdw, _buff, 0, bytesRead)
    pos += bytesRead
  fs.closeSync(fdr)
  fs.closeSync(fdw)

utils.isDirectory = (dir) ->
  try
    stats = fs.lstatSync(dir)
    stats.isDirectory()
  catch e
    false

# ------ Simple templating function

# Simple JavaScript Templating
# John Resig - http://ejohn.org/ - MIT Licensed
tmplCache = {};

utils.tmpl = (str, data) ->
  # Figure out if we're getting a template, or if we need to
  # load the template - and be sure to cache the result.
  if not /[\t\r\n% ]/.test(str)
    if tmplCache[str]
      fn = tmplCache[str]
    else
      # load file
      template = utils.loadAsset("#{str}.tmpl")
      fn = utils.tmpl(template)
  else
    # Convert the template into pure JavaScript
    str = str
    .split("'").join("\\'")
    .split("\n").join("\\n")
    .replace(/<%([\s\S]*?)%>/mg, (m, t) -> '<%' + t.split("\\'").join("'").split("\\n").join("\n") + '%>')
    .replace(/<%=(.+?)%>/g, "',$1,'")
    .split("<%").join("');")
    .split("%>").join("p.push('")
    # Generate a reusable function that will serve as a template
    fn = new Function("obj",
    """
    var p=[]
    var print = function(){ p.push.apply(p,arguments); };
    with(obj){
      p.push('#{str}');
    }
    return p.join('');
    """
    )
  # Provide some basic currying to the user
  return data and fn( data ) or fn;

# ------ Formatting urls and folder paths

clean = (values, sep, trimStart = false) ->
  result = ""
  for value in values when value
    result = result + sep + value
  # clean duplicate sep
  regexp = new RegExp "#{sep}+","g"
  result = result.replace(regexp, sep)
  # trim the starting path sep if there is one
  if trimStart and utils.startsWith(result, sep)
    result = result.slice(sep.length)
  # make sure doesn't end in sep
  if utils.endsWith(result, sep)
    result = result.slice(0, -sep.length)
  result

utils.cleanPath = (paths...) ->
  result = clean(paths, path.sep, true)
  # deal with windows paths :o(...
  if isWin or true
    cleanPath = new RegExp /\//g
    result = result.replace(cleanPath, path.sep)
  result

utils.cleanRoute = (routes...) ->
  clean(routes, "/")

module.exports = utils