cf-rtex 2.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2cbc2f55ee737e1a2975f05d000d78a88b833c02334346a3d3231117b0df84f6
+  data.tar.gz: 9317e517b43d544033e96fd0fa8d6df79229584f9b88cf165257165f33057c25
+SHA512:
+  metadata.gz: 000efdd44938b7280c5a07ff1a0a2729d9b654a7a03447aceb6aa3c5f91b1674edf35a0368ea6b8f778d9d854a7e032ad2c0fd47bc78a3dedd6415985fd8b942
+  data.tar.gz: d43b5912f6888dced779a3ce1ee6d8cee6f78dd5b834955e8aeccebb95b36b5e5dae273fd449c2e662f83ef1d6453fcd56b79c0a470b17911094acffdbdc5dd3

data/README.rdoc

@@ -0,0 +1,53 @@
+== Changes from the original
+* Upgraded for rails 3/4 integration, removed merb and standalone support
+* Optionaly setting a password on generated PDFs using the pdf-toolkit gem
+* Writes last generated intermediate latex document to tmp/last_document.latex in development mode
+* Considers all latex escaped text html_safe
+* latex_simple_format method added so that new lines can be rendered properly in latex.
+
+= RTeX: TeX/PDF Generation for Ruby
+
+Project homepage (FAQ, manual, documentation, contact info): http://rtex.rubyforge.org
+
+Original source repository at: http://github.com/bruce/rtex
+
+== Dependencies
+
+* pdflatex executable, available in modern teTeX distributions
+* Requires Rails >= 2.0.1 if used as a plugin.
+
+== Usage
+
+For use as a standalone executable, see `rtex --help'
+
+For use as a Rails plugin, see README_RAILS.rdoc
+
+== More Information
+
+Additional help may be available at the project homepage,
+http://rtex.rubyforge.org
+
+== License
+
+  (The MIT License)
+
+  Copyright (c) 2006-2008 Bruce Williams, Wiebe Cazemier
+
+  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,22 @@
+require 'rubygems'
+require 'echoe'
+
+require File.dirname(__FILE__) << "/lib/rtex/version"
+
+Echoe.new 'rtex' do |p|
+  p.version = RTeX::Version::STRING
+  p.author = 'Aaron Pederson'
+  p.email  = 'aaron.pederson@castingnetworks.com'
+  p.project = 'cf-rtex'
+  p.summary = "LaTeX preprocessor for PDF generation; Rails plugin"
+  p.url = "http://rtex.rubyforge.org"
+  p.include_rakefile = true
+  p.development_dependencies = %w(Shoulda echoe)
+  p.rcov_options = '--exclude gems --exclude version.rb --sort coverage --text-summary --html -o coverage'
+  p.ignore_pattern = /^(pkg|doc|site)|\.svn|CVS|\.bzr|\.DS|\.git/
+  p.rubygems_version = nil
+end
+
+task :coverage do
+  system "open coverage/index.html" if PLATFORM['darwin']
+end

data/lib/rtex/document.rb

@@ -0,0 +1,172 @@
+require 'erb'
+require 'ostruct'
+require 'tmpdir'
+
+module RTeX
+  
+  class Document
+    
+    extend Escaping
+        
+    class FilterError < ::StandardError; end
+    class GenerationError < ::StandardError; end
+    class ExecutableNotFoundError < ::StandardError; end
+    
+    # Default options
+    # [+:preprocess+] Are we preprocessing? Default is +false+
+    # [+:preprocessor+] Executable to use during preprocessing (generating TOCs, etc). Default is +latex+
+    # [+:shell_redirect+] Option redirection for shell output (eg, +"> /dev/null 2>&1"+ ). Default is +nil+.
+    # [+:tmpdir+] Location of temporary directory (default: +Dir.tmpdir+)
+    def self.options
+      @options ||= {
+        :preprocessor => 'latex',
+        :preprocess => false,
+        :processor => 'pdflatex',
+        # 
+        :shell_redirect => nil,
+        # Temporary Directory
+        :tempdir => Dir.tmpdir
+      }
+    end
+        
+    def initialize(content, options={})
+      @options = self.class.options.merge(options)
+      if @options[:processed]
+        @source = content
+      else
+        @erb = ERB.new(content)
+      end
+    end
+    
+    # Get the source for the entire 
+    def source(binding=nil) #:nodoc:
+      @source ||= wrap_in_layout do
+        filter @erb.result(binding)
+      end
+    end
+    
+    # Process through defined filter
+    def filter(text) #:nodoc:
+      return text unless @options[:filter]
+      if (process = RTeX.filters[@options[:filter]])
+        process[text]
+      else
+        raise FilterError, "No `#{@options[:filter]}' filter"
+      end
+    end
+    
+    # Wrap content in optional layout
+    def wrap_in_layout #:nodoc:
+      if @options[:layout]
+        ERB.new(@options[:layout]).result(binding)
+      else
+        yield
+      end
+    end
+    
+    # Generate PDF from 
+    # call-seq:
+    #   to_pdf # => PDF in a String
+    #   to_pdf { |filename| ... }
+    def to_pdf(binding=nil, &file_handler)
+      process_pdf_from(source(binding), &file_handler)
+    end
+    
+    def processor #:nodoc:
+      @processor ||= check_path_for @options[:processor]
+    end
+    
+    def preprocessor #:nodoc:
+      @preprocessor ||= check_path_for @options[:preprocessor]
+    end
+    
+    def system_path #:nodoc:
+      ENV['PATH']
+    end
+        
+    #######
+    private
+    #######
+    
+    # Verify existence of executable in search path
+    def check_path_for(command)
+      unless FileTest.executable?(command) || system_path.split(":").any?{ |path| FileTest.executable?(File.join(path, command))}
+        raise ExecutableNotFoundError, command
+      end
+      command
+    end
+    
+    # Basic processing
+    def process_pdf_from(input, &file_handler)
+      Tempdir.open(@options[:tempdir]) do |tempdir|
+        prepare input
+        if generating?
+          preprocess! if preprocessing?
+          process!
+          verify!
+        end
+        if file_handler
+          yield full_path_in(tempdir.path)
+        else
+          result_as_string
+        end
+      end
+    end
+    
+    def process!
+      unless `#{processor} --interaction=nonstopmode '#{source_file}' #{@options[:shell_redirect]}`
+        raise GenerationError, "Could not generate PDF using #{processor}"      
+      end
+    end
+    
+    def preprocess!
+      unless `#{preprocessor} --interaction=nonstopmode '#{source_file}' #{@options[:shell_redirect]}`
+        raise GenerationError, "Could not preprocess using #{preprocessor}"      
+      end
+    end
+    
+    def preprocessing?
+      @options[:preprocess]
+    end
+        
+    def source_file
+      @source_file ||= file(:tex)
+    end
+    
+    def log_file
+      @log_file ||= file(:log)
+    end
+    
+    def result_file
+      @result_file ||= file(@options[:tex] ? :tex : :pdf)
+    end
+    
+    def file(extension)
+      "document.#{extension}"
+    end
+    
+    def generating?
+      !@options[:tex]
+    end
+    
+    def verify!
+      unless File.exists?(result_file)
+        raise GenerationError, "Could not find result PDF #{result_file} after generation.\nCheck #{File.expand_path(log_file)}"
+      end
+    end
+    
+    def prepare(input)
+      File.open(source_file, 'wb') { |f| f.puts input }
+    end
+    
+    def result_as_string
+      File.open(result_file, 'rb') { |f| f.read }
+    end
+    
+    def full_path_in(directory)
+      File.expand_path(File.join(directory, result_file))
+    end
+    
+  end
+
+end

data/lib/rtex/escaping.rb

@@ -0,0 +1,33 @@
+module RTeX
+  
+  module Escaping
+    
+    # Escape text using +replacements+
+    def escape(text)
+      replacements.inject(text.to_s) do |corpus, (pattern, replacement)|
+        corpus.gsub(pattern, replacement)
+      end.html_safe
+    end
+
+    def simple_format(text)
+      text=escape(text)
+      text.gsub(/([\n])/, '\newline{}').html_safe
+    end
+    
+    # List of replacements
+    def replacements
+      @replacements ||= [
+        [/([{}])/,    '\\\\\1'],
+        [/\\/,        '\textbackslash{}'],
+        [/\^/,        '\textasciicircum{}'],
+        [/~/,         '\textasciitilde{}'],
+        [/\|/,        '\textbar{}'],
+        [/\</,        '\textless{}'],
+        [/\>/,        '\textgreater{}'],
+        [/([_$&%#])/, '\\\\\1']
+      ]
+    end
+    
+  end
+  
+end

data/lib/rtex/helpers.rb

@@ -0,0 +1,22 @@
+module RTeX
+  module Helpers
+    def latex_escape(*args)
+      # Since Rails' I18n implementation aliases l() to localize(), LaTeX
+      # escaping should only be done if RTeX is doing the rendering.
+      # Otherwise, control should be be passed to localize().
+      if Thread.current[:_rendering_rtex]
+        RTeX::Document.escape(*args)
+      else
+        localize(*args)
+      end
+    end
+
+    def latex_simple_format(*args)
+      RTeX::Document.simple_format(*args)
+    end
+
+    alias :l :latex_escape
+    alias :sf :latex_simple_format
+
+  end
+end

data/lib/rtex/railtie.rb

@@ -0,0 +1,19 @@
+module RTeX
+  class Railtie < Rails::Railtie
+    initializer "rtex.add_template_handler" do 
+      ActionView::Template.register_template_handler("rtex", 
+        RTeX::TemplateHandler)
+    end
+    initializer "rtex.add_controller_methods" do
+      ActionController::Base.send(:include, RTeX::ControllerMethods)
+    end
+    initializer "rtex.add_helper_methods" do
+      ActionView::Base.send(:include, RTeX::Helpers)
+    end
+    initializer "rtex.set_tempdir" do 
+      ActiveSupport.on_load(:action_controller) do
+        Document.options[:tempdir] = Rails.root.join("tmp")
+      end
+    end
+  end
+end

data/lib/rtex/tempdir.rb

@@ -0,0 +1,52 @@
+require 'fileutils'
+
+module RTeX
+  
+  class Tempdir #:nodoc:
+        
+    def self.open(parent_path=RTeX::Document.options[:tempdir])
+      tempdir = new(parent_path)
+      FileUtils.mkdir_p tempdir.path
+      result = Dir.chdir(tempdir.path) do
+        yield tempdir
+      end
+      # We don't remove the temporary directory when exceptions occur,
+      # so that the source of the exception can be dubbed (logfile kept)
+      tempdir.remove!
+      result
+    end
+    
+    def initialize(parent_path, basename='rtex')
+      @parent_path = parent_path
+      @basename = basename
+      @removed = false
+    end
+    
+    def path
+      @path ||= File.expand_path(File.join(@parent_path, 'rtex', "#{@basename}-#{uuid}"))
+    end
+    
+    def remove!
+      return false if @removed
+      FileUtils.rm_rf path
+      @removed = true
+    end
+    
+    #######
+    private
+    #######
+    
+    # Try using uuidgen, but if that doesn't work drop down to
+    # a poor-man's UUID; timestamp, thread & object hashes
+    # Note: I don't want to add any dependencies (so no UUID library)
+    def uuid
+      if (result = `uuidgen`.strip rescue nil).empty?
+        "#{Time.now.to_i}-#{Thread.current.hash}-#{hash}"
+      else
+        result
+      end
+    end
+    
+  end
+  
+end

data/lib/rtex/template_handler.rb

@@ -0,0 +1,71 @@
+
+module RTeX
+
+  class TemplateHandler < ActionView::Template::Handlers::ERB
+    def call(template)
+      super.sub(/^(?!#)/m, "Thread.current[:_rendering_rtex] = true;\n")
+    end   
+  end
+
+  module ControllerMethods
+    def self.included(base)
+      base.alias_method_chain :render, :rtex 
+    end
+
+    def render_with_rtex(options = nil, *args, &block)
+      # pp args
+      orig = render_without_rtex(options, *args, &block)
+      # CF HACK
+      
+      File.open(Rails.root.join("tmp","last_document.latex"), "w"){|f| f.puts orig.to_s.force_encoding('UTF-8')} if Rails.env.development?
+      
+      # old:
+      # File.open(Rails.root.join("tmp","last_document.latex"), "w"){|f| f.puts orig} if Rails.env.development?
+
+      # END CF HACK
+      if Thread.current[:_rendering_rtex] == true
+        Thread.current[:_rendering_rtex] = false
+        options = {} if options.class != Hash        
+        Document.new(orig, options.merge(:processed => true)).to_pdf do |f|
+          serve_file = Tempfile.new('rtex-pdf')
+
+          if options[:user_pw].present? && options[:owner_pw].present?
+            pdf_path = File.dirname(f)
+            pdf_name = File.basename(f, '.pdf')
+            encrypted_filename = File.join(pdf_path, "#{pdf_name}_encrypted.pdf")
+            owner_pw = options[:owner_pw].is_a?(Proc)? options[:owner_pw].call : options[:owner_pw]
+            user_pw = options[:user_pw].is_a?(Proc)? options[:user_pw].call : options[:user_pw]
+
+            pdftk_commands = [
+              f,
+              'output', encrypted_filename,
+              'owner_pw', owner_pw,
+              'user_pw', user_pw
+            ]
+
+            unless options[:disallow_printing]
+              pdftk_commands << 'allow'
+              pdftk_commands << 'printing'
+            end
+
+            PDF::Toolkit.pdftk(*pdftk_commands)
+            f = encrypted_filename
+          end
+
+          FileUtils.mv f, serve_file.path
+          send_file serve_file.path,
+            :disposition => (options[:disposition] rescue nil) || 'inline',
+            :url_based_filename => true,
+            :filename => (options[:filename] rescue nil),
+            :type => "application/pdf",
+            :length => File.size(serve_file.path),
+            :stream => false
+          serve_file.close
+        end   
+      end
+      orig
+    end    
+
+  end
+
+end

data/lib/rtex/version.rb

@@ -0,0 +1,77 @@
+# (The MIT License)
+# 
+# Copyright (c) 2008 Jamis Buck <jamis@37signals.com>,
+#               with modifications by Bruce Williams <bruce@codefluency.com>
+# 
+# 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.
+module RTeX
+  
+    
+  # A class for describing the current version of a library. The version
+  # consists of three parts: the +major+ number, the +minor+ number, and the
+  # +tiny+ (or +patch+) number.
+  class Version
+  
+    # A convenience method for instantiating a new Version instance with the
+    # given +major+, +minor+, and +tiny+ components.
+    def self.[](major, minor, tiny)
+      new(major, minor, tiny)
+    end
+    
+    attr_reader :major, :minor, :tiny
+
+    # Create a new Version object with the given components.
+    def initialize(major, minor, tiny)
+      @major, @minor, @tiny = major, minor, tiny
+    end
+
+    # Compare this version to the given +version+ object.
+    def <=>(version)
+      to_i <=> version.to_i
+    end
+
+    # Converts this version object to a string, where each of the three
+    # version components are joined by the '.' character. E.g., 2.0.0.
+    def to_s
+      @to_s ||= [@major, @minor, @tiny].join(".")
+    end
+
+    # Converts this version to a canonical integer that may be compared
+    # against other version objects.
+    def to_i
+      @to_i ||= @major * 1_000_000 + @minor * 1_000 + @tiny
+    end
+    
+    def to_a
+      [@major, @minor, @tiny]
+    end
+
+    MAJOR = 2
+    MINOR = 1
+    TINY  = 1
+    
+    # The current version as a Version instance
+    CURRENT = new(MAJOR, MINOR, TINY)
+    # The current version as a String
+    STRING = CURRENT.to_s
+        
+  end
+  
+end

data/lib/rtex.rb

@@ -0,0 +1,7 @@
+require 'rtex/tempdir.rb'
+require 'rtex/escaping.rb'
+require 'rtex/document.rb'
+require 'rtex/template_handler.rb'
+require 'rtex/helpers.rb'
+require 'rtex/railtie.rb'
+require 'rtex/version.rb'

data/test/document_test.rb

@@ -0,0 +1,86 @@
+require File.dirname(__FILE__) << '/test_helper'
+
+class DocumentTest < Test::Unit::TestCase
+
+  context "Document Generation" do
+  
+    setup do
+      change_tmpdir_for_testing
+    end
+  
+    should "have a to_pdf method" do
+      assert document(:first).respond_to?(:to_pdf)
+    end
+    
+    context "when escaping" do
+      setup do
+        @obj = Object.new
+        def @obj.to_s
+          '\~'
+        end
+        @escaped = '\textbackslash{}\textasciitilde{}'
+      end
+      should "escape character" do
+        assert_equal @escaped, RTeX::Document.escape(@obj.to_s)
+      end
+      should "convert argument to string before attempting escape" do        
+        assert_equal @escaped, RTeX::Document.escape(@obj)
+      end
+    end
+    
+    should "use a to_pdf block to move a file to a relative path" do
+      begin
+        path = File.expand_path(File.dirname(__FILE__) << '/tmp/this_is_relative_to_pwd.pdf')
+        document(:first).to_pdf do |filename|
+          assert_nothing_raised do
+            FileUtils.move filename, path
+          end
+          assert File.exists?(path)
+        end
+      ensure
+        FileUtils.rm path rescue nil
+      end
+    end
+  
+    should "generate PDF and return as a string" do
+      @author = 'Foo'
+      assert_equal '%PDF', document(:first).to_pdf(binding)[0, 4]
+    end
+  
+    should "generate TeX source and return as a string with debug option" do
+      @author = 'Foo'
+      assert_not_equal '%PDF', document(:first, :tex => true).to_pdf(binding)[0, 4]    
+    end
+  
+    should "generate PDF and give access to file directly" do
+      @author = 'Foo'
+      data_read = nil
+      invocation_result = document(:first).to_pdf(binding) do |filename|
+        data_read = File.open(filename, 'rb') { |f| f.read }
+        :not_the_file_contents
+      end
+      assert_equal '%PDF', data_read[0, 4]
+      assert_equal :not_the_file_contents, invocation_result
+    end
+  
+    should "generate TeX source and give access to file directly" do
+      @author = 'Foo'
+      data_read = nil
+      invocation_result = document(:first, :tex => true).to_pdf(binding) do |filename|
+        data_read = File.open(filename, 'rb') { |f| f.read }
+        :not_the_file_contents
+      end
+      assert_not_equal '%PDF', data_read[0, 4]
+      assert_equal :not_the_file_contents, invocation_result
+    end
+  
+    should "wrap in a layout using `yield'" do
+      doc = document(:fragment, :layout => 'testing_layout[<%= yield %>]')
+      @name = 'ERB'
+      source = doc.source(binding)
+      assert source =~ /^testing_layout.*?ERB, Fragmented/
+    end
+  
+  end
+  
+end

data/test/filter_test.rb

@@ -0,0 +1,24 @@
+require File.dirname(__FILE__) << '/test_helper'
+
+class FilterTest < Test::Unit::TestCase
+
+  context "Filtering Documents" do
+  
+    should "filter through textile" do
+      doc = document('text.textile', :filter => 'textile')
+      source = doc.source(binding)
+      assert source.include?('\item')
+    end
+  
+    should "not affect layouts" do
+      doc = document('text.textile',
+              :filter => 'textile',
+              :layout => "* layout\n* is\n<%= yield %>")
+      source = doc.source(binding)
+      assert source.include?("* layout"), "filtered layout"
+      assert source.include?('\item'), "didn't filter content"
+    end
+
+  end
+  
+end

data/test/fixtures/first.tex

@@ -0,0 +1,50 @@
+% This percent indicates a comment.
+% This is a very simple latex article that introduces the way 
+% equations are typeset.  Do this in linux:
+%
+% latex first.tex
+% latex first.tex
+% xdvi first.dvi
+% dvips -o first.ps first.dvi
+% gv first.ps
+% lpr first.ps
+% pdflatex first.tex
+% acroread first.pdf
+\documentclass[12pt]{article}
+\title{First \LaTeX} 
+\author{Joe Student}
+\date{\today}
+
+\begin{document}
+
+\maketitle
+
+\abstract{This is a very simple example of using \LaTeX\ for typesetting.
+The procedure for typesetting equations is introduced.}
+\begin{sdsd}
+\end{bar}
+
+\section{A few equations}
+Equations can be typeset inline like so: $\vec{F}=m\vec{a}$ .
+Equations can also be separated form the text: $$ \vec{F}=m\vec{a} \ . $$
+Notice the punctuation, the ``.'', had to be included with the equation. 
+Equations can also have a number assigned and a label attached,
+as in the following:
+\begin{equation}
+\frac{D\vec{\omega}}{Dt} =
+( \vec{\omega} + \vec{\Omega}) \cdot \nabla  \vec{U}
++ \frac{1}{\rho^2} \nabla \rho \times \nabla p 
++ \nu \nabla^2  \vec{\omega} 
+\label{vorteq}
+\end{equation}
+The vorticity equation (\ref{vorteq}) is referenced by label,
+not by number.  The numbers may change as the document grows and
+more equations are added.
+
+New paragraphs are indicated with a blank line in the source code.
+
+\section{The End}
+
+Further examples of \LaTeX\ can be found at {\tt it.metr.ou.edu}
+
+\end{document}

data/test/fixtures/first.tex.erb

@@ -0,0 +1,48 @@
+% This percent indicates a comment.
+% This is a very simple latex article that introduces the way 
+% equations are typeset.  Do this in linux:
+%
+% latex first.tex
+% latex first.tex
+% xdvi first.dvi
+% dvips -o first.ps first.dvi
+% gv first.ps
+% lpr first.ps
+% pdflatex first.tex
+% acroread first.pdf
+\documentclass[12pt]{article}
+\title{First \LaTeX} 
+\author{<%= @author %>}
+\date{\today}
+
+\begin{document}
+
+\maketitle
+
+\abstract{This is a very simple example of using \LaTeX\ for typesetting.
+The procedure for typesetting equations is introduced.}
+
+\section{A few equations}
+Equations can be typeset inline like so: $\vec{F}=m\vec{a}$ .
+Equations can also be separated form the text: $$ \vec{F}=m\vec{a} \ . $$
+Notice the punctuation, the ``.'', had to be included with the equation. 
+Equations can also have a number assigned and a label attached,
+as in the following:
+\begin{equation}
+\frac{D\vec{\omega}}{Dt} =
+( \vec{\omega} + \vec{\Omega}) \cdot \nabla  \vec{U}
++ \frac{1}{\rho^2} \nabla \rho \times \nabla p 
++ \nu \nabla^2  \vec{\omega} 
+\label{vorteq}
+\end{equation}
+The vorticity equation (\ref{vorteq}) is referenced by label,
+not by number.  The numbers may change as the document grows and
+more equations are added.
+
+New paragraphs are indicated with a blank line in the source code.
+
+\section{The End}
+
+Further examples of \LaTeX\ can be found at {\tt it.metr.ou.edu}
+
+\end{document}

data/test/fixtures/fragment.tex.erb

@@ -0,0 +1 @@
+\par <%= @name %>, Fragmented

data/test/fixtures/text.textile

@@ -0,0 +1,4 @@
+This is a list:
+* One
+* Two
+* _three_

data/test/tempdir_test.rb

@@ -0,0 +1,67 @@
+require File.dirname(__FILE__) << '/test_helper'
+
+class TempdirTest < Test::Unit::TestCase
+
+  context "Creating a temporary directory" do
+  
+    setup do
+      change_tmpdir_for_testing
+    end
+  
+    should "change directory" do
+      old_location = Dir.pwd
+      block_location = nil
+      RTeX::Tempdir.open do
+        assert_not_equal old_location, Dir.pwd
+        block_location = Dir.pwd
+      end
+      assert_equal old_location, Dir.pwd
+      assert !File.exists?(block_location)
+    end
+  
+    should "use a 'rtex' name prefix" do
+      RTeX::Tempdir.open do
+        assert_equal 'rtex-', File.basename(Dir.pwd)[0,5]
+      end
+    end
+  
+    should "remove the directory after use if no exception occurs by default" do
+      path = nil
+      RTeX::Tempdir.open do
+        path = Dir.pwd
+        assert File.exists?(path)
+      end
+      assert !File.exists?(path)
+    end
+  
+    should "return the result of the last statement if automatically removing the directory" do
+      result = RTeX::Tempdir.open do
+        :last
+      end
+      assert_equal :last, :last
+    end
+  
+    should "return the result of the last statment if not automatically removing the directory" do
+      tempdir = nil # to capture value
+      result = RTeX::Tempdir.open do |tempdir|
+        :last
+      end
+      tempdir.remove!
+      assert_equal :last, :last
+    end
+  
+    should "not remove the directory after use if an exception occurs" do
+      path = nil
+      assert_raises RuntimeError do
+        RTeX::Tempdir.open do
+          path = Dir.pwd
+          assert File.directory?(path)
+          raise "Test exception!"
+        end
+      end
+      assert File.directory?(path)
+    end
+  
+  end
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,26 @@
+require 'test/unit'
+
+require 'rubygems'
+begin
+  require 'shoulda'
+  require 'flexmock/test_unit'
+rescue LoadError
+  abort "the `Shoulda' and `flexmock' gems are required for testing"
+end
+
+require File.dirname(__FILE__) << '/../lib/rtex'
+
+class Test::Unit::TestCase
+  
+  def change_tmpdir_for_testing
+    flexmock(Dir).should_receive(:tmpdir).and_return(File.dirname(__FILE__) << '/tmp')
+  end
+
+  def document(name, options={})
+    name = name.kind_of?(Symbol) ? "#{name}.tex.erb" : name
+    template = File.read(File.dirname(__FILE__) << "/fixtures/#{name}")
+    RTeX::Document.new(template, options)
+  end
+
+end
+  

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: cf-rtex
+version: !ruby/object:Gem::Version
+  version: 2.1.2
+platform: ruby
+authors:
+- Aaron Pederson
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-07-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: pdf-toolkit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Description of Rtex.
+email:
+- aaron.pederson@castingnetworks.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.rdoc
+- Rakefile
+- lib/rtex.rb
+- lib/rtex/document.rb
+- lib/rtex/escaping.rb
+- lib/rtex/helpers.rb
+- lib/rtex/railtie.rb
+- lib/rtex/tempdir.rb
+- lib/rtex/template_handler.rb
+- lib/rtex/version.rb
+- test/document_test.rb
+- test/filter_test.rb
+- test/fixtures/first.tex
+- test/fixtures/first.tex.erb
+- test/fixtures/fragment.tex.erb
+- test/fixtures/text.textile
+- test/tempdir_test.rb
+- test/test_helper.rb
+homepage: https://github.com/casting-frontier/cf-rtex
+licenses: []
+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: []
+rubygems_version: 3.3.11
+signing_key:
+specification_version: 4
+summary: Summary of Rtex.
+test_files:
+- test/document_test.rb
+- test/filter_test.rb
+- test/fixtures/first.tex
+- test/fixtures/first.tex.erb
+- test/fixtures/fragment.tex.erb
+- test/fixtures/text.textile
+- test/tempdir_test.rb
+- test/test_helper.rb