prawn-svg 0.32.0 → 0.34.0

data/prawn-svg.gemspec

@@ -1,27 +1,29 @@
-# -*- encoding: utf-8 -*-
-require File.expand_path('../lib/prawn/svg/version', __FILE__)
+require File.expand_path('lib/prawn/svg/version', __dir__)
 
 Gem::Specification.new do |gem|
   gem.name = 'prawn-svg'
   gem.version = Prawn::SVG::VERSION
-  gem.summary = "SVG renderer for Prawn PDF library"
-  gem.description = "This gem allows you to render SVG directly into a PDF using the 'prawn' gem.  Since PDF is vector-based, you'll get nice scaled graphics if you use SVG instead of an image."
-  gem.author = "Roger Nesbitt"
-  gem.email = "roger@seriousorange.com"
-  gem.homepage = "http://github.com/mogest/prawn-svg"
+  gem.summary = 'SVG renderer for Prawn PDF library'
+  gem.description = <<-EOT.strip
+    This gem allows you to render SVG directly into a PDF using the 'prawn' gem.  Since PDF is vector-based, you'll get nice scaled graphics if you use SVG instead of an image.
+  EOT
+  gem.author = 'Mog Nesbitt'
+  gem.email = 'mog@seriousorange.com'
+  gem.homepage = 'http://github.com/mogest/prawn-svg'
   gem.license = 'MIT'
 
-  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
   gem.files         = `git ls-files`.split("\n")
   gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  gem.name          = "prawn-svg"
-  gem.require_paths = ["lib"]
+  gem.require_paths = ['lib']
 
-  gem.required_ruby_version = '>= 2.3.0'
+  gem.required_ruby_version = '>= 2.5.0'
 
-  gem.add_runtime_dependency "prawn", ">= 0.11.1", "< 3"
-  gem.add_runtime_dependency "css_parser", "~> 1.6"
-  gem.add_runtime_dependency "rexml", "~> 3.2"
-  gem.add_development_dependency "rspec", "~> 3.0"
-  gem.add_development_dependency "rake", "~> 13.0"
+  gem.add_runtime_dependency 'base64', '~> 0.1.0'
+  gem.add_runtime_dependency 'css_parser', '~> 1.6'
+  gem.add_runtime_dependency 'matrix', '~> 0.4.2'
+  gem.add_runtime_dependency 'prawn', '>= 0.11.1', '< 3'
+  gem.add_runtime_dependency 'rexml', '~> 3.2'
+  gem.add_development_dependency 'rake', '~> 13.0'
+  gem.add_development_dependency 'rspec', '~> 3.0'
 end

data/spec/prawn/svg/color_spec.rb

@@ -1,38 +1,43 @@
 require File.dirname(__FILE__) + '/../../spec_helper'
 
 describe Prawn::SVG::Color do
-  describe "::color_to_hex" do
+  describe "::css_color_to_prawn_color" do
     it "converts #xxx to a hex value" do
-      Prawn::SVG::Color.color_to_hex("#9ab").should == "99aabb"
+      Prawn::SVG::Color.css_color_to_prawn_color("#9ab").should == "99aabb"
     end
 
     it "converts #xxxxxx to a hex value" do
-      Prawn::SVG::Color.color_to_hex("#9ab123").should == "9ab123"
+      Prawn::SVG::Color.css_color_to_prawn_color("#9ab123").should == "9ab123"
     end
 
     it "converts an html colour name to a hex value" do
-      Prawn::SVG::Color.color_to_hex("White").should == "ffffff"
+      Prawn::SVG::Color.css_color_to_prawn_color("White").should == "ffffff"
     end
 
     it "converts an rgb string to a hex value" do
-      Prawn::SVG::Color.color_to_hex("rgb(16, 32, 48)").should == "102030"
-      Prawn::SVG::Color.color_to_hex("rgb(-5, 50%, 120%)").should == "007fff"
+      Prawn::SVG::Color.css_color_to_prawn_color("rgb(16, 32, 48)").should == "102030"
+      Prawn::SVG::Color.css_color_to_prawn_color("rgb(-5, 50%, 120%)").should == "007fff"
+    end
+
+    it "converts a CMYK string to an array of numbers" do
+      expect(Prawn::SVG::Color.css_color_to_prawn_color("device-cmyk(0, 0.32, 0.48, 1)")).to eq [0, 32, 48, 100]
+      expect(Prawn::SVG::Color.css_color_to_prawn_color("device-cmyk(-5, 50%, 120%, -5%)")).to eq [0, 50, 100, 0]
     end
 
     it "scans the string and finds the first colour it can parse" do
-      Prawn::SVG::Color.color_to_hex("function(#someurl, 0) nonexistent rgb( 3 ,4,5 ) white").should == "030405"
+      Prawn::SVG::Color.css_color_to_prawn_color("function(#someurl, 0) nonexistent rgb( 3 ,4,5 ) white").should == "030405"
     end
 
     it "ignores url()s" do
-      expect(Prawn::SVG::Color.color_to_hex("url(#someplace) red")).to eq 'ff0000'
+      expect(Prawn::SVG::Color.css_color_to_prawn_color("url(#someplace) red")).to eq 'ff0000'
     end
 
     it "returns black if the color doesn't exist" do
-      expect(Prawn::SVG::Color.color_to_hex("blurble")).to eq '000000'
+      expect(Prawn::SVG::Color.css_color_to_prawn_color("blurble")).to eq '000000'
     end
 
     it "returns nil if there's no fallback after a url()" do
-      expect(Prawn::SVG::Color.color_to_hex("url(#someplace)")).to be nil
+      expect(Prawn::SVG::Color.css_color_to_prawn_color("url(#someplace)")).to be nil
     end
   end
 
@@ -42,19 +47,27 @@ describe Prawn::SVG::Color do
     let(:drob_gradient) { double }
 
     it "returns a list of all colors parsed, ignoring impossible or non-existent colors" do
-      results = Prawn::SVG::Color.parse("url(#nope) url(#flan) blurble green #123", gradients)
+      results = Prawn::SVG::Color.parse("url(#nope) url(#flan) blurble green #123", gradients, :rgb)
       expect(results).to eq [
         flan_gradient,
-        Prawn::SVG::Color::Hex.new("008000"),
-        Prawn::SVG::Color::Hex.new("112233")
+        Prawn::SVG::Color::RGB.new("008000"),
+        Prawn::SVG::Color::RGB.new("112233")
       ]
     end
 
     it "appends black to the list if there aren't any url() references" do
-      results = Prawn::SVG::Color.parse("blurble green", gradients)
+      results = Prawn::SVG::Color.parse("blurble green", gradients, :rgb)
+      expect(results).to eq [
+        Prawn::SVG::Color::RGB.new("008000"),
+        Prawn::SVG::Color::RGB.new("000000")
+      ]
+    end
+
+    it "works in CMYK color mode" do
+      results = Prawn::SVG::Color.parse("blurble green", gradients, :cmyk)
       expect(results).to eq [
-        Prawn::SVG::Color::Hex.new("008000"),
-        Prawn::SVG::Color::Hex.new("000000")
+        Prawn::SVG::Color::CMYK.new([100, 0, 100, 50]),
+        Prawn::SVG::Color::CMYK.new([0, 0, 0, 100])
       ]
     end
   end

data/spec/prawn/svg/document_spec.rb

@@ -5,6 +5,23 @@ describe Prawn::SVG::Document do
   let(:options) { {} }
 
   describe "#initialize" do
+    context "with a well-formed document" do
+      let(:svg) { "<svg></svg>" }
+      let(:options) { {color_mode: :cmyk} }
+
+      it "parses the XML and yields itself to its block" do
+        yielded = nil
+
+        document = Prawn::SVG::Document.new(svg, bounds, options) do |doc|
+          yielded = doc
+        end
+
+        expect(yielded).to eq document
+        expect(document.color_mode).to eq :cmyk
+        expect(document.root.name).to eq 'svg'
+      end
+    end
+
     context "when unparsable XML is provided" do
       let(:svg) { "this isn't SVG data" }
 

data/spec/prawn/svg/elements/marker_spec.rb

@@ -73,10 +73,10 @@ RSpec.describe Prawn::SVG::Elements::Marker do
                 ["stroke_color", ["000000"], {}, []],
                 ["line_width", [100.0], {}, []],
                 ["cap_style", [:butt], {}, []],
