virgild-resumetools 0.2.3 → 0.2.4

data/CHANGES

@@ -0,0 +1,6 @@
+2009-09-17 (Version 0.2.4)
+* Added property helpers to ResumeTools::Resume
+* Added plain text renderer (ResumeTools::Resume#render_plain_text)
+
+2009-09-01
+* Path cleanup

data/lib/resumetools.rb

@@ -23,12 +23,13 @@
 # OTHER DEALINGS IN THE SOFTWARE.
 #++
 
-$:.unshift(File.dirname(__FILE__))
-
 require "extlib"
 require "uuidtools"
 
+$:.unshift File.dirname(__FILE__)
+
 require "resumetools/version"
 require "resumetools/resume/resume"
 require "resumetools/resume/text_reader"
-require "resumetools/resume/pdf"
+require "resumetools/resume/pdf"
+require "resumetools/resume/plain_text"

data/lib/resumetools/resume/plain_text.rb

@@ -0,0 +1,128 @@
+require 'text/format'
+
+module ResumeTools
+  module Renderer
+    class PlainText
+      def initialize(resume)
+        @resume = resume
+      end
+      
+      def render(opts={})
+        @item_bullet = "-"
+        @header_filler = "-"
+        @newline = "\n"
+        @format = Text::Format.new
+        @format.first_indent = 0
+        @format.columns = 80
+        @indent = 2
+        @lined_headers = true
+        
+        center @resume.full_name
+        center @resume.address1
+        center @resume.address2
+        center @resume.telephone
+        center @resume.email
+        center @resume.url
+        blank_line
+
+        @resume.sections.each_with_index do |section, n|
+          render_section(section)
+          blank_line if (n < @resume.sections.length - 1)
+        end  
+        content
+      end
+      
+      private
+      
+      def render_section(section)
+        header section.title
+        render_paragraph(section.para) if section.has_paragraph?
+        
+        section.items.each_with_index do |item, n|
+          push_margin do
+            render_item(item)
+          end
+          blank_line if (n < section.items.length - 1)
+        end
+        
+        section.periods.each_with_index do |period, n|
+          push_margin do
+            render_period period
+          end
+          blank_line if (n < section.periods.length - 1)
+        end
+      end
+      
+      def render_period(period)
+        add_line(period.title) if period.title
+        add_line period.line
+        
+        if period.has_items?
+          blank_line
+          push_margin do
+            period.items.each_with_index do |item, n|
+              render_item item
+              blank_line if (n < period.items.length - 1)
+            end
+          end
+        end
+      end
+      
+      def render_item(item)
+        add_line "#{@item_bullet} " + item.text
+      end
+      
+      def render_paragraph(para)
+        push_margin { add_line para }
+      end
+      
+      def reset_content
+        @text_content = String.new
+      end
+      
+      def content
+        @text_content ||= String.new
+      end
+      
+      def center(line)
+        line = @newline if line.nil?
+        content << @format.center(line)        
+      end
+      
+      def add_line(line="")
+        line = @newline if line.nil?
+        content << @format.format(line)
+      end
+      
+      def blank_line
+        content << @newline
+      end
+      
+      def push_margin(cols=0, &block)
+        cols = @indent if (cols == 0)
+        previous_margin = @format.left_margin
+        @format.left_margin = @format.left_margin + cols
+        block.call
+        @format.left_margin = previous_margin
+      end
+      
+      def header(text)
+        add_line(text)
+        add_line(@header_filler * text.length) if @lined_headers
+      end
+    end #class PlainText
+    
+    module PlainTextMethods
+      # Render to plain text
+      def render_plain_text(opts={})
+        renderer = PlainText.new(self)
+        renderer.render(opts)
+      end
+    end #module Methods
+    
+  end #module Renderer
+  
+  Resume.class_eval do
+    include Renderer::PlainTextMethods
+  end
+end #module ResumeTools

data/lib/resumetools/resume/resume.rb

@@ -28,13 +28,7 @@ module ResumeTools
   # = Resume
   # Represents a single resume document
   class Resume
-    
-    # The title of the resume
-    attr_accessor :title
-    
-    # The name (or label) for this resume
-    attr_accessor :name
-    
+        
     # The full name of the subject of this resume
     attr_accessor :full_name
     
@@ -57,16 +51,14 @@ module ResumeTools
     attr_reader :sections
     
     # Creates a +Resume+ and passes it to the given block. Returns the created +Resume+.
-    def self.build(&block)
-      resume = self.new
-      yield resume
+    def self.build(opts={}, &block)
+      resume = self.new(opts)
+      block.call(resume)
       resume
     end
     
     # Creates a new +Resume+ with the given properties
     def initialize(props={})
-      @title = props[:title] || ""
-      @name = props[:name] || "Unnamed Resume"
       @full_name = props[:full_name] || ""
       @url = props[:url] || ""
       @email = props[:email] || ""
@@ -115,7 +107,12 @@ module ResumeTools
       !self.address2.blank?
     end
     
-  end
+    #
+    def has_sections?
+      !self.sections.empty?      
+    end
+    
+  end #class Resume
   
   
   # = Section
@@ -140,6 +137,31 @@ module ResumeTools
       @items = Array.new
       @periods = Array.new
     end
+    
+    #
+    def has_paragraph?
+      !self.para.blank?
+    end
+    
+    def has_para?
+      self.has_paragraph?
+    end
+    
+    #
+    def has_items?
+      !self.items.empty?
+    end
+    
+    #
+    def has_periods?
+      !self.periods.empty?
+    end
+    
+    #
+    def has_title?
+      !self.title.blank?
+      
+    end
 
     # Creates a period and adds it to the list
     def create_period(props={}, &block)
@@ -200,6 +222,31 @@ module ResumeTools
       @items = Array.new
     end
     
+    #
+    def has_title?
+      !self.title.blank?
+    end
+    
+    def has_location?
+      !self.location.blank?
+    end
+    
+    def has_organization?
+      !self.organization.blank?
+    end
+    
+    def has_dtstart?
+      !self.dtstart.blank?
+    end
+    
+    def has_dtend?
+      !self.dtend.blank?
+    end
+    
+    def has_items?
+      !self.items.empty?
+    end
+    
     # Adds an item
     def add_item(item)
       self.items << item
@@ -212,6 +259,22 @@ module ResumeTools
       self.add_item(item)
       item
     end
+    
+    # The period details in a single line
+    def line
+      elements = Array.new
+      elements << self.organization if self.has_organization?
+      elements << self.location if self.has_location?
+      if self.has_dtstart? && self.has_dtend?
+        date = " (#{self.dtstart}) - #{self.dtend})"
+      elsif self.has_dtstart? || self.has_dtend?
+        value = self.has_dtstart? ? self.dtstart : self.dtend
+        date = " (#{value})"
+      else
+        date = ''
+      end
+      elements.join(", ").concat("#{date}")
+    end
   end
   
   

data/lib/resumetools/version.rb

@@ -28,7 +28,7 @@ unless defined? ResumeTools::VERSION
     module VERSION
       MAJOR = 0
       MINOR = 2
-      TINY  = 3
+      TINY  = 4
       STRING = [MAJOR, MINOR, TINY].join('.')
     end
   end

data/spec/resume_spec.rb

@@ -27,8 +27,7 @@ require File.join(File.dirname(__FILE__), "spec_helper")
 
 
 def resume_attributes
-  { :name => "Physicist Resume",
-    :title => "Physicist - 30+ yrs experience",
+  { 
     :full_name => "Albert Einstein",
     :url => "http://phys6.science.org/einstein",
     :email => "albert.einstein@science.org",
@@ -65,15 +64,13 @@ describe "Resume" do
   
   it "has initial properties after creation" do
     @resume = ResumeTools::Resume.new
-    @resume.name.should == "Unnamed Resume"
-    @resume.title.should be_blank
     @resume.full_name.should be_blank
     @resume.has_url?.should be_false
     @resume.has_email?.should be_false
     @resume.has_telephone?.should be_false
     @resume.has_address1?.should be_false
     @resume.has_address2?.should be_false
-    @resume.should have(0).sections
+    @resume.has_sections?.should be_false
   end
   
   it "is created with hash properties" do
@@ -84,8 +81,6 @@ describe "Resume" do
     @resume.has_address1?.should be_true
     @resume.has_address2?.should be_true
     
-    @resume.name.should == @attributes[:name]
-    @resume.title.should == @attributes[:title]
     @resume.full_name.should == @attributes[:full_name]
     @resume.url.should == @attributes[:url]
     @resume.telephone.should == @attributes[:telephone]
@@ -110,6 +105,7 @@ describe "Section" do
     end
     
     @resume.should have(1).sections
+    @resume.has_sections?.should be_true
     section = @resume.sections[0]
     section.title.should == @attributes[:title]
     section.para.should == @attributes[:para]
@@ -118,8 +114,15 @@ describe "Section" do
   it "should have no items" do
     section = ResumeTools::Section.new
     section.should have(0).items
+    section.has_items?.should be_false
   end
   
+  it "should have no periods" do
+    section = ResumeTools::Section.new
+    section.has_periods?.should be_false    
+  end
+  
+  
   it "should be able to add items" do
     section = ResumeTools::Section.new
     section.create_item do |item|
@@ -130,6 +133,7 @@ describe "Section" do
     section.should have(2).items
     section.items[0].text.should == "This is item A."
     section.items[1].text.should == "This is item B."
+    section.has_items?.should be_true
   end
   
   it "is created in the right order" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: virgild-resumetools
 version: !ruby/object:Gem::Version 
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors: 
 - Virgil Dimaguila
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-09-01 00:00:00 -07:00
+date: 2009-09-17 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -73,11 +73,17 @@ extra_rdoc_files: []
 files: 
 - examples/sample.pdf
 - examples/sample.resume
+- lib/fonts
+- lib/fonts/Vera.ttf
+- lib/fonts/VeraBd.ttf
+- lib/fonts/VeraBI.ttf
+- lib/fonts/VeraIt.ttf
 - lib/resumetools
 - lib/resumetools/grammars
 - lib/resumetools/grammars/resume.treetop
 - lib/resumetools/resume
 - lib/resumetools/resume/pdf.rb
+- lib/resumetools/resume/plain_text.rb
 - lib/resumetools/resume/resume.rb
 - lib/resumetools/resume/text_reader.rb
 - lib/resumetools/version.rb
@@ -93,10 +99,6 @@ files:
 - tasks/package.rake
 - tasks/rdoc.rake
 - tasks/rspec.rake
-- fonts/Vera.ttf
-- fonts/VeraBd.ttf
-- fonts/VeraBI.ttf
-- fonts/VeraIt.ttf
 - CHANGES
 - LICENSE
 - Rakefile