ruby_slides 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e578fb2796af5721b2dac0f714008dc2931251a6
+  data.tar.gz: 724e2a43e2290b97be58b812f56dd39d0d11f658
+SHA512:
+  metadata.gz: f179ad0ea0e90b7b17e90012316a34f059ed9bbf2037382229ff3a1bc0775451dcc4deed0cdcbbc0d784e49017be45fe10dc6cba140c6337bce693185bc7498e
+  data.tar.gz: edaa7a60d5bdaecc708a884bb3d3d2f6bafa1ef20bfc1ac45ddd7f10408c31d1b1420e6901e2933c76cef62aadf6cadff70abe42366512294753e367c5ed4ea8

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+# note taking
+notes

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.15.3

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at mail@danielsousa.io. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Daniel Sousa
+
+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.md

@@ -0,0 +1,46 @@
+# RubySlides
+
+Create Powerpoint presentations in Ruby with elements like slides, text, images, tables and charts.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruby_slides'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ruby_slides
+
+Optionally use the latest code using:
+
+```ruby
+gem 'ruby_slides', git: "https://github.com/danielsousaio/ruby_slides.git"
+```
+
+## Usage
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/danielsousaio/ruby_slides. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the RubySlides project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/ruby_slides/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ruby_slides"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/ruby_slides/compression.rb

@@ -0,0 +1,25 @@
+module RubySlides
+  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} already exists!"
+        end
+      end
+    end
+  end  
+end

data/lib/ruby_slides/presentation.rb

@@ -0,0 +1,105 @@
+require 'zip/filesystem'
+require 'fileutils'
+require 'tmpdir'
+
+module RubySlides
+  class Presentation
+    include RubySlides::Util
+
+    attr_reader :slides
+
+    def initialize
+      @slides = []
+    end
+
+    def introduction_slide(title, subtitle)
+      @slides << RubySlides::Slide::Introduction.new(title: title,
+                                                     subtitle: subtitle)
+    end
+
+    def textual_slide(title, content = [])
+      @slides << RubySlides::Slide::Textual.new(presentation: self,
+                                                title: title,
+                                                content: content)
+    end
+
+    def pictorial_slide(title, image_path, coords = {})
+      @slides << RubySlides::Slide::Pictorial.new(presentation: self,
+                                                  title: title,
+                                                  image_path: image_path,
+                                                  coords: coords)
+    end
+
+    def text_picture_slide(title, image_path, content = [])
+      @slides << RubySlides::Slide::TextPicSplit.new(presentation: self,
+                                                     title: title,
+                                                     image_path: image_path,
+                                                     content: content)
+    end
+
+    def picture_description_slide(title, image_path, content = [])
+      @slides << RubySlides::Slide::DescriptionPic.new(presentation: self,
+                                                       title: title,
+                                                       image_path: image_path,
+                                                       content: content)
+    end
+
+    def table_slide(title, content = [])
+      @slides << RubySlides::Slide::Table.new(presentation: self,
+                                              title: title,
+                                              content: content)
+    end
+
+    def chart_slide(title, series = [{}])
+      @slides << RubySlides::Slide::Chart.new(presentation: self,
+                                              title: title,
+                                              series: series)
+    end
+
+    def save(path)
+      Dir.mktmpdir do |dir|
+        extract_path = "#{dir}/extract_#{Time.now.strftime("%Y-%m-%d-%H%M%S")}"
+
+        # Copy template to temp path
+        FileUtils.copy_entry(TEMPLATE_PATH, extract_path)
+
+        # Remove keep files
+        Dir.glob("#{extract_path}/**/.keep").each do |keep_file|
+          FileUtils.rm_rf(keep_file)
+        end
+
+        # Render/save generic stuff
+        render_view('content_type.xml.erb',
+                    "#{extract_path}/[Content_Types].xml")
+        render_view('presentation.xml.rel.erb',
+                    "#{extract_path}/ppt/_rels/presentation.xml.rels")
+        render_view('presentation.xml.erb',
+                    "#{extract_path}/ppt/presentation.xml")
+        render_view('app.xml.erb',
+                    "#{extract_path}/docProps/app.xml")
+
+        # Save slides
+        slides.each_with_index do |slide, index|
+          slide.save(extract_path, index + 1)
+        end
+
+        # Create .pptx file
+        File.delete(path) if File.exist?(path)
+        RubySlides.compress_pptx(extract_path, path)
+      end
+      path
+    end
+
+    def file_types
+      slides.map {|slide|
+        slide.file_type if slide.respond_to? :file_type
+      }.compact.uniq
+    end
+
+    def charts
+      slides.map {|slide|
+        slide.class == RubySlides::Slide::Chart
+      }.count
+    end
+  end
+end

data/lib/ruby_slides/slide/chart.rb

@@ -0,0 +1,41 @@
+require 'fileutils'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class Chart
+      include RubySlides::Util
+
+      attr_reader :title, :series
+
+      def initialize(options={})
+        require_arguments [:title, :series], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+      end
+
+      def save(extract_path, index)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+        save_chart_xml(extract_path, index)
+      end
+
+      def save_rel_xml(extract_path, index)
+        render_view('chart_rel.xml.erb',
+                    "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels",
+                    index: index)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('chart_slide.xml.erb',
+                    "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+
+      def save_chart_xml(extract_path, index)
+        render_view('chart_ele.xml.erb',
+                    "#{extract_path}/ppt/charts/chart#{index}.xml")
+      end
+    end
+  end
+end

data/lib/ruby_slides/slide/introduction.rb

@@ -0,0 +1,36 @@
+require 'fileutils'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class Introduction
+      include RubySlides::Util
+
+      attr_reader :title, :subtitle
+
+      def initialize(options={})
+        require_arguments [:title, :subtitle], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+      end
+
+      def save(extract_path, index)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+      end
+
+      def file_type
+        nil
+      end
+
+      def save_rel_xml(extract_path, index)
+        render_view('introduction_rel.xml.erb', "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels", index: 1)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('introduction_slide.xml.erb', "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+    end
+  end
+end

data/lib/ruby_slides/slide/pictorial.rb

@@ -0,0 +1,54 @@
+require 'zip/filesystem'
+require 'fileutils'
+require 'fastimage'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class Pictorial
+      include RubySlides::Util
+
+      attr_reader :image_name, :title, :coords, :image_path
+
+      def initialize(options={})
+        require_arguments [:presentation, :title, :image_path], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+        @coords = default_coords unless @coords.any?
+        @image_name = File.basename(@image_path)
+      end
+
+      def save(extract_path, index)
+        copy_media(extract_path, @image_path)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+      end
+
+      def file_type
+        File.extname(image_name).gsub('.', '')
+      end
+
+      def default_coords
+        slide_width = pixel_to_pt(720)
+        default_width = pixel_to_pt(550)
+
+        return {} unless dimensions = FastImage.size(image_path)
+        image_width, image_height = dimensions.map {|d| pixel_to_pt(d)}
+        new_width = default_width < image_width ? default_width : image_width
+        ratio = new_width / image_width.to_f
+        new_height = (image_height.to_f * ratio).round
+        {x: (slide_width / 2) - (new_width/2), y: pixel_to_pt(120), cx: new_width, cy: new_height}
+      end
+      private :default_coords
+
+      def save_rel_xml(extract_path, index)
+        render_view('pictorial_rel.xml.erb', "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels", index: 2)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('pictorial_slide.xml.erb', "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+    end
+  end
+end

data/lib/ruby_slides/slide/picture_description.rb

@@ -0,0 +1,63 @@
+require 'zip/filesystem'
+require 'fileutils'
+require 'fastimage'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class DescriptionPic
+      include RubySlides::Util
+
+      attr_reader :title, :content, :image_name, :image_path, :coords
+
+      def initialize(options={})
+        require_arguments [:presentation, :title, :image_path, :content], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+        @coords = default_coords
+        @image_name = File.basename(@image_path)
+      end
+
+      def save(extract_path, index)
+        copy_media(extract_path, @image_path)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+      end
+
+      def file_type
+        File.extname(image_name).gsub('.', '')
+      end
+
+      def default_coords
+        slide_width = pixel_to_pt(720)
+        default_width = pixel_to_pt(550)
+        default_height = pixel_to_pt(300)
+
+        return {} unless dimensions = FastImage.size(image_path)
+        image_width, image_height = dimensions.map {|d| pixel_to_pt(d)}
+
+        capped_width = [default_width, image_width].min
+        w_ratio = capped_width / image_width.to_f
+
+        capped_height = [default_height, image_height].min
+        h_ratio = capped_height / image_height.to_f
+
+        ratio = [w_ratio, h_ratio].min
+
+        new_width = (image_width.to_f * ratio).round
+        new_height = (image_height.to_f * ratio).round
+        {x: (slide_width / 2) - (new_width/2), y: pixel_to_pt(60), cx: new_width, cy: new_height}
+      end
+      private :default_coords
+
+      def save_rel_xml(extract_path, index)
+        render_view('picture_description_rels.xml.erb', "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels", index: 2)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('picture_description_slide.xml.erb', "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+    end
+  end
+end

data/lib/ruby_slides/slide/table.rb

@@ -0,0 +1,32 @@
+require 'fileutils'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class Table
+      include RubySlides::Util
+
+      attr_reader :title, :content
+
+      def initialize(options={})
+        require_arguments [:title, :content], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+      end
+
+      def save(extract_path, index)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+      end
+
+      def save_rel_xml(extract_path, index)
+        render_view('table_rel.xml.erb', "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels", index: 2)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('table_slide.xml.erb', "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+    end
+  end
+end

data/lib/ruby_slides/slide/text_picture_split.rb

@@ -0,0 +1,59 @@
+require 'zip/filesystem'
+require 'fileutils'
+require 'fastimage'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class TextPicSplit
+      include RubySlides::Util
+
+      attr_reader :title, :content, :image_name, :image_path, :coords
+
+      def initialize(options={})
+        require_arguments [:presentation, :title, :image_path, :content], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+        @coords = default_coords
+        @image_name = File.basename(@image_path)
+      end
+
+      def save(extract_path, index)
+        copy_media(extract_path, @image_path)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+      end
+
+      def file_type
+        File.extname(image_name).gsub('.', '')
+      end
+
+      def default_coords
+        start_x = pixel_to_pt(360)
+        default_width = pixel_to_pt(300)
+
+        return {} unless dimensions = FastImage.size(image_path)
+        image_width, image_height = dimensions.map {|d| pixel_to_pt(d)}
+        new_width = default_width < image_width ? default_width : image_width
+        ratio = new_width / image_width.to_f
+        new_height = (image_height.to_f * ratio).round
+        {x: start_x, y: pixel_to_pt(120), cx: new_width, cy: new_height}
+      end
+      private :default_coords
+
+      def save_rel_xml(extract_path, index)
+        render_view('text_picture_split_rel.xml.erb',
+                    "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels",
+                    index: 2)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('text_picture_split_slide.xml.erb',
+                    "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+    end
+  end
+
+
+end

data/lib/ruby_slides/slide/textual.rb

@@ -0,0 +1,32 @@
+require 'fileutils'
+require 'erb'
+
+module RubySlides
+  module Slide
+    class Textual
+      include RubySlides::Util
+
+      attr_reader :title, :content
+
+      def initialize(options={})
+        require_arguments [:title, :content], options
+        options.each {|k, v| instance_variable_set("@#{k}", v)}
+      end
+
+      def save(extract_path, index)
+        save_rel_xml(extract_path, index)
+        save_slide_xml(extract_path, index)
+      end
+
+      def save_rel_xml(extract_path, index)
+        render_view('textual_rel.xml.erb', "#{extract_path}/ppt/slides/_rels/slide#{index}.xml.rels", index: 2)
+      end
+      private :save_rel_xml
+
+      def save_slide_xml(extract_path, index)
+        render_view('textual_slide.xml.erb', "#{extract_path}/ppt/slides/slide#{index}.xml")
+      end
+      private :save_slide_xml
+    end
+  end
+end