bin_tools 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: afa83c1999ac186ee2e917d137c27a3926cf69bf
+  data.tar.gz: 4b59fc2d1afd8f42ff96b9a2814ca0ef04fb866a
+SHA512:
+  metadata.gz: 59df6d09f30b27b08e64828e16e8d2ce1e53c45483eb010b1b8c69630c3fc184d26a9ebabcae1133a0a502a8b5e1ed14f436985980daa8dfd0ad1277fdbe2a6f
+  data.tar.gz: fbf60d1eb431b742a537d6c49b8d0fca83b01911b69e028596e0cb1a883aa9edfd1dda44b364989770bff906c958804cf95bee296d4b7ef84998ca67cf1b8d4d

data/lib/bin_tools.rb

@@ -0,0 +1,3 @@
+module BinTools; end
+require 'bin_tools/reader'
+require 'bin_tools/writer'

data/lib/bin_tools/reader.rb

@@ -0,0 +1,151 @@
+# General purpose binary reader
+
+# 8 16 32 64
+# C S L Q - unsigned
+# c s l q - unsigned
+# < LE
+# > BE
+# A - binary string
+# z - null terminated
+# H - hex string
+
+class BinTools::Reader
+  def initialize str
+    @rom = str
+    @cur = 0
+    @base = 0
+  end
+
+  def self.from_file fn
+    data = File.open(fn, "rb") { |io| io.read }
+    self.new data
+  end
+
+  def set_base pos
+    @base = pos
+  end
+
+  def seek pos
+    @cur = pos + @base
+  end
+
+  def seek_rel pos
+    @cur += pos
+  end
+
+  def tell
+    @cur - @base
+  end
+
+  def read_str len
+    r = @rom[@cur..(@cur + len - 1)].unpack("A#{len}").first
+    @cur += len
+    r
+  end
+
+  def read_str_varlen
+    len = read_varlen_le
+    r = @rom[@cur..(@cur + len - 1)].unpack("A#{len}").first
+    @cur += len
+    r
+  end
+
+  def read_byte
+    r = @rom[@cur].ord
+    @cur += 1
+    r
+  end
+
+  def read_bool
+    read_byte == 1
+  end
+
+  def read_s8
+    r = @rom[@cur].unpack("c").first
+    @cur += 1
+    r
+  end
+
+  def read_u16_le
+    r = @rom[@cur..(@cur + 3)].unpack('S<').first
+    @cur += 2
+    r
+  end
+
+  def read_s16_le
+    r = @rom[@cur..(@cur + 3)].unpack('s<').first
+    @cur += 2
+    r
+  end
+
+  def read_u16_be
+    r = @rom[@cur..(@cur + 3)].unpack('S>').first
+    @cur += 2
+    r
+  end
+
+  def read_u32_le
+    r = @rom[@cur..(@cur + 3)].unpack('L<').first
+    @cur += 4
+    r
+  end
+
+  def read_s32_le
+    r = @rom[@cur..(@cur + 3)].unpack('l<').first
+    @cur += 4
+    r
+  end
+
+  def read_u32_be
+    r = @rom[@cur..(@cur + 3)].unpack('L>').first
+    @cur += 4
+    r
+  end
+
+  def read_f32_le
+    r = @rom[@cur..(@cur + 3)].unpack('e').first
+    @cur += 4
+    r
+  end
+
+  def read_bin len
+    r = @rom[@cur..(@cur + len - 1)]
+    @cur += len
+    r
+  end
+
+  def read_binswap len
+    togo = len
+    bin_data = "".b
+    while togo > 0
+      r = @rom[@cur..(@cur + 3)].unpack('L>')
+      bin_data += r.pack('L<')
+      @cur += 4
+      togo -= 4
+    end
+    bin_data
+  end
+
+  def read_varlen_le
+    val = 0
+    r = read_byte
+    val = r & 0x7F
+    return val if r < 0x80
+    r = read_byte << 7
+    val + r
+  end
+
+  def read_varlen_be
+    val = 0
+    r = read_byte
+    val = r & 0x7F
+    return val if r < 0x80
+    r = read_byte
+    val = (val << 8) + r
+    val
+  end
+
+  def msg str
+    puts "%08X(%08X): %s" % [@cur, tell, str]
+  end
+end

data/lib/bin_tools/writer.rb

@@ -0,0 +1,123 @@
+# 8 16 32 64
+# C S L Q - unsigned
+# c s l q - unsigned
+# < LE
+# > BE
+# A - binary string
+# z - null terminated
+# H - hex string
+
+
+class BinTools::Writer
+  def initialize fn
+    @f = File.new fn, "wb"
+  end
+
+  def self.open fn, &block
+    f = self.new fn
+    block.call f
+    f.close
+  end
+
+  def seek pos
+    @f.seek pos
+  end
+
+  def tell
+    @f.tell
+  end
+
+  def write_str str
+    @f.write str
+  end
+
+  def write_str_varlen str
+    write_varlen_le str.size
+    @f.write str
+  end
+
+  def write_byte val
+    @f.write [val].pack("C")
+  end
+
+  def write_bool val
+    write_byte val ? 1 : 0
+  end
+
+  def write_u16_le val
+    @f.write [val].pack("S<")
+  end
+
+  def write_s16_le val
+    @f.write [val].pack("s<")
+  end
+
+  def write_u16_be val
+    @f.write [val].pack("S>")
+  end
+
+  def write_u32_le val
+    @f.write [val].pack("L<")
+  end
+
+  def write_s32_le val
+    @f.write [val].pack("l<")
+  end
+
+  def write_u32_be val
+    @f.write [val].pack("L>")
+  end
+
+  def write_f32_le val
+    @f.write [val].pack("e")
+  end
+
+  def write_u24_be val
+    write_byte val >> 16
+    write_u16_be val & 0xFFFF
+  end
+
+  def write_bin str
+    @f.write str
+  end
+
+  def write_varlen_be val
+    out = [val & 0x7F]
+    val = val >> 7
+    while val > 0
+        out << (val & 0x7f) + 0x80
+        val = val >> 7
+    end
+    out.reverse.each do |x|
+      write_byte x
+    end
+  end
+
+  def write_varlen_le val
+    out = [val & 0x7F]
+    val = val >> 7
+    while val > 0
+        out << (val & 0x7f)
+        val = val >> 7
+    end
+    out.each_with_index do |x, i|
+      write_byte(x + ((i == out.size - 1) ? 0 : 0x80))
+    end
+  end
+
+  def write_binswap str
+    togo = str.size
+    pos = 0
+    while togo > 0
+      r = @rom[pos..(pos+3)].unpack('L>')
+      d = r.pack('L<')
+      write_bin d
+      pos += 4
+      togo -= 4
+    end
+  end
+
+  def close
+    @f.close
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: bin_tools
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Madeline Lim
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-05-23 00:00:00.000000000 Z
+dependencies: []
+description: Binary I/O library for Ruby that is similar to using the C# Binary Reader
+  and Writer.
+email: deltabouche@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bin_tools.rb
+- lib/bin_tools/reader.rb
+- lib/bin_tools/writer.rb
+homepage: https://github.com/deltabouche/bin_tools
+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.6.14
+signing_key: 
+specification_version: 4
+summary: Binary I/O library for Ruby
+test_files: []