caracal 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52dc6e582d7e47010ca9fc90d1e02f20944d55faa485548c881bec1091c45e96
-  data.tar.gz: b6f22eebb075a7852b0ea30ea595ca6ca89f7b98e40564ff3ab2b68c9f004039
+  metadata.gz: f7539fa972b10d2c7af3de21bb8f9787eecb0e0c3867326afd4cdedd2ec3dd5a
+  data.tar.gz: 8356897d9cb7e54c9816497f0297cc635afb2267f42cba57fac009b3819791f0
 SHA512:
-  metadata.gz: 9651b63df3aa217d25c8ed1f9c3676a57071f3c4e7532053c76f0d07ead18e399c0dcc79c40427959bd275966c60e8be5b72ac0620f0bfd8853aff0ff1a1ddc4
-  data.tar.gz: 9b9bd2396372f9fe4334eccbeddee4bff14aa7f3b14acc595fe6dbdeba858f37017c3b64d38b28b9efd60f26b11351590122bff05d73f7fb3cffefa36c9dee3a
+  metadata.gz: b8542dfdc09c07f78f7bf63714d681b1f8a0d93c6718f14f3d1e53ef6b055e6549df94b95fddb93390f89e6d300063566b9d71d7584b104c453caa4dadf0e023
+  data.tar.gz: '009ca4e19a83ec60c60bc3dc9e009da724a0768f50ebfba2b2e4045bf98e658689386495e3f59fd639eb2da1bb1fcfd059ada4f517353707647799c3d9c12be6'

data/CHANGELOG.md

@@ -1,9 +1,18 @@
+#### v1.4.0
+
+* Enhancements
+  * Changed `file_name` method to accept absolute and relative paths. (@jdugan)
+  * Added instance save method so documents can be created via commands instead of blocks, if desired. (@jdugan)
+  * Removed extra paragraph tag inserted after tables; added logic to ensure final tag of table cells is always a paragraph. (@jdugan)
+  
+
 #### v1.3.0
 
 * Enhancements
   * Added proper text highlighting. Colors are limited so we left :bgcolor option. (@rmarone)
   * Added bookmarks and internal links. (@rmarone)
 
+
 #### v1.2.0
 
 * Enhancements

data/lib/caracal/core/file_name.rb

@@ -1,39 +1,43 @@
 module Caracal
   module Core
-    
-    # This module encapsulates all the functionality related to setting the 
+
+    # This module encapsulates all the functionality related to setting the
     # document's name.
     #
     module FileName
       def self.included(base)
         base.class_eval do
-          
+
           #-------------------------------------------------------------
           # Configuration
           #-------------------------------------------------------------
-    
+
           # constants
           const_set(:DEFAULT_FILE_NAME, 'caracal.docx')
-          
+
           # accessors
           attr_reader :name
-          
-          
+          attr_reader :path
+
+
           #-------------------------------------------------------------
           # Public Methods
           #-------------------------------------------------------------
-    
+
           # This method sets the name of the output file. Defaults
           # to the name of the library.
           #
           def file_name(value=nil)
             v = value.to_s.strip
-            @name = (v == '') ? self.class::DEFAULT_FILE_NAME : v
+            a = v.split('/')
+
+            @name = (v == '') ? self.class::DEFAULT_FILE_NAME : a.last
+            @path = (a.size > 1) ? v : "./#{ v }"
           end
-          
+
         end
       end
     end
-    
+
   end
-end
+end

data/lib/caracal/core/models/table_cell_model.rb

@@ -1,5 +1,6 @@
 require 'caracal/core/models/base_model'
 require 'caracal/core/models/margin_model'
+require 'caracal/core/models/paragraph_model'
 
 
 module Caracal
@@ -39,6 +40,11 @@ module Caracal
           end
 
           super options, &block
+
+          p_klass = Caracal::Core::Models::ParagraphModel     # the final tag in a table cell
+          unless contents.last.is_a? p_klass                  # *must* be a paragraph for OOXML
+            contents << p_klass.new(content: '')              # to not throw an error.
+          end
         end
 
 

data/lib/caracal/document.rb

@@ -37,9 +37,9 @@ require 'caracal/renderers/styles_renderer'
 module Caracal
   class Document
 
-    #-------------------------------------------------------------
+    #------------------------------------------------------
     # Configuration
-    #-------------------------------------------------------------
+    #------------------------------------------------------
 
     # mixins (order is important)
     include Caracal::Core::CustomProperties
@@ -64,11 +64,11 @@ module Caracal
     include Caracal::Core::Text
 
 
-    #-------------------------------------------------------------
+    #------------------------------------------------------
     # Public Class Methods
-    #-------------------------------------------------------------
+    #------------------------------------------------------
 
-    #============ OUTPUT ====================================
+    #============ OUTPUT ==================================
 
     # This method renders a new Word document and returns it as a
     # a string.
@@ -86,16 +86,17 @@ module Caracal
     #
     def self.save(f_name = nil, &block)
       docx   = new(f_name, &block)
-      buffer = docx.render
-
-      File.open("./#{ docx.name }", 'wb') { |f| f.write(buffer.string) }
+      docx.save
+      # buffer = docx.render
+      #
+      # File.open(docx.path, 'wb') { |f| f.write(buffer.string) }
     end
 
 
 
-    #-------------------------------------------------------------
+    #------------------------------------------------------
     # Public Instance Methods
-    #-------------------------------------------------------------
+    #------------------------------------------------------
 
     # This method instantiates a new word document.
     #
@@ -119,7 +120,7 @@ module Caracal
     end
 
 
-    #============ GETTERS ===================================
+    #============ GETTERS =================================
 
     # This method returns an array of models which constitute the
     # set of instructions for producing the document content.
@@ -129,7 +130,7 @@ module Caracal
     end
 
 
-    #============ RENDERING =================================
+    #============ RENDERING ===============================
 
     # This method renders the word document instance into
     # a string buffer. Order is important!
@@ -153,13 +154,21 @@ module Caracal
     end
 
 
+    #============ SAVING ==================================
+
+    def save
+      buffer = render
+
+      File.open(path, 'wb') { |f| f.write(buffer.string) }
+    end
+
 
-    #-------------------------------------------------------------
+    #------------------------------------------------------
     # Private Instance Methods
-    #-------------------------------------------------------------
+    #------------------------------------------------------
     private
 
-    #============ RENDERERS =====================================
+    #============ RENDERERS ===============================
 
     def render_app(zip)
       content = ::Caracal::Renderers::AppRenderer.render(self)

data/lib/caracal/renderers/document_renderer.rb

@@ -403,7 +403,7 @@ module Caracal
 
         # don't know why this is needed, but it prevents a
         # rendering error.
-        render_paragraph(xml, Caracal::Core::Models::ParagraphModel.new)
+        # render_paragraph(xml, Caracal::Core::Models::ParagraphModel.new)
       end
 
 

data/lib/caracal/version.rb

@@ -1,3 +1,3 @@
 module Caracal
-  VERSION = '1.3.0'
+  VERSION = '1.4.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: caracal
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Trade Infomatics
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-28 00:00:00.000000000 Z
+date: 2018-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri