literate-programming 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0579c7998d6a577731d88aaf496b921958e1c6c7
+  data.tar.gz: 9e080bfd77245430a9cf245526651510d308c0c9
+SHA512:
+  metadata.gz: ef5992afcf34d3bfcf24608850b4d0d5f6cb9eab9989315fb22ebf3c739bbae6ed2f84c0ea8ef60b38f8c87d565b32b62e05743e9ea07f4b198a293991b31d37
+  data.tar.gz: a54eb1c3414d1d6a74dffde4897dd9d898a6362d564acfcaecb8224502f2ee7a33f89b6a1090a30a2fa4b12befed28e5aa118a6a48cfd30aaa7873637a06090f

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in literate-programming.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 pixie-grasper
+
+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,76 @@
+# Literate Programming for Ruby and Markdown!
+
+Let us Literate Programming!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'literate-programming'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install literate-programming
+
+### Installation from repository
+
+You are also able to install this gem from github repository.
+```bash
+$ git clone https://github.com/pixie-grasper/literate-programming.git
+$ cd literate-programming
+$ rake install
+```
+
+## Usage
+
+- How to Use?
+
+```bash
+$ rtangle example.wrb # to get example.rb
+$ rweave example.wrb # to get example.md
+```
+
+## Examples
+- Hello, world!
+
+First, write hellow.wrb
+```
+First, define the Hello, world!
+[[hello-world]] =
+  "Hello, world!"
+
+Next, define Main Program; 'Hello, world!'
+[[*]] =
+  def main
+    p [[hello-world]]
+  end
+
+Finaly, call the main.
+[[*]] +=
+  main
+```
+
+Second, tangle it!
+```bash
+$ rtangle hello.wrb
+```
+
+Finally, you will get hello.rb
+```ruby
+def main
+  p "Hello, world!"
+end
+
+main
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new 'spec'
+task :default => :spec

data/bin/rtangle

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require 'literate/programming'
+
+raise if ARGV.length < 1
+ifname = ARGV[0]
+ofname = File.dirname(ifname) + '/' + File.basename(ifname, '.wrb') + '.rb'
+inst = Literate::Programming.new File.open(ifname, 'r').read
+File.open(ofname, 'w').write inst.to_ruby

data/bin/rweave

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require 'literate/programming'
+
+raise if ARGV.length < 1
+ifname = ARGV[0]
+ofname = File.dirname(ifname) + '/' + File.basename(ifname, '.wrb') + '.md'
+inst = Literate::Programming.new File.open(ifname, 'r').read
+File.open(ofname, 'w').write inst.to_md

data/example/simple-1.wrb

@@ -0,0 +1,3 @@
+Simple Case 1.
+[[*]] =
+  p 'Hello, world!'

data/example/simple-2.wrb

@@ -0,0 +1,7 @@
+Simple Case 2.
+[[hello-world]] =
+  'Hello, world!'
+
+The main program says hello!
+[[*]] =
+  p [[hello-world]]

data/example/simple-3.wrb

@@ -0,0 +1,17 @@
+Simple Case 3.
+[[*]] =
+  def main
+    [[main-body]]
+  end
+
+The main function says hello-world
+[[main-body]] =
+  p [[hello-world]]
+
+Definition of the hello-world is a 'Hello, world!'
+[[hello-world]] =
+  'Hello, world!'
+
+Finally, call the main function.
+[[*]] +=
+  main

data/example/template-1.wrb

@@ -0,0 +1,36 @@
+Template Case 1.
+[[*]] =
+  def main
+    [[main-body]]
+  end
+
+Sing a song ''99 bottles of beer''
+[[main-body]] =
+  [[bottles:100]]
+
+General case, sing below
+[[bottles:@]] =
+  puts '@0 bottles of beer on the wall, @0 bottles of beer.'
+  puts 'Take one down and pass it around, @@(@0 - 1) bottles of beer on the wall.'
+  [[bottles:@@(@0 - 1)]]
+
+When number of bottles == 2
+[[bottles:2]] =
+  puts '2 bottles of beer on the wall, 2 bottles of beer.'
+  puts 'Take one down and pass it around, 1 bottle of beer on the wall.'
+  [[bottles:1]]
+
+When number of bottles == 1
+[[bottles:1]] =
+  puts '1 bottle of beer on the wall, 1 bottle of beer.'
+  puts 'Take one down and pass it around, no more bottles of beer on the wall.'
+  [[bottles:0]]
+
+When no rest bottles...
+[[bottles:0]] =
+  puts 'No more bottles of beer on the wall, no more bottles of beer.'
+  puts 'Go to the store and buy some more, 99 bottles of beer on the wall.'
+
+Finally, call the main function.
+[[*]] +=
+  main

data/example/template-2.wrb

@@ -0,0 +1,27 @@
+Template Case 2.
+[[*]] =
+  class Main
+    [[main-body]]
+  end
+
+It is free to use @ unless it is followed by a number.
+It is also free to use @@ unless it is followed by left parent.
+[[main-body]] =
+  def initialize
+    @x = @@default_x
+  end
+
+If @@ is followed by left parent, it will evaluated by the rtangle.
+For example, an rtangled below one will equals to '@@default_x = 10'
+[[main-body]] +=
+  @@default_x = @@(1 + 2 + 3 + 4)
+
+How Main.new.run works?
+[[main-body]] +=
+  def run
+    p 'Hello!'
+  end
+
+Finally, instanciate Main and run it!
+[[*]] +=
+  Main.new.run

data/lib/literate/programming/version.rb

@@ -0,0 +1,5 @@
+module Literate
+  class Programming
+    VERSION = "1.0.0"
+  end
+end

data/lib/literate/programming.rb

@@ -0,0 +1,188 @@
+require "literate/programming/version"
+
+module Literate
+  class Programming
+    def initialize(src = "", source: nil, tabstop: 2)
+      @source = source || src
+      @tabstop = tabstop
+    end
+
+    def to_ruby
+      convert[:rb]
+    end
+
+    def to_md
+      convert[:md]
+    end
+
+    def convert
+      current_mode = :text
+      md = ""
+      table = {}
+      current_code = nil
+      current_label = nil
+      operator = nil
+      @source.split($/).each do |line|
+        old_mode = current_mode
+        case current_mode
+        when :text
+          if line.match /^[ \t]*\[\[([^\]]+)\]\][ \t]*(\+?=|<<)[ \t]*$/ then
+            current_mode = :code
+            current_code = ''
+            current_label = $1
+            case $2
+              when '='
+                operator = :assign
+              when '+=', '<<'
+                operator = :append
+            end
+          end
+        when :code
+          if line.match /^[ \t]*$/ then
+            current_mode = :text
+          else
+            line = line.match(/^[ \t]*/).post_match
+          end
+        end
+        case current_mode
+        when :text
+          if old_mode == :code then
+            case operator
+              when :assign
+                raise if table[current_label]
+                table[current_label] = current_code
+              when :append
+                table[current_label] ||= ''
+                table[current_label] << $/ << current_code
+            end
+            md << '```' << $/ << $/
+          else
+            md << line << $/
+          end
+        when :code
+          if old_mode == :code then
+            current_code << line << $/
+            md << line << $/
+          else
+            md << '```ruby:' << current_label
+            md << ' append' if operator == :append
+            md << $/
+          end
+        end
+      end
+      if current_mode == :code then
+        case operator
+          when :assign
+            table[current_label] = current_code
+          when :append
+            table[current_label] ||= ''
+            table[current_label] << $/ << current_code
+        end
+        md << '```' << $/
+      end
+      table['*'] ||= ''
+      return {rb: indent_code(expand(table)), md: indent_text(md)}
+    end
+
+    def expand(table)
+      processed = ''
+      processing = '[[*]]'
+      while processing.match /^((?:[^\[]|\[[^\[])*)\[\[([^\]]+)\]\]/m
+        processed << $1
+        expanding = $2
+        follow = $~.post_match
+        if table.member? expanding then
+          processing = expand_template(table[expanding], nil).chomp
+        elsif expanding.match /^([^:]+):([^,]+)(,[^,]+)*$/ then
+          true_expanding = $1 + ':@'
+          args = $~.to_a[2..-2]
+          raise 'undefined ' + expanding unless table.member? true_expanding
+          processing = expand_template(table[true_expanding], args).chomp
+        else
+          raise 'undefined ' + expanding
+        end
+        processing << follow
+      end
+      return processed << processing
+    end
+
+    def expand_template(string, args)
+      processed = ''
+      processing = string
+      while processing.match /^((?:[^@]|@[^0-9@])*)@/m
+        processed << $1
+        follow = $~.post_match
+        if follow.match /^(0|[1-9][0-9]*)/m then
+          # @num -> args[num]
+          processed << args[$1.to_i]
+          processing = $~.post_match
+        elsif follow.match /^@/m then
+          follow = $~.post_match
+          if follow.match /^(?<paren>\((?:[^()]|\g<paren>)*\))/m then
+            # @@(expr) -> eval(expr)
+            post_match = $~.post_match
+            expanding = eval(expand_template $1, args)
+            processed << expanding.to_s
+            processing = post_match
+          else
+            processed << '@@'
+            processing = follow
+          end
+        else
+          processed << '@'
+          processing = follow
+        end
+      end
+      return processed << processing
+    end
+
+    def indent_code(code)
+      indent_level_stack = [-@tabstop]
+      ret = ''
+      code.split($/).each do |line|
+        ret, indent_level_stack = pretty_print_ruby ret, indent_level_stack, line
+      end
+      return ret
+    end
+
+    def indent_text(text)
+      mode = :text
+      ret = ''
+      indent_level_stack = nil
+      text.split($/).each do |line|
+        if mode == :text and line.match /^```/ then
+          mode = :code
+          indent_level_stack = [-@tabstop]
+          ret << line << $/
+        elsif mode == :text then
+          ret << line << $/
+        elsif mode == :code and line.match /^```/ then
+          mode = :text
+          ret << line << $/
+        else
+          ret, indent_level_stack = pretty_print_ruby ret, indent_level_stack, line
+        end
+      end
+      return ret
+    end
+
+    def pretty_print_ruby(buffer, indent_level_stack, line)
+      if line.match /^[ \t]*(else|elsif|ensure|rescue|when)\b/ then
+        current_indent_level = indent_level_stack[-1]
+      elsif line.match /\b(end)\b/ then
+        current_indent_level = indent_level_stack.pop
+      else
+        current_indent_level = indent_level_stack[-1] + @tabstop
+      end
+      if line.match /^[ \t]*$/ then
+        buffer << $/
+      else
+        buffer << ' ' * current_indent_level << line << $/
+      end
+      if line.match /^[ \t]*(begin|class|def|for|while|module)\b/
+        indent_level_stack.push current_indent_level
+      end
+      return buffer, indent_level_stack
+    end
+  end
+end

data/literate-programming.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'literate/programming/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'literate-programming'
+  spec.version       = Literate::Programming::VERSION
+  spec.authors       = %w!pixie-grasper!
+  spec.email         = %w!himajinn13sei@gmail.com!
+
+  spec.summary       = %q{Literate Programming for Ruby / Markdown.}
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/pixie-grasper/literate-programming'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/).find_all do |path|
+    not File.basename(path).match %r!^\.!
+  end
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/spec/lib/literate/programming_spec.rb

@@ -0,0 +1,498 @@
+require 'spec_helper'
+require 'literate/programming'
+
+describe 'literate-programming' do
+  it 'empty' do
+    inst = Literate::Programming.new
+    expect(inst.to_ruby).to eq ""
+    expect(inst.to_md).to eq ""
+
+    inst = Literate::Programming.new ""
+    expect(inst.to_ruby).to eq ""
+    expect(inst.to_md).to eq ""
+
+    inst = Literate::Programming.new $/
+    expect(inst.to_ruby).to eq ""
+    expect(inst.to_md).to eq ""
+  end
+
+  it 'simple case 1' do
+    inst = Literate::Programming.new <<-EOW
+Simple Case 1.
+[[*]] =
+  p 'Hello, world!'
+    EOW
+
+    expect(inst.to_ruby).to eq <<-EOC
+p 'Hello, world!'
+    EOC
+
+    expect(inst.to_md).to eq <<-EOM
+Simple Case 1.
+```ruby:*
+p 'Hello, world!'
+```
+    EOM
+  end
+
+  it 'simple case 2' do
+    inst = Literate::Programming.new <<-EOM
+Simple Case 2.
+[[hello-world]] =
+  'Hello, world!'
+
+The main program says hello!
+[[*]] =
+  p [[hello-world]]
+    EOM
+
+    expect(inst.to_ruby).to eq <<-EOC
+p 'Hello, world!'
+    EOC
+
+    expect(inst.to_md).to eq <<-EOM
+Simple Case 2.
+```ruby:hello-world
+'Hello, world!'
+```
+
+The main program says hello!
+```ruby:*
+p [[hello-world]]
+```
+    EOM
+  end
+
+  it 'simple case 3' do
+    inst = Literate::Programming.new <<-EOM
+Simple Case 3.
+[[*]] =
+  def main
+    [[main-body]]
+  end
+
+The main function says hello-world
+[[main-body]] =
+  p [[hello-world]]
+
+Definition of the hello-world is a 'Hello, world!'
+[[hello-world]] =
+  'Hello, world!'
+
+Finally, call the main function.
+[[*]] +=
+  main
+    EOM
+
+    expect(inst.to_ruby).to eq <<-EOC
+def main
+  p 'Hello, world!'
+end
+
+main
+    EOC
+
+    expect(inst.to_md).to eq <<-EOC
+Simple Case 3.
+```ruby:*
+def main
+  [[main-body]]
+end
+```
+
+The main function says hello-world
+```ruby:main-body
+p [[hello-world]]
+```
+
+Definition of the hello-world is a 'Hello, world!'
+```ruby:hello-world
+'Hello, world!'
+```
+
+Finally, call the main function.
+```ruby:* append
+main
+```
+    EOC
+  end
+
+  it 'template case 1' do
+    inst = Literate::Programming.new <<-EOM
+Template Case 1.
+[[*]] =
+  def main
+    [[main-body]]
+  end
+
+Sing a song ''99 bottles of beer''
+[[main-body]] =
+  [[bottles:100]]
+
+General case, sing below
+[[bottles:@]] =
+  puts '@0 bottles of beer on the wall, @0 bottles of beer.'
+  puts 'Take one down and pass it around, @@(@0 - 1) bottles of beer on the wall.'
+  [[bottles:@@(@0 - 1)]]
+
+When number of bottles == 2
+[[bottles:2]] =
+  puts '2 bottles of beer on the wall, 2 bottles of beer.'
+  puts 'Take one down and pass it around, 1 bottle of beer on the wall.'
+  [[bottles:1]]
+
+When number of bottles == 1
+[[bottles:1]] =
+  puts '1 bottle of beer on the wall, 1 bottle of beer.'
+  puts 'Take one down and pass it around, no more bottles of beer on the wall.'
+  [[bottles:0]]
+
+When no rest bottles...
+[[bottles:0]] =
+  puts 'No more bottles of beer on the wall, no more bottles of beer.'
+  puts 'Go to the store and buy some more, 99 bottles of beer on the wall.'
+
+Finally, call the main function.
+[[*]] +=
+  main
+    EOM
+
+    expect(inst.to_ruby).to eq <<-EOC
+def main
+  puts '100 bottles of beer on the wall, 100 bottles of beer.'
+  puts 'Take one down and pass it around, 99 bottles of beer on the wall.'
+  puts '99 bottles of beer on the wall, 99 bottles of beer.'
+  puts 'Take one down and pass it around, 98 bottles of beer on the wall.'
+  puts '98 bottles of beer on the wall, 98 bottles of beer.'
+  puts 'Take one down and pass it around, 97 bottles of beer on the wall.'
+  puts '97 bottles of beer on the wall, 97 bottles of beer.'
+  puts 'Take one down and pass it around, 96 bottles of beer on the wall.'
+  puts '96 bottles of beer on the wall, 96 bottles of beer.'
+  puts 'Take one down and pass it around, 95 bottles of beer on the wall.'
+  puts '95 bottles of beer on the wall, 95 bottles of beer.'
+  puts 'Take one down and pass it around, 94 bottles of beer on the wall.'
+  puts '94 bottles of beer on the wall, 94 bottles of beer.'
+  puts 'Take one down and pass it around, 93 bottles of beer on the wall.'
+  puts '93 bottles of beer on the wall, 93 bottles of beer.'
+  puts 'Take one down and pass it around, 92 bottles of beer on the wall.'
+  puts '92 bottles of beer on the wall, 92 bottles of beer.'
+  puts 'Take one down and pass it around, 91 bottles of beer on the wall.'
+  puts '91 bottles of beer on the wall, 91 bottles of beer.'
+  puts 'Take one down and pass it around, 90 bottles of beer on the wall.'
+  puts '90 bottles of beer on the wall, 90 bottles of beer.'
+  puts 'Take one down and pass it around, 89 bottles of beer on the wall.'
+  puts '89 bottles of beer on the wall, 89 bottles of beer.'
+  puts 'Take one down and pass it around, 88 bottles of beer on the wall.'
+  puts '88 bottles of beer on the wall, 88 bottles of beer.'
+  puts 'Take one down and pass it around, 87 bottles of beer on the wall.'
+  puts '87 bottles of beer on the wall, 87 bottles of beer.'
+  puts 'Take one down and pass it around, 86 bottles of beer on the wall.'
+  puts '86 bottles of beer on the wall, 86 bottles of beer.'
+  puts 'Take one down and pass it around, 85 bottles of beer on the wall.'
+  puts '85 bottles of beer on the wall, 85 bottles of beer.'
+  puts 'Take one down and pass it around, 84 bottles of beer on the wall.'
+  puts '84 bottles of beer on the wall, 84 bottles of beer.'
+  puts 'Take one down and pass it around, 83 bottles of beer on the wall.'
+  puts '83 bottles of beer on the wall, 83 bottles of beer.'
+  puts 'Take one down and pass it around, 82 bottles of beer on the wall.'
+  puts '82 bottles of beer on the wall, 82 bottles of beer.'
+  puts 'Take one down and pass it around, 81 bottles of beer on the wall.'
+  puts '81 bottles of beer on the wall, 81 bottles of beer.'
+  puts 'Take one down and pass it around, 80 bottles of beer on the wall.'
+  puts '80 bottles of beer on the wall, 80 bottles of beer.'
+  puts 'Take one down and pass it around, 79 bottles of beer on the wall.'
+  puts '79 bottles of beer on the wall, 79 bottles of beer.'
+  puts 'Take one down and pass it around, 78 bottles of beer on the wall.'
+  puts '78 bottles of beer on the wall, 78 bottles of beer.'
+  puts 'Take one down and pass it around, 77 bottles of beer on the wall.'
+  puts '77 bottles of beer on the wall, 77 bottles of beer.'
+  puts 'Take one down and pass it around, 76 bottles of beer on the wall.'
+  puts '76 bottles of beer on the wall, 76 bottles of beer.'
+  puts 'Take one down and pass it around, 75 bottles of beer on the wall.'
+  puts '75 bottles of beer on the wall, 75 bottles of beer.'
+  puts 'Take one down and pass it around, 74 bottles of beer on the wall.'
+  puts '74 bottles of beer on the wall, 74 bottles of beer.'
+  puts 'Take one down and pass it around, 73 bottles of beer on the wall.'
+  puts '73 bottles of beer on the wall, 73 bottles of beer.'
+  puts 'Take one down and pass it around, 72 bottles of beer on the wall.'
+  puts '72 bottles of beer on the wall, 72 bottles of beer.'
+  puts 'Take one down and pass it around, 71 bottles of beer on the wall.'
+  puts '71 bottles of beer on the wall, 71 bottles of beer.'
+  puts 'Take one down and pass it around, 70 bottles of beer on the wall.'
+  puts '70 bottles of beer on the wall, 70 bottles of beer.'
+  puts 'Take one down and pass it around, 69 bottles of beer on the wall.'
+  puts '69 bottles of beer on the wall, 69 bottles of beer.'
+  puts 'Take one down and pass it around, 68 bottles of beer on the wall.'
+  puts '68 bottles of beer on the wall, 68 bottles of beer.'
+  puts 'Take one down and pass it around, 67 bottles of beer on the wall.'
+  puts '67 bottles of beer on the wall, 67 bottles of beer.'
+  puts 'Take one down and pass it around, 66 bottles of beer on the wall.'
+  puts '66 bottles of beer on the wall, 66 bottles of beer.'
+  puts 'Take one down and pass it around, 65 bottles of beer on the wall.'
+  puts '65 bottles of beer on the wall, 65 bottles of beer.'
+  puts 'Take one down and pass it around, 64 bottles of beer on the wall.'
+  puts '64 bottles of beer on the wall, 64 bottles of beer.'
+  puts 'Take one down and pass it around, 63 bottles of beer on the wall.'
+  puts '63 bottles of beer on the wall, 63 bottles of beer.'
+  puts 'Take one down and pass it around, 62 bottles of beer on the wall.'
+  puts '62 bottles of beer on the wall, 62 bottles of beer.'
+  puts 'Take one down and pass it around, 61 bottles of beer on the wall.'
+  puts '61 bottles of beer on the wall, 61 bottles of beer.'
+  puts 'Take one down and pass it around, 60 bottles of beer on the wall.'
+  puts '60 bottles of beer on the wall, 60 bottles of beer.'
+  puts 'Take one down and pass it around, 59 bottles of beer on the wall.'
+  puts '59 bottles of beer on the wall, 59 bottles of beer.'
+  puts 'Take one down and pass it around, 58 bottles of beer on the wall.'
+  puts '58 bottles of beer on the wall, 58 bottles of beer.'
+  puts 'Take one down and pass it around, 57 bottles of beer on the wall.'
+  puts '57 bottles of beer on the wall, 57 bottles of beer.'
+  puts 'Take one down and pass it around, 56 bottles of beer on the wall.'
+  puts '56 bottles of beer on the wall, 56 bottles of beer.'
+  puts 'Take one down and pass it around, 55 bottles of beer on the wall.'
+  puts '55 bottles of beer on the wall, 55 bottles of beer.'
+  puts 'Take one down and pass it around, 54 bottles of beer on the wall.'
+  puts '54 bottles of beer on the wall, 54 bottles of beer.'
+  puts 'Take one down and pass it around, 53 bottles of beer on the wall.'
+  puts '53 bottles of beer on the wall, 53 bottles of beer.'
+  puts 'Take one down and pass it around, 52 bottles of beer on the wall.'
+  puts '52 bottles of beer on the wall, 52 bottles of beer.'
+  puts 'Take one down and pass it around, 51 bottles of beer on the wall.'
+  puts '51 bottles of beer on the wall, 51 bottles of beer.'
+  puts 'Take one down and pass it around, 50 bottles of beer on the wall.'
+  puts '50 bottles of beer on the wall, 50 bottles of beer.'
+  puts 'Take one down and pass it around, 49 bottles of beer on the wall.'
+  puts '49 bottles of beer on the wall, 49 bottles of beer.'
+  puts 'Take one down and pass it around, 48 bottles of beer on the wall.'
+  puts '48 bottles of beer on the wall, 48 bottles of beer.'
+  puts 'Take one down and pass it around, 47 bottles of beer on the wall.'
+  puts '47 bottles of beer on the wall, 47 bottles of beer.'
+  puts 'Take one down and pass it around, 46 bottles of beer on the wall.'
+  puts '46 bottles of beer on the wall, 46 bottles of beer.'
+  puts 'Take one down and pass it around, 45 bottles of beer on the wall.'
+  puts '45 bottles of beer on the wall, 45 bottles of beer.'
+  puts 'Take one down and pass it around, 44 bottles of beer on the wall.'
+  puts '44 bottles of beer on the wall, 44 bottles of beer.'
+  puts 'Take one down and pass it around, 43 bottles of beer on the wall.'
+  puts '43 bottles of beer on the wall, 43 bottles of beer.'
+  puts 'Take one down and pass it around, 42 bottles of beer on the wall.'
+  puts '42 bottles of beer on the wall, 42 bottles of beer.'
+  puts 'Take one down and pass it around, 41 bottles of beer on the wall.'
+  puts '41 bottles of beer on the wall, 41 bottles of beer.'
+  puts 'Take one down and pass it around, 40 bottles of beer on the wall.'
+  puts '40 bottles of beer on the wall, 40 bottles of beer.'
+  puts 'Take one down and pass it around, 39 bottles of beer on the wall.'
+  puts '39 bottles of beer on the wall, 39 bottles of beer.'
+  puts 'Take one down and pass it around, 38 bottles of beer on the wall.'
+  puts '38 bottles of beer on the wall, 38 bottles of beer.'
+  puts 'Take one down and pass it around, 37 bottles of beer on the wall.'
+  puts '37 bottles of beer on the wall, 37 bottles of beer.'
+  puts 'Take one down and pass it around, 36 bottles of beer on the wall.'
+  puts '36 bottles of beer on the wall, 36 bottles of beer.'
+  puts 'Take one down and pass it around, 35 bottles of beer on the wall.'
+  puts '35 bottles of beer on the wall, 35 bottles of beer.'
+  puts 'Take one down and pass it around, 34 bottles of beer on the wall.'
+  puts '34 bottles of beer on the wall, 34 bottles of beer.'
+  puts 'Take one down and pass it around, 33 bottles of beer on the wall.'
+  puts '33 bottles of beer on the wall, 33 bottles of beer.'
+  puts 'Take one down and pass it around, 32 bottles of beer on the wall.'
+  puts '32 bottles of beer on the wall, 32 bottles of beer.'
+  puts 'Take one down and pass it around, 31 bottles of beer on the wall.'
+  puts '31 bottles of beer on the wall, 31 bottles of beer.'
+  puts 'Take one down and pass it around, 30 bottles of beer on the wall.'
+  puts '30 bottles of beer on the wall, 30 bottles of beer.'
+  puts 'Take one down and pass it around, 29 bottles of beer on the wall.'
+  puts '29 bottles of beer on the wall, 29 bottles of beer.'
+  puts 'Take one down and pass it around, 28 bottles of beer on the wall.'
+  puts '28 bottles of beer on the wall, 28 bottles of beer.'
+  puts 'Take one down and pass it around, 27 bottles of beer on the wall.'
+  puts '27 bottles of beer on the wall, 27 bottles of beer.'
+  puts 'Take one down and pass it around, 26 bottles of beer on the wall.'
+  puts '26 bottles of beer on the wall, 26 bottles of beer.'
+  puts 'Take one down and pass it around, 25 bottles of beer on the wall.'
+  puts '25 bottles of beer on the wall, 25 bottles of beer.'
+  puts 'Take one down and pass it around, 24 bottles of beer on the wall.'
+  puts '24 bottles of beer on the wall, 24 bottles of beer.'
+  puts 'Take one down and pass it around, 23 bottles of beer on the wall.'
+  puts '23 bottles of beer on the wall, 23 bottles of beer.'
+  puts 'Take one down and pass it around, 22 bottles of beer on the wall.'
+  puts '22 bottles of beer on the wall, 22 bottles of beer.'
+  puts 'Take one down and pass it around, 21 bottles of beer on the wall.'
+  puts '21 bottles of beer on the wall, 21 bottles of beer.'
+  puts 'Take one down and pass it around, 20 bottles of beer on the wall.'
+  puts '20 bottles of beer on the wall, 20 bottles of beer.'
+  puts 'Take one down and pass it around, 19 bottles of beer on the wall.'
+  puts '19 bottles of beer on the wall, 19 bottles of beer.'
+  puts 'Take one down and pass it around, 18 bottles of beer on the wall.'
+  puts '18 bottles of beer on the wall, 18 bottles of beer.'
+  puts 'Take one down and pass it around, 17 bottles of beer on the wall.'
+  puts '17 bottles of beer on the wall, 17 bottles of beer.'
+  puts 'Take one down and pass it around, 16 bottles of beer on the wall.'
+  puts '16 bottles of beer on the wall, 16 bottles of beer.'
+  puts 'Take one down and pass it around, 15 bottles of beer on the wall.'
+  puts '15 bottles of beer on the wall, 15 bottles of beer.'
+  puts 'Take one down and pass it around, 14 bottles of beer on the wall.'
+  puts '14 bottles of beer on the wall, 14 bottles of beer.'
+  puts 'Take one down and pass it around, 13 bottles of beer on the wall.'
+  puts '13 bottles of beer on the wall, 13 bottles of beer.'
+  puts 'Take one down and pass it around, 12 bottles of beer on the wall.'
+  puts '12 bottles of beer on the wall, 12 bottles of beer.'
+  puts 'Take one down and pass it around, 11 bottles of beer on the wall.'
+  puts '11 bottles of beer on the wall, 11 bottles of beer.'
+  puts 'Take one down and pass it around, 10 bottles of beer on the wall.'
+  puts '10 bottles of beer on the wall, 10 bottles of beer.'
+  puts 'Take one down and pass it around, 9 bottles of beer on the wall.'
+  puts '9 bottles of beer on the wall, 9 bottles of beer.'
+  puts 'Take one down and pass it around, 8 bottles of beer on the wall.'
+  puts '8 bottles of beer on the wall, 8 bottles of beer.'
+  puts 'Take one down and pass it around, 7 bottles of beer on the wall.'
+  puts '7 bottles of beer on the wall, 7 bottles of beer.'
+  puts 'Take one down and pass it around, 6 bottles of beer on the wall.'
+  puts '6 bottles of beer on the wall, 6 bottles of beer.'
+  puts 'Take one down and pass it around, 5 bottles of beer on the wall.'
+  puts '5 bottles of beer on the wall, 5 bottles of beer.'
+  puts 'Take one down and pass it around, 4 bottles of beer on the wall.'
+  puts '4 bottles of beer on the wall, 4 bottles of beer.'
+  puts 'Take one down and pass it around, 3 bottles of beer on the wall.'
+  puts '3 bottles of beer on the wall, 3 bottles of beer.'
+  puts 'Take one down and pass it around, 2 bottles of beer on the wall.'
+  puts '2 bottles of beer on the wall, 2 bottles of beer.'
+  puts 'Take one down and pass it around, 1 bottle of beer on the wall.'
+  puts '1 bottle of beer on the wall, 1 bottle of beer.'
+  puts 'Take one down and pass it around, no more bottles of beer on the wall.'
+  puts 'No more bottles of beer on the wall, no more bottles of beer.'
+  puts 'Go to the store and buy some more, 99 bottles of beer on the wall.'
+end
+
+main
+    EOC
+
+    expect(inst.to_md).to eq <<-EOC
+Template Case 1.
+```ruby:*
+def main
+  [[main-body]]
+end
+```
+
+Sing a song ''99 bottles of beer''
+```ruby:main-body
+[[bottles:100]]
+```
+
+General case, sing below
+```ruby:bottles:@
+puts '@0 bottles of beer on the wall, @0 bottles of beer.'
+puts 'Take one down and pass it around, @@(@0 - 1) bottles of beer on the wall.'
+[[bottles:@@(@0 - 1)]]
+```
+
+When number of bottles == 2
+```ruby:bottles:2
+puts '2 bottles of beer on the wall, 2 bottles of beer.'
+puts 'Take one down and pass it around, 1 bottle of beer on the wall.'
+[[bottles:1]]
+```
+
+When number of bottles == 1
+```ruby:bottles:1
+puts '1 bottle of beer on the wall, 1 bottle of beer.'
+puts 'Take one down and pass it around, no more bottles of beer on the wall.'
+[[bottles:0]]
+```
+
+When no rest bottles...
+```ruby:bottles:0
+puts 'No more bottles of beer on the wall, no more bottles of beer.'
+puts 'Go to the store and buy some more, 99 bottles of beer on the wall.'
+```
+
+Finally, call the main function.
+```ruby:* append
+main
+```
+    EOC
+  end
+
+  it 'template case 2' do
+    inst = Literate::Programming.new <<-EOM
+Template Case 2.
+[[*]] =
+  class Main
+    [[main-body]]
+  end
+
+It is free to use @ unless it is followed by a number.
+It is also free to use @@ unless it is followed by left parent.
+[[main-body]] =
+  def initialize
+    @x = @@default_x
+  end
+
+If @@ is followed by left parent, it will evaluated by the rtangle.
+For example, an rtangled below one will equals to '@@default_x = 10'
+[[main-body]] +=
+  @@default_x = @@(1 + 2 + 3 + 4)
+
+How Main.new.run works?
+[[main-body]] +=
+  def run
+    p 'Hello!'
+  end
+
+Finally, instanciate Main and run it!
+[[*]] +=
+  Main.new.run
+    EOM
+
+    expect(inst.to_ruby).to eq <<-EOC
+class Main
+  def initialize
+    @x = @@default_x
+  end
+
+  @@default_x = 10
+
+  def run
+    p 'Hello!'
+  end
+end
+
+Main.new.run
+    EOC
+
+    expect(inst.to_md).to eq <<-EOC
+Template Case 2.
+```ruby:*
+class Main
+  [[main-body]]
+end
+```
+
+It is free to use @ unless it is followed by a number.
+It is also free to use @@ unless it is followed by left parent.
+```ruby:main-body
+def initialize
+  @x = @@default_x
+end
+```
+
+If @@ is followed by left parent, it will evaluated by the rtangle.
+For example, an rtangled below one will equals to '@@default_x = 10'
+```ruby:main-body append
+@@default_x = @@(1 + 2 + 3 + 4)
+```
+
+How Main.new.run works?
+```ruby:main-body append
+def run
+  p 'Hello!'
+end
+```
+
+Finally, instanciate Main and run it!
+```ruby:* append
+Main.new.run
+```
+    EOC
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rspec'
+
+RSpec.configure do |config|
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: literate-programming
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- pixie-grasper
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-11-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Literate Programming for Ruby / Markdown.
+email:
+- himajinn13sei@gmail.com
+executables:
+- rtangle
+- rweave
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/rtangle
+- bin/rweave
+- example/simple-1.wrb
+- example/simple-2.wrb
+- example/simple-3.wrb
+- example/template-1.wrb
+- example/template-2.wrb
+- lib/literate/programming.rb
+- lib/literate/programming/version.rb
+- literate-programming.gemspec
+- spec/lib/literate/programming_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/pixie-grasper/literate-programming
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Literate Programming for Ruby / Markdown.
+test_files:
+- spec/lib/literate/programming_spec.rb
+- spec/spec_helper.rb