dtracer 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 35633957f1d2837f8e43d24ad211683ebb434dee
+  data.tar.gz: fe3d29ee7ff8ead9e2f3da297bb3649fb8c371ae
+SHA512:
+  metadata.gz: 348da84583a7df13c9cc386147b99b241470b273fd6a49aae8b9e06db25b6b02328ffa4d0907cb9537870f462972aedd435113059992d5efc19167eda2f7a662
+  data.tar.gz: e1d2210e72e66253d3be0aa5a3bcfd5b98d99355ae37bd4f7eecf5b8e52ae078fe725e625228ee00b7c2e417e5429010ad756f3d3a88b9406af5ce6bbe57578e

data/.gitignore

@@ -0,0 +1,101 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+# Created by https://www.gitignore.io
+
+### RubyMine ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm
+
+*.iml
+
+## Directory-based project format:
+.idea/
+# if you remove the above rule, at least ignore the following:
+
+# User-specific stuff:
+# .idea/workspace.xml
+# .idea/tasks.xml
+# .idea/dictionaries
+
+# Sensitive or high-churn files:
+# .idea/dataSources.ids
+# .idea/dataSources.xml
+# .idea/sqlDataSources.xml
+# .idea/dynamic.xml
+# .idea/uiDesigner.xml
+
+# Gradle:
+# .idea/gradle.xml
+# .idea/libraries
+
+# Mongo Explorer plugin:
+# .idea/mongoSettings.xml
+
+## File-based project format:
+*.ipr
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+
+
+### Ruby ###
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Omar Abdelhafith
+
+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,67 @@
+# DTracer
+
+DTracer is part ruby gem, part iOS pod, that helps the sending and receiving of DTrace commands.
+The `dtracer` gem will listen to the DTrace commands that are sent from the [OADTraceSender]() pod.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'dtracer'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dtracer
+
+## Usage
+
+1. Incorporate the `OADTraceSender` in your iOS project ([how to?]())
+2. Use `OADTraceSender` in your iOS app, to send a dtrace command.
+3. Run the iOS app to register the probes.
+4. Use `dtracer` gem command line to register a probe.
+
+Any dtrace command you send will be received on your terminal.   
+
+Note: registering a probe using DTrace requires admin privileges, running any dtracer command will ask for that.
+
+### Type of probes
+
+One good usage of DTrace is to log the network communicate instead of polluting the Xcode console.
+
+Using DTrace to log network communication has the following benefits:
+- Avoids Xcode console pollution with network logs.
+- Extremely cheap; probes that are not being listened do not add any overhead.
+
+To check how to implement OADtraceSender in your iOS project, check [OADtraceSender pod]().
+
+Using `dtracer` command you can register 3 types of tracers.
+
+#### Request probes
+These are probes that listens to dtrace command sent from `[OADTracer traceRequest:]` objc method. 
+- `tracer curl`: outputs the the `NSURLRequest` send with the dtrace event as a curl command.
+- `tracer details`: outputs the the `NSURLRequest` send with the dtrace event as a formatted string. You can pass it multiple flags to decide what to print from the request.
+
+Using the `-r` flag with both of the above will add a response probe tee.
+
+#### Response probes
+`dtracer response` adds a probe that outputs the `NSURLResponse`, `NSData` and `NSError` combination, sent using `[OADTracer traceResponse:data:error:]` objc method. 
+
+#### String probes
+In case you have the need to send any arbitrary string, then use `dtracer custom`; This command adds a probe that prints any string sent using `[OADTracer traceString:]` objc method. 
+
+## Contributing
+
+1. Fork it ( https://github.com/oarrabi/dtracer/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## Tests
+[Yes! ](https://github.com/oarrabi/dtracer/tree/master/spec)

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new :test do |task|
+  task.verbose = false
+  task.rspec_opts = ['--color', '--format', 'doc']
+end

data/bin/dtracer

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'dtracer/cli'
+
+DTracer::CLI.start

data/dtracer.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dtracer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "dtracer"
+  spec.version       = DTracer::VERSION
+  spec.authors       = ["Omar Abdelhafith"]
+  spec.email         = ["o.arrabi@me.com"]
+  spec.summary       = %q{DTracer is part ruby gem, part iOS pod, that helps the sending and receiving of DTrace commands..}
+  spec.description   = %q{DTracer is part ruby gem, part iOS pod, that helps the sending and receiving of DTrace commands.
+The `dtracer` gem will listen to the DTrace commands that are sent from the [OADTraceSender]() pod.}
+  spec.homepage      = "http://nsomar.com/dtracer"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_dependency "thor"
+end

data/lib/dtracer.rb

@@ -0,0 +1,4 @@
+require "dtracer/version"
+require "dtracer/probe_listener"
+require "dtracer/request_formatters"
+require "dtracer/response_formatters"

data/lib/dtracer/builder.rb

@@ -0,0 +1,43 @@
+class DTracer::Builder
+
+  def initialize
+    @content = []
+  end
+
+  def add_options(is_quite, string_size = 102400)
+    @content << "#pragma D option quiet" if is_quite
+    @content << "#pragma D option strsize=#{string_size}"
+    @content << ''
+  end
+
+  def add_begin_probe
+    @content << 'BEGIN {'
+    @content << '  printf("Tracing started\n");'
+    @content << '}'
+    @content << ''
+  end
+
+  def add_request_probe
+    add_probe("request")
+  end
+
+  def add_response_probe
+    add_probe("response")
+  end
+
+  def add_custom_probe
+    add_probe("custom")
+  end
+
+  def build
+    @content.join("\n")
+  end
+
+  def add_probe(probe_type)
+    @content << "oadprobe*:::#{probe_type} {"
+    @content << '  printf("%s\n\n", copyinstr(arg0));'
+    @content << '}'
+    @content << ''
+  end
+
+end

data/lib/dtracer/cli.rb

@@ -0,0 +1,105 @@
+require 'thor'
+require 'dtracer'
+require 'tempfile'
+require 'json'
+
+class DTracer::CLI < Thor
+  package_name :dtracer
+
+  option :r, :aliases => ["--response"], :type => :boolean, desc: "include the request response"
+  desc "curl", "register a curl probe"
+
+  def curl
+    say "Starting dtrace", :green
+
+    t1 = Thread.new do
+      ProbeListener.new("request", true).listen do |hash|
+        puts RequestCurlFormatter.new(hash).to_s
+      end
+    end
+
+    t2 = Thread.new do
+      sleep(0.3)
+      add_response_probe if options[:r]
+    end
+
+    t1.join
+    t2.join
+
+  rescue Exception => ex
+    say ex.message, :red
+  end
+
+  option :b, :aliases => ["--body"], :type => :boolean, desc: "show the http body"
+  option :m, :aliases => ["--method"], :type => :boolean, desc: "show the http method"
+  option :u, :aliases => ["--url"], :type => :boolean, desc: "show the http url"
+  option :h, :aliases => ["--headers"], :type => :boolean, desc: "show the http url"
+  option :c, :aliases => ["--cookies"], :type => :boolean, desc: "show the http url"
+  option :q, :aliases => ["--quiet"], :type => :boolean, desc: "show the http url"
+  option :r, :aliases => ["--response"], :type => :boolean, desc: "include the request response"
+  desc "details", "register a curl probe"
+
+  def details
+    options_without_response = options.dup
+    options_without_response.delete(:r)
+
+    raise "Select any option from -b, -c, -h, -u (you can combine them for more info)" if options_without_response.empty?
+
+    say "Starting dtrace", :green
+
+    t1 = Thread.new do
+      ProbeListener.new("request", true).listen do |hash|
+        puts RequestDetailsFormatter.new(hash, options || {}).to_s
+      end
+    end
+
+    t2 = Thread.new do
+      sleep(0.3)
+      add_response_probe if options[:r]
+    end
+
+    t1.join
+    t2.join
+
+  rescue Exception => ex
+    say ex.message, :red
+  end
+
+  desc "response", "register a custom probe"
+
+  def response
+    say "Starting dtrace", :green
+
+    add_response_probe
+
+  rescue Exception => ex
+    say ex.message, :red
+  end
+
+  desc "custom", "register a custom probe"
+
+  def custom
+    say "Starting dtrace", :green
+
+    probe = ProbeListener.new("custom", false)
+
+    probe.listen do |string|
+      puts string
+    end
+
+  rescue Exception => ex
+    say ex.message, :red
+  end
+
+
+  private
+
+  def add_response_probe
+    probe = ProbeListener.new("response", true)
+    probe.listen do |hash|
+      formatter = ResponseFormatter.new(hash)
+      puts formatter.to_s
+    end
+  end
+
+end

data/lib/dtracer/probe_listener.rb

@@ -0,0 +1,66 @@
+require "open3"
+
+class ProbeListener
+
+  def initialize(name, is_hash)
+    @name = name
+    @probe_string = probe_string(name)
+    @is_hash = is_hash
+  end
+
+  def listen
+    write_probe
+    cmd = "sudo dtrace -s #{trace_file_path}"
+
+    IO.popen(cmd) do |stdout|
+      stdout.each do |line|
+
+        if @is_hash
+          value = try_parse(line)
+          next unless value
+        else
+          value = line.strip
+          next if value.empty?
+        end
+
+        puts "\n#{@name.capitalize}----------------------------------------------"
+        yield(value)
+      end
+    end
+
+    clean_up
+  end
+
+  private
+
+  def try_parse(string)
+    JSON.parse(string)
+  rescue
+    nil
+  end
+
+  def probe_string(name)
+    builder = DTracer::Builder.new
+    builder.add_options(true)
+
+    builder.add_begin_probe
+    builder.add_probe(name)
+    builder.build
+  end
+
+  def write_probe
+    @file = Tempfile.new('temp.d')
+    @file.write(@probe_string)
+    @file.flush
+  end
+
+  def clean_up
+    @file.unlink
+    @file.close
+  end
+
+  def trace_file_path
+    @file.path
+  end
+
+end

data/lib/dtracer/request_formatters.rb

@@ -0,0 +1,115 @@
+module RequestFormattable
+
+  def initialize(hash)
+    @hash = hash
+    generate
+  end
+
+  def to_s
+    @content
+  end
+
+  def generate
+    arr = []
+
+    methods = [:begin_section, :method_section, :body_section,
+               :cookie_section, :header_section, :url_section]
+
+    methods.each do |method_name|
+      # get content array for a request section
+      content_array = self.send(method_name, @hash)
+      arr.concat(content_array) if content_array
+
+    end
+
+    @content = arr.join(joining_string)
+  end
+
+end
+
+class RequestCurlFormatter
+
+  include RequestFormattable
+
+  def joining_string
+    " \\ \n"
+  end
+
+  def begin_section(_)
+    ["curl"]
+  end
+
+  def method_section(hash)
+    ["-X #{hash["method"]}"]
+  end
+
+  def url_section(hash)
+    ["\"#{hash["url"]}\""]
+  end
+
+  def header_section(hash)
+    return nil unless hash["headers"]
+
+    hash["headers"].map { |key, value| "-H '#{key}: #{value}'" }
+  end
+
+  def cookie_section(hash)
+    return nil unless hash["cookies"]
+
+    hash["cookies"].map { |name, value| "--cookie \"#{name}=#{value}\"" }
+  end
+
+  def body_section(hash)
+    return nil unless hash["body"]
+
+    ["-d #{hash["body"]}"]
+  end
+
+end
+
+class RequestDetailsFormatter
+
+  include RequestFormattable
+
+  def initialize(hash, options)
+    @options = options
+    super(hash)
+  end
+
+  def joining_string
+    "\n"
+  end
+
+  def begin_section(_)
+    []
+  end
+
+  def method_section(hash)
+    return nil unless @options[:m] && hash["method"]
+
+    ["Method:\n  #{hash["method"]}"]
+  end
+
+  def url_section(hash)
+    return nil unless @options[:u] && hash["url"]
+    ["URL:\n  #{hash["url"]}"]
+  end
+
+  def header_section(hash)
+    return nil unless @options[:h] && hash["headers"]
+
+    hash["headers"].map { |key, value| "  #{key}: #{value}" }.insert(0, "Headers:")
+  end
+
+  def cookie_section(hash)
+    return nil unless @options[:c] && hash["cookies"]
+
+    hash["cookies"].map { |name, value| "  #{name}: #{value}" }.insert(0, "Cookies:")
+  end
+
+  def body_section(hash)
+    return nil unless @options[:b] && hash["body"]
+    ["Body:\n  #{hash["body"]}"]
+  end
+
+end

data/lib/dtracer/response_formatters.rb

@@ -0,0 +1,70 @@
+class ResponseFormatter
+
+  def initialize(hash)
+    @hash = hash
+    generate
+  end
+
+  def generate
+    arr = []
+
+    methods = [:response_section, :header_section, :cookie_section, :body_section, :error_section]
+
+    methods.each do |method_name|
+      # get content array for a request section
+      content_array = self.send(method_name, @hash)
+      arr.concat(content_array) if content_array
+
+    end
+
+    @content = arr.join("\n")
+  end
+
+  def response_section(hash)
+    arr = []
+
+    if hash["statusCode"]
+      arr << "Status Code:"
+      arr << "  #{hash["statusCode"]}"
+    end
+
+    if hash["url"]
+      arr << "URL:"
+      arr << "  #{hash["url"]}"
+    end
+
+    arr
+  end
+
+  def header_section(hash)
+    return nil unless hash["headers"]
+
+    hash["headers"].map { |key, value| "  #{key}: #{value}" }.insert(0, "Headers:")
+  end
+
+  def cookie_section(hash)
+    return nil unless hash["cookies"]
+
+    hash["cookies"].map { |name, value| "  #{name}: #{value}" }.insert(0, "Cookies:")
+  end
+
+  def body_section(hash)
+    return nil unless hash["body"]
+
+    ["Body:\n  #{hash["body"]}"]
+  end
+
+  def error_section(hash)
+    return nil unless hash["error"]
+    arr = []
+    arr << "Error:"
+    arr << "  Error Code: #{hash["error"]["errorCode"]}"
+    arr << "  Description: #{hash["error"]["localizedDescription"]}"
+    arr
+  end
+
+  def to_s
+    @content
+  end
+
+end

data/lib/dtracer/version.rb

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

data/spec/builder_spec.rb

@@ -0,0 +1,45 @@
+require 'rspec'
+require 'dtracer/builder'
+
+
+describe DTracer::Builder do
+  before(:each) do
+
+  end
+
+  it "should add options" do
+    b = DTracer::Builder.new
+    b.add_options(true)
+
+    expect(b.build).to eq "#pragma D option quiet\n#pragma D option strsize=102400\n"
+  end
+
+  it "should add begin probe" do
+    b = DTracer::Builder.new
+    b.add_begin_probe
+
+    expect(b.build).to eq "BEGIN {\n  printf(\"Tracing started\\n\");\n}\n"
+  end
+
+  it "should add request probe" do
+    b = DTracer::Builder.new
+    b.add_request_probe
+
+    expect(b.build).to eq "oadprobe*:::request {\n  printf(\"%s\\n\\n\", copyinstr(arg0));\n}\n"
+  end
+
+  it "should add response probe" do
+    b = DTracer::Builder.new
+    b.add_response_probe
+
+    expect(b.build).to eq "oadprobe*:::response {\n  printf(\"%s\\n\\n\", copyinstr(arg0));\n}\n"
+  end
+
+  it "should add custom probe" do
+    b = DTracer::Builder.new
+    b.add_custom_probe
+
+    expect(b.build).to eq "oadprobe*:::custom {\n  printf(\"%s\\n\\n\", copyinstr(arg0));\n}\n"
+  end
+
+end

data/spec/request_formatter_spec.rb

@@ -0,0 +1,117 @@
+require 'rspec'
+require 'dtracer/request_formatters'
+
+describe 'RequestCurlFormatter' do
+
+  it 'should correctly convert method and url' do
+    f = RequestCurlFormatter.new(HASH_WITHOUT_BODY)
+    expect(f.to_s).to eq(CURL_WITHOUT_BODY)
+  end
+
+  it 'should correctly convert the http body' do
+    f = RequestCurlFormatter.new(HASH_WITH_BODY)
+    expect(f.to_s).to eq(CURL_WITH_BODY)
+  end
+
+  it 'should correctly convert the headers' do
+    f = RequestCurlFormatter.new(HASH_WITH_HEADERS)
+    expect(f.to_s).to eq(CURL_WITH_HEADER)
+  end
+
+  it 'should correctly convert http with body and cookies' do
+    f = RequestCurlFormatter.new(HASH_WITH_BODY_AND_COOKIES)
+    expect(f.to_s).to eq(CURL_WITH_BODY_AND_COOKIES)
+  end
+
+  it 'should correctly convert http with body header and cookies' do
+    f = RequestCurlFormatter.new(HASH_WITH_BODY_HEADER_AND_COOKIES)
+    expect(f.to_s).to eq(CURL_WITH_BODY_HEADER_AND_COOKIES)
+  end
+
+end
+
+ALL_OPTIONS = {:m => true, :b => true, :c => true, :h => true, :u => true}
+describe 'RequestDetailsFormatter' do
+
+  it 'should correctly convert method and url' do
+    f = RequestDetailsFormatter.new(HASH_WITHOUT_BODY, ALL_OPTIONS)
+    expect(f.to_s).to eq(DETAIL_WITHOUT_BODY)
+  end
+
+  it 'should correctly convert the http body' do
+    f = RequestDetailsFormatter.new(HASH_WITH_BODY, ALL_OPTIONS)
+    expect(f.to_s).to eq(DETAIL_WITH_BODY)
+  end
+
+  it 'should correctly convert the headers' do
+    f = RequestDetailsFormatter.new(HASH_WITH_HEADERS, ALL_OPTIONS)
+    expect(f.to_s).to eq(DETAIL_WITH_HEADER)
+  end
+
+  it 'should correctly convert http with body and cookies' do
+    f = RequestDetailsFormatter.new(HASH_WITH_BODY_AND_COOKIES, ALL_OPTIONS)
+    expect(f.to_s).to eq(DETAIL_WITH_BODY_AND_COOKIES)
+  end
+
+  it 'should correctly convert http with body header and cookies' do
+    f = RequestDetailsFormatter.new(HASH_WITH_BODY_HEADER_AND_COOKIES, ALL_OPTIONS)
+    expect(f.to_s).to eq(DETAIL_WITH_BODY_HEADER_AND_COOKIES)
+  end
+
+  context 'Parsing options' do
+
+    it 'should display only method when m is passed' do
+      options = {:m => true}
+      f = RequestDetailsFormatter.new(HASH_WITH_BODY_HEADER_AND_COOKIES, options)
+      expect(f.to_s).to eq("Method:\n  POST")
+    end
+
+    it 'should display only body when b is passed' do
+      options = {:b => true}
+      f = RequestDetailsFormatter.new(HASH_WITH_BODY_HEADER_AND_COOKIES, options)
+      expect(f.to_s).to eq("Body:\n  Body is test test")
+    end
+
+    it 'should display header and cookies when h and c are passed' do
+      options = {:c => true, :h => true}
+      f = RequestDetailsFormatter.new(HASH_WITH_BODY_HEADER_AND_COOKIES, options)
+      expect(f.to_s).to eq("Cookies:\n  cookie1: v1\n  cookie2: v2\nHeaders:\n  k1: v1\n  k2: v2")
+    end
+
+  end
+
+end
+
+# Mock data
+
+HASH_WITHOUT_BODY =
+    {"url" => "https:\/\/www.google.com", "method" => "GET"}
+HASH_WITH_BODY =
+    {"url" => "https:\/\/www.google.com", "method" => "POST",
+     "body" => "Body is test test"}
+HASH_WITH_HEADERS =
+    {"url" => "https:\/\/www.google.com", "method" => "POST",
+     "headers" => {"k1" => "v1", "k2" => "v2"}}
+HASH_WITH_BODY_AND_COOKIES =
+    {"url" => "https:\/\/www.google.com", "method" => "POST",
+     "body" => "Body is test test",
+     "cookies" => {"cookie1" => "v1", "cookie2" => "v2"}}
+HASH_WITH_BODY_HEADER_AND_COOKIES =
+    {"url" => "https:\/\/www.google.com", "method" => "POST",
+     "body" => "Body is test test",
+     "cookies" => {"cookie1" => "v1", "cookie2" => "v2"},
+     "headers" => {"k1" => "v1", "k2" => "v2"}}
+
+
+CURL_WITHOUT_BODY = "curl \\ \n-X GET \\ \n\"https://www.google.com\""
+CURL_WITH_BODY = "curl \\ \n-X POST \\ \n-d Body is test test \\ \n\"https://www.google.com\""
+CURL_WITH_HEADER = "curl \\ \n-X POST \\ \n-H 'k1: v1' \\ \n-H 'k2: v2' \\ \n\"https://www.google.com\""
+CURL_WITH_BODY_AND_COOKIES = "curl \\ \n-X POST \\ \n-d Body is test test \\ \n--cookie \"cookie1=v1\" \\ \n--cookie \"cookie2=v2\" \\ \n\"https://www.google.com\""
+CURL_WITH_BODY_HEADER_AND_COOKIES = "curl \\ \n-X POST \\ \n-d Body is test test \\ \n--cookie \"cookie1=v1\" \\ \n--cookie \"cookie2=v2\" \\ \n-H 'k1: v1' \\ \n-H 'k2: v2' \\ \n\"https://www.google.com\""
+
+
+DETAIL_WITHOUT_BODY = "Method:\n  GET\nURL:\n  https://www.google.com"
+DETAIL_WITH_BODY = "Method:\n  POST\nBody:\n  Body is test test\nURL:\n  https://www.google.com"
+DETAIL_WITH_HEADER = "Method:\n  POST\nHeaders:\n  k1: v1\n  k2: v2\nURL:\n  https://www.google.com"
+DETAIL_WITH_BODY_AND_COOKIES = "Method:\n  POST\nBody:\n  Body is test test\nCookies:\n  cookie1: v1\n  cookie2: v2\nURL:\n  https://www.google.com"
+DETAIL_WITH_BODY_HEADER_AND_COOKIES = "Method:\n  POST\nBody:\n  Body is test test\nCookies:\n  cookie1: v1\n  cookie2: v2\nHeaders:\n  k1: v1\n  k2: v2\nURL:\n  https://www.google.com"

data/spec/response_formatters_spec.rb

@@ -0,0 +1,68 @@
+require 'rspec'
+require 'dtracer/response_formatters'
+
+describe 'ResponseFormatter' do
+
+  it 'should correctly convert the http response with status' do
+    f = ResponseFormatter.new(HASH_WITH_STATUS)
+    expect(f.to_s).to eq(RESPONSE_WITH_STATUS)
+  end
+
+  it 'should correctly convert the http response with status and headers' do
+    f = ResponseFormatter.new(HASH_WITH_STATUS_HEADERS)
+    expect(f.to_s).to eq(RESPONSE_WITH_STATUS_HEADERS)
+  end
+
+  it 'should correctly convert the http response with status headers and body' do
+    f = ResponseFormatter.new(HASH_WITH_STATUS_HEADERS_BODY)
+    expect(f.to_s).to eq(RESPONSE_WITH_STATUS_HEADERS_BODY)
+  end
+
+  it 'should correctly convert the http response with errors' do
+    f = ResponseFormatter.new(HASH_WITH_ERROR)
+    expect(f.to_s).to eq(RESPONSE_WITH_ERROR)
+  end
+
+  it 'should correctly convert the http response with errors and body' do
+    f = ResponseFormatter.new(HASH_WITH_ERROR_BODY)
+    expect(f.to_s).to eq(RESPONSE_WITH_ERROR_BODY)
+  end
+
+  it 'should correctly convert the http response with errors body and headers' do
+    f = ResponseFormatter.new(HASH_WITH_ERROR_BODY_HEADER)
+    expect(f.to_s).to eq(RESPONSE_WITH_ERROR_BODY_HEADER)
+  end
+
+end
+
+HASH_WITH_STATUS =
+    {"statusCode" => "2", "url" => "http://google.com"}
+HASH_WITH_STATUS_HEADERS =
+    {"statusCode" => "2", "url" => "http://google.com",
+     "cookies" => {"cookie1" => "v1", "cookie2" => "v2"},
+     "headers" => {"k1" => "v1", "k2" => "v2"}}
+HASH_WITH_STATUS_HEADERS_BODY =
+    {"statusCode" => "2", "url" => "http://google.com",
+     "cookies" => {"cookie1" => "v1", "cookie2" => "v2"},
+     "headers" => {"k1" => "v1", "k2" => "v2"},
+     "body" => "Some body"}
+HASH_WITH_ERROR =
+    {"statusCode" => "500", "url" => "http://google.com",
+     "error" => {"errorCode" => "123", "localizedDescription" => "bad thing"}}
+HASH_WITH_ERROR_BODY =
+    {"statusCode" => "500", "url" => "http://google.com",
+     "error" => {"errorCode" => "123", "localizedDescription" => "bad thing"},
+     "body" => "Some body"}
+HASH_WITH_ERROR_BODY_HEADER =
+    {"statusCode" => "500", "url" => "http://google.com",
+     "error" => {"errorCode" => "123", "localizedDescription" => "bad thing"},
+     "headers" => {"k1" => "v1", "k2" => "v2"},
+     "body" => "Some body"}
+
+
+RESPONSE_WITH_STATUS = "Status Code:\n  2\nURL:\n  http://google.com"
+RESPONSE_WITH_STATUS_HEADERS = "Status Code:\n  2\nURL:\n  http://google.com\nHeaders:\n  k1: v1\n  k2: v2\nCookies:\n  cookie1: v1\n  cookie2: v2"
+RESPONSE_WITH_STATUS_HEADERS_BODY = "Status Code:\n  2\nURL:\n  http://google.com\nHeaders:\n  k1: v1\n  k2: v2\nCookies:\n  cookie1: v1\n  cookie2: v2\nBody:\n  Some body"
+RESPONSE_WITH_ERROR = "Status Code:\n  500\nURL:\n  http://google.com\nError:\n  Error Code: 123\n  Description: bad thing"
+RESPONSE_WITH_ERROR_BODY = "Status Code:\n  500\nURL:\n  http://google.com\nBody:\n  Some body\nError:\n  Error Code: 123\n  Description: bad thing"
+RESPONSE_WITH_ERROR_BODY_HEADER = "Status Code:\n  500\nURL:\n  http://google.com\nHeaders:\n  k1: v1\n  k2: v2\nBody:\n  Some body\nError:\n  Error Code: 123\n  Description: bad thing"

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: dtracer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Omar Abdelhafith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: thor
+  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: |-
+  DTracer is part ruby gem, part iOS pod, that helps the sending and receiving of DTrace commands.
+  The `dtracer` gem will listen to the DTrace commands that are sent from the [OADTraceSender]() pod.
+email:
+- o.arrabi@me.com
+executables:
+- dtracer
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/dtracer
+- dtracer.gemspec
+- lib/dtracer.rb
+- lib/dtracer/builder.rb
+- lib/dtracer/cli.rb
+- lib/dtracer/probe_listener.rb
+- lib/dtracer/request_formatters.rb
+- lib/dtracer/response_formatters.rb
+- lib/dtracer/version.rb
+- spec/builder_spec.rb
+- spec/request_formatter_spec.rb
+- spec/response_formatters_spec.rb
+homepage: http://nsomar.com/dtracer
+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.14
+signing_key: 
+specification_version: 4
+summary: DTracer is part ruby gem, part iOS pod, that helps the sending and receiving
+  of DTrace commands..
+test_files:
+- spec/builder_spec.rb
+- spec/request_formatter_spec.rb
+- spec/response_formatters_spec.rb