cool.io 0.9.0

data/.gitignore

@@ -0,0 +1,25 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## RUBINIUS
+*.rbc
+
+## PROJECT::SPECIFIC
+conftest.dSYM

data/CHANGES

@@ -0,0 +1,199 @@
+0.9.0:
+
+* Rename the project to cool.io
+
+* Bump the version all the way to 0.9! Hell yeah! 1.0 soon!
+
+* Rename the main module from Rev to Coolio, with deprecation warnings for Rev
+
+* Use Jeweler to manage the gem
+
+* Update to RSpec 2.0
+
+* Update to libev 4.01
+
+0.3.2:
+
+* Perform a blocking system call if we're the only thread running (1.8 only)
+
+* Run in non-blocking mode if we're the only thread in the process (1.8 only)
+
+* Make Rev::Loop#run_nonblock signal-safe
+
+* Fix spurious firing of Rev::AsyncWatchers
+
+0.3.1:
+
+* Configurable intervals for Rev::StatWatcher
+
+* Fix broken version number :(
+
+* Removed warning about spuriously readable sockets from Rev::Listener
+
+* Rev::Listener ignores ECONNABORTED from accept_nonblock
+
+* Document rationale for EAGAIN/ECONNABORTED handling in Rev::Listener
+
+0.3.0:
+
+* Add Rev::StatWatcher to monitor filesystem changes
+
+* Add Rev::Listener#fileno for accessing the underlying file descriptor
+
+* Support for creating Rev::Listeners from existing TCPServers/UNIXServers
+
+* Upgrade to libev 3.8
+
+* Simplified code loading
+
+* Pull in iobuffer gem and change outstanding uses of Rev::Buffer to IO::Buffer
+
+* Fix memory leaks resulting from strange semantics of Ruby's xrealloc
+
+* Rev::UNIXServer: use path instead of the first argument
+
+* Rev::Server-based classes can build off ::*Server objects
+
+0.2.4:
+
+* Ugh, botched my first release from the git repo.  Oh well.  Try, try again.
+
+0.2.3:
+
+* Initial Windows support
+
+* Initial Ruby 1.8.7 and 1.9.1 support
+
+* Upgrade to libev 3.52
+
+* Add checks for sys/resource.h and don't allow getting/setting maxfds if it
+  isn't present
+
+0.2.2:
+
+* Correct a pointer arithmetic error in the buffering code that could result
+  in data corruption.
+
+* Upgrade to libev 3.41
+
+* Relax HTTP/1.1 reponse parser to allow the "reason" portion of the response
+  header to be omitted
+
+0.2.1:
+
+* Upgrade to libev 3.31
+
+* Rev::Loop#run_once and Rev::Loop#run_nonblock now return the number of events
+  received when they were running
+
+* Remove inheritence relationship between Rev::IO and Rev::IOWatcher
+
+* Loosen HTTP/1.1 response parser to accept a common malformation in HTTP/1.1
+  chunk headers
+
+* Add underscore prefix to instance variables to avoid conflicts in subclasses
+
+* Remove Rev::SSLServer until it can be made more useful
+
+0.2.0:
+
+* Initial Ruby 1.8.6 support
+
+* Omit Rev::LIBEV_VERSION constant
+
+* Catch Errno::ECONNRESET when writing to sockets
+
+* SSL support via Rev::SSL, with a small C extension subclassing Ruby's
+  OpenSSL::SSL::SSLSocket allowing for non-blocking SSL handshakes
+
+* Initial Rev::Utils implementation with #ncpus and methods to query and
+  change the maximum number of file descriptors for the current process.
+
+* Initial Rev::AsyncWatcher implementation for cross-thread signaling
+
+* Handle unspecified Content-Length when encoding is identity in HttpClient
+
+* Fix bug in HttpClient processing zero Content-Length
+
+* Get rid of method_missing stuff in Rev::HttpClient
+
+* Have Rev::HttpClient close the connection on error
+
+* Allow Rev::TCPSocket#on_connect to be private when accepting connections
+  from a Rev::TCPServer
+
+0.1.4:
+
+* Calibrate Rev::TimerWatchers against ev_time() and ev_now() when the watcher
+  is attached to the loop to ensure that the timeout interval is correct.
+
+* Add check to ensure that a Rev::Loop cannot be run from within a callback
+
+* Store Rev::Loop.default in a Thread-specific instance variable
+
+* Upgrade libev to 0.3.0
+
+* Rename BufferedIO to IO
+
+* Fixed bug in BufferedIO#write_output_buffer causing it to spin endlessly on
+  an empty buffer.
+
+* Added has_active_watchers? to Rev::Loop to check for active watchers
+
+0.1.3:
+
+* Fixed bug in Rev::Buffer read_from and write_to: now rb_sys_fail on failed
+  reads/writes.
+
+* Change Rev::Buffer memory pools to purge on a periodic interval, rather than
+  whenever the GC marks the object.
+
+* Fix bug in tracking the active watcher count.  Factor shared watcher behavior
+  from rev_watcher.h to rev_watcher.c.
+
+0.1.2:
+
+* Commit initial specs
+
+* Improve RDoc for the library
+
+* Eliminate "zero copy" writes as they bypass the event loop
+
+* Added Rev::Buffer C extension to provide high speed buffered writes
+
+* Implement Rev::TCPSocket#peeraddr to improve compatibility with Ruby sockets
+
+* Added Rev::Listener.close for clean shutdown of a listener
+
+* Rev::Loop.default used to call ev_loop_default() (in C).  However, this
+  registers signal handlers which conflict with Ruby's own.  Now the behavior
+  has been changed to return a thread-local singleton of Rev::Loop.
+
+* Creating a new Rev::TCPListener will disable reverse lookups in BasicSocket
+
+* Made backlog for Rev::TCPListener user-definable
+
+* Rev::TCPSocket now implements an on_resolve_failed callback for failed DNS
+  resolution.  By default it's aliased to on_connect_failed.
+
+* Changed event_callbacks to use instance_exec rather than passing the
+  watcher object as an argument.  Documented use of defining an event
+  callback as a block
+
+* Subsecond precision for Rev::TimerWatchers
+
+0.1.1:
+
+* Added Rev::HttpClient, an asynchronous HTTP/1.1 client written on top of
+  the Rev::TCPSocket class
+
+* Imported HTTP response parser from the RFuzz project
+
+* Added exception handling for Errno::ECONNRESET and Errno::EAGAIN
+
+* Fixed bugs in buffered writer which resulted in exceptions if all data
+  couldn't be written with a nonblocking write.
+
+0.1.0:
+
+* Initial public release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007-10 Tony Arcieri
+
+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.markdown

@@ -0,0 +1,4 @@
+Cool.io
+=======
+
+This page intentionally left blank... for now

data/Rakefile

@@ -0,0 +1,98 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "cool.io"
+    gem.summary = "The cool event framework for Ruby"
+    gem.description = "A Ruby wrapper around the libev high performance event library"
+    gem.email = "tony@medioh.com"
+    gem.homepage = "http://github.com/tarcieri/cool.io"
+    gem.authors = ["Tony Arcieri"]
+    gem.add_dependency "iobuffer", ">= 0.1.3"
+    gem.add_development_dependency "rspec", "~> 2.0.0"
+    gem.extensions = FileList["ext/**/extconf.rb"].to_a
+    
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rspec_opts = %w[-fs -c -b]
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+  spec.rspec_opts = %w[-fs -c -b]
+end
+
+task :default => %w(compile spec)
+task :spec => :check_dependencies
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "cool.io #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+def make(makedir)
+  Dir.chdir(makedir) { sh 'make' }
+end
+
+def extconf(dir)
+  Dir.chdir(dir) { ruby "extconf.rb" }
+end
+
+def setup_extension(dir, extension)
+  ext = "ext/#{dir}"
+  ext_so = "#{ext}/#{extension}.#{Config::CONFIG['DLEXT']}"
+  ext_files = FileList[
+    "#{ext}/*.c",
+    "#{ext}/*.h",
+    "#{ext}/extconf.rb",
+    "#{ext}/Makefile",
+  ] 
+
+  desc "Builds just the #{extension} extension"
+  task extension.to_sym => ["#{ext}/Makefile", ext_so ]
+
+  file "#{ext}/Makefile" => ["#{ext}/extconf.rb"] do
+    extconf "#{ext}"
+  end
+
+  file ext_so => ext_files do
+    make "#{ext}"
+    cp ext_so, "lib"
+  end
+end
+
+setup_extension("cool.io", "cool.io_ext")
+setup_extension("http11_client", "http11_client")
+
+task :compile => %w(cool.io_ext http11_client)
+
+# Rebuild parser Ragel
+task :http11_parser do
+  Dir.chdir "ext/http11_client" do
+    target = "http11_parser.c"
+    File.unlink target if File.exist? target
+    sh "ragel http11_parser.rl | rlgen-cd -G2 -o #{target}"
+    raise "Failed to build C source" unless File.exist? target
+  end
+end
+
+CLEAN.include ["build/*", "**/*.o", "**/*.so", "**/*.a", "**/*.log", "pkg"]
+CLEAN.include ["ext/**/Makefile", "lib/cool.io_ext.*", "lib/http11_client.*"]
+CLEAN.include ["ext/**/*.#{Config::CONFIG["DLEXT"]}"]

data/VERSION

@@ -0,0 +1 @@
+0.9.0

data/examples/echo_client.rb

@@ -0,0 +1,38 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'cool.io'
+
+ADDR = '127.0.0.1'
+PORT = 4321
+
+class ClientConnection < Coolio::TCPSocket
+  def on_connect
+    puts "#{remote_addr}:#{remote_port} connected"
+    write "bounce this back to me"
+  end
+
+  def on_close
+    puts "#{remote_addr}:#{remote_port} disconnected"
+  end
+
+  def on_read(data)
+    print "got #{data}"
+    close
+  end
+
+  def on_resolve_failed
+    print "DNS resolve failed"
+  end
+
+  def on_connect_failed
+    print "connect failed, meaning our connection to their port was rejected"
+  end
+
+end
+
+event_loop = Coolio::Loop.default
+client = ClientConnection.connect(ADDR, PORT)
+client.attach(event_loop)
+puts "Echo client connecting to #{ADDR}:#{PORT}..."
+event_loop.run 

data/examples/echo_server.rb

@@ -0,0 +1,27 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'cool.io'
+
+ADDR = '127.0.0.1'
+PORT = 4321
+
+class EchoServerConnection < Coolio::TCPSocket
+  def on_connect
+    puts "#{remote_addr}:#{remote_port} connected"
+  end
+
+  def on_close
+    puts "#{remote_addr}:#{remote_port} disconnected"
+  end
+
+  def on_read(data)
+    write data
+  end
+end
+
+event_loop = Coolio::Loop.default
+Coolio::TCPServer.new(ADDR, PORT, EchoServerConnection).attach(event_loop)
+
+puts "Echo server listening on #{ADDR}:#{PORT}"
+event_loop.run

data/examples/google.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'cool.io'
+
+l = Coolio::Loop.default
+c = Coolio::HttpClient.connect("www.google.com", 80).attach(l)
+c.request('GET', '/search', :query => { :q => 'feces'})
+l.run

data/examples/httpclient.rb

@@ -0,0 +1,38 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'cool.io'
+
+class MyHttpClient < Coolio::HttpClient
+  def on_connect
+    super
+    STDERR.puts "Connected to #{remote_host}:#{remote_port}"
+  end
+
+  def on_connect_failed
+    super
+    STDERR.puts "Connection failed"
+  end
+
+  def on_response_header(header)
+    STDERR.puts "Response: #{header.http_version} #{header.status} #{header.http_reason}"
+  end
+
+  def on_body_data(data)
+    STDOUT.write data
+    STDOUT.flush
+  end
+
+  def on_request_complete
+    STDERR.puts "Request complete!"
+  end
+
+  def on_error(reason)
+    STDERR.puts "Error: #{reason}"
+  end
+end
+
+l = Coolio::Loop.default
+c = MyHttpClient.connect("www.google.com", 80).attach(l)
+c.request('GET', '/search', :query => { :q => 'foobar' })
+l.run