powerpoint 1.4

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NjNkNDQ2MDRjZjlkN2QxZTE3ODMzZDE4NDNlOTYwY2U2NjEzYzA4OA==
+  data.tar.gz: !binary |-
+    MTNjNjk2MTQ2NjczNTU3NDI3OTRiYjA4ZGE4NDYzNmRiNGQ4YzJiNA==
+SHA512:
+  metadata.gz: !binary |-
+    YTYyY2Q1MTFhNzQ4Y2UzNzQ0NTJiMmYwY2VkZDhlZjZmMTdiNTRhMTc0ODUw
+    NDNmY2YxZmNmMDZjYjJmZGQ0OWExYmQ4MDExZjUxZDE4MWQzNDViOGMyMDU1
+    NjVlMGQxY2ZlM2YzMjNlMGM1ZGVjZTg2NDg2ZTBiZjg5MTU5NWU=
+  data.tar.gz: !binary |-
+    NTcxNGJkZjVjMzQ4NzQ3YTcxMjQ3OTk5MTk4ODVlMGI1NGVkY2FmZmEyYmI2
+    YmZhZjE2YzViODBjZmI5NmNhYzg2MDM5YWI0OTE5NDkwZTg3MjRlY2MyYzM2
+    M2E3OTNjOGJiNTEwYWNlZGUwMzE1ZDVjNjIyYzM5MjJlMzZmNDc=

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in powerpoint.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 TODO: Write your name
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,81 @@
+= 'powerpoint' gem --  for creating PowerPoint Slides in Ruby.
+
+'powerpoint' is a Ruby gem that can generate PowerPoint files(pptx).
+
+
+== Installation
+
+'powerpont' can be used from the command line or as part of a Ruby web framework. To install the gem using terminal, run the following command:
+
+    gem install powerpoint
+
+To use it in Rails, add this line to your Gemfile:
+
+    gem "powerpoint"
+
+
+== Basic Usage
+
+'powerpoint' gem can generate a PowerPoint presentaion based on a standard template:
+
+    require 'powerpoint'
+    
+    @deck = Powerpoint::Presentation.new
+
+    # Creating an introduction slide:
+    title = 'Bicycle Of the Mind'
+    subtitle = 'created by Steve Jobs'
+    @deck.add_intro title, subtitle
+    
+    # Creating a text-only slide:
+    # Title must be a string.
+    # Content must be an array of strings that will be displayed as bullet items.
+    title = 'Why Mac?'
+    content = ['Its cool!', 'Its light.']
+    @deck.add_textual_slide title, content
+
+    # Creating an image Slide:
+    # It will contain a title as string.
+    # and an embeded image
+    title = 'Everyone loves Macs:'
+    image_path = 'samples/images/sample_gif.gif'
+    @deck.add_pictorial_slide title, image_path
+    
+    # Specifying coordinates and image size for an embeded image.
+    # x and y values define the position of the image on the slide.
+    # cx and cy define the width and height of the image.
+    # x, y, cx, cy are in points. Each pixel is 12700 points.
+    # coordinates parameter is optional.
+    coords = {x: 124200, y: 3356451, cx: 2895600, cy: 1013460}
+    @deck.add_pictorial_slide title, image_path, coords
+    
+    # Saving the pptx file to the current directory.
+    @deck.save('test.pptx')
+  
+== Compatibility
+
+'powerpoint' gem has been tested with LibreOffice(4.2.1.1) and Apache OpenOffice(4.0.1) on Mac OS X Mavericks, Microsoft PowerPoint 2010 on Windows 7 and Google Docs(latest version as of March 2014).
+
+== Contributing
+
+Contributions are welcomed. You can fork a repository, add your code changes to the forked branch, ensure all existing unit tests pass, create new unit tests cover your new changes and finally create a pull request.
+
+After forking and then cloning the repository locally, install Bundler and then use it
+to install the development gem dependecies:
+
+    gem install bundler
+    bundle install
+
+Once this is complete, you should be able to run the test suite:
+
+    rake
+
+
+== Bug Reporting
+
+Please use the {Issues}[https://github.com/pythonicrubyist/powerpoint/issues] page to report bugs or suggest new enhancements.
+
+
+== License
+
+Powerpoint has been published under {MIT License}[https://github.com/pythonicrubyist/powerpoint/blob/master/LICENSE.txt]

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+# If you want to make this the default task
+task :default => :spec

data/lib/powerpoint.rb

@@ -0,0 +1,40 @@
+require "powerpoint/version"
+require 'powerpoint/slide/intro'
+require 'powerpoint/slide/textual'
+require 'powerpoint/slide/pictorial'
+require 'powerpoint/relationship'
+require 'powerpoint/slide/relationship'
+require 'powerpoint/content_type'
+require 'powerpoint/meta'
+require 'powerpoint/presentation'
+
+module Powerpoint
+
+  spec = Gem::Specification.find_by_name("powerpoint")
+  gem_root = spec.gem_dir
+  TEMPLATE_PATH = "#{gem_root}/template/"
+
+  def self.decompress_pptx in_path, out_path
+  	Zip::File.open(in_path) do |zip_file|
+  	  zip_file.each do |f|
+  	    f_path = File.join(out_path, f.name)
+  	    FileUtils.mkdir_p(File.dirname(f_path))
+  	    zip_file.extract(f, f_path) unless File.exist?(f_path)
+  	  end
+  	end
+  end
+
+  def self.compress_pptx in_path, out_path
+    Zip::File.open(out_path, Zip::File::CREATE) do |zip_file|
+      Dir.glob("#{in_path}/**/*", ::File::FNM_DOTMATCH).each do |path|
+        zip_path = path.gsub("#{in_path}/","")
+        next if zip_path == "." || zip_path == ".." || zip_path.match(/DS_Store/)
+        begin
+          zip_file.add(zip_path, path)
+        rescue Zip::ZipEntryExistsError
+          raise "#{out_path} allready exists!"
+        end
+      end
+    end
+  end  
+end

data/lib/powerpoint/content_type.rb

@@ -0,0 +1,14 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  class Powerpoint::ContentType
+    def initialize extract_path, sllide_number
+      xml = '<Override PartName="/ppt/slides/slide' + sllide_number.to_s + '.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slide+xml"/></Types>'
+      path = "#{extract_path}/[Content_Types].xml"
+      template = File.read path
+      template.gsub!('</Types>', xml)
+      File.open(path, 'w'){ |f| f << template }
+    end
+  end
+end

data/lib/powerpoint/meta.rb

@@ -0,0 +1,14 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  class Powerpoint::Meta
+    def initialize extract_path, sllide_number
+      xml = '<p:sldId id="257" r:id="rId' + (sllide_number+666).to_s + '"/></p:sldIdLst>'
+      path = "#{extract_path}/ppt/presentation.xml"
+      template = File.read path
+      template.gsub!('</p:sldIdLst>', xml)
+      File.open(path, 'w'){ |f| f << template } 
+    end
+  end
+end

data/lib/powerpoint/presentation.rb

@@ -0,0 +1,50 @@
+require 'zip/filesystem'
+require 'fileutils'
+require 'tmpdir'
+
+module Powerpoint
+  class Powerpoint::Presentation
+
+    attr_reader :pptx_path, :extract_path
+
+    def initialize
+      @slide_count = 0
+      @extract_path =  File.join Dir.tmpdir, "extract_#{Time.now.strftime("%Y-%m-%d-%H%M%S")}"
+      FileUtils.copy_entry TEMPLATE_PATH, @extract_path
+    end
+
+    def add_intro title, subtitile=nil
+      @slide_count += 1
+      Powerpoint::Slide::Intro.new @extract_path, title, subtitile
+    end
+
+    def add_textual_slide title, content=[]
+      @slide_count += 1
+      Powerpoint::Slide::Textual.new @extract_path, title, content, @slide_count
+      Powerpoint::Slide::Relationship.new @extract_path, @slide_count
+      setablish_relationships
+    end
+
+    def add_pictorial_slide title, image_path, coords={}
+      @slide_count += 1
+      Powerpoint::Slide::Pictorial.new @extract_path, title, image_path, @slide_count, coords
+      setablish_relationships
+    end    
+    
+    def setablish_relationships
+      if @slide_count > 2
+        Powerpoint::ContentType.new @extract_path, @slide_count
+        Powerpoint::Relationship.new @extract_path, @slide_count
+        Powerpoint::Meta.new @extract_path, @slide_count
+      end
+    end
+
+    def save path
+      @pptx_path = path
+      File.delete(path) if File.exist?(path)
+      Powerpoint.compress_pptx @extract_path, @pptx_path
+      FileUtils.rm_rf(@extract_path)
+      path
+    end
+  end
+end

data/lib/powerpoint/relationship.rb

@@ -0,0 +1,14 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  class Powerpoint::Relationship
+    def initialize extract_path, sllide_number
+      xml = '<Relationship Id="rId'+ (sllide_number+666).to_s + '" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide' + sllide_number.to_s + '.xml"/></Relationships>'
+      path = "#{extract_path}/ppt/_rels/presentation.xml.rels"
+      template = File.read path
+      template.gsub!('</Relationships>', xml)
+      File.open(path, 'w'){ |f| f << template }  
+    end
+  end
+end

data/lib/powerpoint/slide/intro.rb

@@ -0,0 +1,22 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  module Slide
+    class Powerpoint::Slide::Intro
+      def initialize extract_path, title, subtitile=nil
+        template_path = "#{TEMPLATE_PATH}/ppt/slides/slide1.xml"
+        xml = File.read template_path
+
+        xml_title = '<a:p><a:r><a:rPr lang="en-US" dirty="0" smtClean="0"/><a:t>' + title.to_s + '</a:t></a:r><a:endParaRPr lang="en-US" dirty="0"/></a:p>'
+        xml.gsub!('PRESENTATION_TITLE_PACEHOLDER', xml_title)
+
+        xml_subtitle = '<a:p><a:r><a:rPr lang="en-US" dirty="0" smtClean="0"/><a:t>' + subtitile.to_s+ '</a:t></a:r><a:endParaRPr lang="en-US" dirty="0"/></a:p>'
+        xml.gsub!('PRESENTATION_SUBTITLE_PACEHOLDER', xml_subtitle)
+
+        intro_slide_path = "#{extract_path}/ppt/slides/slide1.xml"
+        File.open(intro_slide_path, 'w'){ |f| f << xml }
+      end
+    end
+  end
+end

data/lib/powerpoint/slide/pictorial.rb

@@ -0,0 +1,108 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  module Slide
+    class Powerpoint::Slide::Pictorial
+      def initialize extract_path, title, image_path, slide_number, coords={}
+      	
+      	image_name = File.basename(image_path)
+      	FileUtils.copy_file(image_path, "#{extract_path}/ppt/media/#{image_name}")
+
+      	coords_tag = (coords.empty?) ? '' : '<p:spPr>
+									            <a:xfrm>
+									                <a:off x="' + coords[:x].to_s + '" y="' + coords[:y].to_s + '" />
+									                <a:ext cx="' + coords[:cx].to_s + '" cy="' + coords[:cy].to_s + '" />
+									            </a:xfrm>
+									        </p:spPr>'
+
+        rel_xml =  '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+					<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+					    <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/' + image_name + '" />
+					    <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout2.xml" />
+					</Relationships>'
+
+        rel_path = "#{extract_path}/ppt/slides/_rels/slide#{slide_number}.xml.rels"
+        File.open(rel_path, 'w'){ |f| f << rel_xml }
+
+		slide_xml =  '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+					<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
+					    <p:cSld>
+					        <p:spTree>
+					            <p:nvGrpSpPr>
+					                <p:cNvPr id="1" name="" />
+					                <p:cNvGrpSpPr />
+					                <p:nvPr />
+					            </p:nvGrpSpPr>
+					            <p:grpSpPr>
+					                <a:xfrm>
+					                    <a:off x="0" y="0" />
+					                    <a:ext cx="0" cy="0" />
+					                    <a:chOff x="0" y="0" />
+					                    <a:chExt cx="0" cy="0" />
+					                </a:xfrm>
+					            </p:grpSpPr>
+					            <p:sp>
+					                <p:nvSpPr>
+					                    <p:cNvPr id="2" name="Title 1" />
+					                    <p:cNvSpPr>
+					                        <a:spLocks noGrp="1" />
+					                    </p:cNvSpPr>
+					                    <p:nvPr>
+					                        <p:ph type="title" />
+					                    </p:nvPr>
+					                </p:nvSpPr>
+					                <p:spPr />
+					                <p:txBody>
+					                    <a:bodyPr />
+					                    <a:lstStyle />
+					                    <a:p>
+					                        <a:r>
+					                            <a:rPr lang="en-US" dirty="0" smtClean="0" />
+					                            <a:t>' + title + '</a:t>
+					                        </a:r>
+					                        <a:endParaRPr lang="en-US" dirty="0" />
+					                    </a:p>
+					                </p:txBody>
+					            </p:sp>
+					            <p:pic>
+					                <p:nvPicPr>
+					                    <p:cNvPr id="4" name="Content Placeholder 3" />
+					                    <p:cNvPicPr>
+					                        <a:picLocks noGrp="1" noChangeAspect="1" />
+					                    </p:cNvPicPr>
+					                    <p:nvPr>
+					                        <p:ph idx="1" />
+					                    </p:nvPr>
+					                </p:nvPicPr>
+					                <p:blipFill>
+					                    <a:blip r:embed="rId2">
+					                        <a:extLst>
+					                            <a:ext uri="{28A0092B-C50C-407E-A947-70E740481C1C}">
+					                                <a14:useLocalDpi xmlns:a14="http://schemas.microsoft.com/office/drawing/2010/main" val="0" />
+					                            </a:ext>
+					                        </a:extLst>
+					                    </a:blip>
+					                    <a:stretch>
+					                        <a:fillRect />
+					                    </a:stretch>
+					                </p:blipFill>' + coords_tag +
+					            '</p:pic>
+					        </p:spTree>
+					        <p:extLst>
+					            <p:ext uri="{BB962C8B-B14F-4D97-AF65-F5344CB8AC3E}">
+					                <p14:creationId xmlns:p14="http://schemas.microsoft.com/office/powerpoint/2010/main" val="1474098577" />
+					            </p:ext>
+					        </p:extLst>
+					    </p:cSld>
+					    <p:clrMapOvr>
+					        <a:masterClrMapping />
+					    </p:clrMapOvr>
+					</p:sld>'
+
+        slide_path = "#{extract_path}/ppt/slides/slide#{slide_number}.xml"
+        File.open(slide_path, 'w'){ |f| f << slide_xml }        
+      end
+    end
+  end
+end

data/lib/powerpoint/slide/relationship.rb

@@ -0,0 +1,15 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  module Slide
+    class Powerpoint::Slide::Relationship
+      def initialize extract_path, slide_number
+        xml = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout2.xml"/></Relationships>'
+        path = "#{extract_path}/ppt/slides/_rels/slide#{slide_number}.xml.rels"
+        File.open(path, 'w'){ |f| f << xml }
+      end
+    end
+  end
+end

data/lib/powerpoint/slide/textual.rb

@@ -0,0 +1,26 @@
+require 'zip/filesystem'
+require 'fileutils'
+
+module Powerpoint
+  module Slide
+    class Powerpoint::Slide::Textual
+      def initialize extract_path, title, content, slide_number
+        template_path = "#{TEMPLATE_PATH}/ppt/slides/slide2.xml"
+        xml = File.read template_path
+
+        title_xml = '<a:p><a:r><a:rPr lang="en-US" dirty="0" smtClean="0"/><a:t>'+ title.to_s + '</a:t></a:r><a:endParaRPr lang="en-US" dirty="0"/></a:p>'
+        xml.gsub!('SLIDE_TITLE_PACEHOLDER', title_xml)
+
+        content_xml = ''
+        content.each do |i|
+          content_xml += '<a:p><a:r><a:rPr lang="en-US" dirty="0" smtClean="0"/><a:t>' + i.to_s + '</a:t></a:r></a:p>'
+        end
+
+        xml.gsub!('CONTENT_PACEHOLDER', content_xml)
+
+        slide_path = "#{extract_path}/ppt/slides/slide#{slide_number}.xml"
+        File.open(slide_path, 'w'){ |f| f << xml }
+      end
+    end
+  end
+end