killbill-zendesk 0.1.0

data/.gitignore

@@ -0,0 +1,38 @@
+*.gem
+*.rbc
+*.swp
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+
+.jbundler
+Jarfile.lock
+Gemfile.lock
+
+.DS_Store
+
+# Build directory
+killbill-zendesk/
+
+# Config file
+zendesk.yml
+
+target
+pom.xml.asc
+
+.idea/
+
+test.db

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Jarfile

@@ -0,0 +1,3 @@
+jar 'com.ning.billing:killbill-api', '0.1.80'
+jar 'com.ning.billing:killbill-util:tests', '0.1.80'
+jar 'javax.servlet:javax.servlet-api', '3.0.1'

data/README.md

@@ -0,0 +1,71 @@
+killbill-zendesk-plugin
+=======================
+
+Plugin to mirror Kill Bill data into Zendesk.
+
+User data mapping
+-----------------
+
+<table>
+  <tr>
+    <th>Zendesk attribute</th><th>Value</th>
+  </tr>
+  <tr>
+    <td>name</td><td><em>Kill Bill account name</em></td>
+  </tr>
+  <tr>
+    <td>external_id</td><td><em>Kill Bill account external key</em> if specified, <em>Kill Bill account id</em> otherwise</td>
+  </tr>
+  <tr>
+    <td>locale</td><td><em>Kill Bill account locale</em></td>
+  </tr>
+  <tr>
+    <td>time_zone</td><td><em>Kill Bill account timezone</em></td>
+  </tr>
+  <tr>
+    <td>email</td><td><em>Kill Bill account email</em></td>
+  </tr>
+  <tr>
+    <td>phone</td><td><em>Kill Bill account phone</em></td>
+  </tr>
+  <tr>
+    <td>details</td><td><em>Kill Bill account address1</em>, <em>Kill Bill account address2</em>, <em>Kill Bill account city</em>, <em>Kill Bill account state or province</em>, <em>Kill Bill account postal code</em>, <em>Kill Bill account country</em></td>
+  </tr>
+</table>
+
+
+Requirements
+------------
+
+The plugin needs a database to keep a local mapping between Kill Bill account ids and Zendesk user ids (this is to work around indexing delays in Zendesk). The latest version of the schema can be found here: https://raw.github.com/killbill/killbill-zendesk-plugin/master/db/ddl.sql.
+
+
+Configuration
+-------------
+
+The plugin expects a `zendesk.yml` configuration file containing the following:
+
+```
+:zendesk:
+  :subdomain: 'mysubdomain'
+  :username: 'email@domain.com'
+  :password: 'password'
+# Alternatively, to use Token Authentication or OAuth
+#token: 'kX53RIXZKUFhZxSYhRxe7QGFocTkDmmERDxpcddF' 
+#access_token: 'kX53RIXZKUFhZxSYhRxe7QGFocTkDmmERDxpcddF'
+# Optional
+#  :retry: true
+
+:database:
+  :adapter: 'sqlite3'
+  :database: 'test.db'
+# For MySQL
+#  :adapter: 'jdbc'
+#  :username: 'your-username'
+#  :password: 'your-password'
+#  :driver: 'com.mysql.jdbc.Driver'
+#  :url: 'jdbc:mysql://127.0.0.1:3306/your-database'
+```
+
+By default, the plugin will look at the plugin directory root (where `killbill.properties` is located) to find this file.
+Alternatively, set the Kill Bill system property `-Dcom.ning.billing.osgi.bundles.jruby.conf.dir=/my/directory` to specify another location.

data/Rakefile

@@ -0,0 +1,30 @@
+#!/usr/bin/env rake
+
+# Install tasks to build and release the plugin
+require 'bundler/setup'
+Bundler::GemHelper.install_tasks
+
+# Install test tasks
+require 'rspec/core/rake_task'
+namespace :test do
+  desc 'Run RSpec tests'
+  RSpec::Core::RakeTask.new do |task|
+    task.name = 'spec'
+    task.pattern = './spec/*/*_spec.rb'
+  end
+
+  namespace :remote do
+    desc 'Run RSpec remote tests'
+    RSpec::Core::RakeTask.new do |task|
+      task.name = 'spec'
+      task.pattern = './spec/*/remote/*_spec.rb'
+    end
+  end
+end
+
+# Install tasks to package the plugin for Killbill
+require 'killbill/rake_task'
+Killbill::PluginHelper.install_tasks
+
+# Run tests by default
+task :default => 'test:spec'

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/config.ru

@@ -0,0 +1,4 @@
+require 'zendesk'
+require 'zendesk/config/application'
+
+run Sinatra::Application

data/db/ddl.sql

@@ -0,0 +1,10 @@
+CREATE TABLE `zendesk_users` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `kb_account_id` varchar(255) NOT NULL,
+  `zd_user_id` int(11) NOT NULL,
+  `created_at` datetime NOT NULL,
+  `updated_at` datetime NOT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `index_zendesk_users_on_kb_account_id` (`kb_account_id`),
+  UNIQUE KEY `index_zendesk_users_on_zd_user_id` (`zd_user_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8;

data/db/schema.rb

@@ -0,0 +1,13 @@
+require 'active_record'
+
+ActiveRecord::Schema.define(:version => 20130606153635) do
+  create_table 'zendesk_users', :force => true do |t|
+    t.string 'kb_account_id', :null => false
+    t.integer 'zd_user_id', :null => false
+    t.datetime 'created_at', :null => false
+    t.datetime 'updated_at', :null => false
+  end
+
+  add_index(:zendesk_users, :kb_account_id, :unique => true)
+  add_index(:zendesk_users, :zd_user_id, :unique => true)
+end

data/killbill-zendesk.gemspec

@@ -0,0 +1,41 @@
+version = File.read(File.expand_path('../VERSION', __FILE__)).strip
+
+Gem::Specification.new do |s|
+  s.name        = 'killbill-zendesk'
+  s.version     = version
+  s.summary     = 'Plugin to mirror Kill Bill data into Zendesk'
+  s.description = 'Kill Bill notification plugin for Zendesk.'
+
+  s.required_ruby_version = '>= 1.9.3'
+
+  s.license = 'Apache License (2.0)'
+
+  s.author   = 'Kill Bill core team'
+  s.email    = 'killbilling-users@googlegroups.com'
+  s.homepage = 'http://kill-bill.org'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.bindir        = 'bin'
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.rdoc_options << '--exclude' << '.'
+
+  s.add_dependency 'killbill', '~> 1.0.19'
+  s.add_dependency 'sinatra', '~> 1.3.4'
+  s.add_dependency 'zendesk_api', '~> 0.3.10'
+  s.add_dependency 'activerecord', '~> 3.2.1'
+  if defined?(JRUBY_VERSION)
+    s.add_dependency 'activerecord-jdbcmysql-adapter', '~> 1.2.9'
+  end
+
+  s.add_development_dependency 'jbundler', '~> 0.4.1'
+  s.add_development_dependency 'rake', '>= 10.0.0'
+  s.add_development_dependency 'rspec', '~> 2.12.0'
+  if defined?(JRUBY_VERSION)
+    s.add_development_dependency 'activerecord-jdbcsqlite3-adapter', '~> 1.2.6'
+  else
+    s.add_development_dependency 'sqlite3', '~> 1.3.7'
+  end
+end

data/killbill.properties

@@ -0,0 +1,3 @@
+mainClass=Killbill::Zendesk::ZendeskPlugin
+require=zendesk
+pluginType=NOTIFICATION

data/lib/zendesk/config/application.rb

@@ -0,0 +1,36 @@
+configure do
+  # Usage: rackup -Ilib -E test
+  if (development? or test?) and !Killbill::Zendesk::UserUpdaterInitializer.instance.initialized?
+    require 'logger'
+    Killbill::Zendesk::UserUpdaterInitializer.instance.initialize! File.expand_path(File.dirname(__FILE__) + '../../../../'),
+                                                                   nil,
+                                                                   Logger.new(STDOUT)
+  end
+end
+
+# curl -v -d'webrick=stupid' -XPUT http://127.0.0.1:9292/plugins/killbill-zendesk/users/6939c8c0-cf89-11e2-8b8b-0800200c9a66
+put '/plugins/killbill-zendesk/users/:id' do
+  zendesk_user_url = Killbill::Zendesk::UserUpdaterInitializer.instance.updater.update(params[:id])
+
+  if zendesk_user_url
+    redirect zendesk_user_url
+  else
+    status 500, "Unable to update Zendesk user for id #{params[:id]}"
+  end
+end
+
+# curl -v http://127.0.0.1:9292/plugins/killbill-zendesk/users/6939c8c0-cf89-11e2-8b8b-0800200c9a66
+# Given a Kill Bill account id or Zendesk user id, retrieve the Kill Bill - Zendesk mapping
+get '/plugins/killbill-zendesk/users/:id', :provides => 'json' do
+  if params[:id] =~ /[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}/
+    mapping = Killbill::Zendesk::ZendeskUser.find_by_kb_account_id(params[:id])
+  else
+    mapping = Killbill::Zendesk::ZendeskUser.find_by_zd_user_id(params[:id])
+  end
+
+  if mapping
+    mapping.to_json
+  else
+    status 404
+  end
+end

data/lib/zendesk/user_updater.rb

@@ -0,0 +1,115 @@
+module Killbill::Zendesk
+  class UserUpdater
+    def initialize(client, kb_apis, logger)
+      @client = client
+      @kb_apis = kb_apis
+      @logger = logger
+    end
+
+    def update(lookup_key)
+      kb_account = lookup_kb_account(lookup_key)
+
+      user = find_by_kb_account(kb_account)
+      user = create_user(kb_account) if user.nil?
+
+      user.name = kb_account.name
+      user.external_id = kb_account.external_key || kb_account.id.to_s
+      user.locale = kb_account.locale
+      user.timezone = kb_account.time_zone
+      user.email = kb_account.email
+      user.phone = kb_account.phone
+      user.details = build_details_field(kb_account)
+
+      if user.save
+        @logger.info "Successfully updated #{user.name} in Zendesk: #{user.url}"
+        user.url
+      else
+        @logger.warn "Unable to update #{user.name} in Zendesk: #{user.url}"
+        nil
+      end
+    end
+
+    # Find the Kill Bill account associated with that lookup_key (account id or external key)
+    def lookup_kb_account(lookup_key)
+      if lookup_key.is_a?(Killbill::Plugin::Model::UUID)
+        @kb_apis.get_account_by_id(lookup_key)
+      else
+        lookup_key_s = lookup_key.to_s
+        if lookup_key_s =~ /[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}/
+          lookup_kb_account(Killbill::Plugin::Model::UUID.new(lookup_key_s))
+        else
+          @kb_apis.get_account_by_key(lookup_key_s)
+        end
+      end
+    end
+
+    # Build the Zendesk details field (address information)
+    def build_details_field(kb_account)
+      details = [kb_account.address1, kb_account.address2, kb_account.city, kb_account.state_or_province, kb_account.postal_code, kb_account.country]
+      (details.reject { |detail| detail.blank? }).join(', ')
+    end
+
+    # Create a user in Zendesk and save the id mapping locally
+    def create_user(kb_account)
+      # Create the user in Zendesk
+      user = @client.users.create(:name => kb_account.name)
+
+      # Save the mapping locally - this is required due to the indexing lag on the Zendesk side,
+      # see https://support.zendesk.com/entries/20239737:
+      #   When you add new data to your Zendesk, it typically takes about 2 to 3 minutes before it's indexed and can be searched.
+      # This is unacceptable for us: if an account creation event is quickly followed by a account update event,
+      # we wouldn't be able to retrieve the user, potentially causing duplicates and/or triggering validation errors, e.g.
+      #   Email 1370587241-test@tester.com is already being used by another user
+      ZendeskUser.create! :kb_account_id => kb_account.id.to_s, :zd_user_id => user.id
+
+      user
+    end
+
+    # Find the Zendesk user associated with that Kill Bill account
+    def find_by_kb_account(kb_account)
+      # Do we have already a mapping for that user?
+      zd_account = find_by_id(kb_account.id.to_s)
+      return zd_account if zd_account
+
+      # TODO In the search results below, should we worry about potential dups?
+
+      # First search by external_id, which is the safest method.
+      # The external_id is either the account external key...
+      zd_account = find_by_external_id(kb_account.external_key) if kb_account.external_key
+      return zd_account if zd_account
+
+      # ...or the Kill Bill account id
+      zd_account = find_by_external_id(kb_account.id.to_s)
+      return zd_account if zd_account
+
+      # At this point, we haven't matched this user yet. To reconcile it, use the email address which is guaranteed
+      # to exist on the Zendesk side
+      zd_account = find_by_email(kb_account.email) if kb_account.email
+      return zd_account if zd_account
+
+      # We couldn't find a match - the account will be created
+      nil
+    end
+
+    def find_by_id(kb_account_id)
+      zd_user = ZendeskUser.find_by_kb_account_id(kb_account_id)
+      zd_user ? @client.users.find(:id => zd_user.zd_user_id) : nil
+    end
+
+    def find_by_external_id(external_id)
+      find_all_by_external_id(external_id).first
+    end
+
+    def find_all_by_external_id(external_id)
+      @client.search(:query => "type:user external_id:#{external_id}", :reload => true)
+    end
+
+    def find_by_email(email)
+      find_all_by_email(email).first
+    end
+
+    def find_all_by_email(email)
+      @client.search(:query => "type:user email:#{email}", :reload => true)
+    end
+  end
+end

data/lib/zendesk/user_updater_initializer.rb

@@ -0,0 +1,44 @@
+module Killbill::Zendesk
+  class UserUpdaterInitializer
+    include Singleton
+
+    attr_reader :updater
+
+    def initialize!(conf_dir, kb_apis, logger)
+      # Parse the config file
+      begin
+        @config = YAML.load_file("#{conf_dir}/zendesk.yml")
+      rescue Errno::ENOENT
+        logger.warn "Unable to find the config file #{conf_dir}/zendesk.yml"
+        return
+      end
+
+      client = ZendeskAPI::Client.new do |config|
+        config.url = "https://#{@config[:zendesk][:subdomain]}.zendesk.com/api/v2"
+
+        config.username = @config[:zendesk][:username]
+        config.password = @config[:zendesk][:password]
+        config.token = @config[:zendesk][:token]
+        # Not yet available?
+        #config.access_token = @config[:zendesk][:access_token]
+        config.retry = true if @config[:zendesk][:retry]
+
+        config.logger = logger
+      end
+
+      if defined?(JRUBY_VERSION)
+        # See https://github.com/jruby/activerecord-jdbc-adapter/issues/302
+        require 'jdbc/mysql'
+        Jdbc::MySQL.load_driver(:require) if Jdbc::MySQL.respond_to?(:load_driver)
+      end
+
+      ActiveRecord::Base.establish_connection(@config[:database])
+
+      @updater = UserUpdater.new(client, kb_apis, logger)
+    end
+
+    def initialized?
+      !@updater.nil?
+    end
+  end
+end

data/lib/zendesk/zendesk_user.rb

@@ -0,0 +1,6 @@
+module Killbill::Zendesk
+  class ZendeskUser < ActiveRecord::Base
+    attr_accessible :kb_account_id,
+                    :zd_user_id
+  end
+end

data/lib/zendesk.rb

@@ -0,0 +1,26 @@
+require 'active_record'
+require 'sinatra'
+
+require 'killbill'
+require 'zendesk_api'
+
+require 'zendesk/zendesk_user'
+require 'zendesk/user_updater'
+require 'zendesk/user_updater_initializer'
+
+module Killbill::Zendesk
+  class ZendeskPlugin < Killbill::Plugin::Notification
+
+    # For testing
+    attr_reader :updater
+
+    def start_plugin
+      super
+      @updater = Killbill::Zendesk::UserUpdaterInitializer.instance.initialize!(@conf_dir, @kb_apis, @logger)
+    end
+
+    def on_event(event)
+      @updater.update(event.account_id) if [:ACCOUNT_CREATION, :ACCOUNT_CHANGE].include?(event.event_type.enum)
+    end
+  end
+end

data/pom.xml

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+~ Copyright 2010-2013 Ning, Inc.
+~
+~  Ning licenses this file to you under the Apache License, version 2.0
+~  (the "License"); you may not use this file except in compliance with the
+~  License.  You may obtain a copy of the License at:
+~
+~     http://www.apache.org/licenses/LICENSE-2.0
+~
+~  Unless required by applicable law or agreed to in writing, software
+~  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+~  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+~  License for the specific language governing permissions and limitations
+~  under the License.
+-->
+
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>org.sonatype.oss</groupId>
+        <artifactId>oss-parent</artifactId>
+        <version>5</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>com.ning.killbill.ruby</groupId>
+    <artifactId>zendesk-plugin</artifactId>
+    <packaging>pom</packaging>
+    <version>0.1.0</version>
+    <name>zendesk-plugin</name>
+    <url>http://github.com/killbill/killbill-zendesk-plugin</url>
+    <description>Plugin to mirror Kill Bill data into Zendesk</description>
+    <licenses>
+        <license>
+            <name>Apache License 2.0</name>
+            <url>http://www.apache.org/licenses/LICENSE-2.0.html</url>
+            <distribution>repo</distribution>
+        </license>
+    </licenses>
+    <scm>
+        <connection>scm:git:git://github.com/killbill/killbill-zendesk-plugin.git</connection>
+        <url>https://github.com/killbill/killbill-zendesk-plugin/</url>
+        <developerConnection>scm:git:git@github.com:killbill/killbill-zendesk-plugin.git</developerConnection>
+    </scm>
+</project>

data/release.sh

@@ -0,0 +1,28 @@
+set -e
+
+VERSION=`grep -E '<version>([0-9]+\.[0-9]+\.[0-9]+)</version>' pom.xml | sed 's/[\t \n]*<version>\(.*\)<\/version>[\t \n]*/\1/'`
+if [ "$VERSION" != "$(cat $PWD/VERSION)" ]; then
+  echo "Unable to release: make sure the versions in pom.xml and VERSION match"
+  exit 1
+fi
+
+echo "Cleaning up"
+rake killbill:clean ; rake build
+
+echo "Pushing the gem to Rubygems"
+rake release
+
+echo "Building artifact"
+rake killbill:package
+
+ARTIFACT="$PWD/pkg/killbill-zendesk-$VERSION.tar.gz"
+echo "Pushing $ARTIFACT to Maven Central"
+mvn gpg:sign-and-deploy-file \
+    -DgroupId=com.ning.killbill.ruby \
+    -DartifactId=zendesk-plugin \
+    -Dversion=$VERSION \
+    -Dpackaging=tar.gz \
+    -DrepositoryId=ossrh-releases \
+    -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ \
+    -Dfile=$ARTIFACT \
+    -DpomFile=pom.xml

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'bundler'
+require 'zendesk'
+
+require 'logger'
+
+require 'rspec'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+  config.tty = true
+  config.formatter = 'documentation'
+end
+
+require 'active_record'
+ActiveRecord::Base.establish_connection(
+    :adapter => 'sqlite3',
+    :database => 'test.db'
+)
+# Create the schema
+require File.expand_path(File.dirname(__FILE__) + '../../db/schema.rb')

data/spec/zendesk/remote/integration_spec.rb

@@ -0,0 +1,86 @@
+require 'spec_helper'
+
+class KillbillApiWithFakeGetAccountById < Killbill::Plugin::KillbillApi
+  def initialize(*args)
+    super(*args)
+    @accounts = {}
+  end
+
+  def create_account(id, external_key, name, email)
+    @accounts[id.to_s] = Killbill::Plugin::Model::Account.new(id, nil, nil, nil, external_key, name, 1, email, 1, 'USD', nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, false, true)
+  end
+
+  def get_account_by_id(id)
+    @accounts[id.to_s]
+  end
+end
+
+class MockEvent
+  attr_reader :event_type
+  attr_reader :account_id
+
+  def initialize(event_type, account_id)
+    @event_type = event_type
+    @account_id = account_id
+  end
+end
+
+describe Killbill::Zendesk::ZendeskPlugin do
+  before(:each) do
+    @plugin = Killbill::Zendesk::ZendeskPlugin.new
+    @plugin.conf_dir = File.expand_path(File.dirname(__FILE__) + '../../../../')
+
+    logger = Logger.new(STDOUT)
+    logger.level = Logger::DEBUG
+    @plugin.logger = logger
+
+    @plugin.kb_apis = KillbillApiWithFakeGetAccountById.new(nil)
+
+    @plugin.start_plugin
+  end
+
+  after(:each) do
+    @plugin.stop_plugin
+  end
+
+  it 'should be able to create and update a user' do
+    external_key, kb_account_id = create_kb_account
+
+    # Verify the initial state of our table
+    Killbill::Zendesk::ZendeskUser.count.should == 0
+
+    # Verify the account doesn't exist yet
+    @plugin.updater.find_by_external_id(external_key).should be_nil
+
+    # Send a creation event
+    @plugin.on_event MockEvent.new(Killbill::Plugin::Model::ExtBusEventType.new(:ACCOUNT_CREATION), kb_account_id)
+
+    # We should now verify the account exists, but we can't, due to indexing lag :/
+    #@plugin.updater.find_by_external_id(external_key).email.should == email
+    # Instead, we use our table
+    Killbill::Zendesk::ZendeskUser.count.should == 1
+
+    # Send an update event
+    @plugin.on_event MockEvent.new(Killbill::Plugin::Model::ExtBusEventType.new(:ACCOUNT_CHANGE), kb_account_id)
+
+    # Verify we didn't create dups
+    #@plugin.updater.find_all_by_external_id(external_key).count.should == 1
+    Killbill::Zendesk::ZendeskUser.count.should == 1
+
+    # Create a new user
+    external_key, kb_account_id = create_kb_account
+    @plugin.on_event MockEvent.new(Killbill::Plugin::Model::ExtBusEventType.new(:ACCOUNT_CREATION), kb_account_id)
+
+    Killbill::Zendesk::ZendeskUser.count.should == 2
+  end
+
+  private
+
+  def create_kb_account
+    external_key = Time.now.to_i.to_s + '-test'
+    kb_account_id = Killbill::Plugin::Model::UUID.new(external_key)
+    email = external_key + '@tester.com'
+    @plugin.kb_apis.create_account(kb_account_id, external_key, 'Test tester', email)
+    return external_key, kb_account_id
+  end
+end

data/spec/zendesk/user_updater_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe Killbill::Zendesk::UserUpdater do
+  it 'should build the details line' do
+    updater = Killbill::Zendesk::UserUpdater.new(nil, nil, nil)
+
+    account = build_account(nil, nil, nil, nil, nil, nil)
+    updater.build_details_field(account).should == ''
+
+    account = build_account('493 Slro road', nil, nil, nil, nil, nil)
+    updater.build_details_field(account).should == '493 Slro road'
+
+    account = build_account('493 Slro road', nil, 'Fola', nil, nil, nil)
+    updater.build_details_field(account).should == '493 Slro road, Fola'
+
+    account = build_account('493 Slro road', nil, 'Fola', 'FG', nil, nil)
+    updater.build_details_field(account).should == '493 Slro road, Fola, FG'
+
+    account = build_account('493 Slro road', nil, 'Fola', 'FG', 140, nil)
+    updater.build_details_field(account).should == '493 Slro road, Fola, FG, 140'
+
+    account = build_account('493 Slro road', 'apt 33', 'Fola', 'FG', 140, nil)
+    updater.build_details_field(account).should == '493 Slro road, apt 33, Fola, FG, 140'
+
+    account = build_account('493 Slro road', 'apt 33', 'Fola', 'FG', 140, 'Floq')
+    updater.build_details_field(account).should == '493 Slro road, apt 33, Fola, FG, 140, Floq'
+  end
+
+  private
+
+  def build_account(address1, address2, city, state_or_province, postal_code, country)
+    Killbill::Plugin::Model::Account.new(nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, address1, address2, nil, city, state_or_province, postal_code, country, nil, nil, nil)
+  end
+end

metadata

@@ -0,0 +1,219 @@
+--- !ruby/object:Gem::Specification
+name: killbill-zendesk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease:
+platform: ruby
+authors:
+- Kill Bill core team
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2013-06-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: killbill
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.19
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.19
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: zendesk_api
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.10
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.10
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.1
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.1
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: activerecord-jdbcmysql-adapter
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: jbundler
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+    none: false
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  name: rake
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.0.0
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.0.0
+    none: false
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  name: rspec
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+    none: false
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  name: activerecord-jdbcsqlite3-adapter
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.6
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.6
+    none: false
+  prerelease: false
+  type: :development
+description: Kill Bill notification plugin for Zendesk.
+email: killbilling-users@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Jarfile
+- README.md
+- Rakefile
+- VERSION
+- config.ru
+- db/ddl.sql
+- db/schema.rb
+- killbill-zendesk.gemspec
+- killbill.properties
+- lib/zendesk.rb
+- lib/zendesk/config/application.rb
+- lib/zendesk/user_updater.rb
+- lib/zendesk/user_updater_initializer.rb
+- lib/zendesk/zendesk_user.rb
+- pom.xml
+- release.sh
+- spec/spec_helper.rb
+- spec/zendesk/remote/integration_spec.rb
+- spec/zendesk/user_updater_spec.rb
+homepage: http://kill-bill.org
+licenses:
+- Apache License (2.0)
+post_install_message:
+rdoc_options:
+- "--exclude"
+- "."
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      segments:
+      - 0
+      version: !binary |-
+        MA==
+      hash: 2
+  none: false
+requirements: []
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
+specification_version: 3
+summary: Plugin to mirror Kill Bill data into Zendesk
+test_files:
+- spec/spec_helper.rb
+- spec/zendesk/remote/integration_spec.rb
+- spec/zendesk/user_updater_spec.rb