spawnling 2.1 → 2.1.1

data/README.md

@@ -1,12 +1,16 @@
 #News
 
-Now runs with ruby 1.9 (and later).  Because ruby "stole" the name "spawn", this gem
-now has been redefined to use "Spawn.new(&block)" instead of "spawn(&block)".  Other
+2013-4-15 gem renamed from "spawn-block" (lame) to "spawnling" (awesome).  Sadly the
+name "spawn" was taken before I got around to making this into a gem so I decided to
+give it a new name and a new home.
+
+Also, now runs with ruby 1.9 (and later).  Because ruby "stole" the name "spawn", this gem
+now has been redefined to use "Spawnling.new(&block)" instead of "spawn(&block)".  Other
 than that nothing has changed in the basic usage.  Read below for detailed usage.
 
-# Spawn
+# Spawnling
 
-This gem provides a 'Spawn' class to easily fork OR thread long-running sections of
+This gem provides a 'Spawnling' class to easily fork OR thread long-running sections of
 code so that your application can return results to your users more quickly.
 It works by creating new database connections in ActiveRecord::Base for the
 spawned block so that you don't have to worry about database connections working,
@@ -50,7 +54,7 @@ into your config/database.yml.
 Here's a simple example of how to demonstrate the spawn plugin.
 In one of your controllers, insert this code (after installing the plugin of course):
 ```ruby
-Spawn.new do
+Spawnling.new do
   logger.info("I feel sleepy...")
   sleep 11
   logger.info("Time to wake up!")
@@ -60,17 +64,17 @@ If everything is working correctly, your controller should finish quickly then y
 the last log message several seconds later.
 
 If you need to wait for the spawned processes/threads, then pass the objects returned by
-spawn to Spawn.wait(), like this:
+spawn to Spawnling.wait(), like this:
 ```ruby
 spawns = []
 N.times do |i|
   # spawn N blocks of code
-  spawns << Spawn.new do
+  spawns << Spawnling.new do
     something(i)
   end
 end
 # wait for all N blocks of code to finish running
-Spawn.wait(spawns)
+Spawnling.wait(spawns)
 ```
 ## Options
 
@@ -89,7 +93,7 @@ Any option to spawn can be set as a default so that you don't have to pass them
 to every call of spawn.   To configure the spawn default options, add a line to
 your configuration file(s) like this:
 ```ruby
-  Spawn::default_options {:method => :thread}
+  Spawnling.default_options {:method => :thread}
 ```
 If you don't set any default options, the :method will default to :fork.  To
 specify different values for different environments, add the default_options call to
@@ -97,9 +101,9 @@ he appropriate environment file (development.rb, test.rb).   For testing you can
 the default :method to :yield so that the code is run inline.
 ```ruby
   # in environment.rb
-  Spawn.method :method => :fork, :nice => 7
+  Spawnling.method :method => :fork, :nice => 7
   # in test.rb, will override the environment.rb setting
-  Spawn.method :method => :yield
+  Spawnling.method :method => :yield
 ```
 This allows you to set your production and development environments to use different
 methods according to your needs.
@@ -109,7 +113,7 @@ methods according to your needs.
 If you want your forked child to run at a lower priority than the parent process, pass in
 the :nice option like this:
 ```ruby
-Spawn.new(:nice => 7) do
+Spawnling.new(:nice => 7) do
   do_something_nicely
 end
 ```
@@ -120,7 +124,7 @@ do threading either by telling the spawn method when you call it or by configuri
 environment.
 For example, this is how you can tell spawn to use threading on the call,
 ```ruby
-Spawn.new(:method => :thread) do
+Spawnling.new(:method => :thread) do
   something
 end
 ```
@@ -149,7 +153,7 @@ listing the running processes (ps).
 For example, if you do something like this,
 ```ruby
 3.times do |i|
- Spawn.new(:argv => "spawn -#{i}-") do
+ Spawnling.new(:argv => "spawn -#{i}-") do
    something(i)
   end
 end

data/init.rb

@@ -1 +1 @@
-require 'spawn'
+require 'spawnling'

data/lib/patches.rb

@@ -2,7 +2,7 @@ if defined?(ActiveRecord)
   # see activerecord/lib/active_record/connection_adaptors/abstract/connection_specification.rb
   class ActiveRecord::Base
     # reconnect without disconnecting
-    if ::Spawn::RAILS_3_x || ::Spawn::RAILS_2_2
+    if ::Spawnling::RAILS_3_x || ::Spawnling::RAILS_2_2
       def self.spawn_reconnect(klass=self)
         # keep ancestors' connection_handlers around to avoid them being garbage collected in the forked child
         @@ancestor_connection_handlers ||= []
@@ -24,7 +24,7 @@ if defined?(ActiveRecord)
     end
 
     # this patch not needed on Rails 2.x and later
-    if ::Spawn::RAILS_1_x
+    if ::Spawnling::RAILS_1_x
       # monkey patch to fix threading problems,
       # see: http://dev.rubyonrails.org/ticket/7579
       def self.clear_reloadable_connections!
@@ -58,7 +58,7 @@ if defined?(Unicorn::HttpServer) && defined?(Unicorn::HttpRequest::REQ)
     REQ = Unicorn::HttpRequest::REQ
     alias_method :orig_process_client, :process_client
     def process_client(client)
-      ::Spawn.resources_to_close(client, REQ)
+      ::Spawnling.resources_to_close(client, REQ)
       orig_process_client(client)
     end
   end
@@ -66,7 +66,7 @@ elsif defined? Unicorn::HttpServer
   class Unicorn::HttpServer
     alias_method :orig_process_client, :process_client
     def process_client(client)
-      ::Spawn.resources_to_close(client, @request)
+      ::Spawnling.resources_to_close(client, @request)
       orig_process_client(client)
     end
   end
@@ -78,10 +78,10 @@ end
 if defined? Mongrel::HttpServer
   class Mongrel::HttpServer
     # redefine Montrel::HttpServer::process_client so that we can intercept
-    # the socket that is being used so Spawn can close it upon forking
+    # the socket that is being used so Spawnling can close it upon forking
     alias_method :orig_process_client, :process_client
     def process_client(client)
-      ::Spawn.resources_to_close(client, @socket)
+      ::Spawnling.resources_to_close(client, @socket)
       orig_process_client(client)
     end
   end
@@ -101,7 +101,7 @@ if need_passenger_patch
     class Passenger::Railz::RequestHandler
       alias_method :orig_process_request, :process_request
       def process_request(headers, input, output)
-        ::Spawn.resources_to_close(input, output)
+        ::Spawnling.resources_to_close(input, output)
         orig_process_request(headers, input, output)
       end
     end
@@ -112,7 +112,7 @@ if need_passenger_patch
     class PhusionPassenger::Railz::RequestHandler
       alias_method :orig_process_request, :process_request
       def process_request(headers, input, output)
-        ::Spawn.resources_to_close(input, output)
+        ::Spawnling.resources_to_close(input, output)
         orig_process_request(headers, input, output)
       end
     end
@@ -123,7 +123,7 @@ if need_passenger_patch
     class PhusionPassenger::Rack::RequestHandler
       alias_method :orig_process_request, :process_request
       def process_request(headers, input, output)
-        ::Spawn.resources_to_close(input, output)
+        ::Spawnling.resources_to_close(input, output)
         orig_process_request(headers, input, output)
       end
     end

data/lib/{spawn.rb → spawnling.rb}

@@ -1,6 +1,6 @@
 require 'logger'
 
-class Spawn
+class Spawnling
   if defined? ::Rails
     RAILS_1_x = (::Rails::VERSION::MAJOR == 1) unless defined?(RAILS_1_x)
     RAILS_2_2 = ((::Rails::VERSION::MAJOR == 2 && ::Rails::VERSION::MINOR >= 2)) unless defined?(RAILS_2_2)
@@ -34,7 +34,7 @@ class Spawn
   # Set the options to use every time spawn is called unless specified
   # otherwise.  For example, in your environment, do something like
   # this:
-  #   Spawn::default_options = {:nice => 5}
+  #   Spawnling::default_options = {:nice => 5}
   # to default to using the :nice option with a value of 5 on every call.
   # Valid options are:
   #   :method => (:thread | :fork | :yield)
@@ -84,12 +84,12 @@ class Spawn
     @@punks = []
   end
   # register to kill marked children when parent exits
-  at_exit { Spawn.kill_punks }
+  at_exit { Spawnling.kill_punks }
 
   # Spawns a long-running section of code and returns the ID of the spawned process.
   # By default the process will be a forked process.   To use threading, pass
   # :method => :thread or override the default behavior in the environment by setting
-  # 'Spawn::method :thread'.
+  # 'Spawnling::method :thread'.
   def initialize(opts = {})
     raise "Must give block of code to be spawned" unless block_given?
     options = @@default_options.merge(symbolize_options(opts))
@@ -149,7 +149,7 @@ class Spawn
         Process.setpriority(Process::PRIO_PROCESS, 0, options[:nice]) if options[:nice]
 
         # disconnect from the listening socket, et al
-        Spawn.close_resources
+        Spawnling.close_resources
         if defined?(Rails)
           # get a new database connection so the parent can keep the original one
           ActiveRecord::Base.spawn_reconnect
@@ -175,7 +175,7 @@ class Spawn
           # ensure log is flushed since we are using exit!
           @@logger.flush if @@logger && @@logger.respond_to?(:flush)
           # this child might also have children to kill if it called spawn
-          Spawn.kill_punks
+          Spawnling.kill_punks
           # this form of exit doesn't call at_exit handlers
           exit!(0)
         end
@@ -194,7 +194,7 @@ class Spawn
       @@logger.debug "spawn> death row = #{@@punks.inspect}" if @@logger
     end
 
-    # return Spawn::Id.new(:fork, child)
+    # return Spawnling::Id.new(:fork, child)
     return child
   end
 
@@ -217,7 +217,8 @@ class Spawn
     end
   end
 end
-Spawnling = Spawn
+# backwards compatibility unless someone is using the "other" spawn gem
+Spawn = Spawnling unless defined? Spawn
 
 # patches depends on Spawn so require it after the class
 require 'patches'

metadata

@@ -1,69 +1,65 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: spawnling
-version: !ruby/object:Gem::Version 
-  version: "2.1"
+version: !ruby/object:Gem::Version
+  version: 2.1.1
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Tom Anderson
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-08-08 00:00:00 Z
+date: 2010-08-08 00:00:00.000000000Z
 dependencies: []
+description: ! 'This plugin provides a ''Spawn'' class to easily fork OR
 
-description: |-
-  This plugin provides a 'Spawn' class to easily fork OR
   thread long-running sections of code so that your application can return
+
   results to your users more quickly.  This plugin works by creating new database
+
   connections in ActiveRecord::Base for the spawned block.
-  
+
+
   The plugin also patches ActiveRecord::Base to handle some known bugs when using
-  threads (see lib/patches.rb).
-email: 
+
+  threads (see lib/patches.rb).'
+email:
 - tom@squeat.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - lib/patches.rb
-- lib/spawn/cucumber.rb
-- lib/spawn.rb
+- lib/spawnling/cucumber.rb
+- lib/spawnling.rb
 - spec/spawn/spawn_spec.rb
 - spec/spec_helper.rb
 - CHANGELOG
 - LICENSE
 - README.md
 - init.rb
-homepage: http://github.com/tra/spawn
+homepage: http://github.com/tra/spawnling
 licenses: []
-
-metadata: {}
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
+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: 2.0.3
+rubygems_version: 1.8.10
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: Easily fork OR thread long-running sections of code in Ruby
 test_files: []
-

checksums.yaml

@@ -1,7 +0,0 @@
---- 
-SHA1: 
-  data.tar.gz: 22c752d3c7f7e6f38838941833c5b3e05cd376e1
-  metadata.gz: 3ed0947f67a6a6937970268bcb2988dc56184dda
-SHA512: 
-  data.tar.gz: 858a4f1a283da28138a84b801f2943901a86bf49250804bd46477f01b5e667927bab24de0350a5f8887f210af57ae233b3e2cb45647404ff0677bb877eb3ca8c
-  metadata.gz: 949044c486e08b519984b6734c009568143d7d64325838f8df47f6cee75d0e8903a831f3552cf4373d25ca8a749381067fae25c327357609c917e11182f7e3a0