midi-nibbler 0.1.1 → 0.2.1

metadata

@@ -1,95 +1,90 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: midi-nibbler
-version: !ruby/object:Gem::Version 
-  prerelease: 
-  version: 0.1.1
+version: !ruby/object:Gem::Version
+  version: 0.2.1
 platform: ruby
-authors: 
+authors:
 - Ari Russo
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-06-05 00:00:00 -04:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2014-08-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: midi-message
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: midilib
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: midilib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id002
-description: Parse MIDI Messages.
-email: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A utility for parsing MIDI messages from various types of input
+email:
 - ari.russo@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
+- LICENSE
+- README.md
 - lib/nibbler.rb
-- lib/nibbler/nibbler.rb
-- lib/nibbler/midi-message_factory.rb
+- lib/nibbler/hex_processor.rb
+- lib/nibbler/midi-message.rb
+- lib/nibbler/midilib.rb
 - lib/nibbler/parser.rb
-- lib/nibbler/midilib_factory.rb
-- lib/nibbler/hex_char_array_filter.rb
+- lib/nibbler/session.rb
 - lib/nibbler/type_conversion.rb
-- test/test_parser.rb
 - test/helper.rb
-- test/test_parser_rejected.rb
-- test/test_nibbler.rb
-- test/test_parser_buffer.rb
-- test/test_hex_char_array_filter.rb
-- test/test_midilib_factory.rb
-- test/test_type_conversion.rb
-- test/test_midi_message_factory.rb
-- LICENSE
-- README.rdoc
-has_rdoc: true
+- test/hex_processor_test.rb
+- test/midi_message_test.rb
+- test/midilib_test.rb
+- test/parser_buffer_test.rb
+- test/parser_rejected_test.rb
+- test/parser_test.rb
+- test/session_test.rb
+- test/type_conversion_test.rb
 homepage: http://github.com/arirusso/nibbler
-licenses: []
-
+licenses:
+- Apache 2.0
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
+    - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-
 rubyforge_project: nibbler
-rubygems_version: 1.6.2
+rubygems_version: 2.2.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Parse MIDI Messages.
 test_files: []
-

data/README.rdoc

@@ -1,115 +0,0 @@
-= nibbler
-
-{cat on arp}[http://images.treetrouble.net/images/dog_with_synth.jpg]
-
-Parse MIDI Messages
-
-== Requirements
-
-* {midi-message}[http://github.com/arirusso/midi-message]  
-	
-== Install
-
-  gem install midi-nibbler
-
-== Usage
-
-  require 'nibbler'
-  
-  nibbler = Nibbler.new
-
-Enter a message piece by piece
-  
-  nibbler.parse("90")
-    => nil
-
-  nibbler.parse("40")
-    => nil
-
-  nibbler.parse("40")
-  => #<MIDIMessage::NoteOn:0x98c9818 
-       @channel=0, 
-       @data=[64, 100], 
-       @name="C3", 
-       @note=64, 
-       @status=[9, 0], 
-       @velocity=100, 
-       @verbose_name="Note On: C3">
-  
-Enter a message all at once
-  
-  nibbler.parse("904040")
-  
-  => #<MIDIMessage::NoteOn:0x98c9818 
-        @channel=0, 
-        @data=[64, 100], 
-        @name="C3", 
-        @note=64, 
-        @status=[9, 0], 
-        @velocity=100, 
-        @verbose_name="Note On: C3">
-  
-Use bytes
-  
-  nibbler.parse(0x90, 0x40, 0x40)
-    => #<MIDIMessage::NoteOn:0x98c9818 ...>
-    
-You can use nibbles in string format
-  
-  nibbler.parse("9", "0", "4", "0", "4", "0")
-    => #<MIDIMessage::NoteOn:0x98c9818 ...>
-  
-Interchange the different types
-  
-  nibbler.parse("9", "0", 0x40, 64)
-    => #<MIDIMessage::NoteOn:0x98c9818 ...>
-  
-Use running status
-
-  nibbler.parse(0x40, 64)
-    => #<MIDIMessage::NoteOn:0x98c9818 ...>
-  
-Look at the messages we've parsed
-  
-  nibbler.messages
-    => [#<MIDIMessage::NoteOn:0x98c9804 ...>
-        #<MIDIMessage::NoteOn:0x98c9811 ...>]
-  
-Add an incomplete message
-  
-  nibbler.parse("9")
-  nibbler.parse("40")
-  
-See progress
-  
-  nibbler.buffer
-    => ["9", "4", "0"]
-  
-  nibbler.buffer_s
-    => "940"
-  
-Pass in a timestamp
-
-  nibbler.parse("904040", :timestamp => Time.now.to_i)
-    => { :messages=> #<MIDIMessage::NoteOn:0x92f4564 ..>, :timestamp=>1304488440 }
-  
-Nibbler defaults to generate {midi-message}[http://github.com/arirusso/midi-message] objects, but it is also possible to use {midilib}[https://github.com/jimm/midilib] 
-
-  Nibbler.new(:message_lib => :midilib)
-  
-  nibbler.parse("9", "0", 0x40, "40")
-    => "0: ch 00 on 40 40"
-  
-== Also see
-
-* {midi-eye}[http://github.com/arirusso/midi-eye], a MIDI event listener based on nibbler
-
-== Author
-
-* {Ari Russo}[http://github.com/arirusso] <ari.russo at gmail.com>
-
-== License
-
-Apache 2.0, See the file LICENSE
-
-Copyright (c) 2011 Ari Russo

data/lib/nibbler/hex_char_array_filter.rb

@@ -1,37 +0,0 @@
-#!/usr/bin/env ruby
-#
-module Nibbler  
-  
-  # Turns various types of input in to an array of hex digit chars
-  class HexCharArrayFilter
-       
-    # returns an array of hex string nibbles
-    def process(*a)
-      a.flatten!
-      buf = []
-      a.each do |thing|
-        buf += case thing
-          when Array then thing.map { |arr| to_nibbles(*arr) }.inject { |a,b| a + b }
-          when String then TypeConversion.hex_str_to_hex_chars(filter_string(thing))
-          when Numeric then TypeConversion.numeric_byte_to_hex_chars(filter_numeric(thing))
-        end
-      end
-      buf.compact.map { |n| n.upcase } 
-    end
-    
-    private
-    
-    # limit <em>num</em> to bytes usable in MIDI ie values (0..240)
-    # returns nil if the byte is outside of that range
-    def filter_numeric(num)
-      (0x00..0xFF).include?(num) ? num : nil
-    end
-    
-    # get rid of non-hex string characters
-    def filter_string(str)
-      str.gsub(/[^0-9a-fA-F]/, '').upcase
-    end
-  
-  end
-
-end

data/lib/nibbler/midi-message_factory.rb

@@ -1,54 +0,0 @@
-#!/usr/bin/env ruby
-#
-module Nibbler
-
-  # factory for constructing messages with {midi-message}(http://github.com/arirusso/midi-message)
-  class MIDIMessageFactory
-    
-    include MIDIMessage
-    
-    def note_off(second_nibble, data_byte_1, data_byte_2)
-      NoteOff.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def note_on(second_nibble, data_byte_1, data_byte_2)
-      NoteOn.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def polyphonic_aftertouch(second_nibble, data_byte_1, data_byte_2)
-      PolyphonicAftertouch.new(second_nibble, data_byte_1, data_byte_2)
-    end
-      
-    def control_change(second_nibble, data_byte_1, data_byte_2)
-      ControlChange.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def program_change(second_nibble, data_byte)
-      ProgramChange.new(second_nibble, data_byte)
-    end
-    
-    def channel_aftertouch(second_nibble, data_byte)
-      ChannelAftertouch.new(second_nibble, data_byte)
-    end
-    
-    def pitch_bend(second_nibble, data_byte_1, data_byte_2)
-      PitchBend.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def system_exclusive(*a)
-      SystemExclusive.new(*a)
-    end
-    
-    def system_common(second_nibble, data_byte_1 = nil, data_byte_2 = nil)
-      SystemCommon.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def system_realtime(second_nibble)
-      SystemRealtime.new(second_nibble)
-    end
-    
-        
-  
-  end
-
-end

data/lib/nibbler/midilib_factory.rb

@@ -1,66 +0,0 @@
-#!/usr/bin/env ruby
-#
-module Nibbler
-
-  # factory for constructing messages with {midilib}(https://github.com/jimm/midilib)
-  # midilib is copyright © 2003-2010 Jim Menard
-  class MidilibFactory
-    
-    include MIDI
-    
-    def note_off(second_nibble, data_byte_1, data_byte_2)
-      NoteOff.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def note_on(second_nibble, data_byte_1, data_byte_2)
-      NoteOn.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def polyphonic_aftertouch(second_nibble, data_byte_1, data_byte_2)
-      PolyPressure.new(second_nibble, data_byte_1, data_byte_2)
-    end
-      
-    def control_change(second_nibble, data_byte_1, data_byte_2)
-      Controller.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def program_change(second_nibble, data_byte)
-      ProgramChange.new(second_nibble, data_byte)
-    end
-    
-    def channel_aftertouch(second_nibble, data_byte)
-      ChannelPressure.new(second_nibble, data_byte)
-    end
-    
-    def pitch_bend(second_nibble, data_byte_1, data_byte_2)
-      # to-do handle the midilib lsb/msb
-      # right now the second data byte is being thrown away
-      PitchBend.new(second_nibble, data_byte_1, data_byte_2)
-    end
-    
-    def system_exclusive(*a)
-      SystemExclusive.new(a)
-    end
-    
-    def system_common(second_nibble, data_byte_1 = nil, data_byte_2 = nil)
-      case second_nibble
-        when 0x2 then SongPointer.new(data_byte_1) # similar issue to pitch bend here
-        when 0x3 then SongSelect.new(data_byte_1)
-        when 0x6 then TuneRequest.new
-      end      
-    end
-    
-    def system_realtime(second_nibble)
-      case second_nibble
-        when 0x8 then Clock.new
-        when 0xA then Start.new
-        when 0xB then Continue.new
-        when 0xC then Stop.new
-        when 0xE then ActiveSense.new
-        when 0xF then SystemReset.new
-      end      
-    end  
-    
-  end
-
-end

data/lib/nibbler/nibbler.rb

@@ -1,89 +0,0 @@
-#!/usr/bin/env ruby
-#
-module Nibbler
- 
-  # this is the entry point to the app
-  class Nibbler
-
-    extend Forwardable
-
-    attr_reader :messages,
-                :processed,
-                :rejected
-    
-    # this class holds on to all output except for the buffer because the data in the buffer
-    # is the only data that's relevant between calls of Parser.process 
-    def_delegators :@parser, :buffer            
-    def_delegator :clear_buffer, :buffer, :clear
-    def_delegator :clear_processed, :processed, :clear
-    def_delegator :clear_rejected, :rejected, :clear
-    def_delegator :clear_messages, :messages, :clear
-
-    def initialize(options = {}, &block)
-      @timestamps = options[:timestamps] || false
-      @callbacks, @processed, @rejected, @messages = [], [], [], []
-      @parser = Parser.new(options)    
-      @typefilter = HexCharArrayFilter.new
-      block.call unless block.nil?
-    end
-    
-    def all_messages
-      @messages | @fragmented_messages
-    end
-    
-    def buffer_s
-      buffer.join
-    end
-    alias_method :buffer_hex, :buffer_s
-
-    def clear_buffer
-      buffer.clear
-    end
-
-    def clear_messages
-      @messages.clear
-    end
-    
-    def use_timestamps
-      @messages = @messages.map do |m|
-        { :messages => m, :timestamp => nil }
-      end
-      @timestamps = true
-    end
-
-    def parse(*a)
-      a.compact!
-      options = a.last.kind_of?(Hash) ? a.pop : nil      
-      timestamp = options[:timestamp] if !options.nil? && !options[:timestamp].nil?
-      use_timestamps if !timestamp.nil? && !@timestamps         
-      queue = @typefilter.process(a)
-      result = @parser.process(queue)
-      record_message(result[:messages], timestamp)
-      @processed += result[:processed]
-      @rejected += result[:rejected]
-      get_parse_output(result[:messages], options)
-    end    
-    
-    private
-        
-    def record_message(msg, timestamp = nil)
-      !@timestamps ? @messages += msg : @messages << { 
-        :messages => msg, 
-        :timestamp => timestamp 
-      }     
-    end
-    
-    def get_parse_output(messages, options = nil)
-      # return type
-      # 0 messages: nil
-      # 1 message: the message
-      # >1 message: an array of messages
-      # might make sense to make this an array no matter what...iii dunnoo
-      output = messages.length < 2 ? (messages.empty? ? nil : messages[0]) : messages
-      output = { :messages => output, :timestamp => options[:timestamp] } if @timestamps && !options.nil?
-      output      
-    end
-    
-  end
-  
-end