pprb 0.9.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Zahary Karadjov, Stefan Dragnev
+
+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/Rakefile

@@ -0,0 +1,67 @@
+require 'rubygems'
+require 'rake'
+require './lib/pprb'
+
+begin
+  require 'jeweler'
+  
+  Jeweler::Tasks.new do |gem|
+    gem.name = "pprb"
+    gem.authors = ["Zahary Karadjov", "Stefan Dragnev"]
+    gem.summary = "PPRB The little preprocessor that could"
+    gem.description = "PPRB is a code preprocessor and text templating engine with minimalistic syntax and strong emphasis on eliminating any code duplication in template files"
+    gem.email = "zahary@gmail.com"
+    gem.homepage = "http://github.com/zah/pprb"    
+    gem.version = PPRB::Version::STRING
+    
+    gem.executable = 'pprb'
+    
+    gem.files.exclude 'CMake'
+    gem.files.exclude 'VisualStudio'
+    
+    gem.add_development_dependency "thoughtbot-shoulda"
+    gem.add_dependency "trollop"    
+  end
+  
+  #Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "pprb #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/bin/pprb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.dirname(__FILE__) + "/../lib"
+
+require 'rubygems'
+require 'pprb'
+require 'trollop'
+
+options = Trollop::options do
+  banner "PPRB #{PPRB::Version::STRING} usage: pprb source [options]"  
+  opt :out, "Output file. Unless supplied prints to STDOUT", :short => 'o', :type => String
+end
+
+source = ARGV.shift
+
+Trollop::die "Please, provide a source file" unless source
+
+open(source, "r") do |input|
+  target_output = PPRB::render input
+  
+  unless options.out
+    puts target_output
+  else
+    open(opts[:out], 'w').write target_output
+  end
+end

data/examples/hw.c

@@ -0,0 +1,29 @@
+> hw = "Hello World"
+
+% rb
+  puts "Arbitrary ruby code is executed here"
+  puts "Functions could be defined"
+
+  def test a, b
+    a + b
+  end 
+-
+
+> # this defines a function, but keeps the standard mode for 
+> # "lines without special symbols are output"
+% def hello_world_template
+  puts("Hello World")
+  % 3.times
+  puts("Hello Loop")
+  -
+-
+
+void main()
+{
+  > hello_world_template
+  
+  % 6.times
+  printf("%d", `test 5, 10`);
+  -
+}
+

data/lib/pprb.rb

@@ -0,0 +1,235 @@
+module PPRB
+  module Version
+    MAJOR = 0
+    MINOR = 9
+    PATCH = 0
+    
+    STRING = [MAJOR, MINOR, PATCH].compact.join('.')
+  end
+  
+  def self.render source
+    PPRB.new(source).run
+  end
+
+  def self.compile source
+    PPRB.new(source)
+  end
+  
+  class PPRB
+    # source is either a File object or a string
+    # start_state is either :pp or :rb
+    def initialize source, start_state = :pp
+      @source = source
+      @path = File.expand_path(source.path) if source.class == File
+
+      @BLOCK = @LINE = @END = @TICKS = ''
+      profile :default
+
+      @ruby_output = ''
+      @target_output = ''
+
+      @input_state = [start_state]
+      @last_emitted = :code
+
+      load_rules
+      source.lines.each { |l| process_line l }
+      @ruby_output << ']' if @last_emitted == :text
+    end
+
+    def run
+      run_and_translate_errors @ruby_output
+      @target_output
+    end
+
+    attr_reader :ruby_output, :target_output
+
+    PROFILES = {
+      :default => {
+        :block => /^%(.*)/,
+        :line  => /^>(.*)/,
+        :end   => /^-$/,
+        :ticks => /`(.*?)`/
+      },
+
+      :c_parsable => {
+        :block => %r[^//\s*%(.*)],
+        :line  => %r[^//\s*>(.*)],
+        :end   => %r[^//\s*-$],
+        :ticks => /\brb_(\w+?)_\b/
+      },
+    }
+
+    def profile filter = nil, prof = nil, overlay = nil
+      # sort-out the passed arguments
+      overlay = filter  if filter.class == Hash
+      overlay = prof    if prof.class == Hash
+      prof    = filter  if filter.class == Symbol
+      filter  = nil     if filter != nil and filter.class != String
+      prof    = nil     if prof != nil and prof.class != Symbol
+
+      raise "No profile or overlay specified" if overlay == nil and prof == nil
+
+      unless filter
+        if prof
+          profile = PROFILES[prof]
+          raise "Unknown profile: #{p}" if profile == nil
+          config profile
+        end
+
+        config overlay if overlay
+      else
+        profile nil, prof, overlay if File.fnmatch(filter, @path)
+      end
+    end
+
+    def config options
+      for key, value in options
+        var = "@#{key.to_s.upcase}"
+        raise "Unknown option: #{key}" if instance_variable_get(var) == nil
+        instance_variable_set var, value
+      end
+    end
+
+  private
+    def process_line line
+      case line.strip
+        when @BLOCK then begin_block $1+"\n"
+        when @END   then end_block
+        when @LINE  then emit $1+"\n", antistate(@input_state.last)
+        else emit line, @input_state.last
+      end
+    end
+
+    def end_block
+      raise "Unexpected block end (no matching block start)." if @input_state.size == 1
+
+      if @input_state.pop == :pp
+        emit "end\n", :rb
+      else
+        emit '', :pp
+      end
+    end
+
+    def begin_block line
+      if @input_state.last == :pp
+        case line
+          when /^\s*rb/ then
+            @input_state.push :rb
+            emit '', :pp
+          when /\bdef|\bfor\b|\bwhile\b|\buntil\b|\bdo\b|\bif\b|\bunless\b|\case\b|\bclass\b|\bmodule\b|\bbegin\b/ then
+            @input_state.push :pp
+            emit line, :rb
+          else
+            @input_state.push :pp
+            emit line.rstrip + " do\n", :rb
+        end
+      else # state :rb
+        @input_state.push :pp
+        emit "begin ", :rb
+        emit line, :pp
+      end
+    end
+
+    def emit line, state
+      if state == :rb
+        if @last_emitted == :text
+          @ruby_output << "]; #{line}"
+          @last_emitted = :code
+        else
+          @ruby_output << line
+        end
+      else # state :pp
+        if @last_emitted == :code
+          @ruby_output << "target_out %[#{escape_code line}"
+          @last_emitted = :text
+        else
+          @ruby_output << escape_code(line)
+        end
+      end
+    end
+
+    def antistate state
+      (state == :pp) ? (:rb) : (:pp)
+    end
+
+    def escape_code str
+      ruby_snippets = []
+      # we don't want anything escaped withing ruby snippets, so first we move them out
+      str.gsub!(@TICKS) { ruby_snippets << $1; "%%#{ruby_snippets.size - 1}" }
+      # after escaping what's necessary, we move them back in
+      str.gsub('\\', '\\\\\\').gsub(']', '\\]').gsub('[', '\\[').gsub(/%%(\d+)/) { "\#{#{ruby_snippets[ $1.to_i ]}}" }
+    end
+
+    def pprb_include_dirs
+      return @pprb_include_dirs if @pprb_include_dirs != nil
+      return [] if @path == nil
+
+      dir = File.dirname @path
+      dirs = []
+
+      while true
+        dirs << dir
+
+        modules_dir = dir + "/pprb_modules"
+        dirs << modules_dir if File.directory? modules_dir
+
+        break if dir == '/' or dir == '/cygdrive'
+
+        parent_dir = File.dirname dir
+        break if parent_dir == dir # this a terminating condition on Windows
+
+        dir = parent_dir
+      end
+
+      @pprb_include_dirs = dirs.reverse
+    end
+
+    def load_rules
+      pprb_include_dirs.each do |dir|
+        next unless File.exist?(rules = "#{dir}/pprb.rules")
+        open(rules) { |f| run_and_translate_errors(f.read, rules) }
+      end
+    end
+    
+    def use file
+      found = false
+
+      pprb_include_dirs.each do |dir|
+        next unless File.exist?(include = "#{dir}/#{file}.pprb.i")
+        found = true
+        open(include) do |file|
+          pprb = PPRB.new(file.read, :rb)
+          run_and_translate_errors pprb.ruby_output, include
+        end
+      end
+
+      raise "Could not find PPRB module '#{file}'" unless found
+    end
+
+    def target_out text
+      @target_output << text
+    end
+
+    def run_and_translate_errors code, filename = @path
+      instance_eval code
+    rescue RuntimeError, Exception => err
+      source_line = nil
+      p err
+      err.backtrace.grep(/\(eval\):(\d+)/) { source_line ||= $1.to_i }
+
+      if source_line
+        $stderr.puts "#{filename}:#{source_line}: error: #{err.to_s}"
+        $stderr.puts
+
+        $stderr.puts "Ruby backtrace:"
+        $stderr.puts err.backtrace
+
+        $stderr.puts "Working directory: #{Dir.pwd}"
+      else
+        raise err
+      end
+    end
+  end
+
+end
+

data/test/pprb_test.rb

@@ -0,0 +1,7 @@
+require 'test_helper'
+
+class PprbTest < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'pprb'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification 
+name: pprb
+version: !ruby/object:Gem::Version 
+  hash: 59
+  prerelease: 
+  segments: 
+  - 0
+  - 9
+  - 0
+  version: 0.9.0
+platform: ruby
+authors: 
+- Zahary Karadjov
+- Stefan Dragnev
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-14 00:00:00 +03:00
+default_executable: pprb
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: trollop
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: PPRB is a code preprocessor and text templating engine with minimalistic syntax and strong emphasis on eliminating any code duplication in template files
+email: zahary@gmail.com
+executables: 
+- pprb
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+files: 
+- .document
+- LICENSE
+- Rakefile
+- bin/pprb
+- examples/hw.c
+- lib/pprb.rb
+- test/pprb_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/zah/pprb
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: PPRB The little preprocessor that could
+test_files: 
+- test/pprb_test.rb
+- test/test_helper.rb