savage 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Jeremy Holland
+
+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,17 @@
+= Savage
+
+A little gem for extracting and manipulating SVG vector path data.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add specs for it. This is important so I don't break it in a
+  future version unintentionally. 
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Jeremy Holland. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "savage"
+    gem.summary = %Q{A little library to manipulate SVG path data}
+    gem.description = %Q{A little gem for extracting and manipulating SVG vector path data.}
+    gem.email = "jeremy@jeremypholland.com"
+    gem.homepage = "http://github.com/therubyneck/savage"
+    gem.authors = ["Jeremy Holland"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "savage #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/savage/core_extensions/string.rb

@@ -0,0 +1,8 @@
+class String
+  def constantize
+    unless /\A(?:::)?([A-Z]\w*(?:::[A-Z]\w*)*)\z/ =~ self
+      raise NameError, "#{self.inspect} is not a valid constant name!"
+    end
+    Object.module_eval("::#{$1}", __FILE__, __LINE__)
+  end
+end

data/lib/savage/direction.rb

@@ -0,0 +1,29 @@
+module Savage
+  module Directions
+    Point = Struct.new :x, :y
+  end
+  
+  class Direction
+    
+    include Utils
+    
+    def initialize(absolute)
+      @absolute = absolute
+    end
+    
+    def absolute?
+      @absolute
+    end
+  end
+end
+
+require File.dirname(__FILE__) + "/directions/close_path"
+require File.dirname(__FILE__) + "/directions/coordinate_target"
+require File.dirname(__FILE__) + "/directions/horizontal_to"
+require File.dirname(__FILE__) + "/directions/vertical_to"
+require File.dirname(__FILE__) + "/directions/point_target"
+require File.dirname(__FILE__) + "/directions/move_to"
+require File.dirname(__FILE__) + "/directions/line_to"
+require File.dirname(__FILE__) + "/directions/quadratic_curve_to"
+require File.dirname(__FILE__) + "/directions/cubic_curve_to"
+require File.dirname(__FILE__) + "/directions/arc_to"

data/lib/savage/directions/arc_to.rb

@@ -0,0 +1,24 @@
+module Savage
+  module Directions
+    class ArcTo < PointTarget
+      attr_accessor :radius, :rotation, :large_arc, :sweep
+    
+      def initialize(radius_x, radius_y, rotation, large_arc, sweep, target_x, target_y, absolute=true)
+        super(target_x, target_y, absolute)
+        @radius = Point.new(radius_x, radius_y)
+        @rotation = rotation
+        @large_arc = large_arc
+        @sweep = sweep
+      end
+    
+      def to_command
+        command_code << "#{@radius.x} #{@radius.y} #{@rotation} #{bool_to_int(@large_arc)} #{bool_to_int(@sweep)} #{target.x} #{target.y}".gsub(/ -/,'-')
+      end
+    
+      private
+        def command_code
+          (absolute?) ? 'A' : 'a'
+        end
+    end
+  end
+end

data/lib/savage/directions/close_path.rb

@@ -0,0 +1,14 @@
+module Savage
+  module Directions
+    class ClosePath < Direction
+    
+      def initialize(absolute=true)
+        super(absolute)
+      end
+    
+      def to_command
+        command_string = (absolute?) ? 'Z' : 'z'
+      end
+    end
+  end
+end

data/lib/savage/directions/coordinate_target.rb

@@ -0,0 +1,20 @@
+module Savage
+  module Directions
+    class CoordinateTarget < Direction
+    
+      attr_accessor :target
+    
+      def initialize(target, absolute=true)
+        @target = target
+        super(absolute)
+      end
+    
+      def to_command
+        command_code << @target.to_s
+      end
+    
+      private
+        def command_code; ''; end;
+    end
+  end
+end

data/lib/savage/directions/cubic_curve_to.rb

@@ -0,0 +1,25 @@
+module Savage
+  module Directions
+    class CubicCurveTo < QuadraticCurveTo
+      attr_accessor :control_1
+    
+      def initialize(control_1_x, control_1_y, control_2_x, control_2_y, target_x, target_y, absolute=true)
+        @control_1 = Point.new(control_1_x, control_1_y)
+        super(control_2_x, control_2_y, target_x, target_y, absolute)
+      end
+    
+      def to_command(continuous=false)
+        command_code(continuous) << ((!continuous) ? "#{@control_1.x} #{@control_1.y} #{@control.x} #{@control.y} #{@target.x} #{@target.y}".gsub(/ -/,'-') : super().gsub(/[A-Za-z]/,''))
+      end
+    
+      def control_2; @control; end
+      def control_2=(value); @control = value; end
+    
+      private
+        def command_code(continuous=false)
+          return (absolute?) ? 'C' : 'c' unless continuous
+          (absolute?) ? 'S' : 's'
+        end
+    end
+  end
+end

data/lib/savage/directions/horizontal_to.rb

@@ -0,0 +1,10 @@
+module Savage
+  module Directions
+    class HorizontalTo < CoordinateTarget
+      private
+        def command_code
+          (absolute?) ? 'H' : 'h'
+        end
+    end
+  end
+end

data/lib/savage/directions/line_to.rb

@@ -0,0 +1,10 @@
+module Savage
+  module Directions
+    class LineTo < PointTarget
+      private
+        def command_code
+          (absolute?) ? 'L' : 'l'
+        end
+    end
+  end
+end

data/lib/savage/directions/move_to.rb

@@ -0,0 +1,10 @@
+module Savage
+  module Directions
+    class MoveTo < PointTarget
+      private
+        def command_code
+          (absolute?) ? 'M' : 'm'
+        end
+    end
+  end
+end

data/lib/savage/directions/point_target.rb

@@ -0,0 +1,20 @@
+module Savage
+  module Directions
+    class PointTarget < Direction
+    
+      attr_accessor :target
+    
+      def initialize(x, y, absolute=true)
+        @target = Point.new(x,y)
+        super(absolute)
+      end
+    
+      def to_command
+        command_code << "#{@target.x.to_s} #{@target.y.to_s}".gsub(/ -/,'-')
+      end
+    
+      private
+        def command_code; ''; end;
+    end
+  end
+end

data/lib/savage/directions/quadratic_curve_to.rb

@@ -0,0 +1,22 @@
+module Savage
+  module Directions
+    class QuadraticCurveTo < PointTarget
+      attr_accessor :control
+    
+      def initialize(control_x, control_y, target_x, target_y, absolute=true)
+        @control = Point.new(control_x, control_y)
+        super(target_x, target_y, absolute)
+      end
+    
+      def to_command(continuous=false)
+        command_code(continuous) << ((!continuous) ? "#{@control.x} #{@control.y} #{@target.x} #{@target.y}".gsub(/ -/,'-') : super().gsub(/[A-Za-z]/,''))
+      end
+    
+      private
+        def command_code(continuous=false)
+          return (absolute?) ? 'Q' : 'q' unless continuous
+          (absolute?) ? 'T' : 't'
+        end
+    end
+  end
+end

data/lib/savage/directions/vertical_to.rb

@@ -0,0 +1,10 @@
+module Savage
+  module Directions
+    class VerticalTo < CoordinateTarget
+      private
+        def command_code
+          (absolute?) ? 'V' : 'v'
+        end
+    end
+  end
+end

data/lib/savage/path.rb

@@ -0,0 +1,16 @@
+module Savage
+  class Path
+    require File.dirname(__FILE__) + "/sub_path"
+    
+    def initialize(path_string=nil)
+      raise ArgumentError unless path_string.nil? || path_string.kind_of?(String)
+    end
+    
+    def subpaths
+      return []
+    end
+    
+    def to_command
+    end
+  end
+end

data/lib/savage/sub_path.rb

@@ -0,0 +1,47 @@
+module Savage
+  class SubPath
+    Directions.constants.each do |constant|
+      unless %w[PointTarget CoordinateTarget Point MoveTo].include? constant
+        sym = constant.gsub(/[A-Z]/) { |p| '_' + p.downcase }[1..-1].to_sym
+        define_method(sym) do |*args|
+          new_command = ("Savage::Directions::" << constant).constantize.new(*args)
+          @commands << new_command
+          new_command
+        end
+      end
+    end
+    
+    attr_accessor :commands
+    
+    def move_to(*args)
+      return nil unless @commands.empty?
+      new_move = Directions::MoveTo.new(*args)
+      @commands <<  new_move
+      new_move
+    end
+    
+    def initialize
+      @commands = []
+    end
+    
+    # FIXME - refactor this monstrosity
+    def to_command
+      prev_command = nil
+      command = ''
+      @commands.each do |dir|
+        this_command = dir.to_command
+        if dir.class == prev_command || (dir.class == Directions::LineTo && prev_command == Directions::MoveTo)
+          this_command.gsub!(/^[A-Za-z]/,'')
+          this_command = " " << this_command unless this_command.match(/^-/)
+        end
+        prev_command = dir.class
+        command << this_command
+      end
+      command
+    end
+    
+    def closed?
+      @commands.last.kind_of? Directions::ClosePath
+    end
+  end
+end

data/lib/savage/utils.rb

@@ -0,0 +1,7 @@
+module Savage
+  module Utils
+    def bool_to_int(value)
+      (value) ? 1 : 0
+    end
+  end
+end

data/lib/savage.rb

@@ -0,0 +1,9 @@
+SAVAGE_PATH = File.dirname(__FILE__) + "/savage/"
+[
+  'core_extensions/string',
+  'utils',
+  'direction',
+  'path'
+].each do |library|
+  require SAVAGE_PATH + library
+end

data/savage.gemspec

@@ -0,0 +1,100 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{savage}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeremy Holland"]
+  s.date = %q{2010-05-02}
+  s.description = %q{A little gem for extracting and manipulating SVG vector path data.}
+  s.email = %q{jeremy@jeremypholland.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/savage.rb",
+     "lib/savage/core_extensions/string.rb",
+     "lib/savage/direction.rb",
+     "lib/savage/directions/arc_to.rb",
+     "lib/savage/directions/close_path.rb",
+     "lib/savage/directions/coordinate_target.rb",
+     "lib/savage/directions/cubic_curve_to.rb",
+     "lib/savage/directions/horizontal_to.rb",
+     "lib/savage/directions/line_to.rb",
+     "lib/savage/directions/move_to.rb",
+     "lib/savage/directions/point_target.rb",
+     "lib/savage/directions/quadratic_curve_to.rb",
+     "lib/savage/directions/vertical_to.rb",
+     "lib/savage/path.rb",
+     "lib/savage/sub_path.rb",
+     "lib/savage/utils.rb",
+     "savage.gemspec",
+     "spec/savage/directions/arc_to_spec.rb",
+     "spec/savage/directions/close_path_spec.rb",
+     "spec/savage/directions/cubic_curve_to_spec.rb",
+     "spec/savage/directions/horizontal_to_spec.rb",
+     "spec/savage/directions/line_to_spec.rb",
+     "spec/savage/directions/move_to_spec.rb",
+     "spec/savage/directions/point_spec.rb",
+     "spec/savage/directions/quadratic_curve_spec.rb",
+     "spec/savage/directions/vertical_to_spec.rb",
+     "spec/savage/path_spec.rb",
+     "spec/savage/sub_path_spec.rb",
+     "spec/savage_spec.rb",
+     "spec/shared/command.rb",
+     "spec/shared/coordinate_target.rb",
+     "spec/shared/direction.rb",
+     "spec/shared/point_target.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/therubyneck/savage}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A little library to manipulate SVG path data}
+  s.test_files = [
+    "spec/savage/directions/arc_to_spec.rb",
+     "spec/savage/directions/close_path_spec.rb",
+     "spec/savage/directions/cubic_curve_to_spec.rb",
+     "spec/savage/directions/horizontal_to_spec.rb",
+     "spec/savage/directions/line_to_spec.rb",
+     "spec/savage/directions/move_to_spec.rb",
+     "spec/savage/directions/point_spec.rb",
+     "spec/savage/directions/quadratic_curve_spec.rb",
+     "spec/savage/directions/vertical_to_spec.rb",
+     "spec/savage/path_spec.rb",
+     "spec/savage/sub_path_spec.rb",
+     "spec/savage_spec.rb",
+     "spec/shared/command.rb",
+     "spec/shared/coordinate_target.rb",
+     "spec/shared/direction.rb",
+     "spec/shared/point_target.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/spec/savage/directions/arc_to_spec.rb

@@ -0,0 +1,96 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+include Savage::Directions
+
+describe ArcTo do
+  def dir_class; ArcTo; end
+  def create_relative; ArcTo.new(100,200,300,true,false,400,500,false); end
+  def command_code; 'a'; end
+  
+  before :each do
+    @dir = dir_class.new(100,200,300,true,false,400,500)
+  end
+  
+  include DirectionShared
+  
+  it 'should have a target' do
+    @dir.respond_to?(:target).should == true
+    @dir.target.class.should == Point
+  end
+  it 'should have a radius' do
+    @dir.respond_to?(:radius).should == true
+    @dir.radius.class.should == Point
+  end
+  it 'should have a large arc based on the constructor argument' do
+    @dir.respond_to?(:large_arc).should == true
+    @dir.large_arc.should == true
+  end
+  it 'should have a sweep based on the constructor argument' do
+    @dir.respond_to?(:sweep).should == true
+    @dir.sweep.should == false
+  end
+  it 'should have a rotation based on the constructor arugment' do
+    @dir.respond_to?(:rotation).should == true
+    @dir.rotation.should == 300
+  end
+  it 'should have an accessible target x, based on the constructor argument' do
+    @dir.target.x.should == 400
+  end
+  it 'should have an accessible target y, based on the constructor argument' do
+    @dir.target.y.should == 500
+  end
+  it 'should have an accessible x radius, based on the constructor argument' do
+    @dir.radius.x.should == 100
+  end
+  it 'should have an accessible y radius, based on the constructor argument' do
+    @dir.radius.y.should == 200
+  end
+  it 'should be constructed with at least x and y radii, rotation, large arc, sweep, and target x and y parameters' do
+    lambda { dir_class.new }.should raise_error
+    lambda { dir_class.new 45 }.should raise_error
+    lambda { dir_class.new 45, 50 }.should raise_error
+    lambda { dir_class.new 45, 50, 60 }.should raise_error
+    lambda { dir_class.new 45, 50, 60, true }.should raise_error
+    lambda { dir_class.new 45, 50, 60, true, true }.should raise_error
+    lambda { dir_class.new 45, 50, 60, true, true, 100 }.should raise_error
+    lambda { dir_class.new 45, 50, 60, true, true, 100, 200 }.should_not raise_error
+  end
+  it 'should be relative if constructed with a false eighth parameter' do
+    direction = dir_class.new 45, 50, 60, true, true, 100, 200, false
+    direction.absolute?.should == false
+  end
+  it 'should be absolute if constructed with a true eighth parameter' do
+    direction = dir_class.new 45, 50, 60, true, true, 100, 200, true
+    direction.absolute?.should == true
+  end
+  it 'should be absolute if constructed with only seven parameters' do
+    direction = dir_class.new 45, 50, 60, true, true, 100, 200
+    direction.absolute?.should == true
+  end
+  describe '#to_command' do
+    it 'should have exactly 7 numerical parameters' do
+      extract_coordinates(@dir.to_command).length.should == 7
+    end
+    it 'should show the provided x radius value as the first parameter' do
+      extract_coordinates(@dir.to_command)[0].should == 100
+    end
+    it 'should show the provided y radius value as the second parameter' do
+      extract_coordinates(@dir.to_command)[1].should == 200
+    end
+    it 'should show the provided rotation value as the third parameter' do
+      extract_coordinates(@dir.to_command)[2].should == 300
+    end
+    it 'should show the integer interpretation of the provided large arc value as the fourth parameter' do
+      extract_coordinates(@dir.to_command)[3].should == 1
+    end
+    it 'should show the integer interpretation of the provided sweep value as the fifth parameter' do
+      extract_coordinates(@dir.to_command)[4].should == 0
+    end
+    it 'should show the provided target x value as the sixth parameter' do
+      extract_coordinates(@dir.to_command)[5].should == 400
+    end
+    it 'should show the provided target y value as the seventh parameter' do
+      extract_coordinates(@dir.to_command)[6].should == 500
+    end
+  end
+end

data/spec/savage/directions/close_path_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+include Savage::Directions
+
+describe ClosePath do
+  before :each do
+    @dir = ClosePath.new()
+  end
+  def create_relative; ClosePath.new(false); end
+  def command_code; 'z'; end
+  include DirectionShared
+  it 'should be constructed with with either no parameters or a single boolean parameter' do
+    lambda { ClosePath.new }.should_not raise_error
+    lambda { ClosePath.new true }.should_not raise_error
+    lambda { ClosePath.new 45, 50 }.should raise_error
+  end
+  it 'should be relative if constructed with a false parameter' do
+    direction = ClosePath.new(false)
+    direction.absolute?.should == false
+  end
+  it 'should be absolute if constructed with a false parameter' do
+    direction = ClosePath.new(true)
+    direction.absolute?.should == true
+  end
+  it 'should be absolute if constructed with no parameters' do
+    direction = ClosePath.new()
+    direction.absolute?.should == true
+  end
+end