jsound 0.1.0-java

data/spec/jsound/midi/devices/repeater_device_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+module JSound::Midi::Devices
+  describe Repeater do
+
+    let(:repeater) { Repeater.new }
+    let(:output1) { mock 'device1' }
+    let(:output2) { mock 'device1' }
+
+    before { repeater >> [output1, output2] }
+
+    it "should pass all messages to its outputs" do
+      output1.should_receive(:message).once.with :the_message
+      output2.should_receive(:message).once.with :the_message
+      repeater.message :the_message
+    end
+
+  end
+end

data/spec/jsound/midi/devices/transformer_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+module JSound::Midi
+  module Devices
+
+    describe Transformer do
+
+      describe "#message" do
+        it "transform the messages using the block passed to .new" do
+          transformer = Transformer.new{|message| message.pitch += 12; message }
+          output = mock 'device'
+          transformer >> output
+          output.should_receive(:message).once.with MessageBuilder.note_on(72,100)
+          transformer.message MessageBuilder.note_on(60,100)
+        end
+      end
+
+    end
+
+  end
+end

data/spec/jsound/midi/devlice_list_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+module JSound::Midi
+
+  describe DeviceList do
+
+    let(:device1) { mock('device1', :description => 'Mock Device #1') }
+    let(:device2) { mock('device2', :description => 'Mock Device #2') }
+    let(:device3) { mock('device3', :description => 'Mock Device #3') }
+    let(:devices) { [device1,device2,device3] }
+    let(:device_list) { DeviceList.new devices }
+
+    describe '.new' do
+      it "constructs an empty device list with no arguments" do
+        DeviceList.new.should be_empty
+      end
+
+      it "constructs a list with the given arguments" do
+        DeviceList.new(devices).devices.should == devices
+      end
+    end
+
+    describe "#open" do
+      it "acts like #find and also opens the device" do
+        device2.should_receive :open
+        device_list.open(/Mock.*2/).should == device2
+      end
+
+      it "raises an error when no device is not found" do
+        lambda{ device_list.open(:nothing) }.should raise_error
+      end
+    end
+
+    describe "#/" do
+      it "finds and opens the first device matching a regexp constructed from the argument" do
+        device1.should_receive(:open)
+        (device_list/'Mock').should == device1
+      end
+
+      it "is case insensitive" do
+        device1.should_receive(:open)
+        (device_list/'mock').should == device1
+      end
+    end
+
+    describe "#method_missing" do
+      it "acts like #/ for unimplemented methods" do
+        device1.should_receive(:open)
+        device_list.mock.should == device1
+      end
+
+      it "treats '_' like a wildard" do
+        device2.should_receive(:open)
+        device_list.mock_2.should == device2
+      end
+
+    end
+
+  end
+end

data/spec/jsound/midi/message_builder_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+module JSound::Midi
+  describe MessageBuilder do
+
+    it 'should expose its methods as module functions' do
+      msg = MessageBuilder.note_on(60)
+      msg.type.should == :note_on    
+    end
+
+    context 'with MessageBuilder included' do
+      include MessageBuilder
+
+      it 'should provide a set of methods for building midi messages' do
+        msg = note_on(60)
+        msg.type.should == :note_on
+      end
+
+    end
+
+  end
+end

data/spec/jsound/midi/message_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+module JSound::Midi
+
+  describe Message do
+
+    let(:data) { [50,100]}
+    let(:channel) { 5 }
+    let(:message) { Message.new(data, channel) }
+
+    describe "#clone" do
+      it "constructs a new Message" do
+        message.clone.should_not be_equal message
+      end
+
+      it "constructs an equivalent Message" do
+        message.clone.should == message
+      end
+
+      it "constructs a new Message with the same data" do
+        message.clone.data.should == data
+      end
+
+      it "constructs a new Message with the same channel" do
+        message.clone.channel.should == channel
+      end
+    end
+
+  end
+end

data/spec/jsound/midi/messages/note_off_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+module JSound::Midi::Messages
+
+  describe NoteOff do
+
+    let(:pitch) { 60 }
+    let(:velocity) { 100 }
+    let(:channel) { 3 }
+    let(:note_off) { NoteOff.new(pitch,velocity,channel) }
+
+    describe ".from_java" do
+      before do
+        @java_message = javax.sound.midi.ShortMessage.new
+        @java_message.setMessage(javax.sound.midi.ShortMessage::NOTE_OFF, channel, pitch, velocity)
+      end
+
+      it "constructs a new instance from a javax.sound.midi.ShortMessage" do
+        NoteOff.from_java(@java_message).should be_a NoteOff
+      end
+
+      it "extracts the pitch from the data1 byte" do
+        NoteOff.from_java(@java_message).pitch.should == pitch
+      end
+
+      it "extracts the velocity from the data2 byte" do
+        NoteOff.from_java(@java_message).velocity.should == velocity
+      end
+
+      it "extracts the channel" do
+        NoteOff.from_java(@java_message).channel.should == channel
+      end
+
+      it "creates an equal object when called with itself's #to_java" do
+        NoteOff.from_java(note_off.to_java).should == note_off
+      end
+    end
+
+    describe "#to_java" do
+      it "creates a javax.sound.midi.ShortMessage" do
+        note_off.to_java.should be_a javax.sound.midi.ShortMessage
+      end
+
+      it "creates a message with a note_off command" do
+        note_off.to_java.command.should == javax.sound.midi.ShortMessage::NOTE_OFF
+      end
+
+      it "creates a message with pitch in the data1 byte" do
+        note_off.to_java.data1.should == pitch
+      end
+
+      it "creates a message with velocity in the data2 byte" do
+        note_off.to_java.data2.should == velocity
+      end
+
+      it "creates a message with the given channel" do
+        note_off.to_java.channel.should == channel
+      end
+    end
+
+
+  end
+end

data/spec/jsound/midi/messages/note_on_spec.rb

@@ -0,0 +1,109 @@
+require 'spec_helper'
+module JSound::Midi::Messages
+
+  describe NoteOn do
+
+    let(:pitch) { 60 }
+    let(:velocity) { 100 }
+    let(:channel) { 3 }
+    let(:note_on) { NoteOn.new(pitch,velocity,channel) }
+
+    describe ".from_java" do
+      before do
+        @java_message = javax.sound.midi.ShortMessage.new
+        @java_message.setMessage(javax.sound.midi.ShortMessage::NOTE_ON, channel, pitch, velocity)
+      end
+
+      it "constructs a new instance from a javax.sound.midi.ShortMessage" do
+        NoteOn.from_java(@java_message).should be_a NoteOn
+      end
+
+      it "extracts the pitch from the data1 byte" do
+        NoteOn.from_java(@java_message).pitch.should == pitch
+      end
+
+      it "extracts the velocity from the data2 byte" do
+        NoteOn.from_java(@java_message).velocity.should == velocity
+      end
+
+      it "extracts the channel" do
+        NoteOn.from_java(@java_message).channel.should == channel
+      end
+
+      it "creates an equal object when called with itself's #to_java" do
+        NoteOn.from_java(note_on.to_java).should == note_on
+      end
+    end
+
+    describe "#to_java" do
+      it "creates a javax.sound.midi.ShortMessage" do
+        note_on.to_java.should be_a javax.sound.midi.ShortMessage
+      end
+
+      it "creates a message with a NOTE_ON command" do
+        note_on.to_java.command.should == javax.sound.midi.ShortMessage::NOTE_ON
+      end
+
+      it "creates a message with pitch in the data1 byte" do
+        note_on.to_java.data1.should == pitch
+      end
+
+      it "creates a message with velocity in the data2 byte" do
+        note_on.to_java.data2.should == velocity
+      end
+
+      it "creates a message with the given channel" do
+        note_on.to_java.channel.should == channel
+      end
+    end
+
+    describe "#pitch" do
+      it "is the pitch of the message" do
+        note_on.pitch.should == pitch
+      end
+
+      it "is the first data byte" do
+        note_on.pitch.should == note_on.data[0]
+      end
+    end
+
+    describe "#pitch=" do
+      it "sets the pitch of the message" do
+        pitch2 = pitch+1
+        note_on.pitch = pitch2
+        note_on.pitch.should == pitch2
+      end
+
+      it "causes the java_message (returned from #to_java) to be regenereated" do
+        pitch2 = pitch+1
+        note_on.pitch = pitch2
+        note_on.to_java.data1.should == pitch2
+      end
+    end
+
+    describe "#velocity" do
+      it "is the velocity of the message" do
+        note_on.velocity.should == velocity
+      end
+
+      it "is the second data byte" do
+        note_on.velocity.should == note_on.data[1]
+      end
+    end
+
+    describe "#velocity=" do
+      it "sets the velocity of the message" do
+        velocity2 = velocity+1
+        note_on.velocity = velocity2
+        note_on.velocity.should == velocity2
+      end
+
+      it "causes the java_message (returned from #to_java) to be regenereated" do
+        velocity2 = velocity+1
+        note_on.velocity = velocity2
+        note_on.to_java.data2.should == velocity2
+      end
+    end
+
+  end
+end

