quixote 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc
+.DS_Store
+
+# docs
+rdoc
+doc
+.yardoc
+
+# vim
+*.swp
+
+# rcov generated
+coverage

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2012. Matt Sanders.
+All rights reserved.
+
+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. No attribution is required by products that make use of this 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.
+
+Except as contained in this notice, the name(s) of the above copyright holders shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization.
+
+Contributors to this project agree to grant all rights to the copyright holder of the primary product. Attribution is maintained in the source control history of the product.

data/README.md

@@ -0,0 +1,59 @@
+Quixote
+=======
+
+A simple tool for statefully generating time-series data.
+
+## Installation
+
+In your shell:
+
+    gem install quixote
+
+Then, in your application or script:
+
+    require 'quixote'
+
+## Basic Usage
+
+For each data stream you want to generate, set up a `Quixote` object. Here are some examples:
+
+    percentage = Quixote.new(:min => 0, :max => 100, :range_by => 10)
+    fahrenheit = Quixote.new(:min => -30.0, :max => 120.0, :range_by => 3.0)
+    
+If you don't specify any initialization options the object will be assumed to be a percentage and will default to the settings of the `percentage` object above.
+    
+An initial value will be randomly generated and can be accessed with `#last`:
+
+	percentage.last #=> 58 
+	
+If you want to enforce a certain starting value, just set last to whatever you want:
+
+	percentage.last = 60
+
+By default each following value will range up or down by a random value up to a max of `range_by`. To get a series of stateful values just call `#next`:
+
+    percentage.next #=> 64
+    percentage.next #=> 66
+	percentage.next #=> 58
+	
+You can use `#last` to retrieve the most recently generated number or move the range to a number you select at any time.
+	
+This makes it trivial to generate stateful runs of any length you want:
+
+    values = []
+    100.times { values << percentage.next }
+    
+    values #=> [49, 55, 48, …]
+
+
+## Contribution
+
+* Check the latest master to make sure the feature hasn't been implemented / the bug hasn't been fixed yet.
+* Check the issue tracker to see if someone has already requested and/or contributed it.
+* Fork the project and submit a pull request from a feature or bugfix branch.
+* Please include tests. This is important so we don't break your changes unintentionally in a future version.
+* Please don't modify the gemspec, Rakefile, version, or changelog. If you do change these files, please isolate a separate commit so we can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2012 Matt Sanders. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+# IRB
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/quixote.rb"
+end

data/lib/quixote.rb

@@ -0,0 +1,49 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require "quixote/version"
+
+class Quixote
+  attr_accessor :min, :max, :range_by, :last
+
+  def initialize(options={})
+    defaults = {
+      :max => 100,
+      :min => 0,
+      :range_by => 10
+    }
+
+    defaults.merge(options).each do |key, value|
+      send("#{key}=", value)
+    end
+
+    @last = random_start_point
+  end
+
+  def next
+    if last == max
+      decrement
+    elsif last == min || (rand < 0.5)
+      increment
+    else
+      decrement
+    end
+    last
+  end
+
+  private
+
+  def increment
+    @last += rand(range_by+1)
+    @last = max if last > max
+  end
+
+  def decrement
+    @last -= rand(range_by+1)
+    @last = min if last < min
+  end
+  
+  def random_start_point
+    rand((max-min)+1) + min
+  end
+end

data/lib/quixote/version.rb

@@ -0,0 +1,3 @@
+class Quixote
+  VERSION = "0.0.1"
+end

data/quixote.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "quixote/version"
+
+Gem::Specification.new do |s|
+  s.name        = "quixote"
+  s.version     = Quixote::VERSION
+
+  s.authors     = ["Matt Sanders"]
+  s.email       = ["matt@modal.org"]
+  s.homepage    = "https://github.com/nextmat/quixote"
+  s.summary     = %q{Simple stateful generator for time-series data}
+  s.description = %q{A flexible, stateful generator for sample time-series data}
+
+  #s.rubyforge_project = "quixote"
+  
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.extra_rdoc_files = %w[LICENSE]
+
+  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"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'minitest/autorun'
+require 'pp'
+
+# require pry if available
+begin
+  require 'pry'
+rescue LoadError
+end
+
+require 'quixote'

data/test/test_quixote.rb

@@ -0,0 +1,53 @@
+puts "running"
+
+require "helper"
+
+class TextQuixote < MiniTest::Spec
+
+  def test_defaults
+    q = Quixote.new
+    assert_equal 100, q.max
+    assert_equal 0, q.min
+    assert_equal 10, q.range_by
+  end
+  
+  def test_initialization
+    q = Quixote.new(:min => 50, :max => 200, :range_by => 80)
+    assert_equal 50, q.min
+    assert_equal 200, q.max
+    assert_equal 80, q.range_by
+  end
+  
+  def test_starting_point
+    100.times do
+      q = Quixote.new(:max => 20, :min => 10)
+      assert q.last >= 10, "#{q.last} is < min (10)"
+      assert q.last <= 20, "#{q.last} is > max (20)"
+    end
+    
+    q = Quixote.new
+    q.last = 25
+    assert_equal 25, q.last, 'last should be settable'
+  end
+  
+  def test_range_limits
+    q = Quixote.new(:min => 1, :max => 10, :range_by => 4)
+    values = []
+    1000.times { values << q.next } # build up a bunch of values
+    assert values.min >= 1, 'should never range below min'
+    assert values.max <= 10, 'should never range above max'
+  end
+  
+  def test_range_size
+    q = Quixote.new(:min => 1, :max => 20, :range_by => 6)
+    last = q.last
+    deltas = []
+    1000.times do
+      deltas << (q.next - last).abs
+      last = q.last
+    end
+    assert_equal 6, deltas.max
+    assert_equal 0, deltas.min
+  end
+
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: quixote
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Matt Sanders
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-15 00:00:00.000000000 Z
+dependencies: []
+description: A flexible, stateful generator for sample time-series data
+email:
+- matt@modal.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/quixote.rb
+- lib/quixote/version.rb
+- quixote.gemspec
+- test/helper.rb
+- test/test_quixote.rb
+homepage: https://github.com/nextmat/quixote
+licenses: []
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: Simple stateful generator for time-series data
+test_files:
+- test/helper.rb
+- test/test_quixote.rb
+has_rdoc: