gmaps4rails 2.0.0.pre → 2.0.0

data/lib/generators/gmaps4rails/copy_coffee_generator.rb

@@ -0,0 +1,14 @@
+module Gmaps4rails
+  module Generators
+    class CopyCoffeeGenerator < ::Rails::Generators::Base
+
+      desc "This generator copies coffee files to app/assets/javascripts"
+      source_root      File.expand_path('../../../../vendor/assets/javascripts', __FILE__)
+
+      def copy_coffee
+        say_status("copying", "coffee files", :green)
+        directory 'gmaps', 'app/assets/javascripts/gmaps'
+      end
+    end
+  end
+end

data/lib/generators/gmaps4rails/copy_js_generator.rb

@@ -0,0 +1,15 @@
+module Gmaps4rails
+  module Generators
+    class CopyJsGenerator < ::Rails::Generators::Base
+
+      desc "This generator copies js files to public/javascripts"
+      source_root File.expand_path('../../../../js_compilation', __FILE__)
+
+      def copy_js
+        say_status("copying", "js file", :green)
+        copy_file "gmaps_google.js", "public/javascripts/gmaps_google.js"
+      end
+
+    end
+  end
+end

data/lib/gmaps4rails.rb

@@ -1,26 +1,16 @@
+if defined?(::Rails)
+  require 'gmaps4rails/rails/engine' if ::Rails.version >= '3.1'
+  require 'gmaps4rails/rails/railtie'
+end
+require 'gmaps4rails/version'
+
 module Gmaps4rails
-  require 'rails'
-  require 'gmaps4rails/base'
-  
-  class Engine < Rails::Engine
-     
-     initializer "gmaps4rails view helpers" do |app|
-       ActionView::Base.send :include, Gmaps4railsHelper
-     end
-     
+  autoload :MarkersBuilder, 'gmaps4rails/markers_builder'
+
+  module Rails
   end
-  
-  class Railtie < Rails::Railtie
-  
-     initializer "include acts_as_gmappable within ORM" do
-       ActiveSupport.on_load(:active_record) do
-         ActiveRecord::Base.send(:include, Gmaps4rails::ActsAsGmappable)
-       end
-       
-       ActiveSupport.on_load(:mongoid) do
-         Mongoid::Document.send(:include, Gmaps4rails::ActsAsGmappable)
-       end
-     end
-  
+
+  def Gmaps4rails.build_markers(collection, &block)
+    ::Gmaps4rails::MarkersBuilder.new(collection).call(&block)
   end
 end

data/lib/gmaps4rails/markers_builder.rb

@@ -0,0 +1,74 @@
+module Gmaps4rails
+  # the to_gmaps4rails method accepts a block to customize:
+  # - infowindow
+  # - picture
+  # - shadow
+  # - title
+  # - sidebar
+  # - json
+  #
+  # This works this way:
+  #   @users = User.all
+  #   @json  = Gmaps4rails.build_markers @users do |user, marker|
+  #     marker.lat user.latitude
+  #     marker.lng user.longitude
+  #     marker.infowindow render_to_string(:partial => "/users/my_template", :locals => { :object => user}).gsub(/\n/, '').gsub(/"/, '\"')
+  #     marker.picture({
+  #                     :url    => "http://www.blankdots.com/img/github-32x32.png",
+  #                     :width  => "32",
+  #                     :height => "32"
+  #                    })
+  #     marker.title   "i'm the title"
+  #     marker.json({ :id => user.id })
+  #   end
+  class MarkersBuilder
+
+    def initialize(collection)
+      @collection = Array(collection)
+    end
+
+    def call(&block)
+      @collection.map do |object|
+        MarkerBuilder.new(object).call(&block)
+      end
+    end
+
+    class MarkerBuilder
+
+      attr_reader :object, :hash
+      def initialize(object)
+        @object = object
+        @hash   = {}
+      end
+
+      def call(&block)
+        block.call(object, self)
+        hash
+      end
+
+      def lat(float)
+        @hash[:lat] = float
+      end
+
+      def lng(float)
+        @hash[:lng] = float
+      end
+
+      def infowindow(string)
+        @hash[:infowindow] = string
+      end
+
+      def title(string)
+        @hash[:marker_title] = string
+      end
+
+      def json(json)
+        @hash.merge! json
+      end
+
+      def picture(hash)
+        @hash[:picture] = hash
+      end
+    end
+  end
+end

data/lib/gmaps4rails/rails/engine.rb

@@ -0,0 +1,6 @@
+module Gmaps4rails
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/gmaps4rails/rails/railtie.rb

@@ -0,0 +1,6 @@
+module Gmaps4rails
+  module Rails
+    class Railtie < ::Rails::Railtie
+    end
+  end
+end

data/lib/gmaps4rails/version.rb

@@ -1,3 +1,3 @@
 module Gmaps4rails
-  VERSION = "2.0.0.pre"
-end
+  VERSION = "2.0.0"
+end

data/script/compile_coffee_files.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+require 'sprockets'
+
+app_path = File.expand_path('../..',  __FILE__)
+
+source_path      = (app_path + "/vendor/assets/javascripts/gmaps/")
+destination_path = (app_path + "/js_compilation/")
+
+%w(google).each do |name|
+  #main source file:
+  main_source_file_name = "#{name}.coffee"
+  #desired output file
+  compiled_file_path = (destination_path + "gmaps_#{name}.js")
+
+  env = Sprockets::Environment.new
+  env.append_path source_path
+
+  open(compiled_file_path, "w").write( env[main_source_file_name] )
+end

data/script/gmaps4rails.rake

@@ -0,0 +1,7 @@
+task :travis do
+  ["rspec spec", "rake jasmine:ci"].each do |cmd|
+    puts "Starting to run #{cmd}..."
+    system("export DISPLAY=:99.0 && bundle exec #{cmd}")
+    raise "#{cmd} failed!" unless $?.exitstatus == 0
+  end
+end

data/spec/javascripts/google/builders/marker_spec.js

@@ -0,0 +1,96 @@
+describe("Gmaps.Google.Builders.Marker", function() {
+
+  var subject_klass, instance, primitives;
+
+  beforeEach(function() {
+    primitives    = spec_helpers.override_primitives();
+    subject_klass = spec_helpers.google.Builders.Marker(primitives);
+  });
+
+  describe("constructor", function() {
+    var serviceObject, infowindow;
+    beforeEach(function() {
+      spyOn(subject_klass.prototype, 'create_marker');
+      spyOn(subject_klass.prototype, 'create_infowindow');
+    });
+
+    it("sets vars", function() {
+      instance = new subject_klass();
+      expect(subject_klass.prototype.create_marker).toHaveBeenCalled();
+      expect(subject_klass.prototype.create_infowindow).toHaveBeenCalled();
+    });
+
+    describe("marker_options", function() {
+      describe("coordinates", function() {
+        var args = { lat: 40, lng: 42};
+
+        it("only coordinates, without randomization", function() {
+          instance = new subject_klass(args, {}, {});
+
+          instance.marker_options();
+
+          expect(primitives.latLng).toHaveBeenCalledWith(args.lat, args.lng);
+        });
+
+        it("only coordinates, with randomization", function() {
+          instance = new subject_klass(args, {}, { maxRandomDistance: 12 });
+
+          instance.marker_options();
+
+          expect(primitives.latLng).not.toHaveBeenCalledWith(args.lat, args.lng);
+
+          called_lat = primitives.latLng.mostRecentCall.args[0];
+          called_lng = primitives.latLng.mostRecentCall.args[1];
+
+          expect(called_lat).toBeWithinOf(args.lat, 0.0001);
+          expect(called_lng).toBeWithinOf(args.lng, 0.0001);
+        });
+      });
+
+      describe("title", function() {
+        it("without title", function() {
+          instance = new subject_klass({}, {}, {});
+
+          var result = instance.marker_options();
+
+          expect(result.title).toBeUndefined();
+        });
+
+        it("with title", function() {
+          instance = new subject_klass({marker_title: 'title'}, {}, { maxRandomDistance: 12 });
+
+          var result = instance.marker_options();
+
+          expect(result.title).toEqual('title');
+        });
+      });
+
+      describe("merge with provider options", function() {
+        it("no provider options", function() {
+          instance = new subject_klass({}, {}, {});
+
+          var result = instance.marker_options();
+
+          expect(result.zIndex).toBeUndefined();
+        });
+
+        it("provider options", function() {
+          instance = new subject_klass({}, { zIndex: 'zIndex'}, { maxRandomDistance: 12 });
+
+          var result = instance.marker_options();
+
+          expect(result.zIndex).toEqual('zIndex');
+        });
+
+        it("provider options with overlapping keys", function() {
+          instance = new subject_klass({marker_title: 'arg_title'}, { title: 'provider_title'}, { maxRandomDistance: 12 });
+
+          var result = instance.marker_options();
+
+          expect(result.title).toEqual('arg_title');
+        });
+      });
+    });
+  });
+
+});

data/spec/javascripts/helpers/SpecHelper.js

@@ -0,0 +1,101 @@
+spec_helpers = {
+
+  createHandlersSpies: function(){
+    Gmaps.Specs = {
+      spies:    {
+        Builders: {}
+      },
+      Objects:  {},
+      Builders: {}
+    };
+
+    classes = ['Bound', 'Circle', 'Map', 'Marker', 'Polyline', 'Polygon', 'Kml', 'Clusterer' ];
+
+    _.each(classes, function(klass_name){
+      Gmaps.Specs.Objects[klass_name] = function(){};
+
+      Gmaps.Specs.spies.Builders[klass_name] = jasmine.createSpy(klass_name + ' build');
+
+      Gmaps.Specs.Builders[klass_name] = function(){
+        return {
+          build: function() {
+           return Gmaps.Specs.spies.Builders[klass_name];
+          }
+        }
+      };
+
+      spyOn(Gmaps.Specs.Builders, klass_name).andCallThrough();
+    })
+  },
+  override_primitives: function(){
+    factory = {
+      point:        jasmine.createSpy('point'),
+      size:         jasmine.createSpy('size'),
+      circle:       jasmine.createSpy('circle'),
+      latLng:       jasmine.createSpy('latLng'),
+      latLngBounds: jasmine.createSpy('latLngBounds'),
+      map:          jasmine.createSpy('map'),
+      mapTypez:     jasmine.createSpy('mapTypes'),
+      markerImage:  jasmine.createSpy('markerImage'),
+      marker:       jasmine.createSpy('marker'),
+      infowindow:   jasmine.createSpy('infowindow'),
+      listener:     jasmine.createSpy('addListener'),
+      clusterer:    jasmine.createSpy('clusterer'),
+      listenerOnce: jasmine.createSpy('addListenerOnce'),
+      polyline:     jasmine.createSpy('polyline'),
+      polygon:      jasmine.createSpy('polygon'),
+      kml:          jasmine.createSpy('kml'),
+
+      addListener: function(object, event_name, fn){
+        factory.listener(object, event_name, fn);
+      },
+      addListenerOnce: function(object, event_name, fn){
+        factory.listenerOnce(object, event_name, fn);
+      },
+      mapTypes: function(type){
+        factory.mapTypez[type];
+      },
+      latLngFromPosition: function(position){
+        if (_.isArray(position)){
+          return new factory.latLng(position[0], position[1])
+        } else {
+          if (_.isNumber(position.lat) && _.isNumber(position.lng)) {
+            return new factory.latLng(position.lat, position.lng)
+          } else {
+            return position;
+          }
+        }
+      }
+    };
+    return factory;
+  },
+
+  google: {
+
+    Builders: {
+      Marker: function(primitives){
+        var MarkerBuilder, _ref,
+          __hasProp = {}.hasOwnProperty,
+          __extends = function(child, parent) { for (var key in parent) { if (__hasProp.call(parent, key)) child[key] = parent[key]; } function ctor() { this.constructor = child; } ctor.prototype = parent.prototype; child.prototype = new ctor(); child.__super__ = parent.prototype; return child; };
+
+        return (function(_super) {
+          __extends(MarkerBuilder, _super);
+
+          function MarkerBuilder() {
+            _ref = MarkerBuilder.__super__.constructor.apply(this, arguments);
+            return _ref;
+          }
+
+          MarkerBuilder.OBJECT = Gmaps.Google.Objects.Marker;
+
+          MarkerBuilder.PRIMITIVES = primitives;
+
+          return MarkerBuilder;
+
+        })(Gmaps.Google.Builders.Marker);
+      }
+    }
+  }
+};
+
+window.spec_helpers = spec_helpers;

data/spec/javascripts/helpers/matchers.js

@@ -0,0 +1,12 @@
+beforeEach(function() {
+  var matchers = {
+    toBeFunction: function() {
+      return this.actual instanceof Function;
+    },
+    toBeWithinOf: function(expected, delta) {
+    return ((expected - delta) <= this.actual && (expected + delta) >= this.actual);
+    }
+  };
+
+  this.addMatchers(matchers);
+});

data/spec/javascripts/helpers/underscore.js

@@ -0,0 +1,6 @@
+//     Underscore.js 1.5.2
+//     http://underscorejs.org
+//     (c) 2009-2013 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
+//     Underscore may be freely distributed under the MIT license.
+(function(){var n=this,t=n._,r={},e=Array.prototype,u=Object.prototype,i=Function.prototype,a=e.push,o=e.slice,c=e.concat,l=u.toString,f=u.hasOwnProperty,s=e.forEach,p=e.map,h=e.reduce,v=e.reduceRight,g=e.filter,d=e.every,m=e.some,y=e.indexOf,b=e.lastIndexOf,x=Array.isArray,w=Object.keys,_=i.bind,j=function(n){return n instanceof j?n:this instanceof j?(this._wrapped=n,void 0):new j(n)};"undefined"!=typeof exports?("undefined"!=typeof module&&module.exports&&(exports=module.exports=j),exports._=j):n._=j,j.VERSION="1.5.2";var A=j.each=j.forEach=function(n,t,e){if(null!=n)if(s&&n.forEach===s)n.forEach(t,e);else if(n.length===+n.length){for(var u=0,i=n.length;i>u;u++)if(t.call(e,n[u],u,n)===r)return}else for(var a=j.keys(n),u=0,i=a.length;i>u;u++)if(t.call(e,n[a[u]],a[u],n)===r)return};j.map=j.collect=function(n,t,r){var e=[];return null==n?e:p&&n.map===p?n.map(t,r):(A(n,function(n,u,i){e.push(t.call(r,n,u,i))}),e)};var E="Reduce of empty array with no initial value";j.reduce=j.foldl=j.inject=function(n,t,r,e){var u=arguments.length>2;if(null==n&&(n=[]),h&&n.reduce===h)return e&&(t=j.bind(t,e)),u?n.reduce(t,r):n.reduce(t);if(A(n,function(n,i,a){u?r=t.call(e,r,n,i,a):(r=n,u=!0)}),!u)throw new TypeError(E);return r},j.reduceRight=j.foldr=function(n,t,r,e){var u=arguments.length>2;if(null==n&&(n=[]),v&&n.reduceRight===v)return e&&(t=j.bind(t,e)),u?n.reduceRight(t,r):n.reduceRight(t);var i=n.length;if(i!==+i){var a=j.keys(n);i=a.length}if(A(n,function(o,c,l){c=a?a[--i]:--i,u?r=t.call(e,r,n[c],c,l):(r=n[c],u=!0)}),!u)throw new TypeError(E);return r},j.find=j.detect=function(n,t,r){var e;return O(n,function(n,u,i){return t.call(r,n,u,i)?(e=n,!0):void 0}),e},j.filter=j.select=function(n,t,r){var e=[];return null==n?e:g&&n.filter===g?n.filter(t,r):(A(n,function(n,u,i){t.call(r,n,u,i)&&e.push(n)}),e)},j.reject=function(n,t,r){return j.filter(n,function(n,e,u){return!t.call(r,n,e,u)},r)},j.every=j.all=function(n,t,e){t||(t=j.identity);var u=!0;return null==n?u:d&&n.every===d?n.every(t,e):(A(n,function(n,i,a){return(u=u&&t.call(e,n,i,a))?void 0:r}),!!u)};var O=j.some=j.any=function(n,t,e){t||(t=j.identity);var u=!1;return null==n?u:m&&n.some===m?n.some(t,e):(A(n,function(n,i,a){return u||(u=t.call(e,n,i,a))?r:void 0}),!!u)};j.contains=j.include=function(n,t){return null==n?!1:y&&n.indexOf===y?n.indexOf(t)!=-1:O(n,function(n){return n===t})},j.invoke=function(n,t){var r=o.call(arguments,2),e=j.isFunction(t);return j.map(n,function(n){return(e?t:n[t]).apply(n,r)})},j.pluck=function(n,t){return j.map(n,function(n){return n[t]})},j.where=function(n,t,r){return j.isEmpty(t)?r?void 0:[]:j[r?"find":"filter"](n,function(n){for(var r in t)if(t[r]!==n[r])return!1;return!0})},j.findWhere=function(n,t){return j.where(n,t,!0)},j.max=function(n,t,r){if(!t&&j.isArray(n)&&n[0]===+n[0]&&n.length<65535)return Math.max.apply(Math,n);if(!t&&j.isEmpty(n))return-1/0;var e={computed:-1/0,value:-1/0};return A(n,function(n,u,i){var a=t?t.call(r,n,u,i):n;a>e.computed&&(e={value:n,computed:a})}),e.value},j.min=function(n,t,r){if(!t&&j.isArray(n)&&n[0]===+n[0]&&n.length<65535)return Math.min.apply(Math,n);if(!t&&j.isEmpty(n))return 1/0;var e={computed:1/0,value:1/0};return A(n,function(n,u,i){var a=t?t.call(r,n,u,i):n;a<e.computed&&(e={value:n,computed:a})}),e.value},j.shuffle=function(n){var t,r=0,e=[];return A(n,function(n){t=j.random(r++),e[r-1]=e[t],e[t]=n}),e},j.sample=function(n,t,r){return arguments.length<2||r?n[j.random(n.length-1)]:j.shuffle(n).slice(0,Math.max(0,t))};var k=function(n){return j.isFunction(n)?n:function(t){return t[n]}};j.sortBy=function(n,t,r){var e=k(t);return j.pluck(j.map(n,function(n,t,u){return{value:n,index:t,criteria:e.call(r,n,t,u)}}).sort(function(n,t){var r=n.criteria,e=t.criteria;if(r!==e){if(r>e||r===void 0)return 1;if(e>r||e===void 0)return-1}return n.index-t.index}),"value")};var F=function(n){return function(t,r,e){var u={},i=null==r?j.identity:k(r);return A(t,function(r,a){var o=i.call(e,r,a,t);n(u,o,r)}),u}};j.groupBy=F(function(n,t,r){(j.has(n,t)?n[t]:n[t]=[]).push(r)}),j.indexBy=F(function(n,t,r){n[t]=r}),j.countBy=F(function(n,t){j.has(n,t)?n[t]++:n[t]=1}),j.sortedIndex=function(n,t,r,e){r=null==r?j.identity:k(r);for(var u=r.call(e,t),i=0,a=n.length;a>i;){var o=i+a>>>1;r.call(e,n[o])<u?i=o+1:a=o}return i},j.toArray=function(n){return n?j.isArray(n)?o.call(n):n.length===+n.length?j.map(n,j.identity):j.values(n):[]},j.size=function(n){return null==n?0:n.length===+n.length?n.length:j.keys(n).length},j.first=j.head=j.take=function(n,t,r){return null==n?void 0:null==t||r?n[0]:o.call(n,0,t)},j.initial=function(n,t,r){return o.call(n,0,n.length-(null==t||r?1:t))},j.last=function(n,t,r){return null==n?void 0:null==t||r?n[n.length-1]:o.call(n,Math.max(n.length-t,0))},j.rest=j.tail=j.drop=function(n,t,r){return o.call(n,null==t||r?1:t)},j.compact=function(n){return j.filter(n,j.identity)};var M=function(n,t,r){return t&&j.every(n,j.isArray)?c.apply(r,n):(A(n,function(n){j.isArray(n)||j.isArguments(n)?t?a.apply(r,n):M(n,t,r):r.push(n)}),r)};j.flatten=function(n,t){return M(n,t,[])},j.without=function(n){return j.difference(n,o.call(arguments,1))},j.uniq=j.unique=function(n,t,r,e){j.isFunction(t)&&(e=r,r=t,t=!1);var u=r?j.map(n,r,e):n,i=[],a=[];return A(u,function(r,e){(t?e&&a[a.length-1]===r:j.contains(a,r))||(a.push(r),i.push(n[e]))}),i},j.union=function(){return j.uniq(j.flatten(arguments,!0))},j.intersection=function(n){var t=o.call(arguments,1);return j.filter(j.uniq(n),function(n){return j.every(t,function(t){return j.indexOf(t,n)>=0})})},j.difference=function(n){var t=c.apply(e,o.call(arguments,1));return j.filter(n,function(n){return!j.contains(t,n)})},j.zip=function(){for(var n=j.max(j.pluck(arguments,"length").concat(0)),t=new Array(n),r=0;n>r;r++)t[r]=j.pluck(arguments,""+r);return t},j.object=function(n,t){if(null==n)return{};for(var r={},e=0,u=n.length;u>e;e++)t?r[n[e]]=t[e]:r[n[e][0]]=n[e][1];return r},j.indexOf=function(n,t,r){if(null==n)return-1;var e=0,u=n.length;if(r){if("number"!=typeof r)return e=j.sortedIndex(n,t),n[e]===t?e:-1;e=0>r?Math.max(0,u+r):r}if(y&&n.indexOf===y)return n.indexOf(t,r);for(;u>e;e++)if(n[e]===t)return e;return-1},j.lastIndexOf=function(n,t,r){if(null==n)return-1;var e=null!=r;if(b&&n.lastIndexOf===b)return e?n.lastIndexOf(t,r):n.lastIndexOf(t);for(var u=e?r:n.length;u--;)if(n[u]===t)return u;return-1},j.range=function(n,t,r){arguments.length<=1&&(t=n||0,n=0),r=arguments[2]||1;for(var e=Math.max(Math.ceil((t-n)/r),0),u=0,i=new Array(e);e>u;)i[u++]=n,n+=r;return i};var R=function(){};j.bind=function(n,t){var r,e;if(_&&n.bind===_)return _.apply(n,o.call(arguments,1));if(!j.isFunction(n))throw new TypeError;return r=o.call(arguments,2),e=function(){if(!(this instanceof e))return n.apply(t,r.concat(o.call(arguments)));R.prototype=n.prototype;var u=new R;R.prototype=null;var i=n.apply(u,r.concat(o.call(arguments)));return Object(i)===i?i:u}},j.partial=function(n){var t=o.call(arguments,1);return function(){return n.apply(this,t.concat(o.call(arguments)))}},j.bindAll=function(n){var t=o.call(arguments,1);if(0===t.length)throw new Error("bindAll must be passed function names");return A(t,function(t){n[t]=j.bind(n[t],n)}),n},j.memoize=function(n,t){var r={};return t||(t=j.identity),function(){var e=t.apply(this,arguments);return j.has(r,e)?r[e]:r[e]=n.apply(this,arguments)}},j.delay=function(n,t){var r=o.call(arguments,2);return setTimeout(function(){return n.apply(null,r)},t)},j.defer=function(n){return j.delay.apply(j,[n,1].concat(o.call(arguments,1)))},j.throttle=function(n,t,r){var e,u,i,a=null,o=0;r||(r={});var c=function(){o=r.leading===!1?0:new Date,a=null,i=n.apply(e,u)};return function(){var l=new Date;o||r.leading!==!1||(o=l);var f=t-(l-o);return e=this,u=arguments,0>=f?(clearTimeout(a),a=null,o=l,i=n.apply(e,u)):a||r.trailing===!1||(a=setTimeout(c,f)),i}},j.debounce=function(n,t,r){var e,u,i,a,o;return function(){i=this,u=arguments,a=new Date;var c=function(){var l=new Date-a;t>l?e=setTimeout(c,t-l):(e=null,r||(o=n.apply(i,u)))},l=r&&!e;return e||(e=setTimeout(c,t)),l&&(o=n.apply(i,u)),o}},j.once=function(n){var t,r=!1;return function(){return r?t:(r=!0,t=n.apply(this,arguments),n=null,t)}},j.wrap=function(n,t){return function(){var r=[n];return a.apply(r,arguments),t.apply(this,r)}},j.compose=function(){var n=arguments;return function(){for(var t=arguments,r=n.length-1;r>=0;r--)t=[n[r].apply(this,t)];return t[0]}},j.after=function(n,t){return function(){return--n<1?t.apply(this,arguments):void 0}},j.keys=w||function(n){if(n!==Object(n))throw new TypeError("Invalid object");var t=[];for(var r in n)j.has(n,r)&&t.push(r);return t},j.values=function(n){for(var t=j.keys(n),r=t.length,e=new Array(r),u=0;r>u;u++)e[u]=n[t[u]];return e},j.pairs=function(n){for(var t=j.keys(n),r=t.length,e=new Array(r),u=0;r>u;u++)e[u]=[t[u],n[t[u]]];return e},j.invert=function(n){for(var t={},r=j.keys(n),e=0,u=r.length;u>e;e++)t[n[r[e]]]=r[e];return t},j.functions=j.methods=function(n){var t=[];for(var r in n)j.isFunction(n[r])&&t.push(r);return t.sort()},j.extend=function(n){return A(o.call(arguments,1),function(t){if(t)for(var r in t)n[r]=t[r]}),n},j.pick=function(n){var t={},r=c.apply(e,o.call(arguments,1));return A(r,function(r){r in n&&(t[r]=n[r])}),t},j.omit=function(n){var t={},r=c.apply(e,o.call(arguments,1));for(var u in n)j.contains(r,u)||(t[u]=n[u]);return t},j.defaults=function(n){return A(o.call(arguments,1),function(t){if(t)for(var r in t)n[r]===void 0&&(n[r]=t[r])}),n},j.clone=function(n){return j.isObject(n)?j.isArray(n)?n.slice():j.extend({},n):n},j.tap=function(n,t){return t(n),n};var S=function(n,t,r,e){if(n===t)return 0!==n||1/n==1/t;if(null==n||null==t)return n===t;n instanceof j&&(n=n._wrapped),t instanceof j&&(t=t._wrapped);var u=l.call(n);if(u!=l.call(t))return!1;switch(u){case"[object String]":return n==String(t);case"[object Number]":return n!=+n?t!=+t:0==n?1/n==1/t:n==+t;case"[object Date]":case"[object Boolean]":return+n==+t;case"[object RegExp]":return n.source==t.source&&n.global==t.global&&n.multiline==t.multiline&&n.ignoreCase==t.ignoreCase}if("object"!=typeof n||"object"!=typeof t)return!1;for(var i=r.length;i--;)if(r[i]==n)return e[i]==t;var a=n.constructor,o=t.constructor;if(a!==o&&!(j.isFunction(a)&&a instanceof a&&j.isFunction(o)&&o instanceof o))return!1;r.push(n),e.push(t);var c=0,f=!0;if("[object Array]"==u){if(c=n.length,f=c==t.length)for(;c--&&(f=S(n[c],t[c],r,e)););}else{for(var s in n)if(j.has(n,s)&&(c++,!(f=j.has(t,s)&&S(n[s],t[s],r,e))))break;if(f){for(s in t)if(j.has(t,s)&&!c--)break;f=!c}}return r.pop(),e.pop(),f};j.isEqual=function(n,t){return S(n,t,[],[])},j.isEmpty=function(n){if(null==n)return!0;if(j.isArray(n)||j.isString(n))return 0===n.length;for(var t in n)if(j.has(n,t))return!1;return!0},j.isElement=function(n){return!(!n||1!==n.nodeType)},j.isArray=x||function(n){return"[object Array]"==l.call(n)},j.isObject=function(n){return n===Object(n)},A(["Arguments","Function","String","Number","Date","RegExp"],function(n){j["is"+n]=function(t){return l.call(t)=="[object "+n+"]"}}),j.isArguments(arguments)||(j.isArguments=function(n){return!(!n||!j.has(n,"callee"))}),"function"!=typeof/./&&(j.isFunction=function(n){return"function"==typeof n}),j.isFinite=function(n){return isFinite(n)&&!isNaN(parseFloat(n))},j.isNaN=function(n){return j.isNumber(n)&&n!=+n},j.isBoolean=function(n){return n===!0||n===!1||"[object Boolean]"==l.call(n)},j.isNull=function(n){return null===n},j.isUndefined=function(n){return n===void 0},j.has=function(n,t){return f.call(n,t)},j.noConflict=function(){return n._=t,this},j.identity=function(n){return n},j.times=function(n,t,r){for(var e=Array(Math.max(0,n)),u=0;n>u;u++)e[u]=t.call(r,u);return e},j.random=function(n,t){return null==t&&(t=n,n=0),n+Math.floor(Math.random()*(t-n+1))};var I={escape:{"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;"}};I.unescape=j.invert(I.escape);var T={escape:new RegExp("["+j.keys(I.escape).join("")+"]","g"),unescape:new RegExp("("+j.keys(I.unescape).join("|")+")","g")};j.each(["escape","unescape"],function(n){j[n]=function(t){return null==t?"":(""+t).replace(T[n],function(t){return I[n][t]})}}),j.result=function(n,t){if(null==n)return void 0;var r=n[t];return j.isFunction(r)?r.call(n):r},j.mixin=function(n){A(j.functions(n),function(t){var r=j[t]=n[t];j.prototype[t]=function(){var n=[this._wrapped];return a.apply(n,arguments),z.call(this,r.apply(j,n))}})};var N=0;j.uniqueId=function(n){var t=++N+"";return n?n+t:t},j.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var q=/(.)^/,B={"'":"'","\\":"\\","\r":"r","\n":"n"," ":"t","\u2028":"u2028","\u2029":"u2029"},D=/\\|'|\r|\n|\t|\u2028|\u2029/g;j.template=function(n,t,r){var e;r=j.defaults({},r,j.templateSettings);var u=new RegExp([(r.escape||q).source,(r.interpolate||q).source,(r.evaluate||q).source].join("|")+"|$","g"),i=0,a="__p+='";n.replace(u,function(t,r,e,u,o){return a+=n.slice(i,o).replace(D,function(n){return"\\"+B[n]}),r&&(a+="'+\n((__t=("+r+"))==null?'':_.escape(__t))+\n'"),e&&(a+="'+\n((__t=("+e+"))==null?'':__t)+\n'"),u&&(a+="';\n"+u+"\n__p+='"),i=o+t.length,t}),a+="';\n",r.variable||(a="with(obj||{}){\n"+a+"}\n"),a="var __t,__p='',__j=Array.prototype.join,"+"print=function(){__p+=__j.call(arguments,'');};\n"+a+"return __p;\n";try{e=new Function(r.variable||"obj","_",a)}catch(o){throw o.source=a,o}if(t)return e(t,j);var c=function(n){return e.call(this,n,j)};return c.source="function("+(r.variable||"obj")+"){\n"+a+"}",c},j.chain=function(n){return j(n).chain()};var z=function(n){return this._chain?j(n).chain():n};j.mixin(j),A(["pop","push","reverse","shift","sort","splice","unshift"],function(n){var t=e[n];j.prototype[n]=function(){var r=this._wrapped;return t.apply(r,arguments),"shift"!=n&&"splice"!=n||0!==r.length||delete r[0],z.call(this,r)}}),A(["concat","join","slice"],function(n){var t=e[n];j.prototype[n]=function(){return z.call(this,t.apply(this._wrapped,arguments))}}),j.extend(j.prototype,{chain:function(){return this._chain=!0,this},value:function(){return this._wrapped}})}).call(this);
+//# sourceMappingURL=underscore-min.map

data/spec/javascripts/objects/handler_spec.js

@@ -0,0 +1,320 @@
+describe("Gmaps.Objects.Handler", function() {
+
+  var subjectClass = Gmaps.Objects.Handler;
+  var subject      = null;
+  var builders_path  = function()    { return Gmaps.Specs.Builders; };
+  var builders       = function(name){ return builders_path()[name]; };
+  var stubbed_path   = function(name){ return Gmaps.Specs.spies.Builders; };
+  var stubbed        = function(name){ return stubbed_path()[name]; };
+  var primitives     = spec_helpers.override_primitives()
+  var build_subject = function() {
+    subject = new subjectClass('Specs', { primitives: primitives });
+  };
+
+  beforeEach(function() {
+    spec_helpers.createHandlersSpies();
+  });
+
+  it("function exists", function() {
+    expect(typeof subjectClass).toBe('function');
+  });
+
+  describe("constructor", function() {
+    beforeEach(function() {
+      build_subject();
+    });
+
+    describe("primitives setter", function() {
+      it("uses expected primitives", function() {
+        new subject.primitives.point();
+        expect(primitives.point).toHaveBeenCalled();
+      });
+    });
+
+    describe("options setter", function() {
+      it("default", function() {
+        expect(_.isEqual(subject.builders,       subject._default_builders())).toBeTruthy();
+        expect(_.isEqual(subject.models,         subject._default_models())).toBeTruthy();
+        expect(_.isEqual(subject.marker_options, subject._default_marker_options())).toBeTruthy();
+      });
+
+      it("redefines builders", function() {
+        var MarkerBuilder = function(){};
+        subject = new subjectClass('Specs', {  primitives: primitives, builders: { Marker: MarkerBuilder } });
+        expect(subject.builders.Marker).toBe(MarkerBuilder);
+      });
+
+      it("redefines models", function() {
+        var MarkerModel = function(){};
+        subject = new subjectClass('Specs', {  primitives: primitives, models: { Marker: MarkerModel } });
+        expect(subject.models.Marker).toBe(MarkerModel);
+      });
+
+      it("redefines marker_options", function() {
+        var marker_options = { foo: 1 };
+        subject = new subjectClass('Specs', {  primitives: primitives, markers: marker_options });
+        expect(subject.marker_options.foo).toBe(marker_options.foo);
+      });
+
+      it("Clusterer: default model if clusterer required", function() {
+        subject = new subjectClass('Specs', {
+          primitives: primitives,
+          markers: { clusterer: {} }
+        });
+        expect(subject.models.Clusterer).not.toBe(Gmaps.Objects.NullClusterer);
+      });
+
+      it("Clusterer: null clusterer if no clusterer required", function() {
+        subject = new subjectClass('Specs', {
+          primitives: primitives,
+          markers:   { clusterer: null }
+        });
+        expect(subject.models.Clusterer).toBe(Gmaps.Objects.NullClusterer);
+      });
+
+      it("creates bounds", function() {
+        expect(subject.bounds).toBe(stubbed('Bound'));
+      });
+    });
+  });
+
+  describe("buildMap", function() {
+    beforeEach(function() {
+      build_subject();
+    });
+
+    it("delegates to builder", function() {
+      var options   = jasmine.createSpy('options');
+      var onMapLoad = function(){};
+      subject.buildMap(options, onMapLoad);
+      expect(Gmaps.Specs.Builders.Map).toHaveBeenCalledWith(options, jasmine.any(Function), undefined)
+      expect(subject.map).toBe(stubbed('Map'));
+    });
+  });
+
+  describe("with map", function() {
+    var map;
+
+    var assign_stubbed_map = function() {
+      map = jasmine.createSpy('map');
+      spyOn(subject, 'getMap').andReturn(map);
+    };
+
+    describe("add collection", function() {
+
+      var object_data, objects_data, provider_options, built_object;
+
+      beforeEach(function() {
+        built_object = jasmine.createSpy('built_object');
+        object_data  = jasmine.createSpy('object_data');
+        objects_data = [object_data];
+        provider_options = jasmine.createSpy('provider_options');
+        build_subject();
+        assign_stubbed_map();
+      });
+
+      describe("addMarkers", function() {
+        it("loops and delegates to addMarker", function() {
+          spyOn(subject, 'addMarker').andReturn(built_object);
+
+          var result = subject.addMarkers(objects_data, provider_options);
+
+          expect(subject.addMarker).toHaveBeenCalledWith(object_data, provider_options);
+          expect(result).toEqual([built_object]);
+        });
+      });
+
+      describe("addCircles", function() {
+        it("loops and delegates to addCircle", function() {
+          spyOn(subject, 'addCircle').andReturn(built_object);
+
+          var result = subject.addCircles(objects_data, provider_options);
+
+          expect(subject.addCircle).toHaveBeenCalledWith(object_data, provider_options);
+          expect(result).toEqual([built_object]);
+        });
+      });
+
+      describe("addPolylines", function() {
+        it("loops and delegates to addPolyline", function() {
+          spyOn(subject, 'addPolyline').andReturn(built_object);
+
+          var result = subject.addPolylines(objects_data, provider_options);
+
+          expect(subject.addPolyline).toHaveBeenCalledWith(object_data, provider_options);
+          expect(result).toEqual([built_object]);
+        });
+      });
+
+      describe("addPolygons", function() {
+        it("loops and delegates to addPolygon", function() {
+          spyOn(subject, 'addPolygon').andReturn(built_object);
+
+          var result = subject.addPolygons(objects_data, provider_options);
+
+          expect(subject.addPolygon).toHaveBeenCalledWith(object_data, provider_options);
+          expect(result).toEqual([built_object]);
+        });
+      });
+
+      describe("addKmls", function() {
+        it("loops and delegates to addKml", function() {
+          spyOn(subject, 'addKml').andReturn(built_object);
+
+          var result = subject.addKmls(objects_data, provider_options);
+
+          expect(subject.addKml).toHaveBeenCalledWith(object_data, provider_options);
+          expect(result).toEqual([built_object]);
+        });
+      });
+    });
+
+    describe("add single item", function() {
+      var object, object_data, provider_options, builder_spy;
+
+      var create_context = function(name){
+        stubbed_path()[name] = object;
+        builder_spy          = builders(name);
+
+        build_subject();
+        assign_stubbed_map();
+      };
+
+      beforeEach(function() {
+        object           = jasmine.createSpyObj('object', ['setMap']);
+        object_data      = jasmine.createSpy('object_data');
+        provider_options = jasmine.createSpy('provider_options');
+      });
+
+      describe("addMarker", function() {
+        var clusterer;
+
+        beforeEach(function() {
+          clusterer = jasmine.createSpyObj('clusterer', ['addMarker']);
+          create_context('Marker');
+          subject.clusterer = clusterer;
+        });
+
+        it("delegates marker creation to builder", function() {
+          var result = subject.addMarker(object_data, provider_options);
+          expect(builder_spy).toHaveBeenCalledWith(object_data, provider_options, subject.marker_options);
+        });
+
+        it("associate map to Marker", function() {
+          subject.addMarker(object_data, provider_options);
+
+          expect(object.setMap).toHaveBeenCalledWith(map);
+        });
+
+        it("clusterer receives marker", function() {
+          subject.addMarker(object_data, provider_options);
+
+          expect(clusterer.addMarker).toHaveBeenCalledWith(object);
+        });
+
+        it("returns marker", function() {
+          var result = subject.addMarker(object_data, provider_options);
+
+          expect(result).toBe(object);
+        });
+      });
+
+      describe("addCircle", function() {
+        beforeEach(function() {
+          create_context('Circle');
+        });
+
+        it("delegates circle creation to builder", function() {
+          subject.addCircle(object_data, provider_options);
+
+          expect(builder_spy).toHaveBeenCalledWith(object_data, provider_options, undefined);
+        });
+
+        it("associate map to circle", function() {
+          subject.addCircle(object_data, provider_options);
+
+          expect(object.setMap).toHaveBeenCalledWith(map);
+        });
+
+        it("returns circle", function() {
+          var result = subject.addCircle(object_data, provider_options);
+
+          expect(result).toBe(object);
+        });
+      });
+
+      describe("addPolyline", function() {
+        beforeEach(function() {
+          create_context('Polyline');
+        });
+
+        it("delegates polyline creation to builder", function() {
+          subject.addPolyline(object_data, provider_options);
+
+          expect(builder_spy).toHaveBeenCalledWith(object_data, provider_options, undefined);
+        });
+
+        it("associate map to polyline", function() {
+          subject.addPolyline(object_data, provider_options);
+
+          expect(object.setMap).toHaveBeenCalledWith(map);
+        });
+
+        it("returns polyline", function() {
+          var result = subject.addPolyline(object_data, provider_options);
+
+          expect(result).toBe(object);
+        });
+      });
+
+      describe("addPolygon", function() {
+        beforeEach(function() {
+          create_context('Polygon');
+        });
+
+        it("delegates polygon creation to builder", function() {
+          subject.addPolygon(object_data, provider_options);
+
+          expect(builder_spy).toHaveBeenCalledWith(object_data, provider_options, undefined);
+        });
+
+        it("associate map to polygon", function() {
+          subject.addPolygon(object_data, provider_options);
+
+          expect(object.setMap).toHaveBeenCalledWith(map);
+        });
+
+        it("returns polygon", function() {
+          var result = subject.addPolygon(object_data, provider_options);
+
+          expect(result).toBe(object);
+        });
+      });
+
+      describe("addKml", function() {
+        beforeEach(function() {
+          create_context('Kml');
+        });
+
+        it("delegates kml creation to builder", function() {
+          subject.addKml(object_data, provider_options);
+
+          expect(builder_spy).toHaveBeenCalledWith(object_data, provider_options, undefined);
+        });
+
+        it("associate map to kml", function() {
+          subject.addKml(object_data, provider_options);
+
+          expect(object.setMap).toHaveBeenCalledWith(map);
+        });
+
+        it("returns kml", function() {
+          var result = subject.addKml(object_data, provider_options);
+
+          expect(result).toBe(object);
+        });
+      });
+    });
+  });
+
+});