data/spec/jsound/midi/messages/pitch_bend_spec.rb

@@ -0,0 +1,88 @@
+require 'spec_helper'
+module JSound::Midi::Messages
+
+  describe PitchBend do
+
+    let(:value) { 1000 }
+    let(:lsb) { value & 127 }
+    let(:msb) { (value >> 7) & 127 }
+    let(:channel) { 4 }
+    let(:pitch_bend) { PitchBend.new(value,channel) }
+
+    describe ".from_java" do
+      before do
+        @java_message = javax.sound.midi.ShortMessage.new
+        @java_message.setMessage(javax.sound.midi.ShortMessage::PITCH_BEND, channel, lsb, msb)
+      end
+
+      it "constructs a new instance from a javax.sound.midi.ShortMessage" do
+        PitchBend.from_java(@java_message).should be_a PitchBend
+      end
+
+      it "extracts the 14-bit value from the 2 7-bit data bytes" do
+        pitch_bend = PitchBend.from_java(@java_message)
+        pitch_bend.value.should == value
+      end
+
+      it "extracts the channel" do
+        PitchBend.from_java(@java_message).channel.should == channel
+      end
+
+      it "creates an equal object when called with itself's #to_java" do
+        PitchBend.from_java(pitch_bend.to_java).should == pitch_bend
+      end
+
+      it "creates an object that returns the java message in response to #to_java" do
+        PitchBend.from_java(@java_message).to_java.should be_equal @java_message
+      end
+    end
+
+    describe "#to_java" do
+      it "creates a javax.sound.midi.ShortMessage" do
+        pitch_bend.to_java.should be_a javax.sound.midi.ShortMessage
+      end
+
+      it "creates a message with a PITCH_BEND command" do
+        pitch_bend.to_java.command.should == javax.sound.midi.ShortMessage::PITCH_BEND
+      end
+
+      it "creates a message with the least significant 7-bits in the data1 byte" do
+        pitch_bend.to_java.data1.should == lsb
+      end
+
+      it "creates a message with the most significant 7-bits in the data2 byte" do
+        pitch_bend.to_java.data2.should == msb
+      end
+
+      it "creates a message with the given channel" do
+        pitch_bend.to_java.channel.should == channel
+      end
+    end
+
+    describe "#value" do
+      it "is the value of the message" do
+        pitch_bend.value.should == value
+      end
+
+      it "is the 14-bit value of the message" do
+        pitch_bend.value.should == lsb + (msb << 7)
+      end
+    end
+
+    describe "#value=" do
+      it "sets the value" do
+        pitch_bend.value = 2000
+        pitch_bend.value.should == 2000
+      end
+
+      it "affects the java message" do
+        pitch_bend.value = 2000
+        java_message = pitch_bend.to_java
+        java_message.data1.should == 2000 & 127
+        java_message.data2.should == (2000 >> 7) & 127
+      end
+
+    end
+
+  end
+end

data/spec/jsound/midi_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+module JSound
+  describe Midi do
+
+    # The spec doesn't care what MIDI devices are found, 
+    # but it better find something or this library is not useful.     
+
+    it 'should have DEVICES' do
+      Midi::DEVICES.should_not be_empty  
+    end
+
+    it 'should have some INPUTS or OUTPUTS' do
+      (Midi::INPUTS.length + Midi::OUTPUTS.length).should > 1
+    end 
+
+    context 'with Midi included' do
+      include Midi
+      describe '#refresh_devices' do
+        it 'should refresh the list of midi devices' do
+          Midi::DEVICES.clear
+          refresh_devices
+          Midi::DEVICES.should_not be_empty
+        end
+      end
+    end
+
+    it 'should expose #refresh_devices as a module function' do
+      Midi.refresh_devices
+    end
+
+  end
+end