cool.io 0.9.0 → 1.0.0

data/CHANGES

@@ -1,3 +1,7 @@
+1.0.0:
+
+* Fancy new DSL
+
 0.9.0:
 
 * Rename the project to cool.io
@@ -12,6 +16,8 @@
 
 * Update to libev 4.01
 
+* Initial Rubinius support
+
 0.3.2:
 
 * Perform a blocking system call if we're the only thread running (1.8 only)

data/README.markdown

@@ -1,4 +1,175 @@
 Cool.io
 =======
 
-This page intentionally left blank... for now
+[http://coolio.github.com](http://coolio.github.com)
+
+Cool.io is an event library for Ruby, built on the libev event library which 
+provides a cross-platform interface to high performance system calls .  This 
+includes the epoll system call for Linux, the kqueue system call for BSDs and 
+OS X, and the completion ports interface for Solaris.
+
+Cool.io also binds asynchronous wrappers to Ruby's core socket classes so you can
+use them in conjunction with Cool.io to build asynchronous event-driven 
+applications.
+
+You can include Cool.io in your programs with:
+
+	require 'rubygems'
+	require 'cool.io'
+
+Questions? Sign up for the mailing list by emailing: [cool.io@librelist.com](mailto:cool.io@librelist.com)
+
+The latest development code is available via github at:
+
+[git://github.com/tarcieri/cool.io.git](git://github.com/tarcieri/cool.io.git)
+
+Anatomy
+-------
+
+Cool.io builds on two core classes which bind to the libev API:
+
+* Cool.io::Loop - This class represents an event loop which uses underlying high
+  performance system calls to wait for events.
+
+* Cool.io::Watcher - This is the base class for event observers.  Once you attach
+  an event observer to a loop and start running it, you will begin receiving
+  callbacks to particlar methods when events occur.
+
+Watchers
+--------
+
+There are presently four types of watchers:
+
+* Cool.io::IOWatcher - This class waits for an IO object to become readable,
+  writable, or both.
+
+* Cool.io::TimerWatcher - This class waits for a specified duration then fires
+  an event.  You can also configure it to fire an event at specified intervals.
+
+* Cool.io::StatWatcher - Monitors files or directories for changes
+
+* Cool.io::AsyncWatcher - Can be used to wake up a Cool.io::Loop running in a
+  different thread. This allows each thread to run a separate Cool.io::Loop and
+  for the different event loops to be able to signal each other.
+
+Using Watchers
+--------------
+
+Watchers have five important methods:
+
+* attach(loop) - This binds a watcher to the specified event loop.  If the
+  watcher is already bound to a loop it will be detached first, then attached
+  to the new one.
+
+* detach - This completely unbinds a watcher from an event loop.
+
+* disable - This stops the watcher from receiving events but does not unbind
+  it from the loop.  If you are trying to toggle a watcher on and off, it's
+  best to use this method (and enable) as it performs better than completely
+  removing the watcher from the event loop.
+
+* enable - This re-enables a watcher which has been disabled in the past.
+  The watcher must still be bound to an event loop.
+
+* evloop - This returns the Cool.io::Loop object which the watcher is currently
+  bound to.
+
+Asynchronous Wrappers
+---------------------
+
+Several classes which provide asynchronous event-driven wrappers for Ruby's
+core socket classes are also provided.  Among these are:
+
+* Cool.io::TCPSocket - A buffered wrapper to core Ruby's Socket class for use with
+  TCP sockets.  You can asynchronously create outgoing TCP connections using 
+  its Cool.io::TCPSocket.connect method.  Cool.io::TCPSocket provides write buffering
+  to ensure that writing never blocks, and has asynchronous callbacks for
+  several events, including when the connection is opened (or failed), when
+  data is received, when the write buffer has been written out completely,
+  and when the connection closes.
+
+* Cool.io::TCPServer - A wrapper for TCPServer which creates new instances of
+  Cool.io::TCPSocket (or any subclass you wish to provide) whenever an incoming
+  connection is received.
+
+* Cool.io::HttpClient - An HTTP/1.1 client with support for chunked encoding
+  and streaming response processing through asynchronous callbacks.
+
+Example Program
+---------------
+
+Cool.io provides a Sinatra-like DSL for authoring event-driven programs:
+
+    require 'rubygems'
+    require 'cool.io'
+
+    ADDR = '127.0.0.1'
+    PORT = 4321
+
+    cool.io.connection :echo_server_connection do
+      on_connect do
+        puts "#{remote_addr}:#{remote_port} connected"
+      end
+
+      on_close do
+        puts "#{remote_addr}:#{remote_port} disconnected"
+      end
+
+      on_read do |data|
+        write data
+      end
+    end
+
+    puts "Echo server listening on #{ADDR}:#{PORT}"
+    cool.io.server ADDR, PORT, :echo_server_connection
+    cool.io.run
+    
+This creates a new connection class called :echo_server_connection and defines
+a set of callbacks for when various events occur.
+
+We then create a new server on the given address and port. When this server
+receives new connections, it will create new instances of the given connection
+class for each connection.
+
+Finally, we kick everything off with cool.io.run. Calling cool.io.run will 
+block, listening for events on our server.
+    
+Using Cool.io subclasses directly
+---------------------------------
+
+Below is an example of how to write an echo server using a subclass instead of
+the DSL:
+
+	require 'cool.io'
+	HOST = 'localhost'
+	PORT = 4321
+
+	class EchoServerConnection < Cool.io::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
+
+	server = Cool.io::TCPServer.new(HOST, PORT, EchoServerConnection)
+	server.attach(Cool.io::Loop.default)
+
+	puts "Echo server listening on #{HOST}:#{PORT}"
+	Cool.io::Loop.default.run
+
+Here a new observer type (EchoServerConnection) is made by subclassing an
+existing one and adding new implementations to existing event handlers.
+
+A new event loop is created, and a new Cool.io::TCPServer (whose base class is
+Cool.io::Watcher) is created and attached to the event loop.
+
+Once this is done, the event loop is started with event_loop.run.  This method
+will block until there are no active watchers for the loop or the loop is
+stopped explicitly with event_loop.stop.

data/Rakefile

@@ -12,7 +12,7 @@ begin
     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.add_development_dependency "rspec", ">= 2.1.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

data/VERSION

@@ -1 +1 @@
-0.9.0
+1.0.0

data/cool.io.gemspec

@@ -0,0 +1,138 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{cool.io}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tony Arcieri"]
+  s.date = %q{2010-12-13}
+  s.description = %q{A Ruby wrapper around the libev high performance event library}
+  s.email = %q{tony@medioh.com}
+  s.extensions = ["ext/cool.io/extconf.rb", "ext/http11_client/extconf.rb"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.markdown"
+  ]
+  s.files = [
+    "CHANGES",
+    "LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "cool.io.gemspec",
+    "examples/dslified_echo_client.rb",
+    "examples/dslified_echo_server.rb",
+    "examples/echo_client.rb",
+    "examples/echo_server.rb",
+    "examples/google.rb",
+    "examples/httpclient.rb",
+    "ext/cool.io/.gitignore",
+    "ext/cool.io/cool.io.h",
+    "ext/cool.io/cool.io_ext.c",
+    "ext/cool.io/ev_wrap.h",
+    "ext/cool.io/extconf.rb",
+    "ext/cool.io/iowatcher.c",
+    "ext/cool.io/libev.c",
+    "ext/cool.io/loop.c",
+    "ext/cool.io/stat_watcher.c",
+    "ext/cool.io/timer_watcher.c",
+    "ext/cool.io/utils.c",
+    "ext/cool.io/watcher.c",
+    "ext/cool.io/watcher.h",
+    "ext/http11_client/.gitignore",
+    "ext/http11_client/LICENSE",
+    "ext/http11_client/ext_help.h",
+    "ext/http11_client/extconf.rb",
+    "ext/http11_client/http11_client.c",
+    "ext/http11_client/http11_parser.c",
+    "ext/http11_client/http11_parser.h",
+    "ext/http11_client/http11_parser.rl",
+    "ext/libev/Changes",
+    "ext/libev/LICENSE",
+    "ext/libev/README",
+    "ext/libev/README.embed",
+    "ext/libev/ev.c",
+    "ext/libev/ev.h",
+    "ext/libev/ev_epoll.c",
+    "ext/libev/ev_kqueue.c",
+    "ext/libev/ev_poll.c",
+    "ext/libev/ev_port.c",
+    "ext/libev/ev_select.c",
+    "ext/libev/ev_vars.h",
+    "ext/libev/ev_win32.c",
+    "ext/libev/ev_wrap.h",
+    "ext/libev/test_libev_win32.c",
+    "lib/.gitignore",
+    "lib/cool.io.rb",
+    "lib/cool.io/async_watcher.rb",
+    "lib/cool.io/dns_resolver.rb",
+    "lib/cool.io/dsl.rb",
+    "lib/cool.io/eventmachine.rb",
+    "lib/cool.io/http_client.rb",
+    "lib/cool.io/io.rb",
+    "lib/cool.io/iowatcher.rb",
+    "lib/cool.io/listener.rb",
+    "lib/cool.io/loop.rb",
+    "lib/cool.io/meta.rb",
+    "lib/cool.io/server.rb",
+    "lib/cool.io/socket.rb",
+    "lib/cool.io/timer_watcher.rb",
+    "lib/coolio.rb",
+    "lib/rev.rb",
+    "spec/async_watcher_spec.rb",
+    "spec/dns_spec.rb",
+    "spec/possible_tests/schedules_other_threads.rb",
+    "spec/possible_tests/test_on_resolve_failed.rb",
+    "spec/possible_tests/test_resolves.rb",
+    "spec/possible_tests/test_write_during_resolve.rb",
+    "spec/possible_tests/works_straight.rb",
+    "spec/spec_helper.rb",
+    "spec/timer_watcher_spec.rb",
+    "spec/unix_listener_spec.rb",
+    "spec/unix_server_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/tarcieri/cool.io}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{The cool event framework for Ruby}
+  s.test_files = [
+    "examples/dslified_echo_client.rb",
+    "examples/dslified_echo_server.rb",
+    "examples/echo_client.rb",
+    "examples/echo_server.rb",
+    "examples/google.rb",
+    "examples/httpclient.rb",
+    "spec/async_watcher_spec.rb",
+    "spec/dns_spec.rb",
+    "spec/possible_tests/schedules_other_threads.rb",
+    "spec/possible_tests/test_on_resolve_failed.rb",
+    "spec/possible_tests/test_resolves.rb",
+    "spec/possible_tests/test_write_during_resolve.rb",
+    "spec/possible_tests/works_straight.rb",
+    "spec/spec_helper.rb",
+    "spec/timer_watcher_spec.rb",
+    "spec/unix_listener_spec.rb",
+    "spec/unix_server_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<iobuffer>, [">= 0.1.3"])
+      s.add_development_dependency(%q<rspec>, [">= 2.1.0"])
+    else
+      s.add_dependency(%q<iobuffer>, [">= 0.1.3"])
+      s.add_dependency(%q<rspec>, [">= 2.1.0"])
+    end
+  else
+    s.add_dependency(%q<iobuffer>, [">= 0.1.3"])
+    s.add_dependency(%q<rspec>, [">= 2.1.0"])
+  end
+end
+

data/examples/dslified_echo_client.rb

@@ -0,0 +1,34 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'cool.io'
+
+ADDR = '127.0.0.1'
+PORT = 4321
+
+cool.io.connect ADDR, PORT do
+  on_connect do
+    puts "Connected to #{remote_host}:#{remote_port}"
+    write "bounce this back to me"
+  end
+
+  on_close do
+    puts "Disconnected from #{remote_host}:#{remote_port}"
+  end
+
+  on_read do |data|
+    puts "Got: #{data}"
+    close
+  end
+
+  on_resolve_failed do
+    puts "Error: Couldn't resolve #{remote_host}"
+  end
+
+  on_connect_failed do
+    puts "Error: Connection refused to #{remote_host}:#{remote_port}"
+  end
+end
+
+puts "Echo client connecting to #{ADDR}:#{PORT}..."
+cool.io.run 

data/examples/dslified_echo_server.rb

@@ -0,0 +1,24 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'cool.io'
+
+ADDR = '127.0.0.1'
+PORT = 4321
+
+cool.io.server ADDR, PORT do
+  on_connect do
+    puts "#{remote_addr}:#{remote_port} connected"
+  end
+
+  on_close do
+    puts "#{remote_addr}:#{remote_port} disconnected"
+  end
+
+  on_read do |data|
+    write data
+  end
+end
+
+puts "Echo server listening on #{ADDR}:#{PORT}"
+cool.io.run

data/examples/echo_client.rb

@@ -6,7 +6,7 @@ require 'cool.io'
 ADDR = '127.0.0.1'
 PORT = 4321
 
-class ClientConnection < Coolio::TCPSocket
+class ClientConnection < Cool.io::TCPSocket
   def on_connect
     puts "#{remote_addr}:#{remote_port} connected"
     write "bounce this back to me"
@@ -31,7 +31,7 @@ class ClientConnection < Coolio::TCPSocket
 
 end
 
-event_loop = Coolio::Loop.default
+event_loop = Cool.io::Loop.default
 client = ClientConnection.connect(ADDR, PORT)
 client.attach(event_loop)
 puts "Echo client connecting to #{ADDR}:#{PORT}..."

data/examples/echo_server.rb

@@ -6,7 +6,7 @@ require 'cool.io'
 ADDR = '127.0.0.1'
 PORT = 4321
 
-class EchoServerConnection < Coolio::TCPSocket
+class EchoServerConnection < Cool.io::TCPSocket
   def on_connect
     puts "#{remote_addr}:#{remote_port} connected"
   end
@@ -20,8 +20,8 @@ class EchoServerConnection < Coolio::TCPSocket
   end
 end
 
-event_loop = Coolio::Loop.default
-Coolio::TCPServer.new(ADDR, PORT, EchoServerConnection).attach(event_loop)
+event_loop = Cool.io::Loop.default
+Cool.io::TCPServer.new(ADDR, PORT, EchoServerConnection).attach(event_loop)
 
 puts "Echo server listening on #{ADDR}:#{PORT}"
 event_loop.run

data/ext/cool.io/loop.c

@@ -274,9 +274,7 @@ static VALUE Coolio_Loop_run_nonblock(VALUE self)
 
   assert(loop_data->ev_loop && !loop_data->events_received);
 
-  TRAP_BEG;
   RUN_LOOP(loop_data, EVLOOP_NONBLOCK);  
-  TRAP_END;
   Coolio_Loop_dispatch_events(loop_data);
   
   nevents = INT2NUM(loop_data->events_received);

data/ext/http11_client/LICENSE

@@ -0,0 +1,31 @@
+Copyright (c) 2010, Zed A. Shaw and Mongrel2 Project Contributors.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+
+    * Neither the name of the Mongrel2 Project, Zed A. Shaw, nor the names
+      of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/lib/cool.io.rb

@@ -18,10 +18,12 @@ require "cool.io/dns_resolver"
 require "cool.io/socket"
 require "cool.io/server"
 require "cool.io/http_client"
+require "cool.io/dsl"
 
 module Coolio
   VERSION = File.read(File.expand_path('../../VERSION', __FILE__)).strip
   def self.version; VERSION; end
+  def self.inspect; "Cool.io"; end
 end
 
 module Cool

data/lib/cool.io/dsl.rb

@@ -0,0 +1,135 @@
+#--
+# Copyright (C)2010 Tony Arcieri
+# You can redistribute this under the terms of the Ruby license
+# See file LICENSE for details
+#++
+
+module Coolio
+  # A module we stash all the connections defined by the DSL under
+  module Connections; end
+  
+  # A DSL for defining Cool.io connection types and servers
+  module DSL
+    # Define all methods on the metaclass
+    module_function
+    
+    # Run the default Cool.io event loop
+    def run
+      Cool.io::Loop.default.run
+    end
+    
+    # Connect to the given host and port using the given connection class
+    def connect(host, port, connection_name = nil, *initializer_args, &block)
+      if block_given?
+        initializer_args.unshift connection_name if connection_name
+        
+        klass = Class.new Cool.io::TCPSocket
+        connection_builder = ConnectionBuilder.new klass
+        connection_builder.instance_eval &block
+      else
+        raise ArgumentError, "no connection name or block given" unless connection_name
+        klass = self[connection_name]
+      end
+      
+      client = klass.connect host, port, *initializer_args
+      client.attach Cool.io::Loop.default
+      client
+    end
+    
+    # Create a new Cool.io::TCPServer
+    def server(host, port, connection_name = nil, *initializer_args, &block)
+      if block_given?
+        initializer_args.unshift connection_name if connection_name
+        
+        klass = Class.new Cool.io::TCPSocket
+        connection_builder = ConnectionBuilder.new klass
+        connection_builder.instance_eval &block
+      else
+        raise ArgumentError, "no connection name or block given" unless connection_name
+        klass = self[connection_name]
+      end
+      
+      server = Cool.io::TCPServer.new host, port, klass, *initializer_args
+      server.attach Cool.io::Loop.default
+      server
+    end
+    
+    # Create a new Cool.io::TCPSocket class
+    def connection(name, &block)
+      # Camelize class name
+      class_name = name.to_s.split('_').map { |s| s.capitalize }.join
+      
+      connection = Class.new Cool.io::TCPSocket
+      connection_builder = ConnectionBuilder.new connection
+      connection_builder.instance_eval &block
+      
+      Coolio::Connections.const_set class_name, connection
+    end
+    
+    # Look up a connection class by its name
+    def [](connection_name)
+      class_name = connection_name.to_s.split('_').map { |s| s.capitalize }.join
+    
+      begin
+        Coolio::Connections.const_get class_name
+      rescue NameError
+        raise NameError, "No connection type registered for #{connection_name.inspect}"
+      end
+    end
+    
+    # Builder for Cool.io::TCPSocket classes
+    class ConnectionBuilder
+      def initialize(klass)
+        @klass = klass
+      end
+      
+      # Declare an initialize function
+      def initializer(&action)
+        @klass.send :define_method, :initialize, &action
+      end
+      
+      # Declare the on_connect callback
+      def on_connect(&action)
+        @klass.send :define_method, :on_connect, &action
+      end
+      
+      # Declare a callback fired if we failed to connect
+      def on_connect_failed(&action)
+        @klass.send :define_method, :on_connect_failed, &action
+      end
+      
+      # Declare a callback fired if DNS resolution failed
+      def on_resolve_failed(&action)
+        @klass.send :define_method, :on_resolve_failed, &action
+      end
+      
+      # Declare the on_close callback
+      def on_close(&action)
+        @klass.send :define_method, :on_close, &action
+      end
+      
+      # Declare the on_read callback
+      def on_read(&action)
+        @klass.send :define_method, :on_read, &action
+      end
+      
+      # Declare the on_write_complete callback
+      def on_write_complete(&action)
+        @klass.send :define_method, :on_write_complete, &action
+      end
+    end
+  end
+end
+
+# The Cool module containing all our coolness
+module Cool
+  module Coolness
+    def cool; Cool::IOThunk; end
+  end
+  
+  module IOThunk
+    def self.io; Coolio::DSL; end
+  end
+end
+
+extend Cool::Coolness

data/lib/cool.io/socket.rb

@@ -39,10 +39,8 @@ module Coolio
     event_callback :on_connect_failed
     
     # Called if a hostname failed to resolve when connecting
-    # Defaults to  calling on_connect_failed
-    def on_resolve_failed
-       on_connect_failed
-    end
+    # Defaults to calling on_connect_failed
+    alias_method :on_resolve_failed, :on_connect_failed
     
     #########
     protected
@@ -123,7 +121,7 @@ module Coolio
     
     # Called by precreate during asyncronous DNS resolution
     def preinitialize(addr, port, *args)
-      @_write_buffer = ::IO::Buffer.new # allow for writing BEFORE the DNS has resolved
+      @_write_buffer = ::IO::Buffer.new # allow for writing BEFORE DNS has resolved
       @remote_host, @remote_addr, @remote_port = addr, addr, port
       @_resolver = TCPConnectResolver.new(self, addr, port, *args)
     end
@@ -137,7 +135,7 @@ module Coolio
       
       super
       
-      @address_family, @remote_port, @remote_host, @remote_addr = socket.peeraddr  
+      @address_family, @remote_port, @remote_host, @remote_addr = socket.peeraddr
     end
     
     def peeraddr
@@ -153,9 +151,9 @@ module Coolio
         @host,  addr, @port = host, addr, port
         @address_family = nil
 
-        @socket = super(family, ::Socket::SOCK_STREAM, 0)
+        super(family, ::Socket::SOCK_STREAM, 0)
         begin
-          @socket.connect_nonblock(::Socket.sockaddr_in(port, addr))
+          connect_nonblock(::Socket.sockaddr_in(port, addr))
         rescue Errno::EINPROGRESS
         end
       end

data/spec/dns_spec.rb

@@ -0,0 +1,39 @@
+require File.expand_path('../spec_helper', __FILE__)
+
+VALID_DOMAIN = "google.com"
+INVALID_DOMAIN = "gibidigibigididibitidibigitibidigitidididi.com"
+
+class ItWorked < StandardError; end
+class WontResolve < StandardError; end
+
+class ConnectorThingy < Cool.io::TCPSocket
+  def on_connect
+    raise ItWorked
+  end
+
+  def on_resolve_failed
+    raise WontResolve
+  end
+end
+
+describe "DNS" do
+  before :each do
+    @loop = Cool.io::Loop.new
+  end
+  
+  it "connects to valid domains" do
+    ConnectorThingy.connect(VALID_DOMAIN, 80).attach(@loop)
+    
+    proc do
+      @loop.run
+    end.should raise_error(ItWorked)
+  end
+  
+  it "fires on_resolve_failed for invalid domains" do
+    ConnectorThingy.connect(INVALID_DOMAIN, 80).attach(@loop)
+    
+    proc do
+      @loop.run
+    end.should raise_error(WontResolve)
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: cool.io
 version: !ruby/object:Gem::Version 
-  hash: 59
+  hash: 23
   prerelease: false
   segments: 
+  - 1
   - 0
-  - 9
   - 0
-  version: 0.9.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Tony Arcieri
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-06 00:00:00 -06:00
+date: 2010-12-13 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -40,14 +40,14 @@ dependencies:
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
-        hash: 15
+        hash: 11
         segments: 
         - 2
+        - 1
         - 0
-        - 0
-        version: 2.0.0
+        version: 2.1.0
   type: :development
   version_requirements: *id002
 description: A Ruby wrapper around the libev high performance event library
@@ -61,12 +61,14 @@ extra_rdoc_files:
 - LICENSE
 - README.markdown
 files: 
-- .gitignore
 - CHANGES
 - LICENSE
 - README.markdown
 - Rakefile
 - VERSION
+- cool.io.gemspec
+- examples/dslified_echo_client.rb
+- examples/dslified_echo_server.rb
 - examples/echo_client.rb
 - examples/echo_server.rb
 - examples/google.rb
@@ -85,6 +87,7 @@ files:
 - ext/cool.io/watcher.c
 - ext/cool.io/watcher.h
 - ext/http11_client/.gitignore
+- ext/http11_client/LICENSE
 - ext/http11_client/ext_help.h
 - ext/http11_client/extconf.rb
 - ext/http11_client/http11_client.c
@@ -106,11 +109,11 @@ files:
 - ext/libev/ev_win32.c
 - ext/libev/ev_wrap.h
 - ext/libev/test_libev_win32.c
-- ext/libev/update_ev_wrap
 - lib/.gitignore
 - lib/cool.io.rb
 - lib/cool.io/async_watcher.rb
 - lib/cool.io/dns_resolver.rb
+- lib/cool.io/dsl.rb
 - lib/cool.io/eventmachine.rb
 - lib/cool.io/http_client.rb
 - lib/cool.io/io.rb
@@ -124,6 +127,7 @@ files:
 - lib/coolio.rb
 - lib/rev.rb
 - spec/async_watcher_spec.rb
+- spec/dns_spec.rb
 - spec/possible_tests/schedules_other_threads.rb
 - spec/possible_tests/test_on_resolve_failed.rb
 - spec/possible_tests/test_resolves.rb
@@ -138,8 +142,8 @@ homepage: http://github.com/tarcieri/cool.io
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -168,17 +172,20 @@ signing_key:
 specification_version: 3
 summary: The cool event framework for Ruby
 test_files: 
+- examples/dslified_echo_client.rb
+- examples/dslified_echo_server.rb
+- examples/echo_client.rb
+- examples/echo_server.rb
+- examples/google.rb
+- examples/httpclient.rb
 - spec/async_watcher_spec.rb
-- spec/spec_helper.rb
-- spec/timer_watcher_spec.rb
-- spec/unix_listener_spec.rb
-- spec/unix_server_spec.rb
+- spec/dns_spec.rb
 - spec/possible_tests/schedules_other_threads.rb
 - spec/possible_tests/test_on_resolve_failed.rb
 - spec/possible_tests/test_resolves.rb
 - spec/possible_tests/test_write_during_resolve.rb
 - spec/possible_tests/works_straight.rb
-- examples/echo_client.rb
-- examples/echo_server.rb
-- examples/google.rb
-- examples/httpclient.rb
+- spec/spec_helper.rb
+- spec/timer_watcher_spec.rb
+- spec/unix_listener_spec.rb
+- spec/unix_server_spec.rb

data/.gitignore

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

data/ext/libev/update_ev_wrap

@@ -1,19 +0,0 @@
-#!/bin/sh
-
-(
-   echo '#define VAR(name,decl) name'
-   echo '#define EV_GENWRAP 1'
-   cat ev_vars.h
-) | cc -E -o - - | perl -ne '
-   while (<>) {
-      push @syms, $1 if /(^\w+)/;
-   }
-   print "/* DO NOT EDIT, automatically generated by update_ev_wrap */\n",
-         "#ifndef EV_WRAP_H\n",
-         "#define EV_WRAP_H\n",
-         (map "#define $_ ((loop)->$_)\n", @syms),
-         "#else\n",
-         "#undef EV_WRAP_H\n",
-         (map "#undef $_\n", @syms),
-         "#endif\n";
-' >ev_wrap.h