emonti-hexwrench 0.2.0

data/History.txt

@@ -0,0 +1,7 @@
+== 0.2.0 / 2009-06-17
+* release version
+
+== 0.1.0 / 2009-03-20
+
+* enhancements
+  * Started using bones to help manage this mess. History.txt is born!

data/README.rdoc

@@ -0,0 +1,69 @@
+
+= hexwrench
+
+* http://www.github.com/emonti/hexwrench
+
+== DESCRIPTION:
+
+Hexwrench is a gui-based hex editor written in ruby based using wxruby.
+
+
+== REQUIREMENTS:
+
+* wxruby >= 0.2.0
+* optional: wxirb (http://www.github.com/emonti/wxirb)
+
+
+== INSTALL:
+
+=== Gem Installation
+
+    gem sources -a http://gems.github.com #(you only have to do this once)
+    gem install emonti-hexwrench
+
+=== Manual installation:
+
+You can access the latest hexwrench branches at github with git:
+
+  git clone git://github.com/emonti/hexwrench.git
+
+To generate the gem locally do:
+
+  cd hexwrench
+  rake gem:install
+
+or ... you can install manually without rubygems.
+
+  cd hexwrench
+  cp -r hexwrench/lib/* /usr/lib/ruby/1.8/site_ruby/1.8 # or another ruby libdir
+  cp bin/* ~/bin      # or wherever else in your PATH
+
+Run this to generate docs with rdoc the same way the gem would have:
+
+  rdoc --main README.rdoc README.rdoc lib
+
+== LICENSE:
+
+(The MIT License) 
+
+Copyright (c) 2009 Eric Monti, Matasano Security
+
+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/Rakefile

@@ -0,0 +1,42 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  begin
+    load 'tasks/setup.rb'
+  rescue LoadError
+    raise RuntimeError, '### please install the "bones" gem ###'
+  end
+end
+
+ensure_in_path 'lib'
+require 'hexwrench'
+
+task :default => 'test:run'
+
+PROJ.name = 'hexwrench'
+PROJ.authors = 'Eric Monti'
+PROJ.email = 'emonti@matasano.com'
+PROJ.description = 'A wxwidgets-based hex editor written in ruby'
+PROJ.url = 'http://emonti.github.com/hexwrench'
+PROJ.version = Hexwrench::VERSION
+PROJ.rubyforge.name = 'hexwrench'
+PROJ.readme_file = 'README.rdoc'
+
+PROJ.spec.opts << '--color'
+
+PROJ.rdoc.opts << '--line-numbers'
+
+#PROJ.rdoc.opts << '--diagram'
+PROJ.notes.tags << "X"+"XX" # muhah! so we don't note our-self
+
+# exclude rcov.rb from rcov report
+PROJ.rcov.opts += ["--exclude",  "rcov.rb", "--exclude", "eventmachine"]
+
+depend_on 'wxruby', '>= 2.0.0'
+
+# EOF

data/bin/hexwrench

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+#
+
+begin
+  require 'rubygems'
+rescue LoadError
+end
+require 'wx'
+require 'hexwrench'
+
+
+Wx::App.run do
+  Hexwrench::EditorFrame.new( nil, :filename => ARGV[0]).show
+end

data/hexwrench.gemspec

@@ -0,0 +1,38 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{hexwrench}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Eric Monti"]
+  s.date = %q{2009-06-17}
+  s.default_executable = %q{hexwrench}
+  s.description = %q{A wxwidgets-based hex editor written in ruby}
+  s.email = %q{emonti@matasano.com}
+  s.executables = ["hexwrench"]
+  s.extra_rdoc_files = ["History.txt", "README.rdoc", "bin/hexwrench", "lib/hexwrench/build_xrc.sh", "lib/hexwrench/ui/gui.xrc"]
+  s.files = ["History.txt", "README.rdoc", "Rakefile", "bin/hexwrench", "hexwrench.gemspec", "lib/hexwrench.rb", "lib/hexwrench/build_xrc.sh", "lib/hexwrench/data_inspector.rb", "lib/hexwrench/edit_frame.rb", "lib/hexwrench/edit_window.rb", "lib/hexwrench/gui.rb", "lib/hexwrench/stringsgrid.rb", "lib/hexwrench/stringslist.rb", "lib/hexwrench/stringsvlist.rb", "lib/hexwrench/ui/gui.xrc", "samples/ascii_heat_map.rb", "tasks/ann.rake", "tasks/bones.rake", "tasks/gem.rake", "tasks/git.rake", "tasks/notes.rake", "tasks/post_load.rake", "tasks/rdoc.rake", "tasks/rubyforge.rake", "tasks/setup.rb", "tasks/spec.rake", "tasks/svn.rake", "tasks/test.rake"]
+  s.homepage = %q{http://emonti.github.com/hexwrench}
+  s.rdoc_options = ["--line-numbers", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{hexwrench}
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{A wxwidgets-based hex editor written in ruby}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<wxruby>, [">= 2.0.0"])
+      s.add_development_dependency(%q<bones>, [">= 2.5.1"])
+    else
+      s.add_dependency(%q<wxruby>, [">= 2.0.0"])
+      s.add_dependency(%q<bones>, [">= 2.5.1"])
+    end
+  else
+    s.add_dependency(%q<wxruby>, [">= 2.0.0"])
+    s.add_dependency(%q<bones>, [">= 2.5.1"])
+  end
+end

data/lib/hexwrench/build_xrc.sh

@@ -0,0 +1 @@
+xrcise -o gui.rb -n Hexwrench ui/gui.xrc

data/lib/hexwrench/data_inspector.rb

@@ -0,0 +1,138 @@
+require 'rbkb/extends'
+
+module Hexwrench
+  DEFAULT_DATA_INSPECTORS = [
+    { :label => "8 bit", 
+      :enabled => true,
+      :proc => lambda {|buf, idx, parent| buf[idx].to_s} },
+
+    { :label => "16 bit", 
+      :enabled => true,
+      :proc => lambda do |buf, idx, parent| 
+        if d=buf[idx,2] and d.size == 2
+          d.dat_to_num(parent.endianness)
+        end
+      end 
+    }, 
+
+    { :label => "32 bit", 
+      :enabled => true,
+      :proc => lambda do |buf, idx, parent| 
+        if d=buf[idx,4] and d.size == 4
+          d.dat_to_num(parent.endianness)
+        end
+      end
+    },
+
+    { :label => "64 bit",
+      :enabled => true,
+      :proc => lambda do |buf, idx, parent|
+        if d=buf[idx,8] and d.size == 8
+          d.dat_to_num(parent.endianness)
+        end
+      end
+    },
+
+    { :label => "128 bit",
+      :enabled => false,
+      :proc => lambda do |buf, idx, parent|
+        if d=buf[idx,16] and d.size == 16
+          d.dat_to_num(parent.endianness)
+        end
+      end
+    },
+
+    { :label => "IPv4",
+      :enabled => true,
+      :proc => lambda do |buf, idx, parent|
+        if d=buf[idx,4] and d.size == 4
+          "#{d[0]}.#{d[1]}.#{d[2]}.#{d[3]}"
+        end
+      end
+    }
+  ]
+
+  DATA_INS_BYTE_ORDER={:big => 0, :little => 1}
+
+  class DataInspector < Wx::Frame
+    attr_accessor :endian, :inspectors, :font
+
+    def initialize(parent, opts={})
+      unless @editor=opts[:editor]
+        raise "#{self.class}.new() requires an :editor parameter" 
+      end
+
+      super(parent, :title => "Data Inspector")
+      @inspectors =(opts[:inspectors] || DEFAULT_DATA_INSPECTORS)
+      @endian =(opts[:endian]|| :big)
+      @font = (opts[:font] || Wx::Font.new(10, Wx::MODERN, Wx::NORMAL, Wx::NORMAL))
+      set_font(@font)
+
+      @order_sel = Wx::RadioBox.new(self ,
+         :choices => ["MSB", "LSB"], :label => "Byte Order")
+
+      @order_sel.selection = DATA_INS_BYTE_ORDER[@endian]
+
+      evt_radiobox(@order_sel) {|evt| do_inspectors() }
+
+      @grid = Wx::Grid.new(self)
+      make_grid()
+      
+      @main_sizer = Wx::BoxSizer.new(Wx::VERTICAL)
+      @main_sizer.add(@order_sel)
+      @main_sizer.add(@grid, Wx::EXPAND|Wx::ALL)
+      self.sizer = @main_sizer
+    end
+    
+    def endianness
+      DATA_INS_BYTE_ORDER.invert[@order_sel.selection]
+    end
+
+    def make_grid()
+      @grid.create_grid(@inspectors.select {|x| x[:enabled]}.size, 1)
+      @grid.set_row_label_alignment(Wx::ALIGN_RIGHT, Wx::ALIGN_CENTRE)
+      @grid.set_default_cell_background_colour(Wx::LIGHT_GREY)
+      @grid.set_col_label_size(0)
+      @grid.set_col_minimal_acceptable_width(0)
+      @grid.enable_grid_lines(false)
+      @grid.disable_drag_row_size()
+      @grid.disable_drag_grid_size()
+      @grid.set_label_font(@font)
+      @grid.set_selection_mode(Wx::Grid::GridSelectRows)
+
+      @grid.begin_batch
+      idx=0
+      @inspectors.each do |inspector|
+        next unless inspector[:enabled]
+        label = inspector[:label]
+        @grid.set_row_label_value(idx, label.to_s)
+        @grid.set_read_only(idx,0) # XXX
+        idx+=1
+      end
+      @grid.end_batch
+    end
+
+    def do_inspectors
+      if @editor.selection
+        pos = 0
+        buf = @editor.data[@editor.selection]
+      else
+        pos = @editor.cur_pos
+        buf = @editor.data
+      end
+
+      @grid.begin_batch
+      idx=0
+      @inspectors.each do |inspector|
+        next unless inspector[:enabled]
+        inspector_proc = inspector[:proc]
+        val=inspector_proc.call(buf, pos, self)
+        @grid.set_cell_value(idx, 0, val.to_s)
+        idx+=1
+      end
+      @grid.auto_size_column(0, true)
+      @grid.end_batch
+    end
+
+  end
+end