Tor.rb: Onion Routing for Ruby (tor2)

This is a Ruby library for interacting with the Tor anonymity network.

/ ! \ This repository were created to keep an updated version of this lib on the gem store. I am not the author or the maintainer even if PR are welcomed. The original project can be found at https://github.com/dryruby/tor.rb (previously http://github.com/bendiken/tor-ruby).

The name of this alternative gem is tor2 to avoid confusion with the original.

• Supports checking whether Tor is installed in the user's current PATH, and if it is, returning the version number.
• Supports parsing Tor configuration files and looking up the values of particular options.
• Supports querying and controlling a locally-running Tor process using the Tor Control Protocol (TC) over a socket connection.
• Supports querying the Tor DNS Exit List (DNSEL) to determine whether a particular host is a Tor exit node or not.
• Compatible with Ruby 1.8.7+, Ruby 1.9.x, and JRuby 1.4/1.5.

require 'rubygems'
require 'tor2'

Tor.available?                                     #=> true
Tor.version                                        #=> "0.2.1.25"

torrc = Tor::Config.load("/etc/tor/torrc")

Tor::Config.open("/etc/tor/torrc") do |torrc|
  puts "Tor SOCKS port: #{torrc['SocksPort']}"
  puts "Tor control port: #{torrc['ControlPort']}"
  puts "Tor exit policy:"
  torrc.each('ExitPolicy') do |key, value|
    puts "  #{value}"
  end
end

Tor::Controller.connect(:port => 9051) do |tor|
  puts "Tor version: #{tor.version}"
  puts "Tor config file: #{tor.config_file}"
end

Tor::DNSEL.include?("208.75.57.100")               #=> true
Tor::DNSEL.include?("1.2.3.4")                     #=> false

• http://cypherpunk.rubyforge.org/tor/

• Ruby (>= 1.8.7) or (>= 1.8.1 with Backports)
• Tor (>= 0.2.1)

The recommended installation method is via RubyGems. To install the latest official release of Tor.rb, do:

% [sudo] gem install tor2                 # Ruby 1.8.7+ or 1.9.x
% [sudo] gem install backports tor2       # Ruby 1.8.1+

To get a local working copy of the development repository, do:

% git clone git://github.com/alexmili/tor.rb.git

Alternatively, you can download the latest development version as a tarball as follows:

% wget http://github.com/alexmili/tor.rb/tarball/master

• Arto Bendiken - http://ar.to/

Tor.rb is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.