cool.io 1.0.0 → 1.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e56b06dac89092ba3fb69d7705788b4aecb51a205075b47afa6b8ff946f8bfa6
+  data.tar.gz: d9ff9ac907b8eb86d3158d893acdcc0f64c58985ae2ccfeeafbcc9c2a5e366a4
+SHA512:
+  metadata.gz: b9d3c85e07f9f439c86be0572d4c455a429fbb2b8fd5b1cbdb87cd0fdca1c629060515074751eecb92357b365edf05c8b0cc79ce63ca4d6188e4eeca903cf95e
+  data.tar.gz: 942c188b705d59f6aa0c9d028d87b17722f9cba55c317cfb1be8f7548562c68e1467c8ec5664297cbb575fd1f6997875311d1a35d76efb772c4f50c87c20aa94

data/.github/workflows/test.yaml

@@ -0,0 +1,54 @@
+name: Test
+
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+env:
+  CONSOLE_OUTPUT: XTerm
+
+jobs:
+  test:
+    name: ${{matrix.ruby}} on ${{matrix.os}}
+    runs-on: ${{matrix.os}}-latest
+    continue-on-error: ${{matrix.experimental}}
+    
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu
+          - macos
+          - windows
+        
+        ruby:
+          - "3.0"
+          - "3.1"
+          - "3.2"
+          - "3.3"
+          - "head"
+        
+        experimental: [false]
+        
+        # include:
+        #   - os: ubuntu
+        #     ruby: truffleruby
+        #     experimental: true
+        #   - os: ubuntu
+        #     ruby: jruby
+        #     experimental: true
+        #   - os: ubuntu
+        #     ruby: head
+        #     experimental: true
+    
+    steps:
+    - uses: actions/checkout@v3
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{matrix.ruby}}
+        bundler-cache: true
+    
+    - name: Run tests
+      timeout-minutes: 2
+      run: bundle exec rake

data/.gitignore

@@ -0,0 +1,30 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+tmp
+
+## RUBINIUS
+*.rbc
+
+## PROJECT::SPECIFIC
+conftest.dSYM
+
+*.lock
+gems.locked
+.ruby-version

data/.rspec

@@ -0,0 +1,3 @@
+--color 
+--format documentation 
+--backtrace

data/{CHANGES → CHANGES.md}

@@ -1,205 +1,301 @@
-1.0.0:
+1.7.1
+-----
+
+* Set fallback local loopback address by default for Windows environment
+
+1.7.0
+-----
+
+* Fix extension build failure for ruby3
+
+1.6.1
+-----
+
+* Fix warning for recent compilers
+
+1.6.0
+-----
+
+* Add ruby 2.6/2.7 to windows gem
+* Drop ruby 2.1/2.2/2.3 from windows gem
+
+1.5.4
+-----
+
+* Add ruby 2.5 to windows gem
+
+1.5.3
+-----
+
+* Fix invalid IOWatcher's rb_funcall that causes ArgumentError with ruby 2.5 and clang
+
+1.5.2
+-----
+
+* Fix invalid TimerWatcher's rb_funcall that causes ArgumentError with ruby 2.5 and clang
+
+1.5.1
+-----
+
+* Don't raise an exception when peername failed
+
+ 1.5.0
+-----
+
+* Update libev to 4.24
+
+1.4.6
+-----
+
+* Add ruby 2.4.0 to windows binary gem
+
+ 1.4.5
+-----
+
+* Increase FD_SETSIZE to 1024 on Windows
+
+1.4.4
+-----
+
+* Suppress lots of warnings
+
+1.4.3
+-----
+
+* Use accept instead of accept_nonblock on Windows to avoid thundering held problem
+* Fix compilation error on Solaris and Ruby 2.3.0
+
+1.4.2
+-----
+
+* Add unexpected object info to attach exception message
+
+1.4.1
+-----
+
+* Use SleepEx instead of Sleep for better fix of process hung problem on windows environment
+* Use rake-compiler-dock for cross compilation
+
+1.4.0
+-----
+
+* Update libev to 4.20
+* Sleep in timeout instead of select on Windows
+
+1.3.1
+-----
+
+* Fix several bugs for JRuby support enhancement
+* Fix deadlock bug on Windows environment
+* Use RSpec3
+
+1.3.0
+-----
+
+* Block evaluation doesn't change self for keeping consistency with Ruby block
+* Remove EventMachine emulation module
+* Remove HttpClient
+* DSL syntax is no longer available by default. Need to require 'cool.io/dsl' in user code
+* Update libev to 4.19
+
+1.2.4
+-----
+
+* Fix a bug that #close for unconnected Socket doesn't detach all watchers (#33)
+* Remove 1.8 support code
+* Use standard library instead of own hosts list (#34)
+
+1.2.3
+-----
+
+* Fix CPU consuming issue on Windows.
+
+1.2.2
+-----
+
+* Add timeout option to Loop#run and Loop#run_once. Default by nil
+* Support Ruby 2.2.0
+
+1.2.1
+-----
+
+* Release the GIL when libev polls (#24)
+* Add Listener#listen method to change backlog size
+
+1.2.0
+-----
+
+* Support Windows environment via cross compilation
+* Include iobuffer library
+* Update to libev 4.15
+* Remove Ruby 1.8 support
+
+1.1.0
+-----
+
+* Switch from Jeweler to Bundler for the gem boilerplate
+* Fix firing of Coolio::HttpClient#on_request_complete (#15)
+* Fix failure to resolve Init_cool symbol on win32 mingw (#14)
+* Fix closing /etc/hosts in the DNS resolver (#12)
+* Refactor StatWatcher to pass pervious and current path state ala Node.js
+* spec:valgrind Rake task to run specs under valgrind
+* Use rake-compiler to build cool.io
+* Upgrade to libev 4.04
+
+1.0.0
+-----
 
 * Fancy new DSL
 
-0.9.0:
+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
-
 * Initial Rubinius support
 
-0.3.2:
+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:
+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:
+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:
+0.2.4
+-----
 
 * Ugh, botched my first release from the git repo.  Oh well.  Try, try again.
 
-0.2.3:
+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:
+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:
+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:
+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:
+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:
+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:
+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:
+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:
+0.1.0
+-----
 
-* Initial public release
+* Initial public release

data/{README.markdown → README.md}

@@ -1,8 +1,6 @@
 Cool.io
 =======
 
-[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 
@@ -14,14 +12,9 @@ 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)
+```ruby
+require 'cool.io'
+```
 
 Anatomy
 -------
@@ -92,37 +85,36 @@ core socket classes are also provided.  Among these are:
   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'
+```ruby
+require 'cool.io'
+require 'cool.io/dsl'
 
-    ADDR = '127.0.0.1'
-    PORT = 4321
+ADDR = '127.0.0.1'
+PORT = 4321
 
-    cool.io.connection :echo_server_connection do
-      on_connect do
-        puts "#{remote_addr}:#{remote_port} connected"
-      end
+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_close do
+    puts "#{remote_addr}:#{remote_port} disconnected"
+  end
 
-      on_read do |data|
-        write data
-      end
-    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
+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.
@@ -140,29 +132,31 @@ 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
+```ruby
+require 'cool.io'
+HOST = 'localhost'
+PORT = 4321
 
-	class EchoServerConnection < Cool.io::TCPSocket
-	  def on_connect
-	    puts "#{remote_addr}:#{remote_port} connected"
-	  end
+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_close
+    puts "#{remote_addr}:#{remote_port} disconnected"
+  end
 
-	  def on_read(data)
-	    write data
-	  end
-	end
+  def on_read(data)
+    write data
+  end
+end
 
-	server = Cool.io::TCPServer.new(HOST, PORT, EchoServerConnection)
-	server.attach(Cool.io::Loop.default)
+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
+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.