squib 0.6.0 → 0.7.0

data/lib/squib/card.rb

@@ -1,67 +1,67 @@
-require 'cairo'
-require 'squib/input_helpers'
-require 'squib/graphics/cairo_context_wrapper'
-
-module Squib
-  # Back end graphics. Private.
-  class Card
-
-    # :nodoc:
-    # @api private
-    attr_reader :width, :height, :backend, :svgfile
-
-    # :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
-      @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
-        Dir.mkdir @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
-
-    ########################
-    ### BACKEND GRAPHICS ###
-    ########################
-    require 'squib/graphics/background'
-    require 'squib/graphics/image'
-    require 'squib/graphics/save_doc'
-    require 'squib/graphics/save_images'
-    require 'squib/graphics/shapes'
-    require 'squib/graphics/showcase'
-    require 'squib/graphics/text'
-
-  end
-end
+require 'cairo'
+require 'squib/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
+        Dir.mkdir @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
+
+    ########################
+    ### BACKEND GRAPHICS ###
+    ########################
+    require 'squib/graphics/background'
+    require 'squib/graphics/image'
+    require 'squib/graphics/save_doc'
+    require 'squib/graphics/save_images'
+    require 'squib/graphics/shapes'
+    require 'squib/graphics/showcase'
+    require 'squib/graphics/text'
+
+  end
+end

data/lib/squib/conf.rb

@@ -1,111 +1,117 @@
-require 'squib'
-require 'forwardable'
-require 'squib/args/typographer'
-
-module Squib
-  # @api private
-  class Conf
-
-    DEFAULTS = {
-      'antialias'     => 'best',
-      'backend'       => 'memory',
-      'count_format'  => SYSTEM_DEFAULTS[:count_format],
-      'custom_colors' => {},
-      'dir'           => SYSTEM_DEFAULTS[:dir],
-      'hint'          => :none,
-      'img_dir'       => '.',
-      'progress_bars' => false,
-      'ldquote'       => "\u201C", # UTF8 chars
-      'rdquote'       => "\u201D",
-      'lsquote'       => "\u2018",
-      'rsquote'       => "\u2019",
-      'em_dash'       => "\u2014",
-      'en_dash'       => "\u2013",
-      'ellipsis'      => "\u2026",
-      'smart_quotes'  => true,
-      'text_hint'     => 'off',
-    }
-
-    #Translate the hints to the methods.
-    ANTIALIAS_OPTS = {
-      nil        => 'subpixel',
-      'best'     => 'subpixel',
-      'good'     => 'gray',
-      'fast'     => 'gray',
-      'gray'     => 'gray',
-      'subpixel' => 'subpixel'
-    }
-
-    def initialize(config_hash = DEFAULTS)
-      @config_hash = config_hash
-      @typographer = Args::Typographer.new(config_hash)
-      normalize_antialias
-    end
-
-    # Load the configuration file, if exists, overriding hardcoded defaults
-    # @api private
-    def self.load(file)
-      yaml = {}
-      if File.exists? file
-        Squib::logger.info { "  using config: #{file}" }
-        yaml = YAML.load_file(file) || {}
-      end
-      Conf.new(DEFAULTS.merge(yaml))
-    end
-
-    def to_s
-      "Conf: #{@config_hash.to_s}"
-    end
-
-    def img_dir
-      @config_hash['img_dir']
-    end
-
-    def text_hint
-      @config_hash['text_hint']
-    end
-
-    def text_hint=(hint)
-      @config_hash['text_hint'] = hint
-    end
-
-    def progress_bars
-      @config_hash['progress_bars']
-    end
-
-    def typographer
-      @typographer
-    end
-
-    def dir
-      @config_hash['dir']
-    end
-
-    def prefix
-      @config_hash['prefix']
-    end
-
-    def count_format
-      @config_hash['count_format']
-    end
-
-    def antialias
-      @config_hash['antialias']
-    end
-
-    def backend
-      @config_hash['backend']
-    end
-
-    def custom_colors
-      @config_hash['custom_colors']
-    end
-
-    private
-
-    def normalize_antialias
-      @config_hash['antialias'] = ANTIALIAS_OPTS[@config_hash['antialias'].downcase.strip]
-    end
-
-  end
-end
+require 'forwardable'
+require 'squib'
+require 'squib/args/typographer'
+require 'yaml'
+
+module Squib
+  # @api private
+  class Conf
+
+    DEFAULTS = {
+      'antialias'     => 'best',
+      'backend'       => 'memory',
+      'count_format'  => SYSTEM_DEFAULTS[:count_format],
+      'custom_colors' => {},
+      'dir'           => SYSTEM_DEFAULTS[:dir],
+      'hint'          => :none,
+      'img_dir'       => '.',
+      'progress_bars' => false,
+      'ldquote'       => "\u201C", # UTF8 chars
+      'rdquote'       => "\u201D",
+      'lsquote'       => "\u2018",
+      'rsquote'       => "\u2019",
+      'em_dash'       => "\u2014",
+      'en_dash'       => "\u2013",
+      'ellipsis'      => "\u2026",
+      'smart_quotes'  => true,
+      'text_hint'     => 'off',
+      'warn_ellipsize'=> true,
+    }
+
+    #Translate the hints to the methods.
+    ANTIALIAS_OPTS = {
+      nil        => 'subpixel',
+      'best'     => 'subpixel',
+      'good'     => 'gray',
+      'fast'     => 'gray',
+      'gray'     => 'gray',
+      'subpixel' => 'subpixel'
+    }
+
+    def initialize(config_hash = DEFAULTS)
+      @config_hash = config_hash
+      @typographer = Args::Typographer.new(config_hash)
+      normalize_antialias
+    end
+
+    # Load the configuration file, if exists, overriding hardcoded defaults
+    # @api private
+    def self.load(file)
+      yaml = {}
+      if File.exists? file
+        Squib::logger.info { "  using config: #{file}" }
+        yaml = YAML.load_file(file) || {}
+      end
+      Conf.new(DEFAULTS.merge(yaml))
+    end
+
+    def to_s
+      "Conf: #{@config_hash.to_s}"
+    end
+
+    def img_dir
+      @config_hash['img_dir']
+    end
+
+    def text_hint
+      @config_hash['text_hint']
+    end
+
+    def text_hint=(hint)
+      @config_hash['text_hint'] = hint
+    end
+
+    def progress_bars
+      @config_hash['progress_bars']
+    end
+
+    def typographer
+      @typographer
+    end
+
+    def dir
+      @config_hash['dir']
+    end
+
+    def prefix
+      @config_hash['prefix']
+    end
+
+    def count_format
+      @config_hash['count_format']
+    end
+
+    def antialias
+      @config_hash['antialias']
+    end
+
+    def backend
+      @config_hash['backend']
+    end
+
+    def custom_colors
+      @config_hash['custom_colors']
+    end
+
+    def warn_ellipsize?
+      @config_hash['warn_ellipsize']
+    end
+
+    private
+
+    def normalize_antialias
+      @config_hash['antialias'] = ANTIALIAS_OPTS[@config_hash['antialias'].downcase.strip]
+    end
+
+  end
+end

data/lib/squib/constants.rb

@@ -1,178 +1,178 @@
-module Squib
-    # Squib's defaults for when arguments are not specified in the command nor layouts.
-    #
-    # @api public
-    SYSTEM_DEFAULTS = {
-      :align => :left,
-      :alpha => 1.0,
-      :angle => 0,
-      :angle_range => (Math::PI / -4.0)..(Math::PI / 4),
-      :blend => :none,
-      :color => :black,
-      :columns => 5,
-      :count_format => '%02d',
-      :cx1 => 0,
-      :cx2 => 0,
-      :cy1 => 0,
-      :cy2 => 0,
-      :data => nil,
-      :default_font => 'Arial 36',
-      :dir => '_output',
-      :dx => 0, # delta
-      :dy => 0, # delta
-      :ellipsize => :end,
-      :face => :left,
-      :fill_color => '#0000',
-      :force_id => false,
-      :font => :use_set,
-      :font_size => nil,
-      :format => :png,
-      :gap => 0,
-      :height => :native,
-      :hint => :off,
-      :inner_radius => 50,
-      :img_dir => '.',
-      :justify => false,
-      :key => '*',
-      :margin => 75,
-      :markup => false,
-      :mask => nil,
-      :n => 5,
-      :offset => 1.1,
-      :outer_radius => 100,
-      :prefix => 'card_',
-      :progress_bar => false,
-      :quotes => :dumb,
-      :reflect_offset => 15,
-      :reflect_percent => 0.25,
-      :reflect_strength => 0.2,
-      :range => :all,
-      :rotate => false,
-      :rows => :infinite,
-      :scale => 0.85,
-      :sheet => 0,
-      :spacing => 0,
-      :str => '',
-      :stroke_color => :black,
-      :stroke_width => 2.0,
-      :trim => 0,
-      :trim_radius => 38,
-      :valign => :top,
-      :width => :native,
-      :wrap => true,
-      :x => 0,
-      :x1 => 100,
-      :x2 => 150,
-      :x3 => 100,
-      :x_radius => 0,
-      :y => 0,
-      :y1 => 100,
-      :y2 => 150,
-      :y3 => 150,
-      :y_radius => 0,
-    }
-
-    # These are parameters that are intended to be "expanded" across
-    # range if they are singletons.
-    #
-    # For example: using a different font for each card, using one `text` command
-    #
-    # key: the internal name of the param (e.g. :files)
-    # value: the user-facing API key (e.g. file: 'abc.png')
-    #
-    # @api private
-    EXPANDING_PARAMS = {
-          :align => :align,
-          :alpha => :alpha,
-          :angle => :angle,
-          :blend => :blend,
-          :circle_radius => :radius,
-          :color => :color,
-          :cx1 => :cx1,
-          :cx2 => :cx2,
-          :cy1 => :cy1,
-          :cy2 => :cy2,
-          :dx => :dx,
-          :dy => :dy,
-          :ellipsize => :ellipsize,
-          :files => :file,
-          :fill_color => :fill_color,
-          :force_svgid => :force_id,
-          :font => :font,
-          :font_size => :font_size,
-          :height => :height,
-          :hint => :hint,
-          :inner_radius => :inner_radius,
-          :justify => :justify,
-          :layout => :layout,
-          :markup => :markup,
-          :mask => :mask,
-          :n => :n,
-          :outer_radius => :outer_radius,
-          :quotes => :quotes,
-          :rect_radius => :radius,
-          :spacing => :spacing,
-          :str => :str,
-          :stroke_color => :stroke_color,
-          :stroke_width => :stroke_width,
-          :svgdata => :data,
-          :svgid => :id,
-          :valign => :valign,
-          :width => :width,
-          :wrap => :wrap,
-          :x => :x,
-          :x1 => :x1,
-          :x2 => :x2,
-          :x3 => :x3,
-          :x_radius => :x_radius,
-          :y => :y,
-          :y1 => :y1,
-          :y2 => :y2,
-          :y3 => :y3,
-          :y_radius => :y_radius,
-      }
-
-    # These parameters are considered for unit conversion
-    #
-    # For example
-    #    text str: 'Hello, World', x: '1in'
-    #
-    # key: the internal name of the param (e.g. :circle_radius)
-    # value: the user-facing API key (e.g. radius: '1in')
-    UNIT_CONVERSION_PARAMS = {
-      :circle_radius => :radius,
-      :cx1 => :cx1,
-      :cx2 => :cx2,
-      :cy1 => :cy1,
-      :cy2 => :cy2,
-      :dx => :dx, # delta
-      :dy => :dx, # delta
-      :gap => :gap,
-      :height => :height,
-      :inner_radius => :inner_radius,
-      :margin => :margin,
-      :outer_radius => :outer_radius,
-      :paper_width => :width,
-      :paper_height => :height,
-      :rect_radius => :radius,
-      :spacing => :spacing,
-      :stroke_width => :stroke_width,
-      :trim => :trim,
-      :width => :width,
-      :x => :x,
-      :x1 => :x1,
-      :x2 => :x2,
-      :x3 => :x3,
-      :x_radius => :x_radius,
-      :y => :y,
-      :y1 => :y1,
-      :y2 => :y2,
-      :y3 => :y3,
-      :y_radius => :y_radius,
-    }
-
-    # Used for inch-cm conversion
-    # :nodoc:
-    # @api private
-    INCHES_IN_CM = 0.393700787
-end
+module Squib
+    # Squib's defaults for when arguments are not specified in the command nor layouts.
+    #
+    # @api public
+    SYSTEM_DEFAULTS = {
+      :align => :left,
+      :alpha => 1.0,
+      :angle => 0,
+      :angle_range => (Math::PI / -4.0)..(Math::PI / 4),
+      :blend => :none,
+      :color => :black,
+      :columns => 5,
+      :count_format => '%02d',
+      :cx1 => 0,
+      :cx2 => 0,
+      :cy1 => 0,
+      :cy2 => 0,
+      :data => nil,
+      :default_font => 'Arial 36',
+      :dir => '_output',
+      :dx => 0, # delta
+      :dy => 0, # delta
+      :ellipsize => :end,
+      :face => :left,
+      :fill_color => '#0000',
+      :force_id => false,
+      :font => :use_set,
+      :font_size => nil,
+      :format => :png,
+      :gap => 0,
+      :height => :native,
+      :hint => :off,
+      :inner_radius => 50,
+      :img_dir => '.',
+      :justify => false,
+      :key => '*',
+      :margin => 75,
+      :markup => false,
+      :mask => nil,
+      :n => 5,
+      :offset => 1.1,
+      :outer_radius => 100,
+      :prefix => 'card_',
+      :progress_bar => false,
+      :quotes => :dumb,
+      :reflect_offset => 15,
+      :reflect_percent => 0.25,
+      :reflect_strength => 0.2,
+      :range => :all,
+      :rotate => false,
+      :rows => :infinite,
+      :scale => 0.85,
+      :sheet => 0,
+      :spacing => 0,
+      :str => '',
+      :stroke_color => :black,
+      :stroke_width => 2.0,
+      :trim => 0,
+      :trim_radius => 38,
+      :valign => :top,
+      :width => :native,
+      :wrap => true,
+      :x => 0,
+      :x1 => 100,
+      :x2 => 150,
+      :x3 => 100,
+      :x_radius => 0,
+      :y => 0,
+      :y1 => 100,
+      :y2 => 150,
+      :y3 => 150,
+      :y_radius => 0,
+    }
+
+    # These are parameters that are intended to be "expanded" across
+    # range if they are singletons.
+    #
+    # For example: using a different font for each card, using one `text` command
+    #
+    # key: the internal name of the param (e.g. :files)
+    # value: the user-facing API key (e.g. file: 'abc.png')
+    #
+    # @api private
+    EXPANDING_PARAMS = {
+          :align => :align,
+          :alpha => :alpha,
+          :angle => :angle,
+          :blend => :blend,
+          :circle_radius => :radius,
+          :color => :color,
+          :cx1 => :cx1,
+          :cx2 => :cx2,
+          :cy1 => :cy1,
+          :cy2 => :cy2,
+          :dx => :dx,
+          :dy => :dy,
+          :ellipsize => :ellipsize,
+          :files => :file,
+          :fill_color => :fill_color,
+          :force_svgid => :force_id,
+          :font => :font,
+          :font_size => :font_size,
+          :height => :height,
+          :hint => :hint,
+          :inner_radius => :inner_radius,
+          :justify => :justify,
+          :layout => :layout,
+          :markup => :markup,
+          :mask => :mask,
+          :n => :n,
+          :outer_radius => :outer_radius,
+          :quotes => :quotes,
+          :rect_radius => :radius,
+          :spacing => :spacing,
+          :str => :str,
+          :stroke_color => :stroke_color,
+          :stroke_width => :stroke_width,
+          :svgdata => :data,
+          :svgid => :id,
+          :valign => :valign,
+          :width => :width,
+          :wrap => :wrap,
+          :x => :x,
+          :x1 => :x1,
+          :x2 => :x2,
+          :x3 => :x3,
+          :x_radius => :x_radius,
+          :y => :y,
+          :y1 => :y1,
+          :y2 => :y2,
+          :y3 => :y3,
+          :y_radius => :y_radius,
+      }
+
+    # These parameters are considered for unit conversion
+    #
+    # For example
+    #    text str: 'Hello, World', x: '1in'
+    #
+    # key: the internal name of the param (e.g. :circle_radius)
+    # value: the user-facing API key (e.g. radius: '1in')
+    UNIT_CONVERSION_PARAMS = {
+      :circle_radius => :radius,
+      :cx1 => :cx1,
+      :cx2 => :cx2,
+      :cy1 => :cy1,
+      :cy2 => :cy2,
+      :dx => :dx, # delta
+      :dy => :dx, # delta
+      :gap => :gap,
+      :height => :height,
+      :inner_radius => :inner_radius,
+      :margin => :margin,
+      :outer_radius => :outer_radius,
+      :paper_width => :width,
+      :paper_height => :height,
+      :rect_radius => :radius,
+      :spacing => :spacing,
+      :stroke_width => :stroke_width,
+      :trim => :trim,
+      :width => :width,
+      :x => :x,
+      :x1 => :x1,
+      :x2 => :x2,
+      :x3 => :x3,
+      :x_radius => :x_radius,
+      :y => :y,
+      :y1 => :y1,
+      :y2 => :y2,
+      :y3 => :y3,
+      :y_radius => :y_radius,
+    }
+
+    # Used for inch-cm conversion
+    # :nodoc:
+    # @api private
+    INCHES_IN_CM = 0.393700787
+end