meta_compile 0.0.1 → 0.0.2

data/README.md

@@ -0,0 +1,40 @@
+meta_compile
+============
+
+A meta compilation framework for Ruby à la [Meta-II by Val Schorre](http://ibm-1401.info/Meta-II-schorre.pdf).
+
+Uses a C version of Meta-II developed by Long Nguyen's ([meta](https://github.com/impeachgod/meta)) to bootstrap a Ruby version from a [fully self-contained 28 (non-empty) line specification file](https://raw.github.com/robertfeldt/meta_compile/master/bootstrap/meta_for_ruby.txt). The [generated Ruby Meta-II compiler file](https://github.com/robertfeldt/meta_compile/blob/master/bin/meta_compile) is 229 lines of non-empty Ruby code.
+
+Install
+-------
+
+Clone the git repo and then run:
+
+        rake bootstrap
+
+and it will bootstrap and print info about each step. This requires gcc, rake and a recent ruby. 
+
+If you only want the finished result you can just install as a gem:
+
+        gem install meta_compile
+
+since it is available on [rubygems.org](https://rubygems.org/gems/meta_compile).
+
+Manually verifying that it is a meta compiler
+---------------------------------------------
+
+In your local copy of the git repo, use the pre-generated binary to compile the specification file to a ruby file:
+
+        bin/meta_compile bootstrap/meta_for_ruby.txt t.rb
+
+This generates a t.rb which is itself a compiler for meta syntax specs. So lets use it to generate itself:
+
+        ruby t.rb bootstrap/meta_for_ruby.txt t2.rb
+
+And ensure they are really the same:
+
+        diff t.rb t2.rb
+
+Limitations
+-----------
++ Very bad/little error handling

data/bootstrap/meta_for_ruby.txt

@@ -0,0 +1,36 @@
+.syntax RMetaII
+
+arg = '$' <'@o.print @t'>
+    | .string <'@o.print ' $>;
+
+output = '<' *arg '>' <'@o.print "\n"'>;
+
+exp3 = .id <'compile_' $>
+     | .string <'@i.scan /\s*/; s=' $>
+       <'@f = (@i.peek(s.length) == s) ? (@t=s; @i.pos += s.length) : nil'>
+     | '.id' <'@i.scan /\s*/; @f = @t = @i.scan /[A-Za-z]+[A-Za-z0-9_]+/'>
+     | '.string' <'@i.scan /\s*/; @f = @t = @i.scan /\047[^\047]*\047/'>
+     | '(' exp1 ')'
+     | '.e' <'@f = true'>
+     | '*' <'begin'> exp3 <'end while @f'> <'@f = true'>;
+
+exp2 = ( exp3 <'if @f'> | output <'if true'> )
+       *( exp3 <'raise("error at: " + @i.rest.split("\n")[0]) if !@f'>
+        | output ) <'end'>;
+
+exp1 = <'begin'> exp2
+       *( '|' <'break if @f'> exp2 )
+       <'end while false'>;
+
+stat = .id <'def compile_' $> '=' exp1 ';' <'end'>;
+
+program = '.syntax' .id 
+  <'#!/usr/bin/env ruby'> <'require "strscan"'>
+  <'class ' $> <'def compile(str, out)'>
+  <'@i, @o = StringScanner.new(str), out'>
+  <'compile_program'> <'end'>
+  *stat '.end' <'end'>
+  <'begin; puts "Use: meta_compile <in> <out>"; exit; end if ARGV.length != 2'>
+  <'File.open(ARGV[1], "w") {|f| RMetaII.new.compile(File.read(ARGV[0]), f)}'>;
+
+.end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_compile
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -19,6 +19,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - bin/meta_compile
+- README.md
+- bootstrap/meta_for_ruby.txt
 homepage: http://rubygems.org/gems/meta_compile
 licenses: []
 post_install_message: