thin-attach_socket 0.1

data/README.md

@@ -0,0 +1,49 @@
+Provides `Thin::Backends::AttachSocket` for booting a thin server on an already open
+Socket.
+
+This is useful when running thin inside [einhorn](https://github.com/stripe/einhorn), and
+it requires [eventmachine-le](https://github.com/ibc/EventMachine-LE).
+
+Installation
+============
+
+Either `gem install thin-attach_socket`, or add `gem 'thin-attach_socket'` to your
+`Gemfile` and run `bundle`.
+
+Usage
+=====
+
+Thin allows you to configure the backend dynamically, so using thin-attach-socket is as
+simple as:
+
+```ruby
+require 'thin/attach_socket'
+Thin::Server.new(MyApp,
+                 backend: Thin::Backends::AttachSocket,
+                 socket: IO.for_fd(6))
+```
+
+By default thin will stop the EventMachine reactor when you stop the server, and this is
+usually what you want. If you're running other servers on the reactor however, you should
+pass `preserve_reactor: true` when constructing a new server, and this will not happen.
+
+```ruby
+require 'thin/attach_socket'
+Thin::Server.new(MyApp,
+                 backend: Thin::Backends::AttachSocket,
+                 socket: IO.for_fd(6),
+                 signals: false,
+                 preserve_reactor: true)
+```
+
+If you do this, you need to make sure to stop the thin server before stopping the EM
+reactor.
+
+Meta-foo
+========
+
+thin-attach_socket is released under the Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
+
+It was heavily based on the [work](https://github.com/stripe/thin/commit/42e29ba23a136a30dc11a1c9dff1fe1187dc9eee) of
+Patrick Collison at Stripe.
+

data/lib/thin/attach_socket.rb

@@ -0,0 +1,64 @@
+# Based on Patrick Collison's commit to stripe/thin:
+# https://github.com/stripe/thin/commit/42e29ba23a136a30dc11a1c9dff1fe1187dc9eee
+#
+module Thin
+  module Backends
+    # Backend to act as a TCP server using an already opened file
+    # descriptor. Currently requires a patched EventMachine like
+    # https://github.com/ibc/EventMachine-LE
+    #
+    # @example
+    #
+    #   Thin::Server.new(MyApp,
+    #                    backend: Thin::Backends::AttachSocket,
+    #                    socket: IO.for_fd(6))
+    #
+    # If you're running thin inside a reactor with other servers, then pass
+    # preserve_reactor: true. This ensures that when you stop the Thin server,
+    # it will not stop your reactor.
+    #
+    # If you're doing that you probably also want to pass signals: false so that
+    # you can control when thin shuts down:
+    #
+    # @example
+    #
+    #   Thin::Server.new(MyApp,
+    #                    backend: Thin::Backends::AttachSocket,
+    #                    socket: IO.for_fd(6),
+    #                    signals: false,
+    #                    preserve_reactor: true)
+    #
+    class AttachSocket < Base
+      def initialize(host, port, options)
+        @socket = options[:socket]
+        @preserve_reactor = !!options[:preserve_reactor]
+        super()
+      end
+
+      def connect
+        @signature = EventMachine.attach_server(@socket, Connection, &method(:initialize_connection))
+      end
+
+      def disconnect
+        EventMachine.stop_server(@signature)
+      end
+
+      def to_s
+        "socket:#{@socket.inspect}"
+      end
+
+      def stop!
+        if @preserve_reactor
+          # This is the code for super, with the EM::stop call removed.
+          @running  = false
+          @stopping = false
+
+          @connections.each { |connection| connection.close_connection_after_writing }
+          close
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/thin-attach_socket.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name = "thin-attach_socket"
+  s.version = "0.1"
+  s.platform = Gem::Platform::RUBY
+  s.author = "Conrad Irwin"
+  s.email = "conrad.irwin@gmail.com"
+  s.homepage = "http://github.com/ConradIrwin/thin-attach_socket"
+  s.summary = "Provides Thin::Backends::AttachServer for booting thin on an existing socket."
+  s.description = "This is useful for running thin behind einhorn, and requires eventmachine-le"
+  s.files = `git ls-files`.split("\n")
+  s.require_path = "lib"
+  s.add_dependency 'thin'
+  s.add_dependency 'eventmachine-le'
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: thin-attach_socket
+version: !ruby/object:Gem::Version
+  prerelease: 
+  version: '0.1'
+platform: ruby
+authors:
+- Conrad Irwin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  type: :runtime
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: thin
+- !ruby/object:Gem::Dependency
+  type: :runtime
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: eventmachine-le
+description: This is useful for running thin behind einhorn, and requires eventmachine-le
+email: conrad.irwin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/thin/attach_socket.rb
+- thin-attach_socket.gemspec
+homepage: http://github.com/ConradIrwin/thin-attach_socket
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Provides Thin::Backends::AttachServer for booting thin on an existing socket.
+test_files: []
+has_rdoc: