space_observatory 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c33aabad489c6d4e3fe00a0d270daaf7694450aa
+  data.tar.gz: 2c22ce59b2d4d6c2aba4310d931261eae95f4d03
+SHA512:
+  metadata.gz: 5056147bf38a148f8a28c6a35af85f6a691b4073507291224ec8d45630cf1a9556da97e5788453fb2164369554e2a9bcfd8151016b018e76580af2909d3974e6
+  data.tar.gz: df671b5081f41a0418ccf499860cb7c16b7732a36de3b6a013ab5f04df857e3a61907515eccc4e47a9202f14eb76e4fca33e85c1faa335c6ad7d319c7ec3fa40

data/.gitignore

@@ -0,0 +1,25 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.ruby-version
+Gemfile.lock
+InstalledFiles
+_yardoc
+bin/
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+vendor/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,4 @@
+--color
+--default-path spec
+--fail-fast
+--format doc

data/.yardopts

@@ -0,0 +1,2 @@
+--readme README.md
+lib/**/*.rb

data/Gemfile

@@ -0,0 +1,27 @@
+#! /your/favourite/path/to/bundler
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in space_observatory.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Urabe, Shyouhei
+
+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,28 @@
+# SpaceObservatory
+
+This is an easy add-on for you to observe your ObjectSpace.
+
+## Main Features
+
+- Pure ruby.  NO C extensions.
+- Drop-in design that requires NO modifications to your program.
+- Minimal overhead.  Does all jobs except data collection in a separate process.
+
+## Installation
+
+As usual.
+
+## Usage
+
+```bash
+bundle exec with-space-observatory.rb --port=1234 -- ruby bin/rails server --port=5678
+```
+
+This command starts two HTTP servers on ports 1234 and 5678 each.  1234 (for this case) is for probing object space of rails server which listens port 5678.
+
+`with-space-observatory.rb --help` might expose more option(s).
+
+## TODOs
+
+- Probing is slow.  Should cache.
+- JSON is valid, but not that pretty.

data/Rakefile

@@ -0,0 +1,69 @@
+#! /your/favourite/path/to/rake
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+
+require 'rubygems'
+require 'bundler/setup'
+require 'rake'
+Bundler.setup :default
+
+begin
+  require "bundler/gem_tasks"
+  Bundler.setup :default, :development
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+begin
+  Bundler.require :development
+  require 'rspec/core/rake_task'
+
+  YARD::Rake::YardocTask.new
+
+  RSpec::Core::RakeTask.new :spec do |spec|
+    spec.pattern = FileList['spec/**/*_spec.rb']
+  end
+
+  task default: :spec
+rescue LoadError, NameError
+  # OK, they can be absent on non-development mode.
+end
+
+desc "a la rails console"
+task :console do
+  require_relative "lib/space_observatory"
+  require 'irb'
+  require 'irb/completion'
+  ARGV.clear
+  IRB.start
+end
+task :c => :console
+
+desc "pry console"
+task :pry do
+  require_relative "lib/space_observatory"
+  require 'pry'
+  ARGV.clear
+  Pry.start
+end

data/exec/with-space-observatory.rb

@@ -0,0 +1,125 @@
+#! /your/favourite/path/to/ruby
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+
+# This file is  ultra tricky because it  can be both executed as  a script, AND
+# required as  a library.  PLUS, when  required, it shall not  leak any objects
+# because that should affect its probing result.
+#
+#     The cause of  this evilness is that we cannot  assume our helper routines
+#     are on the  load path.  So the  only safe assumption is  the existance of
+#     this  exact file.   Thank goodness  we can  know the  path of  ourself by
+#     querying  __FILE__.    Requiring  this  should  solve   this  wire-puzzle
+#     situation.
+
+if __FILE__ == $0
+  # This case we are  executed as a script (first stage).   Our mission here is
+  # to spawn  a process  that acts  as JSONRPC server,  then exec  the original
+  # projectile, with injecting two file descriptors that connect to the spawned
+  # server.
+
+  # SIGINT shall interrupt us properly.
+  Signal.trap "INT" do
+    Process.exit false # false indicates failure.
+  end
+
+  require 'rubygems'
+  require 'space_observatory/base_station'
+
+  tx, rx, pid, argw = SpaceObservatory::BaseStation.rackup! ARGV
+
+  # Wait for spawned process to parse ARGV...
+
+  case line = rx.gets
+  when "space_observatory ok\n" then
+    # Normal.  Propel second stage.
+    path = File.expand_path __FILE__
+    argh = { 7 => tx, 8 => rx } # FDs < 7 happen to be reserved somehow in ruby
+    arge = {
+      'RUBYOPT'  => (ENV['RUBYOPT'] || '') + " -r #{path}",
+      'BASE_PID' => pid.to_s,
+    }
+    Process.exec arge, *argw, argh
+    # /* NOTREACHED */
+
+  when "space_observatory norun\n" then
+    # No need to run, or no runnable projectile specified
+    STDOUT.write rx.read # dump if any
+    Process.exit true
+
+  else
+    # Something went wrong
+    STDOUT.puts line
+    STDOUT.write rx.read # dump if any
+    Process.exit false
+  end
+
+else
+  # We  are `require`d  here  (second  stage).  This  case  we  SNEAK INTO  the
+  # projectile.  So to minimize the impact  of our presence, we require nothing
+  # but `objspace.so`.
+  #
+  # This part is  a hand-crafted state-of-art sh*t that I  believe is unable to
+  # unit-test.  Just feel it.  It works.  For me.
+
+  begin
+    # File descriptor number 7 and 8 should have been passed (see 1st stage).
+    tx = IO.for_fd 7, 'wb:binary:binary'
+    rx = IO.for_fd 8, 'rb:binary:binary'
+    th = Thread.start do
+      begin
+        tx.puts 'space_observatory hello' # handshake
+        tx.flush
+        loop do
+          case rx.gets
+          when "space_observatory setup\n" then
+            require 'objspace'
+          when "space_observatory probe\n" then
+            # This is the key part of this entire lib.
+            Thread.exclusive do
+              tx.puts 'space_observatory begin_objspace'
+              ObjectSpace.dump_all output: tx
+              tx.puts 'space_observatory end_objspace'
+              tx.flush
+            end
+          when "space_observatory teardown\n", NilClass then
+            Thread.exit
+          end
+        end
+      rescue Errno::EPIPE
+        # Abnormal end of peer
+      end
+    end
+    at_exit do
+      Thread.exclusive do
+        tx.puts 'space_observatory projectile_eof'
+        tx.flush
+      end
+      th.join
+      tx.close_write
+      rx.close_read
+      Process.waitpid ENV['BASE_PID'].to_i if ENV['BASE_PID']
+    end
+  rescue Errno::EBADF, Errno::EINVAL
+    # Maybe a grand-child process.  Just leave nothing.
+  end
+end

data/lib/space_observatory.rb

@@ -0,0 +1,28 @@
+#! /your/favourite/path/to/ruby
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+
+require_relative "space_observatory/version"
+
+module SpaceObservatory
+  # Your code goes here...
+end

data/lib/space_observatory/base_station.rb

@@ -0,0 +1,163 @@
+#! /your/favourite/path/to/ruby
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+
+require 'rubygems'
+require 'open3'
+require 'sync'
+require 'rack'
+require 'slop'
+require_relative '../space_observatory'
+
+class SpaceObservatory::BaseStation
+  # Fork a base station process
+  # @param  [Array]  argv     The ::ARGV
+  # @return [IO, IO, Integer, Array]  child's socket, pid, and argv.
+  def self.rackup! argv
+    _, a    = parse argv
+    path    = File.expand_path __FILE__
+    cmdline = %W"-r #{path} -e SpaceObservatory::BaseStation.construct --"
+    i, o, t = Open3.popen2 %w'ruby ruby', *cmdline, *argv
+    return i, o, t.pid, a
+  end
+
+  # Child process entry point
+  def self.construct
+    obj = new ARGV, STDIN, STDOUT
+    if obj.need_rackup?
+      obj.start_collector
+      obj.rackup
+    else
+      obj.banner
+    end
+  end
+
+  # Parse command line
+  # @param [Array] argv argv
+  # @return [Slop, Array] parsed command line parameters, and remains.
+  def self.parse argv
+    argw = argv.dup
+    opts = Slop.parse! argw do
+      on 'h', 'help', 'this message'
+      on 'port=', 'JSONRPC port', as: Integer
+      on 'ttl=', 'cache expiration (in seconds)', as: Float
+    end
+    return opts, argw
+  end
+
+  # @param [Array] argv   the ::ARGV
+  # @param [IO]    stdin  the ::STDIN
+  # @param [IO]    stdout the ::STDOUT
+  def initialize argv, stdin, stdout
+    @argv        = argv
+    @stdin       = stdin
+    @stdout      = stdout
+    @stdout.sync = true # we need line IO
+    @opts, @argw = self.class.parse argv
+    @argw.shift if @argw.first == '--'
+    @started     = Time.at 0
+    @finished    = Time.at 0
+    @jsons       = Array.new
+    @rwlock      = Sync.new
+    @expires     = @opts['ttl'] || 60 # 300 # 3600
+  end
+
+  def rackup
+    Rack::Handler::WEBrick.run self, Port: @opts['port']
+  end
+
+  def banner
+    @stdout.puts "space_observatory norun"
+    @stdout.puts @opts.help if @opts['h']
+    @stdout.flush
+    @stdout.close_write
+  end
+
+  def start_collector
+    Thread.start do
+      # needs handshale
+      @stdout.puts "space_observatory ok"
+      @stdin.gets # wait execve(2)
+      @stdout.puts "space_observatory setup"
+      @stdout.puts "space_observatory probe"
+      while line = @stdin.gets
+        case line
+        when "space_observatory projectile_eof\n"
+          Rack::Handler::WEBrick.shutdown rescue nil
+          @stdout.close
+          return
+        when "space_observatory begin_objspace\n"
+          @started = Time.now
+          @rwlock.lock Sync::EX
+          @jsons   = Array.new
+        when "space_observatory end_objspace\n"
+          @rwlock.unlock Sync::EX
+          @finished = Time.now
+          STDERR.printf "took %fsec\n", (@finished - @started).to_f
+        when /\A{/o
+          # This is the output of ObjectSpace.dump_all
+          @jsons.push line
+        else
+		raise "TBW: #{line}"
+        end
+      end
+    end
+  end
+
+  def need_rackup?
+    not @opts['h'] and not @argw.empty?
+  end
+
+  def call env
+    # TODO: more "proper" JSON
+    enum = Enumerator.new do |y|
+      @rwlock.synchronize Sync::EX do
+        if Time.now - @started >= @expires
+          @stdout.puts "space_observatory probe"
+          IO.select [@stdin], [], [], 10
+          @started = Time.now # prevent further probe
+        end
+      end
+      Thread.pass
+      @rwlock.synchronize Sync::SH do
+        id = @finished.to_i
+        y.yield <<-"]"
+          {
+            "jsonrpc" : "2.0",
+            "id" : #{id},
+            "result" : [
+        ]
+        @jsons.each_with_index do |i, j|
+          y.yield "," unless j.zero?
+          y.yield i
+        end
+        y.yield "]\n}\n"
+      end
+    end
+
+    return [
+      200,
+      { 'Content-Type' => 'application/json' },
+      enum
+    ]
+  end
+end

data/lib/space_observatory/version.rb

@@ -0,0 +1,25 @@
+#! /your/favourite/path/to/ruby
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+module SpaceObservatory
+  VERSION = "0.0.1"
+end

data/space_observatory.gemspec

@@ -0,0 +1,54 @@
+#! /your/favourite/path/to/gem
+# -*- coding: utf-8; mode: ruby; ruby-indent-level: 2 -*-
+#
+# Copyright (c) 2014 Urabe, Shyouhei
+#
+# 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.
+
+require 'rubygems'
+require_relative 'lib/space_observatory/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "space_observatory"
+  gem.version       = SpaceObservatory::VERSION
+  gem.authors       = ["Urabe, Shyouhei"]
+  gem.email         = ["shyouhei@ruby-lang.org"]
+  gem.summary       = "ObjectSpace#dump_all exposed"
+  gem.description   = "Pure-ruby Minimal-overhead Drop-in probe to ObjectSpace."
+  gem.homepage      = "https://github.com/shyouhei/space_observatory"
+  gem.license       = "MIT"
+
+  gem.bindir        = "exec"
+  gem.files         = `git ls-files -z`.split("\x0")
+  gem.executables   = gem.files.grep(%r{^exec/}) { |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.required_ruby_version = '~> 2.1'
+  gem.add_development_dependency 'yard',      '~> 0.8'
+  gem.add_development_dependency 'rdoc',      '~> 4.0'
+  gem.add_development_dependency 'rspec',     '~> 3.0'
+  gem.add_development_dependency 'rspec-its'
+  gem.add_development_dependency 'simplecov', '>= 0'
+  gem.add_development_dependency 'bundler',   '~> 1.6'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'pry'
+  gem.add_dependency 'rack' # we use pure-rack
+  gem.add_dependency 'slop'
+end

metadata

@@ -0,0 +1,198 @@
+--- !ruby/object:Gem::Specification
+name: space_observatory
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Urabe, Shyouhei
+autorequire: 
+bindir: exec
+cert_chain: []
+date: 2014-07-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  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'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Pure-ruby Minimal-overhead Drop-in probe to ObjectSpace.
+email:
+- shyouhei@ruby-lang.org
+executables:
+- with-space-observatory.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".yardopts"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- exec/with-space-observatory.rb
+- lib/space_observatory.rb
+- lib/space_observatory/base_station.rb
+- lib/space_observatory/version.rb
+- space_observatory.gemspec
+homepage: https://github.com/shyouhei/space_observatory
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: ObjectSpace#dump_all exposed
+test_files: []
+has_rdoc: