tor 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7be2c2b80fea90e1b3e9567624a442d4b3d1a92946f72d6b465280ad4b5d0ec8
-  data.tar.gz: 96358536b8479ea4fba83fb236dabb6b743074c058a48a6fbfe435bf00ab5bbc
+  metadata.gz: a9f4d7cdee4cdba315a7851d2cad22501ee89d35fc9e16a8fbc8e817948a13e9
+  data.tar.gz: 1e45634091d9c257e26cf5e60eeb71f1c38fadb4da9ebfbf1879427d2d4e7622
 SHA512:
-  metadata.gz: b961dc19ac6f692cbade5226a895782c311cf6463fd228595ee4044085de9340f6948e852c981649c63abfd0abd01665d3fd7cabf2970815be6f87541b8158ee
-  data.tar.gz: cbecd4beddfd8d543d79233ea2f116609204550f0366a091aacac9573eae593e08c2d5c663020b56713ea6fc46b6dbb2ca39aa6b4e0e1686bb30d6ae7c7b2a7c
+  metadata.gz: 402c526509d4e023171f22ad0b5078d834d06f45eb2e4ad500b5693d9af41300ddba663418e41f30db7bcc8ca2632800d1f4b11e78608358c1e96635b50d8ef4
+  data.tar.gz: d9c06427dd10c3e50c4c30486e2a0814bd0732e7be9b3e94d07d27dc4d467be5aff96652766e03270d5535103e6557b98318de0497fa612a10c4ee917668cf2b

data/AUTHORS

@@ -1,2 +1 @@
 * Arto Bendiken <arto.bendiken@gmail.com>
-* Łukasz Wieczorek <wieczorek1990@gmail.com>

data/CREDITS

@@ -0,0 +1 @@
+* Łukasz Wieczorek <wieczorek1990@gmail.com>

data/README.md

@@ -0,0 +1,101 @@
+Tor.rb: Onion Routing for Ruby
+==============================
+
+This is a Ruby library for interacting with the [Tor][] anonymity network.
+
+* <http://github.com/bendiken/tor-ruby>
+
+Features
+--------
+
+* 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)][TC] over a socket connection.
+* Supports querying the [Tor DNS Exit List (DNSEL)][TorDNSEL] 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.
+
+Examples
+--------
+
+    require 'rubygems'
+    require 'tor'
+
+### Checking whether Tor is installed and which version it is
+
+    Tor.available?                                     #=> true
+    Tor.version                                        #=> "0.2.1.25"
+
+### Parsing the Tor configuration file (1)
+
+    torrc = Tor::Config.load("/etc/tor/torrc")
+
+### Parsing the Tor configuration file (2)
+
+    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
+
+### Communicating with a running Tor process
+
+    Tor::Controller.connect(:port => 9051) do |tor|
+      puts "Tor version: #{tor.version}"
+      puts "Tor config file: #{tor.config_file}"
+    end
+
+### Checking whether a particular host is a Tor exit node
+
+    Tor::DNSEL.include?("185.220.101.21")               #=> true
+    Tor::DNSEL.include?("1.2.3.4")                     #=> false
+
+Dependencies
+------------
+
+* [Ruby](http://ruby-lang.org/) (>= 1.8.7) or (>= 1.8.1 with [Backports][])
+* [Tor](https://www.torproject.org/download.html.en) (>= 0.2.1)
+
+Installation
+------------
+
+The recommended installation method is via [RubyGems](http://rubygems.org/).
+To install the latest official release of Tor.rb, do:
+
+    % [sudo] gem install tor                 # Ruby 1.8.7+ or 1.9.x
+    % [sudo] gem install backports tor       # Ruby 1.8.1+
+
+Download
+--------
+
+To get a local working copy of the development repository, do:
+
+    % git clone git://github.com/bendiken/tor-ruby.git
+
+Alternatively, you can download the latest development version as a tarball
+as follows:
+
+    % wget http://github.com/bendiken/tor-ruby/tarball/master
+
+Author
+------
+
+* [Arto Bendiken](mailto:arto.bendiken@gmail.com) - <http://ar.to/>
+
+License
+-------
+
+Tor.rb is free and unencumbered public domain software. For more
+information, see <http://unlicense.org/> or the accompanying UNLICENSE file.
+
+[Tor]:       https://www.torproject.org/
+[TorDNSEL]:  https://www.torproject.org/tordnsel/
+[TC]:        http://gitweb.torproject.org/tor.git?a=blob_plain;hb=HEAD;f=doc/spec/control-spec.txt
+[OR]:        http://en.wikipedia.org/wiki/Onion_routing
+[Backports]: http://rubygems.org/gems/backports

data/VERSION

@@ -1 +1 @@
-0.1.5
+0.1.7

data/lib/tor/config.rb

@@ -47,9 +47,9 @@ module Tor
         File.open(filename.to_s, 'rb') do |file|
           file.each_line do |line|
             case line = line.strip.chomp.strip
-              when ''   then next # skip empty lines
-              when /^#/ then next # skip comments
-              else line = line.split('#').first.strip
+            when ''   then next # skip empty lines
+            when /^#/ then next # skip comments
+            else line = line.split('#').first.strip
             end
             # TODO: support for unquoting and unescaping values
             config << line.split(/\s+/, 2)
@@ -97,6 +97,7 @@ module Tor
     # @return [Enumerator]
     def each(key = nil, &block)
       return enum_for(:each, key) unless block_given?
+
       key ? @lines.find_all { |k, v| key === k }.each(&block) : @lines.each(&block)
     end
   end

data/lib/tor/control.rb

@@ -152,11 +152,11 @@ module Tor
         loop do
           # TODO: support for reading multiple authentication methods
           case reply = read_reply
-            when /^250-AUTH METHODS=(\w*)/
-              method = $1.strip.downcase.to_sym
-              method = method.eql?(:null) ? nil : method
-            when /^250-/  then next
-            when '250 OK' then break
+          when /^250-AUTH METHODS=(\w*)/
+            method = $1.strip.downcase.to_sym
+            method = method.eql?(:null) ? nil : method
+          when /^250-/  then next
+          when '250 OK' then break
           end
         end
         method
@@ -192,8 +192,8 @@ module Tor
       cookie ||= @options[:cookie]
       send(:send_line, cookie ? "AUTHENTICATE #{cookie}" : "AUTHENTICATE")
       case reply = read_reply
-        when '250 OK' then @authenticated = true
-        else raise AuthenticationError.new(reply)
+      when '250 OK' then @authenticated = true
+      else raise AuthenticationError.new(reply)
       end
       self
     end
@@ -252,6 +252,7 @@ module Tor
       read_reply # skip "250+config-text="
       while line = read_reply
         break unless line != "."
+
         reply.concat(line + "\n")
       end
       read_reply # skip "250 OK"
@@ -270,7 +271,7 @@ module Tor
       read_reply
     end
 
-  protected
+    protected
 
     ##
     # Sends a command line over the socket.

data/lib/tor/dnsel.rb

@@ -21,7 +21,7 @@ module Tor
     def self.include?(host)
       begin
         query(host) == '127.0.0.2'
-      rescue Resolv::ResolvError   # NXDOMAIN
+      rescue Resolv::ResolvError # NXDOMAIN
         false
       rescue Resolv::ResolvTimeout
         nil
@@ -61,7 +61,7 @@ module Tor
     end
     class << self; alias_method :hostname, :dnsname; end
 
-  protected
+    protected
 
     ##
     # Resolves `host` into an IPv4 address using Ruby's default resolver.
@@ -78,22 +78,22 @@ module Tor
     # @return [String]
     def self.getaddress(host, reversed = false)
       host = case host.to_s
-        when Resolv::IPv6::Regex
-          raise ArgumentError.new("not an IPv4 address: #{host}")
-        when Resolv::IPv4::Regex
-          host.to_s
-        else
-          begin
-            RESOLVER.each_address(host.to_s) do |addr|
-              return addr.to_s if addr.to_s =~ Resolv::IPv4::Regex
-            end
-            raise Resolv::ResolvError.new("no address for #{host}")
-          rescue NoMethodError
-            # This is a workaround for Ruby bug #2614:
-            # @see http://redmine.ruby-lang.org/issues/show/2614
-            raise Resolv::ResolvError.new("no address for #{host}")
-          end
-      end
+             when Resolv::IPv6::Regex
+               raise ArgumentError.new("not an IPv4 address: #{host}")
+             when Resolv::IPv4::Regex
+               host.to_s
+             else
+               begin
+                 RESOLVER.each_address(host.to_s) do |addr|
+                   return addr.to_s if addr.to_s =~ Resolv::IPv4::Regex
+                 end
+                 raise Resolv::ResolvError.new("no address for #{host}")
+               rescue NoMethodError
+                 # This is a workaround for Ruby bug #2614:
+                 # @see http://redmine.ruby-lang.org/issues/show/2614
+                 raise Resolv::ResolvError.new("no address for #{host}")
+               end
+             end
       reversed ? host.split('.').reverse.join('.') : host
     end
   end

data/lib/tor/version.rb

@@ -2,7 +2,7 @@ module Tor
   module VERSION
     MAJOR = 0
     MINOR = 1
-    TINY  = 4
+    TINY  = 7
     EXTRA = nil
 
     STRING = [MAJOR, MINOR, TINY, EXTRA].compact.join('.')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tor
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - Arto Bendiken
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-22 00:00:00.000000000 Z
+date: 2024-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard
@@ -52,7 +52,7 @@ extra_rdoc_files: []
 files:
 - AUTHORS
 - CREDITS
-- README
+- README.md
 - UNLICENSE
 - VERSION
 - lib/tor.rb
@@ -60,7 +60,7 @@ files:
 - lib/tor/control.rb
 - lib/tor/dnsel.rb
 - lib/tor/version.rb
-homepage: http://cypherpunk.rubyforge.org/tor/
+homepage: https://rubygems.org/gems/tor/
 licenses:
 - Unlicense
 metadata: {}
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Tor (>= 0.2.1.25)
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: Onion routing for Ruby.

data/README

@@ -1 +0,0 @@
-./README.md