w32evol_ruby 0.0.1

data/README.rdoc

@@ -0,0 +1,75 @@
+= w32evol_wrapper -- w32evol obfuscation engine wrapped in Ruby
+
+== Table of Contents
+1. Introduction
+2. Dependencies
+3. Installation
+4. Usage
+5. Development
+
+== 1. Introduction
+<b>Does not contain a virus</b>
+
+This is a Ruby wrapper for the obfuscation engine 
+{w32evol}[https://bitbucket.org/martinvelez/w32evol].
+
+The {w32evol}[https://bitbucket.org/martinvelez/w32evol] obfuscation engine 
+has a command line interface.  This wrapper allows you to use the obfuscation 
+engine within your Ruby scripts.  
+
+== 2. Dependencies
+
+* {Ruby 1.9.2}[http://www.ruby-lang.org/en/downloads/] or greater
+* {wine}[http://www.winehq.org/download] (1.3 or greater, may work with 1.2)
+* {w32evol}[https://bitbucket.org/martinvelez/w32evol/downloads] 
+  (v0.1.0 is include in this gem's ext folder)
+
+== 3. Installation
+
+=== Rubygems:
+You might need to use sudo.
+ gem install w32evol_ruby
+
+=== Not Rubygems:
+1. Download w32evol_ruby[http://bitbucket.org/martinvelez/w32evol_ruby/downloads]
+2. Require the w32evol Ruby class file in your program (lib folder) 
+   * The w32evol.exe engine is located in this gems ext folder.
+
+== 4. Usage
+
+=== Example 1
+This example is found in the examples directory.
+ #!/usr/bin/env ruby
+
+ require 'w32evol_ruby'
+
+ ARGF.binmode
+ input = ARGF.read
+ # Assuming engine is installed in this gem's "ext" folder.
+ # Otherwise, you must pass the engine's executable path to the class's 
+ # constructor.
+ # For example:
+ # engine = W32Evol.new({:command => "/path/to/engine"})
+ engine = W32Evol.new
+
+ output, errors, status = engine.obfuscate(input)
+
+ puts "INPUT:", input.inspect
+ puts "STATUS:", status
+ puts "ERRORS: ", errors
+ puts "OUTPUT:", output.inspect
+
+
+== 5. Development
+
+Author:: {Martin Velez}[http://www.martinvelez.com]
+Copyright:: Copyright (C) 2012 {Martin Velez}[http://www.martinvelez.com]
+License:: GPL[http://www.gnu.org/copyleft/gpl.html]
+
+=== Source
+Bitbucket[https://bitbucket.org/martinvelez/w32evol_ruby/src] is hosting this code.
+ http://bitbucket.org/martinvelez/w32evol_ruby/src
+
+=== Issues and Bug Reports
+Provide feedback, get help, request features, and reports bugs here:
+ https://bitbucket.org/martinvelez/w32evol_ruby/issues?status=new?status=open

data/examples/example.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+#require 'w32evol_ruby'
+require '../lib/w32evol.rb'
+
+ARGF.binmode
+input = ARGF.read
+# Assuming engine is installed in this gem's "ext" folder.
+# Otherwise, you must pass the engine's executable path to the class's 
+# constructor.
+# For example:
+# engine = W32Evol.new({:command => "/path/to/engine"})
+engine = W32Evol.new
+
+output, errors, status = engine.obfuscate(input)
+
+puts "INPUT:", input.inspect
+puts "STATUS:", status
+puts "ERRORS: ", errors
+puts "OUTPUT:", output.inspect

data/examples/in.bin

@@ -0,0 +1 @@
+��

data/lib/w32evol.rb

@@ -0,0 +1,112 @@
+require 'tempfile'
+
+# This class wraps the w32evol obfuscation engine.
+# {w32evol}[https://github.com/martinvelez/w32evol]
+class W32Evol
+
+	# By default the engine is distributed in the ext folder of this gem.
+	# This constant allows us to find the path to the engine executable. 
+	ENGINE_ROOT 	= File.expand_path(File.join(File.dirname(__FILE__), '..'))
+	BINARY 				= true # input is in binary format
+	NOSTDIN 			= true # does not accept standard input
+	PLATFORM			= "windows" # windows program (requires wine in Linux) 
+	
+	attr_reader :options
+
+	# The user can instantiate this class by passing in a Hash of options
+	# 
+	# Default options:
+	#
+	# By default the engine is distributed with this gem in the "ext" folder
+	#  :command => File.join(ENGINE_ROOT,"ext","bin","w32evol.exe")
+	#	
+	def initialize(options = {})
+		@name = self.class.to_s.downcase
+		@options = default_options.merge(options)
+		@command_options = generate_command_options
+	end
+	
+	# this method obfuscates code and provides the obfuscated code, errors 
+	# produced by the engine, and the engine's exit status
+	#  Binary String or filename: input
+	#  Binary String: output
+	#	 String: errors
+	#  Integer: exitstatus
+	#  obfuscate(input) => output, errors, exitstatus
+	def obfuscate(input)
+		output, errors, exitstatus = "", "", 0
+	
+		# if input string contains the \xnn escape sequence, 
+		# then we can assume that it is code
+		# For example, let input = "\x83\xC0\x0A"
+		# Then input.inspect => "\"\\x83\"".
+		# Thus, input.inspect =~ /\\x../ => 1
+		if (input.inspect =~ /\\x.*/) >= 0
+			infile = Tempfile.open(["#{@name}_in",'.bin']) do |f| 
+				f.binmode
+				f.syswrite input
+				f.path
+			end 
+		else
+			raise("#{input}: File does not exists or is not readable") \
+				unless File.exist?(input) and File.readable?(input)
+		end
+	
+		outfile = Tempfile.open(["#{@name}_out",'.bin']) {|f| f.path }	
+		return obfuscate_inner(infile, outfile)		
+	end
+
+	private
+		# This method defines the default options in a Hash
+		# 
+		# By default, the engine is expected to be in the "ext" folder.
+		# 
+		def default_options
+			{
+				# By default the engine is in the ext folder of this gem
+				# This assumes that the wine command in in your PATH
+				:command => File.join(ENGINE_ROOT,"ext","#{@name}.exe")
+			}
+		end
+
+		# This method converts the options Hash into a string of flags for the 
+		# command line call.
+		#
+		# Example output:
+		#  "--x cpp --x iso --x motif --x posix2 --x stl --x unix95 --x xpg4" 
+		def generate_command_options
+			command_options = ""
+			@options.each do |key, value|
+				if key.to_s != "command"
+					if value.kind_of?(Array)
+						value.each{|val| command_options += "#{key} #{val} "}
+					elsif
+						command_options += "#{key} #{value} "
+					end		
+				end
+			end
+			command_options.rstrip
+		end
+
+		# This method obfuscate the code in infile and stores in outfile
+		#
+		# It is used for engines with a command line interface which requires an input 
+		# file name, and an output file name.
+		def obfuscate_inner(infile, outfile)
+			# This engine does not output to stderr, it only returns an exit code if it
+			# fails.	
+			output, errors, exitstatus = "", "", 0
+			cmd = "#{@options[:command]} #{infile} #{outfile}"
+			cmd.insert(0, "wine ") if (PLATFORM == 'windows' and RUBY_PLATFORM =~ /linux/)
+			system(cmd) 
+			exitstatus = $?.exitstatus		
+			if exitstatus == 0 # if engine success
+				f = File.new(outfile)
+				output = f.sysread(f.size)
+				f.close
+			end	
+			return output, errors, exitstatus	
+		end
+
+end
+

data/test/test_w32evol.rb

@@ -0,0 +1,18 @@
+require 'minitest/autorun'
+require 'w32evol'
+
+class TestW32Evol < MiniTest::Unit::TestCase
+	
+	def setup
+		@engine = W32Evol.new
+		@input = "\x83\xC0\x0A" 
+	end
+
+	def test_obfuscate
+		output, errors, status = @engine.obfuscate(@input)
+		assert_equal "\x81\xC0\x0A\x00\x00\x00", output
+		assert_equal "", errors
+		assert_equal 0, status
+	end
+end
+

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+name: w32evol_ruby
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Martin Velez
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-01-31 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Provides a Ruby wrapper for the w32evol obfuscation engine
+email: mvelez999@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/w32evol.rb
+- ext/w32evol.exe
+- examples/in.bin
+- examples/example.rb
+- test/test_w32evol.rb
+- README.rdoc
+has_rdoc: true
+homepage: http://bitbucket.org/martinvelez/w32evol
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper for the w32evol obfuscation engine
+test_files: []
+