launch_tracks 0.1.0

data/README.rdoc

@@ -0,0 +1,63 @@
+= LaunchTracks
+
+LaunchTracks uses launchd and the Tracks Rack server to start your Ruby web
+apps on demand.
+
+== Install
+
+  gem install launch_tracks
+
+== Usage
+
+  cd /path/to/myapp
+  launch_tracks setup 4000
+
+Your app will automatically start once you visit http://localhost:4000/ and
+shutdown after 10 minutes idle.
+
+The output from stdout and stderr will be available at /tmp/myapp-out.txt and /tmp/myapp-err.txt respectively.
+
+To restart your app <tt>touch restart.txt</tt> in your app's base directory.
+
+=== Commands
+
+[setup]   Creates a launchd plist for your app in ~/Library/LaunchAgents, and
+          loads it, making your app available for on-demand startup. Requires a
+          port number for your app to run on as an argument.
+          Example: <tt>launch_tracks setup 4000</tt>
+
+[load]    Loads your app's launchd plist from ~/Library/LaunchAgents, making
+          your app available for on-demand startup.
+
+[unload]  Unloads your app's launchd plist from ~/Library/LaunchAgents,
+          disabling on-demand startup.
+
+[restart] Restart your app. The same can be achieved with
+          <tt>touch restart.txt</tt> in your app's base directory.
+
+[rm]      Unload and remove your app's plist from ~/Library/LaunchAgents,
+          permanently disabling it.
+
+== Licence
+
+(The MIT License)
+
+Copyright (c) 2012 Matthew Sadler
+
+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/bin/launch_tracks

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+require "fileutils"
+
+name = FileUtils.pwd.split("/").last
+label = "com.github.matsadler.launch_tracks.#{name}"
+logdir = "/tmp"
+plist_name = "#{label}.plist"
+plist_dir = File.expand_path("~/Library/LaunchAgents")
+plist_path = "#{plist_dir}/#{plist_name}"
+
+command, port = ARGV
+
+help = "Usage: launch_tracks help|setup PORTNUMBER|load|unload|restart|rm"
+
+case command
+when "help", "-h", "--help"
+  puts help
+  exit
+when "load"
+  exec "launchctl load #{plist_path}"
+when "unload"
+  exec "launchctl unload #{plist_path}"
+when "restart"
+  FileUtils.touch("restart.txt")
+  exit
+when "rm"
+  `launchctl unload #{plist_path}`
+  FileUtils.rm(plist_path)
+  exit
+when "setup"
+  abort help unless port =~ /^\d+$/
+  # continue
+else
+  abort help
+end
+
+plist = <<-PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  
+  <key>Label</key>
+  <string>#{label}</string>
+  
+  <key>WorkingDirectory</key>
+  <string>#{FileUtils.pwd}</string>
+  
+  <key>StandardOutPath</key>
+  <string>#{logdir}/#{name}-out.log</string>
+  
+  <key>StandardErrorPath</key>
+  <string>#{logdir}/#{name}-err.log</string>
+  
+  <key>EnvironmentVariables</key>
+  <dict>
+    #{ENV.map do |key,string|
+    "<key>#{key}</key>
+    <string>#{string}</string>"
+  end.join("\n    ")}
+  </dict>
+  
+  <key>ProgramArguments</key>
+  <array>
+    #{if File.exist?("Gemfile")
+    "<string>bundle</string>
+    <string>exec</string>
+    "
+    end}<string>rackup</string>
+    <string>-rlaunch_tracks</string>
+    <string>-slaunch_tracks</string>
+  </array>
+  
+  <key>Sockets</key>
+  <dict>
+    <key>http</key>
+    <dict>
+      <key>SockServiceName</key>
+      <string>#{port}</string>
+      <key>SockFamily</key>
+      <string>IPv4</string>
+    </dict>
+  </dict>
+  
+</dict>
+</plist>
+PLIST
+
+FileUtils.mkdir_p(plist_dir)
+File.open(plist_path, "w") {|f| f << plist}
+
+exec "launchctl load #{plist_path}"

data/lib/launch_tracks.rb

@@ -0,0 +1,16 @@
+require "fileutils"
+require "launch"
+require "tracks"
+require "rack/idle"
+
+Rack::Handler.register("launch_tracks", "LaunchTracks")
+
+module LaunchTracks
+  
+  def self.run(app, options={})
+    app = Rack::Idle.new(app, :watch => "restart.txt")
+    sockets = Launch::Job.checkin.sockets["http"]
+    Tracks.new(app, options).listen(sockets.first)
+  end
+  
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: launch_tracks
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Matthew Sadler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-22 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: launch
+  requirement: &70168027907900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70168027907900
+- !ruby/object:Gem::Dependency
+  name: tracks
+  requirement: &70168027907420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70168027907420
+- !ruby/object:Gem::Dependency
+  name: rack-idle
+  requirement: &70168027906960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70168027906960
+description: Automaticlly start Rack applications on demand using launchd.
+email: mat@sourcetagsandcodes.com
+executables:
+- launch_tracks
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- lib/launch_tracks.rb
+- README.rdoc
+- bin/launch_tracks
+homepage: http://github.com/matsadler/launch_tracks
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.rdoc
+- --charset
+- utf-8
+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.10
+signing_key: 
+specification_version: 3
+summary: Start Rack apps on demand with launchd.
+test_files: []