trail 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2011 Maurycy Pawlowski-Wieronski <maurycy@g.pl>
+
+Permission to use, copy, modify, and distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.rdoc

@@ -0,0 +1,41 @@
+=Trail
+
+Trail is a lightweight queue for delayed and normalized execution.
+
+==Quick Start
+
+First, create a trail:
+
+	t = Trail.new
+
+Then, define the normalization method:
+
+	t.normalize = lambda do |trail|
+	  trail.uniq
+	end
+
+And, the commit method:
+
+	t.commit = lambda do |trail|
+	  trail.each {|e| puts e }
+	  nil
+	end
+
+Push some data:
+
+	100.times { t.push("hello, world") }
+
+And, commit the trail:
+
+	t.commit!
+
+Please note that Trail#commit! returns Trail#commit return.
+
+It is possible to specify the watch method:
+
+	t.watch = lambda do |trail, v|
+	  puts 'hello'
+	  trail
+	end
+
+Please note that Trail#watch return overwrites the trail's queue.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/trail.rb

@@ -0,0 +1,33 @@
+class Trail
+  
+  def initialize
+    @queue = []
+
+    @watch = nil
+    @commit = nil
+    @normalize = nil
+  end
+  
+  def normalize=(v)
+    @normalize = v
+  end
+  
+  def commit=(v)
+    @commit = v
+  end
+  
+  def watch=(v)
+    @watch = v
+  end
+  
+  def push(v)
+    @queue.push(v)
+    @queue = @watch.call(v) unless @watch.nil?
+    v
+  end
+  
+  def commit!
+    @queue = @normalize.call(@queue) unless @normalize.nil?
+    @commit.nil? ? @queue : @commit.call(@queue)
+  end
+end

data/lib/trail/version.rb

@@ -0,0 +1,3 @@
+module Trail
+  VERSION = "0.0.1"
+end

data/test/trail_test.rb

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'test/unit'
+require 'ruby-debug'
+
+require '../lib/trail'
+
+class TrailTest < Test::Unit::TestCase
+
+  def setup
+  end
+
+  def test_new
+    assert_nothing_raised { Trail.new }
+  end
+  
+  def test_commit
+    t = Trail.new
+    t.commit = lambda do |trail|
+      'hello'
+    end
+    
+    assert_equal 'hello', t.commit!
+  end
+  
+  def test_normalize=
+    t = Trail.new
+    t.normalize = lambda do |trail|
+      []
+    end
+    
+    10.times do
+      t.push('hello')
+    end
+    
+    assert_equal [], t.commit!
+  end
+  
+  def test_watch=
+    t = Trail.new
+    t.watch = lambda do |trail|
+      ['random']
+    end
+    
+    10.times do
+      t.push('hello')
+    end
+    
+    assert_equal ['random'], t.commit!
+  end
+end

data/trail.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "trail/version"
+
+Gem::Specification.new do |s|
+  s.name        = "trail"
+  s.version     = Trail::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Maurycy Pawlowski-Wieronski"]
+  s.email       = ["maurycy@g.pl"]
+  s.homepage    = "https://github.com/maurycy/trail"
+  s.summary     = %q{A lightweight queue for delayed and normalized execution}
+
+  s.rubyforge_project = "trail"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: trail
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Maurycy Pawlowski-Wieronski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-28 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: 
+email: 
+- maurycy@g.pl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- lib/trail.rb
+- lib/trail/version.rb
+- test/trail_test.rb
+- trail.gemspec
+has_rdoc: true
+homepage: https://github.com/maurycy/trail
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: trail
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A lightweight queue for delayed and normalized execution
+test_files: 
+- test/trail_test.rb