firecracker 1.0.0

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/.rspec

@@ -0,0 +1,5 @@
+--color
+-fs
+-Ilib
+-Ispec
+--require spec_helper

data/Gemfile

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

data/README.md

@@ -0,0 +1,123 @@
+# Firecracker
+
+An implementation of the [UDP](http://bittorrent.org/beps/bep_0015.html)/[TCP](http://wiki.theory.org/BitTorrentSpecification#Tracker_.27scrape.27_Convention) torrent scrape protocol.
+
+## Get started
+
+All methods below returns a hash similar to this one.
+
+``` ruby
+{
+  seeders: 123,
+  leechers: 456,
+  downloads: 789
+}
+```
+
+### Specify a protocol
+
+A second argument may be passed to `load`, `raw` and `calculate` to specify which protocol to use.
+An example argument would look like this: `[:tcp, :udp]`, both tcp and udp are defaults.
+
+### A local torrent file
+
+``` ruby
+Firecracker.load("path/to/file.torrent")
+```
+
+### A raw torrent string
+
+``` ruby
+torrent = RestClient.get("http://mysite.com/file.torrent")
+Firecracker.raw(torrent)
+```
+
+### A String#bdecode hash
+
+``` ruby
+torrent = RestClient.get("http://mysite.com/file.torrent")
+Firecracker.calculate(torrent.bdecode)
+```
+
+## Helper methods
+
+Ingoing argument (`torrent`) is from now on a [String#bdecode](https://github.com/naquad/bencode_ext) hash.
+
+``` ruby
+require "bencode_ext"
+torrent = File.read("path/to/file.torrent").bdecode
+```
+
+### Generate a info_hash string
+
+``` ruby
+Firecracker.hash(torrent)
+# => "03db8637a8e16f7d5e3e4f7557d5d87b1905dc16"
+```
+
+### A list of TCP/UDP trackers
+
+``` ruby
+Firecracker.udp_trackers(torrent)
+# => ["udp://tracker.openbittorrent.com:80", "..."]
+
+Firecracker.tcp_trackers(torrent)
+# => ["http://torrent.ubuntu.com:6969/scrape", "..."]
+```
+
+## UDP/TCP requests
+
+If you want to define your own server or/and protocol you can do this using the [TCPScraper](https://github.com/oleander/firecracker/blob/master/lib/firecracker/tcp_scraper.rb) and [UDPScraper](https://github.com/oleander/firecracker/blob/master/lib/firecracker/udp_scraper.rb) classes.
+
+The hash being passed is a [info_hash](http://wiki.theory.org/BitTorrent_Tracker_Protocol) string.
+
+You can in theory pass up to 72 hashes in one request.
+
+Keep in mind that if one of the passed hashes is invalid or doesn't exist, the requested server might return 404 or 400.  
+It's therefore recommended to make one request for each hash. 
+
+### TCP
+
+``` ruby
+Firecracker::TCPScraper.new({
+  tracker: "exodus.desync.com:6969/announce",
+  hashes: ["c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0"]
+}).process!
+
+# {
+#   c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0: {
+#     seeders: 123,
+#     leechers, 456
+#     downloads: 789
+#   }
+# }
+```
+
+### UDP
+
+``` ruby
+Firecracker::UDPScraper.new({
+  tracker: "tracker.openbittorrent.com",
+  hashes: ["523d83e8aee1a979e66584b5304d2e8fdc9a1675"]
+}).process!
+
+# {
+#   523d83e8aee1a979e66584b5304d2e8fdc9a1675: {
+#     seeders: 123,
+#     leechers, 456
+#     downloads: 789
+#   }
+# }
+```
+
+## How to install
+
+    [sudo] gem install firecracker
+
+## Requirements
+
+Ruby *1.9.2*.
+
+## License
+
+*Firecracker* is released under the *MIT license*.

data/Rakefile

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

data/firecracker.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/firecracker/version", __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Linus Oleander"]
+  gem.email         = ["linus@oleander.nu"]
+  gem.description   = %q{An implementation of the UDP/TCP torrent scrape protocol}
+  gem.summary       = %q{An implementation of the UDP/TCP torrent scrape protocol}
+  gem.homepage      = "https://github.com/oleander.nu/firecracker-rb"
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "firecracker"
+  gem.require_paths = ["lib"]
+  gem.version       = Firecracker::VERSION
+  
+  gem.add_dependency("rest-client")
+  gem.add_dependency("bencode_ext")
+  
+  gem.add_development_dependency("vcr")
+  gem.add_development_dependency("rspec")  
+  gem.add_development_dependency("webmock")
+  
+  gem.required_ruby_version = "~> 1.9.0"
+end

data/lib/firecracker.rb

@@ -0,0 +1,108 @@
+require "firecracker/udp_scraper"
+require "firecracker/tcp_scraper"
+require "digest/sha1"
+require "bencode_ext"
+require "uri"
+
+module Firecracker
+  #
+  # @torrent String Path to a torrent file
+  # @protocols Array<Symbol> Protocols that should be used. UDP is the fastest.
+  # @return Hash Seeders, leechers and the amounts of downloads
+  #
+  def self.load(torrent, protocols = [:udp, :tcp])
+    Firecracker.raw(File.read(torrent))
+  end
+  
+  #
+  # @torrent String A raw torrent file.
+  # @protocols Array<Symbol> Protocols that should be used. UDP is the fastest.
+  # @return Hash Seeders, leechers and the amounts of downloads
+  #
+  def self.raw(raw, protocols = [:udp, :tcp])
+    Firecracker.calculate(raw.bdecode)
+  end
+  
+  #
+  # @torrent Hash A Torrent hash generated using String#bdecode
+  # @protocols Array<Symbol> Protocols that should be used. UDP is the fastest.
+  # @return Hash Seeders, leechers and the amounts of downloads
+  #
+  def self.calculate(torrent, protocols = [:udp, :tcp])    
+    raise "At least one protocol needs to be passed" if protocols.empty?
+    
+    # UDP related trackers
+    if protocols.include?(:udp)
+      trackers = udp_trackers(torrent)      
+      udp_results = trackers.map do |tracker|
+        begin
+          Firecracker::UDPScraper.new({
+            tracker: tracker,
+            hashes: [hash(torrent)]
+          }).process!
+        rescue
+          # raise $! unless silent
+        end
+      end.reject(&:nil?).map(&:values).flatten
+    end
+    
+    # TCP related trackers
+    if protocols.include?(:tcp)
+      trackers = tcp_trackers(torrent)
+      tcp_results = trackers.map do |tracker|
+        begin
+          Firecracker::TCPScraper.new({
+            tracker: tracker,
+            hashes: [hash(torrent)]
+          }).process!
+        rescue
+          # raise $! unless silent
+        end
+      end.reject(&:nil?).map(&:values).flatten
+    end
+
+    (tcp_results + udp_results).inject{ |memo, el| memo.merge(el){ |k, old_v, new_v| old_v + new_v } }
+  end
+  
+  #
+  # @torrent Hash A Torrent hash generated using String#bdecode
+  # @return Array<String> A list of UDP trackers for the given torrent
+  #
+  def self.udp_trackers(torrent)
+    announce      = torrent["announce"]
+    announce_list = torrent["announce-list"]
+        
+    trackers = announce_list.flatten.select{|tracker| tracker.match(/^udp:\/\//)}
+    if announce.match(/^udp:\/\//)
+      trackers << announce
+    end
+    
+    return trackers
+  end
+  
+  #
+  # @torrent Hash A Torrent hash generated using String#bdecode
+  # @return Array<String> A list of TCP trackers for the given torrent
+  #
+  def self.tcp_trackers(torrent)
+    announce      = torrent["announce"]
+    announce_list = torrent["announce-list"]
+        
+    trackers = announce_list.flatten.select{|tracker| tracker.match(/^http:\/\//)}
+    if announce.match(/^http:\/\//)
+      trackers << announce
+    end
+    
+    # TPBs tracker is no longer active
+    return trackers.map{|t| t.gsub(/announce/, "scrape")}.reject{|t| t.match(%r{thepiratebay})}
+  end
+  
+  #
+  # @torrent Hash A Torrent hash generated using String#bdecode
+  # @return String An info_hash. Read more about it here:
+  # http://wiki.theory.org/BitTorrent_Tracker_Protocol
+  #
+  def self.hash(torrent)
+    Digest::SHA1.hexdigest(torrent["info"].bencode)
+  end
+end

data/lib/firecracker/base.rb

@@ -0,0 +1,56 @@
+require "bencode_ext"
+require "timeout"
+
+module Firecracker
+  class Base
+    #
+    # @args Hash A bunch of options
+    # Example:
+    #  {
+    #    tracker: "tracker.ccc.de",
+    #    hashes: ["2bbf3d63e6b313ecf2655067b51e93f17eeeb135"],
+    #    debug: false
+    #  }
+    #
+    def initialize(args = {})
+      @options = {
+        debug: false,
+        timeout: 2,
+        tracker: nil,
+        hashes: []
+      }.merge(args)
+    end
+    
+    #
+    # @return Do we have everyting that's needed
+    #  to do the request.
+    #
+    def valid?
+      [
+        @options[:tracker],
+        @options[:hashes].count.between?(1, 72)
+      ].all?
+    end
+    
+    #
+    # @return Should we print debug ouput?
+    #
+    def debug?
+      @options[:debug]
+    end
+    
+    #
+    # @return Array<String> A list of hashes
+    #
+    def hashes
+      @options[:hashes]
+    end
+    
+    #
+    # @return Integer Global timeout limit
+    #
+    def timeout
+      @options[:timeout]
+    end
+  end
+end

data/lib/firecracker/tcp_scraper.rb

@@ -0,0 +1,95 @@
+require "rest-client"
+require "uri"
+require_relative "base"
+
+module Firecracker
+  class TCPScraper < Firecracker::Base
+    #
+    # @return Hash
+    #   Example: {
+    #     c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0: {
+    #       downloads: 123,
+    #       complete: 456,
+    #       incomplete: 789
+    #     }
+    #   }
+    #
+    def process!
+      raise "both #tracker and #hashes/#hash must be set" unless valid?
+      
+      keys    = ["downloaded", "complete", "incomplete"]
+      map     = {:complete => :seeders, :incomplete => :leechers, :downloaded => :downloads} 
+      results = Hash.new { |h,k| h[k] = 0 }
+      
+      raise %q{
+        Someting went wrong.
+        You've passed multiply hashes, but the 
+        tracker only responed with one result.
+      } if files.empty? and not @options[:hashes].one?
+      
+      if files.empty?
+        keys.each do |key|
+          replace = map[key.to_sym] ? map[key.to_sym] : key
+          results[replace.to_sym] += raw_hash[key].to_i
+        end
+        
+        return {
+          hashes.first => results
+        }
+      end
+      
+      files.keys.each do |key|
+        file = files[key]
+        results.merge!({
+          key => {
+            downloads: file["downloaded"],
+            seeders: file["complete"],
+            leechers: file["incomplete"]
+          }
+        })
+      end
+      
+      return results
+    end
+      
+    private
+      def files
+        @_files ||= raw_hash["files"] || {}
+      end
+      
+      def raw_hash
+        @_raw_hash ||= if data.nil? or data.empty?
+          {}
+        else
+          count = 0
+          data.gsub(/20:(.+?)d8/) do |m|
+            hash = hashes[count]
+            res = "#{hash.length}:#{hash}d8"
+            count += 1; res
+          end.bdecode || {}
+        end
+      end
+  
+      def random_value(max = 20)
+        (0...max).map{ ("a".."z").to_a[rand(26)] }.join
+      end
+
+      def hash_info
+        @_hash_info ||= @options[:hashes].map do |hash|
+          "info_hash=%s" % URI.encode([hash].pack("H*"))
+        end.join("&")
+      end
+  
+      #
+      # Sometime, I'm not sure when, the timeout value
+      # passed to RestClient is ignored. That is why
+      # the hole method is wrapped inside a Timeout block.
+      # Is there a better solution?
+      #
+      def data
+        Timeout::timeout(timeout) {
+          @_data ||= RestClient.get("#{@options[:tracker]}?%s" % hash_info, timeout: timeout)
+        }
+      end
+    end
+end

data/lib/firecracker/udp_scraper.rb

@@ -0,0 +1,90 @@
+require "socket"
+require_relative "base"
+
+module Firecracker
+  class UDPScraper < Firecracker::Base      
+    #
+    # @return Hash
+    #   Example: {
+    #     c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0: {
+    #       downloads: 123,
+    #       complete: 456,
+    #       incomplete: 789
+    #     }
+    #   }
+    #
+    def process!
+      raise "both #tracker and #hashes/#hash must be set" unless valid?
+      
+      # Handshake
+      data = send(to_hex(4497486125440, 8) + to_hex(0, 4) + transaction_id)
+      request_error! unless data
+      
+      # Main request
+      data = send(data[16..31] + to_hex(2, 4) + transaction_id + hashes.join)
+      request_error! unless data
+    
+      index = 16
+      results = {}
+      
+      loop do
+        break unless data[index + 23]
+
+        completed = data[(index + 8)..index + 15].to_i(16)
+        leechers  = data[(index + 16)..index + 23].to_i(16)
+        seeders   = data[index..index + 7].to_i(16)
+        hash      = hashes[(index - 16)/24]
+
+        results.merge!({
+          hash => {
+            downloads: completed,
+            seeders: seeders,
+            leechers: leechers
+          }
+        })
+
+        index += 24
+      end
+
+      return results
+    end
+    
+  private
+    def socket
+      @_socket ||= UDPSocket.open
+    end
+    
+    def request_error!
+      raise "Request error. UDP server did not respond"
+    end
+    
+    def to_hex(value, max)
+      value.to_s(16).rjust(max * 2, "0")
+    end
+  
+    def tracker
+      if @options[:tracker] =~ /^udp:\/\//
+        @options[:tracker]
+      else
+        "udp://#{@options[:tracker]}"
+      end
+    end
+
+    def send(data)
+      Timeout::timeout(timeout) {
+        uri = URI.parse(tracker)
+
+        socket.send([data].pack("H*"), 0, uri.host, uri.port || 80)
+        resp = if select([socket], nil, nil, 3)
+          socket.recvfrom_nonblock(65536)
+        end
+        
+        resp ? resp.first.unpack("H*").first : nil
+      }
+    end
+  
+    def transaction_id
+      @_transaction_id ||= to_hex(rand(65535), 4)
+    end
+  end
+end

data/lib/firecracker/version.rb

@@ -0,0 +1,3 @@
+module Firecracker
+  VERSION = "1.0.0"
+end

data/spec/firecracker_spec.rb

@@ -0,0 +1,18 @@
+describe Firecracker do
+  # use_vcr_cassette "example-total" Crashes Ruby for some reason
+  before(:all) { @result = Firecracker.load("spec/fixtures/example.torrent") }
+  
+  let(:keys){
+    [:seeders, :leechers, :downloads]
+  }
+    
+  it "should return seeders, leechers and the amount of downloads" do
+    (@result.keys & keys).count.should eq(3)
+  end
+  
+  it "should only contain values greater than zero" do
+    @result.keys.each do |key|
+      @result[key].should > 0
+    end
+  end
+end

data/spec/fixtures/vcr_cassettes/example2.yml

@@ -0,0 +1,339 @@
+---
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.blazing.de:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7193e10:downloadedi10e10:incompletei1130eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.irc.su:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 404
+      message: Not Found
+    headers:
+      content-type:
+      - text/html
+      server:
+      - Microsoft-IIS/7.5
+      x-powered-by:
+      - ASP.NET
+      date:
+      - Mon, 19 Dec 2011 23:04:33 GMT
+      content-length:
+      - '1245'
+    body: ! "<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">\n<html
+      xmlns=\"http://www.w3.org/1999/xhtml\">\n<head>\n<meta http-equiv=\"Content-Type\"
+      content=\"text/html; charset=iso-8859-1\"/>\n<title>404 - File or directory
+      not found.</title>\n<style type=\"text/css\">\n<!--\nbody{margin:0;font-size:.7em;font-family:Verdana,
+      Arial, Helvetica, sans-serif;background:#EEEEEE;}\nfieldset{padding:0 15px 10px
+      15px;} \nh1{font-size:2.4em;margin:0;color:#FFF;}\nh2{font-size:1.7em;margin:0;color:#CC0000;}
+      \nh3{font-size:1.2em;margin:10px 0 0 0;color:#000000;} \n#header{width:96%;margin:0
+      0 0 0;padding:6px 2% 6px 2%;font-family:\"trebuchet MS\", Verdana, sans-serif;color:#FFF;\nbackground-color:#555555;}\n#content{margin:0
+      0 0 2%;position:relative;}\n.content-container{background:#FFF;width:96%;margin-top:8px;padding:10px;position:relative;}\n-->\n</style>\n</head>\n<body>\n<div
+      id=\"header\"><h1>Server Error</h1></div>\n<div id=\"content\">\n <div class=\"content-container\"><fieldset>\n
+      \ <h2>404 - File or directory not found.</h2>\n  <h3>The resource you are looking
+      for might have been removed, had its name changed, or is temporarily unavailable.</h3>\n
+      </fieldset></div>\n</div>\n</body>\n</html>\n"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.ilibr.org:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7296e10:downloadedi10e10:incompletei1155eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.csze.com:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7087e10:downloadedi10e10:incompletei1129eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://10.rarbg.com:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7296e10:downloadedi10e10:incompletei1155eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://pow7.com:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7296e10:downloadedi10e10:incompletei1155eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.token.ro:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7297e10:downloadedi10e10:incompletei1156eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://fr33dom.h33t.com:3310/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers: !!null 
+    body: d5:filesde5:flagsd20:min_request_intervali1800eee
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://t2.pow7.com:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7297e10:downloadedi10e10:incompletei1156eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.ilibr.org:6969/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7297e10:downloadedi10e10:incompletei1156eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://t1.pow7.com:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7297e10:downloadedi10e10:incompletei1156eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://ipv4.tracker.harry.lu:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7298e10:downloadedi10e10:incompletei1156eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.pow7.com:80/scrape?info_hash=%03%DB%867%A8%E1o%7D%5E%3EOuW%D5%D8%7B%19%05%DC%16
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 200
+      message: OK
+    headers:
+      content-type:
+      - text/plain
+      content-length:
+      - '88'
+    body: ! "d5:filesd20:\x03Û\x867¨áo}^>OuWÕØ{\x19\x05Ü\x16d8:completei7298e10:downloadedi10e10:incompletei1156eeee"
+    http_version: '1.1'
+- !ruby/struct:VCR::HTTPInteraction
+  request: !ruby/struct:VCR::Request
+    method: :get
+    uri: http://tracker.pow7.com:80/scrape?info_hash=%02%95$%F34%A2%C0%9F3%05w%CA%9A5x%E1Z1%F0%8B
+    body: !!null 
+    headers:
+      accept:
+      - ! '*/*; q=0.5, application/xml'
+      accept-encoding:
+      - gzip, deflate
+      timeout:
+      - '2'
+  response: !ruby/struct:VCR::Response
+    status: !ruby/struct:VCR::ResponseStatus
+      code: 400
+      message: Invalid Request
+    headers:
+      content-type:
+      - text/html
+      content-length:
+      - '31'
+    body: ! '<title>Invalid Request</title>
+
+'
+    http_version: '1.1'

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require "rspec"
+require "webmock/rspec"
+require "vcr"
+require "yaml"
+require "firecracker"
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+  config.extend VCR::RSpec::Macros
+end
+
+VCR.config do |c|
+  c.cassette_library_dir = "spec/fixtures/vcr_cassettes"
+  c.stub_with :webmock
+  c.default_cassette_options = {
+    record: :new_episodes
+  }
+  c.allow_http_connections_when_no_cassette = true
+end

data/spec/tcp_spec.rb

@@ -0,0 +1,65 @@
+describe Firecracker::TCPScraper do
+  describe "single file" do
+    # use_vcr_cassette "example1" Doesn't work for some reason
+    
+    let(:hashes) { ["c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0"] }
+    let(:raw){
+      Firecracker::TCPScraper.new({
+        tracker: "exodus.desync.com:6969/announce",
+        hashes: hashes,
+        debug: true
+      }).process!
+    }
+    
+    let(:values) { raw[raw.keys.first] }
+    
+    it "should match the number of hashes" do
+      raw.should have(1).keys
+      raw.keys.first.should eq(hashes.first)
+    end
+    
+    it "should have 3 categories" do
+      values.keys.each do |key|
+        [:downloads, :seeders, :leechers].should include(key)
+      end
+    end
+    
+    it "should only contain values greater than zero" do
+      values.keys.each do |key|
+        values[key].should > 0
+      end
+    end
+  end
+  
+  describe "multi file" do
+    use_vcr_cassette "example2"
+    
+    let(:hashes) { ["03db8637a8e16f7d5e3e4f7557d5d87b1905dc16"] }
+    let(:raw){
+      Firecracker::TCPScraper.new({
+        tracker: "tracker.pow7.com:80/scrape",
+        hashes: hashes,
+        debug: true
+      }).process!
+    }
+    
+    let(:values) { raw[raw.keys.first] }
+    
+    it "should match the number of hashes" do
+      raw.should have(1).keys
+      raw.keys.first.should eq(hashes.first)
+    end
+    
+    it "should have 3 categories" do
+      values.keys.each do |key|
+        [:seeders, :leechers, :downloads].should include(key)
+      end
+    end
+    
+    it "should only contain values greater than zero" do
+      values.keys.each do |key|
+        values[key].should > 0
+      end
+    end
+  end
+end

data/spec/udp_spec.rb

@@ -0,0 +1,31 @@
+require "spec_helper"
+
+describe Firecracker::UDPScraper do
+  let(:hashes) { ["523d83e8aee1a979e66584b5304d2e8fdc9a1675"] }
+
+  let(:raw){
+    Firecracker::UDPScraper.new({
+      tracker: "tracker.openbittorrent.com",
+       hashes: hashes
+    }).process!
+  }
+  
+  let(:values) { raw[raw.keys.first] }
+  
+  it "should match the number of hashes" do
+    raw.should have(1).keys
+    raw.keys.first.should eq(hashes.first)
+  end
+  
+  it "should have 3 categories" do
+    values.keys.each do |key|
+      [:downloads, :seeders, :leechers].should include(key)
+    end
+  end
+  
+  it "should only contain values greater than zero" do
+    values.keys.each do |key|
+      values[key].should > 0
+    end
+  end
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: firecracker
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Linus Oleander
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-12 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: &70225212402380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70225212402380
+- !ruby/object:Gem::Dependency
+  name: bencode_ext
+  requirement: &70225212401960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70225212401960
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: &70225212401540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70225212401540
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70225212401120 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70225212401120
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &70225212400700 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70225212400700
+description: An implementation of the UDP/TCP torrent scrape protocol
+email:
+- linus@oleander.nu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- firecracker.gemspec
+- lib/firecracker.rb
+- lib/firecracker/base.rb
+- lib/firecracker/tcp_scraper.rb
+- lib/firecracker/udp_scraper.rb
+- lib/firecracker/version.rb
+- spec/firecracker_spec.rb
+- spec/fixtures/example.torrent
+- spec/fixtures/vcr_cassettes/example-total.yml
+- spec/fixtures/vcr_cassettes/example1.yml
+- spec/fixtures/vcr_cassettes/example2.yml
+- spec/spec_helper.rb
+- spec/tcp_spec.rb
+- spec/udp_spec.rb
+homepage: https://github.com/oleander.nu/firecracker-rb
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ~>
+    - !ruby/object:Gem::Version
+      version: 1.9.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: An implementation of the UDP/TCP torrent scrape protocol
+test_files:
+- spec/firecracker_spec.rb
+- spec/fixtures/example.torrent
+- spec/fixtures/vcr_cassettes/example-total.yml
+- spec/fixtures/vcr_cassettes/example1.yml
+- spec/fixtures/vcr_cassettes/example2.yml
+- spec/spec_helper.rb
+- spec/tcp_spec.rb
+- spec/udp_spec.rb