+                ["join_style", [:miter], {}, []],
                 ["undash", [], {}, []],
                 ["save", [], {}, []],
                 ["fill", [], {}, [
-                    ["join_style", [:bevel], {}, []],
                     ["move_to", [[0.0, 600.0]], {}, []],
                     ["line_to", [[10.0, 595.0]], {}, []],
                     ["line_to", [[0.0, 590.0]], {}, []],

data/spec/prawn/svg/elements/root_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Prawn::SVG::Elements::Root do
+  let(:color_mode) { :rgb }
+  let(:sizing) do
+    instance_double(Prawn::SVG::Calculators::DocumentSizing, x_offset: 0, y_offset: 0, x_scale: 1, y_scale: 1)
+  end
+  let(:document) do
+    instance_double(Prawn::SVG::Document, color_mode: color_mode, sizing: sizing)
+  end
+  let(:source) { double(name: 'svg', attributes: {}) }
+  let(:state) { Prawn::SVG::State.new }
+  let(:element) { Prawn::SVG::Elements::Root.new(document, source, [], state) }
+
+  it 'uses RGB black as the default color' do
+    element.apply
+    expect(element.calls.first).to eq ['fill_color', ['000000'], {}, []]
+  end
+
+  context 'when in CMYK mode' do
+    let(:color_mode) { :cmyk }
+
+    it 'uses CMYK black as the default color' do
+      element.apply
+      expect(element.calls.first).to eq ['fill_color', [[0, 0, 0, 100]], {}, []]
+    end
+  end
+end

data/spec/prawn/svg/elements/text_spec.rb

@@ -237,4 +237,31 @@ Even more
       ]
     end
   end
+
+  describe "when there's a comment inside the text element" do
+    let(:svg) { '<text>Hi <!-- comment --> there</text>' }
+
+    it "ignores the comment" do
+      element.process
+
+      expect(flatten_calls(element.calls)).to eq [
+        ["text_group", [], {}],
+        ["font", ["Helvetica"], {:style=>:normal}],
+        ["draw_text",
+          ["Hi "],
+          {:size=>16,
+            :style=>:normal,
+            :text_anchor=>"start",
+            :at=>[:relative, :relative],
+            :offset=>[0, 0]}],
+        ["draw_text",
+          ["there"],
+          {:size=>16,
+            :style=>:normal,
+            :text_anchor=>"start",
+            :at=>[:relative, :relative],
+            :offset=>[0, 0]}]
+      ]
+    end
+  end
 end

data/spec/prawn/svg/interface_spec.rb

@@ -39,11 +39,19 @@ describe Prawn::SVG::Interface do
       end
 
       context "when fill_and_stroke is issued" do
+        def expect_rectangle
+          if RUBY_VERSION.start_with?("2.7.")
+            expect(prawn).to receive(:rectangle)
+          else
+            expect(prawn).to receive(:rectangle).with([0, 100], 10, 10)
+          end
+        end
+
         context "and fill rule is not set" do
           let(:interface) { Prawn::SVG::Interface.new('<svg width="250" height="100"><rect width="10" height="10" stroke="red"></rect></svg>', prawn, {}) }
 
           it "adds content 'B'" do
-            expect(prawn).to receive(:rectangle).with([0, 100], 10, 10)
+            expect_rectangle
             expect(prawn).to receive(:add_content).with("W n")
             expect(prawn).to receive(:add_content).with("B")
             interface.draw
@@ -54,7 +62,7 @@ describe Prawn::SVG::Interface do
           let(:interface) { Prawn::SVG::Interface.new('<svg width="250" height="100"><rect width="10" height="10" stroke="red" fill-rule="evenodd"></rect></svg>', prawn, {}) }
 
           it "adds content 'B*'" do
-            expect(prawn).to receive(:rectangle).with([0, 100], 10, 10)
+            expect_rectangle
             expect(prawn).to receive(:add_content).with("W n")
             expect(prawn).to receive(:add_content).with("B*")
             interface.draw

data/spec/sample_images/image_svg_embed.svg

@@ -0,0 +1,6 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1">
+    <rect x="0" y="0" width="100" height="100" fill="red" stroke="blue" stroke-width="5" />
+</svg>
+

data/spec/sample_svg/cmyk.svg

@@ -0,0 +1,5 @@
+<svg width="154" height="28" viewBox="0 0 154 28" xmlns="http://www.w3.org/2000/svg">
+  <g fill="device-cmyk(0.5, 50%, 0.0, 0)" fill-rule="evenodd">
+    <path d="m19.88 23.715-4.083 3.337a4.243 4.243 0 0 1-1.626-.965c-.463-.44-.768-.943-.915-1.508l-3.185 1.812c-.125.068-.336.138-.635.212a3.29 3.29 0 0 1-.754.11c-2.451 0-4.476-.841-6.073-2.524C1.011 22.506.212 20.168.212 17.175c0-2.846.83-5.192 2.491-7.039 1.66-1.847 3.777-2.77 6.353-2.77 1.027 0 1.988.203 2.88.61.892.407 1.479.768 1.762 1.084l2.948-1.067 1.034.305V19.92c0 1.016.178 1.824.533 2.422.354.599.91 1.057 1.667 1.373zm-7.166-2.541v-7.945a4.404 4.404 0 0 0-1.33-1.087c-.548-.303-1.217-.454-2.008-.454-1.141 0-2.086.416-2.837 1.248-.751.831-1.126 2.208-1.126 4.131 0 1.527.35 2.752 1.05 3.674.7.922 1.683 1.383 2.948 1.383.723 0 1.4-.113 2.033-.339.632-.227 1.055-.431 1.27-.611zM39.463 26.51h-3.947l-1.118-1.66-2.728 1.491c-.226.125-.553.217-.982.28a7.964 7.964 0 0 1-1.118.093c-2.666 0-4.69-.897-6.073-2.693s-2.081-4.049-2.092-6.759c-.011-2.937.822-5.274 2.499-7.014 1.677-1.739 3.894-2.609 6.649-2.609.79 0 1.485.062 2.083.187a5.903 5.903 0 0 1 1.728.661V.491h5.099V26.51zm-5.099-5.607v-8.03c-.283-.35-.751-.652-1.406-.906a5.855 5.855 0 0 0-2.134-.381c-1.423 0-2.482.415-3.177 1.245-.694.83-1.042 2.149-1.042 3.956 0 1.841.37 3.216 1.109 4.125.74.91 1.742 1.364 3.007 1.364.813 0 1.527-.135 2.143-.406.616-.271 1.116-.595 1.5-.967zM67.009 26.51h-5.184V15.075c0-.666-.237-1.256-.711-1.77-.475-.514-1.203-.771-2.186-.771-.938 0-1.722.195-2.354.584-.633.39-1.135.754-1.508 1.093V26.51h-5.184V8.299l5.184-.373v1.779l2.155-1.237a7.47 7.47 0 0 1 1.976-.805 8.464 8.464 0 0 1 2.01-.246c1.798 0 3.215.557 4.25 1.669 1.035 1.112 1.553 2.578 1.553 4.396V26.51h-.001zM89.303 17.057c0 2.993-.857 5.376-2.572 7.149-1.716 1.773-4.068 2.66-7.059 2.66-3.216 0-5.625-.892-7.227-2.677-1.603-1.784-2.404-4.162-2.404-7.132 0-2.699.863-5.008 2.59-6.929 1.726-1.92 4.073-2.88 7.041-2.88 2.979 0 5.328.887 7.05 2.66 1.72 1.774 2.581 4.156 2.581 7.149zm-5.252 0c0-1.479-.387-2.795-1.16-3.947-.773-1.152-1.844-1.728-3.21-1.728-1.57 0-2.694.525-3.372 1.575-.677 1.05-1.016 2.417-1.016 4.1 0 1.57.406 2.908 1.22 4.015.813 1.107 1.903 1.66 3.27 1.66 1.524 0 2.617-.449 3.278-1.347.66-.897.99-2.34.99-4.328zM101.145 23.325l-3.762 3.541c-1.559-.643-2.727-1.581-3.506-2.814-.779-1.233-1.17-2.708-1.17-4.42v-7.944H90.98V8.3h1.727V2.286l5.185-.373v6.404h2.71v3.354h-2.71v6.486c0 1.295.294 2.37.881 3.226.587.856 1.377 1.503 2.372 1.942zM121.981 23.715l-4.083 3.337a4.243 4.243 0 0 1-1.626-.965c-.464-.44-.769-.943-.915-1.508l-3.185 1.812c-.124.068-.337.138-.636.212a3.29 3.29 0 0 1-.754.11c-2.451 0-4.475-.841-6.072-2.524-1.599-1.683-2.398-4.021-2.398-7.014 0-2.846.83-5.192 2.491-7.039 1.66-1.847 3.777-2.77 6.353-2.77 1.027 0 1.988.203 2.88.61.892.407 1.479.768 1.762 1.084l2.948-1.067 1.033.305V19.92c0 1.016.178 1.824.533 2.422.355.598.913 1.057 1.669 1.373zm-7.166-2.541v-7.945a4.412 4.412 0 0 0-1.329-1.087c-.549-.303-1.218-.454-2.008-.454-1.141 0-2.087.416-2.838 1.248-.752.831-1.127 2.208-1.127 4.131 0 1.527.35 2.752 1.051 3.674.7.922 1.683 1.383 2.947 1.383.723 0 1.4-.113 2.033-.339.634-.227 1.057-.431 1.271-.611zM153.068 26.51h-5.15V15.075c0-.666-.229-1.256-.687-1.77-.457-.514-1.177-.771-2.159-.771-.803 0-1.52.155-2.152.466a4.972 4.972 0 0 0-1.592 1.211V26.51h-5.15V15.075c0-.666-.229-1.256-.686-1.77-.458-.514-1.178-.771-2.16-.771-.926 0-1.705.189-2.338.567-.633.378-1.096.749-1.389 1.11V26.51h-5.15V8.299l5.15-.373v1.779l2.016-1.237c.666-.406 1.32-.683 1.965-.83a8.86 8.86 0 0 1 1.965-.22c1.197 0 2.219.246 3.066.737a4.986 4.986 0 0 1 1.948 2.024l2.796-1.711a6.749 6.749 0 0 1 1.846-.788 8.17 8.17 0 0 1 2.084-.263c1.795 0 3.207.557 4.234 1.669 1.028 1.112 1.543 2.578 1.543 4.396V26.51zm0 0"/>
+  </g>
+</svg>

data/spec/sample_svg/gradients-cmyk.svg

@@ -0,0 +1,40 @@
+<svg width="240" height="240" version="1.1" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+      <style type="text/css"><![CDATA[
+        #rect1 { fill: url(#Gradient1); }
+        .stop1 { stop-color: device-cmyk(0, 1, 1, 0); }
+        .stop2 { stop-color: device-cmyk(0, 0, 0, 1); stop-opacity: 0; }
+        .stop3 { stop-color: device-cmyk(1, 0, 1, 0); }
+      ]]></style>
+      <linearGradient id="Gradient1">
+        <stop class="stop1" offset="0%"/>
+        <stop class="stop2" offset="50%"/>
+        <stop class="stop3" offset="100%"/>
+      </linearGradient>
+      <linearGradient id="Gradient2" x1="0" x2="0" y1="0" y2="1">
+        <stop offset="25%" stop-color="device-cmyk(0, 1, 1, 0)"/>
+        <stop offset="50%" stop-color="device-cmyk(0, 0, 0, 1)" stop-opacity="0"/>
+        <stop offset="75%" stop-color="device-cmyk(1, 0, 1, 0)"/>
+      </linearGradient>
+      <linearGradient id="Gradient3" x1="0" x2="1" y1="0" y2="1">
+        <stop offset="0%" stop-color="device-cmyk(0, 1, 1, 0)"/>
+        <stop offset="30%" stop-color="device-cmyk(1, 0, 1, 0)"/>
+        <stop offset="60%" stop-color="device-cmyk(1, 0, 1, 0)"/>
+        <stop offset="100%" stop-color="device-cmyk(1, 0, 1, 0)"/>
+      </linearGradient>
+      <linearGradient id="userspace" gradientUnits="userSpaceOnUse" x1="160" y1="90" x2="220" y2="90">
+        <stop offset="0" stop-color="device-cmyk(0, 1, 1, 0)"/>
+        <stop offset="1" stop-color="device-cmyk(1, 0, 1, 0)"/>
+      </linearGradient>
+  </defs>
+
+  <rect id="rect1" x="10" y="10" rx="15" ry="15" width="50" height="100" stroke="black"/>
+  <rect x="10" y="120" rx="15" ry="15" width="50" height="100" fill="url(#Gradient2)" stroke="black"/>
+  <circle cx="110" cy="40" r="30" stroke="black" fill="url(#Gradient3)"/>
+  <ellipse cx="110" cy="100" rx="30" ry="20" stroke="black" fill="url(#Gradient1)"/>
+  <line x1="65" y1="120" x2="200" y2="200" stroke="url(#Gradient3)" stroke-width="5"/>
+  <path d="M80,140l0,50l30,20l0-40z" stroke="url(#Gradient3)" fill="url(#Gradient1)" stroke-width="3"/>
+  <polygon points="150,30 170,80 190,55 200,10" fill="url(#Gradient1)"/>
+  <rect x="150" y="90" width="80" height="30" fill="url(#userspace)" stroke="black"/>
+  <polyline points="150,130 170,170 190,155 200,110" stroke="url(#Gradient1)" stroke-width="3" fill="none"/>
+</svg>

data/spec/sample_svg/image_svg.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg viewBox="0 0 1000 500" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1">
+    <rect x="20" y="20" width="960" height="460" stroke="black" fill="white" />
+    <image xlink:href="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgd2lkdGg9IjExMDAiIGhlaWdodD0iNDAwIj4KICA8cmVjdCB4PSIxMDAiIHk9IjEwMCIgd2lkdGg9IjkwMCIgaGVpZ2h0PSIzMDAiIGZpbGw9Im5vbmUiIHN0cm9rZT0iYmx1ZSIgc3Ryb2tlLXdpZHRoPSIyIiAvPgoKICA8cGF0aCBkPSJNMjAwIDIwMCBMODAwIDMwMCBMODAwIDIwMCIgc3Ryb2tlPSJncmVlbiIgc3Ryb2tlLXdpZHRoPSIxMCIgZmlsbD0icmVkIiAvPgo8L3N2Zz4K" x="100" y="200" width="200" height="200" />
+    <image xlink:href="sample_images/image_svg_embed.svg" x="400" y="200" width="200" height="200" />
+    <image xlink:href="sample_images/image_svg_embed.svg" x="650" y="200" width="100" height="200" />
+    <image xlink:href="sample_images/image_svg_embed.svg" x="800" y="200" width="100" height="200" preserveAspectRatio="none" />
+</svg>

data/spec/sample_svg/ordering.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="177.649" height="244.929" version="1.1" viewBox="0 0 177.649 244.929" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g transform="translate(-21.1667 -31.75)">
+    <rect x="21.1667" y="31.75" width="177.649" height="244.929" fill="url(#linearGradient18)" stroke-width=".264583"/>
+  </g>
+  <defs>
+    <linearGradient id="linearGradient18" x1="109.032" x2="109.74" y1="34.6919" y2="273.287" gradientUnits="userSpaceOnUse">
+      <stop stop-color="orange" offset="0"/>
+      <stop stop-color="blue" offset="1"/>
+    </linearGradient>
+  </defs>
+</svg>

data/spec/sample_svg/symbol.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg viewBox="0 0 1000 1000" xmlns="http://www.w3.org/2000/svg" xmlns:xlink='http://www.w3.org/1999/xlink' version="1.1">
+  <symbol id="rects" viewBox="0 0 100 100">
+    <rect x="10" y="10" width="80" height="80" fill="none" stroke="red"/>
+    <rect x="20" y="20" width="60" height="60" fill="none" stroke="green"/>
+    <rect x="30" y="30" width="40" height="40" fill="none" stroke="blue"/>
+  </symbol>
+  <rect width="1000" height="1000" fill="none" stroke="black"/>
+  <use x="100" y="100" width="800" height="800" xlink:href="#rects"/>
+  <use x="400" y="400" width="200" height="200" xlink:href="#rects"/>
+</svg>

data/spec/spec_helper.rb

@@ -3,12 +3,12 @@ Bundler.require(:default, :development)
 
 # Requires supporting files with custom matchers and macros, etc,
 # in ./support/ and its subdirectories.
-Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
 
 module Support
-  def flatten_calls(calls)
+  def flatten_calls(_calls)
     [].tap do |flattened_calls|
-      add = -> (local_calls) do
+      add = lambda do |local_calls|
         local_calls.each do |call|
           flattened_calls << call[0..2]
           add.call call[3]
@@ -28,12 +28,36 @@ end
 
 RSpec.configure do |config|
   config.mock_with :rspec do |c|
-    c.syntax = [:should, :expect]
+    c.syntax = %i[should expect]
   end
 
   config.expect_with :rspec do |c|
-    c.syntax = [:should, :expect]
+    c.syntax = %i[should expect]
   end
 
   config.include Support
+
+  config.before(:suite) do
+    # calculate the MD5 of all files in spec/sample_output and store in a hash
+    $hashes = {}
+
+    Dir["#{File.dirname(__FILE__)}/sample_output/*.pdf"].each do |file|
+      hash = Digest::MD5.file(file).hexdigest
+      $hashes[file] = hash
+    end
+  end
+
+  config.after(:suite) do
+    # print out the PDFs that have changed
+    changed = $hashes.select do |file, hash|
+      new_hash = Digest::MD5.file(file).hexdigest
+      new_hash != hash
+    end
+
+    if changed.any?
+      puts "\nThese PDFs have changed since the last test run:"
+      cwd = "#{Dir.pwd}/"
+      changed.each { |file, _| puts "  #{file.sub(cwd, '')}" }
+    end
+  end
 end