pdf_tempura 0.0.2

data/spec/lib/pdf_tempura/document/field_common.rb

@@ -0,0 +1,12 @@
+shared_examples "a document field methods" do
+
+  describe "method expectations" do
+    it { should respond_to(:x) }
+    it { should respond_to(:y) }
+    it { should respond_to(:width) }
+    it { should respond_to(:height) }
+    it { should respond_to(:name) }
+    it { should respond_to(:padding) }
+  end
+
+end

data/spec/lib/pdf_tempura/document/field_set_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe PdfTempura::Document::FieldSet do
+
+  let(:group_name) { "group" }
+  subject{ described_class.new(group_name) }
+  it_behaves_like "a field that accepts default commands"
+
+  describe "#new" do
+    it "should have no fields" do
+      subject = described_class.new(group_name)
+      subject.fields.should be_empty
+    end
+
+    it "should yield" do
+      expect { |b|
+        described_class.new(group_name,&b)
+      }.to yield_control
+    end
+  end
+
+  describe "coordinate calculation" do
+    it "calculates correct coordinates with one and two text fields" do
+      subject.text_field :name,[5,30],[20,20]
+      subject.width.should == 20
+      subject.x.should == 5
+      subject.y.should == 30
+      subject.height.should == 20
+
+      subject.text_field :bar,[0,30], [50,10]
+      subject.width.should == 50
+      subject.height.should == 20
+      subject.x.should == 0
+      subject.y.should == 30
+    end
+  end
+
+end

data/spec/lib/pdf_tempura/document/page_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe PdfTempura::Document::Page do
+
+  subject{ described_class.new(100) }
+
+  its(:number){ should == 100 }
+  its(:fields){ should == [] }
+
+  it_behaves_like "a field that accepts default commands"
+
+  describe "#validation" do
+
+    context "when passed an invalid page number" do
+      it "raise an argument error" do
+        expect{
+          described_class.new("one")
+        }.to raise_error ArgumentError, "Number must be of type Numeric."
+      end
+    end
+
+    context "when passed a valid page number" do
+      it "returns a Page object" do
+        described_class.new(1).should be_a(described_class)
+      end
+    end
+
+  end
+
+  describe "#==" do
+    context "when they have the same page number" do
+      let(:other){ described_class.new(100) }
+
+      it{ should == other }
+    end
+
+    context "when they have different page numbers" do
+      let(:other){ described_class.new(200) }
+
+      it{ should_not == other }
+    end
+  end
+
+  describe "#data" do
+    let(:data){ { woo: "yes"} }
+
+    it "returns an empty hash when it has no data" do
+      subject.data == {}
+    end
+
+    it "returns the data" do
+      subject.data = { name: "Bruce" }
+      subject.data.should == { "name" => "Bruce" }
+    end
+  end
+
+end

data/spec/lib/pdf_tempura/document/table_spec.rb

@@ -0,0 +1,161 @@
+require 'spec_helper'
+require_relative 'field_common'
+
+describe PdfTempura::Document::Table do
+
+  context "interface test" do
+    subject { described_class.new("foo", [0,0], height: 100, number_of_rows: 10) }
+    it_should_behave_like "a document field methods"
+  end
+
+  describe "init" do
+
+    let(:name) { :table }
+    let(:origin) { [0,0] }
+    let(:options) { {} }
+    let(:valid_options) { {height: 100, row_height: 10, number_of_rows: 10}}
+
+    describe "option validation" do
+      shared_examples "failing option test" do
+        it "should complain" do
+          expect {
+            described_class.new(name, origin, options)
+          }.to raise_exception(ArgumentError, "You must pass number_of_rows and either height or row_height")
+        end
+      end
+
+      context "only number_of_rows is passed" do
+        let(:options) { {:number_of_rows => 10} }
+        it_should_behave_like "failing option test"
+      end
+
+      context "only height is passed" do
+        let(:options) { {:height => 100} }
+        it_should_behave_like "failing option test"
+      end
+
+      context "only row_height is passed" do
+        let(:options) { {:row_height => 10} }
+        it_should_behave_like "failing option test"
+      end
+
+    end
+
+    context "valid options" do
+      shared_examples "passing options" do
+        it "should not complain" do
+          expect {
+            described_class.new(name, origin, options)
+          }.not_to raise_exception
+        end
+
+        it "should be 100 tall with 10 row_height" do
+          subject = described_class.new(name,origin,options)
+          subject.height.should == 100
+          subject.row_height.should == 10
+        end
+      end
+
+      context "height and number of rows" do
+        let(:options) {{ height: 100, number_of_rows: 10}}
+        it_should_behave_like "passing options"
+      end
+
+      context "row_height and number of rows" do
+        let(:options) {{ row_height: 10, number_of_rows: 10}}
+        it_should_behave_like "passing options"
+      end
+    end
+
+
+    describe "yielding" do
+      it "should yield" do
+        expect { |b| described_class.new(name,origin,valid_options,&b)}.to yield_control
+      end
+    end
+  end
+
+  describe "#text_column"  do
+    let(:options) { {height: 100, number_of_rows: 10} }
+    let(:subject) { described_class.new(:table,[0,0],options)}
+
+    it "should add a column to the table" do
+      subject.text_column(:pin, 50)
+      subject.columns.count.should == 1
+      subject.columns.first.should be_kind_of(PdfTempura::Document::Table::TextColumn)
+    end
+  end
+
+  describe "#checkbox_column"  do
+    let(:options) { {height: 100, number_of_rows: 10} }
+    let(:subject) { described_class.new(:table,[0,0],options)}
+
+    it "should add a column to the table" do
+      subject.checkbox_column(:pin, 50)
+      subject.columns.count.should == 1
+      subject.columns.first.should be_kind_of(PdfTempura::Document::Table::CheckboxColumn)
+    end
+
+    it "should get a field at the correct coordinates" do
+      subject.checkbox_column(:pin,50)
+      field = subject.columns.first.field_at([50,50])
+      field.coordinates.should == [50,50]
+      field.dimensions.should == [50,10]
+    end
+
+  end
+
+  describe ".boxed_character_column" do
+    let(:options) { {height: 100, number_of_rows: 10} }
+    let(:subject) { described_class.new(:table,[0,0],options)}
+
+    it "should add a column to the table" do
+      subject.boxed_character_column(:pin, box_width: 10, box_spacing: 1)
+      subject.columns.count.should == 1
+      subject.columns.first.should be_kind_of(PdfTempura::Document::Table::BoxedCharacterColumn)
+    end
+  end
+
+  describe "#space" do
+    let(:options) { {height: 100, number_of_rows: 10} }
+    let(:subject) { described_class.new(:table,[0,0],options)}
+
+    it "should add a space to the table" do
+      subject.space(5)
+      subject.columns.count.should == 1
+      subject.columns.first.should be_kind_of(PdfTempura::Document::Table::Spacer)
+    end
+  end
+
+  describe "#width" do
+    subject { described_class.new(:table,[0,0],options) }
+
+    context "no padding" do
+      let(:options) { {height: 100, number_of_rows: 10} }
+
+      it "calculates width correctly" do
+        subject.text_column :a,10
+        subject.width.should == 10
+        subject.text_column :b,15
+        subject.width.should == 25
+        subject.space 5
+        subject.width.should == 30
+      end
+    end
+
+    context "with padding" do
+      let(:options) { {height: 100, number_of_rows: 10, cell_padding: 2} }
+
+      it "calculates width correctly" do
+        subject.text_column :a,10
+        subject.width.should == 10
+        subject.text_column :b,15
+        subject.width.should == 27
+        subject.space 5
+        subject.width.should == 34
+      end
+
+    end
+  end
+end
+

data/spec/lib/pdf_tempura/document/text_field_spec.rb

@@ -0,0 +1,195 @@
+require 'spec_helper'
+
+describe PdfTempura::Document::TextField do
+
+  it_behaves_like "a document field"
+
+  let(:name){ :text_field }
+  let(:coordinates){ [10, 20] }
+  let(:dimensions){ [200, 100] }
+  let(:default_value){ "Bruce" }
+
+  let(:options) do
+    {
+      default_value: default_value,
+      font_name: font_name,
+      font_size: font_size,
+      bold: bold,
+      italic: italic,
+      alignment: alignment,
+      multi_line: multi_line,
+      padding: padding,
+      valign: valign,
+      leading: leading
+    }
+  end
+
+  let(:font_name){ "Helvetica" }
+  let(:font_size){ 13 }
+  let(:bold){ true }
+  let(:italic){ true }
+  let(:alignment){ :center }
+  let(:multi_line){ true }
+  let(:padding) { [1,2,3,4] }
+  let(:leading) { 5 }
+  let(:valign) {"center"}
+
+  subject{ described_class.new(name, coordinates, dimensions, options) }
+
+  its(:default_value){ should == "Bruce" }
+  its(:font_name){ should == "Helvetica" }
+  its(:font_size){ should == 13 }
+  it{ should be_bold }
+  it{ should be_italic }
+  its(:alignment){ should == "center" }
+  it{ should be_multi_line }
+  its(:padding) { should == [1,2,3,4] }
+  its(:valign) { should == "center"}
+  its(:leading) { should == 5}
+
+  describe "defaults" do
+    subject{ described_class.new(name, coordinates, dimensions) }
+
+    its(:default_value){ should nil }
+    its(:font_size){ should == 10 }
+    it{ should_not be_bold }
+    its(:alignment){ should == "left" }
+    its(:padding) { should == [0,0,0,0] }
+    it{ should_not be_multi_line }
+  end
+
+  describe "validation" do
+    context "when passed valid attributes" do
+      it "returns a field object" do
+        described_class.new(name, coordinates, dimensions, options).should be_a(described_class)
+      end
+    end
+
+    context "when passed invalid options" do
+      context "as an object other than a hash" do
+        let(:options){ "these are bogus options" }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Options must be a hash."
+        end
+      end
+
+      context "font_name" do
+        let(:font_name){ 0 }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Font_name must be of type String."
+        end
+      end
+
+
+      context "font_size" do
+        let(:font_size){ "twenty" }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Font_size must be of type Numeric."
+        end
+      end
+
+      context "bold" do
+        let(:bold){ 3 }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Bold must be one of the following values: true, false."
+        end
+      end
+
+      context "italic" do
+        let(:italic){ 3 }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Italic must be one of the following values: true, false."
+        end
+      end
+
+
+      context "alignment" do
+        let(:alignment){ :opposite }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Alignment must be one of the following values: left, right, center."
+        end
+      end
+
+      context "multi_line" do
+        let(:multi_line){ "x" }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Multi_line must be one of the following values: true, false."
+        end
+      end
+
+      context "default_value" do
+        let(:default_value){ [] }
+
+        it "throws an error" do
+          expect{
+            described_class.new(name, coordinates, dimensions, options)
+          }.to raise_error ArgumentError, "Default_value must be of type String."
+        end
+      end
+
+      context "padding" do
+        context "as an object other than Array" do
+          let(:padding){ "1x1" }
+
+          it "throws an error" do
+            expect{
+              described_class.new(name, coordinates, dimensions, options)
+            }.to raise_error ArgumentError, "Padding must be of type Array."
+          end
+        end
+
+        context "by passing an invalid x or y coordinate" do
+          let(:padding){ ["a", "b" ] }
+
+          it "throws an error" do
+            expect{
+              described_class.new(name, coordinates, dimensions, options)
+            }.to raise_error ArgumentError, "Padding must contain only Numeric values."
+          end
+        end
+
+        context "by passing not enough coordinates" do
+          let(:padding){ [1] }
+
+          it "throws an error" do
+            expect{
+              described_class.new(name, coordinates, dimensions, options)
+            }.to raise_error ArgumentError, "Padding must contain 4 values."
+          end
+        end
+
+        context "by passing too many coordinates" do
+          let(:padding){ [1, 2, 3] }
+
+          it "throws an error" do
+            expect{
+              described_class.new(name, coordinates, dimensions, options)
+            }.to raise_error ArgumentError, "Padding must contain 4 values."
+          end
+        end
+      end
+    end
+  end
+
+end