id3 1.0.0.pre5 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 98349fdcb8d21521c6cfe9a9135e2fc6f24824b27101918223c2e20bee5f88d5
+  data.tar.gz: 901dc10b5188226630f4f6429e43944b0f8476a84d21e532e86c50e019127d62
+SHA512:
+  metadata.gz: 88eff1c0f42b12bc427bdcd300af8d5d2fe108a3ec2a039acd0748e324407229c99de426a894fecadc4ed8ef6bc4d765650f25207d0df89dd7cfb32afa37123b
+  data.tar.gz: bc2736decb84c8c68bf5c1e856666ffa06495ca3c4bf2be0fd4df96189331bc6d10d0ea039658d6ee53dc900f8ea5e7fcea73ed36d5279c04d1afba33558f72e

data/.gitignore

@@ -0,0 +1,22 @@
+log/*
+tmp/**/*
+*.sqlite
+*.sqlite3
+db/*.sqlite3
+.bundle
+log/*.log
+.DS_Store
+coverage
+doc/api
+db/*.sqlite3
+#*
+.#*
+*~
+.svn
+.cvs
+.git.old
+*.bak
+*.new
+doc
+pkg
+*.gem

data/CHANGES

@@ -1,5 +1,11 @@
 = id3 changes
 
+=== 1.0.0
+
+* release of verion 1.0.0
+  issue with not being able to load `md5` library was because the fixed version was a pre-release,
+  and would not be installed automatically.
+
 === 1.0.0_pre4 (2011-10-11 .. 2011-10-20 working on pre-release of 1.0.0 version)
 
 * changed format of Frame.new() initializer method

data/README.md

@@ -7,12 +7,16 @@ Initial release was 12 Oct 2002
 The library uses Metaprogramming at it's core - see ./lib/id3/frame.rb
 
 # NOTE
-the latest version on the trunk is version 1.0.0_pre4 , a pre-release which aims at Ruby 1.9 compatibility.
+the latest version on the trunk is version 1.0.0_pre6 , a pre-release which aims at Ruby 1.9 compatibility.
 
 
 Author:     Tilo Sloboda <MyFristname.MyLastname At GoogleMail>
 
-Home Page:  http://www.unixgods.org/~tilo/Ruby/ID3
+Home Page:  http://www.unixgods.org/Ruby/ID3/docs/index.html
+
+Comparison of different ID3 Standards: http://www.unixgods.org/Ruby/ID3/docs/ID3_comparison.html
+
+Wikipedia: https://en.wikipedia.org/wiki/ID3
 
 License:    http://www.unixgods.org/~tilo/artistic-license.html
 
@@ -26,7 +30,9 @@ RAA:        http://raa.ruby-lang.org/project/id3tag/  (yes, it's that old :) )
 
 Versions:  
 
-* 1.0.0_pre4 [2012-07-07]
+* 1.0.0_pre6 [2012-08-15]
+* 1.0.0_pre5 [2012-08-14]
+* 1.0.0_pre4 [2012-07-17]
 * 0.5.1 (2011-03-31)
 * 0.5.0 (2008-08-18) 
 * 0.4.1 (2008-08-17)

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/docs/API

@@ -0,0 +1 @@
+../doc

data/examples/id3_statistics_with_Audiofile.rb

@@ -0,0 +1,115 @@
+
+require 'awesome_print'
+
+require 'id3'
+
+
+require '../lib/helpers/recursive_helper'
+
+
+# ------------------------------------------------------------------------------
+def each_song(filename)
+  filename.chomp!
+  @mp3fileN += 1
+
+#  puts "Filename: #{filename}"
+
+  if File.size(filename) == 0
+    @empty_fileN += 1
+    puts "EMPTY MP3-File: #{filename}"   # better to know this, hum?
+    return
+  end
+
+  mp3 = AudioFile.new(filename)   # CAN WE CALL THIS WITH A BLOCK??
+  if mp3.id3_versions.empty?
+    @no_id3_tagN += 1
+    puts "NO ID3 TAGS: #{filename}"   # better to know this, hum?
+    return
+  else    
+    mp3.id3_versions.each do |v|
+      # count how often we saw a certain ID3 tag version
+      @id3_versionNH[v] += 1
+
+      if mp3.has_id3v2tag?
+        # count how often we saw a certain ID3v2 tag size
+        @id3v2_tag_sizesH[v][mp3.tagID3v2.raw.size] ||= 0
+        @id3v2_tag_sizesH[v][mp3.tagID3v2.raw.size]  += 1
+
+        # count how often we saw a certain ID3v2 tag
+        mp3.tagID3v2.keys.each do |tag|
+          @id3v2_fields_usedH[v][tag] ||= 0
+          @id3v2_fields_usedH[v][tag]  += 1
+        end
+      else
+        @only_id3v1_tagN += 1   # if a file only has a ID3v1 tag, we also need a warning message
+        puts "ONLY ID3v1 TAG: #{filename}"   # better to know this, hum?
+      end
+    end
+  end
+end
+# ------------------------------------------------------------------------------
+
+
+
+mp3_library_dir = File.join(  ENV['HOME'] , 'Music/iTunes/iTunes Music')  # e.g. on a Mac
+
+@dirN = 0
+@fileN = 0
+@mp3fileN = 0
+
+@empty_fileN = 0
+@no_id3_tagN = 0
+@only_id3v1_tagN = 0
+
+@id3v2_fields_usedH = {}
+@id3v2_tag_sizesH   = {}
+@id3_versionNH      = {}
+ID3::VERSIONS.each do |v|
+  @id3v2_fields_usedH[v] = {}
+  @id3v2_tag_sizesH[v]   = {}
+  @id3_versionNH[v]      = 0
+end
+
+# gather statistics on the ID3 tags used in your MP3 library:
+recursive_dir_descend( mp3_library_dir , /.*.[mM][pP]3$/ ,   'each_song(filename)'); 1
+
+
+print "
+Files checked: #{@fileN}
+Dirs checked:  #{@dirN}
+
+MP3 Files found: #{@mp3fileN}
+
+Empty MP3 Files: #{@empty_fileN}
+
+NO ID3 Tag at all: #{@no_id3_tagN}
+
+ONLY ID3v2 Tag:  #{@only_id3v1_tagN}
+
+"
+
+puts '--------------------'
+ap @id3v2_fields_usedH ; 1
+puts '--------------------'
+ap @id3v2_tag_sizesH ;1 
+puts '--------------------'
+ap @id3_versionNH ;1
+puts '--------------------'
+
+print "
+Files checked: #{@fileN}
+Dirs checked:  #{@dirN}
+
+MP3 Files found: #{@mp3fileN}
+
+Empty MP3 Files: #{@empty_fileN}
+
+NO ID3 Tag at all: #{@no_id3_tagN}
+
+ONLY ID3v2 Tag:  #{@only_id3v1_tagN}
+
+"
+
+puts "\n\ndone."
+
+

data/examples/old/example2.rb

@@ -0,0 +1,134 @@
+
+require 'id3'
+
+tag1 = ID3::Tag1.new
+tag1.read('mp3/d.mp3')
+
+tag2 = ID3::Tag1.new
+tag2.read('mp3/a.mp3')
+
+raw = tag1.dump
+raw.hexdump
+tag1.raw.hexdump
+
+t =  ID3::Tag1.new
+v,h = t.parse!(raw)
+
+
+raw = tag2.dump
+raw.hexdump
+v,h = t.parse!(raw)
+
+
+t['BLA'] = "blubb"
+
+# -------------------------------------------------------------------------------- 
+
+ require 'id3'
+
+ t = ID3::Tag2.new
+ t.read("mp3/d.mp3")
+ t["ARTIST"]
+
+  t["ARTIST"].dump.hexdump
+
+   t.delete('PICTURE')
+   t.dump.hexdump
+
+# -------------------------------------------------------------------------------- 
+
+require 'id3'
+   
+a = ID3::AudioFile.new("mp3/a.mp3")
+t1 = a.write                            
+a1 = a.writeAudio
+
+aa = ID3::AudioFile.new( t1 )
+t2 = aa.write
+a2 = aa.writeAudio
+
+aaa = ID3::AudioFile.new( t2 )
+t3 = aaa.write
+a3 = aaa.writeAudio
+ 
+a.audioLength
+aa.audioLength
+aaa.audioLength
+
+` ls -l t1 t2 t3`
+
+# to create a test file
+
+File.open("mp3/test.mp3", "w+") { |f|
+ 256.times { |i|
+    f.putc i
+ }
+}
+
+# -------------------------------------------------------------------------------- 
+
+ 
+require 'id3'
+
+a = ID3::AudioFile.new("mp3/a.mp3")
+b = ID3::AudioFile.new("mp3/b.mp3")
+c = ID3::AudioFile.new("mp3/c.mp3")
+d = ID3::AudioFile.new("mp3/d.mp3")
+e = ID3::AudioFile.new("mp3/reeeee.mp3")
+a = ID3::AudioFile.new("mp3/King_Crimson_-_Three_of_a_Perfect_Pair_-_06_-_Industry.mp3")
+
+d.tagID3v2["TMEDIATYPE"].flags
+  
+  d.tagID3v2.version
+  d.tagID3v2["ARTIST"].rawflags
+  d.tagID3v2["ARTIST"].flags
+    
+ d.tagID3v2["ARTIST"].raw
+ d.tagID3v2["ARTIST"].rawheader
+ d.tagID3v2["ARTIST"].rawdata
+  
+  
+t = ID3::Tag2.new
+t.read("mp3/b.mp3")
+
+t["COMMENT"]
+ t["COMMENT"].order
+
+ t["COMMENT"]["bla"] =3
+ 
+
+
+t['COMMENT'].rawdata.hexdump
+ 
+ 
+
+t2["SONGLEN"].rawdata.hexdump
+t2["SONGLEN"].dump.hexdump
+
+
+# to check which symbols don't have a matching pack/unpack pattern:
+  
+(ID3::Framename2symbol["2.2.0"].values + 
+   ID3::Framename2symbol["2.3.0"].values + 
+   ID3::Framename2symbol["2.4.0"].values).uniq.each { |symbol|
+       print "SYMBOL: #{symbol} not defined!\n"       if ! ID3::FrameName2FrameType[symbol]
+}
+
+
+ 
+  ID3::FrameName2FrameType["ARTIST"]
+  ID3::FrameName2FrameType
+  
+ 
+ t2["ARTIST"].raw
+ 
+ t2["ARTIST"].rawdata
+ 
+ 
+ 
+ 
+ t1 = ID3::Tag2.new
+ t1.read("mp3/b.mp3")
+ t1["ARTIST"]
+ 
+

data/examples/old/examples.rb

@@ -0,0 +1,165 @@
+
+# ------------------------------------------------------------------------------
+# SOME EXAMPLES on how the library is intended to be used
+# ------------------------------------------------------------------------------
+
+# EXAMPLE of stripping extra v1-tag if v2-tag is present:
+
+file = "bla.mp3"
+if ID3::has_id3_tag?( file )
+   myfile = AudioFile.open( file )        # do we need a new here?
+   
+   # if a file has both tags (v1 and v2), we delete the v1 tag:
+   if (myfile.has_id3v1_tag?) && (myfile.has_id3v2_tag?)
+      myfile.id3v1tag = nil
+      myfile.write              # we only write if we modified it..
+   end
+end
+
+# NOTE:   may use   id3v1tag.clear   or   id3v1tag = {}  instead
+
+# ------------------------------------------------------------------------------
+
+# EXAMPLE of stripping attached pictures from id3v2-tags if present, 
+#         and re-setting the play counter to 0
+#         and setting the comment to something silly
+
+file = "bla.mp3"
+if ID3::has_id3v2_tag?( file )
+   myfile = AudioFile.open( file )        # do we need a new here?
+#   if (myfile.id3v2tag.member?(PICTURE))  # if there is a picture in the tag..
+      myfile.id3v2tag.delete(PICTURE)     # deletes the unwanted picture..
+#   end
+   myfile.id3v2tag["PLAYCOUNTER"] = 0     # reset the play counter to 0
+   myfile.id3v2tag["COMMENT"] = "Tilo's MP3 collection"   # set the comment
+   
+   myfile.id3v2tag.options["PADDINGSIZE"] = 0        # shrink the tag!
+   myfile.id3v2tag.options["APPENDTAG"]   = false    # shrink the tag!
+   myfile.id3v2tag.options["FOOTER"]      = false    # shrink the tag!
+   myfile.id3v2tag.options["EXT_HEADER"]  = false    # shrink the tag!
+   
+   myfile.write   # writes to the same filename, overwriting the old file
+   myfile.write("new.mp3")   # creates new file
+   myfile.close
+end
+
+# ------------------------------------------------------------------------------
+
+# CODE FRAGMENT   from initialization of AudioFile
+
+# when we open a file and create a new ID3-tag, we should do this internally:
+
+   v1 = ID3::has_id3v1_tag?( file )
+   v2 = ID3::has_id3v2_tag?( file )       # but may not be a version we know
+                                          # about...
+   
+   if (v2)                                # if version is not nil
+      id3v2tag = ID3v2tag.new( v2 )       # only create tag if one in file
+   end 
+   
+   if (v1)
+      id3v1tag = ID3v1tag.new( v1 )       # only create tag if one in file
+   end 
+
+# or we do it the same way as in the old library:
+
+   v1 = ID3::has_id3v1_tag?( file )
+   v2 = ID3::has_id3v2_tag?( file )
+
+   id3v2tag = ID3v2tag.new( v2 ) 
+   id3v2tag.read_v2(file)
+   
+   
+# similarly, when creating a new frame, we need to read it first, 
+# before we can create the correct instance with the correct singleton
+# methods...
+
+   frame = Frame.new  # should create a new frame of the correct type..
+   
+# ------------------------------------------------------------------------------
+
+
+
+
+   
+------------------------------------------------------------------------------
+
+# EXAMPLE tagging an existing MP3 track..
+
+file = "/tmp/rheeeeet.mp3"    # ./examples/mp3/rheeeeet.mp3
+
+if ! ID3.hasID3v2tag?(file)     # if there is no v2 tag 
+
+   myfile = AudioFile.new( file )        # do we need a new here?
+   
+   newtag = ID3::Tag2.new                # create a new,empty v2 tag
+   newtag.version = '2.3.0'
+   newtag["TITLE"] = "Reeeeet!"
+   newtag["ARTIST"] = "Dan Mosedale"
+   newtag["LYRICIST"] = "Dan Mosedale"
+   newtag["COMPOSER"] = "Dan Mosedale"
+   newtag["LANGUAGE"] = "Monkey"          # should raise an error, because there is no 
+                                          # ISO language code for "Monkey"
+                                          
+   newtag["BAND"] = "Mozilla and the ButtMonkeys"
+   newtag["TRACKNUM"] = '1'               # will be converted to "1"
+   newtag["DATE"] = "2000/05/02"          # will be converted to correct date format
+   
+   newtag["COMMENT"] = "The sound which monkeys make when they are flying out of someones butt..   Which is refering to the estimated release date of Netscape 6. See: https://wiki.mozilla.org/SeaMonkey:Name_And_Version"
+   
+   newtag.options["PADDINGSIZE"] = 0
+
+   myfile.tagID3v2 = newtag         # assoziate the new tag with the AudioFile..
+                                    # NOTE: we should CHECK when assigning a tag, 
+                                    #       that the version number matches!
+
+   myfile.write               # if we overwrite, we should save the old tag in "filename.oldtag"
+   myfile.close
+end      
+------------------------------------------------------------------------------
+
+# EXAMPLE to convert a file from older id3v2.x tags to id3v2.3 tags
+
+file = "bla.mp3"
+if ID3::has_id3v2_tag?( file )
+   myfile = AudioFile.open( file )        # do we need a new here?
+   
+   if (myfile.id3v2tag.version < "2.3.0")
+
+   
+       newtag = ID3v2tag("2.3.0")
+       
+#       newtag = ID3v2tag.new              # create new empty tag 
+#       newtag.version = "2.3.0"           # of specific version
+
+       myfile.id3v2tag.each { |key, value|
+           newtag[key] = value
+       }
+       myfile.id3v2tag = newtag
+
+       myfile.id3v2tag.options["PADDINGSIZE"] = 0      # shrink the tag!
+
+       myfile.write   # writes to the same filename, overwriting the old file
+       myfile.write("new.mp3")   # creates new file
+       
+   end
+   
+   myfile.close
+end
+
+------------------------------------------------------------------------------
+
+# EXAMPLE to check if two tags are equivalent.. e.g. if they contain the 
+#         same fields with the same values..
+
+ID3::tags_equivalent(other)
+
+# we also need to check if the number of keys is the same in each hash
+
+equivalent = true
+self.each { |key,value| 
+   equivalent = false   if self[key] != other[key]
+}
+return equivalent
+
+------------------------------------------------------------------------------

data/examples/old/id3statistics.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/ruby
+
+# this script collects statistical output about ID3 collection
+#
+
+require "id3"
+
+
+# ------------------------------------------------------------------------------
+# recursiveDirectoryDescend
+#      do action for files matching regexp
+#
+#      could be extended to array of (regexp,action) pairs
+#
+def recursiveDirectoryDescend(dir,regexp,action)
+ # print "dir : #{dir}\n"
+
+  olddir = Dir.pwd
+  dirp = Dir.open(dir)
+  Dir.chdir(dir)
+  pwd = Dir.pwd
+  @@dirN += 1
+
+  for file in dirp
+    file.chomp
+    next if file =~ /^\.\.?$/
+
+    fullname = "#{pwd}/#{file}"
+
+    if File::directory?(fullname)
+       recursiveDirectoryDescend(fullname,regexp,action)
+    else
+       @@fileN += 1
+       if file =~ regexp
+           # evaluate action
+           eval action
+       end
+    end
+  end
+  Dir.chdir(olddir)
+end
+# ------------------------------------------------------------------------------
+
+def eachSong(filename)
+  filename.chomp!
+  print "MP3-FILE: #{filename}"
+  @@mp3fileN += 1
+
+  if (File.size(filename) == 0)
+    puts " -- empty file\n"
+    return
+  end
+
+  v = 0
+  tagN = 0
+
+  v = ID3::hasID3v1tag?(filename)
+  if v 
+    print " -- found ID3-tag version #{v}"
+    @@id3versionN[v] += 1
+    tagN += 1
+  end
+
+  v = ID3::hasID3v2tag?(filename)
+  if v 
+    print " -- found ID3-tag version #{v}"
+    @@id3versionN[v] += 1
+    tagN += 1
+
+    tag2= ID3::Tag2.new
+    tag2.read(filename)
+
+    size = tag2.raw.size
+    @@sizeSum += size
+    @@sizeMax = size if size > @@sizeMax
+    printf "\ntag-size: %d , tag-keys: %s\n", size, tag2.keys.join(',')
+
+    
+    tag2.keys.each { |field|
+        @@fieldsUsedN[tag2.version][field] += 1
+    }
+  end
+  if tagN == 0
+    print " -- no ID3-tag"
+  end
+  @@tagsPerFileN[tagN] += 1
+  puts "\n"
+end
+# ------------------------------------------------------------------------------
+
+
+@@fileN = 0
+@@mp3fileN = 0
+@@dirN  = 0
+@@id3versionN = Hash.new(0)
+
+@@fieldsUsedN = {}
+ID3::VERSIONS.each do |v|
+   @@fieldsUsedN[v] ||= Hash.new(0)
+end
+
+@@sizeMax = 0
+@@sizeSum = 0
+
+
+@@tagsPerFileN= Array.new(3,0)
+
+dir = ARGV[0]
+
+recursiveDirectoryDescend(dir, /.*\.[mM][pP]3/, %q{ eachSong(fullname) } )
+
+
+print "
+
+Files checked      : #{@@fileN}
+Directories checked: #{@@dirN}
+
+MP3 Files found  : #{@@mp3fileN}
+"
+
+version2tagN = 0
+
+@@id3versionN.keys.each { |v|
+  printf "\nnumber of ID3 tags v#{v} : #{@@id3versionN[v]}\n"
+  version2tagN += 1 if v =~ /^2\./
+}
+
+puts "\n"
+
+@@tagsPerFileN.each_index{ |x|
+  printf "\nFiles tagged #{x}-times : #{@@tagsPerFileN[x]}\n"
+}
+
+ID3::SUPPORTED_SYMBOLS.keys.sort.each{ |v|
+
+  puts "\nFIELDS USED IN VERSION #{v}\n"
+
+  @@fieldsUsedN[v].keys.each { |field|
+     printf "\t%20s : %d\n", field, @@fieldsUsedN[v][field]
+  }
+
+}
+
+printf "\nMax v2 Tag Size was: %d , Average Tag Size was: %d\n" , @@sizeMax, (@@sizeSum / version2tagN)
+puts "\n\ndone."

data/examples/read_remote_id3v2_tag.rb

@@ -0,0 +1,74 @@
+# -*- coding: undecided -*-
+
+# See also: http://stackoverflow.com/questions/7656950/read-id3-tags-of-remote-mp3-file-in-ruby-rails
+
+require 'rubygems'
+require 'awesome_print'    # debugging only
+
+require 'net/http'
+require 'uri'
+require 'id3'
+require 'hexdump'          # debugging only
+
+# --------------------------------------------------------------------------------------------
+
+def get_remote_id3v2_tag( file_url )
+  id3v2_tag_size = get_remote_id3v2_tag_size( file_url )
+  if id3v2_tag_size > 0
+    buffer = get_remote_bytes(file_url, id3v2_tag_size )
+    tag2 = ID3::Tag2.new
+    tag2.read_from_buffer( buffer )
+    return tag2
+  else
+    return nil
+  end
+end
+
+def get_remote_id3v2_tag_size( file_url )
+  buffer = get_remote_bytes( file_url, 100 )
+  if buffer.bytesize > 0
+    return buffer.ID3v2_tag_size
+  else
+    return 0
+  end
+end
+
+def get_remote_bytes( file_url, n)
+  uri = URI(file_url)
+  size = n   # ID3v2 tags can be considerably larger, because of embedded album pictures
+  Net::HTTP.version_1_2  # make sure we use higher HTTP protocol version than 1.0
+  http = Net::HTTP.new(uri.host, uri.port)
+  resp = http.get( file_url , {'Range' => "bytes=0-#{size-1}"} )
+  resp_code = resp.code.to_i
+  if (resp_code >= 200 && resp_code < 300) then
+    return resp.body
+  else
+    return ''
+  end
+end
+
+# --------------------------------------------------------------------------------------------
+
+file_url = 'http://www.unixgods.org/~tilo/ID3/example_mp3_file_with_id3v2.mp3'  # please specify a URL here for testing
+
+
+puts "\nRemote File: \"#{file_url}\""
+
+puts "\ncontains ID3v2 tag of size: #{get_remote_id3v2_tag_size( file_url )} Bytes"
+
+tag2 =  get_remote_id3v2_tag( file_url )
+
+puts "\nID3v3 Version: #{tag2.version}\n"
+
+puts "\ncontains Frames:\n"
+ap tag2.keys
+
+puts "\nID3v2 Tag:\n"
+
+ap( tag2 )
+
+puts "\nID3v2 Hexdump:\n"
+
+puts tag2.raw.hexdump(true)
+
+

data/id3.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "id3/version"
+
+spec = Gem::Specification.new do |s|
+  s.name = 'id3'
+  s.version = ID3::VERSION
+  s.authors = ['Tilo Sloboda']
+  s.email  = ['tilo.sloboda@gmail.com']
+  s.homepage = 'http://www.unixgods.org/~tilo/Ruby/ID3'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'A native ID3 tag library for Ruby, which does not depend on architecture-dependent C-libraries. It supports reading and writing ID3-tag versions 1.0, 1.1, and 2.2.x, 2,3.x, 2,4.x\n http://www.unixgods.org/~tilo/Ruby/ID3'
+  s.description = 'ID3 is a native ruby library for reading and writing ID3 tag versions 1.0, 1.1, and 2.2.x, 2,3.x, 2,4.x'
+
+ s.files         = `git ls-files`.split("\n")
+#  s.files = Dir['docs/**/*'] + Dir['lib/*.rb'] + Dir['lib/id3/*.rb']  + Dir['lib/helpers/*.rb'] + ['LICENSE.html' , 'index.html',  'README.md' , 'CHANGES']
+#  s.test_files = FileList["{tests}/**/*test.rb"].to_a
+  s.has_rdoc = false
+  s.require_paths = ['lib']
+  s.autorequire = 'id3'
+#  s.extra_rdoc_files = ['README']
+  s.rdoc_options << '--title' <<  'Native ID3 Ruby Library - uniform acecss to ID3v1 and ID3v2 tags'
+  s.add_dependency("activesupport", ">= 5")
+#  s.add_dependency("dependency", ">= 0.9.9")
+#  s.bindir = 'bin'
+
+  s.rubyforge_project = 'id3'
+#  s.rubyforge_project = ['none']
+end
+
+#Rake::GemPackageTask.new(spec) do |pkg|
+#  pkg.need_tar = true
+#end

data/lib/id3/constants.rb

@@ -3,7 +3,7 @@ module ID3
   # ----------------------------------------------------------------------------
   #    CONSTANTS
   # ----------------------------------------------------------------------------
-  Version = '1.0.0_pre5'
+  Version = VERSION
 
   ID3v1tagSize     = 128     # ID3v1 and ID3v1.1 have fixed size tags
   ID3v1versionbyte = 125

data/lib/id3/version.rb

@@ -0,0 +1,3 @@
+module ID3
+  VERSION = '1.0.0'
+end

data/lib/id3.rb

@@ -14,6 +14,7 @@ require "helpers/hexdump"           # only needed for debugging -> autoload
 require 'id3/string_extensions'     # adds ID3 methods to String
 require 'id3/io_extensions'         # adds ID3 methods to IO and File
 
+require 'id3/version'               # Gem Version
 require 'id3/constants'             # Constants used throughout the code
 require 'id3/module_methods'        # add ID3 methods to ID3 which operate on filenames
 

metadata

@@ -1,103 +1,116 @@
 --- !ruby/object:Gem::Specification
 name: id3
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre5
-  prerelease: 6
+  version: 1.0.0
 platform: ruby
 authors:
 - Tilo Sloboda
 autorequire: id3
 bindir: bin
 cert_chain: []
-date: 2012-08-14 00:00:00.000000000 Z
+date: 2025-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &17448120 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.x
+        version: '5'
   type: :runtime
   prerelease: false
-  version_requirements: *17448120
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
 description: ID3 is a native ruby library for reading and writing ID3 tag versions
   1.0, 1.1, and 2.2.x, 2,3.x, 2,4.x
-email: tilo.sloboda@gmail.com
+email:
+- tilo.sloboda@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- docs/ID3_comparison.html
-- docs/hexdump.rb
-- docs/Class_Frame.html
-- docs/ID3v2_frames_overview.txt
+- ".gitignore"
+- CHANGES
+- LICENSE.html
+- README.md
+- Rakefile
+- docs/API
 - docs/Class_AudioFile.html
-- docs/ID3v2_frames_comparison.html
-- docs/index.html
-- docs/ID3_comparison2.html
+- docs/Class_Frame.html
+- docs/Class_Tag1.html
 - docs/Class_Tag2.html
-- docs/Module_ID3.html
-- docs/id3.html
 - docs/ID3-Standards/id3v2-00.html
+- docs/ID3-Standards/id3v2-00.txt
+- docs/ID3-Standards/id3v2.3.0.html
+- docs/ID3-Standards/id3v2.3.0.txt
+- docs/ID3-Standards/id3v2.4.0-changes.html
 - docs/ID3-Standards/id3v2.4.0-changes.txt
 - docs/ID3-Standards/id3v2.4.0-frames.html
