midilib 2.0.4 → 3.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9bef04b13853bd3e16488263bd4fdf5fe3f43bc9fa8f48f6967ff8cd78fc2a16
+  data.tar.gz: fd3bf8e7ed497e1396a228b7f6506f25067b2673b381fd6b5312899369e490db
+SHA512:
+  metadata.gz: 1fabc2a6c78a0152d48f6139e644cea2ef67b90c66b38ec085d6eabf4e11ce0c0a6549d5a34ea7020e05b0b3cd069db000e80444daacb8681afe03d458965e15
+  data.tar.gz: 10ce51a6d08c5181cafea51f1772d110cee3a7c244ad47ed06be76b8395f4dfcdf3cfb79a8cd15d9c5dd8c235094fc30013a5d25e0c396574452a1765f38bea1

data/ChangeLog

@@ -1,4 +1,5 @@
-For any further change descriptions, see the Git logs.
+This change log is no longer maintaned. For further change descriptions,
+see the Git logs.
 
 2007-12-11  Jim Menard  <jim@iamplify.com>
 

data/Credits

@@ -29,7 +29,7 @@ Jari Williamsson <jari.williamsson@mailbox.swipnet.se>
 Noah Thorp
 
     Found a bug in the code intended to make midilib work under Ruby 1.9.
-    Found another bug in KeySing.data_as_bytes.
+    Found another bug in KeySig.data_as_bytes.
 
 Zach Chadwick (zachad on Github)
 
@@ -48,9 +48,51 @@ Shai Rosenfeld (shaiguitar on Github)
 J (dark-panda on Github)
 
     Instead of monkeypatching ::Array, put sorting methods into new
-    MIDI::Array subclass to avoid clashes with Rails app.
+    MIDI::Array subclass to avoid clashes with Rails apps.
 
 Lucas lfzawacki (lfzawacki on Github)
 
     Found a bug in the MIDI::IO::SeqReader class: the pitch_bend method's
     msb and lsb parameters were reversed.
+
+Parki <parki06780678@gmail.com>
+
+    Reported failure of install.rb with newer versions of Ruby due to use of
+    old 'ftools' standard library component.
+
+Adam Murray (adamjmurray on Github)
+
+    Submitted a patch that avoids writing empty data when writing tracks.
+
+@dylee on Github
+
+    Submitted a patch that improves key signature event code and to_s.
+
+@willm on Github
+
+    Suggested that Sequence.length_to_delta round the result instead of
+    truncating it.
+
+@kaorukobo on Github
+
+    Fixed a bug where the delta offset of META_SEQ_NAME and META_COPYRIGHT
+    events were incorrectly always set to 0. The delta time may be any
+    value (although META_COPYRIGHT should normally be 0).
+
+@rhelsing on Github
+
+    Added the ability to save MIDI format 0 files.
+
+Miika Alonen (@amiika on Github)
+
+    Updated midilib for Ruby 2.7 and 3.0 by using blocks instead of Proc
+    objects and changing require to require_relative where appropriate.
+
+@johnkolen on Github
+
+    Pointed out incorrect values for CC_GEN_PURPOSE_{5,6,7,8}.
+
+@kaorukobo on Github
+
+    Found a bug caused by note offs coming right before note ons. See
+    https://github.com/jimm/midilib/pull/21 for a detailed write-up.

data/README.rdoc

@@ -8,7 +8,7 @@ http://github.com/jimm/midilib and the RubyGems.org page is
 http://rubygems.org/gems/midilib, where you can also find all the RDoc
 documentation.
 
-midilib is compatible with both Ruby 1.8.x and 1.9.x.
+midilib is compatible with Ruby 2.6 and higher.
 
 
 == Dependencies
@@ -55,12 +55,11 @@ runs all of the tests in the test directory.
 
 == Overview
 
-The midilib MIDI file reader only understands MIDI file format 1, where a
-sequence is made up of multiple tracks. It doesn't yet understand format 0
-(a single track containing all events) or format 2 (a collection of format 0
-files in one file).
+midilib can read and write MIDI file formats 0 (one single track) or 1
+multiple tracks. By default, it writes format 1 which is the most common
+format. MIDI file format 2 is not yet supported.
 
-d=== MIDI::Sequence
+=== MIDI::Sequence
 
 A sequence contains a collection of tracks and global information like the
 sequence's pulses per quarter note (ppqn) and time signature.
@@ -290,7 +289,7 @@ information. Though the first edition book is available online, I encourage
 you to purchase a copy of the latest edition.
 
 A description of the MIDI file format can be found in a few places such as
-http://www.borg.com/~jglatt/tech/midifile.htm.
+https://www.csie.ntu.edu.tw/~r92092/ref/midi/.
 
 The MIDI message reference at http://www.jimmenard.com/midi_ref.html
 describes the format of MIDI commands.
@@ -314,7 +313,7 @@ describes the format of MIDI commands.
 = Administrivia
 
 Author:: Jim Menard (mailto:jim@jimmenard.com)
-Copyright:: Copyright (c) 2003-2012 Jim Menard
+Copyright:: Copyright (c) 2003-2013 Jim Menard
 License:: Distributed under the same license as Ruby.
 
 
@@ -327,7 +326,7 @@ http://www.ruby-lang.org/en/LICENSE.txt.
 midilib may be freely copied in its entirety providing this notice, all
 source code, all documentation, and all other files are included.
 
-midilib is Copyright (c) 2003-2012 by Jim Menard.
+midilib is Copyright (c) 2003-2013 by Jim Menard.
 
 The song "No Fences" contained in the MIDI file examples/NoFences.mid is
 Copyright (c) 1992 by Jim Menard (jim@jimmenard.com). It may be freely used
@@ -336,6 +335,11 @@ for non-commercial purposes as long as the author is given credit.
 
 == Recent Changes
 
+=== Changes for 2.0.5:
+
+Updated +install.rb+ to work with newer versions of Ruby by using
++fileutils+ instead of +ftools+.
+
 === Changes for 2.0.3:
 
 New MIDI::Sequence.pulses_to_seconds method.

data/Rakefile

@@ -1,52 +1,46 @@
 require 'rubygems'
 require 'rake'
-if RUBY_VERSION >= '1.9'
-  require 'rdoc/task'
-  require 'rubygems/package_task'
-  require 'rake/testtask'
-else
-require 'rake/rdoctask'
-  require 'rake/gempackagetask'
-  require 'rake/runtest'
-end
+require 'rdoc/task'
+require 'rubygems/package_task'
+require 'rake/testtask'
 
 PROJECT_NAME = 'midilib'
 RDOC_DIR = 'html'
 
 PKG_FILES = FileList[ 'ChangeLog', 'Credits', 'Rakefile',
-    'README.rdoc', 'TODO.rdoc',
-    'examples/**/*',
-    'html/**/*',
-    'install.rb',
-    'lib/**/*.rb',
-    'test/**/*']
+                      'README.rdoc', 'TODO.rdoc',
+                      'examples/**/*',
+                      'html/**/*',
+                      'install.rb',
+                      'lib/**/*.rb',
+                      'test/**/*']
 
-task :default => [:package]
+task default: [:package]
 
 spec = Gem::Specification.new do |s|
-    s.platform = Gem::Platform::RUBY
-    s.name = PROJECT_NAME
-    s.version = `ruby -Ilib -e 'require "midilib/info"; puts MIDI::Version'`.strip
-    s.requirements << 'none'
+  s.platform = Gem::Platform::RUBY
+  s.name = PROJECT_NAME
+  s.version = `ruby -Ilib -e 'require "midilib/info"; puts MIDI::Version'`.strip
+  s.requirements << 'none'
 
-    s.require_path = 'lib'
+  s.require_path = 'lib'
 
-    s.files = PKG_FILES.to_a
+  s.files = PKG_FILES.to_a
 
-    s.has_rdoc = true
-    s.rdoc_options << '--main' << 'README.rdoc'
-    s.extra_rdoc_files = ['README.rdoc', 'TODO.rdoc']
+  s.rdoc_options << '--main' << 'README.rdoc'
+  s.extra_rdoc_files = ['README.rdoc', 'TODO.rdoc']
 
-    s.author = 'Jim Menard'
-    s.email = 'jim@jimmenard.com'
-    s.homepage = 'http://github.com/jimm/midilib'
-    s.rubyforge_project = PROJECT_NAME
+  s.author = 'Jim Menard'
+  s.email = 'jim@jimmenard.com'
+  s.homepage = 'http://github.com/jimm/midilib'
+  s.rubyforge_project = PROJECT_NAME
+  s.license = 'Ruby'
 
-    s.summary = "MIDI file and event manipulation library"
-    s.description = <<EOF
-midilib is a pure Ruby MIDI library useful for reading and
-writing standard MIDI files and manipulating MIDI event data.
-EOF
+  s.summary = 'MIDI file and event manipulation library'
+  s.description = <<~EOF
+    midilib is a pure Ruby MIDI library useful for reading and
+    writing standard MIDI files and manipulating MIDI event data.
+  EOF
 end
 
 if RUBY_VERSION >= '1.9'
@@ -66,29 +60,18 @@ else
 end
 
 # creates an "rdoc" task
-Rake::RDocTask.new do | rd |
-    rd.main = 'README.rdoc'
-    rd.title = PROJECT_NAME
-    rd.rdoc_files.include('README.rdoc', 'TODO.rdoc', 'lib/**/*.rb')
+Rake::RDocTask.new do |rd|
+  rd.main = 'README.rdoc'
+  rd.title = PROJECT_NAME
+  rd.rdoc_files.include('README.rdoc', 'TODO.rdoc', 'lib/**/*.rb')
 end
 
-desc "Publish gem"
-task :publish => [:rdoc, :package] do
+desc 'Publish gem'
+task publish: %i[rdoc package] do
   version = `ruby -Ilib -e 'require "midilib/info"; puts MIDI::Version'`.strip
   system "gem push pkg/midilib-#{version}.gem"
 end
 
-if RUBY_VERSION >= '1.9'
-  Rake::TestTask.new do |t|
-    t.libs << File.join(File.dirname(__FILE__), 'test')
-    t.libs << File.join(File.dirname(__FILE__), 'lib')
-    t.ruby_opts << '-rubygems'
-    t.pattern = "test/**/test_*.rb"
-  end
-else
-  task :test do
-    Rake::run_tests
-  end
-end
+Rake::TestTask.new
 
-task :clean => [:clobber_rdoc, :clobber_package]
+task clean: %i[clobber_rdoc clobber_package]

data/TODO.rdoc

@@ -1,6 +1,17 @@
 == Bugs
 
-No known bugs. (If that's not a challenge, I don't know what is.)
+midilib does not handle tempo changes when calculating +beats_per_minute+.
+The tempo events are correctly handled when reading/writing/moving them
+around, it's just the functions that answer questions about the current
+tempo that are wrong. See https://github.com/jimm/midilib/issues/8. The
+method +beats_per_minute+ and related methods like +pulses_to_seconds+ will
+have to take into account the possibility of more than one tempo event. They
+will probably have to take new arguments specifying where in the sequence
+the beats or pulses are being requested. For example we could have
++beats_per_minute(at_seconds: 0.0, at_beat: 0.0)+ (where the two keyword
+args are mutually exclusive). Perhaps there should be separately named
+public methods like +beats_per_minute_at_seconds+ and
++beats_per_minute_at_beat+ as well.
 
 == Features
 
@@ -15,7 +26,7 @@ No known bugs. (If that's not a challenge, I don't know what is.)
 
 * Implement key signature in SeqReader.
 
