positionrange 0.6.0

data/README.txt

@@ -0,0 +1,87 @@
+= Position Range -- Ranges with attributes that can be juggled
+
+Allows you to assign random attributes to ranges and juggle them in
+lists. Also adds parsing from string, but most intereting when used in
+a PositionRange::List.
+
+There standard set operations can be applied to it, like additions,
+substractions and intersections. In addition you can also get the
+combined size of all the ranges in the list. And cluster overlapping
+ranges, maintaining the attributes (more below).
+
+PositionRange is a library by the LogiLogi Foundation, extracted from
+http://www.logilogi.org (http://foundation.logilogi.org).
+
+== Usage
+
+You can assign random attributes to PositionRanges.
+
+  r = PositionRange.new(1,10, :cow => 'moo')
+
+  r.cow => 'moo'
+
+You can also create a PositionRange::List directly from a string.
+
+  l = PositionRange::List.from_s('0,10:5,15')
+
+Then you can get the combined size.
+
+  l.range_size => 20
+
+Or line up overlaps.
+
+  l.line_up_overlaps!.to_s => '0,5:5,10:5,10:10,15'
+
+Clustering overlaps maintains attributes.
+
+  l = PositionRange::List.new([
+        PositionRange.new(0,10, :cow => 'moo'),
+        PositionRange.new(5,15, :goat => 7)
+      ])
+
+  l.cluster_overlaps => [
+        PositionRange::List.new([
+            PositionRange.new(0,5, :cow => 'moo')]),
+        PositionRange::List.new([
+            PositionRange.new(5,10, :cow => 'moo'),
+            PositionRange.new(5,10, :goat => 7)]),
+        PositionRange::List.new([
+            PositionRange.new(10,15, :goat => 7)])
+      ]
+
+== Download
+
+The latest version of Position Range can be found at:
+
+* http://rubyforge.org/frs/?group_id=7564
+
+Documentation can be found at:
+
+* http://positionrange.rubyonrails.org
+
+== Installation
+
+You can install Position Range with the following command:
+
+  % [sudo] gem install positionrange
+
+Or from its distribution directory with:
+
+  % [sudo] ruby install.rb
+
+== License
+
+Position Range is released under the GNU Affero GPL licence.
+
+* http://www.fsf.org/licensing/licenses/agpl-3.0.html
+
+== Support
+
+The Position Range homepage is http://positionrange.rubyforge.org.
+
+For the latest news on Position Range:
+
+* http://foundation.logilogi.org/tags/PositionRange
+
+Feel free to submit commits or feature requests. If you send a patch,
+remember to update the corresponding unit tests.

data/Rakefile

@@ -0,0 +1,98 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/contrib/sshpublisher'
+require File.join(File.dirname(__FILE__), 'lib', 'position_range', 'version')
+
+PKG_BUILD     = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+PKG_NAME      = 'positionrange'
+PKG_VERSION   = PositionRange::VERSION::STRING + PKG_BUILD
+PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
+
+RELEASE_NAME  = "REL #{PKG_VERSION}"
+
+RUBY_FORGE_PROJECT = "positionrange"
+RUBY_FORGE_USER    = "wybow"
+
+desc "Default Task"
+task :default => [ :test ]
+
+# Run the unit tests
+Rake::TestTask.new { |t|
+  t.libs << "test"
+  t.pattern = 'test/*_test.rb'
+  t.verbose = true
+  t.warning = false
+}
+
+# Generate the RDoc documentation
+Rake::RDocTask.new { |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "Position Range -- Ranges with attributes that can be juggled"
+  rdoc.options << '--line-numbers' << '--inline-source' << '-A cattr_accessor=object'
+  rdoc.options << '--charset' << 'utf-8'
+  rdoc.rdoc_files.include('README.txt', 'CHANGELOG.txt')
+  rdoc.rdoc_files.include('lib/position_range.rb')
+  rdoc.rdoc_files.include('lib/position_range/*.rb')
+}
+
+# Create compressed packages
+spec = Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+  s.name = PKG_NAME
+  s.summary = "Ranges with attributes that can be juggled."
+  s.description = %q{Allows you to assign random attributes to ranges and juggle them in lists.}
+  s.version = PKG_VERSION
+
+  s.author = "Wybo Wiersma"
+  s.email = "wybo@logilogi.org"
+  s.rubyforge_project = "positionrange"
+  s.homepage = "http://positionrange.rubyforge.org"
+
+  s.has_rdoc = true
+  s.requirements << 'none'
+  s.require_path = 'lib'
+
+  s.files = [ "Rakefile", "install.rb", "README.txt", "CHANGELOG.txt", "LICENSE.txt" ]
+  s.files = s.files + Dir.glob( "lib/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+  s.files = s.files + Dir.glob( "test/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+end
+  
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+desc "Publish the docs, gem, and release files"
+task :publish => [:release, :pgem, :pdoc] do 
+  puts 'Published gem'
+end
+
+desc "Publish the gem"
+task :pgem => [:package] do 
+  Rake::SshFilePublisher.new("gems.rubyonrails.org", 
+      "/u/sites/gems/gems", "pkg", "#{PKG_FILE_NAME}.gem").upload
+  `ssh gems.rubyonrails.org '/u/sites/gems/gemupdate.sh'`
+end
+
+desc "Publish the API documentation"
+task :pdoc => [:rdoc] do 
+  sh "rsync -azv --no-perms --no-times doc/*" +
+      " rubyforge.org:/var/www/gforge-projects/positionrange"
+end
+
+desc "Publish the release files to RubyForge."
+task :release => [ :package ] do
+  require 'rubyforge'
+  require 'rake/contrib/rubyforgepublisher'
+
+  packages = %w( gem tgz zip ).collect{ |ext| "pkg/#{PKG_NAME}-#{PKG_VERSION}.#{ext}" }
+
+  rubyforge = RubyForge.new.configure
+  rubyforge.login
+  rubyforge.add_release(PKG_NAME, PKG_NAME, "REL #{PKG_VERSION}", *packages)
+end

data/install.rb

@@ -0,0 +1,30 @@
+require 'rbconfig'
+require 'find'
+require 'ftools'
+
+include Config
+
+# this was adapted from rdoc's install.rb by way of Log4r
+
+$sitedir = CONFIG["sitelibdir"]
+unless $sitedir
+  version = CONFIG["MAJOR"] + "." + CONFIG["MINOR"]
+  $libdir = File.join(CONFIG["libdir"], "ruby", version)
+  $sitedir = $:.find {|x| x =~ /site_ruby/ }
+  if !$sitedir
+    $sitedir = File.join($libdir, "site_ruby")
+  elsif $sitedir !~ Regexp.quote(version)
+    $sitedir = File.join($sitedir, version)
+  end
+end
+
+# the actual gruntwork
+Dir.chdir("lib")
+
+Find.find("position_range", "position_range.rb") { |f|
+  if f[-3..-1] == ".rb"
+    File::install(f, File.join($sitedir, *f.split(/\//)), 0644, true)
+  else
+    File::makedirs(File.join($sitedir, *f.split(/\//)))
+  end
+}

data/lib/position_range/error.rb

@@ -0,0 +1,28 @@
+#--#
+# Copyright: (c) 2006-2008 The LogiLogi Foundation <foundation@logilogi.org>
+#
+# License:
+#   This file is part of the PositionRange Library. PositionRange is Free
+#   Software. You can run/distribute/modify PositionRange under the terms of
+#   the GNU Affero General Public License version 3. The Affero GPL states
+#   that running a modified version or a derivative work also requires you to
+#   make the sourcecode of that work available to everyone that can interact
+#   with it. We chose the Affero GPL to ensure that PositionRange remains open
+#   and libre (LICENSE.txt contains the full text of the legally binding
+#   license).
+#++#
+#
+# This Error is raised if positions are out of range.
+
+class PositionRange::Error < StandardError
+  attr_accessor :from_range, :to_range
+
+  def initialize(from_range, to_range)
+    @from_range = from_range
+    @to_range = to_range
+  end
+
+  def message
+    super.to_s + ': ' + @from_range.to_s + ',' + @to_range.to_s
+  end
+end