report 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.yardopts

@@ -0,0 +1,2 @@
+--no-private
+--readme README.md

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Seamus Abshere
+
+MIT License
+
+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,137 @@
+# Report
+
+DSL for creating clean CSV, XLSX, and PDF reports in Ruby.
+
+Extracted from Brighter Planet's corporate reporting system.
+
+## Usage
+
+    class FleetReport < Report
+      attr_reader :batchfile
+
+      def initialize(batchfile)
+        @batchfile = batchfile
+      end
+
+      def description
+        'Fleet sustainability report'
+      end
+
+      def vehicles(type)
+        @batchfile.vehicles.where(:type => type)
+      end
+      
+      table 'Cars' do
+        head do
+          row 'Report type', :description
+          row 'Batchfile', :batchfile
+        end
+        body do
+          rows :vehicles, ['car']
+          column 'Vehicle ID', :id
+          column 'CO2 score', :carbon
+          column 'CO2 units', 'kg'
+          column 'Fuel grade'
+          column 'Fuel volume'
+          column 'Odometer'
+          column 'City'
+          column 'State'
+          column 'Postal code', :zip_code
+          column 'Country'
+          column 'Methodology'
+        end
+      end
+
+      table 'Trucks' do
+        head do
+          row 'Report type', :description
+          row 'Batchfile', :batchfile
+        end
+        body do
+          rows :vehicles, ['truck']
+          column 'Vehicle ID', :id
+          column 'CO2 score', :carbon
+          column 'CO2 units', 'kg'
+          column 'Fuel grade'
+          column 'Fuel volume'
+          column 'Odometer'
+          column 'City'
+          column 'State'
+          column 'Postal code', :zip_code
+          column 'Country'
+          column 'Methodology'
+        end
+      end
+
+      format_pdf(
+        :document => { :page_layout => :landscape },
+        :head => {:width => (10*72)},
+        :body => {:width => (10*72), :header => true}
+      )
+
+      format_xlsx do |xlsx|
+        xlsx.header.right.contents = 'Corporate Reporting Program'
+        xlsx.page_setup.top = 1.5
+        xlsx.page_setup.header = 0
+        xlsx.page_setup.footer = 0
+      end
+    end
+
+    b = Batchfile.first
+    fr = FleetReport.new(b)
+    fr.pdf.path
+    fr.csv.paths # note one file per table
+    fr.xlsx.path
+
+## Real-world usage
+
+<p><a href="http://brighterplanet.com"><img src="https://s3.amazonaws.com/static.brighterplanet.com/assets/logos/flush-left/inline/green/rasterized/brighter_planet-160-transparent.png" alt="Brighter Planet logo"/></a></p>
+
+We use `report` for [corporate reporting products at Brighter Planet](http://brighterplanet.com/research) and in production at
+
+* [Brighter Planet's impact estimate web service](http://impact.brighterplanet.com)
+* [Brighter Planet's reference data web service](http://data.brighterplanet.com)
+
+## Inspirations
+
+### dynamicreports
+
+http://dynamicreports.rubyforge.org/
+
+    class OrdersReport < DynamicReports::Report
+      title "Orders Report"
+      subtitle "All orders recorded in database"
+      columns :total, :created_at
+
+      chart :total_vs_quantity do
+        columns :total, :quantity
+        label_column "created_at"
+      end
+    end
+
+    # in the controller
+    def orders
+      @orders = Order.find(:all, :limit => 25)
+      render :text => OrdersReport.on(@orders).to_html, :layout => "application"
+    end
+
+### reportbuilder
+
+http://ruby-statsample.rubyforge.org/reportbuilder/
+
+    require "reportbuilder"    
+    rb=ReportBuilder.new do
+      text("2")
+      section(:name=>"Section 1") do
+        table(:name=>"Table", :header=>%w{id name}) do
+          row([1,"John"])
+        end
+      end
+      preformatted("Another Text")
+    end
+    rb.name="Html output"
+    puts rb.to_html
+
+## Copyright
+
+Copyright 2012 Brighter Planet, Inc.

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/bin/report

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+require 'report'

data/lib/report.rb

@@ -0,0 +1,51 @@
+require 'active_support/core_ext'
+
+require 'report/version'
+require 'report/utils'
+
+require 'report/table'
+require 'report/filename'
+require 'report/formatter'
+require 'report/template'
+require 'report/head'
+require 'report/body'
+require 'report/xlsx'
+require 'report/csv'
+require 'report/pdf'
+
+class Report
+  class << self
+    attr_accessor :tables
+    attr_accessor :pdf_format
+    attr_accessor :xlsx_format
+
+    def table(table_name, &blk)
+      tables << Table.new(table_name, &blk)
+    end
+
+    def format_pdf(hsh)
+      self.pdf_format = hsh
+    end
+
+    def format_xlsx(&blk)
+      self.xlsx_format = blk
+    end
+
+    def inherited(klass)
+      klass.tables = []
+      klass.pdf_format = {}
+    end
+  end
+
+  def csv
+    @csv ||= Csv.new self
+  end
+
+  def xlsx
+    @xlsx ||= Xlsx.new self
+  end
+
+  def pdf
+    @pdf ||= Pdf.new self
+  end
+end

data/lib/report/body.rb

@@ -0,0 +1,31 @@
+require 'report/body/column'
+require 'report/body/row'
+require 'report/body/rows'
+
+class Report
+  class Body
+    attr_reader :table
+    attr_reader :columns
+    def initialize(table, &blk)
+      @table = table
+      @columns = []
+      instance_eval(&blk)
+    end
+    def rows(*args)
+      @rows = Rows.new(*([self]+args))
+    end
+    def column(*args, &blk)
+      @columns << Column.new(*([self]+args), &blk)
+    end
+    def each(report)
+      @rows.each(report) do |obj|
+        yield Row.new(self, obj)
+      end
+    end
+    def to_a(report)
+      a = []
+      each(report) { |row| a << row.to_a }
+      a
+    end
+  end
+end

data/lib/report/body/column.rb

@@ -0,0 +1,48 @@
+class Report
+  class Body
+    class Column
+      attr_reader :body
+      attr_reader :name
+      attr_reader :method_id
+      attr_reader :proc
+      attr_reader :faded
+      attr_reader :row_options
+      def initialize(*args, &proc)
+        if block_given?
+          @proc = proc
+        end
+        @body = args.shift
+        @name = args.shift
+        options = args.extract_options!
+        @method_id = options.delete(:method_id) || args.shift
+        @faded = options.delete(:faded)
+        @row_options = options
+      end
+      def read(obj)
+        if @proc
+          obj.instance_eval(&@proc)
+        elsif method_id
+          obj.send method_id
+        elsif from_name = guesses.detect { |m| obj.respond_to?(m) }
+          obj.send from_name
+        else
+          raise "#{obj.inspect} does not respond to any of #{guesses.inspect}"
+        end
+      end
+      def read_with_options(obj)
+        v = read obj
+        f = case faded
+        when Symbol
+          obj.send faded
+        else
+          faded
+        end
+        { :value => v, :faded => f }.merge row_options
+      end
+      private
+      def guesses
+        [ name, name.underscore.gsub(/\W/, '_') ]
+      end
+    end
+  end
+end

data/lib/report/body/row.rb

@@ -0,0 +1,20 @@
+class Report
+  class Body
+    class Row
+      attr_reader :body
+      attr_reader :obj
+      def initialize(body, obj)
+        @body = body
+        @obj = obj
+      end
+      def to_a
+        body.columns.map { |column| column.read(obj) }
+      end
+      def to_hash
+        body.columns.map do |column|
+          column.read_with_options obj
+        end
+      end
+    end
+  end
+end

data/lib/report/body/rows.rb

@@ -0,0 +1,21 @@
+class Report
+  class Body
+    class Rows
+      attr_reader :body
+      attr_accessor :method_id
+      attr_accessor :args
+      def initialize(*args)
+        @body = args.shift
+        @method_id = args.shift
+        if args.last.is_a?(Array)
+          @args = args.last
+        end
+      end
+      def each(report, &blk)
+        (args ? report.send(method_id, *args) : report.send(method_id)).each do |obj|
+          blk.call obj
+        end
+      end
+    end
+  end
+end

data/lib/report/csv.rb

@@ -0,0 +1,21 @@
+require 'csv'
+
+require 'report/csv/table'
+
+class Report
+  class Csv
+    attr_reader :report
+    def initialize(report)
+      @report = report
+    end
+    def paths
+      tables.map { |table| table.path }
+    end
+    private
+    def tables
+      @tables ||= report.class.tables.map do |report_table|
+        Csv::Table.new self, report_table
+      end
+    end
+  end
+end

data/lib/report/csv/table.rb

@@ -0,0 +1,26 @@
+class Report
+  class Csv
+    class Table < Struct.new(:parent, :table)
+      include Report::Utils
+      def path
+        return @path if defined?(@path)
+        tmp_path = tmp_path(:hint => table.name, :extname => '.csv')
+        File.open(tmp_path, 'wb') do |f|
+          if table._head
+            table._head.each(parent.report) do |row|
+              f.write row.to_a.to_csv
+            end
+            f.write [].to_csv
+          end
+          if table._body
+            f.write table._body.columns.map(&:name).to_csv
+            table._body.each(parent.report) do |row|
+              f.write row.to_a.to_csv
+            end
+          end
+        end
+        @path = tmp_path
+      end
+    end
+  end
+end

data/lib/report/head.rb

@@ -0,0 +1,25 @@
+require 'report/head/row'
+
+class Report
+  class Head
+    attr_reader :table
+    def initialize(table, &blk)
+      @table = table
+      @rows = []
+      instance_eval(&blk)
+    end
+    def row(*cells)
+      @rows << Row.new(self, cells)
+    end
+    def each(report)
+      @rows.each do |row|
+        yield row.read(report)
+      end
+    end
+    def to_a(report)
+      a = []
+      each(report) { |row| a << row.to_a }
+      a
+    end
+  end
+end

data/lib/report/head/row.rb

@@ -0,0 +1,27 @@
+class Report
+  class Head
+    class Row
+      attr_reader :head
+      attr_reader :cells
+      def initialize(head, cells)
+        @head = head
+        @cells = cells
+      end
+      def read(report)
+        cells.map do |cell|
+          case cell
+          when String
+            cell
+          when Symbol
+            unless report.respond_to?(cell)
+              raise "#{report.inspect} doesn't respond to #{cell.inspect}"
+            end
+            report.send cell
+          else
+            raise "must pass String or Symbol to head row"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/report/pdf.rb

@@ -0,0 +1,102 @@
+require 'fileutils'
+
+class Report
+  class Pdf
+    DEFAULT_FONT = {
+      :normal      => File.expand_path('../pdf/DejaVuSansMono.ttf', __FILE__),
+      :italic      => File.expand_path('../pdf/DejaVuSansMono-Oblique.ttf', __FILE__),
+      :bold        => File.expand_path('../pdf/DejaVuSansMono-Bold.ttf', __FILE__),
+      :bold_italic => File.expand_path('../pdf/DejaVuSansMono-BoldOblique.ttf', __FILE__),
+    }
+    DEFAULT_DOCUMENT = {
+      :top_margin => 118,
+      :right_margin => 36,
+      :bottom_margin => 72,
+      :left_margin => 36,
+      :page_layout => :landscape,
+    }
+    DEFAULT_HEAD = {}
+    DEFAULT_BODY = {
+      :width => (10*72),
+      :header => true
+    }
+    DEFAULT_NUMBER_PAGES = [
+      'Page <page> of <total>',
+      {:at => [648, -2], :width => 100, :size => 10}
+    ]
+
+    include Utils
+
+    attr_reader :report
+
+    def initialize(report)
+      @report = report
+    end
+
+    def path
+      return @path if defined?(@path)
+      require 'prawn'
+      tmp_path = tmp_path(:extname => '.pdf')
+      Prawn::Document.generate(tmp_path, document) do |pdf|
+        
+        pdf.font_families.update(font_name => font)
+        pdf.font font_name
+
+        report.class.tables.each do |table|
+          if table._head and (t = table._head.to_a(report)).length > 0
+            pdf.table(t, head)
+          end
+
+          pdf.move_down 20
+          pdf.text table.name, :style => :bold
+          pdf.move_down 10
+
+          if table._body and (t = table._body.to_a(report)).length > 0
+            pdf.table(t, body)
+          end
+        end
+
+        pdf.number_pages(*number_pages)
+      end
+      
+      if stamp
+        raise "#{stamp} not readable or does not exist" unless File.readable?(stamp)
+        require 'posix/spawn'
+        POSIX::Spawn::Child.new 'pdftk', tmp_path, 'stamp', stamp, 'output', "#{tmp_path}.stamped"
+        FileUtils.mv "#{tmp_path}.stamped", tmp_path
+      end
+
+      @path = tmp_path
+    end
+
+    private
+
+    def font_name
+      'MainFont'
+    end
+    
+    def font
+      DEFAULT_FONT.merge report.class.pdf_format.fetch(:font, {})
+    end
+    
+    def document
+      DEFAULT_DOCUMENT.merge report.class.pdf_format.fetch(:document, {})
+    end
+
+    def head
+      DEFAULT_HEAD.merge report.class.pdf_format.fetch(:head, {})
+    end
+
+    def body
+      DEFAULT_BODY.merge report.class.pdf_format.fetch(:body, {})
+    end
+
+    def stamp
+      report.class.pdf_format[:stamp]
+    end
+
+    def number_pages
+      report.class.pdf_format.fetch :number_pages, DEFAULT_NUMBER_PAGES
+    end
+  end
+end

data/lib/report/table.rb

@@ -0,0 +1,21 @@
+class Report
+  class Table
+    attr_reader :name
+    def initialize(name, &blk)
+      @name = name
+      instance_eval(&blk)
+    end
+    def body(&blk)
+      @body = Body.new(self, &blk)
+    end
+    def head(&blk)
+      @head = Head.new(self, &blk)
+    end
+    def _head
+      @head
+    end
+    def _body
+      @body
+    end
+  end
+end

data/lib/report/utils.rb

@@ -0,0 +1,15 @@
+require 'tmpdir'
+
+class Report
+  module Utils
+    # stolen from https://github.com/seamusabshere/unix_utils
+    def tmp_path(options = {})
+      ancestor = [ self.class.name, options[:hint] ].compact.join('_')
+      extname = options.fetch(:extname, '.tmp')
+      basename = File.basename ancestor.sub(/^\d{9,}_/, '')
+      basename.gsub! /\W/, '_'
+      time = Time.now.strftime('%H%M%S%L')
+      File.join Dir.tmpdir, [time, '_', basename[0..(234-extname.length)], extname].join
+    end
+  end
+end

data/lib/report/version.rb

@@ -0,0 +1,3 @@
+class Report
+  VERSION = "0.0.1"
+end

data/lib/report/xlsx.rb

@@ -0,0 +1,46 @@
+require 'fileutils'
+
+class Report
+  class Xlsx
+    include Utils
+    attr_reader :report
+    def initialize(report)
+      @report = report
+    end
+    def path
+      return @path if defined?(@path)
+      require 'xlsx_writer'
+      tmp_path = tmp_path(:extname => '.xlsx')
+      workbook = XlsxWriter::Document.new
+      if f = report.class.xlsx_format
+        f.call workbook
+      end
+      report.class.tables.each do |table|
+        sheet = workbook.add_sheet table.name
+        cursor = 1 # excel row numbers start at 1
+        if table._head
+          table._head.each(report) do |row|
+            sheet.add_row row.to_a
+            cursor += 1
+          end
+          sheet.add_row []
+          cursor += 1
+        end
+        if table._body
+          sheet.add_row table._body.columns.map(&:name)
+          table._body.each(report) do |row|
+            sheet.add_row row.to_hash
+          end
+          sheet.add_autofilter calculate_autofilter(table, cursor)
+        end
+      end
+      FileUtils.mv workbook.path, tmp_path
+      workbook.cleanup
+      @path = tmp_path
+    end
+    private
+    def calculate_autofilter(table, cursor)
+      [ 'A', cursor, ':', XlsxWriter::Cell.excel_column_letter(table._body.columns.length-1), cursor ].join
+    end
+  end
+end

data/report.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/report/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Seamus Abshere"]
+  gem.email         = ["seamus@abshere.net"]
+  d = %q{DSL for creating clean CSV, XLSX, and PDF reports in Ruby. Extracted from Brighter Planet's corporate reporting system.}
+  gem.description   = d
+  gem.summary       = d
+  gem.homepage      = "https://github.com/seamusabshere/report"
+
+  gem.files         = `git ls-files`.split($\)
+  # gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "report"
+  gem.require_paths = ["lib"]
+  gem.version       = Report::VERSION
+
+  gem.add_runtime_dependency 'activesupport'
+  gem.add_runtime_dependency 'xlsx_writer'
+  gem.add_runtime_dependency 'prawn'
+  gem.add_runtime_dependency 'posix-spawn'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'remote_table'
+  gem.add_development_dependency 'unix_utils'
+  gem.add_development_dependency 'yard'
+end

data/spec/report_spec.rb

@@ -0,0 +1,360 @@
+# -*- encoding: utf-8 -*-
+# 日
+require 'report'
+
+require 'remote_table'
+require 'unix_utils'
+require 'posix/spawn'
+
+class Translation < Struct.new(:language, :translation)
+  class << self
+    def all
+      [ new('English', 'Hello'), new('Russian', 'Здравствуйте') ]
+    end
+  end
+  def backward
+    translation.reverse
+  end
+end
+
+class A1 < Report
+  table 'Hello' do
+    head do
+      row 'World'
+    end
+  end
+end
+class A2 < Report
+  table 'How to say hello' do
+    body do
+      rows :translations
+      column 'Language'
+      column 'Translation'
+    end
+  end
+  def translations
+    Translation.all
+  end
+end
+class A3 < Report
+  table 'Translations' do
+    head do
+      row 'Report type', :description
+    end
+    body do
+      rows :translations
+      column 'Language'
+      column 'Translation'
+    end
+  end
+  def description
+    "How to say hello in a few languages!"
+  end
+  def translations
+    Translation.all
+  end
+end
+class A4 < Report
+  table 'Translations and more' do
+    body do
+      rows :translations
+      column 'Language'
+      column 'Forward', :translation
+      column 'Backward'
+    end
+  end
+  def translations
+    Translation.all
+  end
+end
+class A5 < Report
+  table 'InEnglish' do
+    body do
+      rows :translations, ['English']
+      column 'Language'
+      column 'Translation'
+    end
+  end
+  table 'InRussian' do
+    body do
+      rows :translations, ['Russian']
+      column 'Language'
+      column 'Translation'
+    end
+  end
+  def translations(language)
+    Translation.all.select { |t| t.language == language }
+  end
+end
+class A6 < Report
+  table 'Translations and more, again' do
+    body do
+      rows :translations
+      column 'Language'
+      column('Forward') { translation }
+      column('Backward') { translation.reverse }
+    end
+  end
+  def translations
+    Translation.all
+  end
+end
+class A7 < Report
+  format_xlsx do |xlsx|
+    xlsx.header.right.contents = 'Corporate Reporting Program'
+    xlsx.page_setup.top = 1.5
+    xlsx.page_setup.header = 0
+    xlsx.page_setup.footer = 0
+  end
+  table 'Hello' do
+    head do
+      row 'World'
+    end
+  end
+end
+class Numero < Struct.new(:d_e_c_i_m_a_l, :m_o_n_e_y)
+  class << self
+    def all
+      [ new(9.9, 2.5) ]
+    end
+  end
+  def always_true
+    true
+  end
+  def always_false
+    false
+  end
+end
+class B1 < Report
+  table 'Numbers' do
+    body do
+      rows :numbers
+      column 'd_e_c_i_m_a_l', :type => :Decimal, :faded => :always_true
+      column 'm_o_n_e_y', :type => :Currency, :faded => :always_false
+    end
+  end
+  def numbers
+    Numero.all
+  end
+end
+class B2 < Report
+  format_pdf(
+    :document => { :page_layout => :landscape },
+    :head => {:width => (10*72)},
+    :body => {:width => (10*72), :header => true},
+    :font => {
+      :normal => File.expand_path('../../lib/report/pdf/DejaVuSansMono-Oblique.ttf', __FILE__),
+    },
+    :number_pages => ["Page <page> of <total>", {:at => [648, -2], :width => 100, :size => 10}],
+    :stamp => File.expand_path("../stamp.pdf", __FILE__)
+  )
+  table 'Numbers' do
+    body do
+      rows :numbers
+      column 'd_e_c_i_m_a_l', :type => :Decimal, :faded => true
+      column 'm_o_n_e_y', :type => :Currency
+    end
+  end
+  def numbers
+    Numero.all
+  end
+end
+
+describe Report do
+  describe '#csv' do
+    it "writes each table to a separate file" do
+      hello = ::CSV.read A1.new.csv.paths.first
+      hello[0][0].should == 'World'
+    end
+    it "constructs a body out of rows and columns" do
+      how_to_say_hello = ::CSV.read A2.new.csv.paths.first, :headers => :first_row
+      how_to_say_hello[0]['Language'].should == 'English'
+      how_to_say_hello[0]['Translation'].should == 'Hello'
+      how_to_say_hello[1]['Language'].should == 'Russian'
+      how_to_say_hello[1]['Translation'].should == 'Здравствуйте'
+    end
+    it "puts a blank row between head and body" do
+      transl_with_head = ::CSV.read A3.new.csv.paths.first, :headers => false
+      transl_with_head[0][0].should == "Report type"
+      transl_with_head[0][1].should == "How to say hello in a few languages!"
+      transl_with_head[4][0].should == "Russian"
+      transl_with_head[4][1].should == 'Здравствуйте'
+    end
+    it "passes arguments on columns" do
+      t = ::CSV.read A4.new.csv.paths.first, :headers => :first_row
+      en = t[0]
+      ru = t[1]
+      en['Language'].should == 'English'
+      en['Forward'].should == 'Hello'
+      en['Backward'].should == 'Hello'.reverse
+      ru['Language'].should == 'Russian'
+      ru['Forward'].should == 'Здравствуйте'
+      ru['Backward'].should == 'Здравствуйте'.reverse
+    end
+    it "passes arguments on rows" do
+      en_path, ru_path = A5.new.csv.paths
+      en = ::CSV.read en_path, :headers => :first_row
+      en.length.should == 1
+      en[0]['Language'].should == 'English'
+      en[0]['Translation'].should == 'Hello'
+      ru = ::CSV.read ru_path, :headers => :first_row
+      ru.length.should == 1
+      ru[0]['Language'].should == 'Russian'
+      ru[0]['Translation'].should == 'Здравствуйте'
+    end
+    it "instance-evals column blocks against row objects" do
+      t = ::CSV.read A6.new.csv.paths.first, :headers => :first_row
+      en = t[0]
+      ru = t[1]
+      en['Language'].should == 'English'
+      en['Forward'].should == 'Hello'
+      en['Backward'].should == 'Hello'.reverse
+      ru['Language'].should == 'Russian'
+      ru['Forward'].should == 'Здравствуйте'
+      ru['Backward'].should == 'Здравствуйте'.reverse
+    end
+  end
+
+  describe '#xlsx' do
+    it "writes all tables to the same file" do
+      hello = RemoteTable.new A1.new.xlsx.path, :headers => false
+      hello[0][0].should == 'World'
+    end
+    it "constructs a body out of rows and columns" do
+      how_to_say_hello = RemoteTable.new A2.new.xlsx.path, :headers => :first_row
+      how_to_say_hello[0]['Language'].should == 'English'
+      how_to_say_hello[0]['Translation'].should == 'Hello'
+      how_to_say_hello[1]['Language'].should == 'Russian'
+      how_to_say_hello[1]['Translation'].should == 'Здравствуйте'
+    end
+    it "puts a blank row between head and body" do
+      transl_with_head = RemoteTable.new A3.new.xlsx.path, :headers => false, :keep_blank_rows => true
+      transl_with_head[0][0].should == "Report type"
+      transl_with_head[0][1].should == "How to say hello in a few languages!"
+      transl_with_head[4][0].should == "Russian"
+      transl_with_head[4][1].should == 'Здравствуйте'
+    end
+    it "passes arguments on columns" do
+      t = RemoteTable.new A4.new.xlsx.path, :headers => :first_row
+      en = t[0]
+      ru = t[1]
+      en['Language'].should == 'English'
+      en['Forward'].should == 'Hello'
+      en['Backward'].should == 'Hello'.reverse
+      ru['Language'].should == 'Russian'
+      ru['Forward'].should == 'Здравствуйте'
+      ru['Backward'].should == 'Здравствуйте'.reverse
+    end
+    it "passes arguments on rows" do
+      path = A5.new.xlsx.path
+      en = RemoteTable.new(path, :headers => :first_row, :sheet => 'InEnglish').to_a
+      en.length.should == 1
+      en[0]['Language'].should == 'English'
+      en[0]['Translation'].should == 'Hello'
+      ru = RemoteTable.new(path, :headers => :first_row, :sheet => 'InRussian').to_a
+      ru.length.should == 1
+      ru[0]['Language'].should == 'Russian'
+      ru[0]['Translation'].should == 'Здравствуйте'
+    end
+    it "instance-evals column blocks against row objects" do
+      t = RemoteTable.new A6.new.xlsx.path, :headers => :first_row
+      en = t[0]
+      ru = t[1]
+      en['Language'].should == 'English'
+      en['Forward'].should == 'Hello'
+      en['Backward'].should == 'Hello'.reverse
+      ru['Language'].should == 'Russian'
+      ru['Forward'].should == 'Здравствуйте'
+      ru['Backward'].should == 'Здравствуйте'.reverse
+    end
+    it "accepts a formatter that works on the raw XlsxWriter::Document" do
+      path = A7.new.xlsx.path
+      dir = UnixUtils.unzip path
+      File.read("#{dir}/xl/worksheets/sheet1.xml").should include('Corporate Reporting Program')
+      FileUtils.rm_f path
+    end
+    it "allows setting cell options" do
+      path = B1.new.xlsx.path
+      dir = UnixUtils.unzip path
+      xml = File.read("#{dir}/xl/worksheets/sheet1.xml")
+      xml.should match(/s="2".*2.5/) # Currency
+      xml.should match(/s="9".*9.9/) # faded Decimal
+      FileUtils.rm_f path
+      FileUtils.rm_rf dir
+    end
+    it "automatically adds an autofilter" do
+      path = A2.new.xlsx.path
+      dir = UnixUtils.unzip path
+      xml = File.read("#{dir}/xl/worksheets/sheet1.xml")
+      xml.should include('autoFilter ref="A1:B1')
+      FileUtils.rm_f path
+      FileUtils.rm_rf dir
+    end
+  end
+
+  describe '#pdf' do
+    it "writes all tables to the same file" do
+      hello = A1.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', hello, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include('World')
+    end
+    it "constructs a body out of rows and columns" do
+      how_to_say_hello = A2.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', how_to_say_hello, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include('English')
+      stdout_utf8.should include('Hello')
+      stdout_utf8.should include('Russian')
+      stdout_utf8.should include('Здравствуйте')
+    end
+    it "puts a blank row between head and body" do
+      transl_with_head = A3.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', transl_with_head, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include("Report type")
+      stdout_utf8.should include("How to say hello in a few languages!")
+      stdout_utf8.should include('Russian')
+      stdout_utf8.should include('Здравствуйте')
+    end
+    it "passes arguments on columns" do
+      t = A4.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', t, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include('English')
+      stdout_utf8.should include('Hello')
+      stdout_utf8.should include('Hello'.reverse)
+      stdout_utf8.should include('Russian')
+      stdout_utf8.should include('Здравствуйте')
+      stdout_utf8.should include('Здравствуйте'.reverse)
+    end
+    it "passes arguments on rows" do
+      path = A5.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', path, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include('InEnglish')
+      stdout_utf8.should include('InRussian')
+      stdout_utf8.should include('English')
+      stdout_utf8.should include('Hello')
+      stdout_utf8.should include('Russian')
+      stdout_utf8.should include('Здравствуйте')
+    end
+    it "instance-evals column blocks against row objects" do
+      t = A6.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', t, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include('English')
+      stdout_utf8.should include('Hello')
+      stdout_utf8.should include('Hello'.reverse)
+      stdout_utf8.should include('Russian')
+      stdout_utf8.should include('Здравствуйте')
+      stdout_utf8.should include('Здравствуйте'.reverse)
+    end
+    it "accepts pdf formatting options, including the ability to stamp with pdftk" do
+      path = B2.new.pdf.path
+      child = POSIX::Spawn::Child.new('pdftotext', path, '-')
+      stdout_utf8 = child.out.force_encoding('UTF-8')
+      stdout_utf8.should include('Firefox')
+    end
+  end
+end

metadata

@@ -0,0 +1,209 @@
+--- !ruby/object:Gem::Specification
+name: report
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Seamus Abshere
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: xlsx_writer
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: posix-spawn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: remote_table
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: unix_utils
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: DSL for creating clean CSV, XLSX, and PDF reports in Ruby. Extracted
+  from Brighter Planet's corporate reporting system.
+email:
+- seamus@abshere.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .yardopts
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/report
+- lib/report.rb
+- lib/report/body.rb
+- lib/report/body/column.rb
+- lib/report/body/row.rb
+- lib/report/body/rows.rb
+- lib/report/csv.rb
+- lib/report/csv/table.rb
+- lib/report/filename.rb
+- lib/report/formatter.rb
+- lib/report/head.rb
+- lib/report/head/row.rb
+- lib/report/pdf.rb
+- lib/report/pdf/DejaVuSansMono-Bold.ttf
+- lib/report/pdf/DejaVuSansMono-BoldOblique.ttf
+- lib/report/pdf/DejaVuSansMono-Oblique.ttf
+- lib/report/pdf/DejaVuSansMono.ttf
+- lib/report/table.rb
+- lib/report/template.rb
+- lib/report/utils.rb
+- lib/report/version.rb
+- lib/report/xlsx.rb
+- report.gemspec
+- spec/report_spec.rb
+- spec/stamp.pdf
+homepage: https://github.com/seamusabshere/report
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: DSL for creating clean CSV, XLSX, and PDF reports in Ruby. Extracted from
+  Brighter Planet's corporate reporting system.
+test_files:
+- spec/report_spec.rb
+- spec/stamp.pdf
+has_rdoc: