squib 0.14.1 → 0.14.2

data/lib/squib/card.rb

@@ -1,74 +1,75 @@
-require 'cairo'
-require_relative 'graphics/cairo_context_wrapper'
-
-module Squib
-  # Back end graphics. Private.
-  class Card
-
-    # :nodoc:
-    # @api private
-    attr_reader :width, :height, :backend, :svgfile, :index
-
-    # :nodoc:
-    # @api private
-    attr_accessor :cairo_surface, :cairo_context
-
-    # :nodoc:
-    # @api private
-    def initialize(deck, width, height, index=-1)
-      @deck          = deck
-      @width         = width
-      @height        = height
-      @backend       = deck.backend
-      @index         = index
-      @svgfile       = "#{deck.dir}/#{deck.prefix}#{deck.count_format % index}.svg"
-      @cairo_surface = make_surface(@svgfile, @backend)
-      @cairo_context = Squib::Graphics::CairoContextWrapper.new(Cairo::Context.new(@cairo_surface))
-      @cairo_context.antialias = deck.antialias
-    end
-
-    # :nodoc:
-    # @api private
-    def make_surface(svgfile, backend)
-      case backend.downcase.to_sym
-      when :memory
-        Cairo::ImageSurface.new(@width, @height)
-      when :svg
-        FileUtils.mkdir_p @deck.dir unless Dir.exists?(@deck.dir)
-        Cairo::SVGSurface.new(svgfile, @width, @height)
-      else
-        Squib.logger.fatal "Back end not recognized: '#{backend}'"
-        abort
-      end
-    end
-
-  # A save/restore wrapper for using Cairo
-  # :nodoc:
-  # @api private
-    def use_cairo(&block)
-      @cairo_context.save
-      block.yield(@cairo_context)
-      @cairo_context.restore
-    end
-
-    def finish!
-      begin
-        @cairo_surface.finish
-      rescue Cairo::SurfaceFinishedError
-        # do nothin - if it's already finished that's fine
-      end
-    end
-
-    ########################
-    ### BACKEND GRAPHICS ###
-    ########################
-    require_relative 'graphics/background'
-    require_relative 'graphics/image'
-    require_relative 'graphics/save_doc'
-    require_relative 'graphics/save_images'
-    require_relative 'graphics/shapes'
-    require_relative 'graphics/showcase'
-    require_relative 'graphics/text'
-
-  end
-end
+require 'cairo'
+require_relative 'graphics/cairo_context_wrapper'
+
+module Squib
+  # Back end graphics. Private.
+  class Card
+
+    # :nodoc:
+    # @api private
+    attr_reader :width, :height, :backend, :svgfile, :index
+
+    # :nodoc:
+    # @api private
+    attr_accessor :cairo_surface, :cairo_context
+
+    # :nodoc:
+    # @api private
+    def initialize(deck, width, height, index=-1)
+      @deck          = deck
+      @width         = width
+      @height        = height
+      @backend       = deck.backend
+      @index         = index
+      @svgfile       = "#{deck.dir}/#{deck.prefix}#{deck.count_format % index}.svg"
+      @cairo_surface = make_surface(@svgfile, @backend)
+      @cairo_context = Squib::Graphics::CairoContextWrapper.new(Cairo::Context.new(@cairo_surface))
+      @cairo_context.antialias = deck.antialias
+    end
+
+    # :nodoc:
+    # @api private
+    def make_surface(svgfile, backend)
+      case backend.downcase.to_sym
+      when :memory
+        Cairo::ImageSurface.new(@width, @height)
+      when :svg
+        FileUtils.mkdir_p @deck.dir unless Dir.exists?(@deck.dir)
+        Cairo::SVGSurface.new(svgfile, @width, @height)
+      else
+        Squib.logger.fatal "Back end not recognized: '#{backend}'"
+        abort
+      end
+    end
+
+  # A save/restore wrapper for using Cairo
+  # :nodoc:
+  # @api private
+    def use_cairo(&block)
+      @cairo_context.save
+      @cairo_context.new_path # see bug 248
+      block.yield(@cairo_context)
+      @cairo_context.restore
+    end
+
+    def finish!
+      begin
+        @cairo_surface.finish
+      rescue Cairo::SurfaceFinishedError
+        # do nothin - if it's already finished that's fine
+      end
+    end
+
+    ########################
+    ### BACKEND GRAPHICS ###
+    ########################
+    require_relative 'graphics/background'
+    require_relative 'graphics/image'
+    require_relative 'graphics/save_doc'
+    require_relative 'graphics/save_images'
+    require_relative 'graphics/shapes'
+    require_relative 'graphics/showcase'
+    require_relative 'graphics/text'
+
+  end
+end

data/lib/squib/commands/cli.rb

@@ -1,39 +1,39 @@
-require 'mercenary'
-require_relative 'make_sprue'
-require_relative 'new'
-
-module Squib
-  class CLI
-
-    def run
-      Mercenary.program(:squib) do |p|
-        p.version Squib::VERSION
-        p.description 'A Ruby DSL for prototyping card games'
-        p.syntax 'squib <subcommand> [options]'
-
-        p.command(:new) do |c|
-          c.syntax 'new PATH'
-          c.description 'Creates a new basic Squib project scaffolding in PATH. Must be a new directory or already empty.'
-
-          c.option 'advanced', '--advanced', 'Create the advanced layout'
-
-          c.action do |args, options|
-            advanced = options.key? 'advanced'
-            Squib::Commands::New.new.process(args, advanced)
-          end
-        end
-
-        p.command(:make_sprue) do |c|
-          c.syntax 'make_sprue'
-          c.description 'Creates a sprue definition file.'
-
-          c.action do |args, options|
-            Squib::Commands::MakeSprue.new.process(args)
-          end
-        end
-
-      end
-    end
-
-  end
-end
+require 'mercenary'
+require_relative 'make_sprue'
+require_relative 'new'
+
+module Squib
+  class CLI
+
+    def run
+      Mercenary.program(:squib) do |p|
+        p.version Squib::VERSION
+        p.description 'A Ruby DSL for prototyping card games'
+        p.syntax 'squib <subcommand> [options]'
+
+        p.command(:new) do |c|
+          c.syntax 'new PATH'
+          c.description 'Creates a new basic Squib project scaffolding in PATH. Must be a new directory or already empty.'
+
+          c.option 'advanced', '--advanced', 'Create the advanced layout'
+
+          c.action do |args, options|
+            advanced = options.key? 'advanced'
+            Squib::Commands::New.new.process(args, advanced)
+          end
+        end
+
+        p.command(:make_sprue) do |c|
+          c.syntax 'make_sprue'
+          c.description 'Creates a sprue definition file.'
+
+          c.action do |args, options|
+            Squib::Commands::MakeSprue.new.process(args)
+          end
+        end
+
+      end
+    end
+
+  end
+end

data/lib/squib/commands/data/template_option.rb

@@ -1,109 +1,109 @@
-module Squib
-  class Margin
-    attr_reader :top
-    attr_reader :right
-    attr_reader :bottom
-    attr_reader :left
-
-    ##
-    # Create a new margin definition.
-    #
-    # Takes +definition+ which can either be a space-separated +String+ or an
-    # +Array+ of +Float+ and will translate it to the top, right, bottom and
-    # left members.
-    #
-    # The syntax follows how CSS parses margin shorthand strings.
-    def initialize(definition)
-      if definition.instance_of? String
-        @top, @right, @bottom, @left = expand_shorthand(
-          definition.split(/\s+/).map!(&:to_f))
-      elsif definition.is_a? Numeric
-        @top, @right, @bottom, @left = expand_shorthand [definition]
-      elsif definition.instance_of? Array
-        @top, @right, @bottom, @left = expand_shorthand definition
-      else
-        raise ArgumentError, 'Invalid value, must be either string or array'
-      end
-    end
-
-    ##
-    # Map out the margin array.
-    #
-    # Takes +margin_arr+ and attempt to expand it to a strict [top, right,
-    # bottom, left] array.
-    private def expand_shorthand(margin_arr)
-      if margin_arr.size == 1
-        all = margin_arr[0]
-        [all, all, all, all]
-      elsif margin_arr.size == 2
-        margin_arr + margin_arr
-      elsif margin_arr.size == 3
-        margin_arr + [margin_arr[1]]
-      elsif margin_arr.size >= 4
-        margin_arr[0..3]
-      else
-        raise ArgumentError, 'Invalid array'
-      end
-    end
-  end
-
-
-  class Gap
-    attr_reader :horizontal
-    attr_reader :vertical
-
-    def initialize(definition)
-      if definition.instance_of? String
-        @horizontal, @vertical = expand_shorthand(
-          definition.split(/\s+/).map!(&:to_f))
-      elsif definition.instance_of? Array
-        @horizontal, @vertical = expand_shorthand definition
-      elsif definition.is_a? Numeric
-        @horizontal, @vertical = definition, definition
-      else
-        raise ArgumentError, 'Invalid value, must be either string or array'
-      end
-    end
-
-    private def expand_shorthand(gap_arr)
-      if gap_arr.size >= 2
-        gap_arr[0..1]
-      elsif gap_arr.size == 1
-        gap_arr + gap_arr
-      else
-        raise ArgumentError, 'Invalid array'
-      end
-    end
-  end
-
-
-  class TemplateOption
-    attr_accessor :unit
-    attr_accessor :sheet_width
-    attr_accessor :sheet_height
-    attr_writer :sheet_margin
-    attr_accessor :sheet_align
-    attr_accessor :card_width
-    attr_accessor :card_height
-    attr_writer :card_gap
-    attr_accessor :card_ordering
-    attr_accessor :output_file
-    attr_accessor :crop_lines
-
-    def sheet_margin
-      if not @sheet_margin.instance_of? Margin
-        @sheet_margin = Margin.new @sheet_margin
-      else
-        @sheet_margin
-      end
-    end
-
-    def card_gap
-      if not @card_gap.instance_of? Gap
-        @card_gap = Gap.new @card_gap
-      else
-        @card_gap
-      end
-    end
-  end
-end
+module Squib
+  class Margin
+    attr_reader :top
+    attr_reader :right
+    attr_reader :bottom
+    attr_reader :left
+
+    ##
+    # Create a new margin definition.
+    #
+    # Takes +definition+ which can either be a space-separated +String+ or an
+    # +Array+ of +Float+ and will translate it to the top, right, bottom and
+    # left members.
+    #
+    # The syntax follows how CSS parses margin shorthand strings.
+    def initialize(definition)
+      if definition.instance_of? String
+        @top, @right, @bottom, @left = expand_shorthand(
+          definition.split(/\s+/).map!(&:to_f))
+      elsif definition.is_a? Numeric
+        @top, @right, @bottom, @left = expand_shorthand [definition]
+      elsif definition.instance_of? Array
+        @top, @right, @bottom, @left = expand_shorthand definition
+      else
+        raise ArgumentError, 'Invalid value, must be either string or array'
+      end
+    end
+
+    ##
+    # Map out the margin array.
+    #
+    # Takes +margin_arr+ and attempt to expand it to a strict [top, right,
+    # bottom, left] array.
+    private def expand_shorthand(margin_arr)
+      if margin_arr.size == 1
+        all = margin_arr[0]
+        [all, all, all, all]
+      elsif margin_arr.size == 2
+        margin_arr + margin_arr
+      elsif margin_arr.size == 3
+        margin_arr + [margin_arr[1]]
+      elsif margin_arr.size >= 4
+        margin_arr[0..3]
+      else
+        raise ArgumentError, 'Invalid array'
+      end
+    end
+  end
+
+
+  class Gap
+    attr_reader :horizontal
+    attr_reader :vertical
+
+    def initialize(definition)
+      if definition.instance_of? String
+        @horizontal, @vertical = expand_shorthand(
+          definition.split(/\s+/).map!(&:to_f))
+      elsif definition.instance_of? Array
+        @horizontal, @vertical = expand_shorthand definition
+      elsif definition.is_a? Numeric
+        @horizontal, @vertical = definition, definition
+      else
+        raise ArgumentError, 'Invalid value, must be either string or array'
+      end
+    end
+
+    private def expand_shorthand(gap_arr)
+      if gap_arr.size >= 2
+        gap_arr[0..1]
+      elsif gap_arr.size == 1
+        gap_arr + gap_arr
+      else
+        raise ArgumentError, 'Invalid array'
+      end
+    end
+  end
+
+
+  class TemplateOption
+    attr_accessor :unit
+    attr_accessor :sheet_width
+    attr_accessor :sheet_height
+    attr_writer :sheet_margin
+    attr_accessor :sheet_align
+    attr_accessor :card_width
+    attr_accessor :card_height
+    attr_writer :card_gap
+    attr_accessor :card_ordering
+    attr_accessor :output_file
+    attr_accessor :crop_lines
+
+    def sheet_margin
+      if not @sheet_margin.instance_of? Margin
+        @sheet_margin = Margin.new @sheet_margin
+      else
+        @sheet_margin
+      end
+    end
+
+    def card_gap
+      if not @card_gap.instance_of? Gap
+        @card_gap = Gap.new @card_gap
+      else
+        @card_gap
+      end
+    end
+  end
+end

data/lib/squib/commands/make_sprue.rb

@@ -1,275 +1,275 @@
-require 'fileutils'
-require 'pathname'
-require 'highline'
-require 'bigdecimal'
-require 'yaml'
-require_relative 'data/template_option'
-
-module Squib
-  # Squib's command-line option
-  module Commands
-    # Generate a template definition file that can be used for
-    # +save_templated_sheet+
-    #
-    # @api public
-    class MakeSprue
-      # :nodoc:
-      # @api private
-      def process(args, input = $stdin, output = $stdout)
-        # Get definitions from the user
-        @option = prompt(input, output)
-
-        @printable_edge_right = (
-          @option.sheet_width - @option.sheet_margin.right)
-        @printable_edge_bottom = (
-          @option.sheet_height - @option.sheet_margin.bottom)
-        @card_iter_x = @option.card_width + @option.card_gap.horizontal
-        @card_iter_y = @option.card_height + @option.card_gap.vertical
-
-        # Recalculate the sheet margin if the sheet alignment is in the center
-        if @option.sheet_align == :center
-          @option.sheet_margin = recalculate_center_align_sheet
-        end
-
-        # We would now have to output the file
-        YAML.dump generate_template, File.new(@option.output_file, 'w')
-      end
-
-      private
-
-      # Accept user input that defines the template.
-      def prompt(input, output)
-        option = TemplateOption.new
-        cli = HighLine.new(input, output)
-
-        option.unit = cli.choose do |menu|
-          menu.prompt = 'What measure unit should we use? '
-          menu.choice(:in)
-          menu.choice(:cm)
-          menu.choice(:mm)
-        end
-
-        cli.choose do |menu|
-          menu.prompt = 'What paper size you are using? '
-          menu.choice('A4, portrait') do
-            option.sheet_width = convert_measurement_value(
-              210, :mm, option.unit
-            )
-            option.sheet_height = convert_measurement_value(
-              297, :mm, option.unit
-            )
-          end
-          menu.choice('A4, landscape') do
-            option.sheet_width = convert_measurement_value(
-              297, :mm, option.unit
-            )
-            option.sheet_height = convert_measurement_value(
-              210, :mm, option.unit
-            )
-          end
-          menu.choice('US letter, portrait') do
-            option.sheet_width = convert_measurement_value(
-              8.5, :in, option.unit
-            )
-            option.sheet_height = convert_measurement_value(
-              11, :in, option.unit
-            )
-          end
-          menu.choice('US letter, landscape') do
-            option.sheet_width = convert_measurement_value(
-              11, :in, option.unit
-            )
-            option.sheet_height = convert_measurement_value(
-              8.5, :in, option.unit
-            )
-          end
-          menu.choice('Custom size') do
-            option.sheet_width = cli.ask(
-              "Custom paper width? (#{option.unit}) ", Float
-            )
-            option.sheet_height = cli.ask(
-              "Custom paper height? (#{option.unit}) ", Float
-            )
-          end
-        end
-
-        option.sheet_margin = cli.ask(
-          "Sheet margins? (#{option.unit}) "
-        ) do |q|
-          q.validate = /^((\d+\.\d+|\d+) ){0,3}(\d+\.\d+|\d+)/
-        end
-        option.sheet_align = cli.choose do |menu|
-          menu.prompt = 'How to align cards on sheet? [left] '
-          menu.choice(:left)
-          menu.choice(:right)
-          menu.choice(:center)
-          menu.default = :left
-        end
-
-        option.card_width = cli.ask(
-          "Card width? (#{option.unit}) ", Float
-        ) { |q| q.above = 0 }
-        option.card_height = cli.ask(
-          "Card height? (#{option.unit}) ", Float
-        ) { |q| q.above = 0 }
-        option.card_gap = cli.ask(
-          "Gap between cards? (#{option.unit}) "
-        ) { |q| q.validate = /^((\d+\.\d+|\d+))(\s+(\d+\.\d+|\d+))?/ }
-
-        option.card_ordering = cli.choose do |menu|
-          menu.prompt = 'How to layout your cards? [rows]'
-          menu.choice(:rows, text: 'In rows')
-          menu.choice(:columns, text: 'In columns')
-          menu.default = :rows
-        end
-
-        option.crop_lines = cli.choose do |menu|
-          menu.prompt = 'Generate crop lines? [true]'
-          menu.choice(:true)
-          menu.choice(:false)
-          menu.default = :true
-        end
-
-        option.output_file = cli.ask('Output to? ') do |q|
-          q.validate = lambda do |path_str|
-            path = Pathname.new path_str
-            if path.exist?
-              path.writable? && !path.directory?
-            else
-              path.dirname.writable?
-            end
-          end
-
-          q.responses[:not_valid] = (
-            'The filename specified is not a writable file or is a directory.'
-          )
-          q.default = 'template.yml'
-        end
-
-        option
-      end
-
-      def convert_measurement_value(val, from_unit, to_unit)
-        return val if from_unit == to_unit
-
-        if from_unit == :in
-          val_mm = val * 25.4
-        elsif from_unit == :cm
-          val_mm = val * 10.0
-        end
-
-        if to_unit == :in
-          val_mm / 25.4
-        elsif to_unit == :cm
-          val_mm / 10.0
-        else
-          val_mm
-        end
-      end
-
-      def generate_template
-        x = @option.sheet_margin.left
-        y = @option.sheet_margin.top
-        cards = []
-        horizontal_crop_lines = Set.new
-        vertical_crop_lines = Set.new
-
-        while (
-            x + @card_iter_x < @printable_edge_right &&
-            y + @card_iter_y < @printable_edge_bottom)
-          xpos = x + @option.card_gap.horizontal
-          ypos = y + @option.card_gap.vertical
-          cards.push(
-            'x' => "#{xpos}#{@option.unit}",
-            'y' => "#{ypos}#{@option.unit}"
-          )
-
-          # Append the crop lines
-          vertical_crop_lines.add xpos
-          vertical_crop_lines.add xpos + @option.card_width
-          horizontal_crop_lines.add ypos
-          horizontal_crop_lines.add ypos + @option.card_height
-
-          # Calculate the next iterator
-          if @option.card_ordering == :rows
-            x, y = next_card_pos_row(x, y)
-          elsif @option.card_ordering == :columns
-            x, y = next_card_pos_col(x, y)
-          else
-            raise RunTimeException, 'Invalid card ordering value received'
-          end
-        end
-
-        output = {
-          'sheet_width' => "#{@option.sheet_width}#{@option.unit}",
-          'sheet_height' => "#{@option.sheet_height}#{@option.unit}",
-          'card_width' => "#{@option.card_width}#{@option.unit}",
-          'card_height' => "#{@option.card_height}#{@option.unit}",
-          'cards' => cards
-        }
-
-        if @option.crop_lines == :true
-          lines = []
-          vertical_crop_lines.each do |val|
-            lines.push(
-              'type' => :vertical, 'position' => "#{val}#{@option.unit}"
-            )
-          end
-          horizontal_crop_lines.each do |val|
-            lines.push(
-              'type' => :horizontal, 'position' => "#{val}#{@option.unit}"
-            )
-          end
-          output['crop_line'] = { 'lines' => lines }
-        end
-
-        # Return the output data
-        output
-      end
-
-      def recalculate_center_align_sheet
-        # We will still respect the user specified margins
-        printable_width = (
-          @option.sheet_width - @option.sheet_margin.left -
-          @option.sheet_margin.right)
-        num_of_cols, remainder = printable_width.divmod(@card_iter_x)
-        if (
-            @option.card_gap.horizontal > 0 &&
-            remainder < @option.card_gap.horizontal)
-          num_of_cols -= 1
-        end
-
-        new_hor_margin = (
-          (@option.sheet_width - num_of_cols * @card_iter_x -
-           @option.card_gap.horizontal) / 2)
-        Margin.new [
-          @option.sheet_margin.top,
-          new_hor_margin,
-          @option.sheet_margin.bottom
-        ]
-      end
-
-      def next_card_pos_row(x, y)
-        x += @card_iter_x
-
-        if (x + @card_iter_x) > @printable_edge_right
-          x = @option.sheet_margin.left
-          y += @card_iter_y
-        end
-
-        [x, y]
-      end
-
-      def next_card_pos_col(x, y)
-        y += @card_iter_y
-
-        if (y + @card_iter_y) > @printable_edge_bottom
-          x += @card_iter_x
-          y = @option.sheet_margin.top
-        end
-
-        [x, y]
-      end
-    end
-  end
-end
+require 'fileutils'
+require 'pathname'
+require 'highline'
+require 'bigdecimal'
+require 'yaml'
+require_relative 'data/template_option'
+
+module Squib
+  # Squib's command-line option
+  module Commands
+    # Generate a template definition file that can be used for
+    # +save_templated_sheet+
+    #
+    # @api public
+    class MakeSprue
+      # :nodoc:
+      # @api private
+      def process(args, input = $stdin, output = $stdout)
+        # Get definitions from the user
+        @option = prompt(input, output)
+
+        @printable_edge_right = (
+          @option.sheet_width - @option.sheet_margin.right)
+        @printable_edge_bottom = (
+          @option.sheet_height - @option.sheet_margin.bottom)
+        @card_iter_x = @option.card_width + @option.card_gap.horizontal
+        @card_iter_y = @option.card_height + @option.card_gap.vertical
+
+        # Recalculate the sheet margin if the sheet alignment is in the center
+        if @option.sheet_align == :center
+          @option.sheet_margin = recalculate_center_align_sheet
+        end
+
+        # We would now have to output the file
+        YAML.dump generate_template, File.new(@option.output_file, 'w')
+      end
+
+      private
+
+      # Accept user input that defines the template.
+      def prompt(input, output)
+        option = TemplateOption.new
+        cli = HighLine.new(input, output)
+
+        option.unit = cli.choose do |menu|
+          menu.prompt = 'What measure unit should we use? '
+          menu.choice(:in)
+          menu.choice(:cm)
+          menu.choice(:mm)
+        end
+
+        cli.choose do |menu|
+          menu.prompt = 'What paper size you are using? '
+          menu.choice('A4, portrait') do
+            option.sheet_width = convert_measurement_value(
+              210, :mm, option.unit
+            )
+            option.sheet_height = convert_measurement_value(
+              297, :mm, option.unit
+            )
+          end
+          menu.choice('A4, landscape') do
+            option.sheet_width = convert_measurement_value(
+              297, :mm, option.unit
+            )
+            option.sheet_height = convert_measurement_value(
+              210, :mm, option.unit
+            )
+          end
+          menu.choice('US letter, portrait') do
+            option.sheet_width = convert_measurement_value(
+              8.5, :in, option.unit
+            )
+            option.sheet_height = convert_measurement_value(
+              11, :in, option.unit
+            )
+          end
+          menu.choice('US letter, landscape') do
+            option.sheet_width = convert_measurement_value(
+              11, :in, option.unit
+            )
+            option.sheet_height = convert_measurement_value(
+              8.5, :in, option.unit
+            )
+          end
+          menu.choice('Custom size') do
+            option.sheet_width = cli.ask(
+              "Custom paper width? (#{option.unit}) ", Float
+            )
+            option.sheet_height = cli.ask(
+              "Custom paper height? (#{option.unit}) ", Float
+            )
+          end
+        end
+
+        option.sheet_margin = cli.ask(
+          "Sheet margins? (#{option.unit}) "
+        ) do |q|
+          q.validate = /^((\d+\.\d+|\d+) ){0,3}(\d+\.\d+|\d+)/
+        end
+        option.sheet_align = cli.choose do |menu|
+          menu.prompt = 'How to align cards on sheet? [left] '
+          menu.choice(:left)
+          menu.choice(:right)
+          menu.choice(:center)
+          menu.default = :left
+        end
+
+        option.card_width = cli.ask(
+          "Card width? (#{option.unit}) ", Float
+        ) { |q| q.above = 0 }
+        option.card_height = cli.ask(
+          "Card height? (#{option.unit}) ", Float
+        ) { |q| q.above = 0 }
+        option.card_gap = cli.ask(
+          "Gap between cards? (#{option.unit}) "
+        ) { |q| q.validate = /^((\d+\.\d+|\d+))(\s+(\d+\.\d+|\d+))?/ }
+
+        option.card_ordering = cli.choose do |menu|
+          menu.prompt = 'How to layout your cards? [rows]'
+          menu.choice(:rows, text: 'In rows')
+          menu.choice(:columns, text: 'In columns')
+          menu.default = :rows
+        end
+
+        option.crop_lines = cli.choose do |menu|
+          menu.prompt = 'Generate crop lines? [true]'
+          menu.choice(:true)
+          menu.choice(:false)
+          menu.default = :true
+        end
+
+        option.output_file = cli.ask('Output to? ') do |q|
+          q.validate = lambda do |path_str|
+            path = Pathname.new path_str
+            if path.exist?
+              path.writable? && !path.directory?
+            else
+              path.dirname.writable?
+            end
+          end
+
+          q.responses[:not_valid] = (
+            'The filename specified is not a writable file or is a directory.'
+          )
+          q.default = 'template.yml'
+        end
+
+        option
+      end
+
+      def convert_measurement_value(val, from_unit, to_unit)
+        return val if from_unit == to_unit
+
+        if from_unit == :in
+          val_mm = val * 25.4
+        elsif from_unit == :cm
+          val_mm = val * 10.0
+        end
+
+        if to_unit == :in
+          val_mm / 25.4
+        elsif to_unit == :cm
+          val_mm / 10.0
+        else
+          val_mm
+        end
+      end
+
+      def generate_template
+        x = @option.sheet_margin.left
+        y = @option.sheet_margin.top
+        cards = []
+        horizontal_crop_lines = Set.new
+        vertical_crop_lines = Set.new
+
+        while (
+            x + @card_iter_x < @printable_edge_right &&
+            y + @card_iter_y < @printable_edge_bottom)
+          xpos = x + @option.card_gap.horizontal
+          ypos = y + @option.card_gap.vertical
+          cards.push(
+            'x' => "#{xpos}#{@option.unit}",
+            'y' => "#{ypos}#{@option.unit}"
+          )
+
+          # Append the crop lines
+          vertical_crop_lines.add xpos
+          vertical_crop_lines.add xpos + @option.card_width
+          horizontal_crop_lines.add ypos
+          horizontal_crop_lines.add ypos + @option.card_height
+
+          # Calculate the next iterator
+          if @option.card_ordering == :rows
+            x, y = next_card_pos_row(x, y)
+          elsif @option.card_ordering == :columns
+            x, y = next_card_pos_col(x, y)
+          else
+            raise RunTimeException, 'Invalid card ordering value received'
+          end
+        end
+
+        output = {
+          'sheet_width' => "#{@option.sheet_width}#{@option.unit}",
+          'sheet_height' => "#{@option.sheet_height}#{@option.unit}",
+          'card_width' => "#{@option.card_width}#{@option.unit}",
+          'card_height' => "#{@option.card_height}#{@option.unit}",
+          'cards' => cards
+        }
+
+        if @option.crop_lines == :true
+          lines = []
+          vertical_crop_lines.each do |val|
+            lines.push(
+              'type' => :vertical, 'position' => "#{val}#{@option.unit}"
+            )
+          end
+          horizontal_crop_lines.each do |val|
+            lines.push(
+              'type' => :horizontal, 'position' => "#{val}#{@option.unit}"
+            )
+          end
+          output['crop_line'] = { 'lines' => lines }
+        end
+
+        # Return the output data
+        output
+      end
+
+      def recalculate_center_align_sheet
+        # We will still respect the user specified margins
+        printable_width = (
+          @option.sheet_width - @option.sheet_margin.left -
+          @option.sheet_margin.right)
+        num_of_cols, remainder = printable_width.divmod(@card_iter_x)
+        if (
+            @option.card_gap.horizontal > 0 &&
+            remainder < @option.card_gap.horizontal)
+          num_of_cols -= 1
+        end
+
+        new_hor_margin = (
+          (@option.sheet_width - num_of_cols * @card_iter_x -
+           @option.card_gap.horizontal) / 2)
+        Margin.new [
+          @option.sheet_margin.top,
+          new_hor_margin,
+          @option.sheet_margin.bottom
+        ]
+      end
+
+      def next_card_pos_row(x, y)
+        x += @card_iter_x
+
+        if (x + @card_iter_x) > @printable_edge_right
+          x = @option.sheet_margin.left
+          y += @card_iter_y
+        end
+
+        [x, y]
+      end
+
+      def next_card_pos_col(x, y)
+        y += @card_iter_y
+
+        if (y + @card_iter_y) > @printable_edge_bottom
+          x += @card_iter_x
+          y = @option.sheet_margin.top
+        end
+
+        [x, y]
+      end
+    end
+  end
+end