-- docs/ID3-Standards/id3v2.3.0.html
 - docs/ID3-Standards/id3v2.4.0-frames.txt
-- docs/ID3-Standards/id3v2.4.0-structure.txt
-- docs/ID3-Standards/id3v2.4.0-changes.html
-- docs/ID3-Standards/id3v2.3.0.txt
 - docs/ID3-Standards/id3v2.4.0-structure.html
-- docs/ID3-Standards/id3v2-00.txt
-- docs/Class_Tag1.html
+- docs/ID3-Standards/id3v2.4.0-structure.txt
+- docs/ID3_comparison.html
+- docs/ID3_comparison2.html
+- docs/ID3v2_frames_comparison.html
+- docs/ID3v2_frames_overview.txt
+- docs/Module_ID3.html
+- docs/hexdump.rb
+- docs/id3.html
+- docs/index.html
+- examples/id3_statistics_with_Audiofile.rb
+- examples/mp3/example_mp3_file_with_id3v2_2_0.mp3
+- examples/mp3/rheeeeet.mp3
+- examples/old/example2.rb
+- examples/old/examples.rb
+- examples/old/id3statistics.rb
+- examples/read_remote_id3v2_tag.rb
+- id3.gemspec
+- index.html
+- lib/helpers/hash_extensions.rb
+- lib/helpers/hexdump.rb
+- lib/helpers/invert_hash.rb
+- lib/helpers/recursive_helper.rb
+- lib/helpers/restricted_ordered_hash.rb
+- lib/helpers/ruby_1.8_1.9_compatibility.rb
 - lib/id3.rb
-- lib/id3/module_methods.rb
-- lib/id3/id3.rb
+- lib/id3/audiofile.rb
 - lib/id3/constants.rb
-- lib/id3/tag2.rb
 - lib/id3/frame.rb
+- lib/id3/frame_array.rb
 - lib/id3/generic_tag.rb
-- lib/id3/audiofile.rb
+- lib/id3/id3.rb
 - lib/id3/io_extensions.rb
-- lib/id3/tag1.rb
-- lib/id3/frame_array.rb
+- lib/id3/module_methods.rb
 - lib/id3/string_extensions.rb
-- lib/helpers/hexdump.rb
-- lib/helpers/ruby_1.8_1.9_compatibility.rb
-- lib/helpers/invert_hash.rb
-- lib/helpers/recursive_helper.rb
-- lib/helpers/hash_extensions.rb
-- lib/helpers/restricted_ordered_hash.rb
-- LICENSE.html
-- index.html
-- README.md
-- CHANGES
+- lib/id3/tag1.rb
+- lib/id3/tag2.rb
+- lib/id3/version.rb
 homepage: http://www.unixgods.org/~tilo/Ruby/ID3
 licenses: []
-post_install_message: 
+metadata: {}
+post_install_message:
 rdoc_options:
-- --title
+- "--title"
 - Native ID3 Ruby Library - uniform acecss to ID3v1 and ID3v2 tags
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>'
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubyforge_project: id3
-rubygems_version: 1.8.15
-signing_key: 
-specification_version: 3
+rubygems_version: 3.5.4
+signing_key:
+specification_version: 4
 summary: A native ID3 tag library for Ruby, which does not depend on architecture-dependent
   C-libraries. It supports reading and writing ID3-tag versions 1.0, 1.1, and 2.2.x,
   2,3.x, 2,4.x\n http://www.unixgods.org/~tilo/Ruby/ID3