caracal 1.4.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07032410054f6b6e5b8d640aa391c24382eda9461832b7f3fb0fe2bb9203164f
-  data.tar.gz: 780ae708802f68185d556d6ec0dc28b5fdb86adefc6043ec18bf32027440278b
+  metadata.gz: 3357d1a61526623b3acb0ead4e0b990ce1c70026ea321ba014415947380daec9
+  data.tar.gz: 5be1b9e7bec559c1199c2c17befe1238c3ab522c1ef1fdb3a49a58e3b102c67f
 SHA512:
-  metadata.gz: 136540cd7409584e274462d2f43b7b21f4533a4351611ea41f0db03fd6282a366d01c0a5d1f6b4d05d7674d9bdd9f939b536ba569189407abcfe253e8fc524c8
-  data.tar.gz: d9c61a1f362f43625aaa3160639f903ebd003df993dc8e78c17e456bb1a1205aef94b5e1dc8cdf9b69136ba71786bb2eeee03f8e26ae35c1862ea329d1fe9162
+  metadata.gz: ad771cd941a199997acf1138bd1d426e5f2a4d1d5feb2065366a85de09a5f31295f9eee3a97b7264732e27b09706c722e4532f0a2164f73c00d3b3543623eddc
+  data.tar.gz: d89fe871c0f5569292adfd8ec6a5c044bf1096ecb95e711b2c55a9a4aa1324317d757f5ab8057d20582ff0ccd3c5b6f150c5b5a25a3a4aed81634a495ce32ad2

data/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Ruby ${{ matrix.ruby }} / rubyzip ${{ matrix.rubyzip }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.1', '3.2', '3.3', '3.4', '4.0']
+        rubyzip: ['~> 1.3', '~> 3.4']
+    env:
+      RUBYZIP_VERSION: ${{ matrix.rubyzip }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rspec

data/CHANGELOG.md

@@ -1,10 +1,37 @@
+#### v1.5.0
+
+* Enhancements
+  * Added the `keep_next` paragraph property, which keeps a paragraph on the same page as the one following it. (@benjaminketron)
+  * Added the `header_rows` table method, which repeats the leading rows of a table after each page break. (@benjaminketron)
+  * Added the `cant_split` and `cant_split?` table methods, which keep a row from splitting across a page break. (@benjaminketron)
+  * Added the `column_widths` table method, which sets the table grid explicitly instead of deriving it from the first row. (@martinsp)
+  * Widened the rubyzip dependency to `>= 1.1.6, < 4.0`, allowing rubyzip 3.x. (@acwertman)
+  * Added continuous integration across Ruby 3.1-4.0 and both supported rubyzip lines. (@dlauer)
+  * Declared `required_ruby_version >= 3.1`. (@dlauer)
+  * Documented the trust contract for image and iframe sources in a new Security section. (@dlauer)
+
+* Bug Fixes
+  * Images and iframes are no longer loaded through `Kernel#open`, which executed a target beginning with `|` as a shell command, stopped fetching URLs entirely on Ruby 3.0 and later, and read in text mode on Windows, corrupting image data. Both are now read in binary, with `URI.open` for http(s) targets and `File.binread` for local paths. (@LItterBoy-GB, @dlauer)
+  * Removed control characters that XML does not permit from text, links, table cells, page number labels and custom properties. A single such character made Word reject the entire document. (@dlauer)
+  * Image part names and content types are now derived from the image data when it is supplied, rather than from the URL. This fixes presigned URLs, extensionless URLs and images carried in embedded documents. Registered content types for bmp, tiff and svg. (@dlauer)
+  * `iframe` now works inside table cells. (@catmando, @dlauer)
+  * Raised the rubyzip floor past versions whose `write_buffer` required an argument, which raised `ArgumentError` on save. (@acwertman)
+  * Corrected the documented units for table border and rule spacing, which are points rather than twips or eighths of a point. (@dlauer)
+
+
+#### v1.4.1
+
+* Bug Fixes
+  * Corrected rowspan logic to handle all cases. (@martinsp)
+
+
 #### 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
 

data/Gemfile

@@ -1,3 +1,6 @@
 source 'https://rubygems.org'
 
 gemspec
+
+# lets CI test against specific rubyzip versions
+gem 'rubyzip', ENV['RUBYZIP_VERSION'] if ENV['RUBYZIP_VERSION']

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014 Trade Informatics, Inc.
+Copyright (c) 2014 Urvin LLC
 
 MIT License
 

data/README.md

@@ -11,7 +11,7 @@ Caracal is not a magical HTML to Word translator. Instead, it is a markup langua
 
 Or, said differently, if you use [Prawn](https://github.com/prawnpdf/prawn) for PDF generation, you'll probably like Caracal. Only you'll probably like it better. :)
 
-Please see the [caracal-example](https://github.com/trade-informatics/caracal-example) repository for
+Please see the [caracal-example](https://github.com/urvin-compliance/caracal-example) repository for
 a working demonstration of the library's capabilities.
 
 
@@ -207,6 +207,19 @@ All Caracal models perform basic validations on their attributes, but this is, w
 In forthcoming versions of Caracal, we'll be looking to expand the `InvalidModelError` class to provide broader error reporting abilities across the entire library.
 
 
+## Security
+
+Caracal reads whatever path or URL you hand it. Both `img` and `iframe` accept a local filesystem path or an http(s) URL, and Caracal reads or fetches it while the document renders.
+
+**Treat those values as trusted input.** If a path or URL can be influenced by an end user, validate it before passing it to Caracal:
+
+* **Local paths** are read with the permissions of your application's process. Any file that process can read can be embedded in the generated document, so `docx.img '/etc/passwd'` embeds the contents of that file.
+* **URLs** are fetched from your application's network position, and redirects are followed. A user-supplied URL can therefore reach internal services, `localhost`, or cloud metadata endpoints that are not otherwise reachable from outside.
+* **Documents embedded with `iframe`** are parsed, and their markup is copied into your output. Only embed documents you trust. See [IFrames](#iframes).
+
+Caracal deliberately does not restrict paths, hosts, or directories, because it cannot know what is legitimate for your application. That policy belongs in your code: an allowlist of permitted directories or hosts, or simply never passing user-supplied values through to Caracal.
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -415,6 +428,7 @@ docx.p 'Sample text.' do
   bgcolor         'cccccc'          # sets the background color.
   highlight_color 'yellow'          # sets the highlight color. only accepts OOXML enumerations. see http://www.datypic.com/sc/ooxml/t-w_ST_HighlightColor.html.
   vertical_align  'superscript'     # sets the vertical alignment.
+  keep_next       false             # sets whether or not to keep this paragraph with the next paragraph when separated by page break.
 end
 ```
 
@@ -505,7 +519,7 @@ docx.hr do
   color   '333333'   # sets the color of the line. defaults to auto.
   line    :double    # sets the line style (single or double). defaults to single.
   size    8          # sets the thickness of the line. units in 1/8 points. defaults to 4.
-  spacing 4          # sets the spacing around the line. units in 1/8 points. defaults to 1.
+  spacing 4          # sets the space between the line and the surrounding text. units in points. defaults to 1.
 end
 ```
 
@@ -625,6 +639,8 @@ is a bit hacky, but it allows the library to key the image more effectively and
 Caracal needs a file extension to apply to the renamed media file. This seemed
 the simplest solution to both problems.*
 
+*If the URL or path can come from user input, read [Security](#security) first. Caracal will read any local file your process can read, and will fetch any URL you give it.*
+
 
 ### Tables
 
@@ -632,7 +648,7 @@ the simplest solution to both problems.*
 Release v1.4.0 deprecated the behaviour of automatically adding an empty paragraph tag after every table. If you are upgrading from an older version of the library, you will need to control such spacing in your own code.
 ```
 
-Tables can be added using the `table` method.  The method accepts several optional paramters to control the layout and style of the table cells.
+Tables can be added using the `table` method.  The method accepts several optional parameters to control the layout and style of the table cells.
 
 The `table` command accepts data in the form of a two-dimensional arrays. This corresponds to rows and column cells within those rows.  Each array item can be a string, a Hash of options, a Proc (which will be passed as a block), or a `TableCellModel`.  The command will normalize all array contents into a two-dimensional array of `TableCellModel` instances.
 
@@ -640,8 +656,20 @@ The `table` command accepts data in the form of a two-dimensional arrays. This c
 docx.table [['Header 1','Header 2'],['Cell 1', 'Cell 2']] do
   border_color   '666666'   # sets the border color. defaults to 'auto'.
   border_line    :single    # sets the border style. defaults to :single. see OOXML docs for details.
-  border_size    4          # sets the border width. defaults to 0. units in twips.
-  border_spacing 4          # sets the spacing around the border. defaults to 0. units in twips.
+  border_size    4          # sets the border width. defaults to 0. units in 1/8 points.
+  border_spacing 4          # sets the space between the border and the cell text. defaults to 0. units in points.
+  column_widths  [2400, 1200]
+                            # sets an explicit width for each column in the table grid. units in twips.
+                            # defaults to the widths of the cells in the first row.
+end
+```
+
+By default, the table grid is built from the cells in the first row. When that row contains a cell with a `colspan`, the grid can't be derived from it correctly and every column ends up the same width. `column_widths` sets the grid explicitly instead, taking one width per column.
+
+```ruby
+docx.table [['Spans two columns'], ['Cell 1', 'Cell 2']] do
+  cell_style rows[0][0], colspan: 2
+  column_widths [2400, 1200]
 end
 ```
 
@@ -683,6 +711,31 @@ end
 
 *Note: content of cells 21 and 24 will disappear*
 
+Table rows can be marked as header rows using the `header_rows` method which takes a number indicating how many rows from the top of the table should be marked as such. This has the effect of repeating these rows after each page break.
+
+```ruby
+docx.table [['Header 1', 'Header 2'],['Cell 1', 'Cell 2']] do
+  header_rows 1
+end
+```
+
+Row can be marked as can't split rows that re-position themselves at the top of the next if they would have otherwise split across a page break.
+
+```
+docx.table [['11', '22'], ['14', '25'], ['64', '23']] do
+  cant_split rows[1]
+end
+```
+
+or
+
+```
+docx.table [['11', '22'], ['14', '25'], ['64', '23']] do
+  cant_split rows[1...-1]
+end
+```
+
+
 ### Table Cells
 
 If your table contains more complex data (multiple paragraphs, images, lists, etc.), you will probably want to instantiate your `TableCellModel` instances directly.  With the exception of page breaks, table cells can contain anything the document can contain, including another table.
@@ -760,17 +813,19 @@ will not operate as expected in the parent Caracal document.
 
 Again, this feature is considered experimental.  Use at your own risk/discretion.
 
+**Only embed documents you trust.** Caracal parses the file you supply and copies its markup into your output, so the embedded document controls part of the result. Caracal also places no limit on how much data it will decompress while reading the file, so a small crafted document can expand to an arbitrarily large one in memory. Documents uploaded by untrusted users should not be passed to `iframe` without your own validation. See [Security](#security).
+
 
 ## Template Rendering
 
 Caracal includes [Tilt](https://github.com/rtomayko/tilt) integration to facilitate its inclusion in other frameworks.
 
-Rails integration can be added via the [Caracal-Rails](https://github.com/trade-informatics/caracal-rails) gem.
+Rails integration can be added via the [Caracal-Rails](https://github.com/urvin-compliance/caracal-rails) gem.
 
 
 ## Using Variables
 
-Lexical scope is a pretty big challenge for Caracal and it often confuses new users. This [closed issue](https://github.com/trade-informatics/caracal/issues/71) covers the discussion both from the user and library persepctive.
+Lexical scope is a pretty big challenge for Caracal and it often confuses new users. This [closed issue](https://github.com/urvin-compliance/caracal/issues/71) covers the discussion both from the user and library persepctive.
 
 
 ## Filing an Issue
@@ -789,7 +844,7 @@ happy to answer questions and provide what guidance we can. We just won't write
 
 For those using reasonably current versions of Word, please consider the following:
 
-- Before you file an issue, please run the example Caracal project [caracal-example](https://github.com/trade-informatics/caracal-example) in your development environment and
+- Before you file an issue, please run the example Caracal project [caracal-example](https://github.com/urvin-compliance/caracal-example) in your development environment and
 check the output.  This project implements nearly every feature Caracal supports and renders the expected output
 correctly.  It can be thought of as a canonical implementation of the library.
 
@@ -818,7 +873,7 @@ for 2010/2013, a set for 2016, etc.).
 
 ## Contributing
 
-1. Fork it ( https://github.com/trade-informatics/caracal/fork )
+1. Fork it ( https://github.com/urvin-compliance/caracal/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
@@ -837,6 +892,6 @@ A tip of the hat to the wonderful PDF generation library [Prawn](https://github.
 
 ## License
 
-Copyright (c) 2014 Trade Informatics, Inc
+Copyright (c) 2014 Urvin LLC
 
-[MIT License](https://github.com/trade-informatics/caracal/blob/master/LICENSE.txt)
+[MIT License](https://github.com/urvin-compliance/caracal/blob/master/LICENSE.txt)

data/caracal.gemspec

@@ -6,11 +6,11 @@ require 'caracal/version'
 Gem::Specification.new do |spec|
   spec.name          = 'caracal'
   spec.version       = Caracal::VERSION
-  spec.authors       = ['Trade Infomatics', 'John Dugan']
-  spec.email         = ['jpdugan@gmail.com']
+  spec.authors       = ['Urvin LLC', 'John Dugan', 'Dave Lauer']
+  spec.email         = ['jpdugan@gmail.com', 'dave@plia.com']
   spec.summary       = %q{ Fast, professional Microsoft Word (docx) writer for Ruby. }
   spec.description   = %q{ Caracal is a pure Ruby Microsoft Word generation library that produces professional quality MSWord documents (docx) using a simple, HTML-style DSL. }
-  spec.homepage      = 'https://github.com/trade-informatics/caracal'
+  spec.homepage      = 'https://github.com/urvin-compliance/caracal'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0")
@@ -18,11 +18,13 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '>= 3.1'
+
   spec.add_dependency 'nokogiri', '~> 1.6'
-  spec.add_dependency 'rubyzip',  '~> 1.1'
+  spec.add_dependency 'rubyzip',  '>= 1.1.6', '< 4.0'
   spec.add_dependency 'tilt',     '>= 1.4'
 
-  spec.add_development_dependency 'bundler',  '~> 1.3'
-  spec.add_development_dependency 'rake',     '~> 10.0'
+  spec.add_development_dependency 'bundler',  '>= 1.3'
+  spec.add_development_dependency 'rake',     '>= 10.0'
   spec.add_development_dependency 'rspec',    '~> 3.0'
 end

data/lib/caracal/core/iframes.rb

@@ -20,11 +20,16 @@ module Caracal
             model = Caracal::Core::Models::IFrameModel.new(options, &block)
             if model.valid?
               model.preprocess!
-              model.namespaces.each do |(prefix, href)|
-                namespace({ prefix: prefix, href: href })
-              end
-              model.ignorables.each do |prefix|
-                ignorable(prefix)
+
+              # table cells can't hold namespaces; the document
+              # collects those when it renders.
+              if respond_to?(:namespace)
+                model.namespaces.each do |(prefix, href)|
+                  namespace({ prefix: prefix, href: href })
+                end
+                model.ignorables.each do |prefix|
+                  ignorable(prefix)
+                end
               end
 
               contents << model

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

@@ -18,7 +18,7 @@ module Caracal
         const_set(:DEFAULT_BORDER_COLOR,    'auto')
         const_set(:DEFAULT_BORDER_LINE,     :single) 
         const_set(:DEFAULT_BORDER_SIZE,     4)        # 0.5pt in 1/8 points
-        const_set(:DEFAULT_BORDER_SPACING,  1)        # 0.125pt in 1/8 points
+        const_set(:DEFAULT_BORDER_SPACING,  1)        # 1pt. w:space is measured in points, not 1/8 points.
         const_set(:DEFAULT_BORDER_TYPE,     :top)
         
         # accessors

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

@@ -1,3 +1,4 @@
+require 'tempfile'
 require 'caracal/core/models/base_model'
 
 module Caracal
@@ -88,13 +89,11 @@ module Caracal
 
         def file
           @file ||= begin
-            if iframe_url.nil?
-              file = Tempfile.new('iframe')
-              file.write iframe_data
-              file.rewind
-            else
-              file = open(iframe_url)
-            end
+            content = iframe_url.to_s.empty? ? iframe_data : ::Caracal::Utilities.read_resource(iframe_url)
+            file    = Tempfile.new(['iframe', '.docx'])
+            file.binmode
+            file.write content
+            file.close    # flushes the write; rubyzip reopens by path
             file
           end
         end

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

@@ -27,6 +27,7 @@ module Caracal
         attr_reader :paragraph_italic
         attr_reader :paragraph_underline
         attr_reader :paragraph_bgcolor
+        attr_reader :paragraph_keep_next
 
         # initialization
         def initialize(options={}, &block)
@@ -63,7 +64,7 @@ module Caracal
         #========== SETTERS ===============================
 
         # booleans
-        [:bold, :italic, :underline].each do |m|
+        [:bold, :italic, :keep_next, :underline].each do |m|
           define_method "#{ m }" do |value|
             instance_variable_set("@paragraph_#{ m }", !!value)
           end

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

@@ -24,7 +24,17 @@ module Caracal
           setting:    'http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings',
           style:      'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles'
         }
-        
+
+        IMAGE_SIGNATURES = {
+          "\x89PNG\r\n\x1A\n".b  => 'png',
+          "\xFF\xD8\xFF".b       => 'jpeg',
+          'GIF8'.b               => 'gif',
+          'BM'.b                 => 'bmp',
+          "II*\x00".b            => 'tiff',
+          "MM\x00*".b            => 'tiff'
+        }
+        IMAGE_EXTENSIONS = %w(png jpeg jpg gif bmp tif tiff svg)
+
         # accessors
         attr_reader :relationship_id
         attr_reader :relationship_key
@@ -46,14 +56,27 @@ module Caracal
         
         def formatted_target
           if relationship_type == :image
-            ext = relationship_target.to_s.split('.').last
-            ext = ext.split('?').first
-            "media/image#{ relationship_id }.#{ ext }"
+            "media/image#{ relationship_id }.#{ image_extension }"
           else
             relationship_target
           end
         end
-        
+
+        # Prefers the type detected from the image bytes, then the
+        # extension of the target's path (ignoring any query string),
+        # and falls back to png so the part name is always valid.
+        #
+        def image_extension
+          data = relationship_data.to_s.b
+          if (match = IMAGE_SIGNATURES.find { |sig, _| data.start_with?(sig) })
+            return match.last
+          end
+
+          path = relationship_target.to_s.split(/[?#]/).first.to_s
+          ext  = File.extname(path).delete('.').downcase
+          IMAGE_EXTENSIONS.include?(ext) ? ext : 'png'
+        end
+
         def formatted_type
           TYPE_MAP.fetch(relationship_type)
         end

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

@@ -21,7 +21,9 @@ module Caracal
         const_set(:DEFAULT_TABLE_BORDER_COLOR,      'auto')
         const_set(:DEFAULT_TABLE_BORDER_LINE,       :single)
         const_set(:DEFAULT_TABLE_BORDER_SIZE,       0)          # units in 1/8 points
-        const_set(:DEFAULT_TABLE_BORDER_SPACING,    0)          
+        const_set(:DEFAULT_TABLE_BORDER_SPACING,    0)
+        const_set(:DEFAULT_TABLE_HEADER_ROWS,       0)
+        const_set(:DEFAULT_TABLE_CANT_SPLIT_ROWS,   {})
         
         # accessors
         attr_reader :table_align
@@ -36,7 +38,9 @@ module Caracal
         attr_reader :table_border_right       # returns border model
         attr_reader :table_border_horizontal  # returns border model
         attr_reader :table_border_vertical    # returns border model
-        
+        attr_reader :table_header_rows
+        attr_reader :table_column_widths
+
         # initialization
         def initialize(options={}, &block)
           @table_align          = DEFAULT_TABLE_ALIGN
@@ -44,7 +48,9 @@ module Caracal
           @table_border_line    = DEFAULT_TABLE_BORDER_LINE
           @table_border_size    = DEFAULT_TABLE_BORDER_SIZE
           @table_border_spacing = DEFAULT_TABLE_BORDER_SPACING
-          
+          @table_header_rows    = DEFAULT_TABLE_HEADER_ROWS
+          @table_rows_cant_split = {}
+
           super options, &block
         end
         
@@ -99,8 +105,33 @@ module Caracal
             m.apply_styles(options)
           end  
         end
+
+        # This method allows a user to specify one or more
+        # rows that should be rendered with the
+        # <w:cant_split /> property
+        #
+        # For example
+        #
+        # docx.table data do |t|
+        #   t.cant_split r.rows[0...-1]
+        # end
+        #
+        # would cause all rows in the table to be rendered
+        # with the <w:cant_split /> property.
+        def cant_split(models, options={})
+          models = rows.include?(models) ? [models] : models
+          models.each do |r|
+            @table_rows_cant_split[rows.index(r)] = true
+          end
+        end
         
-        
+        # This method returns true or false depending on
+        # if a row has been marked as a can't split row
+        # via the cant_split method.
+        def cant_split?(row_index)
+          !!@table_rows_cant_split[row_index]
+        end
+
         #=============== GETTERS ==============================
         
         # border attrs
@@ -121,7 +152,7 @@ module Caracal
         #=============== SETTERS ==============================
         
         # integers
-        [:border_size, :border_spacing, :width].each do |m|
+        [:border_size, :border_spacing, :header_rows, :width].each do |m|
           define_method "#{ m }" do |value|
             instance_variable_set("@table_#{ m }", value.to_i)
           end
@@ -148,7 +179,12 @@ module Caracal
             instance_variable_set("@table_#{ m }", value.to_s.to_sym)
           end
         end
-        
+
+        # column widths
+        def column_widths(value)
+          @table_column_widths = value.map(&:to_i) if value.is_a?(Array)
+        end
+
         # .data
         def data(value)
           begin
@@ -196,6 +232,7 @@ module Caracal
           k << [:data, :align, :width]
           k << [:border_color, :border_line, :border_size, :border_spacing]
           k << [:border_bottom, :border_left, :border_right, :border_top, :border_horizontal, :border_vertical]
+          k << [:column_widths]
           k.flatten
         end
         
@@ -203,4 +240,4 @@ module Caracal
       
     end
   end
-end
+end

data/lib/caracal/document.rb

@@ -1,4 +1,3 @@
-require 'open-uri'
 require 'zip'
 
 require 'caracal/core/bookmarks'
@@ -136,6 +135,8 @@ module Caracal
     # a string buffer. Order is important!
     #
     def render
+      register_nested_iframes(contents)
+
       buffer = ::Zip::OutputStream.write_buffer do |zip|
         render_package_relationships(zip)
         render_content_types(zip)
@@ -168,6 +169,28 @@ module Caracal
     #------------------------------------------------------
     private
 
+    #============ PREPROCESSING ===========================
+
+    # Iframes inside table cells can't register their namespaces
+    # on the document when they're created, so collect them here.
+    #
+    def register_nested_iframes(models)
+      models.each do |model|
+        case model
+        when Caracal::Core::Models::IFrameModel
+          model.namespaces.each do |(prefix, href)|
+            namespace({ prefix: prefix, href: href })
+          end
+          model.ignorables.each do |prefix|
+            ignorable(prefix)
+          end
+        when Caracal::Core::Models::TableModel
+          model.cells.each { |cell| register_nested_iframes(cell.contents) }
+        end
+      end
+    end
+
+
     #============ RENDERERS ===============================
 
     def render_app(zip)
@@ -225,7 +248,7 @@ module Caracal
         if rel.relationship_data.to_s.size > 0
           content = rel.relationship_data
         else
-          content = open(rel.relationship_target).read
+          content = ::Caracal::Utilities.read_resource(rel.relationship_target)
         end
 
         zip.put_next_entry("word/#{ rel.formatted_target }")

data/lib/caracal/renderers/content_types_renderer.rb

@@ -17,10 +17,14 @@ module Caracal
       def to_xml
         builder = ::Nokogiri::XML::Builder.with(declaration_xml) do |xml|
           xml.send 'Types', root_options do
+            xml.send 'Default', { 'Extension' => 'bmp',  'ContentType' => 'image/bmp' }
             xml.send 'Default', { 'Extension' => 'gif',  'ContentType' => 'image/gif' }
             xml.send 'Default', { 'Extension' => 'jpeg', 'ContentType' => 'image/jpeg' }
             xml.send 'Default', { 'Extension' => 'jpg',  'ContentType' => 'image/jpeg' }
             xml.send 'Default', { 'Extension' => 'png',  'ContentType' => 'image/png' }
+            xml.send 'Default', { 'Extension' => 'svg',  'ContentType' => 'image/svg+xml' }
+            xml.send 'Default', { 'Extension' => 'tif',  'ContentType' => 'image/tiff' }
+            xml.send 'Default', { 'Extension' => 'tiff', 'ContentType' => 'image/tiff' }
             xml.send 'Default', { 'Extension' => 'rels', 'ContentType' => 'application/vnd.openxmlformats-package.relationships+xml' }
             xml.send 'Default', { 'Extension' => 'xml',  'ContentType' => 'application/xml' }
             xml.send 'Override', { 'PartName' => '/docProps/app.xml',    'ContentType' => 'application/vnd.openxmlformats-officedocument.extended-properties+xml' }

data/lib/caracal/renderers/custom_renderer.rb

@@ -23,7 +23,7 @@ module Caracal
                 { fmtid: '{D5CDD505-2E9C-101B-9397-08002B2CF9AE}', pid: index + 2, name: property.custom_property_name } do
                   case property.custom_property_type.downcase
                   when  'text'
-                    xml['vt'].lpwstr property.custom_property_value
+                    xml['vt'].lpwstr xml_safe(property.custom_property_value)
                   when 'date'
                     xml['vt'].filetime property.custom_property_value.to_date
                   when 'number'
@@ -33,11 +33,11 @@ module Caracal
                       xml['vt'].bool property.custom_property_value
                     else
                       # Not a boolean sent, so reverting to string so docx will open
-                      xml['vt'].lpwstr property.custom_property_value
+                      xml['vt'].lpwstr xml_safe(property.custom_property_value)
                     end
                   else
                     # Fail to string type
-                    xml['vt'].lpwstr property.custom_property_value
+                    xml['vt'].lpwstr xml_safe(property.custom_property_value)
                 end
               end
             end

data/lib/caracal/renderers/document_renderer.rb

@@ -214,7 +214,7 @@ module Caracal
         xml['w'].hyperlink(hyperlink_options) do
           xml['w'].r run_options do
             render_run_attributes(xml, model, false)
-            xml['w'].t({ 'xml:space' => 'preserve' }, model.link_content)
+            xml['w'].t({ 'xml:space' => 'preserve' }, xml_safe(model.link_content))
           end
         end
       end
@@ -275,6 +275,7 @@ module Caracal
             xml['w'].pStyle({ 'w:val' => model.paragraph_style })  unless model.paragraph_style.nil?
             xml['w'].contextualSpacing({ 'w:val' => '0' })
             xml['w'].jc({ 'w:val' => model.paragraph_align })  unless model.paragraph_align.nil?
+            xml['w'].keepNext if model.paragraph_keep_next == true
             render_run_attributes(xml, model, true)
           end
           model.runs.each do |run|
@@ -299,7 +300,7 @@ module Caracal
       def render_text(xml, model)
         xml['w'].r run_options do
           render_run_attributes(xml, model, false)
-          xml['w'].t({ 'xml:space' => 'preserve' }, model.text_content)
+          xml['w'].t({ 'xml:space' => 'preserve' }, xml_safe(model.text_content))
         end
       end
 
@@ -332,25 +333,28 @@ module Caracal
             xml['w'].tblLook({ 'w:val'  => '0600'  })
           end
           xml['w'].tblGrid do
-            model.rows.first.each do |tc|
-              (tc.cell_colspan || 1).times do
-                xml['w'].gridCol({ 'w:w' => tc.cell_width })
-              end
+            column_widths = model.table_column_widths
+            column_widths ||= model.rows.first.map do |tc|
+              [tc.cell_width] * (tc.cell_colspan || 1)
+            end.flatten
+
+            column_widths.each do |width|
+              xml['w'].gridCol({ 'w:w' => width })
             end
+
             xml['w'].tblGridChange({ 'w:id' => '0' }) do
               xml['w'].tblGrid do
-                model.rows.first.each do |tc|
-                  (tc.cell_colspan || 1).times do
-                    xml['w'].gridCol({ 'w:w' => tc.cell_width })
-                  end
+                column_widths.each do |width|
+                  xml['w'].gridCol({ 'w:w' => width })
                 end
               end
             end
           end
 
           rowspan_hash = {}
-          model.rows.each do |row|
+          model.rows.each.with_index do |row, row_index|
             xml['w'].tr do
+              render_table_row_properties(xml, model, row_index)
               tc_index = 0
               row.each do |tc|
                 xml['w'].tc do
@@ -390,6 +394,13 @@ module Caracal
         end
       end
 
+      def render_table_row_properties(xml, model, index)
+        xml['w'].trPr do
+          xml['w'].cantSplit if model.cant_split?(index)
+          xml['w'].tblHeader if index < model.table_header_rows
+        end
+      end
+
 
       #============= OPTIONS ===================================
 

data/lib/caracal/renderers/footer_renderer.rb

@@ -31,7 +31,7 @@ module Caracal
                     end
                   end
                   xml['w'].t({ 'xml:space' => 'preserve' }) do
-                    xml.text "#{ document.page_number_label } "
+                    xml.text "#{ xml_safe(document.page_number_label) } "
                   end
                 end
               end

data/lib/caracal/renderers/xml_renderer.rb

@@ -71,6 +71,14 @@ module Caracal
         { 'w:rsidR' => '00000000', 'w:rsidRPr' => '00000000', 'w:rsidDel' => '00000000' }
       end
 
+      # This method removes control characters that XML 1.0 doesn't
+      # allow. A single one makes Word reject the whole document.
+      #
+      def xml_safe(value)
+        str = value.to_s
+        str.valid_encoding? ? str.gsub(/[\x00-\x08\x0B\x0C\x0E-\x1F]/, '') : str
+      end
+
       # These save options force Nokogiri to remove indentation and
       # line feeds from the output.
       #

data/lib/caracal/utilities.rb

@@ -1,3 +1,5 @@
+require 'open-uri'
+
 # We're using this strategy borrowed from ActiveSupport to
 # make command syntax a little more flexible. In a perfect 
 # world we'd just use the double splat feature of Ruby, but 
@@ -18,6 +20,19 @@ module Caracal
         {}
       end
     end
-    
+
+    # Reads binary content from an http(s) URL or a local file path.
+    # Avoids Kernel#open, which no longer fetches URLs on Ruby 3+,
+    # reads in text mode on Windows, and runs a leading "|" as a
+    # shell command.
+    def self.read_resource(location)
+      location = location.to_s
+      if location =~ /\Ahttps?:\/\//i
+        URI.open(location, 'rb', &:read)
+      else
+        File.binread(location)
+      end
+    end
+
   end
 end

data/lib/caracal/version.rb

@@ -1,3 +1,3 @@
 module Caracal
-  VERSION = '1.4.1'
+  VERSION = '1.5.0'
 end

data/lib/caracal.rb

@@ -32,6 +32,7 @@ end
 # and Caracal::Core::Models::TableCellModel.
 #
 Caracal::Core::Models::TableCellModel.class_eval do
+  include Caracal::Core::IFrames
   include Caracal::Core::Images
   include Caracal::Core::Lists
   include Caracal::Core::Rules

data/spec/lib/caracal/core/models/paragraph_model_spec.rb

@@ -11,6 +11,7 @@ describe Caracal::Core::Models::ParagraphModel do
       italic      false
       underline   true
       bgcolor     'cccccc'
+      keep_next   true
     end
   end
 
@@ -31,6 +32,7 @@ describe Caracal::Core::Models::ParagraphModel do
       it { expect(subject.paragraph_italic).to eq false }
       it { expect(subject.paragraph_underline).to eq true }
       it { expect(subject.paragraph_bgcolor).to eq 'cccccc' }
+      it { expect(subject.paragraph_keep_next).to eq true }
     end
 
   end
@@ -70,6 +72,11 @@ describe Caracal::Core::Models::ParagraphModel do
 
       it { expect(subject.paragraph_italic).to eq true }
     end
+    describe '.keep_next' do
+      before { subject.keep_next(true) }
+
+      it { expect(subject.paragraph_keep_next).to eq true }
+    end
     describe '.underline' do
       before { subject.underline(true) }
 

data/spec/lib/caracal/core/models/table_model_spec.rb

@@ -72,6 +72,24 @@ describe Caracal::Core::Models::TableModel do
       describe '.cells' do
         it { expect(subject.cells[0]).to eq 'top left' }   
       end
+
+      # .cant_split and cant_split?
+      describe '.cant_split and .cant_split?' do
+        it { expect(subject.cant_split?(0)).to eq(false) }
+
+        describe "when first row can't split" do 
+          before { subject.cant_split subject.rows[0] }
+
+          it { expect(subject.cant_split?(0)).to eq(true) }
+        end 
+
+        describe 'when no rows can be split' do
+          before { subject.cant_split subject.rows }
+
+          it { expect(subject.cant_split?(0)).to eq(true) }
+          it { expect(subject.cant_split?(1)).to eq(true) } 
+        end  
+      end
     end    
     
     
@@ -178,6 +196,13 @@ describe Caracal::Core::Models::TableModel do
       
       it { expect(subject.table_width).to eq 7500 }
     end
+
+    # .column_widths
+    describe '.column_widths' do
+      before { subject.column_widths([2400, '1200']) }
+
+      it { expect(subject.table_column_widths).to eq [2400, 1200] }
+    end
     
     
     
@@ -209,7 +234,7 @@ describe Caracal::Core::Models::TableModel do
     # .option_keys
     describe '.option_keys' do
       let(:actual)     { subject.send(:option_keys).sort }
-      let(:expected1)  { [:data, :align, :width] }
+      let(:expected1)  { [:data, :align, :width, :column_widths] }
       let(:expected2)  { [:border_color, :border_line, :border_size, :border_spacing] }
       let(:expected3)  { [:border_top, :border_bottom, :border_left, :border_right, :border_horizontal, :border_vertical] }
       let(:expected)   { (expected1 + expected2 + expected3).sort }
@@ -219,4 +244,4 @@ describe Caracal::Core::Models::TableModel do
     
   end
   
-end
+end

data/spec/lib/caracal/core/tables_spec.rb

@@ -18,8 +18,15 @@ describe Caracal::Core::Tables do
       
       it { expect(subject.contents.size).to eq size + 1 }
       it { expect(subject.contents.last).to be_a(Caracal::Core::Models::TableModel) }
+      it { expect(subject.contents.last.table_header_rows).to eq(0) }
+      
+      context 'when .header_rows' do
+        before { subject.table [['Sample Text']] do header_rows 1 end }
+
+        it { expect(subject.contents.last.table_header_rows).to eq(1) }
+      end
     end
     
   end
   
-end
+end

data/spec/lib/caracal/document_output_spec.rb

@@ -0,0 +1,212 @@
+require 'spec_helper'
+require 'stringio'
+require 'tempfile'
+
+describe Caracal::Document do
+  W_NS = { 'w' => 'http://schemas.openxmlformats.org/wordprocessingml/2006/main' }
+
+  let(:png)  { 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='.unpack1('m') }
+  let(:jpeg) { "\xFF\xD8\xFF\xE0".b + 'rest of jpeg' }
+  # the PNG plus bytes a text-mode read would mangle on Windows
+  let(:image_bytes) { png + "\r\n\x1A\r\n".b }
+
+  def parts(docx)
+    result = {}
+    Zip::File.open_buffer(StringIO.new(docx.render.string)) do |zip|
+      zip.each { |e| result[e.name] = e.get_input_stream.read }
+    end
+    result
+  end
+
+  def strict_xml(str)
+    Nokogiri::XML(str) { |config| config.strict }
+  end
+
+
+  #-------------------------------------------------------------
+  # Control characters
+  #-------------------------------------------------------------
+
+  describe 'text containing characters XML does not allow' do
+    let(:text) { "a\x01b\x0Bc\td" }
+
+    it 'strips them from paragraphs, links and table cells' do
+      text = self.text
+      docx = described_class.new('test.docx')
+      docx.p text
+      docx.p { link text, 'https://www.example.com' }
+      docx.table [[text]]
+
+      xml = parts(docx)['word/document.xml']
+      expect { strict_xml(xml) }.not_to raise_error
+      expect(xml.scan("abc\td").size).to eq 3
+    end
+
+    it 'strips them from custom properties' do
+      text = self.text
+      docx = described_class.new('test.docx')
+      docx.custom_property { |p| p.name 'note'; p.value text; p.type :text }
+
+      expect { strict_xml(parts(docx)['docProps/custom.xml']) }.not_to raise_error
+    end
+  end
+
+
+  #-------------------------------------------------------------
+  # Image part names
+  #-------------------------------------------------------------
+
+  describe 'image part names' do
+    it 'uses the type of the supplied data rather than the URL' do
+      png, jpeg = self.png, self.jpeg
+      docx = described_class.new('test.docx')
+      docx.img('https://bucket.example.com/rails/blobs/abc123?signature=x', width: 10, height: 10) { |i| i.data png }
+      docx.img('https://bucket.example.com/photo.png?signature=y',          width: 10, height: 10) { |i| i.data jpeg }
+
+      media = parts(docx).keys.grep(%r{\Aword/media/})
+      expect(media.map { |name| File.extname(name) }).to eq %w(.png .jpeg)
+    end
+
+    {
+      'https://example.com/a/photo.JPG?x=1#frag' => 'jpg',
+      'https://example.com/rails/blobs/abc'     => 'png',
+      'https://example.com'                     => 'png',
+      '/tmp/picture.gif'                        => 'gif',
+      'Picture 1'                               => 'png'
+    }.each do |target, ext|
+      it "names a #{ target.inspect } target with .#{ ext } when no data is supplied" do
+        rel = Caracal::Core::Models::RelationshipModel.new(id: 1, type: :image, target: target)
+        expect(rel.formatted_target).to eq "media/image1.#{ ext }"
+      end
+    end
+
+    it 'registers content types for bmp, tiff and svg' do
+      xml = parts(described_class.new('test.docx'))['[Content_Types].xml']
+      %w(bmp tif tiff svg).each { |ext| expect(xml).to include %(Extension="#{ ext }") }
+    end
+  end
+
+
+  #-------------------------------------------------------------
+  # Image sources
+  #-------------------------------------------------------------
+
+  describe 'image sources' do
+    def media(docx)
+      parts(docx).select { |name, _| name.start_with?('word/media/') }.values
+    end
+
+    it 'embeds a local image byte-for-byte' do
+      file = Tempfile.new(['image', '.png'])
+      file.binmode
+      file.write(image_bytes)
+      file.close
+
+      docx = described_class.new('test.docx')
+      docx.img file.path, width: 10, height: 10
+
+      expect(media(docx)).to eq [image_bytes]
+    end
+
+    it 'fetches an http(s) image via URI.open' do
+      url = 'https://www.example.com/image.png'
+      bytes = image_bytes
+      expect(URI).to receive(:open).with(url, 'rb') { |*_, &blk| blk.call(StringIO.new(bytes)) }
+
+      docx = described_class.new('test.docx')
+      docx.img url, width: 10, height: 10
+
+      expect(media(docx)).to eq [bytes]
+    end
+
+    it 'does not run a "|" target as a shell command' do
+      marker = File.join(Dir.tmpdir, "caracal-pipe-#{ Process.pid }")
+      docx   = described_class.new('test.docx')
+      docx.img "|touch #{ marker }", width: 10, height: 10
+
+      expect { docx.render }.to raise_error(Errno::ENOENT)
+      expect(File.exist?(marker)).to eq false
+    end
+  end
+
+
+  #-------------------------------------------------------------
+  # Table column widths
+  #-------------------------------------------------------------
+
+  describe 'table grid column widths' do
+    let(:data) do
+      [
+        [{ content: 'First', width: 2400 }, { content: 'Second', width: 1200 }],
+        [{ content: 'Third', width: 1800 }, { content: 'Fourth', width: 1800 }]
+      ]
+    end
+
+    it 'uses explicit column widths when set' do
+      docx = described_class.new('test.docx')
+      docx.table(data) { column_widths [1000, 2600] }
+
+      xml = strict_xml(parts(docx)['word/document.xml'])
+      expect(xml.xpath('//w:tbl/w:tblGrid/w:gridCol/@w:w', W_NS).map(&:value)).to eq %w(1000 2600)
+    end
+
+    it 'falls back to the first row widths otherwise' do
+      docx = described_class.new('test.docx')
+      docx.table(data)
+
+      xml = strict_xml(parts(docx)['word/document.xml'])
+      expect(xml.xpath('//w:tbl/w:tblGrid/w:gridCol/@w:w', W_NS).map(&:value)).to eq %w(2400 1200)
+    end
+  end
+
+
+  #-------------------------------------------------------------
+  # Iframes
+  #-------------------------------------------------------------
+
+  describe 'iframes' do
+    let(:snippet) do
+      inner = described_class.new('inner.docx')
+      inner.p 'Text from the iframe'
+      inner.render.string
+    end
+
+    it 'renders an iframe at the top level' do
+      docx = described_class.new('test.docx')
+      docx.iframe data: snippet
+
+      xml = strict_xml(parts(docx)['word/document.xml'])
+      expect(xml.at_xpath('//w:body/w:p/w:r/w:t[.="Text from the iframe"]', W_NS)).not_to be_nil
+    end
+
+    it 'renders an iframe inside a table cell' do
+      data = snippet
+      cell = Caracal::Core::Models::TableCellModel.new { |c| c.iframe(data: data) }
+      docx = described_class.new('test.docx')
+      docx.table [[cell]]
+
+      xml = strict_xml(parts(docx)['word/document.xml'])
+      expect(xml.at_xpath('//w:tc//w:t[.="Text from the iframe"]', W_NS)).not_to be_nil
+    end
+
+    it 'uses the data when the url is explicitly nil' do
+      docx = described_class.new('test.docx')
+      docx.iframe url: nil, data: snippet
+
+      xml = strict_xml(parts(docx)['word/document.xml'])
+      expect(xml.at_xpath('//w:body/w:p/w:r/w:t[.="Text from the iframe"]', W_NS)).not_to be_nil
+    end
+
+    it 'renders an iframe fetched from a URL' do
+      url  = 'https://www.example.com/snippet.docx'
+      data = snippet
+      expect(URI).to receive(:open).with(url, 'rb') { |*_, &blk| blk.call(StringIO.new(data)) }
+
+      docx = described_class.new('test.docx')
+      docx.iframe url: url
+
+      xml = strict_xml(parts(docx)['word/document.xml'])
+      expect(xml.at_xpath('//w:body/w:p/w:r/w:t[.="Text from the iframe"]', W_NS)).not_to be_nil
+    end
+  end
+end

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: caracal
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.5.0
 platform: ruby
 authors:
-- Trade Infomatics
+- Urvin LLC
 - John Dugan
-autorequire: 
+- Dave Lauer
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-05-14 00:00:00.000000000 Z
+date: 2026-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -29,16 +30,22 @@ dependencies:
   name: rubyzip
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: 1.1.6
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.6
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
@@ -57,28 +64,28 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '10.0'
 - !ruby/object:Gem::Dependency
@@ -99,12 +106,13 @@ description: " Caracal is a pure Ruby Microsoft Word generation library that pro
   professional quality MSWord documents (docx) using a simple, HTML-style DSL. "
 email:
 - jpdugan@gmail.com
+- dave@plia.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -212,14 +220,15 @@ files:
 - spec/lib/caracal/core/styles_spec.rb
 - spec/lib/caracal/core/tables_spec.rb
 - spec/lib/caracal/core/text_spec.rb
+- spec/lib/caracal/document_output_spec.rb
 - spec/lib/caracal/errors_spec.rb
 - spec/spec_helper.rb
 - spec/support/_fixtures/snippet.docx
-homepage: https://github.com/trade-informatics/caracal
+homepage: https://github.com/urvin-compliance/caracal
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -227,16 +236,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Fast, professional Microsoft Word (docx) writer for Ruby.
 test_files:
@@ -280,6 +288,7 @@ test_files:
 - spec/lib/caracal/core/styles_spec.rb
 - spec/lib/caracal/core/tables_spec.rb
 - spec/lib/caracal/core/text_spec.rb
+- spec/lib/caracal/document_output_spec.rb
 - spec/lib/caracal/errors_spec.rb
 - spec/spec_helper.rb
 - spec/support/_fixtures/snippet.docx

data/.travis.yml

@@ -1,20 +0,0 @@
-language: ruby
-cache: bundler
-rvm:
-  - 1.9.2
-  - 1.9.3
-  - 2.0.0
-  - 2.1
-  - rbx-2
-  - ruby-head
-  - jruby-head
-matrix:
-  include:
-    - rvm: jruby
-      env: JRUBY_OPTS="--1.9 --debug"
-    - rvm: jruby
-      env: JRUBY_OPTS="--2.0 --debug"
-  allow_failures:
-    - rvm: ruby-head
-    - rvm: jruby-head
-  fast_finish: true