untied-consumer-sync 0.0.1

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 1.8.7

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Redu Educational Technologies
+
+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,100 @@
+# Untied::Consumer::Sync
+
+Process the messages comming from your [Untied::Publisher](https://github.com/redu/untied-publisher) and syncs it directly to the database.
+
+**Build status**
+
+[![Build Status](https://travis-ci.org/redu/untied-consumer-sync.png?branch=master)](https://travis-ci.org/redu/untied-consumer-sync)
+
+## Instalation
+
+Add this line to your Gemfile:
+```ruby
+gem 'untied-consumer-sync'
+```
+
+Execute bundle:
+```
+$ bundle
+```
+
+Or install it yourself:
+```
+$ gem install untied-consumer-sync
+```
+
+## Usage
+
+You will need to mark which model should be syncronized and what attributes you are interested in. So let's see how to do it.
+
+Mark your model as a Zombie, so it can be created without all necessary attributes, but to the application it will be as if it does not even exist. When another Untied message completes this Zombie, it will not be a Zombie anymore and your application can count with it.
+
+**Why this Zombie thing?** It's a good option to syncronize associated models, because Untied does not guarantee the messages order, so you could have an invalid reference (and you don't want it, so zombificate your models!).
+
+```ruby
+class User < ActiveRecord::Base
+  include Untied::Consumer::Sync::Zombificator::ActsAsZombie
+end
+```
+
+The next step is specify which attributes you want to store for each model in your application. To do so you need to create a yml file and say to `Untied::Consumer::Sync` where it can find this.
+
+Say to `Untied::Consumer::Sync` where the file is:
+
+```ruby
+Untied::Consumer::Sync.configure do |config|
+  config.model_data = "#{Rails.root}/config/model_data.yml"
+end
+# Sets ActiveRecord as backend
+Untied::Consumer::Sync.backend = :active_record
+```
+
+Inform the attributes:
+
+```yml
+User: # Payload's type
+  attributes: # Needed attributes
+    - id
+    - login
+    - first_name
+    - last_name
+  mappings:
+    id: core_id # Maps payload's id key to model's core_id column
+  name: User # Model name
+```
+
+To know more about the options you can add to this yml, checkout this [wiki article](http://).
+
+**Note:** If a `destroy` message comes before the `create` one for the entity, the `destoy` message will be ignored.
+
+## What need to be done?
+
+- Test Zombificator::ActsAsZombie
+- Test Backend::Base
+- Update only the changed attributes in `after_update`
+- Limit which callbacks should be listened per model
+- Snake case on the yml
+- Enable `check_for` to accept more than one attribute for one entity
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+<img src="https://github.com/downloads/redu/redupy/redutech-marca.png" alt="Redu Educational Technologies" width="300">
+
+This project is maintained and funded by [Redu Educational Techologies](http://tech.redu.com.br).
+
+# Copyright
+
+Copyright (c) 2012 Redu Educational Technologies
+
+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/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/untied-consumer-sync.rb

@@ -0,0 +1,55 @@
+require "untied-consumer-sync/version"
+require "untied-consumer-sync/config"
+require "untied-consumer-sync/payload_proccessor"
+require "untied-consumer-sync/observer_helper"
+require "untied-consumer-sync/zombificator"
+require "untied-consumer-sync/untied_general_observer"
+require "untied-consumer-sync/backend/base"
+
+module Untied
+  module Consumer
+    module Sync
+      def self.config
+        @config ||= Config.new
+      end
+
+      # Configures untied-publisher. The options are defined at
+      # lib/untied-consumer-sync/config.rb
+      def self.configure(&block)
+        yield(config) if block_given?
+
+        if config.model_data.blank?
+          raise "Configure where your yml file is."
+        end
+
+        self.init_untied
+      end
+
+      # Loads model data structure
+      def self.model_data
+        @model_data ||= YAML.load_file(Sync.config.model_data)
+      end
+
+      # Initializes Untied Consumer
+      def self.init_untied
+        Untied::Consumer.configure do |config_untied|
+          config_untied.observers = [UntiedGeneralObserver]
+        end
+      end
+
+      # Sets the backend that will be used
+      def self.backend=(backend)
+        if backend.is_a? Symbol
+          require "untied-consumer-sync-#{backend.to_s.gsub('_', '')}/backend/#{backend}"
+          backend = "#{Sync}::Backend::#{backend.to_s.classify}::ModelHelper".
+            constantize
+        end
+        @@backend = backend
+      end
+
+      def self.backend
+        @@backend
+      end
+    end
+  end
+end

data/lib/untied-consumer-sync/backend/backend_shared_example.rb

@@ -0,0 +1,103 @@
+shared_examples_for 'a untied-consumer-sync backend' do
+  let(:subject) { described_class.new(user_config) }
+  let(:user_payload) { { 'my_id'=> 22, 'login' => 'sexy_jedi_3000',
+                 'name' => 'Luke Skywalker' } }
+  let(:user_config) do
+    {
+      'attributes' => ['login', 'name', 'id'],
+      'mappings' => { 'id' => 'my_id' },
+      'name' => 'User'
+    }
+  end
+
+  after do
+    User.delete_all
+  end
+
+  describe '#find' do
+    context 'when user does not exist yet' do
+      it 'should not find object if it doesnt exist' do
+        subject.find(3333).should be_nil
+      end
+    end
+
+    context 'when user exists' do
+      before do
+        User.create do |u|
+          u.my_id = 1
+          u.login = 'luke'
+        end
+      end
+
+      it 'should find object by id' do
+        subject.find(1).should_not be_nil
+      end
+    end
+  end
+
+  describe '#create_zombie' do
+    it 'should create zombie user' do
+      subject.create_zombie(99)
+      User.unscoped.where(:my_id => 99).should exist
+      User.unscoped.where(:my_id => 99).first.should be_zombie
+    end
+  end
+
+  describe '#create_model' do
+    context "with valid payload" do
+      context "when user does not exist yet" do
+        it 'should create user' do
+          subject.create_model(user_payload)
+          User.where(:my_id => user_payload['my_id']).should exist
+        end
+      end
+
+      context "when user exists" do
+        before do
+          User.unscoped.new(:my_id => user_payload['my_id']).
+            save(:validate => false)
+        end
+
+        it 'should update zombie user' do
+          subject.create_model(user_payload)
+          User.where(:my_id => user_payload['my_id']).first.should be_valid
+        end
+      end
+    end
+  end
+
+  describe '#update_model' do
+    context 'when user does not exist yet' do
+      it 'should create user' do
+        subject.update_model(user_payload)
+        User.where(:my_id => user_payload['my_id']).should exist
+      end
+    end
+
+    context 'when user exists' do
+      before do
+        User.unscoped.new(:my_id => user_payload['my_id']).
+          save(:validate => false)
+      end
+
+      it 'should update user on database' do
+        subject.update_model(user_payload)
+        User.where(:my_id => user_payload['my_id']).first.should be_valid
+      end
+    end
+  end
+
+  describe '#destroy_model' do
+    context 'when user exists' do
+      before do
+        User.unscoped.new(:my_id => user_payload['my_id']).
+          save(:validate => false)
+      end
+
+      it 'should delete from database' do
+        subject.destroy_model(user_payload)
+        User.where(:my_id => user_payload['my_id']).should_not exist
+      end
+    end
+  end
+end

data/lib/untied-consumer-sync/backend/base.rb

@@ -0,0 +1,87 @@
+module Untied
+  module Consumer
+    module Sync
+      module Backend
+        module Base
+          @@instances = {}
+
+          def self.included(base)
+            base.extend ClassMethods
+          end
+
+          # Public: Lida com a manipulação dos modelos através de payloads.
+          def initialize(model_data)
+            @model = model_data['name'].constantize
+            @model_data = model_data
+          end
+
+          # Public: Cria um modelo zumbie temporário.
+          #
+          # id - Inteiro que indentifica o objeto de acordo com a configuração
+          #
+          # Retorna o modelo recém criado.
+          def create_zombie(id)
+            zombie = @model.unscoped.new do |z|
+              z.send("#{ @model_data['mappings']['id'] }=", id)
+            end
+            zombie.save(:validate => false)
+
+            zombie
+          end
+
+          # Public: Cria o modelo se o mesmo não existir no banco de dados.
+          #
+          # payload - Hash com os dados a serem inseridos.
+          #
+          # Retorna True se a operação for bem sucedida e False no caso contrário.
+          def create_model(payload)
+            temp_model = (find(payload[@model_data['mappings']['id']]) or
+                           @model.unscoped.new)
+
+            # Seta os atributos
+            payload.each_pair { |key, value| temp_model.send("#{key.to_s}=", value) } if temp_model.zombie
+
+            temp_model.save
+          end
+
+          # Public: Atualiza o modelo ou o cria se o mesmo não existir no banco.
+          #
+          # payload - Hash com os dados a serem inseridos.
+          #
+          # Retorna True se a operação for bem sucedida e False no caso contrário.
+          def update_model(payload)
+            temp_model = (find(payload[@model_data['mappings']['id']]) or
+                           @model.unscoped.new)
+            payload.each_pair {|key, value| temp_model.send("#{key.to_s}=", value)}
+
+            temp_model.save
+          end
+
+          # Public: Destroi o modelo se o mesmo não existir no banco de dados.
+          #
+          # payload - Hash com os dados do modelo.
+          #
+          # Retorna True se a operação for bem sucedida e False no caso contrário.
+          def destroy_model(payload)
+            temp_model = find(payload[@model_data['mappings']['id']])
+
+            temp_model.destroy if temp_model
+          end
+
+          module ClassMethods
+            def self.new(*args, &block)
+              old_instance = @@instances[args[0]['name']]
+              return old_instance if old_instance
+
+              obj = ModelHelper.allocate
+              obj.send(:initialize, *args, &block)
+              @@instances[args[0]['name']] = obj
+
+              obj
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/untied-consumer-sync/config.rb

@@ -0,0 +1,18 @@
+# -*- encoding : utf-8 -*-
+require 'configurable'
+
+module Untied
+ module Consumer
+   module Sync
+     class Config
+       include Configurable
+
+       # Config file with models (and its attributes) that will be sync
+       config :model_data, ""
+       # Publisher's identifier so Sync know where to listen.
+       # Default: untied_publisher
+       config :service_name, 'untied_publisher'
+     end
+   end
+ end
+end

data/lib/untied-consumer-sync/observer_helper.rb

@@ -0,0 +1,136 @@
+require 'untied-consumer'
+
+module Untied
+  module Consumer
+    module Sync
+      class ObserverHelper < Untied::Consumer::Observer
+        # Public:  Helper que lida com a logica de manipulção de modelos para o untied.
+        # Observer do untied podem herdar dessa classe para adicionar os callbacks.
+
+        # Public: Metódo proxy que abstrai a complexidade real do create.
+        #
+        # kind - String com o nome do modelo.
+        # payload - Hash com os dados para a criação do modelo.
+        #
+        # Retorna True se a operação foi realizada com sucesso e False no caso
+        # contrário.
+        def create_proxy(kind, payload)
+          call_method("create", kind, payload)
+        end
+
+        # Public: Metódo proxy que abstrai a complexidade real do update.
+        #
+        # kind - String com o nome do modelo.
+        # payload - Hash com os dados para a criação do modelo.
+        #
+        # Retorna True se a operação foi realizada com sucesso e False no caso
+        # contrário.
+        def update_proxy(kind, payload)
+          call_method("update", kind, payload)
+        end
+
+        # Public: Metódo proxy que abstrai a complexidade real do destroy.
+        #
+        # kind - String com o nome do modelo.
+        # payload - Hash com os dados para a criação do modelo.
+        #
+        # Retorna True se a operação foi realizada com sucesso e False no caso.
+        # contrário.
+        def destroy_proxy(kind, payload)
+          call_method("destroy", kind, payload)
+        end
+
+        # Public: Metódo para facilitar o acesso as configurações
+        #
+        # Retorna um Hash com as configurações dos modelos
+        def config
+          Sync.model_data
+        end
+
+        protected
+
+        # Protected: Metodo auxiliar usado pelos proxies, codigo comum ao update, create
+        # e destroy.
+        #
+        # method - String com o nome do metódo a ser chamado: create, update ou destroy.
+        # kind - String com o nome do modelo.
+        # payload - Hash com os dados para a criação do modelo.
+        #
+        # Retorna o True se a operação foi realizada com sucesso e False no caso
+        # contrário.
+        def call_method(method, kind, payload)
+          model_data = config.fetch(kind.classify) {|k| raise "Kind #{k} not found in model_data.yml"}
+          model_helper = Sync.backend.new(model_data)
+          payload_proccessor = PayloadProccessor.new(model_data)
+          new_payload = payload_proccessor.proccess(payload) #Remove dados inuteis
+
+          self.send(method, new_payload, model_helper, payload_proccessor)
+        end
+
+        # Protected: Metódo que cria o modelo.
+        #
+        # payload - Hash com os dados para a criação do modelo.
+        # model_helper - ModelHelper que lida com  a criação de modelos usando a payload.
+        # payload_proccessor - PayloadProccessor que adequa a payload remota ao banco
+        # local.
+        #
+        # Retorna True se a operação foi realizada com sucesso e False no caso.
+        # contrário.
+        def create(payload, model_helper, payload_proccessor)
+          new_payload = create_dep(payload, payload_proccessor)
+
+          model_helper.create_model(new_payload)
+        end
+
+        # Protected: Metódo que atauliza o modelo.
+        #
+        # payload - Hash com os dados para a criação do modelo.
+        # model_helper - ModelHelper que lida com  a criação de modelos usando a payload.
+        # payload_proccessor - PayloadProccessor que adequa a payload remota ao banco
+        # local.
+        #
+        # Retorna True se a operação foi realizada com sucesso e False no caso.
+        # contrário.
+        def update(payload, model_helper, payload_proccessor)
+          new_payload = create_dep(payload, payload_proccessor)
+
+          model_helper.update_model(new_payload)
+        end
+
+        # Protected: Metódo que destroi o modelo.
+        #
+        # payload - Hash com os dados para a criação do modelo.
+        # model_helper - ModelHelper que lida com  a criação de modelos usando a payload.
+        # payload_proccessor - PayloadProccessor que adequa a payload remota ao banco
+        # local.
+        #
+        # Retorna True se a operação foi realizada com sucesso e False no caso.
+        # contrário.
+        def destroy(payload, model_helper, payload_proccessor)
+          model_helper.destroy_model(payload)
+        end
+
+        # Protected: Gera as dependencias para o modelo em questão, cria modelos zombies
+        # se for necesário e traduz as referencias presentes no payload para
+        # referencias locais.
+        #
+        # payload - Hash com os dados para a criação do modelo.
+        # payload_proccessor - PayloadProccessor que adequa a payload remota ao banco
+        # local.
+        #
+        # Retorna um Hash que representa a payload com as dependencias traduzidas
+        def create_dep(payload, payload_proccessor)
+          new_payload = payload.clone
+          payload_proccessor.dependencies.each do |key, value|
+            id = payload[value]
+            aux_helper = Sync.backend.new(config[key.classify])
+            modelo = (aux_helper.find(id) or aux_helper.create_zombie(id))
+            new_payload.merge!(value => modelo.id)
+          end
+
+          new_payload
+        end
+      end
+    end
+  end
+end

data/lib/untied-consumer-sync/payload_proccessor.rb

@@ -0,0 +1,72 @@
+module Untied
+  module Consumer
+    module Sync
+      class PayloadProccessor
+        # Public: Traduz payload recebido via Untied de acordo com os atributos e
+        # mapeamentos do config/model_data.yml.
+
+        @@instances = {}
+
+        def initialize(model_data)
+          @model_data = model_data
+        end
+
+        # Public: Faz o processamento geral da payload
+        #
+        # payload - Hash com os dados do modelo
+        #
+        # Retorna um novo Hash com os dados processados
+        def proccess(payload)
+          new_payload = slice_useless_attrs(payload)
+
+          map_attrs(new_payload)
+        end
+
+        # Public: Metódo de conveniencia para checar as dependencias
+        #
+        # Retorna um Array com as dependencias presentes na configuração do modelo
+        def dependencies
+          @model_data.fetch('check_for', [])
+        end
+
+        def self.new(*args, &block)
+          old_instance = @@instances[args[0]['name']]
+          return old_instance if old_instance
+
+          obj = PayloadProccessor.allocate
+          obj.send(:initialize, *args, &block)
+          @@instances[args[0]['name']] = obj
+          obj
+        end
+
+        protected
+
+        # Protected: Faz mapeamento de atributos
+        #
+        # payload - Hash com os dados do modelo
+        #
+        # Retorna um novo Hash com os atributos mapeados
+        def map_attrs(payload)
+          mappings = @model_data.fetch('mappings', {})
+
+          mappings.each do |k, v|
+            payload.merge!(v => payload.delete(k))
+          end
+
+          payload
+        end
+
+        # Protected: Remove atributos irrelevantes
+        #
+        # payload - Hash com os dados do modelo
+        #
+        # Retorna um novo Hash só com os atributos relevantes
+        def slice_useless_attrs(payload)
+          payload.reject do |key, value|
+            !@model_data['attributes'].include?(key)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/untied-consumer-sync/untied_general_observer.rb

@@ -0,0 +1,31 @@
+module Untied
+  module Consumer
+    module Sync
+      # Observes all entities listed on config file
+      class UntiedGeneralObserver < ObserverHelper
+        def initialize
+          super
+
+          elements = self.config.values.collect {|v| v['name'].underscore.to_sym }
+          args = elements << {:from => Sync.config.service_name }
+          self.class.observe(*args)
+        end
+
+        def after_create(payload)
+          kind = payload.keys[0]
+          self.create_proxy(kind, payload.values[0])
+        end
+
+        def after_update(payload)
+          kind = payload.keys[0]
+          self.update_proxy(kind, payload.values[0])
+        end
+
+        def after_destroy(payload)
+          kind = payload.keys[0]
+          self.destroy_proxy(kind, payload.values[0])
+        end
+      end
+    end
+  end
+end

data/lib/untied-consumer-sync/version.rb

@@ -0,0 +1,7 @@
+module Untied
+  module Consumer
+    module Sync
+      VERSION = "0.0.1"
+    end
+  end
+end

data/lib/untied-consumer-sync/zombificator.rb

@@ -0,0 +1,23 @@
+module Untied
+  module Consumer
+    module Sync
+      module Zombificator
+        module ActsAsZombie
+          # Modulo que adiciona suporte a modelos zombies. Se um modelo for criado sem validação
+          # ele automaticamente é marcado como zombie, caso a validação seja feita,
+          # o modelo perde essa tag se não ocorrer nenhum erro.
+          extend ActiveSupport::Concern
+
+          included do
+            attr_accessible :zombie
+
+            # Modelos zombies não devem aparecer em consultas normais.
+            default_scope where(:zombie => false)
+
+            after_validation { self.zombie = false if self.errors.empty? }
+          end
+        end
+      end
+    end
+  end
+end

data/spec/observer_helper_spec.rb

@@ -0,0 +1,124 @@
+require 'spec_helper'
+
+module Untied::Consumer::Sync
+  describe ObserverHelper do
+    let(:subject){ ObserverHelper.instance }
+
+    after do
+      User.delete_all
+    end
+
+    context "#create_proxy" do
+      context "with a complete (valid) User" do
+        let(:user) { { 'id' => 1, 'login' => 'sexy_jedi_3000',
+                       'name' => 'Luke Skywalker', :thingy => false } }
+
+        it 'should return true' do
+          subject.create_proxy("user", user).should == true
+        end
+
+        it "should add user to database" do
+          expect{
+            subject.create_proxy("user", user)
+          }.to change(User, :count).by(1)
+        end
+      end
+
+      context "with, for now, invalid references" do
+        let(:toy) { { 'id' => 1, 'user_id' => 1 } }
+
+        it 'should return true' do
+          subject.create_proxy("toy", toy).should == true
+        end
+
+        it "should add toy to database" do
+          expect{
+            subject.create_proxy("toy", toy)
+          }.to change(Toy, :count).by(1)
+        end
+
+        it "creates zombie entity for user_id" do
+          subject.create_proxy("toy", toy)
+          User.unscoped.find_by_my_id(toy['user_id']).should_not be_nil
+        end
+
+        after do
+          Toy.delete_all
+        end
+      end
+
+      context "with a invalid User" do
+        let(:invalid_user) { { 'id' => 1 } }
+
+        it "should return false" do
+          subject.create_proxy("user", invalid_user).should be_false
+        end
+
+        it "shouldn't add user to database" do
+          expect{
+            subject.create_proxy("user", invalid_user)
+          }.to_not change(User, :count)
+        end
+      end
+
+      context "with a existent User zombie" do
+        before do
+          @user_zombie = User.unscoped.new(:my_id => 1)
+          @user_zombie.save(:validate => false)
+        end
+        let(:user) { { 'id' => 1, 'login' => 'sexy_jedi_3000',
+                       'name' => 'Luke Skywalker' } }
+
+        it 'should return true' do
+          subject.create_proxy("user", user).should be_true
+        end
+
+        it 'should complete User zombie' do
+          subject.create_proxy("user", user)
+          @user_zombie.reload
+          @user_zombie.login.should == user['login']
+          @user_zombie.name.should == user['name']
+        end
+      end
+    end
+
+    context "#update_proxy" do
+      let(:updated_user) { { 'id' => 1, 'login' => 'sexy_jedi_3000',
+                             'name' => 'Luke Vader' } }
+      before do
+        @user = User.create(:my_id => 1, :login => "sexy_jedi_3000",
+                            :name => "Luke Skywalker")
+      end
+
+      it "should return true" do
+        subject.update_proxy("user", updated_user).should be_true
+      end
+
+      it "should update user on database" do
+        subject.update_proxy("user", updated_user)
+        @user.reload
+        @user.name.should == updated_user['name']
+      end
+    end
+
+    context "#destroy_proxy" do
+      let(:destroyed_user) { { 'id' => 1, 'login' => 'sexy_jedi_3000',
+                             'name' => 'Luke Skywalker' } }
+      before do
+        @user = User.create(:my_id => 1, :login => "sexy_jedi_3000",
+                            :name => "Luke Skywalker")
+      end
+
+      it "should return true" do
+        subject.destroy_proxy("user", destroyed_user).should be_true
+      end
+
+      it "should erase user from database" do
+        subject.destroy_proxy("user", destroyed_user)
+        expect {
+          @user.reload
+        }.to raise_error
+      end
+    end
+  end
+end

data/spec/payload_proccessor_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+module Untied::Consumer::Sync
+  describe PayloadProccessor do
+    let(:subject) { PayloadProccessor.new(config) }
+    let(:config) { Untied::Consumer::Sync.model_data['User'] }
+
+    describe 'proccess' do
+      let(:payload) {{"id"=> 22, 'login' => 'sexy_jedi_3000',
+        'name' => 'Luke Skywalker','thingy' => 'aaaa', 'useless_thing' => 2}}
+
+      it 'should translate mappings' do
+        new_load = subject.proccess(payload)
+        new_load.fetch("my_id", nil).should == payload["id"]
+      end
+
+      it 'should remove useless data' do
+        new_load = subject.proccess(payload)
+        new_load.fetch("useless_thing", nil).should be_nil
+      end
+
+      context "when there are no mappings" do
+        let(:subject) do
+          new_config = config.clone
+          new_config.delete(:mappings)
+
+          PayloadProccessor.new(new_config)
+        end
+
+        it "should not raise error" do
+          expect {
+            subject.proccess(payload)
+          }.to_not raise_error
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'untied-consumer-sync'
+require 'support/setup_ar_and_schema'
+require 'untied-consumer-sync/backend/backend_shared_example'
+
+RSpec.configure do |config|
+
+  Untied::Consumer::Sync.configure do |c|
+    c.model_data = "spec/support/model_data.yml"
+    c.service_name = "my_service"
+  end
+  Untied::Consumer::Sync.backend = :active_record
+
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

data/spec/support/model_data.yml

@@ -0,0 +1,18 @@
+User:
+  attributes:
+    - login
+    - name
+    - id
+  mappings:
+    id:  my_id
+  name: User
+
+Toy:
+  attributes:
+    - user_id
+    - id
+  mappings:
+    id: my_id
+  check_for:
+    User: user_id
+  name: Toy

data/spec/support/setup_ar_and_schema.rb

@@ -0,0 +1,39 @@
+# -*- encoding : utf-8 -*-
+require 'active_record'
+
+module SetupActiveRecord
+  # Connection
+  ar_config = { :test => { :adapter => 'sqlite3', :database => ":memory:" } }
+  ActiveRecord::Base.configurations = ar_config
+  ActiveRecord::Base.
+    establish_connection(ActiveRecord::Base.configurations[:test])
+
+  # Schema
+  ActiveRecord::Schema.define do
+    create_table :users, :force => true do |t|
+      t.string :my_id
+      t.string :login
+      t.string :name
+      t.boolean :zombie, :default => true
+      t.timestamps
+    end
+    create_table :toys, :force => true do |t|
+      t.string :my_id
+      t.integer :user_id
+      t.boolean :zombie, :default => true
+      t.timestamps
+    end
+  end
+
+  # Models
+  class ::User < ActiveRecord::Base
+    include Untied::Consumer::Sync::Zombificator::ActsAsZombie
+    attr_accessible :my_id, :login, :name
+
+    validates_presence_of :login
+  end
+  class ::Toy < ActiveRecord::Base
+    include Untied::Consumer::Sync::Zombificator::ActsAsZombie
+    attr_accessible :my_id, :user_id
+  end
+end

data/spec/sync_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+module Untied::Consumer
+  describe Sync do
+    describe '.configure' do
+      it 'calls init_untied' do
+        Sync.should_receive(:init_untied)
+        Sync.configure
+      end
+    end
+
+    describe '.model_data' do
+      it 'returns the read yml' do
+        Sync.model_data.should == {
+                                     'User' => {
+                                       'attributes' => ['login', 'name', 'id'],
+                                       'mappings' => { 'id' => 'my_id' },
+                                       'name' => 'User'
+                                     },
+                                     'Toy' => {
+                                       'attributes' => ['user_id', 'id'],
+                                       'mappings' => { 'id' => 'my_id' },
+                                       'check_for' => { 'User' => 'user_id' },
+                                       'name' => 'Toy'
+                                     },
+                                  }
+      end
+    end
+
+    describe '.backend=' do
+      before do
+        Sync.backend = nil
+      end
+
+      after do
+        Sync.backend = :active_record
+      end
+
+      let(:klass) { Class.new }
+
+      it 'sets backend to klass' do
+        Sync.backend = klass
+        Sync.backend.should == klass
+      end
+
+      it 'sets backend using symbol' do
+        Sync.backend = :active_record
+        Sync.backend.to_s.should == "#{Sync}::Backend::ActiveRecord" \
+          "::ModelHelper"
+      end
+    end
+  end
+end

data/spec/untied-consumer-sync-activerecord/backend/active_record.rb

@@ -0,0 +1,26 @@
+require "untied-consumer-sync"
+
+module Untied
+  module Consumer
+    module Sync
+      module Backend
+        module ActiveRecord
+          class ModelHelper
+            include Sync::Backend::Base
+
+            # Public: Procura o modelo pelo id.
+            #
+            # id - Inteiro que indentifica o objeto de acordo a configuração.
+            #
+            # Retorna o caso o modelo seja encontrado ou nil caso o modelo não exista
+            # no banco.
+            def find(id)
+              # Unscoped para encontrar zombies
+              @model.unscoped.send("find_by_#{@model_data['mappings']['id']}", id)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/untied_general_observer_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+module Untied::Consumer::Sync
+  describe UntiedGeneralObserver do
+    let(:subject) { UntiedGeneralObserver.instance }
+
+    describe ".initialize" do
+      before do
+        subject
+      end
+
+      # Observed classes defined at spec/support/model_data.yml
+      it "should define observed classes" do
+        subject.observed_classes.to_set.should == [:toy, :user].to_set
+      end
+
+      # Observed service name defined at spec_helper
+      it "should define observed service" do
+        subject.observed_service.should == :my_service
+      end
+    end
+
+    describe "#after_create" do
+      it "should call create_proxy with kind and payload" do
+        subject.should_receive(:create_proxy).with('user', { 'id' => 1})
+        subject.after_create({ 'user' => { 'id' => 1} })
+      end
+    end
+
+    describe "#after_update" do
+      it "should call update_proxy with kind and payload" do
+        subject.should_receive(:update_proxy).with('user', { 'id' => 1})
+        subject.after_update({ 'user' => { 'id' => 1} })
+      end
+    end
+
+    describe "#after_destroy" do
+      it "should call destroy_proxy with kind and payload" do
+        subject.should_receive(:destroy_proxy).with('user', { 'id' => 1})
+        subject.after_destroy({ 'user' => { 'id' => 1} })
+      end
+    end
+  end
+end

data/untied-consumer-sync.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'untied-consumer-sync/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "untied-consumer-sync"
+  gem.version       = Untied::Consumer::Sync::VERSION
+  gem.authors       = ["Igor Calabria", "Guilherme Cavalcanti", "Tiago Ferreira", "Juliana Lucena"]
+  gem.email         = ["igor.calabria@gmail.com", "guiocavalcanti@gmail.com", "fltiago@gmail.com", "julianalucenaa@gmail.com"]
+  gem.description   = %q{Untied Consumer Synchronizer.}
+  gem.summary       = %q{Process the messages comming from your Untied::Publisher and syncs it directly to the database.}
+  gem.homepage      = "http://github.com/redu/untied-consumer-sync"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(spec)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'sqlite3'
+  gem.add_development_dependency 'activerecord'
+
+  gem.add_runtime_dependency 'untied-consumer', '~> 0.0.5'
+  gem.add_runtime_dependency 'configurable'
+
+  if RUBY_VERSION < "1.9"
+    gem.add_development_dependency "ruby-debug"
+  else
+    gem.add_development_dependency "debugger"
+  end
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification 
+name: untied-consumer-sync
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Igor Calabria
+- Guilherme Cavalcanti
+- Tiago Ferreira
+- Juliana Lucena
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-01-03 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: sqlite3
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: untied-consumer
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 0
+        - 0
+        - 5
+        version: 0.0.5
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: configurable
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id007
+description: Untied Consumer Synchronizer.
+email: 
+- igor.calabria@gmail.com
+- guiocavalcanti@gmail.com
+- fltiago@gmail.com
+- julianalucenaa@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/untied-consumer-sync.rb
+- lib/untied-consumer-sync/backend/backend_shared_example.rb
+- lib/untied-consumer-sync/backend/base.rb
+- lib/untied-consumer-sync/config.rb
+- lib/untied-consumer-sync/observer_helper.rb
+- lib/untied-consumer-sync/payload_proccessor.rb
+- lib/untied-consumer-sync/untied_general_observer.rb
+- lib/untied-consumer-sync/version.rb
+- lib/untied-consumer-sync/zombificator.rb
+- spec/observer_helper_spec.rb
+- spec/payload_proccessor_spec.rb
+- spec/spec_helper.rb
+- spec/support/model_data.yml
+- spec/support/setup_ar_and_schema.rb
+- spec/sync_spec.rb
+- spec/untied-consumer-sync-activerecord/backend/active_record.rb
+- spec/untied_general_observer_spec.rb
+- untied-consumer-sync.gemspec
+homepage: http://github.com/redu/untied-consumer-sync
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Process the messages comming from your Untied::Publisher and syncs it directly to the database.
+test_files: 
+- spec/observer_helper_spec.rb
+- spec/payload_proccessor_spec.rb
+- spec/spec_helper.rb
+- spec/support/model_data.yml
+- spec/support/setup_ar_and_schema.rb
+- spec/sync_spec.rb
+- spec/untied-consumer-sync-activerecord/backend/active_record.rb
+- spec/untied_general_observer_spec.rb