bfrb 0.1.3 → 0.1.4

data/README.rdoc

@@ -11,6 +11,7 @@ To install bfrb:
 	% gem install bfrb
 	
 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 ",[.,]"
@@ -22,9 +23,18 @@ Or, you can specify a file with the -f parameter:
 You can also start an interactive interpreter by running bfrb without any parameters
 	
 	% bfrb
+	
+Just in case you feel the need to use another language internally in a Ruby program, I guess you can:
+
+	require 'rubygems'
+	require 'bfrb'
+	
+	bf = BfRb::Base.new
+	bf.run ",[.,]"
 
 == History
 
+* 0.1.4 - Added a little more documentation, efficiency fixes and Ctrl-X to exit a program
 * 0.1.3 - Unmatched brace checks
 * 0.1.2 - Added unit tests
 * 0.1.1 - Added REPL.

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

data/bfrb.gemspec

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

data/lib/bfrb/interpreter.rb

@@ -26,9 +26,11 @@ module BfRb
 		
 		# run a given piece of code
 		def run(code)
-			@code += code
+			@code += code.delete "^[]<>.,+-"
 			if check_for_matching_braces
-				evaluate_code
+				catch :quit do
+					evaluate_code
+				end
 			end
 		end
 		
@@ -63,26 +65,36 @@ module BfRb
 		# evaluate an individual instruction
 		def evaluate_instruction(instruction)
 			case instruction
+			# shift right in memory
 			when ">"
 				@memory_counter += 1
+			# shift left in memory, unless we're at the beginning
 			when "<"
 				if @memory_counter > 1
 					@memory_counter -= 1
 				else
 					@memory_counter = 0
 				end
+			# increment value in memory
 			when "+"
 				@memory.set(@memory_counter, current_memory + 1)
+			# decrement value in memory
 			when "-"
 				unless current_memory == 0
 					@memory.set(@memory_counter, current_memory - 1)
 				end
+			# print value in memory
 			when "."
 				@output_stream.print current_memory.chr
+			# input a character into memory
 			when ","
 				@output_stream.puts
 				input = @input_stream.gets.getbyte(0)
+				if input == 24
+					throw :quit
+				end
 				@memory.set(@memory_counter, input)
+			# jump to the closing bracket if memory is 0
 			when "["
 				if current_memory != 0
 					@loop_stack.push @program_counter
@@ -97,6 +109,7 @@ module BfRb
 						end
 					end
 				end
+			# return to the opening bracket if memory is not zero
 			when "]"
 				matching_bracket = @loop_stack.pop
 				if current_memory != 0

data/lib/bfrb.rb

@@ -22,15 +22,15 @@ module BfRb
 		
 		# interactive read-evaluate-print loop
 		def repl
-			puts "'exit' leaves the REPL"
+			puts "'exit' or Ctrl-X 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> "
+				print "bfrb> "
 				input = gets.chomp
 				case input
-				when "exit"
+				when "exit", 24.chr
 					puts "Exiting"
 					break
 				when "mem"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bfrb
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-06-07 00:00:00.000000000 -05:00
+date: 2011-06-09 00:00:00.000000000 -05:00
 default_executable: bfrb
 dependencies:
 - !ruby/object:Gem::Dependency
   name: shoulda
-  requirement: &8122260 !ruby/object:Gem::Requirement
+  requirement: &8122320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *8122260
+  version_requirements: *8122320
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &8115360 !ruby/object:Gem::Requirement
+  requirement: &8115540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *8115360
+  version_requirements: *8115540
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &8096676 !ruby/object:Gem::Requirement
+  requirement: &8096772 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -44,10 +44,10 @@ dependencies:
         version: 1.5.2
   type: :development
   prerelease: false
-  version_requirements: *8096676
+  version_requirements: *8096772
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &8095140 !ruby/object:Gem::Requirement
+  requirement: &8095248 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,7 +55,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *8095140
+  version_requirements: *8095248
 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: -645724511
+      hash: 950763631
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: