odf-report 0.5.1 → 0.7.1

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    YzhiYWE2MTU5OTRjZWQ2NGExZDc1ZDRjMGUzM2ZlZWU1ZWY4ZWUwNg==
-  data.tar.gz: !binary |-
-    YTBkNGEzZjE1NmNkMjc3MTdiNjdmNjZhMDI4ZjAzYjg5NTU0NjJjZA==
+SHA256:
+  metadata.gz: b953733bc99e0c7e77fc57a5b9e53f38756cc926794df2a8bcfa66156469e1e2
+  data.tar.gz: 69d20e56f5c14cf55c8ddad18019dc656a35a1b247f2d8b07ad0d64ea90cfad0
 SHA512:
-  metadata.gz: !binary |-
-    ZjU1YzA0ZjY5YmRlMmJhZTE4YmM0NjY5MDQ0MDkyNGFlYjU1MGYzOTM1NTk0
-    Y2IyODBlMmEwNWRiODgzZmViMDI1MGE1MmJhODUxYzc3MWY4NDdlNzZmYTEw
-    YzVmZDA5NDIwNTVlYTRjMTQ0YTM1ZTQ0N2JkOTE4MDIyYThkOTY=
-  data.tar.gz: !binary |-
-    MDNlY2U4ZTU2NTUxZTYzYTZlMWZkN2YxYjI1YTE0YTFlODBmMzFiOTdmMThk
-    YzYyMWQwN2QzZDcxZDhmZjE3ZmQ1ZjFhY2E0NTY5MzcxM2M4NWE3NmEzZTBk
-    ZTI1MjI2OGJmZGMzZGIzYTcwZDYxNjYzYzYyYTgzYjhkNDFmNDc=
+  metadata.gz: 8e14bbf17762213635726cf0a6c8270ce9d701e7315e180a1d46b142ae616ddb20e327aa57f67effc02700da73ce452e310c0c77eb861666039b92b83ffcd6a8
+  data.tar.gz: 18de0c6ca80d7740bbfee94d02cf99e2ea1a6153861b68bdd41a0303b9159dca09899b3123b18a965b608341e754f8ca018599e4ad985a18166832beb974314b

data/.github/workflows/gem-push.yml

@@ -0,0 +1,40 @@
+name: Ruby Gem
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby 2.6
+      uses: actions/setup-ruby@v1
+      with:
+        version: 2.6.x
+
+#     - name: Publish to GPR
+#       run: |
+#         mkdir -p $HOME/.gem
+#         touch $HOME/.gem/credentials
+#         chmod 0600 $HOME/.gem/credentials
+#         printf -- "---\n:github: Bearer ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+#         gem build *.gemspec
+#         gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
+#       env:
+#         GEM_HOST_API_KEY: ${{secrets.GPR_AUTH_TOKEN}}
+#         OWNER: username
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: ${{secrets.RUBYGEMS_AUTH_TOKEN}}

data/.gitignore

@@ -3,4 +3,6 @@ pckg
 doc
 *.gem
 test/result
+spec/result
 Gemfile.lock
+.DS_Store

data/.rspec

@@ -0,0 +1,4 @@
+--color
+--warnings
+--require spec_helper
+--format documentation

data/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## Unreleased
+
+### Breaking Changes
+
+- None
+
+### Added
+
+- None
+
+### Fixed
+
+- None
+
+
+## 0.7.1
+
+### Added
+
+- remove image if path is null
+- remove section if collection is empty/null
+
+
+## 0.7.0
+
+### Added
+
+- allow nested images inside tables and sections
+- allow sections inside tables
+
+### Dependencies
+
+- rubyzip >= 1.3.0 (was ~> 1.2.0)
+
+
+## 0.6.0
+
+### Breaking Changes
+
+- `ODFReport::File` renamed to `ODFReport::Template`
+- `ODFReport::Report` constructor signature changed
+
+### Dependencies
+
+- rubyzip ~> 1.2.0 (was ~> 1.1.0)
+
+
+## Earlier Versions
+
+- No docs yet. Contributions welcome!

data/README.md

@@ -0,0 +1,220 @@
+
+# ODF-REPORT
+
+Gem for generating .odt files by making strings, images, tables and sections replacements in a previously created .odt file.
+
+## INSTALL
+
+In your Gemfile
+```ruby
+gem 'odf-report'
+```
+
+## USAGE
+
+### Step 1  --  the template
+
+First of all, you need a `.odt` file to serve as a template.
+Templates are normal .odt files with `[PLACEHOLDERS]` for *substitutions*.
+There are *four* kinds of substitutions available:
+* fields
+* tables
+* images
+* sections
+
+#### Fields
+
+It's just an upcase sentence, surrounded by brackets. It will be replaced by the value you supply.
+
+In the folowing example:
+
+```ruby
+report = ODFReport::Report.new("Users/john/my_template.odt") do |r|
+  r.add_field :user_name, @user.name
+  r.add_field :address, "My new address"
+end
+```
+
+All occurences of `[USER_NAME]` found in the file will be replaced by the value of `@user.name` whereas all `[ADDRESS]` 'es will contains `My new address`
+
+
+#### Tables
+
+To use table placeholders, you should create a Table in your document and give it a name. In OpenOffice, it's just a matter of right-clicking the table you just created, choose `Table Properties...` and type a name in the Name field.
+
+If you inform `header: true`, the first row will be treated as a *header* and left untouched. The remaining rows will be used as the template for the table.
+
+If you have more than one template row, they will be cycled. This is usefull for making zebra tables.
+
+As with **Field placeholders**, just insert a `[FIELD_NAME]` in each cell and let the magic takes place.
+
+Taking the folowing example:
+
+```ruby
+report = ODFReport::Report.new("Users/john/my_template.odt") do |r|
+
+  r.add_field "USER_NAME", @user.nome
+  r.add_field "ADDRESS", @user.address
+
+  r.add_table("TABLE_1", @list_of_itens, :header=>true) do |t|
+    t.add_column(:item_id, :id)
+    t.add_column(:description) { |item| "==> #{item.description}" }
+  end
+
+end
+```
+
+and considering you have a table like this in your template
+
+| #ID | Description |
+|--|--|
+| [ITEM_ID] | [DESCRIPTION] |
+
+
+and a collection `@list_of_itens`, it will create one row for each item in the collection, and the replacement will take place accordingly.
+
+Any format applied to the fields in the template will be preserved.
+
+#### Sections
+
+Sometimes, you have to repeat a whole chunk of a document, in a structure a lot more complex than a table. You can make a Section in your template and use it in this situations. Creating a Section in OpenOffice is as easy as select menu *Insert* and then *Section...*, and then choose a name for it.
+
+Sections are lot like Tables, in the sense that you can pass a collection and have that section repeated for each member of the collection. *But*, Sections can have anything inside it, even Tables *and nested Sections*, as long as you provide the appropriate data structure.
+
+Let's see an example:
+
+```ruby
+  @invoices = Invoice.find(:all)
+
+  report = ODFReport::Report.new("reports/invoice.odt") do |r|
+
+    r.add_field(:title, "INVOICES REPORT")
+    r.add_field(:date, Date.today)
+
+    r.add_section("SC_INVOICE", @invoices) do |s|
+
+      s.add_field(:number) { |invoice| invoice.number.to_s.rjust(5, '0') }
+      s.add_field(:name,    :customer_name)
+      s.add_field(:address, :customer_address)
+
+      s.add_table("TB_ITEMS", :items, header: true) do |t|
+        t.add_column(:id)
+        t.add_column(:product) {|item| item.product.name }
+        t.add_column(:value, :product_value)
+      end
+
+      s.add_field(:total) do |invoice|
+        if invoice.status == 'CLOSED'
+          invoice.total
+        else
+          invoice.items.sum('product_value')}
+        end
+      end
+
+      s.add_section("SUB_NOTES", :notes) do |s1|
+
+        s1.add_field(:note_title) { |n| n.title }
+
+        s1.add_table ...
+
+      end
+
+    end
+
+  end
+```
+
+Note that when you add a Table to a Section, you don't pass the collection itself, but the attribute of the item of that section that will return the collection for that particular Table. Sounds complicated, huh? But once you get it, it's quite straightforward.
+
+In the above example, `s.add_table("TB_ITEMS", :items, header: true) do |t|`, the `:items` thing refers to a `invoice.items`. Easy, right?
+
+
+#### Images
+
+You must put a mock image in your `.odt` template and give it a name. That name will be used to replace the mock image for the actual image.
+You can also assign any properties you want to the mock image and they will be kept once the image is replaced.
+
+An image replace would look like this:
+
+```ruby
+report = ODFReport::Report.new("my_template.odt") do |r|
+  r.add_image :graphic1, "/path/to/the/image.jpg"
+
+  r.add_table("TABLE_WITH_IMAGES", @items) do |t|
+    t.add_column(:id)
+    t.add_column(:product, :product_name)
+    t.add_image('PRODUCT_IMAGE') { |item| item.image_path }
+  end  
+end
+```
+
+<hr/>
+
+### Step 2  --  generating the document
+
+It's fairly simple to generate the document. You can use this inside a Rails application or in a standalone script.
+
+#### Generating a document in a Rails application
+
+In a controller, you can have a code like this:
+
+```ruby
+def print
+
+  @ticket = Ticket.find(params[:id])
+
+  report = ODFReport::Report.new(Rails.root.join("/app/reports/ticket.odt")) do |r|
+
+    r.add_field(:id,         @ticket.id.to_s)
+    r.add_field(:created_by, @ticket.created_by)
+    r.add_field(:created_at, @ticket.created_at.strftime("%d/%m/%Y - %H:%M"))
+    r.add_field(:type,       @ticket.type.name)
+    r.add_field(:status,     @ticket.status_text)
+    r.add_field(:date,       Time.now.strftime("%d/%m/%Y - %H:%M"))
+    r.add_field(:solution,   (@ticket.solution || ''))
+
+    r.add_table("OPERATORS", @ticket.operators) do |t|
+      t.add_column(:name) { |op| "#{op.name} (#{op.department.short_name})" }
+    end
+
+    r.add_table("FIELDS", @ticket.fields) do |t|
+      t.add_column(:field_name, :name)
+      t.add_column(:field_value) { |field| field.text_value || "Empty" }
+    end
+
+  end
+
+  send_data report.generate,
+		    type: 'application/vnd.oasis.opendocument.text',
+            disposition: 'attachment',
+            filename: 'report.odt'
+
+end
+```
+
+#### Generating a document in a standalone script
+
+It's very similar to a Rails app, but you can inform the path where the file will be saved.
+
+```ruby
+report = ODFReport::Report.new("ticket.odt") do |r|
+... populates the report ...
+end
+
+report.generate("./documents/new_ticket.odt")
+```
+
+#### Using a template stored in the database (or anywhere besides the file system)
+You can provide an `io:` param, containing the actual file read into a String.
+
+```ruby
+report = ODFReport::Report.new(io: @template.attachment.read) do |r|
+```
+
+<hr/>
+
+#### REQUIREMENTS
+
+**rubyzip**: manipulating the contents of the odt file, since it's actually a zip file.
+**nokogiri**: parsing and manipulating the document xml files.
+**mime-types**: identify images mime types

data/Rakefile

@@ -1 +1,9 @@
 require "bundler/gem_tasks"
+require 'launchy'
+task :test do
+  Dir.glob('./test/*_test.rb').each { |file| require file}
+end
+
+task :open do
+  Dir.glob('./test/result/*.odt').each { |file| Launchy.open(file) }
+end

data/bin/odt-extract

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'launchy'
+
+arg = ARGV[0]
+dir = File.basename(arg, File.extname(arg))
+
+%x( rm -rf #{dir}; unzip -d #{dir} #{arg} )
+
+Launchy.open dir

data/bin/odt-viewer

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+require 'launchy'
+require "nokogiri"
+require "zip"
+
+xml = ""
+
+Zip::File.open(ARGV[0]) do |zip|
+  content = zip.get_entry('content.xml').get_input_stream.read
+  xml = Nokogiri::XML(content).to_xml
+end
+
+filename = File.join(Dir.mktmpdir, "#{File.basename(ARGV[0])}.result.xml")
+
+File.open(filename, 'w') { |f| f.write xml }
+
+Launchy.open filename

data/lib/odf-report.rb

@@ -2,15 +2,17 @@ require 'rubygems'
 require 'zip'
 require 'fileutils'
 require 'nokogiri'
+require 'mime/types'
+require 'securerandom'
 
 require File.expand_path('../odf-report/parser/default',  __FILE__)
 
-require File.expand_path('../odf-report/images',    __FILE__)
-require File.expand_path('../odf-report/field',     __FILE__)
-require File.expand_path('../odf-report/text',      __FILE__)
-require File.expand_path('../odf-report/file',      __FILE__)
-require File.expand_path('../odf-report/fields',    __FILE__)
-require File.expand_path('../odf-report/nested',    __FILE__)
-require File.expand_path('../odf-report/section',   __FILE__)
-require File.expand_path('../odf-report/table',     __FILE__)
-require File.expand_path('../odf-report/report',    __FILE__)
+require File.expand_path('../odf-report/data_source',  __FILE__)
+require File.expand_path('../odf-report/field',        __FILE__)
+require File.expand_path('../odf-report/text',         __FILE__)
+require File.expand_path('../odf-report/template',     __FILE__)
+require File.expand_path('../odf-report/image',        __FILE__)
+require File.expand_path('../odf-report/nestable',     __FILE__)
+require File.expand_path('../odf-report/section',      __FILE__)
+require File.expand_path('../odf-report/table',        __FILE__)
+require File.expand_path('../odf-report/report',       __FILE__)

data/lib/odf-report/data_source.rb

@@ -0,0 +1,65 @@
+module ODFReport
+  class DataSource
+
+    attr_reader :value
+
+    def initialize(opts, &block)
+      @value      = opts[:value]      || opts[:collection]
+      @data_field = opts[:data_field] || opts[:collection_field] || opts[:name]
+      @block      = block
+    end
+
+    def set_source(record)
+      @value = extract_value_from_item(record)
+    end
+
+    def each(&block)
+      return unless @value
+      @value.each(&block)
+    end
+
+    def empty?
+      @value.nil? || @value.empty?
+    end
+
+    private
+
+    def extract_value_from_item(record)
+
+      if @block
+        @block.call(record)
+
+      elsif record.is_a?(Hash)
+        key = @data_field
+        record[key] || record[key.to_s.downcase] || record[key.to_s.upcase] || record[key.to_s.downcase.to_sym]
+
+      elsif @data_field.is_a?(Array)
+        execute_methods_on_item(record)
+
+      elsif @data_field.is_a?(Hash) && record.respond_to?(@data_field.keys[0])
+        record.send(@data_field.keys[0], @data_field.values[0])
+
+      elsif record.respond_to?(@data_field)
+        record.send(@data_field)
+
+      else
+        raise "Can't find [#{@data_field.to_s}] in this #{record.class}"
+
+      end
+
+    end
+
+    def execute_methods_on_item(record)
+      tmp = record.dup
+      @data_field.each do |f|
+        if f.is_a?(Hash)
+          tmp = tmp.send(f.keys[0], f.values[0])
+        else
+          tmp = tmp.send(f)
+        end
+      end
+      tmp
+    end
+
+  end
+end