backgroundrb-rails3 1.1

data/.autotest

@@ -0,0 +1,17 @@
+class Autotest
+  def find_files
+    result = {}
+    Find.find '.' do |f|
+      Find.prune if @exceptions and f =~ @exceptions and test ?d, f
+
+      next if test ?d, f
+      next if f =~ /(swp|~|rej|orig|flymake)$/        # temporary/patch files
+      next if f =~ /\/\.?#/                     # Emacs autosave/cvs merge files
+
+      filename = f.sub(/^\.\//, '')
+
+      result[filename] = File.stat(filename).mtime rescue next
+    end
+    return result    
+  end
+end

data/ChangeLog

@@ -0,0 +1,50 @@
+2008-09-07  hemant kumar  <hemant@shire.com>
+
+        * Fix environment loading issues.
+
+        * Patch by Kieran P for disabling persistent job queue and its polling.
+
+        * Commit patch by P Baker, related to scheduling a persistent task at specified time. For example:
+        MiddleMan(:hello_worker).enq_some_task(:arg => "hello_world",
+                        :job_key => "boy",:scheduled_at => (Time.now + 1.hour))
+
+2008-06-19  hemant kumar  <hemant@shire.com>
+
+        * Make binary parser iterative and hence won't blow your stack
+
+        * Add run_concurrent
+
+        * Let parent sleep for a while when forking the bdrb master process.
+
+        * Fixed issue with fork. BackgrounDRb now uses fork and exec.
+
+2008-02-28  hemant kumar  <hemant@shire>
+
+        * fixed some meory leaks.
+
+        * Implemented cleaner API for invoking tasks in workers
+
+        * Updated the documentation
+
+2008-02-25  hemant kumar  <hemant@shire>
+
+        * Commited Patch by Alex which lets BackgrounDRb to have command line arguments and loading of specific environments
+        through command line argument.
+
+2008-02-14  hemant kumar  <hemant@shire>
+
+        * Added TestCases for Cron Triggers, Meta Workers and stuff. We are heading towards proper code coverage with specs.
+
+        * Added preliminary support for starting a worker on demand through scheduler. What it means is, when you have a worker which is getting
+        scheduled very less frequently and you don't want the worker to persist, you can ask BackgrounDRb to restart the worker on each schedule.
+
+        * Fixed some unreported issues with writing data to socket between workers and stuff.
+
+        * Fixed issues with too many open connections, because connections were not getting closed. BackgrounDRb now opens only one connection, which is
+        reused throughout the lifecycle of rails application.
+
+        * Fixed all outstanding issues with Cron triggers, BackgrounDRb now explicitly depends on "chronic" gem.
+
+        * Removed Framework directory and BackgrounDRb now explicitly depends on packet gem.
+
+

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+gem 'chronic', '>= 0.2.3'
+gem 'packet', '0.1.15'
+
+group :development do
+  gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.1"
+  gem "rcov", ">= 0"
+end

data/LICENSE

@@ -0,0 +1,4 @@
+Copyright (c) 2007 Hemant Kumar ( mail [at] gnufied [dot] org )
+Copyright (c) 2006 Ezra Zygmuntowicz and skaar[at]waste[dot]org
+
+The Library is dual licensed under terms of Ruby License or MIT License.

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Hemant Kumar ( mail [at] gnufied [dot] org )
+Copyright (c) 2006 Ezra Zygmuntowicz and skaar[at]waste[dot]org
+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

@@ -0,0 +1,22 @@
+= BackgrounDRb
+
+BackgrounDRb is a Ruby job server and scheduler. Its main intent is to be
+used with Ruby on Rails applications for offloading long-running tasks.
+Since a Rails application blocks while serving a request it is best to
+move long-running tasks off into a background process that is divorced
+from http request/response cycle.
+
+This new release of BackgrounDRb is also modular and can be used without Rails so that any Ruby program or framework can use it.
+
+Copyright (c) 2006 Ezra Zygmuntowicz,skaar[at]waste[dot]org,
+
+Copyright (c) 2007 Hemant Kumar (gethemant [at] gmail.com )
+
+
+== Usage
+
+Install using bundler via rubygems by adding gem 'backgroundrb-rails3' to your Gemfile
+
+and then look into http://backgroundrb.rubyforge.org for instructions (DISCLAIMER: documentation on rubyforge is for the Rails2 version of backgroundrb)
+
+Something else here.

data/Rakefile

@@ -0,0 +1,128 @@
+require 'rake'
+require 'rubygems'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+require 'rake/contrib/sshpublisher'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the backgroundrb plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/test_*.rb'
+  t.verbose = true
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new('specs') do |t|
+  t.spec_opts = ["--format", "specdoc"]
+  t.libs = ['lib', 'server/lib' ]
+  t.spec_files = FileList['specs/**/*_spec.rb']
+end
+
+desc "RCov"
+task :rcov do
+  sh("rcov test/**/*.rb")
+end
+
+desc 'Generate documentation for the backgroundrb plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'doc/output/manual'
+  rdoc.title    = 'Backgroundrb'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('LICENSE')
+  rdoc.rdoc_files.include('lib/*.rb')
+  rdoc.rdoc_files.include('lib/backgroundrb/*.rb')
+  rdoc.rdoc_files.include('server/*.rb')
+  rdoc.rdoc_files.include('server/lib/*.rb')
+  rdoc.template = 'jamis'
+end
+
+module Rake
+  class BackgrounDRbPublisher <  SshDirPublisher
+    attr_reader :project, :proj_id, :user
+    def initialize(projname, user)
+      super(
+            "#{user}@rubyforge.org",
+            "/var/www/gforge-projects/backgroundrb",
+            "doc/output")
+    end
+  end
+end
+
+desc "Publish documentation to Rubyforge"
+task :publish_rdoc => [:rdoc] do
+  user = ENV['RUBYFORGE_USER']
+  publisher = Rake::BackgrounDRbPublisher.new('backgroundrb', user)
+  publisher.upload
+end
+
+namespace :git do
+  def current_branch
+    branches = `git branch`
+    return branches.split("\n").detect {|x| x =~ /^\*/}.split(' ')[1]
+  end
+
+  desc "Push changes to central git repo"
+  task :push do
+    sh("git push origin master")
+  end
+
+  desc "update master branch"
+  task :up do
+    t_branch = current_branch
+    sh("git checkout master")
+    sh("git pull")
+    sh("git checkout #{t_branch}")
+  end
+
+  desc "rebase current branch to master"
+  task :rebase => [:up] do
+    sh("git rebase master")
+  end
+
+  desc "merge current branch to master"
+  task :merge => [:up] do
+    t_branch = current_branch
+    sh("git checkout master")
+    sh("git merge #{t_branch}")
+    sh("git checkout #{t_branch}")
+  end
+
+  desc "commot current branch"
+  task :commit => [:merge] do
+    t_branch = current_branch
+    sh("git checkout master")
+    sh("git push origin master")
+    sh("git checkout #{t_branch}")
+  end
+end
+
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "backgroundrb-rails3"
+  gem.homepage = "http://github.com/mtylty/backgroundrb-rails3"
+  gem.license = "MIT"
+  gem.summary = %Q{BackgrounDRb is a Ruby job server and scheduler.}
+  gem.description = %Q{
+    BackgrounDRb is a Ruby job server and scheduler. Its main intent is to be used with Ruby on Rails applications for offloading long-running tasks. 
+    Since a Rails application blocks while serving a request it is best to move long-running tasks off into a background process that is divorced from http request/response cycle.}
+  gem.email = "mtylty@gmail.com"
+  gem.authors = ["Matteo Latini"]
+  gem.version = "1.1"
+  gem.add_dependency 'chronic', '>= 0.2.3'
+  gem.add_dependency 'packet', '>= 0.1.15'
+end
+Jeweler::RubygemsDotOrgTasks.new

data/TODO.org

@@ -0,0 +1,5 @@
+* Todo related with new version *
+- write docs for new :schedule_at
+- docs for disabling job queue checks
+- more documentation for job queue
+- Check for job table migration (need internet)

data/app/controller/backgroundrb_status_controller.rb

@@ -0,0 +1,6 @@
+class BackgroundrbStatusController < ApplicationController
+  def index
+    status = MiddleMan.all_worker_info
+    render :text => status
+  end
+end

data/backgroundrb-rails3.gemspec

@@ -0,0 +1,219 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{backgroundrb-rails3}
+  s.version = "1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matteo Latini"]
+  s.date = %q{2010-12-14}
+  s.description = %q{
+    BackgrounDRb is a Ruby job server and scheduler. Its main intent is to be used with Ruby on Rails applications for offloading long-running tasks. 
+    Since a Rails application blocks while serving a request it is best to move long-running tasks off into a background process that is divorced from http request/response cycle.}
+  s.email = %q{mtylty@gmail.com}
+  s.extra_rdoc_files = [
+    "ChangeLog",
+    "LICENSE",
+    "README"
+  ]
+  s.files = [
+    ".autotest",
+    "ChangeLog",
+    "Gemfile",
+    "LICENSE",
+    "MIT-LICENSE",
+    "README",
+    "Rakefile",
+    "TODO.org",
+    "app/controller/backgroundrb_status_controller.rb",
+    "backgroundrb-rails3.gemspec",
+    "config/backgroundrb.yml",
+    "doc/Rakefile",
+    "doc/config.yaml",
+    "doc/content/advanced/advanced.txt",
+    "doc/content/advanced/advanced.yaml",
+    "doc/content/bugs/bugs.txt",
+    "doc/content/bugs/bugs.yaml",
+    "doc/content/community/community.txt",
+    "doc/content/community/community.yaml",
+    "doc/content/content.txt",
+    "doc/content/content.yaml",
+    "doc/content/faq/faq.txt",
+    "doc/content/faq/faq.yaml",
+    "doc/content/rails/rails.txt",
+    "doc/content/rails/rails.yaml",
+    "doc/content/scheduling/scheduling.txt",
+    "doc/content/scheduling/scheduling.yaml",
+    "doc/content/workers/workers.txt",
+    "doc/content/workers/workers.yaml",
+    "doc/layouts/default/default.erb",
+    "doc/layouts/default/default.yaml",
+    "doc/lib/default.rb",
+    "doc/output/Assets/BG-Ad-Top.png",
+    "doc/output/Assets/BG-Body.png",
+    "doc/output/Assets/BG-Feed.png",
+    "doc/output/Assets/BG-Menu-Hover.png",
+    "doc/output/Assets/BG-Menu.png",
+    "doc/output/Assets/BG-Sidebar-Bottom.png",
+    "doc/output/Assets/Button-Feed.png",
+    "doc/output/images/bg-ad-top.png",
+    "doc/output/images/bg-body.png",
+    "doc/output/images/bg-feed.gif",
+    "doc/output/images/bg-footer.jpg",
+    "doc/output/images/bg-header.jpg",
+    "doc/output/images/bg-menu-hover.png",
+    "doc/output/images/bg-menu.png",
+    "doc/output/images/bg-sidebar-bottom.gif",
+    "doc/output/images/button-feed.png",
+    "doc/output/images/icon-comment.png",
+    "doc/output/images/more_icon.gif",
+    "doc/output/style.css",
+    "doc/page_defaults.yaml",
+    "doc/tasks/default.rake",
+    "doc/templates/default/default.txt",
+    "doc/templates/default/default.yaml",
+    "examples/backgroundrb.yml",
+    "examples/foo_controller.rb",
+    "examples/god_worker.rb",
+    "examples/worker_tests/god_worker_test.rb",
+    "examples/workers/error_worker.rb",
+    "examples/workers/foo_worker.rb",
+    "examples/workers/god_worker.rb",
+    "examples/workers/model_worker.rb",
+    "examples/workers/renewal_worker.rb",
+    "examples/workers/rss_worker.rb",
+    "examples/workers/server_worker.rb",
+    "examples/workers/world_worker.rb",
+    "examples/workers/xmpp_worker.rb",
+    "init.rb",
+    "install.rb",
+    "know_issues.org",
+    "lib/backgroundrb.rb",
+    "lib/backgroundrb/bdrb_client_helper.rb",
+    "lib/backgroundrb/bdrb_cluster_connection.rb",
+    "lib/backgroundrb/bdrb_config.rb",
+    "lib/backgroundrb/bdrb_conn_error.rb",
+    "lib/backgroundrb/bdrb_connection.rb",
+    "lib/backgroundrb/bdrb_job_queue.rb",
+    "lib/backgroundrb/bdrb_result.rb",
+    "lib/backgroundrb/bdrb_start_stop.rb",
+    "lib/backgroundrb/rails_worker_proxy.rb",
+    "lib/backgroundrb/railtie.rb",
+    "lib/generators/backgroundrb/bdrb_migration/USAGE",
+    "lib/generators/backgroundrb/bdrb_migration/bdrb_migration_generator.rb",
+    "lib/generators/backgroundrb/bdrb_migration/templates/migration.rb",
+    "lib/generators/backgroundrb/worker/USAGE",
+    "lib/generators/backgroundrb/worker/templates/unit_test.rb",
+    "lib/generators/backgroundrb/worker/templates/worker.rb",
+    "lib/generators/backgroundrb/worker/worker_generator.rb",
+    "lib/tasks/backgroundrb_tasks.rake",
+    "release_notes.org",
+    "release_points.org",
+    "script/backgroundrb",
+    "script/bdrb_test_helper.rb",
+    "script/load_worker_env.rb",
+    "script/monitrc",
+    "server/backgroundrb_server.rb",
+    "server/lib/bdrb_result_storage.rb",
+    "server/lib/bdrb_server_helper.rb",
+    "server/lib/bdrb_thread_pool.rb",
+    "server/lib/cron_trigger.rb",
+    "server/lib/invalid_dump_error.rb",
+    "server/lib/log_worker.rb",
+    "server/lib/master_proxy.rb",
+    "server/lib/master_worker.rb",
+    "server/lib/meta_worker.rb",
+    "server/lib/trigger.rb",
+    "test/bdrb_client_test_helper.rb",
+    "test/bdrb_test_helper.rb",
+    "test/client/backgroundrb.yml",
+    "test/client/test_bdrb_client_helper.rb",
+    "test/client/test_bdrb_cluster_connection.rb",
+    "test/client/test_bdrb_config.rb",
+    "test/client/test_bdrb_connection.rb",
+    "test/client/test_bdrb_job_queue.rb",
+    "test/client/test_worker_proxy.rb",
+    "test/server/test_cron_trigger.rb",
+    "test/server/test_master_proxy.rb",
+    "test/server/test_master_worker.rb",
+    "test/server/test_meta_worker.rb",
+    "test/server/test_result_storage.rb",
+    "test/socket_mocker.rb",
+    "test/workers/bar_worker.rb",
+    "test/workers/foo_worker.rb",
+    "uninstall.rb"
+  ]
+  s.homepage = %q{http://github.com/mtylty/backgroundrb-rails3}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{BackgrounDRb is a Ruby job server and scheduler.}
+  s.test_files = [
+    "examples/foo_controller.rb",
+    "examples/god_worker.rb",
+    "examples/worker_tests/god_worker_test.rb",
+    "examples/workers/error_worker.rb",
+    "examples/workers/foo_worker.rb",
+    "examples/workers/god_worker.rb",
+    "examples/workers/model_worker.rb",
+    "examples/workers/renewal_worker.rb",
+    "examples/workers/rss_worker.rb",
+    "examples/workers/server_worker.rb",
+    "examples/workers/world_worker.rb",
+    "examples/workers/xmpp_worker.rb",
+    "test/bdrb_client_test_helper.rb",
+    "test/bdrb_test_helper.rb",
+    "test/client/test_bdrb_client_helper.rb",
+    "test/client/test_bdrb_cluster_connection.rb",
+    "test/client/test_bdrb_config.rb",
+    "test/client/test_bdrb_connection.rb",
+    "test/client/test_bdrb_job_queue.rb",
+    "test/client/test_worker_proxy.rb",
+    "test/server/test_cron_trigger.rb",
+    "test/server/test_master_proxy.rb",
+    "test/server/test_master_worker.rb",
+    "test/server/test_meta_worker.rb",
+    "test/server/test_result_storage.rb",
+    "test/socket_mocker.rb",
+    "test/workers/bar_worker.rb",
+    "test/workers/foo_worker.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_runtime_dependency(%q<packet>, ["= 0.1.15"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_runtime_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_runtime_dependency(%q<packet>, [">= 0.1.15"])
+    else
+      s.add_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_dependency(%q<packet>, ["= 0.1.15"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_dependency(%q<packet>, [">= 0.1.15"])
+    end
+  else
+    s.add_dependency(%q<chronic>, [">= 0.2.3"])
+    s.add_dependency(%q<packet>, ["= 0.1.15"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<chronic>, [">= 0.2.3"])
+    s.add_dependency(%q<packet>, [">= 0.1.15"])
+  end
+end
+