serenity-odt-patched 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 20fefb8225508044218e19271f67eb58a4abe1c5
+  data.tar.gz: 97371f993fa1494e7851f9a4e7dd42da477be5dd
+SHA512:
+  metadata.gz: 74a2fd49d0d3b709a542e95bc1c23ab2200f1e323b8d1d96b3901ece332055e02ea5f71d80f63d2377dc4b7495081f38274be51747b1749f482e37809c62e9fc
+  data.tar.gz: 19c3b6374a777b05189e59c05097fe88b3f0546815892c0888b8ea8fbd5a97056070fdce3fca356c663a4672e0796d677f19a3c11c55be2cbe5d5c1f85762e06

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2010 Tomas Kramar
+
+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,83 @@
+# Patch
+Forked to make small tweaks. The original is at https://github.com/kremso/serenity/tree/master/showcase
+
+## Changes
+1. changed all require 'zip/zip' to require 'zip' to patch bug with rubyzip gem
+
+## Todo
+1. add paramiter to change output of file for render_odt function instead of name_of_template_output.odt
+
+Serenity is an embedded ruby for OpenOffice documents (.odt files). You provide an .odt template with ruby code inside a special markup and the data and Serenity generates the document. If you know erb all of this should sound familiar.
+
+Important Changes
+=================
+
+As of version 0.2.0 serenity is using instance variables in the templates. In previous versions, your instance variables would be converted to local before passing to the template, so while in the code you had `@title = 'Serenity'`, you had to put `{%= title }` in the template to get serenity to work. This has now changed and you need to use instance variables in the templates: `{%= @title }`. Honestly, I don't know why I did it this way in the first place, considering that people are used to instance variables in templates from rails.
+
+Usage
+======
+
+Serenity is best demonstrated with an example. The first picture shows the template with the ruby code, next image shows the generated document. The template, output and the sample script can be found in the showcase directory.
+
+![Serenity template](http://github.com/kremso/serenity/blob/master/showcase/imgs/serenity_template.png?raw=true)
+
+The image above is a screenshot of showcase.odt from the [showcase](http://github.com/kremso/serenity/blob/master/showcase) directory. It's a regular OpenOffice document with ruby code embedded inside a special markup. That ruby code drives the document creation. You can use conditionals, loops, blocks — in fact, the whole ruby language and you can apply any OpenOffice formatting to the outputted variables or static text.
+
+The second line in the template is `{%= @title%}` what means: output the value of variable title. It's bold and big, in fact, it's has the 'Heading 1' style applied. That variable will be replaced in the generated document, but it will still be a 'Heading 1'.
+
+You can now take that template, provide the data and generate the final document:
+
+    require 'rubygems'
+    require 'serenity'
+
+    class Showcase
+      include Serenity::Generator
+
+      Person = Struct.new(:name, :items)
+      Item = Struct.new(:name, :usage)
+
+      def generate_showcase
+        @title = 'Serenity inventory'
+
+        mals_items = [Item.new('Moses Brothers Self-Defense Engine Frontier Model B', 'Lock and load')]
+        mal = Person.new('Malcolm Reynolds', mals_items)
+
+        jaynes_items = [Item.new('Vera', 'Callahan full-bore auto-lock with a customized trigger, double cartridge and thorough gauge'),
+                        Item.new('Lux', 'Ratatata'),
+                        Item.new('Knife', 'Cut-throat')]
+        jayne = Person.new('Jayne Cobb', jaynes_items)
+
+        @crew = [mal, jayne]
+
+        render_odt 'showcase.odt'
+      end
+    end
+
+The key parts are `include Serenity::Generator` and `render_odt`. The data for the template must be provided as instance variables.
+
+Following picture shows the generated document. It's a screenshot of the showcase_output.odt document from the [showcase](http://github.com/kremso/serenity/blob/master/showcase) directory.
+
+![Generated document](http://github.com/kremso/serenity/blob/master/showcase/imgs/serenity_output.png?raw=true)
+
+Installation
+============
+
+    gem install serenity-odt
+
+Yeah, serenity is already taken on gemcutter.
+
+Creating templates
+===================
+
+Templates are created directly in OpenOffice. Ruby code is enclosed in special markup:
+
++ `{%= %}` is for ruby code which should be output to the final document. `to_s` is applied to anything found inside this markup
++ `{% %}` is for everything else — loops, ifs, ends and any other non-outputting code
+
+Any special formatting should by applied directly on the markup. E.g. if you need to ouput the value of variable title in bold font, write `{%= title %}`, select in in OpenOffice and make it bold. See the showcase.odt for more examples.
+
+Contact
+=======
+
+kramar[dot]tomas[at]gmail.com
+

data/Rakefile

@@ -0,0 +1,33 @@
+require 'rake'
+require 'spec/rake/spectask'
+require 'rake/gempackagetask'
+
+task :default => [:spec]
+
+Spec::Rake::SpecTask.new("spec")
+
+spec = Gem::Specification.new do |s|
+  s.name = %q{serenity-odt}
+  s.version = "0.2.2"
+
+  s.authors = ["Tomas Kramar"]
+  s.description = <<-EOF
+    Embedded ruby for OpenOffice Text Document (.odt) files. You provide an .odt template
+    with ruby code in a special markup and the data, and Serenity generates the document.
+    Very similar to .erb files.
+  EOF
+  s.email = %q{kramar.tomas@gmail.com}
+  s.files = Dir.glob('lib/**/*.rb') + %w{README.md Rakefile LICENSE}
+  s.has_rdoc = false
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Embedded ruby for OpenOffice Text Document (.odt) files}
+  s.test_files = Dir.glob('spec/**/*.rb') + Dir.glob('fixtures/*.odt')
+  s.add_dependency('rubyzip', '>= 0.9.1')
+  s.add_dependency('nokogiri', '>= 1.0')
+  s.add_development_dependency('rspec', '>= 1.2.9')
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+end

data/lib/serenity/debug.rb

@@ -0,0 +1,19 @@
+module Serenity
+  module Debug
+    def debug?
+      false
+    end
+
+    def debug_file_path
+      File.join(debug_dir, debug_file_name)
+    end
+
+    def debug_file_name
+      "serenity_debug_#{rand(100)}.rb"
+    end
+
+    def debug_dir
+      File.join(File.dirname(__FILE__), '..', '..', 'debug')
+    end
+  end
+end

data/lib/serenity/escape_xml.rb

@@ -0,0 +1,18 @@
+class String
+  def escape_xml
+    mgsub!([[/&/, '&amp;'], [/</, '&lt;'], [/>/, '&gt;']])
+  end
+
+  def convert_newlines
+    gsub!("\n", '<text:line-break/>')
+    self
+  end
+
+  def mgsub!(key_value_pairs=[].freeze)
+    regexp_fragments = key_value_pairs.collect { |k,v| k }
+    gsub!(Regexp.union(*regexp_fragments)) do |match|
+      key_value_pairs.detect{|k,v| k =~ match}[1]
+    end
+    self
+  end
+end

data/lib/serenity/generator.rb

@@ -0,0 +1,18 @@
+module Serenity
+  module Generator
+    def render_odt template_path, output_path = output_name(template_path)
+      template = Template.new template_path, output_path
+      template.process binding
+    end
+
+    private
+
+    def output_name input
+      if input =~ /(.+)\.odt\Z/
+        "#{$1}_output.odt"
+      else
+        "#{input}_output.odt"
+      end
+    end
+  end
+end

data/lib/serenity/images_processor.rb

@@ -0,0 +1,32 @@
+module Serenity
+  class ImagesProcessor
+    include Debug
+
+    IMAGE_DIR_NAME = "Pictures"
+
+    def initialize(xml_content, context)
+      @replacements = []
+      @images = eval('@images', context)
+      @xml_content = xml_content
+    end
+
+    def generate_replacements
+      require 'nokogiri'
+
+      if @images && @images.kind_of?(Hash)
+        xml_data = Nokogiri::XML(@xml_content)
+
+        @images.each do |image_name, replacement_path|
+          if node = xml_data.xpath("//draw:frame[@draw:name='#{image_name}']/draw:image").first
+            placeholder_path = node.attribute('href').value
+            odt_image_path = ::File.join(IMAGE_DIR_NAME, ::File.basename(placeholder_path))
+
+            @replacements << [odt_image_path, replacement_path]
+          end
+        end
+      end
+
+      @replacements
+    end
+  end
+end

data/lib/serenity/line.rb

@@ -0,0 +1,68 @@
+module Serenity
+  class Line
+    attr_reader :text
+
+    def initialize text
+      @text = text
+    end
+
+    def to_s
+      @text
+    end
+
+    def self.text txt
+      TextLine.new txt
+    end
+
+    def self.code txt
+      CodeLine.new txt
+    end
+
+    def self.string txt
+      StringLine.new txt
+    end
+
+    def self.literal txt
+      LiteralLine.new txt
+    end
+
+  end
+
+  class TextLine < Line
+    def to_buf
+      " _buf << '" << escape_text(@text) << "';"
+    end
+
+    def escape_text text
+      text.gsub(/['\\]/, '\\\\\&')
+    end
+  end
+
+  class CodeLine < Line
+    def to_buf
+      escape_code(@text) << ';'
+    end
+
+    def escape_code code
+      code.mgsub! [[/&apos;/, "'"], [/&gt;/, '>'], [/&lt/, '<'], [/&quot;/, '"'], [/&amp;/, '&']]
+    end
+  end
+
+  class StringLine < CodeLine
+    def to_buf
+      " _buf << (" << escape_code(@text) << ").to_s.escape_xml.convert_newlines;"
+    end
+
+    def convert_newlines text
+      text.gsub("First line", '<text:line-break>')
+    end
+  end
+
+  class LiteralLine < CodeLine
+    def to_buf
+      " _buf << (" << escape_code(@text) << ").to_s;"
+    end
+  end
+
+end
+

data/lib/serenity/node_type.rb

@@ -0,0 +1,7 @@
+module Serenity
+  class NodeType
+    TAG = 1
+    CONTROL = 2
+    TEMPLATE = 3
+  end
+end

data/lib/serenity/odteruby.rb

@@ -0,0 +1,91 @@
+module Serenity
+  class OdtEruby
+    include Debug
+
+    EMBEDDED_PATTERN = /\{%([=%]+)?(.*?)-?%\}/m
+
+    def initialize template
+      @src = convert template
+      if debug?
+        File.open(debug_file_path, 'w') do |f|
+          f << @src
+        end
+      end
+    end
+
+    def evaluate context
+      @src = @src.force_encoding Encoding.default_external
+      eval(@src, context)
+    end
+
+    private
+
+    def convert template
+      src = "_buf = '';"
+      buffer = []
+      buffer_next = []
+
+      template.each_node do |node, type|
+        if !buffer_next.empty?
+          if is_matching_pair?(buffer.last, node)
+            buffer.pop
+            next
+          elsif is_nonpair_tag? node
+            next
+          else
+            buffer << buffer_next
+            buffer.flatten!
+            buffer_next = []
+          end
+        end
+
+        if type == NodeType::CONTROL
+          buffer_next = process_instruction(node)
+        else
+          buffer << process_instruction(node)
+          buffer.flatten!
+        end
+      end
+
+      buffer.each { |line| src << line.to_buf }
+      src << "\n_buf.to_s\n"
+    end
+
+    def process_instruction text
+      #text = text.strip
+      pos = 0
+      src = []
+
+      text.scan(EMBEDDED_PATTERN) do |indicator, code|
+        m = Regexp.last_match
+        middle = text[pos...m.begin(0)]
+        pos  = m.end(0)
+        src << Line.text(middle) unless middle.empty?
+
+        if !indicator            # <% %>
+          src << Line.code(code)
+        elsif indicator == '='   # <%= %>
+          src << Line.string(code)
+        elsif indicator == '%'   # <%% %>
+          src << Line.literal(code)
+        end
+      end
+
+      rest = pos == 0 ? text : text[pos..-1]
+
+      src << Line.text(rest) unless rest.nil? or rest.empty?
+      src
+    end
+
+    def is_nonpair_tag? tag
+      tag =~ /<.+?\/>/
+    end
+
+    def is_matching_pair? open, close
+      open = open.to_s.strip
+      close = close.to_s.strip
+
+      close == "</#{open[1, close.length - 3]}>"
+    end
+  end
+end

data/lib/serenity/template.rb

@@ -0,0 +1,38 @@
+require 'zip'
+require 'fileutils'
+
+module Serenity
+  class Template
+    attr_accessor :template
+
+    def initialize(template, output)
+      FileUtils.cp(template, output)
+      @template = output
+    end
+
+    def process context
+      tmpfiles = []
+      Zip::ZipFile.open(@template) do |zipfile|
+        %w(content.xml styles.xml).each do |xml_file|
+          content = zipfile.read(xml_file)
+
+          # Images replacement
+          images_replacements = ImagesProcessor.new(content, context).generate_replacements
+          images_replacements.each do |r|
+            zipfile.replace(r.first, r.last)
+          end
+
+          odteruby = OdtEruby.new(XmlReader.new(content))
+          out = odteruby.evaluate(context)
+          out.force_encoding Encoding.default_external
+
+          tmpfiles << (file = Tempfile.new("serenity"))
+          file << out
+          file.close
+
+          zipfile.replace(xml_file, file.path)
+        end
+      end
+    end
+  end
+end

data/lib/serenity/xml_reader.rb

@@ -0,0 +1,31 @@
+module Serenity
+  class XmlReader
+
+    def initialize src
+      @src = src.force_encoding("UTF-8")
+    end
+
+    def each_node
+      last_match_pos = 0
+
+      @src.scan(/<.*?>/) do |node|
+        m = Regexp.last_match
+        if m.begin(0) > last_match_pos
+          text = @src[last_match_pos...m.begin(0)]
+          yield text, node_type(text) if text.gsub(/\s+/, '') != ''
+        end
+
+        last_match_pos = m.end(0)
+        yield node, NodeType::TAG
+      end
+    end
+
+    def node_type text
+      if text =~ /\s*\{%[^=#].+?%\}\s*/
+        NodeType::CONTROL
+      else
+        NodeType::TEMPLATE
+      end
+    end
+  end
+end

data/lib/serenity.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'serenity/line'
+require 'serenity/debug'
+require 'serenity/node_type'
+require 'serenity/escape_xml'
+require 'serenity/odteruby'
+require 'serenity/images_processor'
+require 'serenity/template'
+require 'serenity/xml_reader'
+require 'serenity/generator'

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: serenity-odt-patched
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- kremso, Tyrel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-10-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+description: Embedded ruby for OpenOffice/LibreOffice Text Document (.odt) files.
+  You provide an .odt template with ruby code in a special markup and the data, and
+  Serenity generates the document. Very similar to .erb files.
+email: ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/serenity.rb
+- lib/serenity/debug.rb
+- lib/serenity/escape_xml.rb
+- lib/serenity/generator.rb
+- lib/serenity/images_processor.rb
+- lib/serenity/line.rb
+- lib/serenity/node_type.rb
+- lib/serenity/odteruby.rb
+- lib/serenity/template.rb
+- lib/serenity/xml_reader.rb
+homepage: https://github.com/MuTechIndustries/serenity
+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: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Parse ODT file and substitutes placeholders like ERb. With small tweeks
+test_files: []