whitespace-ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3ff8b72c2baeb5ad2c69f31e1a31f3e541f039c8
+  data.tar.gz: 2bfffd2243ccaffd7ff0250eb24d672707acc1d8
+SHA512:
+  metadata.gz: 3de7c8d3f2719f595fd7f9c1a11ea862c59d68012989ce1b7d4babf1d84e2357ed7c8be5e69e537af0cea2e49e1cb66c6c2787214a2927779072b7d086e3d158
+  data.tar.gz: 551eafc5ab4054218fdd83b22d417e37112475b567f4d9977d017ff6661931ada2a522714940718679799d9272804f0034c6b4dc57175979f14bd6960db1b92c

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.ruby-version
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Dwayne Crooks
+
+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/README.md

@@ -0,0 +1,52 @@
+## About
+
+An interpreter written in [Ruby](https://www.ruby-lang.org) for the imperative, stack based language called [Whitespace][1].
+
+## Installation
+
+Install it yourself using:
+
+```bash
+$ gem install whitespace-ruby
+```
+
+You would now have access to an executable called `whitespace`. Type
+
+```bash
+$ whitespace --help
+```
+
+to learn more.
+
+## Usage
+
+Let's say you've written a [Whitespace][1] program and stored it in the file `program.ws`. Then, to execute that program, type:
+
+```bash
+$ whitespace program.ws
+```
+
+This gem comes with example [Whitespace][1] programs that you can check out at [examples](/examples). Be sure to run them to see what they do.
+
+For example, here's the [factorial program](/examples/fact.ws) and a sample execution (assuming you're in the examples directory):
+
+```bash
+$ whitespace fact.ws
+Enter a number: 40
+40! = 20397882081197443358640281739902897356800000000
+```
+
+## References
+
+- [Whitespace tutorial](http://compsoc.dur.ac.uk/whitespace/tutorial.html)
+
+## Credits
+
+Thanks to Edwin Brady and Chris Morris for developing this programming language (also developers of the [Idris][2] programming language). I've had lots of fun playing with it and writing interpreters (in [Racket](https://github.com/dwayne/whitespace-racket), [Haskell](https://github.com/dwayne/whitespace-haskell) and now [Ruby](https://www.ruby-lang.org)) for it.
+
+## Copyright
+
+Copyright (c) 2016 Dwayne Crooks. See [LICENSE](/LICENSE.md) for further details.
+
+[1]: https://en.wikipedia.org/wiki/Whitespace_\(programming_language\)
+[2]: https://en.wikipedia.org/wiki/Idris_(programming_language)

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/setup"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.warning = false
+end
+
+task default: :test

data/bin/whitespace

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+
+require_relative "../lib/whitespace"
+
+def main
+  require "optparse"
+  options = {}
+  opts = OptionParser.new do |opts|
+    executable_name = File.basename($PROGRAM_NAME)
+    opts.banner = <<-BANNER
+A Whitespace interpreter written in Ruby.
+
+Usage: #{executable_name} [options] filename
+
+    BANNER
+
+    opts.on("-v", "--version", "Show version information, then exit") do
+      puts Whitespace::VERSION
+      exit
+    end
+
+    opts.on("-h", "--help", "Show this help, then exit") do
+      puts opts
+      exit
+    end
+  end
+  opts.parse!
+
+  nargs = ARGV.length
+  if nargs == 0 || nargs > 1
+    puts opts
+    exit 1
+  end
+
+  abs_filename = File.expand_path(ARGV[0])
+  src = File.new(abs_filename).read
+
+  vm = Whitespace::VM.new
+  console = Whitespace::Console.new
+  parser = Whitespace::Parser.new(vm, console)
+
+  begin
+    vm.load(parser.parse(src))
+    vm.run
+  rescue => e
+    raise Whitespace::Error
+  end
+end
+
+begin
+  main
+rescue Whitespace::Error => e
+  STDERR.puts "A problem occurred while executing your Whitespace program"
+  STDERR.puts "Error: #{e.cause.message}"
+  exit 1
+rescue ArgumentError => e
+  STDERR.puts "Please check your options/arguments"
+  STDERR.puts "Error: #{e.message}"
+  exit 1
+rescue => e
+  STDERR.puts "Sorry, we encountered an unrecoverable error"
+  STDERR.puts e.message
+  STDERR.puts e.backtrace.join("\n")
+  exit 1
+end

data/examples/count.ws

@@ -0,0 +1,76 @@
+   	
+
+   	    		
+ 
+ 	
+ 	   	 	 
+	
+     	
+	    
+    	 		
+	  	
+	  	   	 	
+
+ 
+ 	    		
+
+   	   	 	
+ 
+
+
+
+
+
+   		    	 		  	   		  	  
+	   
+	
+
+   			 			 			  	  		 	  	 			 	   		  	 	
+ 
+ 			 
+ 
+	  			 			 			  	  		 	  	 			 	   		  	 	 	 					 		  	 	 		 			  		  	  
+	
+     	
+	   
+ 
+ 			 			 			  	  		 	  	 			 	   		  	 	
+
+   			 			 			  	  		 	  	 			 	   		  	 	 	 					 		  	 	 		 			  		  	  
+ 
+
+ 
+
+
+	
+
+   			  	  		  	 	 		    	 		  	  
+ 
+  
+ 	
+	 			 
+    	 	 
+	  	
+	  			  	  		  	 	 		    	 		  	   	 					 		  	 	 		 			  		  	  
+ 
+
+   	
+	   
+ 
+ 			  	  		  	 	 		    	 		  	  
+
+   			  	  		  	 	 		    	 		  	   	 					 		  	 	 		 			  		  	  
+ 
+
+   	
+	       
+		 
+	
+
+   		 			  		  	 	 			 			 		 		   		 	  	 		 			  		  	 	
+   	 	 
+   		 	
+	
+  	
+  
+	

data/examples/fact.ws

@@ -0,0 +1,135 @@
+Ask the user for a
+number, then calculate its	   	 	
+factorial.		    	
+   		 			 
+		    	 
+This program shows how	we		 	  
+handle	recursion	as well as big numbers.		
+   		  	 	
+Try	giving	10000 as an input... 	  
+   			  	 
+		    	 	
+   	     
+		    		 
+   		    	
+		    			
+   	     
+		    	   
+   		 			 
+		    	  	
+   			 	 	
+		    	 	 
+   		 		 	
+		    	 		
+   		   	 
+		    		  
+   		  	 	
+		    		 	
+   			  	 
+		    			 
+   			 	 
+		    				
+   	     
+		    	    
+    
+		    	 	  
+   	    	
+		    	 	 	
+   	     
+		    	 		 
+   				 	
+		    	 			
+   	     
+		    		   
+    
+		     
+
+ 	 			 			 			  	  		 	  	 			 	   		  	 	
+   		  	  
+	
+		   		  	  
+			
+ 	 		  		  		    	 		   		 			 	  
+   		  	  
+				
+ 	   	 	  
+
+ 	 			 			 			  	  		 	  	 			 	   		  	 	
+	
+ 	
+ 	 		 			  		  	 	 			 			 		 		   		 	  	 		 			  		  	 	
+
+
+
+
+   		  		  		    	 		   		 			 	  
+ 
+    	
+	  	
+	  		  		  		    	 		   		 			 	   		   	  		    	 			  		 		  	 	
+ 
+    	
+	  	
+ 	 		  		  		    	 		   		 			 	  
+	  
+
+	
+
+   		  		  		    	 		   		 			 	   		   	  		    	 			  		 		  	 	
+   	
+
+	
+
+   		    	 		  	   		  	  
+	   
+	
+
+   			 			 			  	  		 	  	 			 	   		  	 	
+ 
+ 			 
+ 
+	  			 			 			  	  		 	  	 			 	   		  	 	 	 					 		  	 	 		 			  		  	  
+	
+     	
+	   
+ 
+ 			 			 			  	  		 	  	 			 	   		  	 	
+
+   			 			 			  	  		 	  	 			 	   		  	 	 	 					 		  	 	 		 			  		  	  
+ 
+
+ 
+
+
+	
+
+   			  	  		  	 	 		    	 		  	  
+ 
+  
+ 	
+	 			 
+    	 	 
+	  	
+	  			  	  		  	 	 		    	 		  	   	 					 		  	 	 		 			  		  	  
+ 
+
+   	
+	   
+ 
+ 			  	  		  	 	 		    	 		  	  
+
+   			  	  		  	 	 		    	 		  	   	 					 		  	 	 		 			  		  	  
+ 
+
+   	
+	       
+		 
+	
+
+   		 			  		  	 	 			 			 		 		   		 	  	 		 			  		  	 	
+   	 	 
+   		 	
+	
+  	
+  
+	

data/examples/hello.ws

@@ -0,0 +1,110 @@
+Say hello.   
+   	  	   
+		    	
+   		  	 	
+		    	 
+   		 		  
+		    		
+   		 		  
+		    	  
+   		 				
+		    	 	
+   	 		  
+		    		 
+   	     
+		    			
+   			 			
+		    	   
+   		 				
+		    	  	
+   			  	 
+		    	 	 
+   		 		  
+		    	 		
+   		  	  
+		    		  
+   	     
+		    		 	
+   		 				
+		    			 
+   		  		 
+		    				
+   	     
+		    	    
+   			  		
+		    	   	
+   			    
+		    	  	 
+   		    	
+		    	  		
+   		   		
+		    	 	  
+   		  	 	
+		    	 	 	
+   			  		
+		    	 		 
+   	    	
+		    	 			
+    
+		     
+
+ 	 			 			 			  	  		 	  	 			 	   		  	 	
+
+ 	 		 			  		  	 	 			 			 		 		   		 	  	 		 			  		  	 	
+
+
+
+
+   		    	 		  	   		  	  
+	   
+	
+
+   			 			 			  	  		 	  	 			 	   		  	 	
+ 
+ 			 
+ 
+	  			 			 			  	  		 	  	 			 	   		  	 	 	 					 		  	 	 		 			  		  	  
+	
+     	
+	   
+ 
+ 			 			 			  	  		 	  	 			 	   		  	 	
+
+   			 			 			  	  		 	  	 			 	   		  	 	 	 					 		  	 	 		 			  		  	  
+ 
+
+ 
+
+
+	
+
+   			  	  		  	 	 		    	 		  	  
+ 
+  
+ 	
+	 			 
+    	 	 
+	  	
+	  			  	  		  	 	 		    	 		  	   	 					 		  	 	 		 			  		  	  
+ 
+
+   	
+	   
+ 
+ 			  	  		  	 	 		    	 		  	  
+
+   			  	  		  	 	 		    	 		  	   	 					 		  	 	 		 			  		  	  
+ 
+
+   	
+	       
+		 
+	
+
+   		 			  		  	 	 			 			 		 		   		 	  	 		 			  		  	 	
+   	 	 
+   		 	
+	
+  	
+  
+