bfrb 0.1.0 → 0.1.1

data/README.rdoc

@@ -1,6 +1,6 @@
 = bfrb
 
-bfrb is a simple brainfuck interpreter written in Ruby.
+bfrb is a simple {brainfuck}[http://www.muppetlabs.com/~breadbox/bf] interpreter written in Ruby.
 
 == Usage
 
@@ -8,10 +8,25 @@ To install bfrb:
 	
 	% gem install bfrb
 	
-After installation, you can use bfrb in two ways.  First, you can pass brainfuck code directly into it, as long as it is wrapped in quotes.
+Once bfrb is installed, you can use it to interpret your brainfuck code.  
+First, you can pass brainfuck code directly into it, as long as it is wrapped in quotes.
 	
 	% bfrb ",[.,]"
 	
 Or, you can specify a file with the -f parameter:
 
 	% bfrb -f test.bf
+	
+You can also start an interactive interpreter by running bfrb without any parameters
+	
+	% bfrb
+	
+== Things To Do
+
+* Compiler
+* Unit Testing
+
+== History
+
+v 0.1.1 - Added REPL.
+v 0.1.0 - Initial release.  Allows running code passed in or from a file.

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/bfrb.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{bfrb}
-  s.version = "0.1.0"
+  s.version = "0.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Chris ONeal"]
-  s.date = %q{2011-06-03}
+  s.date = %q{2011-06-06}
   s.default_executable = %q{bfrb}
   s.description = %q{bfrb is a brainfuck interpreter written in Ruby.}
   s.email = %q{ctoneal@gmail.com}

data/bin/bfrb

@@ -4,22 +4,31 @@ require File.expand_path(File.join(File.dirname(__FILE__), "..", "lib", "bfrb.rb
 
 def usage
 	puts "Usage:"
+	puts "Start interactive evaluation: bfrb"
 	puts "Pass code in as first command line parameter (in quotes): bfrb \",[.,]\""
 	puts "Specify a file to read: bfrb -f test.bf"
+	puts "View this message: bfrb -u"
 end
 
 bfrb = BfRb::Base.new
 # if the command line params specify a file, run it
 # otherwise attempt to run code passed in as a param
-if ARGV.length > 1
-	if ARGV[0] == "-f"
-		bfrb.load_file(ARGV[1])
-	else
-		puts "Invalid arguments"
+if ARGV.length == 0
+	puts "Starting interactive evaluation"
+	bfrb.repl
+else
+	case ARGV[0]
+	when "-u"
 		usage
+	when "-f"
+		if ARGV.length > 1
+			bfrb.load_file(ARGV[1])
+		else
+			puts "Invalid arguments"
+			usage
+		end
+	else
+		puts "Interpreting code"
+		bfrb.run(ARGV[0])
 	end
-elsif ARGV.length > 0
-	bfrb.run(ARGV[0])
-else
-	usage
-end
+end

data/lib/bfrb/interpreter.rb

@@ -4,6 +4,8 @@ module BfRb
 	# interprets brainfuck code
 	class Interpreter
 	
+		attr_reader :program_counter, :memory_counter
+	
 		# initialize the interpreter
 		def initialize
 			@memory = Memory.new
@@ -19,17 +21,20 @@ module BfRb
 			@loop_stack = []
 		end
 		
+		# run a given piece of code
 		def run(code)
-			@code = code
+			@code += code
 			evaluate_code
 		end
 		
+		# evaluate each instruction in the current code
 		def evaluate_code
 			while ((0 <= @program_counter) and (@program_counter < @code.length))
 				evaluate_instruction
 			end
 		end
 		
+		# evaluate an individual instruction
 		def evaluate_instruction
 			case @code[@program_counter]
 			when ">"
@@ -41,16 +46,16 @@ module BfRb
 					@memory_counter = 0
 				end
 			when "+"
-				@memory.set(@memory_counter, @memory.get(@memory_counter) + 1)
+				@memory.set(@memory_counter, current_memory + 1)
 			when "-"
-				@memory.set(@memory_counter, @memory.get(@memory_counter) - 1)
+				@memory.set(@memory_counter, current_memory - 1)
 			when "."
-				print @memory.get(@memory_counter).chr
+				print current_memory.chr
 			when ","
 				input = $stdin.gets.getbyte(0)
 				@memory.set(@memory_counter, input)
 			when "["
-				if @memory.get(@memory_counter) != 0
+				if current_memory != 0
 					@loop_stack.push @program_counter
 				else
 					bracket_counter = 1
@@ -65,11 +70,16 @@ module BfRb
 				end
 			when "]"
 				matching_bracket = @loop_stack.pop
-				if @memory.get(@memory_counter) != 0
+				if current_memory != 0
 					@program_counter = matching_bracket - 1
 				end
 			end
 			@program_counter += 1
 		end
+		
+		# returns the value in the current memory cell
+		def current_memory
+			return @memory.get(@memory_counter)
+		end
 	end
 end

data/lib/bfrb.rb

@@ -19,5 +19,28 @@ module BfRb
 			code = File.open(file_path) { |f| f.read }
 			run(code)
 		end
+		
+		# interactive read-evaluate-print loop
+		def repl
+			puts "'exit' leaves the REPL"
+			puts "'mem' displays the value in the current cell of memory"
+			puts "'clear' clears everything from memory"
+			while true
+				puts ""
+				print "bf> "
+				input = gets.chomp
+				case input
+				when "exit"
+					puts "Exiting"
+					break
+				when "mem"
+					puts "Cell: #{@interpreter.memory_counter} Value: #{@interpreter.current_memory}"
+				when "clear"
+					@interpreter.initialize_environment
+				else
+					@interpreter.run(input)
+				end
+			end
+		end
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bfrb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-06-03 00:00:00.000000000 -05:00
+date: 2011-06-06 00:00:00.000000000 -05:00
 default_executable: bfrb
 dependencies:
 - !ruby/object:Gem::Dependency
   name: shoulda
-  requirement: &8092368 !ruby/object:Gem::Requirement
+  requirement: &9389616 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *8092368
+  version_requirements: *9389616
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &8091288 !ruby/object:Gem::Requirement
+  requirement: &9388836 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *8091288
+  version_requirements: *9388836
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &8089740 !ruby/object:Gem::Requirement
+  requirement: &9388188 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -44,10 +44,10 @@ dependencies:
         version: 1.5.2
   type: :development
   prerelease: false
-  version_requirements: *8089740
+  version_requirements: *9388188
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &8073336 !ruby/object:Gem::Requirement
+  requirement: &9387504 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,7 +55,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *8073336
+  version_requirements: *9387504
 description: bfrb is a brainfuck interpreter written in Ruby.
 email: ctoneal@gmail.com
 executables:
@@ -93,7 +93,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -476785
+      hash: 1070569779
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: