iostruct 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b5299fc722f0b62051802a5ec32ac37de25c48b92a5899a77da7494aa6dfa73
-  data.tar.gz: dd50d4aa68a79fded59a6720867bea0b4961ca7513d79cf124bda6ad9d5e40fc
+  metadata.gz: 4a17b782202e0503788fd3b16dffdebddecd62becb30c52ba28161ebde1e300d
+  data.tar.gz: d42484281a468a378902d4589b67201ad4f134660559766690e48849b9f2a46c
 SHA512:
-  metadata.gz: b3434b61ba2cac8b9465a91da45d7dd5ee5aadd5eeaba77c3d115a564b7dbb31ecdb37e579bd3b41132af5eff42ad687c12ebf4d69da5a4015e23fa317e5b133
-  data.tar.gz: 852776b5bbaacf3ac4107a9755879ca986841e7d415bc16310e7ee6f565b6335b58c2d0730fd5de20ecde7843abe64c30c898855bb48e918e8bd7f83b527b5a0
+  metadata.gz: db34080f66b2815628e20a6e7b9331089d55a011dd35ae90b9e8f7758cb97332fad7b9caadfcc977a93e104cb0d9b9e3c932e82a2070e54205ba3bb7a52337d4
+  data.tar.gz: d25f3804da77a52630bb4492548c3ab71124c06610558dde277ea2c769a826ce8a720a5df99b2ab3691791b090f6ec4774b65e8072117383ab389e4095451a0f

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+# 0.3.0
+
+ - added `__offset` field:
+    
+    ```ruby
+    X = IOStruct.new('LL')
+    io = StringIO.new('x'*1000)
+
+    X.read(io).__offset     # 0
+    X.read(io).__offset     # 8
+    X.read(io).__offset     # 16
+
+    X.read('abcd').__offset # nil
+    ```

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    iostruct (0.1.0)
+    iostruct (0.3.0)
 
 GEM
   remote: https://rubygems.org/

data/lib/iostruct/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IOStruct
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/iostruct.rb

@@ -94,9 +94,11 @@ module IOStruct
   module ClassMethods
     # src can be IO or String, or anything that responds to :read or :unpack
     def read src, size = nil
+      pos = nil
       size ||= const_get 'SIZE'
       data =
         if src.respond_to?(:read)
+          pos = src.tell
           src.read(size).to_s
         elsif src.respond_to?(:unpack)
           src
@@ -106,11 +108,13 @@ module IOStruct
 #      if data.size < size
 #        $stderr.puts "[!] #{self.to_s} want #{size} bytes, got #{data.size}"
 #      end
-      new(*data.unpack(const_get('FORMAT')))
+      new(*data.unpack(const_get('FORMAT'))).tap{ |x| x.__offset = pos }
     end
   end # ClassMethods
 
   module InstanceMethods
+    attr_accessor :__offset
+
     def pack
       to_a.pack self.class.const_get('FORMAT')
     end

data/spec/iostruct_spec.rb

@@ -96,4 +96,27 @@ describe IOStruct do
   it "throws exception on unknown format" do
     expect { IOStruct.new('K', :x) }.to raise_error('Unknown field type "K"')
   end
+
+  context '__offset field' do
+    let(:data) { 0x100.times.to_a.pack('L*') }
+    let(:io) { StringIO.new(data) }
+    let(:struct) { IOStruct.new('LLLL', :a, :b, :c, :d) }
+
+    context 'when src is an IO' do
+      it 'is set to the current IO position' do
+        a = []
+        while !io.eof?
+          a << struct.read(io)
+        end
+        expect(a.map(&:__offset)).to eq (0...0x400).step(0x10).to_a
+      end
+    end
+
+    context 'when src is a string' do
+      it 'is nil' do
+        x = struct.read(data)
+        expect(x.__offset).to be_nil
+      end
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: iostruct
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andrey "Zed" Zaikin
@@ -60,6 +60,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -89,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A Struct that can read/write itself from/to IO-like objects