mixpal 0.0.4

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mixpal.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,5 @@
+guard "rspec", :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$}) { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch("spec/spec_helper.rb") { "spec" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 patbenatar
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,121 @@
+# Mixpal
+
+As the JavaScript library is Mixpanel's preferred method of usage,
+Mixpal aims to make it easier to work with from your Rails backend.
+Most notably it persists tracking data across redirects, perfect for handling
+events like user sign ups or form submissions.
+
+## Installation
+
+### With Bundler
+
+1. Add to Gemfile: `gem "mixpal"`
+1. `$ bundle`
+
+### Standalone
+
+```bash
+$ gem install mixpal
+```
+
+## Setup
+
+### In your controller
+
+```ruby
+class ApplicationController < ActionController::Base
+  include Mixpal::Integration
+  mixpanel_identity :current_user, :email
+end
+```
+
+`mixpanel_identity` tells Mixpal how to identify your users. This
+is used to alias and identify with Mixpanel. The first arg should be a method
+on this controller that returns an object to which we can send the second arg.
+In this example, we'll identify our user by `current_user.email`.
+
+### In your layout
+
+```ruby
+<%= mixpanel.render() %>
+```
+
+## Usage
+
+Mixpal exposes its helpers to your controllers, views, and view helpers.
+
+### Tracking Events
+
+```ruby
+mixpanel.track "Event Name", property_1: "A string", property_2: true
+```
+
+### Registering New Users
+
+When a new user signs up, you want to create their profile on Mixpanel as well
+as alias all event data to their identifier. As per Mixpanel's docs, you should
+only do this once per user.
+
+```ruby
+mixpanel.register_user user.attributes.slice("name", "email")
+```
+
+`register_user` will attempt to identify and convert the following properties to
+Mixpanel "special properties": `name`, `email`, and `created_at`.
+
+### Updating Existing Users
+
+When a user changes their profile...
+
+```ruby
+mixpanel.update_user email: "mynewemail@example.com"
+```
+
+As with `register_user`, this method will also identify "special properties".
+
+### Persistance Across Redirects
+
+Mixpal stores any tracked events or user data in `Rails.cache` when
+it detects a redirect so it can output the appropriate Mixpanel JS integration
+code to the client on the following render. This enables us to do cool things
+like:
+
+```ruby
+class UsersController < ActionController::Base
+  def create
+    # ... do cool stuff ...
+    mixpanel.register_user name: @user.name, email: @user.email
+    redirect_to root_path
+  end
+
+  def update
+    # ... more cool stuff! ...
+
+    mixpanel.update_user name: @user.name
+    mixpanel.track "Profile Updated"
+
+    redirect_to root_path
+  end
+end
+```
+
+#### Customizing the storage adapter
+
+You can specify a custom persistence storage adapter like so:
+
+```ruby
+Mixpal::Tracker.storage = MyCustomAdapter.new
+```
+
+Storage adapters must implement the following API: `write(key, value)`,
+`read(key)`, and `delete(key)`.
+
+## Contributing
+
+1. Fork it
+1. Create your feature branch (`git checkout -b feature/my-new-feature`)
+1. Make your changes
+1. Add accompanying tests
+1. Commit your changes (`git commit -am 'Add some feature'`)
+1. Push to the branch (`git push origin feature/my-new-feature`)
+1. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/mixpal.rb

@@ -0,0 +1,10 @@
+require "mixpal/version"
+require "active_support/core_ext"
+
+module Mixpal
+  autoload :Util, "mixpal/util"
+  autoload :Tracker, "mixpal/tracker"
+  autoload :Event, "mixpal/event"
+  autoload :User, "mixpal/user"
+  autoload :Integration, "mixpal/integration"
+end

data/lib/mixpal/event.rb

@@ -0,0 +1,26 @@
+module Mixpal
+  class Event
+    attr_reader :name, :properties
+
+    def initialize(name, properties)
+      @name = name
+      @properties = properties
+    end
+
+    def render
+      js_object = Mixpal::Util.hash_to_js_object_string(properties)
+      "mixpanel.track(\"#{name}\", #{js_object});".html_safe
+    end
+
+    def to_store
+      {
+        name: name,
+        properties: properties,
+      }
+    end
+
+    def self.from_store(data)
+      new(data[:name], data[:properties])
+    end
+  end
+end

data/lib/mixpal/integration.rb

@@ -0,0 +1,34 @@
+module Mixpal
+  module Integration
+    extend ActiveSupport::Concern
+
+    included do
+      helper_method :mixpanel
+      after_filter :store_mixpanel_if_redirecting
+
+      class_attribute :mixpanel_identity_data
+      def self.mixpanel_identity(object_method, attribute_method)
+        self.mixpanel_identity_data = {
+          object_method: object_method,
+          attribute_method: attribute_method,
+        }
+      end
+    end
+
+    def mixpanel
+      @mixpanel ||= begin
+        identity = if data = self.class.mixpanel_identity_data
+          send(data[:object_method]).try(data[:attribute_method])
+        end
+
+        Mixpal::Tracker.new(identity: identity)
+      end
+    end
+
+    private
+
+    def store_mixpanel_if_redirecting
+      mixpanel.store! if status == 302
+    end
+  end
+end

data/lib/mixpal/tracker.rb

@@ -0,0 +1,68 @@
+module Mixpal
+  class Tracker
+    attr_reader :events, :user_updates, :identity, :alias_user
+
+    STORAGE_KEY = "mixpal"
+    class_attribute :storage
+    self.storage = Rails.cache
+
+    def initialize(args={})
+      @events = []
+      @user_updates = []
+
+      restore!
+
+      @identity = args[:identity]
+    end
+
+    def register_user(properties)
+      @alias_user = true
+      update_user(properties)
+    end
+
+    def update_user(properties)
+      user_updates << Mixpal::User.new(properties)
+    end
+
+    def track(name, properties={})
+      events << Mixpal::Event.new(name, properties)
+    end
+
+    def render
+      "".tap do |html|
+        html << "<script type=\"text/javascript\">"
+        html << "mixpanel.alias(\"#{identity}\");" if alias_user
+        html << events.map(&:render).join("")
+        html << user_updates.map(&:render).join("")
+        html << "mixpanel.identify(\"#{identity}\");" if identity
+        html << "</script>"
+      end.html_safe
+    end
+
+    def store!
+      self.class.storage.write(STORAGE_KEY, to_store)
+    end
+
+    private
+
+    def restore!
+      data = self.class.storage.read(STORAGE_KEY) || {}
+
+      @alias_user = data[:alias_user]
+      @identity = data[:identity]
+      @events = data[:events].map { |e| Mixpal::Event.from_store(e) } if data[:events]
+      @user_updates = data[:user_updates].map { |u| Mixpal::User.from_store(u) } if data[:user_updates]
+
+      self.class.storage.delete(STORAGE_KEY)
+    end
+
+    def to_store
+      {
+        alias_user: @alias_user,
+        identity: identity,
+        events: events.map(&:to_store),
+        user_updates: user_updates.map(&:to_store),
+      }
+    end
+  end
+end

data/lib/mixpal/user.rb

@@ -0,0 +1,43 @@
+module Mixpal
+  class User
+    attr_reader :properties
+
+    def initialize(properties)
+      @properties = properties
+    end
+
+    def render
+      "mixpanel.people.set(#{properties_as_js_object_for_mixpanel});".html_safe
+    end
+
+    def to_store
+      {
+        properties: properties,
+      }
+    end
+
+    def self.from_store(data)
+      new(data[:properties])
+    end
+
+    private
+
+    def properties_as_js_object_for_mixpanel
+      Mixpal::Util.hash_to_js_object_string(properties_for_mixpanel)
+    end
+
+    # Isolate special properties and rename their keys to align with
+    # Mixpanel's naming.
+    def properties_for_mixpanel
+      Hash[properties.map {|k, v| [mixpanel_special_properties_map[k] || k, v] }]
+    end
+
+    def mixpanel_special_properties_map
+      {
+        name: "$name",
+        email: "$email",
+        created_at: "$created",
+      }.with_indifferent_access
+    end
+  end
+end

data/lib/mixpal/util.rb

@@ -0,0 +1,14 @@
+module Mixpal
+  module Util
+    class << self
+      def hash_to_js_object_string(hash)
+        contents = hash.map do |k,v|
+          js_value = v.is_a?(String) || v.is_a?(Time) ? "\"#{v}\"" : v
+          "\"#{k}\": #{js_value}"
+        end.join(",").html_safe
+
+        "{#{contents}}"
+      end
+    end
+  end
+end

data/lib/mixpal/version.rb

@@ -0,0 +1,3 @@
+module Mixpal
+  VERSION = "0.0.4"
+end

data/mixpanel_assistant.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mixpal/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mixpal"
+  spec.version       = Mixpal::VERSION
+  spec.authors       = ["patbenatar"]
+  spec.email         = ["nick@gophilosophie.com"]
+  spec.description   = "Use Mixpanel's JavaScript library from your backend with ease"
+  spec.summary       = "As the JavaScript library is Mixpanel's preferred method of usage, Mixpal aims to make it easier to work with from your Rails backend. Most notably it persists tracking data across redirects, perfect for handling events like user sign ups or form submissions."
+  spec.homepage      = "https://github.com/patbenatar/mixpal"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rspec", "~> 2.14.0"
+  spec.add_development_dependency "guard-rspec", "~> 3.0.3"
+  spec.add_development_dependency "rb-fsevent", "~> 0.9.3"
+  spec.add_development_dependency "awesome_print", "~> 1.1.0"
+  spec.add_development_dependency "nokogiri", "~> 1.6.0"
+
+  spec.add_development_dependency "actionpack", ">= 3.0"
+
+  spec.add_dependency "activesupport", ">= 3.0"
+end

data/spec/lib/mixpal/event_spec.rb

@@ -0,0 +1,48 @@
+require "spec_helper"
+
+describe Mixpal::Event do
+  let(:name) { "Event 1" }
+  let(:properties) { { title: "Awesome Product" } }
+  subject { described_class.new(name, properties) }
+
+  describe "#render" do
+    it "delegates to Util for js_object composition" do
+      Mixpal::Util.should_receive(:hash_to_js_object_string).with(properties)
+      subject.render
+    end
+
+    it "outputs a call to track" do
+      js_object = Mixpal::Util.hash_to_js_object_string(properties)
+      expect(subject.render).to eq "mixpanel.track(\"#{name}\", #{js_object});"
+    end
+
+    it "outputs an html safe string" do
+      expect(subject.render).to be_html_safe
+    end
+  end
+
+  describe "#to_store" do
+    it "returns a hash with its data" do
+      expect(subject.to_store).to eq(
+        name: name,
+        properties: properties,
+      )
+    end
+  end
+
+  describe ".from_store" do
+    let(:result) { described_class.from_store(name: name, properties: properties) }
+
+    it "instantiates a new instance" do
+      expect(result).to be_an_instance_of(described_class)
+    end
+
+    it "sets its name from the data" do
+      expect(result.name).to eq name
+    end
+
+    it "sets its properties from the data" do
+      expect(result.properties).to eq properties
+    end
+  end
+end

data/spec/lib/mixpal/tracker_spec.rb

@@ -0,0 +1,278 @@
+require "spec_helper"
+
+describe Mixpal::Tracker do
+  subject { Mixpal::Tracker.new }
+  let(:identity) { "nick" }
+  let(:subject_with_identity) { Mixpal::Tracker.new(identity: identity) }
+
+  describe "custom storage adapter" do
+    before do
+      @original_adapter = described_class.storage
+
+      MyCustomStorageAdapter = Class.new(MockStorage)
+      @adapter_instance = MyCustomStorageAdapter.new
+
+      described_class.storage = @adapter_instance
+    end
+
+    after { described_class.storage = @original_adapter }
+
+    it "uses the specified adapter" do
+      @adapter_instance.should_receive :write
+      subject.store!
+    end
+  end
+
+  describe "#initialize" do
+    it "creates an empty set of events" do
+      expect(subject.events).to eq []
+    end
+
+    it "creates an empty set of user_updates" do
+      expect(subject.user_updates).to eq []
+    end
+
+    context "with an :identity arg" do
+      subject { subject_with_identity }
+
+      it "sets the identity" do
+        expect(subject.identity).to eq "nick"
+      end
+    end
+
+    context "when data exists in storage" do
+      let(:old_tracker) { Mixpal::Tracker.new(identity: identity) }
+
+      before do
+        old_tracker.track "Event 1"
+        old_tracker.register_user name: "Nick Giancola"
+        old_tracker.store!
+      end
+
+      it "restores the alias_user property" do
+        expect(subject.alias_user).to eq true
+      end
+
+      it "restores the events" do
+        expect(subject.events.size).to eq 1
+      end
+
+      it "delegates event restoration to the Event class" do
+        Mixpal::Event.should_receive(:from_store).
+          with(old_tracker.events.first.to_store)
+
+        subject
+      end
+
+      it "restores the events" do
+        expect(subject.events.size).to eq 1
+      end
+
+      context "when initialized with an identity" do
+        subject { Mixpal::Tracker.new(identity: "Franky") }
+
+        it "overrides anything from storage" do
+          expect(subject.identity).to eq "Franky"
+        end
+      end
+    end
+  end
+
+  describe "#register_user" do
+    it "sets the alias_user flag so we render the alias call" do
+      subject.register_user(name: "Nick")
+      expect(subject.alias_user).to be_true
+    end
+
+    it "delegates to #update_user for tracking user properties" do
+      properties = { name: "Nick" }
+      subject.should_receive(:update_user).with(properties)
+      subject.register_user(properties)
+    end
+  end
+
+  describe "#update_user" do
+    it "instantiates a new User object with properties" do
+      properties = { name: "Nick" }
+      Mixpal::User.should_receive(:new).with(properties)
+      subject.update_user(properties)
+    end
+
+    it "adds the User to user_updates for rendering later" do
+      expect do
+        subject.update_user(name: "Nick")
+      end.to change(subject.user_updates, :size).by(1)
+
+      subject.user_updates.first.should be_an_instance_of(Mixpal::User)
+    end
+  end
+
+  describe "#track" do
+    it "instantiates a new Event object with properties" do
+      name = "Clicked Button"
+      properties = { color: "Green" }
+
+      Mixpal::Event.should_receive(:new).with(name, properties)
+      subject.track(name, properties)
+    end
+
+    it "adds the Event to events for rendering later" do
+      expect do
+        subject.track("Clicked Button", color: "Green")
+      end.to change(subject.events, :size).by(1)
+
+      subject.events.first.should be_an_instance_of(Mixpal::Event)
+    end
+  end
+
+  describe "#render" do
+    it "outputs script tag" do
+      expect(subject.render).to have_tag("script")
+    end
+
+    it "outputs an html safe string" do
+      expect(subject.render).to be_html_safe
+    end
+
+    context "with an identity" do
+      subject { subject_with_identity }
+
+      it "outputs call to identify" do
+        expect(subject.render).to include "mixpanel.identify(\"#{identity}\");"
+      end
+
+      context "when user is being registered" do
+        before { subject.register_user({ name: "Nick Giancola" }) }
+
+        it "outputs call to alias by identity" do
+          expect(subject.render).to include "mixpanel.alias(\"#{identity}\");"
+        end
+      end
+    end
+
+    context "with no registered user" do
+      it "does not output call to alias" do
+        expect(subject.render).not_to include "mixpanel.alias"
+      end
+    end
+
+    context "without an identity" do
+      it "does not output call to identify" do
+        expect(subject.render).not_to include "mixpanel.indentify"
+      end
+    end
+
+    context "with tracked events" do
+      before do
+        subject.track("Event 1", { color: "Green" })
+        subject.track("Event 2", { title: "Something Awesome" })
+      end
+
+      it "delegates render to the events" do
+        subject.events.each { |event| event.should_receive :render }
+        subject.render
+      end
+
+      it "joins each rendered event" do
+        joined = subject.events[0].render + subject.events[1].render
+        expect(subject.render).to include joined
+      end
+    end
+
+    context "with user properties" do
+      before do
+        subject.update_user({ name: "Hank" })
+        subject.update_user({ location: "Los Angeles" })
+      end
+
+      it "delegates render to the users" do
+        subject.user_updates.each { |user| user.should_receive :render }
+        subject.render
+      end
+
+      it "joins each rendered user" do
+        joined = subject.user_updates[0].render + subject.user_updates[1].render
+        expect(subject.render).to include joined
+      end
+    end
+  end
+
+  describe "#store!" do
+    let(:storage) { described_class::storage }
+
+    after { MockRails.cache.delete(described_class::STORAGE_KEY) }
+
+    def storage_should_include(hash_fragment)
+      storage.should_receive(:write).with(
+        described_class::STORAGE_KEY,
+        hash_including(hash_fragment)
+      )
+    end
+
+    it "writes to the storage adapter" do
+      storage.should_receive(:write)
+      subject.store!
+    end
+
+    context "when alias_user is set" do
+      before { subject.register_user({}) }
+
+      it "stores the alias_user property" do
+        storage_should_include(alias_user: true)
+        subject.store!
+      end
+    end
+
+    context "when identity is set" do
+      subject { subject_with_identity }
+
+      it "stores the identity" do
+        storage_should_include(identity: identity)
+        subject.store!
+      end
+    end
+
+    context "when events have been tracked" do
+      before do
+        subject.track("Event 1", { color: "Green" })
+        subject.track("Event 2", { title: "Something Awesome" })
+      end
+
+      it "delegates composition to the events" do
+        subject.events.each { |event| event.should_receive :to_store }
+        subject.store!
+      end
+
+      it "stores the events' composed hashes in an array" do
+        storage_should_include(
+          events: [subject.events[0].to_store, subject.events[1].to_store]
+        )
+
+        subject.store!
+      end
+    end
+
+    context "when user properties have been updated" do
+      before do
+        subject.update_user({ name: "Hank" })
+        subject.update_user({ location: "Los Angeles" })
+      end
+
+      it "delegates composition to the users" do
+        subject.user_updates.each { |user| user.should_receive :to_store }
+        subject.store!
+      end
+
+      it "stores the users' composed hashes in an array" do
+        storage_should_include(
+          user_updates: [
+            subject.user_updates[0].to_store,
+            subject.user_updates[1].to_store
+          ]
+        )
+
+        subject.store!
+      end
+    end
+  end
+end

data/spec/lib/mixpal/user_spec.rb

@@ -0,0 +1,73 @@
+require "spec_helper"
+
+describe Mixpal::User do
+  let(:properties) { { random_property: "Hansel", another_random_one: "So Hot Right Now" } }
+  let(:subject) { described_class.new(properties) }
+
+  describe "#render" do
+    it "delegates to Util for js_object composition" do
+      Mixpal::Util.should_receive(:hash_to_js_object_string).with(properties)
+      subject.render
+    end
+
+    it "outputs a call to people.set" do
+      js_object = Mixpal::Util.hash_to_js_object_string(properties)
+      expect(subject.render).to eq "mixpanel.people.set(#{js_object});"
+    end
+
+    it "outputs an html safe string" do
+      expect(subject.render).to be_html_safe
+    end
+
+    context "with Mixpanel special properties" do
+      let(:properties) do
+        {
+          name: "Nick Giancola",
+          email: "nick@gophilosophie.com",
+          created_at: Time.now,
+          random_property: "Hansel",
+        }
+      end
+
+      it "converts name => $name" do
+        expect(subject.render).to include "\"$name\""
+        expect(subject.render).not_to include "\"name\""
+      end
+
+      it "converts email => $email" do
+        expect(subject.render).to include "\"$email\""
+        expect(subject.render).not_to include "\"email\""
+      end
+
+      it "converts created_at => $created" do
+        expect(subject.render).to include "\"$created\""
+        expect(subject.render).not_to include "\"created_at\""
+      end
+
+      it "leaves other properties untouched" do
+        expect(subject.render).to include "\"random_property\""
+        expect(subject.render).not_to include "\"$random_property\""
+      end
+    end
+  end
+
+  describe "#to_store" do
+    it "returns a hash with its data" do
+      expect(subject.to_store).to eq(
+        properties: properties,
+      )
+    end
+  end
+
+  describe "#from_store" do
+    let(:result) { described_class.from_store(properties: properties) }
+
+    it "instantiates a new instance" do
+      expect(result).to be_an_instance_of(described_class)
+    end
+
+    it "sets its properties from the data" do
+      expect(result.properties).to eq properties
+    end
+  end
+end

data/spec/lib/mixpal/util_spec.rb

@@ -0,0 +1,22 @@
+require "spec_helper"
+
+describe Mixpal::Util do
+  subject { described_class }
+
+  describe ".hash_to_js_object_string" do
+    it "converts a ruby hash to a string representation of a javascript object" do
+      expect(subject.hash_to_js_object_string({key: "value", another: "more value"})).
+        to eq "{\"key\": \"value\",\"another\": \"more value\"}"
+    end
+
+    it "leaves Booleans intact to be interpreted as JS Boolean" do
+      expect(subject.hash_to_js_object_string({ is_cool: true })).
+        to eq "{\"is_cool\": true}"
+    end
+
+    it "leaves Fixnums intact to be interpreted as JS Numbers" do
+      expect(subject.hash_to_js_object_string({ age: 21 })).
+        to eq "{\"age\": 21}"
+    end
+  end
+end

data/spec/lib/mixpal_spec.rb

@@ -0,0 +1,4 @@
+require "spec_helper"
+
+describe Mixpal do
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require "bundler"
+Bundler.require
+
+require "mixpal"
+
+Dir["./spec/support/**/*.rb"].each {|f| require f }
+
+Rails = MockRails
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

data/spec/support/matchers/element_matchers.rb

@@ -0,0 +1,15 @@
+require "nokogiri"
+
+RSpec::Matchers.define :have_tag do |tag|
+  match do |string|
+    document = Nokogiri::HTML(string.to_s)
+    !!document.at_css(tag)
+  end
+end
+
+RSpec::Matchers.define :have_xpath do |tag|
+  match do |string|
+    document = Nokogiri::HTML(string.to_s)
+    !!document.at_xpath(tag)
+  end
+end

data/spec/support/mock_rails.rb

@@ -0,0 +1,6 @@
+require File.expand_path("spec/support/mock_storage")
+
+class MockRails
+  class_attribute :cache
+  self.cache = MockStorage.new
+end

data/spec/support/mock_storage.rb

@@ -0,0 +1,19 @@
+class MockStorage
+  attr_reader :data
+
+  def initialize
+    @data = {}
+  end
+
+  def write(key, value)
+    data[key] = value
+  end
+
+  def read(key)
+    data[key]
+  end
+
+  def delete(key)
+    !!data.delete(key)
+  end
+end

metadata

@@ -0,0 +1,248 @@
+--- !ruby/object:Gem::Specification
+name: mixpal
+version: !ruby/object:Gem::Version
+  prerelease: 
+  version: 0.0.4
+platform: ruby
+authors:
+- patbenatar
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: bundler
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: rake
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: pry
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: rspec
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.0
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.0
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: guard-rspec
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.3
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.3
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: rb-fsevent
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.3
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.3
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: awesome_print
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: nokogiri
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: actionpack
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  name: activesupport
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    none: false
+description: Use Mixpanel's JavaScript library from your backend with ease
+email:
+- nick@gophilosophie.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/mixpal.rb
+- lib/mixpal/event.rb
+- lib/mixpal/integration.rb
+- lib/mixpal/tracker.rb
+- lib/mixpal/user.rb
+- lib/mixpal/util.rb
+- lib/mixpal/version.rb
+- mixpanel_assistant.gemspec
+- spec/lib/mixpal/event_spec.rb
+- spec/lib/mixpal/tracker_spec.rb
+- spec/lib/mixpal/user_spec.rb
+- spec/lib/mixpal/util_spec.rb
+- spec/lib/mixpal_spec.rb
+- spec/spec_helper.rb
+- spec/support/matchers/element_matchers.rb
+- spec/support/mock_rails.rb
+- spec/support/mock_storage.rb
+homepage: https://github.com/patbenatar/mixpal
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      segments:
+      - 0
+      hash: 4327721075013694130
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      segments:
+      - 0
+      hash: 4327721075013694130
+      version: '0'
+  none: false
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: As the JavaScript library is Mixpanel's preferred method of usage, Mixpal
+  aims to make it easier to work with from your Rails backend. Most notably it persists
+  tracking data across redirects, perfect for handling events like user sign ups or
+  form submissions.
+test_files:
+- spec/lib/mixpal/event_spec.rb
+- spec/lib/mixpal/tracker_spec.rb
+- spec/lib/mixpal/user_spec.rb
+- spec/lib/mixpal/util_spec.rb
+- spec/lib/mixpal_spec.rb
+- spec/spec_helper.rb
+- spec/support/matchers/element_matchers.rb
+- spec/support/mock_rails.rb
+- spec/support/mock_storage.rb