spinal_tap 0.0.1

data/.gitignore

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

data/Gemfile

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

data/Guardfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Chad Remesch
+
+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,55 @@
+# SpinalTap
+
+Spinal tap lets you easily connect to running Ruby processes such as daemons and cron scripts.
+Once connected, you can execute arbitrary commands inside of your process.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'spinal_tap'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install spinal_tap
+
+## Basic Usage
+
+Start spinal at the beginning of your long running process:
+
+    SpinalTap.start
+
+By default it will listen for TCP connections on 127.0.0.1:9000.
+You can then telnet into your process and type 'help' to view the default list of commands.
+Spinal Tap uses threads to run in the background of your process.
+
+SpinalTap.start accepts the following options:
+
+    :host => The address to listen on (default: 127.0.0.1).
+    :port => The port to listen on (default: 9000).
+
+You can stop the spinal tap server at any time:
+
+    SpinalTap.stop
+
+## Security
+
+With great power comes great responsibility.
+Currently no authentication exists so anyone who can connect to Spinal Tap has complete control over your process.
+This includes changing memory, reloading classes, killing the process, and pretty much any other nasty thing you can with Ruby's 'eval' method.
+Use at your own risk!  You have been warned!
+
+# Contributing to Spinal Tap:
+
+1. Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+2. Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+3. Fork the project.
+4. Start a feature/bugfix branch.
+5. Commit and push until you are happy with your contribution.
+6. Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+7. Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+8. Create a new Pull Request.

data/Rakefile

@@ -0,0 +1,34 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rubygems'
+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
+
+task :default => :spec
+
+desc 'Start an IRB console with offier loaded'
+task :console do
+  $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+  require 'spinal_tap'
+  require 'irb'
+
+  ARGV.clear
+
+  IRB.start
+end
+
+desc 'Run all specs'
+task :spec do
+  puts 'Running rspec:'
+  system 'rspec spec'
+end
+
+task :default => :spec

data/lib/spinal_tap/client_helpers.rb

@@ -0,0 +1,9 @@
+module SpinalTap
+
+  module ClientHelpers
+    def prompt
+      write('> ')
+    end
+  end
+
+end

data/lib/spinal_tap/server.rb

@@ -0,0 +1,108 @@
+require 'socket'
+
+module SpinalTap
+
+  class Server
+    def initialize(params = {})
+      @host = params[:host] || '127.0.0.1'
+      @port = params[:port] || 9000
+
+      @run = false
+      @workers = {}
+      @workers_lock = Mutex.new
+    end
+
+    def start
+      return false if @running
+
+      @running = true
+
+      @listener_thread = Thread.new do
+        @server_sock = TCPServer.new(@host, @port)
+
+        while true
+          Thread.new(@server_sock.accept) do |client|
+            begin
+              @workers_lock.synchronize do
+                @workers[Thread.current] = client
+              end
+
+              client.setsockopt(Socket::IPPROTO_TCP, Socket::TCP_NODELAY, 1)
+              client.extend(SpinalTap::ClientHelpers)
+
+              process(client)
+            rescue Exception => e
+              puts("WORKER DIED: #{exception_to_s(e)}")
+            end
+          end
+        end
+      end
+
+      true
+    end
+
+    def stop
+      return false unless @running
+
+      Thread.kill(@listener_thread)
+      @server_sock.close
+
+      true
+    end
+
+    def workers
+      @workers_lock.synchronize do
+        return @workers.clone
+      end
+    end
+
+    private
+
+    def process(client)
+      client.prompt
+
+      while(line = client.gets)
+        line.chomp!
+
+        tokens = line.split(' ')
+        command = tokens.first
+
+        case command
+        when 'help' then exec_help(client)
+        when 'eval' then exec_eval(client, tokens[1..-1].join(' '))
+        when 'quit'
+          client.close
+          break
+        else
+          client.puts('Unknown command')
+        end
+
+        client.prompt
+      end
+
+    ensure
+      client.close unless client.closed?
+
+      @workers_lock.synchronize do
+        @workers.delete(Thread.current)
+      end
+    end
+
+    def exec_help(client)
+      client.puts('Commands: help quit eval')
+    end
+
+    def exec_eval(client, code)
+      begin
+        result = eval(code)
+        client.puts(result.to_s)
+      rescue Exception => e
+        client.puts(exception_to_s(e))
+      end
+    end
+
+    def exception_to_s(e)
+      "#{e.message}\r\n#{e.backtrace.join("\r\n")}"
+    end
+  end
+end

data/lib/spinal_tap/version.rb

@@ -0,0 +1,3 @@
+module SpinalTap
+  VERSION = "0.0.1"
+end

data/lib/spinal_tap.rb

@@ -0,0 +1,25 @@
+require 'spinal_tap/version'
+require 'spinal_tap/server'
+require 'spinal_tap/client_helpers'
+
+module SpinalTap
+  def self.start(params = {})
+    return false if @server
+
+    @server = SpinalTap::Server.new(params)
+    @server.start
+  end
+
+  def self.stop
+    return false unless @server
+
+    result = @server.stop
+    @server = nil
+
+    result
+  end
+
+  def self.server
+    @server
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'rubygems'
+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 'benchmark'
+require 'spinal_tap'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+end

data/spinal_tap.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/spinal_tap/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Chad Remesch"]
+  gem.email         = ["chad@remesch.com"]
+  gem.description   = %q{Backdoor into your long running ruby processes.}
+  gem.summary       = %q{Spinal tap lets you easily connect into running ruby processes such as daemons and cron scripts.  With great power comes great responsibility.}
+  gem.homepage      = "http://github.com/chadrem/spinal_tap"
+
+  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{^(test|spec|features)/})
+  gem.name          = "spinal_tap"
+  gem.require_paths = ["lib"]
+  gem.version       = SpinalTap::VERSION
+
+  gem.add_development_dependency('rake', ['= 0.9.2.2'])
+  gem.add_development_dependency('rspec', ['= 2.11'])
+  gem.add_development_dependency('guard', ['= 1.2.3'])
+  gem.add_development_dependency('guard-rspec', ['= 1.2.0'])
+  gem.add_development_dependency('growl', ['= 1.0.3'])
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: spinal_tap
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Chad Remesch
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '2.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '2.11'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: growl
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+description: Backdoor into your long running ruby processes.
+email:
+- chad@remesch.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/spinal_tap.rb
+- lib/spinal_tap/client_helpers.rb
+- lib/spinal_tap/server.rb
+- lib/spinal_tap/version.rb
+- spec/spec_helper.rb
+- spinal_tap.gemspec
+homepage: http://github.com/chadrem/spinal_tap
+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'
+      segments:
+      - 0
+      hash: 4269159806787806500
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4269159806787806500
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Spinal tap lets you easily connect into running ruby processes such as daemons
+  and cron scripts.  With great power comes great responsibility.
+test_files:
+- spec/spec_helper.rb