ruby-osc 0.3.1

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.0.1 2009-08-27
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,15 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+examples/localtest.rb
+lib/ruby-osc.rb
+lib/ruby-osc/bundle.rb
+lib/ruby-osc/client.rb
+lib/ruby-osc/message.rb
+lib/ruby-osc/server.rb
+ruby-osc.gemspec
+spec/bundle_spec.rb
+spec/message_spec.rb
+spec/server_spec.rb
+spec/spec_helper.rb

data/README.rdoc

@@ -0,0 +1,81 @@
+= ruby-osc
+
+http://github.com/maca/ruby-osc
+
+Concise OSC implementation for Ruby
+
+  * 1.9.1 and jRuby compatible
+  * Complies with OSC 1.0 specification
+  * Uses EventMachine for networking and lightweight soft-real-time bundle scheduling
+  
+== SYNOPSIS:
+
+    require 'rubygems'
+    require 'ruby-osc'
+    
+    include  OSC
+    
+    server = Server.new 9090
+    client = Client.new 9090
+    
+    server.add_pattern /.*/ do |*args|       # this will match any address
+      p "/.*/:       #{ args.join(', ') }"
+    end
+    
+    server.add_pattern %r{foo/.*} do |*args| # this will match any /foo node
+      p "%r{foo/.*}: #{ args.join(', ') }"
+    end
+    
+    server.add_pattern "/foo/bar" do |*args| # this will just match /foo/bar address
+      p "'/foo/bar': #{ args.join(', ') }"
+    end
+    
+    server.add_pattern "/exit" do |*args|    # this will just match /exit address
+      exit
+    end
+    
+    client.send Message.new('/foo/bar', 1, 1.2, 'a string')
+    client.send Message.new('/foo/bar/zar', 1, 1.2, 'a string')
+    client.send Bundle.new(Time.now + 2, Message.new('/exit'))
+    
+    OSC::Thread.join
+
+== REQUIREMENTS:
+
+eventmachine
+
+== INSTALL:
+
+	sudo gem install ruby-osc –-source http://gemcutter.org
+
+	Although I prefer not to use sudo: http://dev.innovationfactory.nl/2009/10/26/never-use-sudo-gem-install-again/
+	
+== TODO:
+
+- OSC 1.1 compatibility mode
+- Full documentation
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Macario Ortega
+
+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/Rakefile

@@ -0,0 +1,25 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+require './lib/ruby-osc'
+
+Hoe.plugin :newgem
+# Hoe.plugin :website
+# Hoe.plugin :cucumberfeatures
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec 'ruby-osc' do
+  self.developer 'Macario Ortega', 'macarui@gmail.com'
+  self.rubyforge_name = self.name # TODO this is default value
+  self.extra_deps     = [['eventmachine','>= 0.12.8']]
+
+end
+
+require 'newgem/tasks'
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# remove_task :default
+# task :default => [:spec, :features]

data/examples/localtest.rb

@@ -0,0 +1,30 @@
+require 'rubygems'
+# require "#{ File.dirname __FILE__ }/../lib/ruby-osc" 
+require 'ruby-osc'
+
+include  OSC
+
+server = Server.new 9090
+client = Client.new 9090
+
+server.add_pattern /.*/ do |*args|       # this will match any address
+  p "/.*/:       #{ args.join(', ') }"
+end
+
+server.add_pattern %r{foo/.*} do |*args| # this will match any /foo node
+  p "%r{foo/.*}: #{ args.join(', ') }"
+end
+
+server.add_pattern "/foo/bar" do |*args| # this will just match /foo/bar address
+  p "'/foo/bar': #{ args.join(', ') }"
+end
+
+server.add_pattern "/exit" do |*args|    # this will just match /exit address
+  exit
+end
+
+client.send Message.new('/foo/bar', 1, 1.2, 'a string')
+client.send Message.new('/foo/bar/zar', 1, 1.2, 'a string')
+client.send Bundle.new(Time.now + 2, Message.new('/exit'))
+
+OSC::Thread.join

data/lib/ruby-osc/bundle.rb

