app-racket 0.1.0

data/.gitignore

@@ -0,0 +1,3 @@
+dummy.log
+*.swp
+*.gem

data/README.markdown

@@ -0,0 +1,61 @@
+## Racket
+### Listen to your app.
+
+Warning: very untested and hacky, may cause blindness, etc, etc.
+
+Ever wanted a completely ambient view of your app's performance and progress?
+Racket lets you step back and experience your applications' events as pure light
+and sound. Potentially great for pattern discovery, team morale, and stoner parties.
+Racket uses a custom logfile format, but could be extended to read any line-based
+log file, a la gltail.
+
+Sounds live in the "sounds" directory; wav, mp3, aiff and even wacky formats like OggVorbis are supported.
+
+Events and corresponding reactions are defined in `config/matcher.rb`
+
+## Installing:
+
+    ./install_dependencies.sh
+
+## Usage:
+
+    # start your web-app, or simulate it:
+    ./bin/event_simulator > dummy.log &
+
+    # run app-racket with rsdl wrapper:
+    rsdl bin/racket dummy.log
+
+    # bask in the insanity of your app's racket!
+
+## TODO:
+ * implement tailing over ssh, a la GlTail
+ * implement light control via [arduino](http://rad.rubyforge.org/)
+ * figure out if syslog is what we want for aggregate logfiles from
+   multiple apps/servers into a single stream
+
+## Acknowledgements:
+Thanks to the author of the original "sonic compiler" paper, wherever you are. Also thanks to
+[formalplay](http://formalplay.com),
+[jacius](http://github.com/jacius),
+[fudgie](http://www.fudgie.org),
+[stamen](http://stamen.com/),
+[slowmotionlandscape](http://companypolicy.tv),
+the [monome kids](http://monome.org/),
+and [ambient devices](http://ambientdevices.myshopify.com/products/stock-orb)
+for inspiration. 
+
+## Notes on installation:
+Playing audio in Ruby is much messier than I expected before starting
+this project, especially having seen things like Giles' archeopteryx.
+Racket depends on several external libraries, primarily because
+SDL (the cross-platform multimedia library) itself depends on several
+obscure audio format decoders to even play simple files, e.g. Ogg
+Vorbis and MikMod.
+
+On top of those, on OS X SDL also requires a ruby wrapper called
+rsdl, plus we interface to SDL from ruby via something called
+rubygame, which itself requires things like the FFI gems.
+
+But fear not: the racket installer script handles all that
+for you. On my MacBook Pro the full shebang takes about 4m45s to
+download, compile, and install everything, which isn't bad.

data/Rakefile

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'rake'
+require 'rake/rdoctask'
+
+GEM_NAME = "app-racket"
+AUTHORS = ["John Manoogian III", "Erik Michaels-Ober"]
+EMAIL = "jm3@jm3.net"
+HOMEPAGE = "http://github.com/jm3/racket"
+SUMMARY = "Listen to your app."
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = GEM_NAME
+    gemspec.summary = SUMMARY
+    gemspec.description = gemspec.summary
+    gemspec.authors = AUTHORS
+    gemspec.email = EMAIL
+    gemspec.homepage = HOMEPAGE
+    gemspec.bindir = "bin"
+    gemspec.executables = ["app-racket"]
+    gemspec.default_executable = "app-racket"
+    gemspec.add_dependency("rsdl", ">= 0.1.2")
+    gemspec.add_dependency("rubygame", ">= 2.6.2")
+    gemspec.add_dependency("file-tail", ">= 1.0.4")
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/app-racket.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{app-racket}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["John Manoogian III", "Erik Michaels-Ober"]
+  s.date = %q{2009-11-21}
+  s.default_executable = %q{app-racket}
+  s.description = %q{Listen to your app.}
+  s.email = %q{jm3@jm3.net}
+  s.executables = ["app-racket"]
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "bin/event_simulator",
+     "bin/app-racket",
+     "config/matcher.rb",
+     "install_dependencies.sh",
+     "app-racket.gemspec",
+     "sounds/bing-bong.wav",
+     "sounds/notify_cardinal1.aiff",
+     "sounds/notify_cardinal2.aiff",
+     "sounds/notify_original.aiff",
+     "sounds/notify_robin.aiff",
+     "sounds/phasing-bendy-bells.wav",
+     "sounds/savage.wav",
+     "sounds/skwlechy.wav",
+     "sounds/squeaks.wav",
+     "sounds/tiny-bubbles.mp3",
+     "sounds/winding-weird-loop.wav"
+  ]
+  s.homepage = %q{http://github.com/jm3/racket}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Listen to your app.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rsdl>, [">= 0.1.2"])
+      s.add_runtime_dependency(%q<rubygame>, [">= 2.6.2"])
+      s.add_runtime_dependency(%q<file-tail>, [">= 1.0.4"])
+    else
+      s.add_dependency(%q<rsdl>, [">= 0.1.2"])
+      s.add_dependency(%q<rubygame>, [">= 2.6.2"])
+      s.add_dependency(%q<file-tail>, [">= 1.0.4"])
+    end
+  else
+    s.add_dependency(%q<rsdl>, [">= 0.1.2"])
+    s.add_dependency(%q<rubygame>, [">= 2.6.2"])
+    s.add_dependency(%q<file-tail>, [">= 1.0.4"])
+  end
+end
+

data/bin/app-racket

@@ -0,0 +1,82 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'rubygame'
+require 'file/tail'
+require 'singleton'
+include Rubygame
+
+class Racket
+  include Singleton
+  attr_accessor :events
+
+  def initialize
+    @events = []
+  end
+
+  # Push an event to the bottom of the stack.
+  def push(event)
+    @events.push(event)
+  end
+
+  # Removes the top-most event.
+  def pop
+    @events.pop
+  end
+end
+
+class Event
+  attr_accessor :regex, :description, :reaction
+
+  def initialize(regex, description)
+    @regex = regex
+    @description = description
+  end
+
+  def play(sound)
+    @reaction = Reaction.new(sound)
+  end
+
+  def to_s
+    "#{description}\n"
+  end
+end
+
+class Reaction
+  attr_accessor :sound
+
+  def initialize(sound)
+    @sound = "sounds/#{sound}"
+  end
+end
+
+Rubygame.init
+
+def match(regex, description)
+  @racket = Racket.instance
+  @event = Event.new(regex, description)
+  @racket.push(@event)
+  @event
+end
+
+def run
+  # puts "Using audio driver:" + Rubygame.audio_driver
+  Sound.autoload_dirs = ["sounds"]
+
+  require 'config/matcher'
+
+  @file = File.open(ARGV.first)
+  @file.extend(File::Tail)
+  @file.tail do |line|
+    @racket.events.each do |event|
+      if line.match(event.regex)
+        puts event
+        Sound.load(event.reaction.sound).play
+      end
+    end
+  end
+end
+
+event_thread = Thread.new{run}
+event_thread.join
+Rubygame.quit

data/bin/event_simulator

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# generate a fake stream of events for testing
+
+events = [
+  'tweet',
+  'signup',
+  'invite',
+  'login',
+  'error',
+]
+
+while true
+  puts "#{Time.now}, #{events[rand(events.size)]}"
+  $stdout.flush
+  sleep(rand(3) + 1)
+end

data/config/matcher.rb

@@ -0,0 +1,14 @@
+match(/tweet/, ":) Someone just tweeted!").
+  play("bird_1.aiff")
+
+match(/signup/, ":) Someone just signed up!").
+  play("bird_2.aiff")
+
+match(/invite/, ":) Someone just sent an invite!").
+  play("bird_3.aiff")
+
+match(/login/, ":) Someone just logged in!").
+  play("bird_4.aiff")
+
+match(/error/, ":( Something bad happened!").
+  play("cat.aiff")

data/install_dependencies.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+uname=`uname`
+if [ "$uname" = "Darwin" ] ; then
+  sudo port -d selfupdate && \
+  sudo port clean libsdl && \
+  sudo port install libsdl libsdl_gfx libsdl_ttf libsdl_image libogg libvorbis smpeg libmikmod libsdl_mixer libffi
+else
+  sudo aptitude update && \
+  sudo aptitude install libsdl1.2-dev libogg-dev libogg libvorbis-dev libvorbis
+fi

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification 
+name: app-racket
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- John Manoogian III
+- Erik Michaels-Ober
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-21 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rsdl
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 0
+        - 1
+        - 2
+        version: 0.1.2
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rubygame
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 2
+        - 6
+        - 2
+        version: 2.6.2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: file-tail
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 1
+        - 0
+        - 4
+        version: 1.0.4
+  type: :runtime
+  version_requirements: *id003
+description: Listen to your app.
+email: jm3@jm3.net
+executables: 
+- app-racket
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- README.markdown
+- Rakefile
+- VERSION
+- bin/event_simulator
+- bin/app-racket
+- config/matcher.rb
+- install_dependencies.sh
+- app-racket.gemspec
+- sounds/bing-bong.wav
+- sounds/notify_cardinal1.aiff
+- sounds/notify_cardinal2.aiff
+- sounds/notify_original.aiff
+- sounds/notify_robin.aiff
+- sounds/phasing-bendy-bells.wav
+- sounds/savage.wav
+- sounds/skwlechy.wav
+- sounds/squeaks.wav
+- sounds/tiny-bubbles.mp3
+- sounds/winding-weird-loop.wav
+homepage: http://github.com/jm3/racket
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: Listen to your app.
+test_files: []
+