elftools 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37252d63c99fd7133d5abc0fc0e8c8685d3197840eaad1ddee1ba83b36e5dee7
-  data.tar.gz: 7c092256e8b730ba2e58d8dc6f5000024cf88ee8229f71727c5194a358d07bf8
+  metadata.gz: 604d1720fabed07c8bb37185d09e89ec8962d3a34ad85ec58ffe42a29e02857a
+  data.tar.gz: 5912030d8207a6f46ae3cd3c91e0b6a60b7a2d75f57e79bfd46dc01dfdb3c9d3
 SHA512:
-  metadata.gz: 03ca86ad044a3ed27c1b635f1ad4170a5906f8f3b41b5162934b16784475a3ce3b731b9734665b72803cb293f6eeb8e90cfc703a5b77adebc0b625842d7b3a95
-  data.tar.gz: 44a0470006720e81dfc7096b9cbb076120100db888603cd7107091372b3277d2a0f806089812505d86a0f58f44148e477906289cc49689d21d0ec57950ffee1e
+  metadata.gz: 01466eb4691e615a65a2efda8914e4c7a4ac17f71b2c437e14b088e4962885fd091e0be981ae81deabdf7aa2425b6e9fff8c0e74434aa09fd489a722d7a81c39
+  data.tar.gz: a551049dedca9a3f69cbd1da213b193c8e1f616bf665113d55832b27543bb3e8b02d0f5e9b87ebf64f50d64fb70c15731f8e504e82cc97fb9d6b1251b2cc8d71

data/lib/elftools.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/constants'
 require 'elftools/elf_file'
 require 'elftools/version'

data/lib/elftools/constants.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module ELFTools
   # Define constants from elf.h.
   # Mostly refer from https://github.com/torvalds/linux/blob/master/include/uapi/linux/elf.h
   # and binutils/elfcpp/elfcpp.h.
   module Constants
     # ELF magic header
-    ELFMAG = "\x7FELF".freeze
+    ELFMAG = "\x7FELF"
 
     # Values of `d_un.d_val' in the DT_FLAGS and DT_FLAGS_1 entry.
     module DF

data/lib/elftools/dynamic.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ELFTools
   # Define common methods for dynamic sections and dynamic segments.
   #
@@ -89,7 +91,7 @@ module ELFTools
     # @param [Integer] n The index.
     # @return [ELFTools::Dynamic::Tag] The desired tag.
     def tag_at(n)
-      return if n < 0
+      return if n.negative?
 
       @tag_at_map ||= {}
       return @tag_at_map[n] if @tag_at_map[n]

data/lib/elftools/elf_file.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/constants'
 require 'elftools/exceptions'
 require 'elftools/lazy_array'

data/lib/elftools/exceptions.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ELFTools
   # Being raised when parsing error.
   class ELFError < StandardError; end

data/lib/elftools/lazy_array.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ELFTools
   # A helper class for {ELFTools} easy to implement
   # 'lazy loading' objects.
@@ -37,7 +39,7 @@ module ELFTools
     #   return type of block given in {#initialize}.
     def [](i)
       # XXX: support negative index?
-      return nil if i < 0 || i >= @internal.size
+      return nil unless i.between?(0, @internal.size - 1)
 
       @internal[i] ||= @block.call(i)
     end

data/lib/elftools/note.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/structs'
 require 'elftools/util'
 
@@ -101,7 +103,7 @@ module ELFTools
       # Name of this note.
       # @return [String] The name.
       def name
-        return @name if @name
+        return @name if defined?(@name)
 
         stream.pos = @offset + SIZE_OF_NHDR
         @name = stream.read(header.n_namesz)[0..-2]

data/lib/elftools/sections/dynamic_section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/dynamic'
 require 'elftools/sections/section'
 

data/lib/elftools/sections/note_section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/note'
 require 'elftools/sections/section'
 

data/lib/elftools/sections/null_section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/sections/section'
 
 module ELFTools

data/lib/elftools/sections/relocation_section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/constants'
 require 'elftools/sections/section'
 require 'elftools/structs'

data/lib/elftools/sections/section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/constants'
 module ELFTools
   module Sections

data/lib/elftools/sections/sections.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Require this file to load all sections classes.
 
 require 'elftools/sections/section'
@@ -19,7 +21,7 @@ module ELFTools
       # @param [#pos=, #read] stream Streaming object.
       # @return [ELFTools::Sections::Section]
       #   Return object dependes on +header.sh_type+.
-      def create(header, stream, *args)
+      def create(header, stream, *args, **kwargs)
         klass = case header.sh_type
                 when Constants::SHT_DYNAMIC then DynamicSection
                 when Constants::SHT_NULL then NullSection
@@ -29,7 +31,7 @@ module ELFTools
                 when Constants::SHT_SYMTAB, Constants::SHT_DYNSYM then SymTabSection
                 else Section
                 end
-        klass.new(header, stream, *args)
+        klass.new(header, stream, *args, **kwargs)
       end
     end
   end

data/lib/elftools/sections/str_tab_section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/sections/section'
 require 'elftools/util'
 

data/lib/elftools/sections/sym_tab_section.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/sections/section'
 
 module ELFTools

data/lib/elftools/segments/dynamic_segment.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/segments/segment'
 require 'elftools/dynamic'
 

