socketstream/socketstream

/*jslint bitwise: true*/

'use strict';

/**
 * @ngdoc service
 * @name utils.misc:misc
 * @function
 *
 * @description
 * Module contains misc methods
 */


/**
 * @ngdoc service
 * @name utils.misc#randomString
 * @methodOf utils.misc:misc
 * @function
 *
 * @description
 * Adapted from http://www.broofa.com/Tools/Math.uuid.js
 *
 * @param {String}  len   Length of the expected string
 * @return {String}       uuid string
 */
exports.randomString = function (len) {
  var chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split(''),
      uuid  = [],
      radix = chars.length,
      i;

  for (i = 0; i < len; i++) {
    uuid[i] = chars[0 | Math.random()*radix];
  }
  return uuid.join('');
};

/**
 * @ngdoc service
 * @name utils.misc#parseWsMessage
 * @methodOf utils.misc:misc
 * @function
 *
 * @description
 * Parse incoming websocket messages into message type and contents
 *
 * @param  {String} msg Message to parse
 * @return {Array}      Array, where [0] is message type, [1] is message's body
 */
exports.parseWsMessage = function (msg) {
  var i;
  if ((i = msg.indexOf('|')) > 0) {
    return [msg.substr(0, i), msg.substr(i+1)];
  } else {
    throw new Error('Invalid message');
  }
};

/**
 * @ngdoc service
 * @name utils.misc#extend
 * @methodOf utils.misc:misc
 * @function
 *
 * @description
 * Taken from underscore.js
 *
 * @param  {Object}     obj         Object to extend
 * @param  {<Objects>}  <objects>  to extend with
 * @return {Object}                 Extended object
 */
exports.extend = function (obj) {
  var source,
      prop,
      i;

  for (i = 1; i < arguments.length; i++) {
    source = arguments[i];
    for (prop in source) {
      if (source.hasOwnProperty(prop)) {
        obj[prop] = source[prop];
      }
    }
  }
  return obj;
};

/**
 * @ngdoc service
 * @name utils.misc#defaults
 * @methodOf utils.misc:misc
 * @function
 *
 * @description
 * Useful for declaring default parameter
 *
 * @param  {Object} args      Arguments
 * @param  {Object} defaults  Default arguments
 * @return {Object}           Extended object
 */
exports.defaults = function (args, defaults) {
  return exports.extend({}, defaults, args);
};