@@ -0,0 +1,52 @@
+module OSC
+  class Bundle < Array
+    attr_accessor :timetag
+
+    def initialize timetag = nil, *args
+      args.each{ |arg| raise TypeError, "#{ arg.inspect } is required to be a Bundle or Message" unless Bundle === arg or Message === arg }
+      raise TypeError, "#{ timetag.inspect } is required to be Time or nil" unless timetag == nil or Time === timetag
+      super args
+      @timetag = timetag
+    end
+
+    def encode
+      timetag =
+      if @timetag
+        time, tag, dir = OSC.encoding_directive @timetag
+        time.pack dir
+      else "\000\000\000\000\000\000\000\001" end
+        
+      "#bundle\000#{ timetag }" + collect do |x|
+        x = x.encode
+        [x.size].pack('N') + x
+      end.join
+    end
+
+    def self.decode string
+      string.gsub! /^#bundle\000/, ''
+      t1, t2, content_str = string.unpack('N2a*')
+      
+      timetag   = Time.at(t1 + t2 / (2**32.0) - 2_208_988_800) rescue nil
+      scanner   = StringScanner.new content_str
+      args      = []
+      
+      until scanner.eos?
+        size    = scanner.scan(/.{4}/).unpack('N').first
+        arg_str = scanner.scan(/.{#{ size }}/nm) rescue raise(DecodeError, "An error occured while trying to decode bad formatted osc bundle")
+        args   << OSC.decode(arg_str)
+      end
+      
+      new timetag, *args
+    end
+    
+    def == other
+      self.class == other.class and self.timetag == other.timetag and self.to_a == other.to_a
+    end
+
+    def to_a; Array.new self; end
+    
+    def to_s
+      "OSC::Bundle(#{ self.join(', ') })"
+    end
+  end
+end

data/lib/ruby-osc/client.rb

@@ -0,0 +1,39 @@
+# From the Funaba osc gem:
+module OSC
+  class Client
+ 
+    def initialize port, host = 'localhost'
+      @socket = UDPSocket.new
+      @socket.connect 'localhost', port
+    end
+ 
+    def send mesg, *args
+      @socket.send mesg.encode, 0
+    end
+  end
+end
+
+# module OSC
+#   class Client
+#     
+#     def initialize port, address = 'localhost'
+#       @address, @port = address, port
+#       run
+#     end
+#     
+#     def run
+#       @connection = EventMachine.open_datagram_socket 'localhost', 0, Connection
+#     end
+#  
+#     def stop
+#       @connection.close_connection if @connection
+#     end
+#  
+#     def send item
+#       @connection.send_datagram item.encode, @address, @port 
+#     end
+#     
+#     class Connection < EventMachine::Connection #:nodoc:
+#     end
+#   end
+# end

data/lib/ruby-osc/message.rb

@@ -0,0 +1,66 @@
+module OSC
+  class Message
+    attr_accessor :address, :time, :args
+
+    def initialize address = '', *args
+      args.collect! { |arg| OSC.coerce_argument arg }
+      args.flatten! # won't harm we're not accepting arrays anyway, in case an custom coerced arg coerces to Array eg. Hash
+      raise(TypeError, "Expected address to be a string") unless String === address
+      @address, @args = address, args
+    end
+
+    def encode
+      objs, tags, dirs = @args.collect { |arg| OSC.encoding_directive arg }.transpose
+      dirs ||= [] and objs ||= []
+
+      [",#{ tags and tags.join }", @address].each do |str|
+        obj, tag, dir = OSC.encoding_directive str
+        objs.unshift obj
+        dirs.unshift dir
+      end
+
+      objs.flatten.compact.pack dirs.join
+    end
+
+    def == other
+      self.class == other.class and to_a == other.to_a
+    end
+
+    def to_a; @args.dup.unshift(@address) end
+    def to_s; "OSC::Message(#{ args.join(', ') })" end
+
+    def self.decode string
+      scanner        = StringScanner.new string
+      address, tags  = (1..2).map do
+        string       = scanner.scan(/[^\000]+\000/)
+        scanner.pos += OSC.padding_size(string.size)
+        string.chomp("\000")
+      end
+
+      args = []
+      tags.scan(/\w/) do |tag|
+        case tag
+        when 'i'
+          int = scanner.scan(/.{4}/).unpack('N').first
+          args.push( int > (2**31-1) ? int - 2**32 : int )
+        when 'f'
+          args.push scanner.scan(/.{4}/nm).unpack('g').first
+        when 's'
+          str = scanner.scan(/[^\000]+\000/)
+          scanner.pos += OSC.padding_size(str.size)
+          args.push str.chomp("\000")
+        when 'b'
+          size = scanner.scan(/.{4}/).unpack('N').first
+          str  = scanner.scan(/.{#{ size }}/nm)
+          scanner.pos += OSC.padding_size(size + 4)
+          args.push Blob.new(str)
+        else
+          raise DecodeError, "#{ t } is not a known tag"
+        end
+      end
+
+      new address, *args
+    end
+
+  end
+end

data/lib/ruby-osc/server.rb

@@ -0,0 +1,73 @@
+
+module OSC
+  class Server
+    attr_accessor :port, :address
+
+    def initialize port, address = 'localhost'
+      @port, @address   = port, address
+      @queue, @patterns = [], []
+      @mutex = Mutex.new
+      run
+    end
+
+    def run
+      @connection = EventMachine.open_datagram_socket @address, @port, Connection, self
+      check_queue
+    end
+
+    def stop
+      return unless @connection
+      @connection.close_connection
+      @timer.cancel
+    end
+
+    def add_pattern pattern, &block
+      raise ArgumentError.new("A block must be given") unless block
+      @patterns << [pattern, block]
+    end
+
+    def delete_pattern pattern
+      @patterns.delete pattern
+    end
+
+    def receive data
+      case decoded = OSC.decode(data)
+      when Bundle
+        decoded.timetag.nil? ? decoded.each{ |m| dispatch m } : @mutex.synchronize{@queue.push(decoded)}
+      when Message
+        dispatch decoded
+      end
+      rescue => e 
+        warn "Bad data received: #{ e }"
+    end
+
+    private
+    def check_queue
+      @timer = EventMachine::PeriodicTimer.new 0.002 do
+        now  = Time.now
+        @mutex.synchronize do
+          @queue.delete_if do |bundle|
+            bundle.each{ |m| dispatch m } if delete = now >= bundle.timetag
+            delete
+          end
+        end
+      end
+    end
+
+    def dispatch message
+      @patterns.each do |pat, block| 
+        block.call(*message.to_a) if pat === message.address
+      end
+    end
+
+    class Connection < EventMachine::Connection #:nodoc:
+      def initialize server
+        @server = server
+      end
+
+      def receive_data data
+        @server.receive(data) 
+      end
+    end
+  end
+end

data/lib/ruby-osc.rb

@@ -0,0 +1,60 @@
+
+require 'rubygems'
+require 'eventmachine'
+require 'socket' # Strange side effects with eventmachine udp client and SuperCollider
+require 'strscan'
+require 'thread'
+
+$:.unshift( File.dirname( __FILE__ ) )
+
+require 'ruby-osc/message'
+require 'ruby-osc/bundle'
+require 'ruby-osc/server'
+require 'ruby-osc/client'
+
+module OSC
+  VERSION = '0.3.1'
+  Thread  = EM.reactor_running? ? nil : Thread.new { EM.run }
+  Thread.run if RUBY_VERSION.to_f >= 1.9
+  EM.error_handler { |e| puts e }
+  EM.set_quantum 5
+    
+  class DecodeError < StandardError; end
+  
+  class Blob < String; end
+  
+  module OSCArgument
+    def to_osc_type
+      raise NotImplementedError, "#to_osc_type method should be implemented for #{ self.class }"
+    end
+  end
+  
+  def self.coerce_argument arg
+    case arg
+    when OSCArgument then arg.to_osc_type
+    when Symbol      then arg.to_s
+    when String, Float, Fixnum, Blob, String then arg # Pure osc 1.0 specification
+    else raise(TypeError, "#{ arg.inspect } is not a valid Message argument") end
+  end
+  
+  def self.decode str #:nodoc:
+    str.match(/^#bundle/) ? Bundle.decode(str) : Message.decode(str)
+  end
+  
+  def self.padding_size size
+    (4 - (size) % 4) % 4 
+  end
+  
+  def self.encoding_directive obj #:nodoc:
+    case obj
+    when Float  then [obj, 'f', 'g']
+    when Fixnum then [obj, 'i', 'N']
+    when Blob   then [[obj.size, obj], 'b', "Na*x#{ padding_size obj.size + 4 }"]
+    when String then [obj, 's', "Z*x#{ padding_size obj.size + 1 }"]
+    when Time
+      t1, fr = (obj.to_f + 2208988800).divmod(1)
+      t2 = (fr * (2**32)).to_i
+      [[t1, t2], 't', 'N2']
+    end
+  end
+end

data/ruby-osc.gemspec

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ruby-osc}
+  s.version = "0.3.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Macario Ortega"]
+  s.date = %q{2010-01-17}
+  s.description = %q{}
+  s.email = ["macarui@gmail.com"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt"]
+  s.files = ["History.txt", "Manifest.txt", "README.rdoc", "Rakefile", "examples/localtest.rb", "lib/ruby-osc.rb", "lib/ruby-osc/bundle.rb", "lib/ruby-osc/client.rb", "lib/ruby-osc/message.rb", "lib/ruby-osc/server.rb", "ruby-osc.gemspec", "spec/bundle_spec.rb", "spec/message_spec.rb", "spec/server_spec.rb", "spec/spec_helper.rb"]
+  s.homepage = %q{http://github.com/maca/ruby-osc}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{ruby-osc}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{}
+
+  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<eventmachine>, [">= 0.12.8"])
+      s.add_development_dependency(%q<rubyforge>, [">= 2.0.3"])
+      s.add_development_dependency(%q<gemcutter>, [">= 0.3.0"])
+      s.add_development_dependency(%q<hoe>, [">= 2.5.0"])
+    else
+      s.add_dependency(%q<eventmachine>, [">= 0.12.8"])
+      s.add_dependency(%q<rubyforge>, [">= 2.0.3"])
+      s.add_dependency(%q<gemcutter>, [">= 0.3.0"])
+      s.add_dependency(%q<hoe>, [">= 2.5.0"])
+    end
+  else
+    s.add_dependency(%q<eventmachine>, [">= 0.12.8"])
+    s.add_dependency(%q<rubyforge>, [">= 2.0.3"])
+    s.add_dependency(%q<gemcutter>, [">= 0.3.0"])
+    s.add_dependency(%q<hoe>, [">= 2.5.0"])
+  end
+end

data/spec/bundle_spec.rb

@@ -0,0 +1,99 @@
+require "#{ File.dirname __FILE__ }/spec_helper"
+
+describe Bundle do
+  
+  it "should accept bundle" do
+    Bundle.new( Time.now, Bundle.new ).to_a.should == [Bundle.new]
+  end
+
+  it "should accept message" do
+    Bundle.new( Time.now, Message.new ).to_a.should == [Message.new]
+  end
+
+  it "should rise TypeError if passing passing incorrect type" do
+    lambda { Bundle.new Time.now, 1 }.should raise_error(TypeError)
+  end
+  
+  it "should raise TypeError if timetag is not Time" do
+    lambda { Bundle.new 1 }.should raise_error(TypeError)
+  end
+  
+  it "should accept nil for timetag" do
+    Bundle.new nil
+  end
+
+  describe 'Encode/decode' do
+    shared_examples_for 'Encodable Bundle' do
+      it "should encode" do
+        @bundle.encode.should == @expected
+      end
+      
+      it "should decode to bundle" do
+        Bundle.decode(@expected).should be_a(Bundle)
+      end
+      
+      it "should decode timetag" do
+        Bundle.decode(@expected).timetag.should == @bundle.timetag
+      end
+      
+      it "should actually decode" do
+        Bundle.decode(@expected).should == @bundle
+      end
+    end
+  end
+  
+  describe 'Empty bundle nil timetag' do
+    before do
+      @bundle   = Bundle.new
+      @expected = "#bundle\000\000\000\000\000\000\000\000\001"
+    end
+    it_should_behave_like 'Encodable Bundle'
+  end
+  
+  describe 'Empty bundle with timetag' do
+    before do
+      @bundle   = Bundle.new Time.at(1251420949.16959)
+      @expected = [35, 98, 117, 110, 100, 108, 101, 0, 206, 65, 169, 149, 43, 106, 64, 0].pack('C*')
+    end
+    it_should_behave_like 'Encodable Bundle'
+  end
+  
+  describe 'Bundle with timetag and messages' do
+    before do
+      @bundle   = Bundle.new Time.at(946702800), Message.new('/bar/foo', 4, 3, 2, 1), Message.new('/foo/bar', 1, 2, 3, 4)
+      @expected = [35, 98, 117, 110, 100, 108, 101, 0, 188, 24, 8, 80, 0, 0, 0, 0, 0, 0, 0, 36, 47, 98, 97, 114, 47, 102, 111, 111, 0, 0, 0, 0, 44, 105, 105, 105, 105, 0, 0, 0, 0, 0, 0, 4, 0, 0, 0, 3, 0, 0, 0, 2, 0, 0, 0, 1, 0, 0, 0, 36, 47, 102, 111, 111, 47, 98, 97, 114, 0, 0, 0, 0, 44, 105, 105, 105, 105, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 2, 0, 0, 0, 3, 0, 0, 0, 4].pack('C*')
+    end
+    it_should_behave_like 'Encodable Bundle'
+  end
+  
+  describe 'Nested bundles' do
+    before do
+      @bundle   = Bundle.new( nil, Bundle.new(nil, Message.new('/a')), Message.new('/b') )
+      @expected = "#bundle\000\000\000\000\000\000\000\000\001\000\000\000\034#bundle\000\000\000\000\000\000\000\000\001\000\000\000\b/a\000\000,\000\000\000\000\000\000\b/b\000\000,\000\000\000"
+    end
+    it_should_behave_like 'Encodable Bundle'
+  end
+  
+  describe 'Complex blob' do
+    before do
+      data      = [ 83, 67, 103, 102, 0, 0, 0, 1, 0, 1, 4, 104, 111, 108, 97, 0, 2, 67, -36, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 6, 83, 105, 110, 79, 115, 99, 2, 0, 2, 0, 1, 0, 0, -1, -1, 0, 0, -1, -1, 0, 1, 2, 0, 0 ].pack('C*')
+      @bundle   = Bundle.new nil, Message.new('/d_recv', Blob.new(data), 0)
+      @expected = [35, 98, 117, 110, 100, 108, 101, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 76, 47, 100, 95, 114, 101, 99, 118, 0, 44, 98, 105, 0, 0, 0, 0, 56, 83, 67, 103, 102, 0, 0, 0, 1, 0, 1, 4, 104, 111, 108, 97, 0, 2, 67, 220, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 6, 83, 105, 110, 79, 115, 99, 2, 0, 2, 0, 1, 0, 0, 255, 255, 0, 0, 255, 255, 0, 1, 2, 0, 0, 0, 0, 0, 0].pack('C*')
+    end
+    it_should_behave_like 'Encodable Bundle'
+  end
+  
+  describe 'Complex blob 2' do
+    before do
+      data      = [ 83, 67, 103, 102, 0, 0, 0, 1, 0, 1, 2, 97, 109, 0, 7, 0, 0, 0, 0, 63, 0, 0, 0, 63, -128, 0, 0, 64, 0, 0, 0, -62, -58, 0, 0, 64, -96, 0, 0, -64, -128, 0, 0, 0, 4, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 4, 103, 97, 116, 101, 0, 0, 9, 112, 111, 114, 116, 97, 100, 111, 114, 97, 0, 1, 10, 109, 111, 100, 117, 108, 97, 100, 111, 114, 97, 0, 2, 3, 97, 109, 112, 0, 3, 0, 8, 7, 67, 111, 110, 116, 114, 111, 108, 1, 0, 0, 0, 4, 0, 0, 1, 1, 1, 1, 6, 83, 105, 110, 79, 115, 99, 1, 0, 2, 0, 1, 0, 0, 0, 0, 0, 2, -1, -1, 0, 0, 1, 6, 77, 117, 108, 65, 100, 100, 1, 0, 3, 0, 1, 0, 0, 0, 1, 0, 0, -1, -1, 0, 1, -1, -1, 0, 1, 1, 6, 83, 105, 110, 79, 115, 99, 2, 0, 2, 0, 1, 0, 0, 0, 0, 0, 1, -1, -1, 0, 0, 2, 12, 66, 105, 110, 97, 114, 121, 79, 112, 85, 71, 101, 110, 2, 0, 2, 0, 1, 0, 2, 0, 3, 0, 0, 0, 2, 0, 0, 2, 6, 69, 110, 118, 71, 101, 110, 1, 0, 17, 0, 1, 0, 0, 0, 0, 0, 0, -1, -1, 0, 2, -1, -1, 0, 0, -1, -1, 0, 2, -1, -1, 0, 3, -1, -1, 0, 0, -1, -1, 0, 3, -1, -1, 0, 2, -1, -1, 0, 4, -1, -1, 0, 2, -1, -1, 0, 3, -1, -1, 0, 5, -1, -1, 0, 6, -1, -1, 0, 0, -1, -1, 0, 3, -1, -1, 0, 5, -1, -1, 0, 6, 1, 12, 66, 105, 110, 97, 114, 121, 79, 112, 85, 71, 101, 110, 2, 0, 2, 0, 1, 0, 2, 0, 4, 0, 0, 0, 5, 0, 0, 2, 3, 79, 117, 116, 2, 0, 2, 0, 0, 0, 0, -1, -1, 0, 0, 0, 6, 0, 0, 0, 0 ].pack('C*')
+      @bundle   = Bundle.new nil, Message.new('/d_recv', Blob.new(data), 0)
+      @expected = [35, 98, 117, 110, 100, 108, 101, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 124, 47, 100, 95, 114, 101, 99, 118, 0, 44, 98, 105, 0, 0, 0, 1, 101, 83, 67, 103, 102, 0, 0, 0, 1, 0, 1, 2, 97, 109, 0, 7, 0, 0, 0, 0, 63, 0, 0, 0, 63, 128, 0, 0, 64, 0, 0, 0, 194, 198, 0, 0, 64, 160, 0, 0, 192, 128, 0, 0, 0, 4, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 4, 103, 97, 116, 101, 0, 0, 9, 112, 111, 114, 116, 97, 100, 111, 114, 97, 0, 1, 10, 109, 111, 100, 117, 108, 97, 100, 111, 114, 97, 0, 2, 3, 97, 109, 112, 0, 3, 0, 8, 7, 67, 111, 110, 116, 114, 111, 108, 1, 0, 0, 0, 4, 0, 0, 1, 1, 1, 1, 6, 83, 105, 110, 79, 115, 99, 1, 0, 2, 0, 1, 0, 0, 0, 0, 0, 2, 255, 255, 0, 0, 1, 6, 77, 117, 108, 65, 100, 100, 1, 0, 3, 0, 1, 0, 0, 0, 1, 0, 0, 255, 255, 0, 1, 255, 255, 0, 1, 1, 6, 83, 105, 110, 79, 115, 99, 2, 0, 2, 0, 1, 0, 0, 0, 0, 0, 1, 255, 255, 0, 0, 2, 12, 66, 105, 110, 97, 114, 121, 79, 112, 85, 71, 101, 110, 2, 0, 2, 0, 1, 0, 2, 0, 3, 0, 0, 0, 2, 0, 0, 2, 6, 69, 110, 118, 71, 101, 110, 1, 0, 17, 0, 1, 0, 0, 0, 0, 0, 0, 255, 255, 0, 2, 255, 255, 0, 0, 255, 255, 0, 2, 255, 255, 0, 3, 255, 255, 0, 0, 255, 255, 0, 3, 255, 255, 0, 2, 255, 255, 0, 4, 255, 255, 0, 2, 255, 255, 0, 3, 255, 255, 0, 5, 255, 255, 0, 6, 255, 255, 0, 0, 255, 255, 0, 3, 255, 255, 0, 5, 255, 255, 0, 6, 1, 12, 66, 105, 110, 97, 114, 121, 79, 112, 85, 71, 101, 110, 2, 0, 2, 0, 1, 0, 2, 0, 4, 0, 0, 0, 5, 0, 0, 2, 3, 79, 117, 116, 2, 0, 2, 0, 0, 0, 0, 255, 255, 0, 0, 0, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0].pack('C*')
+      end
+    it_should_behave_like 'Encodable Bundle'
+  end
+  
+  it 'Should raise OSC::DecodeError with bad encoded bundle' do
+    bad_data = "#bundle\000\000\000\000\000\000\000\000\001\000\000\000\034#bundle\000\000\000\000\000\001\000\000\000\b/a\000\000,\000\000\000\000\000\000\b/b\000\000,\000\000\000"
+    lambda { Bundle.decode bad_data }.should raise_error(DecodeError)
+  end
+end

data/spec/message_spec.rb

@@ -0,0 +1,164 @@
+require "#{ File.dirname __FILE__ }/spec_helper"
+
+describe Message do
+  
+  it "should raise TypeError if passing wrong type" do
+    lambda { Message.new('address', Class) }.should raise_error(TypeError)
+  end
+  
+  it "should raise TypeError if not passing a string for address" do
+    lambda { Message.new(OSC) }.should raise_error(TypeError)
+  end
+  
+  it "should have address" do
+    Message.new('/foo/bar').address.should == '/foo/bar'
+  end
+  
+  it "should collect args" do
+    Message.new('/foo/bar', 1, 2, 3, 4).args.size.should == 4
+  end
+  
+  it "should accept integer" do
+    Message.new('/foo/bar', 1).args.should == [1]
+  end
+  
+  it "should should accept float" do
+    Message.new('/foo/bar', 1.0).args.should == [1.0]
+  end
+  
+  it "should accept string" do
+    Message.new('/foo/bar', 'string').args.should == ['string']
+  end
+  
+  it "should accept Blob" do
+    Message.new('/foo/bar', Blob.new('blob')).args.should == [Blob.new('blob')]
+  end
+  
+  it "should convert to array" do
+    Message.new('/foo/bar', 1, 2, 3, 4).to_a.should == ['/foo/bar', 1, 2, 3, 4]
+  end
+  
+  describe 'Custom argument coercion' do
+    
+    before do
+      TrueClass.send(:include, OSCArgument)
+      TrueClass.send( :define_method, :to_osc_type){ 1 }
+      FalseClass.send(:include, OSCArgument)
+      FalseClass.send( :define_method, :to_osc_type){ 0 }
+      Hash.send(:include, OSCArgument)
+      Hash.send( :define_method, :to_osc_type) do 
+        self.to_a.collect{ |pair| pair.collect{ |a| OSC.coerce_argument a } }
+      end
+    end
+    
+    it "should accept true" do
+      Message.new('/foo/bar', true).args.should == [1]
+    end
+
+    it "should accept false" do
+      Message.new('/foo/bar', false).args.should == [0]
+    end
+
+    it "should accept hash" do
+      Message.new('/foo/bar', {:a => :b}).args.should == ["a", "b"]
+    end
+  end
+  
+  describe 'Encode/decode' do
+    shared_examples_for 'Encodable Message' do
+      it "should encode" do
+        @message.encode.should == @expected
+      end
+      
+      it "should decode to message" do
+        Message.decode(@expected).should be_a(Message)
+      end
+      
+      it "should decode address" do
+        Message.decode(@expected).address.should == @message.address
+      end
+      
+      it "should actually decode" do
+        Message.decode(@expected).to_a.inspect.should == @message.to_a.inspect.to_s # Problem with float comparing
+      end
+    end
+    
+    describe 'Address' do
+      before do
+        @message  = Message.new('/foo/bar/long/very/long/long/long/address')
+        @expected = "/foo/bar/long/very/long/long/long/address\000\000\000,\000\000\000"
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+    
+    describe 'Integer' do
+      before do
+        @message  = Message.new('/foo/barz', 2)
+        @expected = "/foo/barz\000\000\000,i\000\000\000\000\000\002"
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+    
+    describe 'Negative Integer' do
+      before do
+        @message  = Message.new('/foo/barz', -2)
+        @expected = "/foo/barz\000\000\000,i\000\000\377\377\377\376"
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+    
+    describe 'Float' do
+      before do
+        @message  = Message.new('/foo/bar', 1.10000002384186)
+        @expected = [47, 102, 111, 111, 47, 98, 97, 114, 0, 0, 0, 0, 44, 102, 0, 0, 63, 140, 204, 205].pack('C*')
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+    
+    describe 'Negative Float' do
+      before do
+        @message  = Message.new('/foo/bar', -1.10000002384186)
+        @expected = [47, 102, 111, 111, 47, 98, 97, 114, 0, 0, 0, 0, 44, 102, 0, 0, 191, 140, 204, 205].pack('C*')
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+    
+    describe 'String' do
+      before do
+        @message  = Message.new('/foo/bar', 'a string to encode')
+        @expected = "/foo/bar\000\000\000\000,s\000\000a string to encode\000\000"
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+
+    describe 'Multiple types' do
+      before do
+        @message  = Message.new('/foo/barzzz', 2, 1.44000005722046, 'basho')
+        @expected = [47, 102, 111, 111, 47, 98, 97, 114, 122, 122, 122, 0, 44, 105, 102, 115, 0, 0, 0, 0, 0, 0, 0, 2, 63, 184, 81, 236, 98, 97, 115, 104, 111, 0, 0, 0].pack('C*')
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+    
+    describe 'Blob' do
+      before do
+        @message  = Message.new('/foo/bar', Blob.new('test blob'))
+        @expected = "/foo/bar\000\000\000\000,b\000\000\000\000\000\ttest blob\000\000\000"
+      end
+      it_should_behave_like 'Encodable Message'
+      
+      it "should raise if size doesn't correspond and return empty message" do
+        lambda do
+          Message.decode("/foo/bar\000\000\000\000,b\000\000\000\000\000\020test blob\000\000\000")
+        end.should raise_error
+      end
+    end
+    
+    describe 'Lots of ints' do
+      before do
+        @message  = Message.new('/bar/foo', 4, 3, 2, 1)
+        @expected = "/bar/foo\000\000\000\000,iiii\000\000\000\000\000\000\004\000\000\000\003\000\000\000\002\000\000\000\001" 
+      end
+      it_should_behave_like 'Encodable Message'
+    end
+  end    
+end

data/spec/server_spec.rb

@@ -0,0 +1,5 @@
+require "#{ File.dirname __FILE__ }/spec_helper"
+
+describe Server do
+  it "should be specked but I am lazy"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'spec'
+
+$:.unshift( File.join( File.dirname( __FILE__), '..', 'lib' ) ) 
+
+require 'ruby-osc'
+include OSC

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-osc
+version: !ruby/object:Gem::Version 
+  version: 0.3.1
+platform: ruby
+authors: 
+- Macario Ortega
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-17 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.12.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rubyforge
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: gemcutter
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+    version: 
+description: ""
+email: 
+- macarui@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- examples/localtest.rb
+- lib/ruby-osc.rb
+- lib/ruby-osc/bundle.rb
+- lib/ruby-osc/client.rb
+- lib/ruby-osc/message.rb
+- lib/ruby-osc/server.rb
+- ruby-osc.gemspec
+- spec/bundle_spec.rb
+- spec/message_spec.rb
+- spec/server_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/maca/ruby-osc
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: ruby-osc
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: ""
+test_files: []
+