slydell 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Trae Robrock
+
+MIT License
+
+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.md

@@ -0,0 +1,42 @@
+# Slydell
+
+Named after Bob Slydell (the Office Space "efficiency expert". This gem will help you track the time utilization of certain methods
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'slydell'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install slydell
+
+## Usage
+
+```ruby
+class MyHeavilyUsedClass
+  include Slydell
+
+  def run_job
+    sleep 10
+    run_some_long_code
+  end
+  track_utilization :run_job
+end
+```
+
+This should report statistics to Statsd via the `$statsd` global using the github-statsd gem
+TODO: Write more about the above
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/slydell.rb

@@ -0,0 +1,96 @@
+require "slydell/version"
+
+module Slydell
+  module ClassMethods
+    def track_utilization(method)
+      class_eval <<-RB
+        alias_method :#{method}_without_tracking, :#{method}
+
+        def #{method}(*args)
+          track_utilization do
+            #{method}_without_tracking *args
+          end
+        end
+      RB
+    end
+  end
+
+  def self.included(base)
+    base.extend ClassMethods
+  end
+
+  private
+
+  def track_utilization
+    reset_window! if @__utilization_tracker.nil? || should_reset_window?
+    start_processing = Time.now
+
+    result = with_sleep_tracking { yield }
+
+    stop_processing = Time.now
+
+    time_to_process = stop_processing - start_processing
+    time_idle       = start_processing - @__utilization_tracker["last_process_finished"]
+
+    @__utilization_tracker["idle_time"]       += (time_idle + sleep_time)
+    @__utilization_tracker["processing_time"] += (time_to_process - sleep_time)
+    @__utilization_tracker["processed_jobs"]  += 1
+    @__utilization_tracker["last_process_finished"] = stop_processing
+    reset_sleep_time!
+
+    StatsTracker.gauge("workling.utilization", utilization)
+
+    result
+  end
+
+  def with_sleep_tracking
+    Kernel.class_eval <<-RB
+      def sleep_with_tracking(duration=nil)
+        start = Time.now
+        res = sleep_without_tracking duration
+        stop = Time.now
+        Thread.current["Slydell::sleep"] ||= 0
+        Thread.current["Slydell::sleep"] += (stop - start)
+        res
+      end
+
+      alias_method :sleep_without_tracking, :sleep
+      alias_method :sleep, :sleep_with_tracking
+    RB
+
+    yield
+  ensure
+    Kernel.class_eval <<-RB
+      alias_method :sleep_with_tracking, :sleep
+      alias_method :sleep, :sleep_without_tracking
+    RB
+  end
+
+  def sleep_time
+    Thread.current["Slydell::sleep"]
+  end
+
+  def reset_sleep_time!
+    Thread.current["Slydell::sleep"] = 0
+  end
+
+  def should_reset_window?
+    (Time.now - @__utilization_tracker["window_start"]) > 5*60 # 5 minutes
+  end
+
+  def utilization
+    @__utilization_tracker["processing_time"] /
+      (@__utilization_tracker["processing_time"] +
+       @__utilization_tracker["idle_time"])
+  end
+
+  def reset_window!
+    @__utilization_tracker ||= {}
+    @__utilization_tracker["window_start"]          = Time.now
+    @__utilization_tracker["last_process_finished"] = @__utilization_tracker["window_start"]
+    @__utilization_tracker["processed_jobs"]        = 0
+    @__utilization_tracker["idle_time"]             = 0
+    @__utilization_tracker["processing_time"]       = 0
+    reset_sleep_time!
+  end
+end

data/lib/slydell/version.rb

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

data/slydell.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/slydell/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Trae Robrock"]
+  gem.email         = ["trobrock@gmail.com"]
+  gem.description   = %q{Track the time utilization of methods, including time spent sleeping}
+  gem.summary       = %q{Named after Bob Slydell (the Office Space "efficiency expert".
+    This gem will help you track the time utilization of certain methods}
+  gem.homepage      = "https://github.com/trobrock/slydell"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "slydell"
+  gem.require_paths = ["lib"]
+  gem.version       = Slydell::VERSION
+
+  gem.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: slydell
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Trae Robrock
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Track the time utilization of methods, including time spent sleeping
+email:
+- trobrock@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/slydell.rb
+- lib/slydell/version.rb
+- slydell.gemspec
+homepage: https://github.com/trobrock/slydell
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3690250929880869365
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3690250929880869365
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Named after Bob Slydell (the Office Space "efficiency expert". This gem will
+  help you track the time utilization of certain methods
+test_files: []