s3sync 1.2.5 → 2.0.0

data/lib/S3_s3sync_mod.rb

@@ -1,143 +0,0 @@
-#  This software code is made available "AS IS" without warranties of any
-#  kind.  You may copy, display, modify and redistribute the software
-#  code either by itself or as incorporated into your code; provided that
-#  you do not remove any proprietary notices.  Your use of this software
-#  code is at your own risk and you waive any claim against Amazon
-#  Digital Services, Inc. or its affiliates with respect to your use of
-#  this software code. (c) 2006 Amazon Digital Services, Inc. or its
-#  affiliates.
-#  
-# This software code is made available "AS IS" without warranties of any        
-# kind.  You may copy, display, modify and redistribute the software            
-# code either by itself or as incorporated into your code; provided that        
-# you do not remove any proprietary notices.  Your use of this software         
-# code is at your own risk and you waive any claim against the author
-# with respect to your use of this software code. 
-# (c) 2007 s3sync.net
-#
-require 'S3'
-require 'HTTPStreaming'
-
-# The purpose of this file is to overlay the S3 library from AWS
-# to add some functionality
-# (without changing the file itself or requiring a specific version)
-# It still isn't perfectly robust, i.e. if radical changes are made
-# to the underlying lib this stuff will need updating.
-
-module S3
-	class AWSAuthConnection
-	
-      def make_http(bucket='', host='', proxy_host=nil, proxy_port=nil, proxy_user=nil, proxy_pass=nil)
-
-         # build the domain based on the calling format
-         server = ''
-         if host != ''
-           server = host           
-         elsif bucket.empty?
-           # for a bucketless request (i.e. list all buckets)
-           # revert to regular domain case since this operation
-           # does not make sense for vanity domains
-           server = @server
-         elsif @calling_format == CallingFormat::SUBDOMAIN
-           server = "#{bucket}.#{@server}" 
-         elsif @calling_format == CallingFormat::VANITY
-           server = bucket 
-         else
-           server = @server
-         end
-         # automatically does the right thing when no proxy
-         http = Net::HTTP::Proxy(proxy_host, proxy_port, proxy_user, proxy_pass).new(server, @port)
-         #http = Net::HTTP.new(server, @port)
-         http.use_ssl = @is_secure
-         http.verify_mode=@verify_mode
-         http.ca_file=@ca_file
-         http.ca_path=@ca_path
-         http.start
-         return http
-      end
-
-		# add support for streaming the response body to an IO stream
-		alias __make_request__ make_request
-      def make_request(method, bucket='', key='', path_args={}, headers={}, data='', metadata={}, streamOut=nil)
-         # build the path based on the calling format
-         path = ''
-         if (not bucket.empty?) and (@calling_format == CallingFormat::REGULAR)
-           path << "/#{bucket}"
-         end
-         # add the slash after the bucket regardless
-         # the key will be appended if it is non-empty
-         path << "/#{key}"
-   
-         # build the path_argument string
-         # add the ? in all cases since 
-         # signature and credentials follow path args
-         path << '?'
-         path << S3.path_args_hash_to_string(path_args) 
-         
-         req = method_to_request_class(method).new("#{path}")
-   
-         set_headers(req, headers)
-         set_headers(req, metadata, METADATA_PREFIX)
-         set_headers(req, {'Connection' => 'keep-alive', 'Keep-Alive' => '300'})
-         
-         set_aws_auth_header(req, @aws_access_key_id, @aws_secret_access_key, bucket, key, path_args)
-         
-         http = $S3syncHttp
-            
-         if req.request_body_permitted?
-           return http.request(req, data, streamOut)
-         else
-           return http.request(req, nil, streamOut)
-         end
-      end
-
-		# a "get" operation that sends the body to an IO stream
-		def get_stream(bucket, key, headers={}, streamOut=nil)
-         return GetResponse.new(make_request('GET', bucket, CGI::escape(key), {}, headers, '', {}, streamOut))
-		end
-		
-		# a "get" operation that sends the body to an IO stream
-		def get_query_stream(bucket, key, path_args={}, headers={}, streamOut=nil)
-         return GetResponse.new(make_request('GET', bucket, CGI::escape(key), path_args, headers, '', {}, streamOut))
-		end
-      
-		def head(bucket, key=nil, headers={})
-         return GetResponse.new(make_request('HEAD', bucket, CGI::escape(key), {}, headers, '', {}))
-		end
-      undef create_bucket
-      def create_bucket(bucket, object)
-         object = S3Object.new(object) if not object.instance_of? S3Object
-         return Response.new(
-            make_request('PUT', bucket, '', {}, {}, object.data, object.metadata)
-         )
-      end
-      # no, because internally the library does not support the header,wait,body paradigm, so this is useless
-      #alias __put__ put
-      #def put(bucket, key, object, headers={})
-      #   headers['Expect'] = "100-continue"
-      #   __put__(bucket, key, object, headers)
-      #end
-
-               
-		# allow ssl validation
-      attr_accessor :verify_mode
-      attr_accessor :ca_path
-      attr_accessor :ca_file      
-
-	end
-   module CallingFormat
-      def CallingFormat.string_to_format(s)
-         case s
-         when 'REGULAR'
-           return CallingFormat::REGULAR
-         when 'SUBDOMAIN'
-           return CallingFormat::SUBDOMAIN
-         when 'VANITY'
-           return CallingFormat::VANITY
-         else
-           raise "Unsupported calling format #{s}"
-         end
-      end
-   end
-   
-end

data/lib/S3encoder.rb

@@ -1,50 +0,0 @@
-# This software code is made available "AS IS" without warranties of any        
-# kind.  You may copy, display, modify and redistribute the software            
-# code either by itself or as incorporated into your code; provided that        
-# you do not remove any proprietary notices.  Your use of this software         
-# code is at your own risk and you waive any claim against the author
-# with respect to your use of this software code. 
-# (c) 2007 s3sync.net
-#
-
-# The purpose of this file is to overlay the cgi class
-# to add some functionality
-# (without changing the file itself or requiring a specific version)
-# It still isn't perfectly robust, i.e. if radical changes are made
-# to the underlying lib this stuff will need updating.
-
-require 'cgi'
-require 'iconv' # for UTF-8 conversion
-
-# thanks to http://www.redhillconsulting.com.au/blogs/simon/archives/000326.html
-module S3ExtendCGI
-	def self.included(base)
-		base.extend(ClassMethods)
-		base.class_eval do
-			class << self
-				alias_method :S3Extend_escape_orig, :escape unless method_defined?(:S3Extend_escape_orig)
-				alias_method :escape, :S3Extend_escape
-			end
-		end
-	end
-	module ClassMethods
-		@@exemptSlashesInEscape = false
-		attr_writer :exemptSlashesInEscape
-		@@usePercent20InEscape = false
-		attr_writer :usePercent20InEscape
-		@@nativeCharacterEncoding = "ISO-8859-1"
-		attr_writer :nativeCharacterEncoding
-		@@useUTF8InEscape = false
-		attr_writer :useUTF8InEscape
-		
-		def S3Extend_escape(string)
-			result = string
-			result = Iconv.iconv("UTF-8", @nativeCharacterEncoding, string).join if @useUTF8InEscape 
-			result = S3Extend_escape_orig(result)
-			result.gsub!(/%2f/i, "/") if @exemptSlashesInEscape
-			result.gsub!("+", "%20") if @usePercent20InEscape
-			result
-		end
-	end
-end
-CGI.send(:include, S3ExtendCGI)

data/lib/s3config.rb

@@ -1,27 +0,0 @@
-#!/usr/bin/ruby
-# This software code is made available "AS IS" without warranties of any        
-# kind.  You may copy, display, modify and redistribute the software            
-# code either by itself or as incorporated into your code; provided that        
-# you do not remove any proprietary notices.  Your use of this software         
-# code is at your own risk and you waive any claim against the author
-# with respect to your use of this software code. 
-# (c) 2007 alastair brunton
-#
-# modified to search out the yaml in several places, thanks wkharold.
-require 'yaml'
-
-module S3Config
-  
-  confpath = ["#{ENV['S3CONF']}", "#{ENV['HOME']}/.s3conf", "/etc/s3conf"]
-  
-  confpath.each do |path|
-    if File.exists?(path) and File.directory?(path) and File.exists?("#{path}/s3config.yml")
-      config = YAML.load_file("#{path}/s3config.yml")
-      config.each_pair do |key, value|
-        eval("$#{key.upcase} = '#{value}'")
-      end
-      break
-    end
-  end
-    
-end

data/lib/s3try.rb

@@ -1,161 +0,0 @@
-#!/usr/bin/env ruby 
-# This software code is made available "AS IS" without warranties of any        
-# kind.  You may copy, display, modify and redistribute the software            
-# code either by itself or as incorporated into your code; provided that        
-# you do not remove any proprietary notices.  Your use of this software         
-# code is at your own risk and you waive any claim against the author
-# with respect to your use of this software code. 
-# (c) 2007 s3sync.net
-#
-module S3sync
-
-	$AWS_ACCESS_KEY_ID = ENV["AWS_ACCESS_KEY_ID"]           
-	$AWS_SECRET_ACCESS_KEY = ENV["AWS_SECRET_ACCESS_KEY"]   
-	$AWS_S3_HOST = (ENV["AWS_S3_HOST"] or "s3.amazonaws.com")
-   $HTTP_PROXY_HOST = ENV["HTTP_PROXY_HOST"]
-   $HTTP_PROXY_PORT = ENV["HTTP_PROXY_PORT"]
-   $HTTP_PROXY_USER = ENV["HTTP_PROXY_USER"]
-   $HTTP_PROXY_PASSWORD = ENV["HTTP_PROXY_PASSWORD"]
-	$SSL_CERT_DIR = ENV["SSL_CERT_DIR"]
-	$SSL_CERT_FILE = ENV["SSL_CERT_FILE"]
-	$S3SYNC_RETRIES = (ENV["S3SYNC_RETRIES"] or 100).to_i # number of errors to tolerate 
-	$S3SYNC_WAITONERROR = (ENV["S3SYNC_WAITONERROR"] or 30).to_i # seconds
-	$S3SYNC_NATIVE_CHARSET = (ENV["S3SYNC_NATIVE_CHARSET"] or "ISO-8859-1")
-	$AWS_CALLING_FORMAT = (ENV["AWS_CALLING_FORMAT"] or "REGULAR")
-   
-	require 'S3'
-
-	require 'HTTPStreaming'
-	require 'S3encoder'
-	CGI::exemptSlashesInEscape = true
-	CGI::usePercent20InEscape = true
-	CGI::useUTF8InEscape = true
-	CGI::nativeCharacterEncoding = $S3SYNC_NATIVE_CHARSET
-	require 'S3_s3sync_mod'
-
-
-	$S3syncRetriesLeft = $S3SYNC_RETRIES.to_i
-	
-	def S3sync.s3trySetup 	
-		
-		# ---------- CONNECT ---------- #
-
-		$S3syncConnection = S3::AWSAuthConnection.new($AWS_ACCESS_KEY_ID, $AWS_SECRET_ACCESS_KEY, $S3syncOptions['--ssl'], $AWS_S3_HOST)
-      $S3syncConnection.calling_format = S3::CallingFormat::string_to_format($AWS_CALLING_FORMAT)
-		if $S3syncOptions['--ssl']
-			if $SSL_CERT_DIR
-				$S3syncConnection.verify_mode = OpenSSL::SSL::VERIFY_PEER
-				$S3syncConnection.ca_path = $SSL_CERT_DIR
-			elsif $SSL_CERT_FILE
-				$S3syncConnection.verify_mode = OpenSSL::SSL::VERIFY_PEER
-				$S3syncConnection.ca_file = $SSL_CERT_FILE
-			end
-		end
-	end
-	def S3sync.s3urlSetup 	
-		$S3syncGenerator = S3::QueryStringAuthGenerator.new($AWS_ACCESS_KEY_ID, $AWS_SECRET_ACCESS_KEY, $S3syncOptions['--ssl'], $AWS_S3_HOST)
-      $S3syncGenerator.calling_format = S3::CallingFormat::string_to_format($AWS_CALLING_FORMAT)
-      $S3syncGenerator.expires_in = $S3syncOptions['--expires-in']
-	end
-   
-   def S3sync.S3tryConnect(bucket, host='')
-         $S3syncHttp = $S3syncConnection.make_http(bucket, host, $HTTP_PROXY_HOST, $HTTP_PROXY_PORT, $HTTP_PROXY_USER, $HTTP_PROXY_PASSWORD)
-   end
-	
-	def S3sync.S3try(command, bucket, *args)
-      if(not $S3syncHttp or (bucket != $S3syncLastBucket))
-         $stderr.puts "Creating new connection" if $S3syncOptions['--debug']
-         $S3syncLastBucket = bucket
-         S3sync.S3tryConnect(bucket)
-      end
-      
-		result = nil
-		delim = $,
-		$,=' '
-		while $S3syncRetriesLeft > 0 do
-         $stderr.puts "Trying command #{command} #{bucket} #{args} with #{$S3syncRetriesLeft} retries left" if $S3syncOptions['--debug']
-			forceRetry = false
-         now = false
-         hush = false
-			begin
-				result = $S3syncConnection.send(command, bucket, *args)
-			rescue Errno::EPIPE => e
-				forceRetry = true
-				$stderr.puts "Broken pipe: #{e}" 
-			rescue Errno::ECONNRESET => e
-				forceRetry = true
-				$stderr.puts "Connection reset: #{e}" 
-			rescue Errno::ECONNABORTED => e
-				forceRetry = true
-				$stderr.puts "Connection aborted: #{e}" 
-			rescue Errno::ETIMEDOUT => e
-				forceRetry = true
-				$stderr.puts "Connection timed out: #{e}"
-			rescue Timeout::Error => e
-				forceRetry = true
-				$stderr.puts "Connection timed out: #{e}" 
-			rescue EOFError => e
-				# i THINK this is happening like a connection reset
-				forceRetry = true
-				$stderr.puts "EOF error: #{e}"
-			rescue OpenSSL::SSL::SSLError => e
-				forceRetry = true
-				$stderr.puts "SSL Error: #{e}"
-			rescue NoMethodError => e
-				# we get this when using --progress, and the local item is something unreadable
-				$stderr.puts "Null stream error: #{e}"
-				break
-			end
-         if forceRetry
-				# kill and reset connection when we receive a non-50x yet retry-able error
-				S3sync.S3tryConnect(bucket)
-         end
-			begin
-				debug("Response code: #{result.http_response.code}")
-				break if ((200...300).include? result.http_response.code.to_i) and (not forceRetry)
-            if result.http_response.code.to_i == 301
-               $stderr.puts "Permanent redirect received. Try setting AWS_CALLING_FORMAT to SUBDOMAIN"
-            elsif result.http_response.code.to_i == 307
-               # move to the other host
-               host = %r{https?://([^/]+)}.match(result.http_response['Location'])[1]
-               $stderr.puts("Temporary Redirect to: " + host)
-               debug("Host: " + host)
-               S3sync.S3tryConnect(bucket, host)
-               $S3syncRetriesLeft = $S3syncRetriesLeft+1 # don't use one up below
-               forceRetry = true
-               now = true
-               hush = true
-            else
-               $stderr.puts "S3 command failed:\n#{command} #{args}"
-               $stderr.puts "With result #{result.http_response.code} #{result.http_response.message}\n"
-               debug(result.http_response.body)
-            end
-				# only retry 500's, per amazon
-				break unless ((500...600).include? result.http_response.code.to_i) or forceRetry
-			rescue NoMethodError
-				debug("No result available")
-			end
-			$S3syncRetriesLeft -= 1
-			$stderr.puts "#{$S3syncRetriesLeft} retries left, sleeping for #{$S3SYNC_WAITONERROR} seconds" unless hush
-			Kernel.sleep $S3SYNC_WAITONERROR.to_i unless now
-		end
-      if $S3syncRetriesLeft <= 0
-         $stderr.puts "Ran out of retries; operations did not complete!"
-      end
-		$, = delim
-		result
-	end
-   
-	def S3sync.S3url(command, bucket, *args)
-      S3sync.s3urlSetup() unless $S3syncGenerator
-		result = nil
-		delim = $,
-		$,=' '
-      $stderr.puts "Calling command #{command} #{bucket} #{args}" if $S3syncOptions['--debug']
-      result = $S3syncGenerator.send(command, bucket, *args)
-		$, = delim
-		result
-	end
-	
-end #module
-

data/lib/thread_generator.rb

@@ -1,383 +0,0 @@
-#!/usr/bin/env ruby
-#--
-# $Idaemons: /home/cvs/rb/generator.rb,v 1.8 2001/10/03 08:54:32 knu Exp $
-# $RoughId: generator.rb,v 1.10 2003/10/14 19:36:58 knu Exp $
-# $Id: generator.rb,v 1.12 2005/12/31 02:56:46 ocean Exp $
-#++
-#
-# = generator.rb: convert an internal iterator to an external one
-#
-# Copyright (c) 2001,2003 Akinori MUSHA <knu@iDaemons.org>
-#
-# All rights reserved.  You can redistribute and/or modify it under
-# the same terms as Ruby.
-#
-# == Overview
-#
-# This library provides the Generator class, which converts an
-# internal iterator (i.e. an Enumerable object) to an external
-# iterator.  In that form, you can roll many iterators independently.
-#
-# The SyncEnumerator class, which is implemented using Generator,
-# makes it easy to roll many Enumerable objects synchronously.
-#
-# See the respective classes for examples of usage.
-
-
-#
-# Generator converts an internal iterator (i.e. an Enumerable object)
-# to an external iterator.
-#
-# == Example
-#
-#   require 'generator'
-#
-#   # Generator from an Enumerable object
-#   g = Generator.new(['A', 'B', 'C', 'Z'])
-#
-#   while g.next?
-#     puts g.next
-#   end
-#
-#   # Generator from a block
-#   g = Generator.new { |g|
-#     for i in 'A'..'C'
-#       g.yield i
-#     end
-#
-#     g.yield 'Z'
-#   }
-#
-#   # The same result as above
-#   while g.next?
-#     puts g.next
-#   end
-#   
-class Generator
-  include Enumerable
-
-  # Creates a new generator either from an Enumerable object or from a
-  # block.
-  #
-  # In the former, block is ignored even if given.
-  #
-  # In the latter, the given block is called with the generator
-  # itself, and expected to call the +yield+ method for each element.
-  def initialize(enum = nil, &block)
-    if enum
-      @block = proc{|g| enum.each{|value| g.yield value}}
-    else
-      @block = block
-    end
-    @index = 0
-    @queue = []
-    @main_thread = nil
-    @loop_thread.kill if defined?(@loop_thread)
-    @loop_thread = Thread.new do
-      Thread.stop
-      begin
-        @block.call(self)
-      rescue
-        @main_thread.raise $!
-      ensure
-        @main_thread.wakeup
-      end
-    end
-    Thread.pass until @loop_thread.stop?
-    self
-  end
-
-  # Yields an element to the generator.
-  def yield(value)
-    if Thread.current != @loop_thread
-      raise "should be called in Generator.new{|g| ... }"
-    end
-    Thread.critical = true
-    begin
-      @queue << value
-      @main_thread.wakeup
-      Thread.stop
-    ensure
-      Thread.critical = false
-    end
-    self
-  end
-
-  # Returns true if the generator has reached the end.
-  def end?
-    if @queue.empty?
-      if @main_thread
-        raise "should not be called in Generator.new{|g| ... }"
-      end
-      Thread.critical = true
-      begin
-        @main_thread = Thread.current
-        @loop_thread.wakeup
-        Thread.stop
-      rescue ThreadError
-        # ignore
-      ensure
-        @main_thread = nil
-        Thread.critical = false
-      end
-    end
-    @queue.empty?
-  end
-
-  # Returns true if the generator has not reached the end yet.
-  def next?
-    !end?
-  end
-
-  # Returns the current index (position) counting from zero.
-  def index
-    @index
-  end
-
-  # Returns the current index (position) counting from zero.
-  def pos
-    @index
-  end
-
-  # Returns the element at the current position and moves forward.
-  def next
-    raise EOFError.new("no more elements available") if end?
-    @index += 1
-    @queue.shift
-  end
-
-  # Returns the element at the current position.
-  def current
-    raise EOFError.new("no more elements available") if end?
-    @queue.first
-  end
-
-  # Rewinds the generator.
-  def rewind
-    initialize(nil, &@block) if @index.nonzero?
-    self
-  end
-
-  # Rewinds the generator and enumerates the elements.
-  def each
-    rewind
-    until end?
-      yield self.next
-    end
-    self
-  end
-end
-
-#
-# SyncEnumerator creates an Enumerable object from multiple Enumerable
-# objects and enumerates them synchronously.
-#
-# == Example
-#
-#   require 'generator'
-#
-#   s = SyncEnumerator.new([1,2,3], ['a', 'b', 'c'])
-#
-#   # Yields [1, 'a'], [2, 'b'], and [3,'c']
-#   s.each { |row| puts row.join(', ') }
-#
-class SyncEnumerator
-  include Enumerable
-
-  # Creates a new SyncEnumerator which enumerates rows of given
-  # Enumerable objects.
-  def initialize(*enums)
-    @gens = enums.map { |e| Generator.new(e) }
-  end
-
-  # Returns the number of enumerated Enumerable objects, i.e. the size
-  # of each row.
-  def size
-    @gens.size
-  end
-
-  # Returns the number of enumerated Enumerable objects, i.e. the size
-  # of each row.
-  def length
-    @gens.length
-  end
-
-  # Returns true if the given nth Enumerable object has reached the
-  # end.  If no argument is given, returns true if any of the
-  # Enumerable objects has reached the end.
-  def end?(i = nil)
-    if i.nil?
-      @gens.detect { |g| g.end? } ? true : false
-    else
-      @gens[i].end?
-    end
-  end
-
-  # Enumerates rows of the Enumerable objects.
-  def each
-    @gens.each { |g| g.rewind }
-
-    loop do
-      count = 0
-
-      ret = @gens.map { |g|
-	if g.end?
-	  count += 1
-	  nil
-	else
-	  g.next
-	end
-      }
-
-      if count == @gens.size
-	break
-      end
-
-      yield ret
-    end
-
-    self
-  end
-end
-
-if $0 == __FILE__
-  eval DATA.read, nil, $0, __LINE__+4
-end
-
-__END__
-
-require 'test/unit'
-
-class TC_Generator < Test::Unit::TestCase
-  def test_block1
-    g = Generator.new { |g|
-      # no yield's
-    }
-
-    assert_equal(0, g.pos)
-    assert_raises(EOFError) { g.current }
-  end
-
-  def test_block2
-    g = Generator.new { |g|
-      for i in 'A'..'C'
-        g.yield i
-      end
-
-      g.yield 'Z'
-    }
-
-    assert_equal(0, g.pos)
-    assert_equal('A', g.current)
-
-    assert_equal(true, g.next?)
-    assert_equal(0, g.pos)
-    assert_equal('A', g.current)
-    assert_equal(0, g.pos)
-    assert_equal('A', g.next)
-
-    assert_equal(1, g.pos)
-    assert_equal(true, g.next?)
-    assert_equal(1, g.pos)
-    assert_equal('B', g.current)
-    assert_equal(1, g.pos)
-    assert_equal('B', g.next)
-
-    assert_equal(g, g.rewind)
-
-    assert_equal(0, g.pos)
-    assert_equal('A', g.current)
-
-    assert_equal(true, g.next?)
-    assert_equal(0, g.pos)
-    assert_equal('A', g.current)
-    assert_equal(0, g.pos)
-    assert_equal('A', g.next)
-
-    assert_equal(1, g.pos)
-    assert_equal(true, g.next?)
-    assert_equal(1, g.pos)
-    assert_equal('B', g.current)
-    assert_equal(1, g.pos)
-    assert_equal('B', g.next)
-
-    assert_equal(2, g.pos)
-    assert_equal(true, g.next?)
-    assert_equal(2, g.pos)
-    assert_equal('C', g.current)
-    assert_equal(2, g.pos)
-    assert_equal('C', g.next)
-
-    assert_equal(3, g.pos)
-    assert_equal(true, g.next?)
-    assert_equal(3, g.pos)
-    assert_equal('Z', g.current)
-    assert_equal(3, g.pos)
-    assert_equal('Z', g.next)
-
-    assert_equal(4, g.pos)
-    assert_equal(false, g.next?)
-    assert_raises(EOFError) { g.next }
-  end
-
-  def test_each
-    a = [5, 6, 7, 8, 9]
-
-    g = Generator.new(a)
-
-    i = 0
-
-    g.each { |x|
-      assert_equal(a[i], x)
-
-      i += 1
-
-      break if i == 3
-    }
-
-    assert_equal(3, i)
-
-    i = 0
-
-    g.each { |x|
-      assert_equal(a[i], x)
-
-      i += 1
-    }
-
-    assert_equal(5, i)
-  end
-end
-
-class TC_SyncEnumerator < Test::Unit::TestCase
-  def test_each
-    r = ['a'..'f', 1..10, 10..20]
-    ra = r.map { |x| x.to_a }
-
-    a = (0...(ra.map {|x| x.size}.max)).map { |i| ra.map { |x| x[i] } }
-
-    s = SyncEnumerator.new(*r)
-
-    i = 0
-
-    s.each { |x|
-      assert_equal(a[i], x)
-
-      i += 1
-
-      break if i == 3
-    }
-
-    assert_equal(3, i)
-
-    i = 0
-
-    s.each { |x|
-      assert_equal(a[i], x)
-
-      i += 1
-    }
-
-    assert_equal(a.size, i)
-  end
-end