-* Format 0 files.
+* Ignore unknown chunks in MIDI files. See the MIDI file spec.
 
 * Format 2 files(?).
 

data/examples/from_scratch.rb

@@ -14,7 +14,7 @@ require 'midilib/sequence'
 require 'midilib/consts'
 include MIDI
 
-seq = Sequence.new()
+seq = Sequence.new
 
 # Create a first track for the sequence. This holds tempo events and stuff
 # like that.
@@ -40,10 +40,10 @@ track.events << Controller.new(0, CC_VOLUME, 127)
 # delta time length of a single quarter note.
 track.events << ProgramChange.new(0, 1, 0)
 quarter_note_length = seq.note_to_delta('quarter')
-[0, 2, 4, 5, 7, 9, 11, 12].each { | offset |
+[0, 2, 4, 5, 7, 9, 11, 12].each do |offset|
   track.events << NoteOn.new(0, 64 + offset, 127, 0)
   track.events << NoteOff.new(0, 64 + offset, 127, quarter_note_length)
-}
+end
 
 # Calling recalc_times is not necessary, because that only sets the events'
 # start times, which are not written out to the MIDI file. The delta times are
@@ -51,6 +51,4 @@ quarter_note_length = seq.note_to_delta('quarter')
 
 # track.recalc_times
 
-File.open('from_scratch.mid', 'wb') { | file |
-	seq.write(file)
-}
+File.open('from_scratch.mid', 'wb') { |file| seq.write(file) }

data/examples/measures_mbt.rb

@@ -13,18 +13,18 @@ $LOAD_PATH[0, 0] = File.join(File.dirname(__FILE__), '..', 'lib')
 
 require 'midilib/sequence'
 
-seq = MIDI::Sequence.new()
-File.open(ARGV[0], 'rb') { | file | seq.read(file) }
+seq = MIDI::Sequence.new
+File.open(ARGV[0], 'rb') { |file| seq.read(file) }
 
 # Get all measures, so events can be mapped to measures:
 measures = seq.get_measures
 
-seq.each { | track |
-  track.each { | e |        
-    if e.kind_of?(MIDI::NoteOn) then
-      # Print out start of notes
-      e.print_note_names = true
-      puts measures.to_mbt(e) + "  ch #{e.channel}:  #{e.note_to_s}"
-    end        
-  }    
-}
+seq.each do |track|
+  track.each do |e|
+    next unless e.is_a?(MIDI::NoteOn)
+
+    # Print out start of notes
+    e.print_note_names = true
+    puts measures.to_mbt(e) + "  ch #{e.channel}:  #{e.note_to_s}"
+  end
+end

data/examples/print_program_changes.rb

@@ -9,20 +9,20 @@ require 'midilib/sequence'
 DEFAULT_MIDI_TEST_FILE = 'NoFences.mid'
 
 # Read from MIDI file
-seq = MIDI::Sequence.new()
+seq = MIDI::Sequence.new
 
-File.open(ARGV[0] || DEFAULT_MIDI_TEST_FILE, 'rb') { | file |
-    # The block we pass in to Sequence.read is called at the end of every
-    # track read. It is optional, but is useful for progress reports.
-    seq.read(file)
-}
+File.open(ARGV[0] || DEFAULT_MIDI_TEST_FILE, 'rb') do |file|
+  # The block we pass in to Sequence.read is called at the end of every
+  # track read. It is optional, but is useful for progress reports.
+  seq.read(file)
+end
 
-seq.each { | track |
+seq.each do |track|
   puts
   puts "*** track name \"#{track.name}\", \"#{track.instrument}\""
-  track.each { | e |
+  track.each do |e|
     e.print_decimal_numbers = true
     e.print_channel_numbers_from_one = true
-    puts e if e.kind_of?(MIDI::ProgramChange)
-  }
-}
+    puts e if e.is_a?(MIDI::ProgramChange)
+  end
+end