cadence 0.0.1

data/README.textile

@@ -0,0 +1,47 @@
+h1. Cadence
+
+Track counts and compute rate of iteration. Set up callbacks for various
+intervals such as @every@ n increments or every n @ticks@.
+
+h2. Sample
+
+<pre>
+require 'lib/cadence'
+
+data = (1..100).to_a
+
+computer = Cadence::Computer.new do |c|
+  c.every 5 do
+    p [:every, 5, n]
+  end
+  
+  c.for(:tens).every do
+    p [:tens, :every, n]
+  end
+  
+  c.twenties.every 2 do
+    p [:twenties, :every, 2, n]
+  end
+  
+  c.ticks 1 do
+    p [:tock, n, timestamp]
+  end
+end
+
+computer.start do |c|
+  data.each do |n|
+    c.next
+    c.tens.next if n % 10 == 0
+    p [:n, n]
+    sleep 0.02
+  end
+end
+</pre>
+
+h2. License
+
+MIT
+
+h2. Copyright
+
+Copyright (C) 2010 Matt Todd.

data/Rakefile

@@ -0,0 +1,5 @@
+task :test do
+  require 'test/cadence_test'
+end
+
+task :default => :test

data/lib/cadence/computer/counter.rb

@@ -0,0 +1,25 @@
+class Cadence::Computer::Counter
+  
+  attr_accessor :count, :triggers
+  
+  def initialize(count = 0)
+    @count    = 0
+    @triggers = {}
+  end
+  
+  def every(n = 1, &block)
+    @triggers[n] = block
+  end
+  
+  def next
+    @count += 1
+    @triggers.each do |(n, trigger)|
+      instance_eval(&trigger) if @count % n == 0
+    end
+  end
+  
+  def n
+    @count
+  end
+  
+end

data/lib/cadence/computer.rb

@@ -0,0 +1,69 @@
+class Cadence::Computer
+  
+  attr_accessor :started_at, :finished_at, :duration,
+                :counter, :counters, :total
+  
+  def initialize
+    @counter  = Counter.new
+    @counters = {}
+    @ticks    = {}
+    
+    yield self
+  end
+  
+  ### Keys
+  
+  def for(key)
+    self.counters[key] ||= Counter.new
+  end
+  def method_missing(method_name, *args, &block)
+    self.for(method_name, &block)
+  end
+  
+  ### Overall total and count tracking
+  
+  def every(n = 1, &block)
+    @counter.every(n, &block)
+  end
+  def next
+    @counter.next
+    @ticks.each do |(n, (last, tick))|
+      @ticks[n] = [self.duration.to_i, tick]
+      instance_eval(&tick) if self.duration.to_i > last.to_i && self.duration.to_i % n == 0
+    end
+  end
+  
+  ### Timing
+  
+  def ticks(n = 1, &block)
+    @ticks[n] ||= [nil, block]
+  end
+  
+  ### Runtime
+  
+  def start
+    @started_at   = self.timestamp
+    yield self
+    @finished_at  = self.timestamp
+    
+    @duration = @finished_at - @started_at
+  end
+  
+  def timestamp
+    Time.now
+  end
+  
+  def duration
+    self.timestamp.to_f - self.started_at.to_f
+  end
+  
+  def rate
+    # self.duration / self.counter.count
+    self.counter.count / self.duration
+  end
+  
+  def n
+    self.counter.count
+  end
+  
+end

data/lib/cadence.rb

@@ -0,0 +1,5 @@
+module Cadence
+end
+
+require 'lib/cadence/computer'
+require 'lib/cadence/computer/counter'

data/test/cadence_test.rb

@@ -0,0 +1,32 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..'))
+require 'lib/cadence'
+
+data = (1..100).to_a
+
+computer = Cadence::Computer.new do |c|
+  c.every 5 do
+    p [:every, 5, n]
+  end
+  
+  c.for(:tens).every do
+    p [:tens, :every, n]
+  end
+  
+  c.twenties.every 2 do
+    p [:twenties, :every, 2, n]
+  end
+  
+  c.ticks 1 do
+    p [:tock, n, timestamp]
+  end
+end
+
+computer.start do |c|
+  data.each do |n|
+    c.next
+    c.tens.next if n % 10 == 0
+    c.twenties.next if n % 20 == 0
+    p [:n, n]
+    sleep 0.02
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: cadence
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matt Todd
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-01 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: "    Track counts and compute rate of iteration. Set up callbacks for various\n    intervals such as every n increments or every n ticks.\n    \n    computer = Cadence::Computer.new do |c|\n      c.every 5 do\n        p [:completed_processing, n]\n      end\n    end\n    \n    computer.start do |c|\n      1.upto(100) do |n|\n        c.next\n        # do magic here\n      end\n    end\n    \n    Mostly intended for providing intermitent feedback of the progress of tasks\n    that will run for lengthy periods of time.\n    \n    Rudimentary support for time-based callbacks is possible through #ticks.\n"
+email: mtodd@highgroove.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.textile
+- Rakefile
+- lib/cadence/computer/counter.rb
+- lib/cadence/computer.rb
+- lib/cadence.rb
+- test/cadence_test.rb
+has_rdoc: true
+homepage: http://github.com/mtodd/cadence
+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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Interval/period callback library
+test_files: []
+