dmapparser 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b4f0392efe8fbb5cb490326f252de2ba2ad14320
+  data.tar.gz: 83521f2817e52ffa041ae04097e41106fc23920d
+SHA512:
+  metadata.gz: 4e6d311c7458783399f658271061e26e3fb7716bf9487159148f6c39d49b911ee14fc62cf676f3d91920587618d59f741bd0b84efa1b12c4da732206891243c7
+  data.tar.gz: 538395db0d8f903ee3f141e9bfeb53f3e4829ab313551060e6a2f291b55a3558a48a1921bbe0235b834efa24cfa41c35ee0fec2fcf2708c2781af2e9cb69bad4

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dmapparser.gemspec
+gemspec
+
+group :test do
+  gem 'minitest', '~> 5.2.2'
+  gem 'coveralls', require: false
+  gem 'rubocop', '~> 0.18.0'
+  gem 'simplecov', require: false
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Jurriaan Pruis
+
+MIT License
+
+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/README.md

@@ -0,0 +1,27 @@
+# DMAPParser
+
+[![Gem Version](https://badge.fury.io/rb/dmapparser.png)](http://badge.fury.io/rb/dmapparser) [![Dependency Status](https://gemnasium.com/jurriaan/dmapparser.png)](https://gemnasium.com/jurriaan/dmapparser)
+
+Parses DMAP data
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'dmapparser'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dmapparser
+
+## Contributing
+
+1. Fork it ( http://github.com/jurriaan/dmapparser/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,22 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rubocop'
+require 'yard'
+YARD::Rake::YardocTask.new
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib/dmapparser'
+  t.test_files = FileList['test/lib/**/*_test.rb']
+  t.verbose = true
+end
+
+task test: :rubocop
+
+task :rubocop do
+  puts "Running Rubocop #{Rubocop::Version::STRING}"
+  args = FileList['**/*.rb', 'Rakefile', 'dmapparser.gemspec', 'Gemfile']
+  cli = Rubocop::CLI.new
+  fail unless cli.run(['-a'] + args) == 0
+end
+
+task default: :test

data/bin/dmapparser

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'dmapparser'
+puts DMAPParser::Parser.parse(ARGF.to_io).inspect

data/dmapparser.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dmapparser/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'dmapparser'
+  spec.version       = DMAPParser::VERSION
+  spec.authors       = ['Jurriaan Pruis']
+  spec.email         = ['email@jurriaanpruis.nl']
+  spec.summary       = %q{Parses DMAP data}
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(/^bin\//) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(/^(test|spec|features)\//)
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'yard'
+  spec.add_development_dependency 'rake'
+end

data/lib/dmapparser.rb

@@ -0,0 +1,3 @@
+require 'dmapparser/version'
+require 'dmapparser/parser'
+require 'dmapparser/builder'

data/lib/dmapparser/builder.rb

@@ -0,0 +1,49 @@
+require 'dmapparser/tag_definitions'
+module DMAPParser
+  # This class provides a DSL to create DMAP responses
+  class Builder
+    attr_reader :result
+
+    def initialize
+      @dmap_stack = []
+    end
+
+    def self.method_missing(method, *args, &block)
+      new.send(method, *args, &block)
+    end
+
+    def method_missing(method, *args, &block)
+      tag = TagDefinition[method]
+      return super if tag.nil?
+
+      if block_given?
+        fail "Tag #{tag} is not a container type" unless tag.container?
+        build_container(tag, &block)
+      else
+        build_tag(tag, args)
+      end
+    end
+
+    private
+
+    def build_tag(tag, args)
+      if @dmap_stack.length > 0
+        args = args.size > 1 ? args : args.first
+        @dmap_stack.last.value << Tag.new(tag, args)
+      else
+        fail 'Cannot build DMAP without a valid container'
+      end
+    end
+
+    def build_container(tag , &block)
+      @dmap_stack << TagContainer.new(tag)
+      instance_exec(&block)
+      if @dmap_stack.length > 1
+        cur_tag = @dmap_stack.pop
+        @dmap_stack.last.value << cur_tag
+      else
+        @result = @dmap_stack.pop
+      end
+    end
+  end
+end

data/lib/dmapparser/converter.rb

@@ -0,0 +1,124 @@
+module DMAPParser
+  # The DMAPConverter class converts between binary and ruby formats
+  class Converter
+    class << self
+      def date_to_bin(data)
+        int_to_bin(value.to_i)
+      end
+
+      def bin_to_byte(data)
+        data.unpack('C').first
+      end
+
+      def bin_to_long(data)
+        (bin_to_int(data[0..3]) << 32) + bin_to_int(data[4..7])
+      end
+
+      def bin_to_int(data)
+        data.unpack('N').first
+      end
+
+      def bin_to_short(data)
+        data.unpack('n').first
+      end
+
+      def bin_to_bool(data)
+        data == "\x01"
+      end
+
+      def bin_to_version(data)
+        data.unpack('nCC').join '.'
+      end
+
+      def bin_to_hex(data)
+        data.bytes.reduce('') { |a, e| a + sprintf('%02X', e) }
+      end
+
+      def bin_to_date(data)
+        Time.at(bin_to_int(data))
+      end
+
+      def bool_to_bin(data)
+        (data ? 1 : 0).chr
+      end
+
+      def int_to_bin(data)
+        [data.to_i].pack 'N'
+      end
+
+      def byte_to_bin(data)
+        [data.to_i].pack 'C'
+      end
+
+      def long_to_bin(data)
+        [data >> 32, data & 0xfffffff].pack 'NN'
+      end
+
+      def short_to_bin(data)
+        [data.to_i].pack 'n'
+      end
+
+      def version_to_bin(data)
+        data.split('.').pack 'nCC'
+      end
+
+      def hex_to_bin(data)
+        [data].pack 'H*'
+      end
+
+      def decode_unknown(data)
+        if data =~ /[^\x20-\x7e]/ # non-readable characters
+          data_to_numeric(data)
+        else
+          data
+        end
+      end
+
+      def data_to_numeric(data)
+        if data.bytesize == 1
+          return Converter.bin_to_byte(data)
+        elsif data.bytesize == 2
+          return Converter.bin_to_short(data)
+        elsif data.bytesize == 4
+          return Converter.bin_to_int(data)
+        elsif data.bytesize == 8
+          return Converter.bin_to_long(data)
+        end
+      end
+
+      def bin_to_string(data)
+        data.force_encoding('utf-8')
+      end
+      alias_method :string_to_bin, :bin_to_string
+
+      alias_method :uint16_to_bin, :short_to_bin
+      alias_method :uint32_to_bin, :int_to_bin
+      alias_method :uint64_to_bin, :long_to_bin
+
+      alias_method :bin_to_uint16, :bin_to_short
+      alias_method :bin_to_uint32, :bin_to_int
+      alias_method :bin_to_uint64, :bin_to_long
+      alias_method :bin_to_unknown, :decode_unknown
+
+      def decode(type, data)
+        decode_method = ('bin_to_' + type.to_s).to_sym
+        if respond_to? decode_method
+          send(decode_method, data)
+        else
+          warn "Decoder: Unknown type #{type}"
+          decode_unknown(data)
+        end
+      end
+
+      def encode(type, data)
+        encode_method = (type.to_s + '_to_bin').to_sym
+        if respond_to? encode_method
+          send(encode_method, data)
+        else
+          warn "Encoder: Unknown type #{type}"
+          data
+        end
+      end
+    end
+  end
+end

data/lib/dmapparser/parser.rb

@@ -0,0 +1,72 @@
+require 'dmapparser/tag_definitions'
+require 'dmapparser/converter'
+require 'stringio'
+
+module DMAPParser
+  # The DMAPParser class parses DMAP responses
+  class Parser
+    ParseError = Class.new(StandardError)
+
+    def self.parse(response)
+      new(response).parse
+    end
+
+    def initialize(response)
+      @response = response
+      @response = StringIO.new(response) unless @response.is_a? IO
+      @response.set_encoding(Encoding::UTF_8) # Use unicode
+    end
+
+    def parse
+      return nil if @response.nil? || @response.size == 0
+      fail ParseError if @response.size < 8
+      ret = TagContainer.new
+      ret.type = TagDefinition[read_key]
+      fail ParseError if ret.type && !ret.type.container?
+      ret.value = parse_container(read_length)
+      ret
+    end
+
+    private
+
+    def bytes_left
+      @response.size - @response.pos
+    end
+
+    def bytes_available?(num = 1)
+      bytes_left - num >= 0
+    end
+
+    def read_bytes(length)
+      unless bytes_available?(length)
+        fail ParseError, 'Not enough data available'
+      end
+      @response.read(length)
+    end
+
+    def read_length
+      Converter.bin_to_int(read_bytes(4))
+    end
+
+    def read_key
+      read_bytes(4)
+    end
+
+    def parse_container(container_length)
+      values = []
+      end_pos = container_length + @response.pos
+      values << build_tag(read_key, read_length) until @response.pos == end_pos
+      values
+    end
+
+    def build_tag(key, length)
+      tag = TagDefinition[key] ||
+            TagDefinition.new(key, :unknown, "unknown (#{length})")
+      if tag.container?
+        TagContainer.new(tag, parse_container(length))
+      else
+        Tag.new(tag, Converter.decode(tag.type, read_bytes(length)))
+      end
+    end
+  end
+end

data/lib/dmapparser/tag.rb

@@ -0,0 +1,24 @@
+module DMAPParser
+  # The Tag class
+  class Tag < Struct.new(:type, :value)
+    def to_s
+      "#<#{self.class.name} #{type}>"
+    end
+
+    def inspect(level = 0)
+      "#{'  ' * level}#{type}: #{value}"
+    end
+
+    def to_dmap
+      value = convert_value(self.value)
+      length = [value.length].pack('N')
+      (type.tag.to_s + length + value).force_encoding('utf-8')
+    end
+
+    private
+
+    def convert_value(value)
+      Converter.encode(type.type, value)
+    end
+  end
+end

data/lib/dmapparser/tag_container.rb

@@ -0,0 +1,62 @@
+module DMAPParser
+  # The TagContainer class is a Tag which contains other Tags
+  class TagContainer < Tag
+    def initialize(type = nil, value = [])
+      super type, value
+    end
+
+    def inspect(level = 0)
+      "#{'  ' * level}#{type}:\n" + value.reduce('') do |a, e|
+        a + e.inspect(level + 1).chomp + "\n"
+      end
+    end
+
+    def get_value(key)
+      return value[key] if key.is_a? Fixnum
+
+      tag = get_tag(key)
+
+      if tag.type.container?
+        tag
+      elsif !tag.nil?
+        tag.value
+      end
+    end
+
+    def get_tag(key)
+      key = key.to_s
+      value.find { |e| e.type.tag == key || e.type.name == key }
+    end
+
+    alias_method :[], :get_value
+
+    def has?(key)
+      !get_tag(key).nil?
+    end
+
+    def method_missing(method, *arguments, &block)
+      if method =~ /(.*)\?$/
+        has?(Regexp.last_match[1])
+      elsif has?(method)
+        get_value(method)
+      else
+        super
+      end
+    end
+
+    def respond_to?(method)
+      method.to_s.match(/(.*)\??$/)
+      has?(Regexp.last_match[1]) || super
+    end
+
+    def to_a
+      value
+    end
+
+    private
+
+    def convert_value(value)
+      value.reduce('') { |a, e| a + e.to_dmap }
+    end
+  end
+end

data/lib/dmapparser/tag_definition.rb

@@ -0,0 +1,32 @@
+require 'dmapparser/tag'
+require 'dmapparser/tag_container'
+
+module DMAPParser
+  # The TagDefinition class describes the tags
+  class TagDefinition < Struct.new(:tag, :type, :name)
+    DEFINITIONS = Hash.new(nil)
+
+    def to_s
+      "#{tag} (#{name}: #{type})"
+    end
+
+    alias_method :inspect, :to_s
+
+    def container?
+      type == :container
+    end
+
+    class << self
+      def find(key)
+        DEFINITIONS[key.to_s]
+      end
+
+      def tag(*args, &block)
+        definition = new(*args, &block).freeze
+        DEFINITIONS[definition.tag.to_s] = definition
+      end
+
+      alias_method :[], :find
+    end
+  end
+end

data/lib/dmapparser/tag_definitions.rb

@@ -0,0 +1,181 @@
+require 'dmapparser/tag_definition'
+module DMAPParser
+  # Sources:
+  # https://github.com/chendo/dmap-ng/blob/master/lib/dmap/tag_definitions.rb
+  # https://code.google.com/p/ytrack/wiki/DMAP
+  # https://code.google.com/p/tunesremote-se/wiki/ContentCodes
+  # https://raw.github.com/mattstevens/dmap-parser/master/dmap_parser.c
+  # /content-codes
+  # rubocop:disable ClassLength
+  class TagDefinition
+    tag 'mcon', :container, 'dmap.container'
+    tag 'msrv', :container, 'dmap.serverinforesponse'
+    tag 'msml', :container, 'dmap.msml'
+    tag 'mccr', :container, 'dmap.contentcodesresponse'
+    tag 'mdcl', :container, 'dmap.dictionary'
+    tag 'mlog', :container, 'dmap.loginresponse'
+    tag 'mupd', :container, 'dmap.updateresponse'
+    tag 'avdb', :container, 'daap.serverdatabases'
+    tag 'mlcl', :container, 'dmap.listing'
+    tag 'mlit', :container, 'dmap.listingitem'
+    tag 'mbcl', :container, 'dmap.bag'
+    tag 'adbs', :container, 'daap.returndatabasesongs'
+    tag 'aply', :container, 'daap.databaseplaylists'
+    tag 'apso', :container, 'daap.playlistsongs'
+    tag 'mudl', :container, 'dmap.deletedidlisting'
+    tag 'abro', :container, 'daap.databasebrowse'
+    tag 'abal', :container, 'daap.browsealbumlisting'
+    tag 'abar', :container, 'daap.browseartistlisting'
+    tag 'abcp', :container, 'daap.browsecomposerlisting'
+    tag 'abgn', :container, 'daap.browsegenrelisting'
+    tag 'prsv', :container, 'daap.resolve'
+    tag 'arif', :container, 'daap.resolveinfo'
+    tag 'casp', :container, 'dacp.speakers'
+    tag 'caci', :container, 'dacp.controlint'
+    tag 'cmpa', :container, 'dacp.pairinganswer'
+    tag 'cacr', :container, 'dacp.cacr'
+    tag 'cmcp', :container, 'dmcp.controlprompt'
+    tag 'cmgt', :container, 'dmcp.getpropertyresponse'
+    tag 'cmst', :container, 'dmcp.status'
+    tag 'agal', :container, 'daap.albumgrouping'
+    tag 'minm', :string, 'dmap.itemname'
+    tag 'msts', :string, 'dmap.statusstring'
+    tag 'mcna', :string, 'dmap.contentcodesname'
+    tag 'asal', :string, 'daap.songalbum'
+    tag 'asaa', :string, 'daap.songalbumartist'
+    tag 'asar', :string, 'daap.songartist'
+    tag 'ascm', :string, 'daap.songcomment'
+    tag 'asfm', :string, 'daap.songformat'
+    tag 'aseq', :string, 'daap.songeqpreset'
+    tag 'asgn', :string, 'daap.songgenre'
+    tag 'asdt', :string, 'daap.songdescription'
+    tag 'asul', :string, 'daap.songdataurl'
+    tag 'ceWM', :string, 'com.apple.itunes.welcome-message'
+    tag 'ascp', :string, 'daap.songcomposer'
+    tag 'assu', :string, 'daap.sortartist'
+    tag 'assa', :string, 'daap.sortalbum'
+    tag 'agrp', :string, 'daap.songgrouping'
+    tag 'cann', :string, 'daap.nowplayingtrack'
+    tag 'cana', :string, 'daap.nowplayingartist'
+    tag 'canl', :string, 'daap.nowplayingalbum'
+    tag 'cang', :string, 'daap.nowplayinggenre'
+    tag 'cmnm', :string, 'dacp.devicename'
+    tag 'cmty', :string, 'dacp.devicetype'
+    tag 'cmpg', :hex, 'dacp.pairingguid' # hex string
+    tag 'mper', :uint64, 'dmap.persistentid'
+    tag 'canp', :uint64, 'dacp.nowplaying'
+    tag 'cmpy', :uint64, 'dacp.passguid'
+    tag 'mdbk', :uint32, 'dmap.databasekind'
+    tag 'aeCs', :uint32, 'com.apple.itunes.artworkchecksum'
+    tag 'mctc', :uint32, 'dmap.containercount'
+    tag 'aeMk', :uint32, 'com.apple.itunes.mediakind'
+    tag 'aeMK', :uint32, 'com.apple.itunes.extended-mediakind'
+    tag 'mstt', :uint32, 'dmap.status' # http status??
+    tag 'mcnm', :string, 'dmap.contentcodesnumber'
+    tag 'meds', :uint32, 'dmap.editcommandssupported'
+    tag 'miid', :uint32, 'dmap.itemid'
+    tag 'mcti', :uint32, 'dmap.containeritemid'
+    tag 'mpco', :uint32, 'dmap.parentcontainerid'
+    tag 'mimc', :uint32, 'dmap.itemcount'
+    tag 'mrco', :uint32, 'dmap.returnedcount'
+    tag 'mtco', :uint32, 'dmap.containercount'
+    tag 'mstm', :uint32, 'dmap.timeoutinterval'
+    tag 'msdc', :uint32, 'dmap.databasescount'
+    tag 'msma', :uint32, 'dmap.speakermachineaddress'
+    tag 'mlid', :uint32, 'dmap.sessionid'
+    tag 'assr', :uint32, 'daap.songsamplerate'
+    tag 'assz', :uint32, 'daap.songsize'
+    tag 'asst', :uint32, 'daap.songstarttime'
+    tag 'assp', :uint32, 'daap.songstoptime'
+    tag 'astm', :uint32, 'daap.songtime'
+    tag 'msto', :uint32, 'dmap.utcoffset'
+    tag 'cmsr', :uint32, 'dmcp.mediarevision'
+    tag 'caas', :uint32, 'dacp.albumshuffle'
+    tag 'caar', :uint32, 'dacp.albumrepeat'
+    tag 'cant', :uint32, 'dacp.remainingtime'
+    tag 'cmmk', :uint32, 'dmcp.mediakind'
+    tag 'cast', :uint32, 'dacp.tracklength'
+    tag 'asai', :uint32, 'daap.songalbumid'
+    tag 'aeNV', :uint32, 'com.apple.itunes.norm-volume'
+    tag 'cmvo', :uint32, 'dmcp.volume'
+    tag 'mcty', :uint16, 'dmap.contentcodestype'
+    tag 'asbt', :uint16, 'daap.songsbeatsperminute'
+    tag 'asbr', :uint16, 'daap.songbitrate'
+    tag 'asdc', :uint16, 'daap.songdisccount'
+    tag 'asdn', :uint16, 'daap.songdiscnumber'
+    tag 'astc', :uint16, 'daap.songtrackcount'
+    tag 'astn', :uint16, 'daap.songtracknumber'
+    tag 'asyr', :uint16, 'daap.songyear'
+    tag 'ated', :uint16, 'daap.supportsextradata'
+    tag 'asgr', :uint16, 'daap.supportsgroups'
+    tag 'mikd', :byte, 'dmap.itemkind'
+    tag 'casu', :byte, 'dacp.su'
+    tag 'msau', :byte, 'dmap.authenticationmethod'
+    tag 'mstu', :byte, 'dmap.updatetype'
+    tag 'asrv', :byte, 'daap.songrelativevolume'
+    tag 'asur', :byte, 'daap.songuserrating'
+    tag 'asdk', :byte, 'daap.songdatakind'
+    tag 'caps', :byte, 'dacp.playstatus'
+    tag 'cash', :byte, 'dacp.shufflestate'
+    tag 'carp', :byte, 'dacp.repeatstate'
+    tag 'cavc', :byte, 'dacp.volumecontrollable'
+    tag 'cafe', :byte, 'dacp.fullscreenenabled'
+    tag 'cave', :byte, 'dacp.visualizerenabled'
+    tag 'muty', :byte, 'dmap.updatetype'
+    tag "f\215ch", :byte, 'dmap.haschildcontainers'
+    tag 'msas', :byte, 'dmap.authenticationschemes'
+    tag 'cavs', :bool, 'dacp.visualizer'
+    tag 'cafs', :bool, 'dacp.fullscreen'
+    tag 'ceGS', :bool, 'com.apple.itunes.genius-selectable'
+    tag 'mslr', :bool, 'dmap.loginrequired'
+    tag 'msal', :bool, 'dmap.supportsautologout'
+    tag 'msup', :bool, 'dmap.supportsupdate'
+    tag 'mspi', :bool, 'dmap.supportspersistenids'
+    tag 'msex', :bool, 'dmap.supportsextensions'
+    tag 'msbr', :bool, 'dmap.supportsbrowse'
+    tag 'msqy', :bool, 'dmap.supportsquery'
+    tag 'msix', :bool, 'dmap.supportsindex'
+    tag 'msrs', :bool, 'dmap.supportsresolve'
+    tag 'asco', :bool, 'daap.songcompliation'
+    tag 'asdb', :bool, 'daap.songdisabled'
+    tag 'abpl', :bool, 'daap.baseplaylist'
+    tag 'aeSP', :bool, 'com.apple.itunes.smart-playlist'
+    tag 'aePP', :bool, 'com.apple.itunes.is-podcast-playlist'
+    tag 'aePS', :bool, 'com.apple.itunes.special-playlist'
+    tag 'aeSG', :bool, 'com.apple.itunes.saved-genius'
+    tag 'aeFP', :bool, 'com.apple.itunes.req-fplay'
+    tag 'aeHV', :bool, 'com.apple.itunes.has-video'
+    tag 'caia', :bool, 'dacp.isavailiable'
+    tag 'caip', :bool, 'dacp.isplaying'
+    tag 'ceVO', :bool, 'com.apple.itunes.voting-enabled'
+    tag 'aeSV', :version, 'com.apple.itunes.music-sharing-version'
+    tag 'mpro', :version, 'dmap.protocolversion'
+    tag 'apro', :version, 'daap.protocolversion'
+    tag 'musr', :version, 'dmap.serverrevision'
+    tag 'mstc', :date, 'dmap.utc-time'
+    tag 'asda', :date, 'daap.songdateadded'
+    tag 'asdm', :date, 'daap.songdatemodified'
+    tag 'ceJC', :bool, 'com.apple.itunes.jukebox-client-vote'
+    tag 'ceJI', :bool, 'com.apple.itunes.jukebox-current'
+    tag 'ceJS', :uint16, 'com.apple.itunes.jukebox-score'
+    tag 'ceJV', :bool, 'com.apple.itunes.jukebox-vote'
+    tag 'ceQR', :container, 'com.apple.itunes.playqueue-contents-response'
+    tag 'ceQS', :container, 'com.apple.itunes.playqueue-contents-???'
+    tag 'ceQs', :uint64, 'com.apple.itunes.playqueue-id'
+    tag 'ceQa', :string, 'com.apple.itunes.playqueue-album'
+    tag 'ceQg', :string, 'com.apple.itunes.playqueue-genre'
+    tag 'ceQn', :string, 'com.apple.itunes.playqueue-name'
+    tag 'ceQr', :string, 'com.apple.itunes.playqueue-artist'
+    tag 'ceQk', :string, 'com.apple.itunes.playqueue-key'
+    tag 'ceQl', :string, 'com.apple.itunes.playqueue-label'
+    tag 'msml', :container, 'msml'
+    tag 'aeGs', :bool, 'com.apple.itunes.can-be-genius-seed'
+    tag 'aprm', :short, 'daap.playlistrepeatmode'
+    tag 'apsm', :short, 'daap.playlistshufflemode'
+    tag 'cmpr', :version, 'dmcp.protocolversion'
+    tag 'capr', :version, 'dacp.protocolversion'
+    tag 'ppro', :version, 'unknown.version'
+    tag 'aeXD', :string, 'com.apple.itunes.xid'
+  end
+  # rubocop:enable ClassLength
+end

data/lib/dmapparser/version.rb

@@ -0,0 +1,4 @@
+# DMAPParser handles the parsing of DMAP data
+module DMAPParser
+  VERSION = '0.0.1'
+end

data/test/.rubocop.yml

@@ -0,0 +1,3 @@
+# Do not introduce global variables.
+GlobalVars:
+  Enabled: false

data/test/lib/dmapparser/builder_test.rb

@@ -0,0 +1,70 @@
+require_relative '../../test_helper'
+
+describe DMAPParser::Builder do
+  before do
+    @pair_data = DMAPParser::Builder.cmpa do
+      cmpg 'AABBCCDDEE'
+      cmnm 'Name'
+      cmty 'iPod'
+    end
+  end
+
+  it 'should return a valid string' do
+    dmap = @pair_data.to_dmap
+    dmap.must_be_instance_of String
+    DMAPParser::Parser.parse(dmap).to_dmap.must_equal(dmap)
+  end
+
+  it 'should raise an exception if tags are put inside non-containers' do
+    lambda do
+      DMAPParser::Builder.cmnm do
+        cmpg 'AABBCCDDEE'
+        cmty 'iPod'
+      end
+    end.must_raise RuntimeError
+  end
+
+  it 'should return a TagContainer' do
+    @pair_data.must_be_instance_of DMAPParser::TagContainer
+  end
+
+  it 'should store the correct values' do
+    @pair_data.cmpg.must_equal 'AABBCCDDEE'
+    @pair_data.cmnm.must_equal 'Name'
+    @pair_data.cmty.must_equal 'iPod'
+  end
+
+  it 'should store the correct Tags' do
+    @pair_data.get_tag(:cmpg).must_be_instance_of DMAPParser::Tag
+    @pair_data.get_tag(:cmnm).must_be_instance_of DMAPParser::Tag
+    @pair_data.get_tag(:cmty).must_be_instance_of DMAPParser::Tag
+  end
+
+  it 'should fail if there is no container' do
+    -> { DMAPParser::Builder.cmnm }.must_raise RuntimeError
+  end
+
+  it 'should support deep nesting' do
+    nested = DMAPParser::Builder.mcon do
+      miid 0
+      mcon do
+        miid 1
+        mcon do
+          miid 2
+          mcon do
+            miid 3
+          end
+        end
+      end
+    end
+
+    nested.must_be_instance_of DMAPParser::TagContainer
+    mcon = nested
+    3.times do |i|
+      mcon.miid.must_equal i
+      mcon = mcon.mcon
+    end
+    dmap = nested.to_dmap
+    DMAPParser::Parser.parse(dmap).to_dmap.must_equal(dmap)
+  end
+end

data/test/lib/dmapparser/parser_test.rb

@@ -0,0 +1,61 @@
+require_relative '../../test_helper'
+
+describe DMAPParser::Parser do
+  it 'should raise a ParserError when given invalid data' do
+    invalid = []
+    invalid << (0..255).map { |c| c.chr }.join # random data
+    invalid << "rand\x00\x00\x00\x01" # non correct size
+    invalid << "msup\x00\x00\x00\x01\x01" # not a container!
+    invalid << "rand\x00\x00\x00\x01\x01" # not a container!
+    invalid.each do |data|
+      lambda do
+        DMAPParser::Parser.parse(data)
+      end.must_raise(DMAPParser::Parser::ParseError)
+    end
+  end
+
+  it 'should return nil if the string is empty' do
+    DMAPParser::Parser.parse('').must_equal nil
+  end
+
+  it 'should ignore padding' do
+    dmap = support_file('simple.dmap').read
+    padded = DMAPParser::Parser.parse(dmap + 'I AM PADDING!!11!!')
+    padded.to_dmap.must_equal dmap
+  end
+
+  it 'should parse an empty container' do
+    data = "mcon\x00\x00\x00\x00"
+    mcon = DMAPParser::Parser.parse(data)
+    mcon.must_be_instance_of DMAPParser::TagContainer
+    mcon.to_a.must_be_empty
+  end
+
+  it 'should accept IO objects' do
+    data = DMAPParser::Parser.parse(support_file('simple.dmap'))
+    data.mstt.must_equal 200
+  end
+
+  it 'should parse iTunes content-types' do
+    data = DMAPParser::Parser.parse(support_file('content_codes.dmap'))
+    data.type.tag.must_equal 'mccr'
+    data.mstt.must_equal 200
+    data.to_a.count.must_equal 184
+  end
+
+  it 'should parse unknown tags' do
+    data = "mcon\x00\x00\x00\x15xkcd\x00\x00\x00\x0dis a webcomic"
+    data = DMAPParser::Parser.parse(data)
+    data.xkcd?.must_equal true
+  end
+
+  it 'should guess the type of unknown tags' do
+    data = "mcon\x00\x00\x00\x15xkcd\x00\x00\x00\x0Dis a webcomic"
+    data = DMAPParser::Parser.parse(data)
+    data.xkcd.must_equal 'is a webcomic'
+    data = "mcon\x00\x00\x00\x0Ajurp\x00\x00\x00\x02\x13\x37"
+    data = DMAPParser::Parser.parse(data)
+    data.jurp.must_equal 0x1337
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,23 @@
+require 'simplecov'
+require 'coveralls'
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start do
+  # add_filter '/test/'
+end
+gem 'minitest'
+require 'minitest/autorun'
+require 'minitest/hell'
+require 'minitest/pride'
+
+$TEST_DIR = __dir__
+$ROOT_DIR = File.expand_path('..', $TEST_DIR)
+$SUPPORT_DIR = File.join(__dir__, 'support/')
+$LOAD_PATH.unshift File.join($ROOT_DIR, 'lib/')
+
+require File.expand_path('../lib/dmapparser.rb', __dir__)
+def support_file(name)
+  open(File.join($SUPPORT_DIR, name))
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: dmapparser
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jurriaan Pruis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- email@jurriaanpruis.nl
+executables:
+- dmapparser
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/dmapparser
+- dmapparser.gemspec
+- lib/dmapparser.rb
+- lib/dmapparser/builder.rb
+- lib/dmapparser/converter.rb
+- lib/dmapparser/parser.rb
+- lib/dmapparser/tag.rb
+- lib/dmapparser/tag_container.rb
+- lib/dmapparser/tag_definition.rb
+- lib/dmapparser/tag_definitions.rb
+- lib/dmapparser/version.rb
+- test/.rubocop.yml
+- test/lib/dmapparser/builder_test.rb
+- test/lib/dmapparser/parser_test.rb
+- test/lib/dmapparser/tag_container_test.rb
+- test/lib/dmapparser/tag_test.rb
+- test/support/content_codes.dmap
+- test/support/simple.dmap
+- test/test_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: Parses DMAP data
+test_files:
+- test/.rubocop.yml
+- test/lib/dmapparser/builder_test.rb
+- test/lib/dmapparser/parser_test.rb
+- test/lib/dmapparser/tag_container_test.rb
+- test/lib/dmapparser/tag_test.rb
+- test/support/content_codes.dmap
+- test/support/simple.dmap
+- test/test_helper.rb
+has_rdoc: