async_service 0.1.4

data/.autotest

@@ -0,0 +1 @@
+require 'autotest/bundler'

data/.gitignore

@@ -0,0 +1,8 @@
+\vendor/
+.bundle/
+coverage/
+spec/reports
+*.log
+.yardoc
+*.gem
+Gemfile.lock

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--profile

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://gems.mobme.in"
+source :rubygems
+
+group :osx do
+  gem "growl"
+  gem 'rb-fsevent'
+end
+
+group :linux do
+  gem "rb-inotify"
+  gem "libnotify"
+end
+
+gemspec

data/Guardfile

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

data/README.md

@@ -0,0 +1,33 @@
+
+## Description
+
+AsyncService provides an abstraction for workers/daemons that processes work from a queue. Often an AsyncService::Worker will get work from a queue, process it and push the result back into another queue.
+
+You can also take a look at [SyncService](https://github.com/mobmewireless/sync_service) which provides abstractions for synchronous SOA.
+
+## Install
+
+    $ gem install async_service
+
+## Creating a Worker
+
+    class CalculatorMachine < AsyncService::Worker
+      # You need to set a service name
+      @service_name = 'in.mobme.calculator_machine'
+
+      # This function is called on run
+      def work
+        loop do
+          queue.remove("work_queue") do |item|
+            result = item[:a] + item[:b]
+
+            queue.add("result_queue", result)
+          end
+          sleep 5
+        end
+      end
+    end
+
+    calculator = CalculatorMachine.new
+    calculator.run
+

data/Rakefile

@@ -0,0 +1,41 @@
+require 'rspec/core/rake_task'
+require "rake/tasklib"
+require "flog"
+require 'ci/reporter/rake/rspec'
+
+RSpec::Core::RakeTask.new(:spec => ["ci:setup:rspec"]) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+task :default => :spec
+
+desc "Analyze for code complexity"
+task :flog do
+  flog = Flog.new
+  flog.flog [ "lib" ]
+  threshold = 10
+
+  bad_methods = flog.totals.select do | name, score |
+    name != "main#none" && score > threshold
+  end
+  bad_methods.sort do | a, b |
+    a[ 1 ] <=> b[ 1 ]
+  end.reverse.each do | name, score |
+    puts "%8.1f: %s" % [ score, name ]
+  end
+  unless bad_methods.empty?
+    raise "#{ bad_methods.size } methods have a flog complexity > #{ threshold }"
+  end
+end
+
+namespace :gem do
+  task :push do
+    puts "Building gem from gemspec..."
+    system("gem build *.gemspec")
+    puts "Pushing up gem to gems.mobme.in..."
+    system("scp -P 2200 *.gem mobme@gems.mobme.in:/home/mobme/public_html/gems.mobme.in/gems")
+    puts "Rebuilding index..."
+    system('ssh mobme@gems.mobme.in -p 2200 "cd /home/mobme/public_html/gems.mobme.in && /usr/local/rvm/bin/rvm 1.9.2 gem generate_index"')
+    puts "Done"
+  end
+end

data/async_service.gemspec

@@ -0,0 +1,35 @@
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+require 'mobme/infrastructure/service/version'
+
+Gem::Specification.new do |s|
+  s.name        = "async_service"
+  s.version     = AsyncService::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["MobME"]
+  s.email       = ["engineering@mobme.in"]
+  s.homepage    = "http://mobme.in/"
+  s.summary     = %q{AsyncService is a library to create asynchronous SOA daemons}
+  s.description = %q{The gem provides an abstraction for asynchronous workers that poll data from a queue and do work}
+  
+  s.required_rubygems_version = ">= 1.3.6"
+  
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "guard"
+  s.add_development_dependency "guard-rspec"
+  s.add_development_dependency "simplecov"
+  s.add_development_dependency "flog"
+  s.add_development_dependency "yard"
+  s.add_development_dependency "ci_reporter"
+  s.add_development_dependency "simplecov-rcov"
+  
+  s.add_dependency "hiredis", "~> 0.3.1"
+  s.add_dependency "redis", "~> 2.2.0"
+  s.add_dependency "true_queue", "~> 0.9"
+
+  s.files              = `git ls-files`.split("\n") - ["Gemfile.lock", ".rvmrc"]
+  s.test_files         = `git ls-files -- {spec}/*`.split("\n")
+  s.require_paths      = ["lib"]
+end

data/lib/async_service.rb

@@ -0,0 +1 @@
+require_relative "mobme/infrastructure/service"

data/lib/mobme/infrastructure/service.rb

@@ -0,0 +1,6 @@
+require 'logger'
+require 'true_queue'
+
+require 'mobme/infrastructure/service/version'
+require 'mobme/infrastructure/service/worker'
+

data/lib/mobme/infrastructure/service/version.rb

@@ -0,0 +1,10 @@
+module MobME
+  module Infrastructure
+    module Service
+      VERSION = "0.1.4"
+    end
+  end
+end
+
+# alias it!
+AsyncService = MobME::Infrastructure::Service

data/lib/mobme/infrastructure/service/worker.rb

@@ -0,0 +1,26 @@
+
+module MobME::Infrastructure::Service
+  class Worker
+    def self.service_name
+      @service_name
+    end
+    
+    def logger
+      @logger ||= Logger.new(STDOUT)
+    end
+    
+    def queue(type = :redis, options = {})      
+      TrueQueue.queue(type, options)
+    end
+
+    def run
+      begin
+        logger.info "Starting #{self.class}.."
+        work
+      rescue StandardError => e
+        logger.err(e.backtrace.unshift(e.inspect).join("\n"))
+        raise
+      end
+    end
+  end
+end

data/spec/mobme/infrastructure/service/worker_spec.rb

@@ -0,0 +1,74 @@
+require 'spec_helper'
+
+require 'async_service'
+
+class DummyWorker < AsyncService::Worker
+  @service_name = 'infrastructure-service-worker-dummy'
+end
+
+describe DummyWorker do
+  describe "class" do
+    it "should define a service name" do
+      DummyWorker.service_name.should_not be_nil
+    end
+  end
+
+  it { should respond_to(:queue) }
+  it { should respond_to(:queue).with(1).argument }
+
+  before(:each) do
+    @dummy_worker = DummyWorker.new
+  end
+
+  it "should log and re-raise any uncaught errors while running" do
+    dummy_worker = DummyWorker.new
+    dummy_worker.logger.should_receive(:err)
+    lambda { dummy_worker.run }.should raise_error
+  end
+
+  describe "#logger" do
+    let(:dummy_logger) { double Logger }
+
+    it "returns a logger instance" do
+      Logger.should_receive(:new).with(STDOUT).and_return(dummy_logger)
+      subject.logger
+    end
+
+    context "when called more than once" do
+      it "returns the same logger instance" do
+        Logger.stub(:new).and_return(dummy_logger)
+        subject.logger.should be dummy_logger
+        subject.logger.should be dummy_logger
+      end
+    end
+  end
+
+  describe "queue" do
+    let(:dummy_work_queue) { double('Queue').as_null_object }
+
+    before :each do
+      TrueQueue.stub!(:queue).and_return(dummy_work_queue)
+    end
+
+    it "should return a connected queue with a same name as the service_name" do
+      TrueQueue.should_receive(:queue).with(:redis, {}).and_return(dummy_work_queue)
+      @dummy_worker.queue
+    end
+
+    context "when options are passed" do
+      it "passes on the options to Queue.queue" do
+        options = double("Options", :empty? => false)
+        TrueQueue.should_receive(:queue).with(:redis, options)
+        @dummy_worker.queue(:redis, options)
+      end
+      
+      it "passes on the type to Queue.queue" do
+        TrueQueue.should_receive(:queue).with(:memory, {})
+        @dummy_worker.queue(:memory)
+      end
+    end
+  end
+end
+
+
+

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'simplecov'
+require 'simplecov-rcov'
+
+SimpleCov.formatter = SimpleCov::Formatter::RcovFormatter
+SimpleCov.start do 
+  add_filter 'vendor' 
+  add_filter 'spec'
+end if ENV["COVERAGE"]
+

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification
+name: async_service
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+  prerelease: 
+platform: ruby
+authors:
+- MobME
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70285336936780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336936780
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70285336936280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336936280
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: &70285336935840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336935840
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &70285336935400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336935400
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70285336934920 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336934920
+- !ruby/object:Gem::Dependency
+  name: flog
+  requirement: &70285336934480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336934480
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &70285336934000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336934000
+- !ruby/object:Gem::Dependency
+  name: ci_reporter
+  requirement: &70285336933540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336933540
+- !ruby/object:Gem::Dependency
+  name: simplecov-rcov
+  requirement: &70285336932940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70285336932940
+- !ruby/object:Gem::Dependency
+  name: hiredis
+  requirement: &70285336932160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *70285336932160
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: &70285336931520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70285336931520
+- !ruby/object:Gem::Dependency
+  name: true_queue
+  requirement: &70285336930840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70285336930840
+description: The gem provides an abstraction for asynchronous workers that poll data
+  from a queue and do work
+email:
+- engineering@mobme.in
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .autotest
+- .gitignore
+- .rspec
+- Gemfile
+- Guardfile
+- README.md
+- Rakefile
+- async_service.gemspec
+- lib/async_service.rb
+- lib/mobme/infrastructure/service.rb
+- lib/mobme/infrastructure/service/version.rb
+- lib/mobme/infrastructure/service/worker.rb
+- spec/mobme/infrastructure/service/worker_spec.rb
+- spec/spec_helper.rb
+homepage: http://mobme.in/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: AsyncService is a library to create asynchronous SOA daemons
+test_files: []