data/lib/elftools/segments/interp_segment.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/segments/segment'
 
 module ELFTools

data/lib/elftools/segments/load_segment.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/segments/segment'
 
 module ELFTools

data/lib/elftools/segments/note_segment.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'elftools/note'
 require 'elftools/segments/segment'
 

data/lib/elftools/segments/segment.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ELFTools
   module Segments
     # Base class of segments.

data/lib/elftools/segments/segments.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Require this file to load all segment classes.
 
 require 'elftools/segments/segment'
@@ -17,7 +19,7 @@ module ELFTools
       # @param [#pos=, #read] stream Streaming object.
       # @return [ELFTools::Segments::Segment]
       #   Return object dependes on +header.p_type+.
-      def create(header, stream, *args)
+      def create(header, stream, *args, **kwargs)
         klass = case header.p_type
                 when Constants::PT_DYNAMIC then DynamicSegment
                 when Constants::PT_INTERP then InterpSegment
@@ -25,7 +27,7 @@ module ELFTools
                 when Constants::PT_NOTE then NoteSegment
                 else Segment
                 end
-        klass.new(header, stream, *args)
+        klass.new(header, stream, *args, **kwargs)
       end
     end
   end

data/lib/elftools/structs.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 require 'bindata'
+
 module ELFTools
   # Define ELF related structures in this module.
   #
   # Structures are fetched from https://github.com/torvalds/linux/blob/master/include/uapi/linux/elf.h.
-  # Using the bindata gem to make these structures support 32/64 bits and
-  # little/big endian simultaneously.
+  # Use gem +bindata+ to have these structures support 32/64 bits and little/big endian simultaneously.
   module Structs
     # The base structure to define common methods.
     class ELFStruct < BinData::Record
@@ -23,9 +25,13 @@ module ELFTools
       end
 
       class << self
-        # Hook constructor, while +BinData::Record+ doesn't allow us to override +#initialize+,
-        # so we hack +new+ here.
-        def new(**kwargs)
+        # Hooks the constructor.
+        #
+        # +BinData::Record+ doesn't allow us to override +#initialize+, so we hack +new+ here.
+        def new(*args)
+          # XXX: The better implementation is +new(*args, **kwargs)+, but we can't do this unless bindata changed
+          # lib/bindata/dsl.rb#override_new_in_class to invoke +new+ with both +args+ and +kwargs+.
+          kwargs = args.last.is_a?(Hash) ? args.last : {}
           offset = kwargs.delete(:offset)
           super.tap do |obj|
             obj.offset = offset
@@ -42,13 +48,13 @@ module ELFTools
           end
         end
 
-        # Hacking to get endian of current class
-        # @return [Symbol, nil] +:little+ or +:big+.
+        # Gets the endianness of current class.
+        # @return [:little, :big] The endianness.
         def self_endian
           bindata_name[-2..-1] == 'be' ? :big : :little
         end
 
-        # Pack integer into string.
+        # Packs an integer to string.
         # @param [Integer] val
         # @param [Integer] bytes
         # @return [String]
@@ -110,7 +116,7 @@ module ELFTools
       choice :sh_entsize, **CHOICE_SIZE_T
     end
 
-    # Program header structure for 32bit.
+    # Program header structure for 32-bit.
     class ELF32_Phdr < ELFStruct
       endian :big_and_little
       uint32 :p_type
@@ -123,7 +129,7 @@ module ELFTools
       uint32 :p_align
     end
 
-    # Program header structure for 64bit.
+    # Program header structure for 64-bit.
     class ELF64_Phdr < ELFStruct
       endian :big_and_little
       uint32 :p_type
@@ -135,13 +141,14 @@ module ELFTools
       uint64 :p_memsz
       uint64 :p_align
     end
-    # Get program header class according to bits.
+
+    # Gets the class of program header according to bits.
     ELF_Phdr = {
       32 => ELF32_Phdr,
       64 => ELF64_Phdr
     }.freeze
 
-    # Symbol structure for 32bit.
+    # Symbol structure for 32-bit.
     class ELF32_sym < ELFStruct
       endian :big_and_little
       uint32 :st_name
@@ -152,7 +159,7 @@ module ELFTools
       uint16 :st_shndx
     end
 
-    # Symbol structure for 64bit.
+    # Symbol structure for 64-bit.
     class ELF64_sym < ELFStruct
       endian :big_and_little
       uint32 :st_name  # Symbol name, index in string tbl
@@ -162,6 +169,7 @@ module ELFTools
       uint64 :st_value # Value of the symbol
       uint64 :st_size  # Associated symbol size
     end
+
     # Get symbol header class according to bits.
     ELF_sym = {
       32 => ELF32_sym,

data/lib/elftools/util.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ELFTools
   # Define some util methods.
   module Util

data/lib/elftools/version.rb

@@ -1,4 +1,6 @@
+# frozen_string_literal: true
+
 module ELFTools
   # Current gem version
-  VERSION = '1.1.0'.freeze
+  VERSION = '1.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elftools
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - david942j
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-07 00:00:00.000000000 Z
+date: 2019-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.1'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.1'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.1
+        version: '0.17'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.1
+        version: '0.17'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -154,15 +154,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.1.0
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: ELFTools - Pure ruby library for parsing and patching ELF files