js-routes 1.0.1 → 1.2.9

data/lib/routes.js

@@ -1,6 +1,12 @@
+/*
+File generated by js-routes GEM_VERSION
+Based on Rails routes of APP_CLASS
+ */
+
 (function() {
-  var NodeTypes, ParameterMissing, Utils, createGlobalJsRoutesObject, defaults, root,
-    __hasProp = {}.hasOwnProperty;
+  var NodeTypes, ParameterMissing, ReservedOptions, Utils, createGlobalJsRoutesObject, defaults, root,
+    hasProp = {}.hasOwnProperty,
+    slice = [].slice;
 
   root = typeof exports !== "undefined" && exports !== null ? exports : this;
 
@@ -17,47 +23,46 @@
 
   NodeTypes = NODE_TYPES;
 
-  Utils = {
-    serialize: function(object, prefix) {
-      var element, i, key, prop, result, s, _i, _len;
+  ReservedOptions = ['anchor', 'trailing_slash', 'host', 'port', 'protocol'];
 
+  Utils = {
+    default_serializer: function(object, prefix) {
+      var element, i, j, key, len, prop, s;
       if (prefix == null) {
         prefix = null;
       }
-      if (!object) {
+      if (object == null) {
         return "";
       }
       if (!prefix && !(this.get_object_type(object) === "object")) {
         throw new Error("Url parameters should be a javascript hash");
       }
-      if (root.jQuery) {
-        result = root.jQuery.param(object);
-        return (!result ? "" : result);
-      }
       s = [];
       switch (this.get_object_type(object)) {
         case "array":
-          for (i = _i = 0, _len = object.length; _i < _len; i = ++_i) {
+          for (i = j = 0, len = object.length; j < len; i = ++j) {
             element = object[i];
-            s.push(this.serialize(element, prefix + "[]"));
+            s.push(this.default_serializer(element, prefix + "[]"));
           }
           break;
         case "object":
           for (key in object) {
-            if (!__hasProp.call(object, key)) continue;
+            if (!hasProp.call(object, key)) continue;
             prop = object[key];
-            if (!(prop != null)) {
-              continue;
+            if ((prop == null) && (prefix != null)) {
+              prop = "";
             }
-            if (prefix != null) {
-              key = "" + prefix + "[" + key + "]";
+            if (prop != null) {
+              if (prefix != null) {
+                key = prefix + "[" + key + "]";
+              }
+              s.push(this.default_serializer(prop, key));
             }
-            s.push(this.serialize(prop, key));
           }
           break;
         default:
-          if (object) {
-            s.push("" + (encodeURIComponent(prefix.toString())) + "=" + (encodeURIComponent(object.toString())));
+          if (object != null) {
+            s.push((encodeURIComponent(prefix.toString())) + "=" + (encodeURIComponent(object.toString())));
           }
       }
       if (!s.length) {
@@ -65,65 +70,35 @@
       }
       return s.join("&");
     },
+    custom_serializer: SERIALIZER,
+    serialize: function(object) {
+      if ((this.custom_serializer != null) && this.get_object_type(this.custom_serializer) === "function") {
+        return this.custom_serializer(object);
+      } else {
+        return this.default_serializer(object);
+      }
+    },
     clean_path: function(path) {
       var last_index;
-
       path = path.split("://");
       last_index = path.length - 1;
       path[last_index] = path[last_index].replace(/\/+/g, "/");
       return path.join("://");
     },
-    set_default_url_options: function(optional_parts, options) {
-      var i, part, _i, _len, _results;
-
-      _results = [];
-      for (i = _i = 0, _len = optional_parts.length; _i < _len; i = ++_i) {
-        part = optional_parts[i];
-        if (!options.hasOwnProperty(part) && defaults.default_url_options.hasOwnProperty(part)) {
-          _results.push(options[part] = defaults.default_url_options[part]);
-        }
-      }
-      return _results;
-    },
-    extract_anchor: function(options) {
-      var anchor;
-
-      anchor = "";
-      if (options.hasOwnProperty("anchor")) {
-        anchor = "#" + options.anchor;
-        delete options.anchor;
-      }
-      return anchor;
-    },
-    extract_trailing_slash: function(options) {
-      var trailing_slash;
-
-      trailing_slash = false;
-      if (defaults.default_url_options.hasOwnProperty("trailing_slash")) {
-        trailing_slash = defaults.default_url_options.trailing_slash;
-      }
-      if (options.hasOwnProperty("trailing_slash")) {
-        trailing_slash = options.trailing_slash;
-        delete options.trailing_slash;
-      }
-      return trailing_slash;
-    },
     extract_options: function(number_of_params, args) {
       var last_el;
-
       last_el = args[args.length - 1];
-      if (args.length > number_of_params || ((last_el != null) && "object" === this.get_object_type(last_el) && !this.look_like_serialized_model(last_el))) {
-        return args.pop();
+      if ((args.length > number_of_params && last_el === void 0) || ((last_el != null) && "object" === this.get_object_type(last_el) && !this.looks_like_serialized_model(last_el))) {
+        return args.pop() || {};
       } else {
         return {};
       }
     },
-    look_like_serialized_model: function(object) {
+    looks_like_serialized_model: function(object) {
       return "id" in object || "to_param" in object;
     },
     path_identifier: function(object) {
       var property;
-
       if (object === 0) {
         return "0";
       }
@@ -147,56 +122,92 @@
     },
     clone: function(obj) {
       var attr, copy, key;
-
       if ((obj == null) || "object" !== this.get_object_type(obj)) {
         return obj;
       }
       copy = obj.constructor();
       for (key in obj) {
-        if (!__hasProp.call(obj, key)) continue;
+        if (!hasProp.call(obj, key)) continue;
         attr = obj[key];
         copy[key] = attr;
       }
       return copy;
     },
-    prepare_parameters: function(required_parameters, actual_parameters, options) {
-      var i, result, val, _i, _len;
-
-      result = this.clone(options) || {};
-      for (i = _i = 0, _len = required_parameters.length; _i < _len; i = ++_i) {
-        val = required_parameters[i];
+    merge: function() {
+      var tap, xs;
+      xs = 1 <= arguments.length ? slice.call(arguments, 0) : [];
+      tap = function(o, fn) {
+        fn(o);
+        return o;
+      };
+      if ((xs != null ? xs.length : void 0) > 0) {
+        return tap({}, function(m) {
+          var j, k, len, results, v, x;
+          results = [];
+          for (j = 0, len = xs.length; j < len; j++) {
+            x = xs[j];
+            results.push((function() {
+              var results1;
+              results1 = [];
+              for (k in x) {
+                v = x[k];
+                results1.push(m[k] = v);
+              }
+              return results1;
+            })());
+          }
+          return results;
+        });
+      }
+    },
+    normalize_options: function(default_parts, required_parameters, optional_parts, actual_parameters) {
+      var i, j, key, len, options, result, url_parameters, value;
+      options = this.extract_options(required_parameters.length, actual_parameters);
+      if (actual_parameters.length > required_parameters.length) {
+        throw new Error("Too many parameters provided for path");
+      }
+      options = this.merge(defaults.default_url_options, default_parts, options);
+      result = {};
+      url_parameters = {};
+      result['url_parameters'] = url_parameters;
+      for (key in options) {
+        if (!hasProp.call(options, key)) continue;
+        value = options[key];
+        if (this.indexOf(ReservedOptions, key) >= 0) {
+          result[key] = value;
+        } else {
+          url_parameters[key] = value;
+        }
+      }
+      for (i = j = 0, len = required_parameters.length; j < len; i = ++j) {
+        value = required_parameters[i];
         if (i < actual_parameters.length) {
-          result[val] = actual_parameters[i];
+          url_parameters[value] = actual_parameters[i];
         }
       }
       return result;
     },
-    build_path: function(required_parameters, optional_parts, route, args) {
-      var anchor, opts, parameters, result, trailing_slash, url, url_params;
-
+    build_route: function(required_parameters, optional_parts, route, default_parts, full_url, args) {
+      var options, parameters, result, url, url_params;
       args = Array.prototype.slice.call(args);
-      opts = this.extract_options(required_parameters.length, args);
-      if (args.length > required_parameters.length) {
-        throw new Error("Too many parameters provided for path");
-      }
-      parameters = this.prepare_parameters(required_parameters, args, opts);
-      this.set_default_url_options(optional_parts, parameters);
-      anchor = this.extract_anchor(parameters);
-      trailing_slash = this.extract_trailing_slash(parameters);
+      options = this.normalize_options(default_parts, required_parameters, optional_parts, args);
+      parameters = options['url_parameters'];
       result = "" + (this.get_prefix()) + (this.visit(route, parameters));
-      url = Utils.clean_path("" + result);
-      if (trailing_slash === true) {
+      url = Utils.clean_path(result);
+      if (options['trailing_slash'] === true) {
         url = url.replace(/(.*?)[\/]?$/, "$1/");
       }
       if ((url_params = this.serialize(parameters)).length) {
         url += "?" + url_params;
       }
-      url += anchor;
+      url += options.anchor ? "#" + options.anchor : "";
+      if (full_url) {
+        url = this.route_url(options) + url;
+      }
       return url;
     },
     visit: function(route, parameters, optional) {
       var left, left_part, right, right_part, type, value;
-
       if (optional == null) {
         optional = false;
       }
@@ -213,7 +224,7 @@
         case NodeTypes.CAT:
           left_part = this.visit(left, parameters, optional);
           right_part = this.visit(right, parameters, optional);
-          if (optional && !(left_part && right_part)) {
+          if (optional && ((this.is_optional_node(left[0]) && !left_part) || ((this.is_optional_node(right[0])) && !right_part))) {
             return "";
           }
           return "" + left_part + right_part;
@@ -233,9 +244,11 @@
           throw new Error("Unknown Rails node type");
       }
     },
+    is_optional_node: function(node) {
+      return this.indexOf([NodeTypes.STAR, NodeTypes.SYMBOL, NodeTypes.CAT], node) >= 0;
+    },
     build_path_spec: function(route, wildcard) {
       var left, right, type;
-
       if (wildcard == null) {
         wildcard = false;
       }
@@ -264,7 +277,6 @@
     },
     visit_globbing: function(route, parameters, optional) {
       var left, right, type, value;
-
       type = route[0], left = route[1], right = route[2];
       if (left.replace(/^\*/i, "") !== left) {
         route[1] = left = left.replace(/^\*/i, "");
@@ -285,18 +297,16 @@
     },
     get_prefix: function() {
       var prefix;
-
       prefix = defaults.prefix;
       if (prefix !== "") {
-        prefix = (prefix.match("/$") ? prefix : "" + prefix + "/");
+        prefix = (prefix.match("/$") ? prefix : prefix + "/");
       }
       return prefix;
     },
-    route: function(required_parts, optional_parts, route_spec) {
+    route: function(required_parts, optional_parts, route_spec, default_parts, full_url) {
       var path_fn;
-
       path_fn = function() {
-        return Utils.build_path(required_parts, optional_parts, route_spec, arguments);
+        return Utils.build_route(required_parts, optional_parts, route_spec, default_parts, full_url, arguments);
       };
       path_fn.required_params = required_parts;
       path_fn.toString = function() {
@@ -304,17 +314,51 @@
       };
       return path_fn;
     },
+    route_url: function(route_defaults) {
+      var hostname, port, protocol;
+      if (typeof route_defaults === 'string') {
+        return route_defaults;
+      }
+      protocol = route_defaults.protocol || Utils.current_protocol();
+      hostname = route_defaults.host || window.location.hostname;
+      port = route_defaults.port || (!route_defaults.host ? Utils.current_port() : void 0);
+      port = port ? ":" + port : '';
+      return protocol + "://" + hostname + port;
+    },
+    has_location: function() {
+      return typeof window !== 'undefined' && typeof window.location !== 'undefined';
+    },
+    current_host: function() {
+      if (this.has_location()) {
+        return window.location.hostname;
+      } else {
+        return null;
+      }
+    },
+    current_protocol: function() {
+      if (this.has_location() && window.location.protocol !== '') {
+        return window.location.protocol.replace(/:$/, '');
+      } else {
+        return 'http';
+      }
+    },
+    current_port: function() {
+      if (this.has_location() && window.location.port !== '') {
+        return window.location.port;
+      } else {
+        return '';
+      }
+    },
     _classToTypeCache: null,
     _classToType: function() {
-      var name, _i, _len, _ref;
-
+      var j, len, name, ref;
       if (this._classToTypeCache != null) {
         return this._classToTypeCache;
       }
       this._classToTypeCache = {};
-      _ref = "Boolean Number String Function Array Date RegExp Object Error".split(" ");
-      for (_i = 0, _len = _ref.length; _i < _len; _i++) {
-        name = _ref[_i];
+      ref = "Boolean Number String Function Array Date RegExp Object Error".split(" ");
+      for (j = 0, len = ref.length; j < len; j++) {
+        name = ref[j];
         this._classToTypeCache["[object " + name + "]"] = name.toLowerCase();
       }
       return this._classToTypeCache;
@@ -331,15 +375,31 @@
       } else {
         return typeof obj;
       }
+    },
+    indexOf: function(array, element) {
+      if (Array.prototype.indexOf) {
+        return array.indexOf(element);
+      } else {
+        return this.indexOfImplementation(array, element);
+      }
+    },
+    indexOfImplementation: function(array, element) {
+      var el, i, j, len, result;
+      result = -1;
+      for (i = j = 0, len = array.length; j < len; i = ++j) {
+        el = array[i];
+        if (el === element) {
+          result = i;
+        }
+      }
+      return result;
     }
   };
 
   createGlobalJsRoutesObject = function() {
     var namespace;
-
     namespace = function(mainRoot, namespaceString) {
       var current, parts;
-
       parts = (namespaceString ? namespaceString.split(".") : []);
       if (!parts.length) {
         return;
@@ -351,6 +411,9 @@
     namespace(root, "NAMESPACE");
     root.NAMESPACE = ROUTES;
     root.NAMESPACE.options = defaults;
+    root.NAMESPACE.default_serializer = function(object, prefix) {
+      return Utils.default_serializer(object, prefix);
+    };
     return root.NAMESPACE;
   };
 

data/lib/routes.js.coffee

@@ -1,3 +1,7 @@
+###
+File generated by js-routes GEM_VERSION
+Based on Rails routes of APP_CLASS
+###
 # root is this
 root = (exports ? this)
 
@@ -9,67 +13,62 @@ defaults =
 
 NodeTypes = NODE_TYPES
 
+ReservedOptions = [
+  'anchor'
+  'trailing_slash'
+  'host'
+  'port'
+  'protocol'
+]
+
 Utils =
 
-  serialize: (object, prefix = null) ->
-    return ""  unless object
+  default_serializer: (object, prefix = null) ->
+    return "" unless object?
     if !prefix and !(@get_object_type(object) is "object")
       throw new Error("Url parameters should be a javascript hash")
 
-    if root.jQuery
-      result = root.jQuery.param(object)
-      return (if not result then "" else result)
-
     s = []
     switch @get_object_type(object)
       when "array"
         for element, i in object
-          s.push @serialize(element, prefix + "[]")
+          s.push @default_serializer(element, prefix + "[]")
       when "object"
-        for own key, prop of object when prop?
-          key = "#{prefix}[#{key}]" if prefix?
-          s.push @serialize(prop, key)
+        for own key, prop of object
+          if !prop? and prefix?
+            prop = ""
+
+          if prop?
+            key = "#{prefix}[#{key}]" if prefix?
+            s.push @default_serializer(prop, key)
       else
-        if object
+        if object?
           s.push "#{encodeURIComponent(prefix.toString())}=#{encodeURIComponent(object.toString())}"
 
     return "" unless s.length
     s.join("&")
 
+  custom_serializer: SERIALIZER
+  serialize: (object) ->
+    if @custom_serializer? and @get_object_type(@custom_serializer) is "function"
+      @custom_serializer(object)
+    else
+      @default_serializer(object)
+
   clean_path: (path) ->
     path = path.split("://")
     last_index = path.length - 1
     path[last_index] = path[last_index].replace(/\/+/g, "/")
     path.join "://"
 
-  set_default_url_options: (optional_parts, options) ->
-    for part, i in optional_parts when (not options.hasOwnProperty(part) and defaults.default_url_options.hasOwnProperty(part))
-      options[part] = defaults.default_url_options[part]
-
-  extract_anchor: (options) ->
-    anchor = ""
-    if options.hasOwnProperty("anchor")
-      anchor = "##{options.anchor}"
-      delete options.anchor
-    anchor
-
-  extract_trailing_slash: (options) ->
-    trailing_slash = false
-    if defaults.default_url_options.hasOwnProperty("trailing_slash")
-      trailing_slash = defaults.default_url_options.trailing_slash
-    if options.hasOwnProperty("trailing_slash")
-      trailing_slash = options.trailing_slash
-      delete options.trailing_slash
-    trailing_slash
-
   extract_options: (number_of_params, args) ->
     last_el = args[args.length - 1]
-    if args.length > number_of_params or (last_el? and "object" is @get_object_type(last_el) and !@look_like_serialized_model(last_el))
-      args.pop()
+    if (args.length > number_of_params and last_el == undefined) or(last_el? and "object" is @get_object_type(last_el) and !@looks_like_serialized_model(last_el))
+      args.pop() || {}
     else
       {}
 
-  look_like_serialized_model: (object) ->
+  looks_like_serialized_model: (object) ->
     # consider object a model if it have a path identifier properties like id and to_param
     "id" of object or "to_param" of object
 
@@ -96,33 +95,47 @@ Utils =
     copy[key] = attr for own key, attr of obj
     copy
 
-  prepare_parameters: (required_parameters, actual_parameters, options) ->
-    result = @clone(options) or {}
-    for val, i in required_parameters when i < actual_parameters.length
-      result[val] = actual_parameters[i]
+  merge: (xs...) ->
+    tap = (o, fn) -> fn(o); o
+    if xs?.length > 0
+      tap {}, (m) -> m[k] = v for k, v of x for x in xs
+
+  normalize_options: (default_parts, required_parameters, optional_parts, actual_parameters) ->
+    options = @extract_options(required_parameters.length, actual_parameters)
+    if actual_parameters.length > required_parameters.length
+      throw new Error("Too many parameters provided for path")
+    options = @merge(defaults.default_url_options, default_parts, options)
+    result = {}
+    url_parameters = {}
+    result['url_parameters'] = url_parameters
+    for own key, value of options
+      if @indexOf(ReservedOptions, key) >= 0
+        result[key] = value
+      else
+        url_parameters[key] = value
+
+    for value, i in required_parameters when i < actual_parameters.length
+      url_parameters[value] = actual_parameters[i]
     result
 
-  build_path: (required_parameters, optional_parts, route, args) ->
+  build_route: (required_parameters, optional_parts, route, default_parts, full_url, args) ->
     args = Array::slice.call(args)
-    opts = @extract_options(required_parameters.length, args)
 
-    if args.length > required_parameters.length
-      throw new Error("Too many parameters provided for path")
-    parameters = @prepare_parameters(required_parameters, args, opts)
-    @set_default_url_options optional_parts, parameters
-    # options
-    anchor = @extract_anchor(parameters)
-    trailing_slash = @extract_trailing_slash(parameters)
+    options = @normalize_options(default_parts, required_parameters, optional_parts, args)
+    parameters = options['url_parameters']
+
     # path
     result = "#{@get_prefix()}#{@visit(route, parameters)}"
-    url = Utils.clean_path("#{result}")
+    url = Utils.clean_path(result)
     # set trailing_slash
-    url = url.replace(/(.*?)[\/]?$/, "$1/") if trailing_slash is true
+    url = url.replace(/(.*?)[\/]?$/, "$1/") if options['trailing_slash'] is true
     # set additional url params
     if (url_params = @serialize(parameters)).length
       url += "?#{url_params}"
     # set anchor
-    url += anchor
+    url += if options.anchor then "##{options.anchor}" else ""
+    if full_url
+      url = @route_url(options) + url
     url
 
   #
@@ -148,7 +161,9 @@ Utils =
       when NodeTypes.CAT
         left_part = @visit(left, parameters, optional)
         right_part = @visit(right, parameters, optional)
-        return "" if optional and not (left_part and right_part)
+        if optional and ((@is_optional_node(left[0]) and not left_part) or
+                                     ((@is_optional_node(right[0])) and not right_part))
+          return ""
         "#{left_part}#{right_part}"
       when NodeTypes.SYMBOL
         value = parameters[left]
@@ -167,6 +182,9 @@ Utils =
       else
         throw new Error("Unknown Rails node type")
 
+
+  is_optional_node: (node) -> @indexOf([NodeTypes.STAR, NodeTypes.SYMBOL, NodeTypes.CAT], node) >= 0
+
   #
   # This method build spec for route
   #
@@ -217,12 +235,44 @@ Utils =
   #
   # route function: create route path function and add spec to it
   #
-  route: (required_parts, optional_parts, route_spec) ->
-    path_fn = -> Utils.build_path(required_parts, optional_parts, route_spec, arguments)
+  route: (required_parts, optional_parts, route_spec, default_parts, full_url) ->
+    path_fn = -> Utils.build_route(
+      required_parts, optional_parts, route_spec, default_parts, full_url, arguments
+    )
     path_fn.required_params = required_parts
     path_fn.toString = -> Utils.build_path_spec(route_spec)
     path_fn
 
+
+  route_url: (route_defaults) ->
+    return route_defaults if typeof route_defaults == 'string'
+    protocol = route_defaults.protocol || Utils.current_protocol()
+    hostname = route_defaults.host || window.location.hostname
+    port = route_defaults.port || (Utils.current_port() unless route_defaults.host)
+    port = if port then ":#{port}" else ''
+
+    protocol + "://" + hostname + port
+
+
+  has_location: ->
+    typeof window != 'undefined' && typeof window.location != 'undefined'
+
+  current_host: ->
+    if @has_location() then window.location.hostname else null
+
+  current_protocol: () ->
+    if @has_location() && window.location.protocol != ''
+      # location.protocol includes the colon character
+      window.location.protocol.replace(/:$/, '')
+    else
+      'http'
+
+  current_port: () ->
+    if @has_location() && window.location.port != ''
+      window.location.port
+    else
+      ''
+
   #
   # This is helper method to define object type.
   # The typeof operator is probably the biggest design flaw of JavaScript, simply because it's basically completely broken.
@@ -260,6 +310,13 @@ Utils =
     return "#{obj}" unless obj?
     (if typeof obj is "object" or typeof obj is "function" then @_classToType()[Object::toString.call(obj)] or "object" else typeof obj)
 
+  # indexOf helper
+  indexOf: (array, element) -> if Array::indexOf then array.indexOf(element) else @indexOfImplementation(array, element)
+  indexOfImplementation: (array, element) ->
+    result = -1
+    (result = i for el, i in array when el is element)
+    result
+
 # globalJsObject
 createGlobalJsRoutesObject = ->
   # namespace function, private
@@ -273,6 +330,8 @@ createGlobalJsRoutesObject = ->
   namespace(root, "NAMESPACE")
   root.NAMESPACE = ROUTES
   root.NAMESPACE.options = defaults
+  root.NAMESPACE.default_serializer = (object, prefix) ->
+    Utils.default_serializer(object, prefix)
   root.NAMESPACE
 # Set up Routes appropriately for the environment.
 if typeof define is "function" and define.amd
@@ -280,4 +339,4 @@ if typeof define is "function" and define.amd
   define [], -> createGlobalJsRoutesObject()
 else
   # Browser globals
-  createGlobalJsRoutesObject()
+  createGlobalJsRoutesObject()