object_profiler 0.0.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YTZjZGUwNDI4MGVjMTM1ZjMxNjA0MzJkZDcyZmNmNzM1MWY1MDYxNg==
+  data.tar.gz: !binary |-
+    ODg0ZWU5YjNkZGU4MjFjZGMxMDZkZjdkNDFiNmY3OTdiZjk3MDZkOQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MjJiNDVhNWY3ZmY5NTc0MzUzYjdhZjI0ZTJjYWI3YzdhYzQwZTlmNmM3ZDIz
+    ZjE0MjU5MmQyZWE0ZjkxMDkwODUxZGQ5Yzg0YmRmNjg5MjZhMmUxZTMwM2Y4
+    OTc2N2RkNjJlNzJmZjAzODMyMzIwMjYyMzlkZDhlNjE3Njk0YjY=
+  data.tar.gz: !binary |-
+    NWNhZDZmNjIwYTQ4MjlkYjA4YWZhY2FiMjNlODYxNmVmZmE5MWQyNzZkZTRk
+    OWM2MTc2Y2NkOWZkNjE1MmZkZTRlMjZmZDk0YmI1ZWFlOWNiOTA5YWE1ZTc1
+    ODljOWI0YjU2ZmVkMDE2MjlhZjE2Zjk2ODhlZjYwYTYwM2NjOWY=

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 object_profilerr.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Tieg Zaharia
+
+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,64 @@
+# Object::Profiler
+
+Track how many Ruby objects your code is creating. In the style of GC::Profiler and 
+inspired by memprof.
+
+## Requirements
+
+1. A platform that supports DTrace (Solaris, OSX, etc)
+2. root access (required by DTrace)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'object_profiler'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install object_profiler
+
+## Usage
+
+    Object::Profiler.track { 
+      require 'rdoc/rdoc'
+    }
+    # => Amount File:Line:Class
+    # =>      1 /.../2.0.0/json/common.rb:67:JSON::Ext::Generator::State
+    # =>      1 /.../2.0.0/json/common.rb:68:JSON::Ext::Generator::State
+    # =>      1 /.../2.0.0/json/common.rb:75:JSON::Ext::Generator::State
+    # =>      1 /.../2.0.0/rdoc/generator/markup.rb:65:Range
+    # =>      1 /.../2.0.0/rdoc/text.rb:42:Hash
+    # =>      1 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler/rubygems_integration.rb:200:Gem::Dependency
+    # =>      1 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler/rubygems_integration.rb:207:Gem::LoadError
+    # =>      1 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler/shared_helpers.rb:23:Pathname
+    # =>      1 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler/shared_helpers.rb:23:String
+    # =>      1 /.../site_ruby/2.0.0/rubygems/requirement.rb:52:Gem::Requirement
+    # =>      2 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler.rb:177:Pathname
+    # =>      2 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler.rb:177:String
+    # =>      3 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler/rubygems_ext.rb:23:Pathname
+    # =>      5 /.../gems/2.0.0/gems/bundler-1.3.4/lib/bundler/rubygems_ext.rb:23:String
+    # =>      6 /.../2.0.0/rdoc/class_module.rb:5:Range
+    # =>      6 /.../2.0.0/rdoc/markdown/literals_1_9.rb:359:RDoc::Markdown::Literals::RuleInfo
+    # =>    240 /.../2.0.0/rdoc/markdown.rb:508:RDoc::Markdown::RuleInfo
+    # =>    274 Total
+
+## Usage - Rails Middleware
+
+  Add to your app initializers, ie `config/initializers/object_profiler.rb`:
+
+    require 'object/profiler/middleware'
+    My::Application.config.middleware.use(::Object::Profiler::Middleware, {:output => 'object_profiler.log'})
+
+  Run the server and tail the log:
+
+    sudo rails s
+
+## Useful DTrace links
+
+1. https://wikis.oracle.com/display/DTrace/Documentation
+

data/Rakefile

@@ -0,0 +1,11 @@
+$: << "lib"
+require 'object/profiler/profiler'
+g
+task :test do
+  Object::Profiler.track { 
+    10.times { Hash.new }
+    3.times { Class.new }
+    2.times { String.new }
+    7.times { Array.new }
+  }
+end

data/lib/object/profiler/middleware.rb

@@ -0,0 +1,19 @@
+require ::File.expand_path('../profiler.rb',  __FILE__)
+
+class Object
+  class Profiler
+    class Middleware
+      def initialize(app, options={})
+        @app    = app
+        @output = options[:output] ? File.open(options[:output], 'w+') : STDOUT
+
+      end
+
+      def call(env)
+        Object::Profiler.track(@output) { 
+          @app.call(env)
+        }
+      end
+    end
+  end
+end

data/lib/object/profiler/probes/object_create.d

@@ -0,0 +1,10 @@
+ruby*:::object-create
+{
+    /* FILE - LINE - CLASS */
+    this->val = copyinstr(arg1);
+    this->val = strjoin(this->val, ":");
+    this->val = strjoin(this->val, lltostr(arg2));
+    this->val = strjoin(this->val, ":");
+    this->val = strjoin(this->val, copyinstr(arg0));
+    @objs[this->val] = count(); 
+}

data/lib/object/profiler/profiler.rb

@@ -0,0 +1,65 @@
+if not system("dtrace -l -i :::jabberwocky")
+  raise "DTrace not responding. Are you running with sudo?"
+end
+
+require 'tempfile'
+
+class Object
+  class Profiler
+    class << self
+      def track(output=nil)
+        raise "Object::Profiler.track requires a block." unless block_given?
+
+        enable
+        result = yield
+        disable
+        report(output)
+
+        return result
+      end
+
+      def enable
+        return if enabled?
+
+        @tmpfile = Tempfile.new("object::profiler")
+        @report = nil
+        probe = File.join(__dir__, 'probes', 'object_create.d')
+        @pid = Process.spawn "dtrace -q -s #{probe} -p #{$$} -o #{@tmpfile.path}"
+
+        # Better way to wait for dtrace to work?
+        sleep 1
+      end
+
+      def enabled?
+        !!@pid
+      end
+
+      def disable
+        return unless enabled?
+
+        Process.kill("SIGINT", @pid)
+        Process.wait
+        @pid = nil
+      end
+
+      def report(io=nil)
+        if !@report
+          @tmpfile.rewind
+        
+          # TODO: Could this be done in the provider instead?
+          results = []
+          @tmpfile.read.strip.lines.each do |line|
+            file_line_type, amount = line.split(" ")
+            results << [amount.to_i, file_line_type]
+          end
+          @report = results.map { |r| "%10d %s" % r }
+          @report << "%10d %s" % [results.map(&:first).inject(0, &:+), "Total"]
+          @report.unshift "\n%10s %s" % ["Amount", "File:Line:Class"]
+
+        end
+        io ||= STDOUT
+        io.puts @report.join("\n")
+      end
+    end
+  end
+end

data/lib/object/profiler/version.rb

@@ -0,0 +1,5 @@
+class Object
+  class Profiler
+    VERSION = "0.0.3"
+  end
+end

data/lib/object_profiler.rb

@@ -0,0 +1,2 @@
+require 'object/profiler/version'
+require 'object/profiler/profiler'

data/object_profiler.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'object/profiler/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "object_profiler"
+  spec.version       = Object::Profiler::VERSION
+  spec.authors       = ["Tieg Zaharia"]
+  spec.email         = ["tieg.zaharia@gmail.com"]
+  spec.description   = %q{Object::Profiler uses DTrace probes in Ruby 2.0 to help instrument your code.}
+  spec.summary       = %q{Object::Profiler uses DTrace probes in Ruby 2.0 to help instrument your code.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  # spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  # spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: object_profiler
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Tieg Zaharia
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Object::Profiler uses DTrace probes in Ruby 2.0 to help instrument your
+  code.
+email:
+- tieg.zaharia@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/object/profiler/middleware.rb
+- lib/object/profiler/probes/object_create.d
+- lib/object/profiler/profiler.rb
+- lib/object/profiler/version.rb
+- lib/object_profiler.rb
+- object_profiler.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Object::Profiler uses DTrace probes in Ruby 2.0 to help instrument your code.
+test_files: []