midiator 0.3.2 → 0.3.3

data/CHANGELOG.md

@@ -0,0 +1,40 @@
+# midiator Changelog
+
+### 0.3.3 / 2010-11-13
+
+* convert build system to hoe
+* convert tests to rspec2
+
+### 0.3.2 / 2009-04-02
+
+* minor doc bug fix
+
+### 0.3.1 / 2009-04-02
+
+* Added DLSSynth example (Giles Bowkett)
+* Interface#play supports playing multiple notes at once (David Brady)
+* Added cygwin support (Adam Murray)
+
+### 0.3.0 / 2008-11-23
+
+* Added method to show allow drivers to give the user instructions
+* Added Control Change (CC) messages (Jeremy Voorhis)
+* Cleaned up CoreMIDI driver (Jeremy Voorhis)
+* Added software synth driver on OSX (Adam Murray & Jeremy Voorhis)
+
+### 0.2.0 / 2008-10-29
+
+* Cleaned up MIDI note shortcuts (Xavier Shay)
+* Fixed platform detection with Platform gem (Giles Bowkett)
+
+### 0.1.1 / 2008-10-19
+
+* Fix bug in the CoreMIDI driver
+
+### 0.1.0 / 2008-10-19
+
+* First release!
+
+### 0.0.1 / 2008-07-04
+
+* Project Created

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2008, Ben Bleything <ben@bleything.net>
+
+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/LICENSE.prp

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2006, 2007 Topher Cyll
+
+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/Manifest.txt

@@ -0,0 +1,32 @@
+CHANGELOG.md
+LICENSE
+LICENSE.prp
+Manifest.txt
+README.md
+Rakefile
+examples/a_little_end_music.rb
+examples/amen_break.rb
+examples/chords.rb
+examples/chromatic_scale.rb
+examples/drum_chords.rb
+examples/metronome.rb
+examples/synth.rb
+examples/twinkle.rb
+lib/midiator.rb
+lib/midiator/driver.rb
+lib/midiator/driver_registry.rb
+lib/midiator/drivers/alsa.rb
+lib/midiator/drivers/core_midi.rb
+lib/midiator/drivers/dls_synth.rb
+lib/midiator/drivers/mmj.rb
+lib/midiator/drivers/winmm.rb
+lib/midiator/drums.rb
+lib/midiator/exceptions.rb
+lib/midiator/interface.rb
+lib/midiator/notes.rb
+lib/midiator/timer.rb
+lib/string_extensions.rb
+spec/driver_registry_spec.rb
+spec/driver_spec.rb
+spec/interface_spec.rb
+spec/string_extensions_spec.rb

data/README.md

@@ -0,0 +1,53 @@
+# MIDIator
+
+* http://github.com/bleything/midiator
+
+## DESCRIPTION:
+
+A nice Ruby interface to your system's MIDI services.
+
+MIDIator was inspired by Topher Cyll's fantastic Practical Ruby Projects
+book.  In it, Topher describes how to interact with the MIDI providers
+in OSX, Linux, and Windows.  As I was reading the book, I noticed some
+things I would do differently, which got me thinking that maybe it
+would be valuable to package up my modifications to the book's code and
+release it as a gem.
+
+## FEATURES:
+
+* Cross-platform system for MIDI output
+* Built-in softsynth (OS X only, so far)
+
+## INSTALL:
+
+    $ [sudo] gem install midiator
+
+## AUTHORS:
+
+* Ben Bleything -- ben@bleything.net
+* Topher Cyll -- http://www.cyll.org
+
+## CREDITS:
+
+Huge, huge credit goes to Topher Cyll, without whom I would have had
+to figure all of this crap out for myself.  Apress also deserves some
+credit; they released all the source in their book under the MIT
+license.  That's a big deal and you should buy their books.
+
+Props also go to the folks who have contributed patches.  In
+alphabetical order:
+
+* Giles Bowkett -- gilesb@gmail.com
+* Ruben Medellin -- http://github.com/chubas
+* Adam Murray -- adam@compusition.com
+* Xavier Shay -- http://rhnh.net
+* Jeremy Voorhis -- jvoorhis@gmail.com
+
+## LICENSE:
+
+Distributed under the terms of the MIT license.  See the LICENSE file
+for complete text and details.
+
+Portions of the code are excerpted from Topher Cyll's Practical Ruby
+Projects.  That code is also released under the MIT license.  See the
+LICENSE.prp file for complete text and details.

data/Rakefile

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec 'midiator' do
+  developer 'Ben Bleything', 'ben@bleything.net'
+
+  ### Use markdown for changelog and readme
+  self.history_file = 'CHANGELOG.md'
+  self.readme_file  = 'README.md'
+
+  ### Depend on Platform
+  self.extra_deps << [ 'Platform', '>= 0.4.0' ]
+
+  ### Test with rspec
+  self.extra_dev_deps << [ 'rspec', '>= 2.1.0' ]
+  self.testlib = :rspec
+
+end

data/examples/a_little_end_music.rb

@@ -0,0 +1,944 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'midiator'
+
+midi = MIDIator::Interface.new
+midi.use :dls_synth
+
+include MIDIator::Notes
+
+scale = [ C4, Cs4, D4, Eb4, E4, F4, Fs4, G4, Gs4, A4, Bb4, B4,
+          C5, Cs5, D5, Eb5, E5, F5, Fs5, G5, Gs5, A5, Bb5, B5 ]
+
+DATA.each_line do |line|
+  num_spaces = line.match( /^(\s+)/ )[1].size rescue 0
+  midi.play scale[ num_spaces / 2 ]
+end
+
+__END__
+end
+    end
+  end
+  end
+  end
+  end
+  end
+  end
+            end
+                end
+              end
+              end
+              end
+            end
+          end
+        end
+      end
+  end
+    end
+    end
+    end
+      end
+    end
+  end
+end
+      end
+          end
+        end
+      end
+    end
+  end
+  end
+  end
+    end
+  end
+end
+  end
+      end
+    end
+  end
+  end
+  end
+  end
+    end
+    end
+  end
+  end
+  end
+    end
+    end
+        end
+        end
+      end
+    end
+      end
+    end
+  end
+      end
+    end
+  end
+      end
+    end
+      end
+    end
+      end
+    end
+        end
+      end
+      end
+    end
+        end
+      end
+      end
+    end
+      end
+    end
+      end
+      end
+      end
+    end
+      end
+      end
+      end
+    end
+        end
+      end
+        end
+          end
+        end
+      end
+        end
+      end
+        end
+        end
+        end
+      end
+    end
+  end
+end
+    end
+    end
+  end
+        end
+      end
+    end
+  end
+end
+end
+            end
+          end
+        end
+      end
+    end
+    end
+    end
+      end
+    end
+    end
+    end
+      end
+    end
+  end
+  end
+  end
+  end
+  end
+  end
+    end
+  end
+end
+end
+end
+  end
+  end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+  end
+    end
+    end
+  end
+    end
+    end
+    end
+  end
+    end
+  end
+    end
+      end
+      end
+      end
+        end
+        end
+            end
+          end
+        end
+          end
+        end
+      end
+      end
+    end
+  end
+    end
+    end
+    end
+  end
+      end
+      end
+    end
+  end
+      end
+      end
+    end
+  end
+    end
+    end
+      end
+        end
+      end
+      end
+      end
+    end
+  end
+      end
+    end
+    end
+  end
+    end
+    end
+  end
+      end
+    end
+      end
+    end
+  end
+        end
+      end
+    end
+      end
+    end
+  end
+      end
+    end
+    end
+  end
+  end
+    end
+  end
+      end
+    end
+  end
+    end
+  end
+        end
+      end
+        end
+      end
+        end
+      end
+        end
+      end
+        end
+      end
+      end
+      end
+    end
+  end
+    end
+    end
+    end
+    end
+    end
+    end
+    end
+    end
+    end
+    end
+  end
+        end
+      end
+    end
+    end
+  end
+      end
+    end
+  end
+      end
+    end
+  end
+    end
+      end
+      end
+    end
+  end
+    end
+  end
+  end
+    end
+  end
+      end
+    end
+  end
+      end
+    end
+  end
+        end
+      end
+    end
+    end
+    end
+    end
+    end
+        end
+      end
+    end
+      end
+    end
+      end
+    end
+      end
+    end
+      end
+    end
+      end
+    end
+  end
+  end
+          end
+            end
+            end
+          end
+                end
+                end
+              end
+            end
+          end
+            end
+          end
+        end
+      end
+                  end
+        end
+      end
+    end
+  end
+          end
+        end
+        end
+      end
+          end
+        end
+      end
+    end
+  end
+    end
+  end
+                end
+              end
+            end
+          end
+            end
+          end
+        end
+            end
+            end
+          end
+        end
+          end
+        end
+              end
+            end
+          end
+        end
+        end
+              end
+            end
+          end
+        end
+        end
+              end
+            end
+          end
+        end
+            end
+          end
+        end
+        end
+            end
+          end
+          end
+            end
+          end
+          end
+        end
+      end
+      end
+    end
+  end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+    end
+  end
+        end
+      end
+    end
+  end
+          end
+        end
+          end
+        end
+      end
+    end
+  end
+        end
+      end
+          end
+        end
+      end
+    end
+  end
+    end
+    end
+  end
+      end
+    end
+      end
+    end
+  end
+      end
+    end
+  end
+            end
+          end
+      end
+        end
+      end
+    end
+      end
+    end
+    end
+    end
+                    end
+                                  end
+                                end
+                              end
+                            end
+                          end
+                        end
+                      end
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+    end
+    end
+          end
+        end
+      end
+    end
+          end
+        end
+      end
+        end
+      end
+    end
+  end
+      end
+      end
+    end
+      end
+    end
+    end
+  end
+    end
+        end
+      end
+  end
+        end
+        end
+        end
+        end
+        end
+        end
+      end
+    end
+  end
+    end
+        end
+            end
+          end
+            end
+          end
+        end
+      end
+    end
+  end
+    end
+      end
+      end
+    end
+  end
+      end
+      end
+    end
+      end
+      end
+    end
+          end
+        end
+      end
+      end
+        end
+        end
+        end
+      end
+    end
+        end
+        end
+        end
+      end
+    end
+        end
+      end
+        end
+      end
+    end
+    end
+      end
+      end
+          end
+          end
+          end
+        end
+        end
+      end
+              end
+            end
+          end
+        end
+      end
+      end
+    end
+    end
+    end
+        end
+              end
+            end
+          end
+        end
+        end
+      end
+    end
+          end
+                end
+              end
+            end
+          end
+          end
+          end
+          end
+        end
+        end
+      end
+    end
+      end
+    end
+    end
+        end
+      end
+    end
+  end
+        end
+      end
+    end
+  end
+      end
+    end
+  end
+        end
+        end
+      end
+    end
+  end
+      end
+        end
+          end
+      end
+      end
+    end
+  end
+      end
+      end
+    end
+          end
+        end
+      end
+    end
+    end
+  end
+          end
+        end
+      end
+    end
+  end
+    end
+    end
+        end
+      end
+      end
+    end
+  end
+      end
+          end
+        end
+      end
+    end
+  end
+    end
+    end
+    end
+        end
+      end
+          end
+          end
+          end
+          end
+            end
+            end
+          end
+        end
+        end
+          end
+        end
+      end
+  end
+        end
+        end
+          end
+        end
+            end
+        end
+      end
+          end
+        end
+      end
+    end
+    end
+    end
+    end
+          end
+          end
+          end
+          end
+            end
+            end
+          end
+        end
+        end
+            end
+          end
+            end
+          end
+        end
+      end
+    end
+    end
+  end
+      end
+    end
+    end
+            end
+          end
+        end
+      end
+      end
+      end
+            end
+          end
+        end
+      end
+    end
+      end
+      end
+    end
+       end
+      end
+    end
+        end
+        end
+      end
+              end
+            end
+          end
+        end
+      end
+                  end
+                end
+              end
+            end
+                end
+              end
+            end
+          end
+          end
+        end
+      end
+        end
+            end
+          end
+        end
+      end
+        end
+      end
+    end
+  end
+      end
+            end
+          end
+        end
+        end
+        end
+        end
+        end
+        end
+        end
+        end
+        end
+      end
+    end
+  end
+      end
+    end
+  end
+    end
+    end
+    end
+  end
+    end
+        end
+      end
+    end
+      end
+      end
+    end
+  end
+    end
+    end
+  end
+      end
+    end
+      end
+      end
+    end
+  end
+  end
+      end
+    end
+  end
+end
+  end
+  end
+      end
+    end
+  end
+    end
+        end
+      end
+    end
+  end
+end
+end
+    end
+    end
+    end
+    end
+    end
+  end
+    end
+  end
+    end
+  end
+end
+      end
+    end
+           end
+    end
+    end
+    end
+  end
+    end
+      end
+    end
+    end
+  end
+end
+           end
+    end
+      end
+    end
+    end
+    end
+    end
+  end
+    end
+    end
+  end
+    end
+  end
+  end
+    end
+  end
+end
+    end
+  end
+  end
+  end
+end
+    end
+  end
+  end
+  end
+  end
+  end
+  end
+end
+  end
+    end
+  end
+    end
+  end
+  end
+  end
+  end
+  end
+  end
+end
+  end
+  end
+    end
+  end
+end
+end
+end
+    end
+  end
+  end
+    end
+  end
+    end
+  end
+end
+  end
+end
+end
+end
+  end
+end
+end
+      end
+        end
+      end
+    end
+  end
+    end
+  end
+end
+  end
+  end
+  end
+    end
+end
+  end
+  end
+    end
+end
+  end
+  end
+end
+  end
+  end
+end
+  end
+        end
+        end
+      end
+    end
+  end
+end
+    end
+    end
+    end
+    end
+    end
+        end
+        end
+      end
+    end
+    end
+    end
+    end
+    end
+      end
+    end
+      end
+    end
+    end
+    end
+    end
+      end
+    end
+    end
+    end
+end
+  end
+  end
+end
+    end
+  end
+      end
+    end
+    end
+    end
+    end
+    end
+    end
+  end
+    end
+  end
+    end
+  end
+    end
+      end
+    end
+      end
+        end
+      end
+        end
+      end
+      end
+        end
+    end
+  end
+end
+end
+end
+end
+  end
+end