zeus-edge 0.12.1

data/lib/zeus.rb

@@ -0,0 +1,161 @@
+# encoding: utf-8
+require 'socket'
+require 'json'
+require 'pty'
+
+require 'zeus/load_tracking'
+
+module Zeus
+  class Plan
+    def after_fork ; end
+  end
+
+  class << self
+    attr_accessor :plan, :dummy_tty, :master_socket
+
+    # this is totally asinine, but readline gets super confused when it's
+    # required at a time when stdin or stdout is not connected to a TTY,
+    # no matter what we do to tell it otherwise later. So we create a dummy
+    # TTY in case readline is required.
+    #
+    # Yup.
+    def setup_dummy_tty!
+      return if self.dummy_tty
+      master, self.dummy_tty = PTY.open
+      Thread.new {
+        loop { master.read(1024) }
+      }
+      STDIN.reopen(dummy_tty)
+      STDOUT.reopen(dummy_tty)
+    end
+
+    def setup_master_socket!
+      return master_socket if master_socket
+
+      fd = ENV['ZEUS_MASTER_FD'].to_i
+      self.master_socket = UNIXSocket.for_fd(fd)
+    end
+
+    def go(identifier=:boot)
+      $0 = "zeus slave: #{identifier}"
+
+      setup_dummy_tty!
+      master = setup_master_socket!
+
+      # I need to give the master a way to talk to me exclusively
+      local, remote = UNIXSocket.pair(Socket::SOCK_STREAM)
+      master.send_io(remote)
+
+      # Now I need to tell the master about my PID and ID
+      local.write "P:#{Process.pid}:#{identifier}\0"
+
+      # Now we run the action and report its success/fail status to the master.
+      features = Zeus::LoadTracking.features_loaded_by {
+        run_action(local, identifier)
+      }
+
+      # the master wants to know about the files that running the action caused us to load.
+      Thread.new { notify_features(local, features) }
+
+      # We are now 'connected'. From this point, we may receive requests to fork.
+      loop do
+        messages = local.recv(1024)
+        messages.split("\0").each do |new_identifier|
+          new_identifier =~ /^(.):(.*)/
+          code, ident = $1, $2
+          if code == "S"
+            fork { plan.after_fork ; go(ident.to_sym) }
+          else
+            fork { plan.after_fork ; command(ident.to_sym, local) }
+          end
+        end
+      end
+    end
+
+    private
+
+    def command(identifier, sock)
+      $0 = "zeus runner: #{identifier}"
+      Process.setsid
+
+      local, remote = UNIXSocket.pair(:DGRAM)
+      sock.send_io(remote)
+      remote.close
+      sock.close
+
+      pid_and_arguments = local.recv(1024)
+      pid_and_arguments.chomp!("\0")
+      # pid_and_arguments.force_encoding("ASCII-8BIT")
+      pid_and_arguments =~ /(.*?):(.*)/
+      client_pid, arguments = $1.to_i, $2
+      arguments.chomp!("\0")
+
+      pid = fork {
+        $0 = "zeus command: #{identifier}"
+        plan.after_fork
+        client_terminal = local.recv_io
+        local.write "P:#{Process.pid}:\0"
+        local.close
+
+        $stdin.reopen(client_terminal)
+        $stdout.reopen(client_terminal)
+        $stderr.reopen(client_terminal)
+        ARGV.replace(JSON.parse(arguments))
+
+        plan.send(identifier)
+      }
+
+      kill_command_if_client_quits!(pid, client_pid)
+
+      Process.wait(pid)
+      code = $?.exitstatus || 0
+
+      local.write "#{code}\0"
+
+      local.close
+    end
+
+    def kill_command_if_client_quits!(command_pid, client_pid)
+      Thread.new {
+        loop {
+          begin
+            Process.kill(0, client_pid)
+          rescue Errno::ESRCH
+            Process.kill(9, command_pid)
+          end
+          sleep 1
+        }
+      }
+    end
+
+    def notify_features(sock, features)
+      features.each do |t|
+        begin
+          sock.write "F:#{t}\0"
+          sock.flush
+        rescue Errno::ENOBUFS
+          sleep 0.2
+          retry
+        end
+      end
+    end
+
+    def report_error_to_master(local, error)
+      str = "R:"
+      str << "#{error.backtrace[0]}: #{error.message} (#{error.class})\n"
+      error.backtrace[1..-1].each do |line|
+        str << "\tfrom #{line}\n"
+      end
+      str << "\0"
+      local.write str
+    end
+
+    def run_action(socket, identifier)
+      plan.send(identifier)
+      socket.write "R:OK\0"
+    rescue Exception => e
+      report_error_to_master(socket, e)
+    end
+
+  end
+end

data/man/build/zeus

@@ -0,0 +1,61 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "ZEUS" "1" "September 2012" "" ""
+.
+.SH "NAME"
+\fBzeus\fR \- boot rails in under a second
+.
+.SH "SYNOPSIS"
+\fBzeus\fR [\-\-no\-color] COMMAND [ARGS]
+.
+.SH "DESCRIPTION"
+Zeus makes working with large codebases much less painful\.
+.
+.P
+To use Zeus with Ruby on Rails 3\.0+, Just run \fBzeus init\fR in your project directory, then run \fBzeus start\fR, then run \fBzeus commands\fR in a different shell to see a list of available commands\.
+.
+.P
+See \fBhttps://github\.com/burke/zeus/blob/master/docs/ruby/modifying\.md\fR for information on modifying the boot process that Zeus uses by default\.
+.
+.SH "SLIGHTLY MORE TECHNICAL DESCRIPTION"
+Zeus is a language\-agnostic application checkpointer for non\-multithreaded applications\.
+.
+.P
+It is primarily targeted at ruby and other dynamic languages, where application boot time can be tens of seconds, but it can be made to work for nearly any language\. However, zeus does not work well with multithreaded applications\. It relies heavily on \fBfork(2)\fR, which is largely incompatible with multithreaded systems\.
+.
+.P
+Currently only ruby is targeted, but support for other languages is planned\.
+.
+.P
+Zeus lets you define common tasks, and preloads all of them in the background\. When you ask to run them, zeus transparently connects your terminal to the already\-running process in milliseconds\.
+.
+.P
+This lets you, for example, run unit tests in dozens of milliseconds, rather than dozens of seconds\.
+.
+.P
+Zeus also monitors all files loaded by your application, and restarts parts of it when dependencies change, to keep everything up\-to\-date\.
+.
+.SH "WAY MORE TECHNICAL DESCRIPTION"
+See \fBhttps://github\.com/burke/zeus/blob/master/docs/overview\.md\fR
+.
+.SH "OPTIONS"
+.
+.TP
+\fB\-\-no\-color\fR
+Prints all output without color
+.
+.SH "BUILTIN COMMANDS"
+.
+.TP
+zeus start(1) \fIzeus\-start\.1\.html\fR
+Start a zeus server in the current directory using \fBzeus\.json\fR
+.
+.TP
+zeus init(1) \fIzeus\-init\.1\.html\fR
+Generate a template zeus\.json
+.
+.TP
+\fBzeus commands(1)\fR
+List the commands defined by zeus\.json
+

data/man/build/zeus-init

@@ -0,0 +1,13 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "ZEUS\-INIT" "1" "September 2012" "" ""
+.
+.SH "NAME"
+\fBzeus\-init\fR \- Generate a template zeus\.json
+.
+.SH "SYNOPSIS"
+\fBzeus init\fR
+.
+.SH "DESCRIPTION"
+Creates a \fBzeus\.json\fR file in the current directory\. This example file is useful for rails applications, but can be modified to suit your needs\.

data/man/build/zeus-init.txt

@@ -0,0 +1,17 @@
+ZEUS-INIT(1)							  ZEUS-INIT(1)
+
+
+
+NAME
+       zeus-init - Generate a template zeus.json
+
+SYNOPSIS
+       zeus init
+
+DESCRIPTION
+       Creates a zeus.json file in the current directory. This example file is
+       useful for rails applications, but can be modified to suit your	needs.
+
+
+
+				September 2012			  ZEUS-INIT(1)

data/man/build/zeus-start

@@ -0,0 +1,16 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "ZEUS\-START" "1" "September 2012" "" ""
+.
+.SH "NAME"
+\fBzeus\-start\fR \- Start a zeus server
+.
+.SH "SYNOPSIS"
+\fBzeus start\fR
+.
+.SH "DESCRIPTION"
+Start a server\.
+.
+.P
+TODO: Better docs\.

data/man/build/zeus-start.txt

@@ -0,0 +1,18 @@
+ZEUS-START(1)							 ZEUS-START(1)
+
+
+
+NAME
+       zeus-start - Start a zeus server
+
+SYNOPSIS
+       zeus start
+
+DESCRIPTION
+       Start a server.
+
+       TODO: Better docs.
+
+
+
+				September 2012			 ZEUS-START(1)

data/man/build/zeus.txt

@@ -0,0 +1,65 @@
+ZEUS(1) 							       ZEUS(1)
+
+
+
+NAME
+       zeus - boot rails in under a second
+
+SYNOPSIS
+       zeus [--no-color] COMMAND [ARGS]
+
+DESCRIPTION
+       Zeus makes working with large codebases much less painful.
+
+       To use Zeus with Ruby on Rails 3.0+, Just run zeus init in your project
+       directory, then run zeus start, then run zeus commands in  a  different
+       shell to see a list of available commands.
+
+       See    https://github.com/burke/zeus/blob/master/docs/ruby/modifying.md
+       for information on  modifying  the  boot  process  that	Zeus  uses  by
+       default.
+
+SLIGHTLY MORE TECHNICAL DESCRIPTION
+       Zeus  is  a  language-agnostic  application checkpointer for non-multi-
+       threaded applications.
+
+       It is primarily targeted at ruby and  other  dynamic  languages,  where
+       application  boot  time	can  be tens of seconds, but it can be made to
+       work for nearly any language. However, zeus does  not  work  well  with
+       multithreaded  applications.  It  relies  heavily  on fork(2), which is
+       largely incompatible with multithreaded systems.
+
+       Currently only ruby is targeted, but support  for  other  languages  is
+       planned.
+
+       Zeus  lets  you	define	common	tasks, and preloads all of them in the
+       background. When you ask to run them, zeus transparently connects  your
+       terminal to the already-running process in milliseconds.
+
+       This  lets  you, for example, run unit tests in dozens of milliseconds,
+       rather than dozens of seconds.
+
+       Zeus also monitors all files loaded by your application,  and  restarts
+       parts of it when dependencies change, to keep everything up-to-date.
+
+WAY MORE TECHNICAL DESCRIPTION
+       See https://github.com/burke/zeus/blob/master/docs/overview.md
+
+OPTIONS
+       --no-color
+	      Prints all output without color
+
+BUILTIN COMMANDS
+       zeus start(1) zeus-start.1.html
+	      Start a zeus server in the current directory using zeus.json
+
+       zeus init(1) zeus-init.1.html
+	      Generate a template zeus.json
+
+       zeus commands(1)
+	      List the commands defined by zeus.json
+
+
+
+
+				September 2012			       ZEUS(1)

data/spec/fake_mini_test.rb

@@ -0,0 +1,31 @@
+module MiniTest
+  module Unit
+    class TestCase
+    end
+  end
+end
+
+def stub_mini_test_methods
+  MiniTest::Unit::TestCase.stub!(:test_suites).and_return [fake_suite]
+  MiniTest::Unit.stub!(:runner).and_return fake_runner
+end
+
+def fake_runner
+ @runner ||= stub("Runner", :run => 0)
+end
+
+def fake_suite
+  @suite ||= stub("TestSuite",
+                  :test_methods => [fake_test_method],
+                  :instance_method => fake_instance_method)
+end
+
+def fake_test_method
+  "test_method"
+end
+
+def fake_instance_method
+  @instance_method ||=  stub("InstanceMethod",
+                             :source_location => ["path/to/file.rb", 2],
+                             :source => "def #{fake_test_method} \n assert true \n end")
+end

data/spec/m_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+require 'fake_mini_test'
+
+describe Zeus::M::Runner do
+  Runner = Zeus::M::Runner
+
+  before do
+    stub_mini_test_methods
+  end
+
+  context "no option is given" do
+    it "runs the test without giving any option" do
+      argv = ["path/to/file.rb"]
+
+      fake_runner.should_receive(:run).with([])
+
+      lambda { Runner.new(argv).run }.should exit_with_code(0)
+    end
+  end
+
+  context "given a line number" do
+    it "aborts if no test is found" do
+      argv = ["path/to/file.rb:100"]
+
+      STDERR.should_receive(:write).with(/No tests found on line 100/)
+      fake_runner.should_not_receive :run
+
+      lambda { Runner.new(argv).run }.should_not exit_with_code(0)
+    end
+
+    it "runs the test if the correct line number is given" do
+      argv = ["path/to/file.rb:2"]
+
+      fake_runner.should_receive(:run).with(["-n", "/(#{fake_test_method})/"])
+
+      lambda { Runner.new(argv).run }.should exit_with_code(0)
+    end
+  end
+
+  context "specifying test name" do
+    it "runs the specified tests when using a pattern in --name option" do
+      argv = ["path/to/file.rb", "--name", "/#{fake_test_method}/"]
+
+      fake_runner.should_receive(:run).with(["-n", "/#{fake_test_method}/"])
+
+      lambda { Runner.new(argv).run }.should exit_with_code(0)
+    end
+
+    it "runs the specified tests when using a pattern in -n option" do
+      argv = ["path/to/file.rb", "-n", "/method/"]
+
+      fake_runner.should_receive(:run).with(["-n", "/method/"])
+
+      lambda { Runner.new(argv).run }.should exit_with_code(0)
+    end
+
+    it "aborts if no test matches the given pattern" do
+      argv = ["path/to/file.rb", "-n", "/garbage/"]
+
+      STDERR.should_receive(:write).with(%r{No test name matches \'/garbage/\'})
+      fake_runner.should_not_receive :run
+
+      lambda { Runner.new(argv).run }.should_not exit_with_code(0)
+    end
+
+    it "runs the specified tests when using a name (no pattern)" do
+      argv = ["path/to/file.rb", "-n", "#{fake_test_method}"]
+
+      fake_runner.should_receive(:run).with(["-n", fake_test_method])
+
+      lambda { Runner.new(argv).run }.should exit_with_code(0)
+    end
+
+    it "aborts if no test matches the given test name" do
+      argv = ["path/to/file.rb", "-n", "method"]
+
+      STDERR.should_receive(:write).with(%r{No test name matches \'method\'})
+      fake_runner.should_not_receive :run
+
+      lambda { Runner.new(argv).run }.should_not exit_with_code(0)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,38 @@
+require 'zeus/rails'
+
+module Zeus::M
+  VERSION = "0.0.0.test"
+end
+
+RSpec::Matchers.define :exit_with_code do |exp_code|
+  actual = nil
+  match do |block|
+    begin
+      block.call
+    rescue SystemExit => e
+      actual = e.status
+    end
+    actual and actual == exp_code
+  end
+  failure_message_for_should do |block|
+    "expected block to call exit(#{exp_code}) but exit" +
+      (actual.nil? ? " not called" : "(#{actual}) was called")
+  end
+  failure_message_for_should_not do |block|
+    "expected block not to call exit(#{exp_code})"
+  end
+  description do
+    "expect block to call exit(#{exp_code})"
+  end
+end
+
+def stub_system_methods
+  Dir.stub!(:glob).and_return(["path/to/file.rb"])
+  Kernel.stub!(:load).and_return
+end
+
+RSpec.configure do |config|
+  config.before(:each) do
+    stub_system_methods
+  end
+end

data/zeus.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+# This preamble is basically used to deal with bundler/gem_tasks, which loads the gemspec
+# on rake init, even though some prerequisites are not generated until `rake build` is invoked.
+version = begin
+            require File.expand_path('../lib/zeus/version', __FILE__)
+            Zeus::VERSION
+          rescue LoadError
+            "0.0.0"
+          end
+
+files = File.exist?('MANIFEST') ? File.read("MANIFEST").lines.map(&:chomp) : []
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Burke Libbey", "Arturo Pie"]
+  gem.email         = ["burke@libbey.me"]
+  gem.description   = %q{Boot any rails app in under a second}
+  gem.summary       = %q{Zeus is an intelligent preloader for ruby applications. It allows normal development tasks to be run in a fraction of a second.}
+  gem.homepage      = "http://zeus.is"
+
+  gem.files         = files
+  gem.extensions    = ["ext/inotify-wrapper/extconf.rb"]
+  gem.executables   = ['zeus']
+  gem.test_files    = []
+  gem.name          = "zeus-edge"
+  gem.require_paths = ["lib"]
+  gem.version       = version
+  gem.license       = "MIT"
+
+  gem.add_development_dependency "rspec", '~>2.12.0'
+
+  gem.add_runtime_dependency "method_source", ">= 0.6.7"
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: zeus-edge
+version: !ruby/object:Gem::Version
+  version: 0.12.1
+  prerelease: 
+platform: ruby
+authors:
+- Burke Libbey
+- Arturo Pie
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: method_source
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.6.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.6.7
+description: Boot any rails app in under a second
+email:
+- burke@libbey.me
+executables:
+- zeus
+extensions:
+- ext/inotify-wrapper/extconf.rb
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- lib/zeus.rb
+- lib/zeus/m.rb
+- lib/zeus/rails.rb
+- lib/zeus/load_tracking.rb
+- lib/zeus/m/test_collection.rb
+- lib/zeus/m/test_method.rb
+- lib/zeus/plan.rb
+- build/zeus-linux-amd64
+- build/fsevents-wrapper
+- build/zeus-darwin-amd64
+- build/zeus-linux-386
+- spec/fake_mini_test.rb
+- spec/m_spec.rb
+- spec/spec_helper.rb
+- zeus.gemspec
+- ext/inotify-wrapper/inotify-wrapper.cpp
+- ext/inotify-wrapper/extconf.rb
+- bin/zeus
+- Rakefile
+- Gemfile
+- man/build/zeus-start
+- man/build/zeus-init
+- man/build/zeus
+- man/build/zeus-start.txt
+- man/build/zeus-init.txt
+- man/build/zeus.txt
+homepage: http://zeus.is
+licenses:
+- MIT
+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: Zeus is an intelligent preloader for ruby applications. It allows normal
+  development tasks to be run in a fraction of a second.
+test_files: []