eventmachine 0.7.0 → 0.7.2

data/lib/eventmachine_version.rb

@@ -1,34 +1,23 @@
-# $Id: eventmachine_version.rb 221 2006-08-07 13:17:51Z blackhedd $
+# $Id: eventmachine_version.rb 324 2007-05-22 22:43:35Z blackhedd $
 #
-# Author:: blackhedd (gmail address: garbagecat10).
+# Author:: Francis Cianfrocca (gmail: blackhedd)
+# Homepage::  http://rubyeventmachine.com
 # Date:: 8 Apr 2006
 # 
-# Copyright (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-#
-# This program is made available under the terms of the GPL version 2.
-#
 # See EventMachine and EventMachine::Connection for documentation and
 # usage examples.
 #
 #----------------------------------------------------------------------------
 #
-# Copyright (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-#
-# Gmail: garbagecat10
-#
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
+# 
 # This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
+# 
+# See the file COPYING for complete licensing information.
 #
 #---------------------------------------------------------------------------
 #
@@ -36,7 +25,7 @@
 
 module EventMachine
 
-  VERSION = "0.7.0"
+  VERSION = "0.7.2"
 
 end
 

data/lib/evma.rb

@@ -1,27 +1,24 @@
-# $Id: evma.rb 88 2006-05-19 03:42:54Z blackhedd $
+# $Id: evma.rb 319 2007-05-22 22:11:18Z blackhedd $
 #
+# Author:: Francis Cianfrocca (gmail: blackhedd)
 # Homepage::  http://rubyeventmachine.com
-# Copyright:: (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-# Email:: gmail address: garbagecat10
+# Date:: 8 Apr 2006
+# 
+# See EventMachine and EventMachine::Connection for documentation and
+# usage examples.
 #
-# Available under the GNU Lesser General Public License.
-# See the file COPYING in the distribution for full licensing information.
-#-------------------------------------------------------------------
-# This file is part of Ruby/EventMachine.
+#----------------------------------------------------------------------------
 #
-# Ruby/EventMachine is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2.1 of the License, or
-# (at your option) any later version.
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
 # 
-# Ruby/EventMachine is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
 # 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ruby/EventMachine; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# See the file COPYING for complete licensing information.
+#
 #-------------------------------------------------------------------
 #
 

data/lib/evma/callback.rb

@@ -1,28 +1,25 @@
-# $Id: callback.rb 88 2006-05-19 03:42:54Z blackhedd $
+# $Id: callback.rb 321 2007-05-22 22:15:04Z blackhedd $
 #
+# Author:: Francis Cianfrocca (gmail: blackhedd)
 # Homepage::  http://rubyeventmachine.com
-# Copyright:: (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-# Email:: gmail address: garbagecat10
+# Date:: 19 May 2006
+# 
+# See EventMachine and EventMachine::Connection for documentation and
+# usage examples.
 #
-# Available under the GNU Lesser General Public License.
-# See the file COPYING in the distribution for full licensing information.
-#-------------------------------------------------------------------
-# This file is part of Ruby/EventMachine.
+#----------------------------------------------------------------------------
 #
-# Ruby/EventMachine is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2.1 of the License, or
-# (at your option) any later version.
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
 # 
-# Ruby/EventMachine is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
 # 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ruby/EventMachine; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#-------------------------------------------------------------------
+# See the file COPYING for complete licensing information.
+#
+#---------------------------------------------------------------------------
 #
 
 

data/lib/evma/container.rb

@@ -1,31 +1,29 @@
-# $Id: container.rb 90 2006-05-19 04:58:15Z blackhedd $
+# $Id: container.rb 321 2007-05-22 22:15:04Z blackhedd $
 #
+# Author:: Francis Cianfrocca (gmail: blackhedd)
 # Homepage::  http://rubyeventmachine.com
-# Copyright:: (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-# Email:: gmail address: garbagecat10
+# Date:: 19 May 2006
+# 
+# See EventMachine and EventMachine::Connection for documentation and
+# usage examples.
 #
-# Available under the GNU Lesser General Public License.
-# See the file COPYING in the distribution for full licensing information.
-#-------------------------------------------------------------------
-# This file is part of Ruby/EventMachine.
+#----------------------------------------------------------------------------
 #
-# Ruby/EventMachine is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2.1 of the License, or
-# (at your option) any later version.
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
 # 
-# Ruby/EventMachine is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
 # 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ruby/EventMachine; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#-------------------------------------------------------------------
+# See the file COPYING for complete licensing information.
+#
+#---------------------------------------------------------------------------
 #
 
 
+
 require 'singleton'
 
 module Evma

data/lib/evma/factory.rb

@@ -1,28 +1,25 @@
-# $Id: factory.rb 90 2006-05-19 04:58:15Z blackhedd $
+# $Id: factory.rb 321 2007-05-22 22:15:04Z blackhedd $
 #
+# Author:: Francis Cianfrocca (gmail: blackhedd)
 # Homepage::  http://rubyeventmachine.com
-# Copyright:: (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-# Email:: gmail address: garbagecat10
+# Date:: 19 May 2006
+# 
+# See EventMachine and EventMachine::Connection for documentation and
+# usage examples.
 #
-# Available under the GNU Lesser General Public License.
-# See the file COPYING in the distribution for full licensing information.
-#-------------------------------------------------------------------
-# This file is part of Ruby/EventMachine.
+#----------------------------------------------------------------------------
 #
-# Ruby/EventMachine is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2.1 of the License, or
-# (at your option) any later version.
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
 # 
-# Ruby/EventMachine is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
 # 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ruby/EventMachine; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#-------------------------------------------------------------------
+# See the file COPYING for complete licensing information.
+#
+#---------------------------------------------------------------------------
 #
 
 

data/lib/evma/protocol.rb

@@ -1,30 +1,28 @@
-# $Id: protocol.rb 90 2006-05-19 04:58:15Z blackhedd $
+# $Id: protocol.rb 321 2007-05-22 22:15:04Z blackhedd $
 #
+# Author:: Francis Cianfrocca (gmail: blackhedd)
 # Homepage::  http://rubyeventmachine.com
-# Copyright:: (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-# Email:: gmail address: garbagecat10
+# Date:: 19 May 2006
+# 
+# See EventMachine and EventMachine::Connection for documentation and
+# usage examples.
 #
-# Available under the GNU Lesser General Public License.
-# See the file COPYING in the distribution for full licensing information.
-#-------------------------------------------------------------------
-# This file is part of Ruby/EventMachine.
+#----------------------------------------------------------------------------
 #
-# Ruby/EventMachine is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2.1 of the License, or
-# (at your option) any later version.
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
 # 
-# Ruby/EventMachine is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
 # 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ruby/EventMachine; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#-------------------------------------------------------------------
+# See the file COPYING for complete licensing information.
+#
+#---------------------------------------------------------------------------
 #
 
+
 module Evma
 class Protocol
 

data/lib/evma/reactor.rb

@@ -1,31 +1,29 @@
-# $Id: reactor.rb 83 2006-05-18 21:36:31Z blackhedd $
+# $Id: reactor.rb 321 2007-05-22 22:15:04Z blackhedd $
 #
+# Author:: Francis Cianfrocca (gmail: blackhedd)
 # Homepage::  http://rubyeventmachine.com
-# Copyright:: (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-# Email:: gmail address: garbagecat10
+# Date:: 18 May 2006
+# 
+# See EventMachine and EventMachine::Connection for documentation and
+# usage examples.
 #
-# Available under the GNU Lesser General Public License.
-# See the file COPYING in the distribution for full licensing information.
-#-------------------------------------------------------------------
-# This file is part of Ruby/EventMachine.
+#----------------------------------------------------------------------------
 #
-# Ruby/EventMachine is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2.1 of the License, or
-# (at your option) any later version.
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
 # 
-# Ruby/EventMachine is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
 # 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ruby/EventMachine; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#-------------------------------------------------------------------
+# See the file COPYING for complete licensing information.
+#
+#---------------------------------------------------------------------------
 #
 
 
+
 require 'singleton'
 
 module Evma

data/lib/pr_eventmachine.rb

@@ -1,36 +1,25 @@
-# $Id: pr_eventmachine.rb 264 2006-10-05 16:33:22Z blackhedd $
+# $Id: pr_eventmachine.rb 319 2007-05-22 22:11:18Z blackhedd $
 #
-# Author:: blackhedd (gmail address: garbagecat10).
+# Author:: Francis Cianfrocca (gmail: blackhedd)
+# Homepage::  http://rubyeventmachine.com
 # Date:: 8 Apr 2006
 # 
-# Copyright (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-#
-# This program is made available under the terms of the GPL version 2.
-#
 # See EventMachine and EventMachine::Connection for documentation and
 # usage examples.
 #
 #----------------------------------------------------------------------------
 #
-# Copyright (C) 2006 by Francis Cianfrocca. All Rights Reserved.
-#
-# Gmail: garbagecat10
-#
+# Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
+# Gmail: blackhedd
+# 
 # This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# it under the terms of either: 1) the GNU General Public License
+# as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version; or 2) Ruby's License.
+# 
+# See the file COPYING for complete licensing information.
 #
-#---------------------------------------------------------------------------
+#-------------------------------------------------------------------
 #
 # 
 

data/lib/protocols/buftok.rb

@@ -0,0 +1,121 @@
+# BufferedTokenizer - Statefully split input data by a specifiable token
+#
+# Authors:: Tony Arcieri, Martin Emde
+#
+#----------------------------------------------------------------------------
+#
+# Copyright (C) 2006-07 by Tony Arcieri and Martin Emde
+# 
+# Distributed under the Ruby license (http://www.ruby-lang.org/en/LICENSE.txt)
+#
+#---------------------------------------------------------------------------
+#
+
+# (C)2006 Tony Arcieri, Martin Emde
+# Distributed under the Ruby license (http://www.ruby-lang.org/en/LICENSE.txt)
+
+# BufferedTokenizer takes a delimiter upon instantiation, or acts line-based
+# by default.  It allows input to be spoon-fed from some outside source which
+# receives arbitrary length datagrams which may-or-may-not contain the token
+# by which entities are delimited.
+
+class BufferedTokenizer
+  # New BufferedTokenizers will operate on lines delimited by "\n" by default
+  # or allow you to specify any delimiter token you so choose, which will then
+  # be used by String#split to tokenize the input data
+  def initialize(delimiter = "\n", size_limit = nil)
+    # Store the specified delimiter
+    @delimiter = delimiter
+
+    # Store the specified size limitation
+    @size_limit = size_limit
+
+    # The input buffer is stored as an array.  This is by far the most efficient
+    # approach given language constraints (in C a linked list would be a more
+    # appropriate data structure).  Segments of input data are stored in a list
+    # which is only joined when a token is reached, substantially reducing the
+    # number of objects required for the operation.
+    @input = []
+
+    # Size of the input buffer
+    @input_size = 0
+  end
+
+  # Extract takes an arbitrary string of input data and returns an array of
+  # tokenized entities, provided there were any available to extract.  This
+  # makes for easy processing of datagrams using a pattern like:
+  #
+  #   tokenizer.extract(data).map { |entity| Decode(entity) }.each do ...
+  def extract(data)
+    # Extract token-delimited entities from the input string with the split command.
+    # There's a bit of craftiness here with the -1 parameter.  Normally split would
+    # behave no differently regardless of if the token lies at the very end of the 
+    # input buffer or not (i.e. a literal edge case)  Specifying -1 forces split to
+    # return "" in this case, meaning that the last entry in the list represents a
+    # new segment of data where the token has not been encountered
+    entities = data.split @delimiter, -1
+
+    # Check to see if the buffer has exceeded capacity, if we're imposing a limit
+    if @size_limit
+      raise 'input buffer full' if @input_size + entities.first.size > @size_limit
+      @input_size += entities.first.size
+    end
+    
+    # Move the first entry in the resulting array into the input buffer.  It represents
+    # the last segment of a token-delimited entity unless it's the only entry in the list.
+    @input << entities.shift
+
+    # If the resulting array from the split is empty, the token was not encountered
+    # (not even at the end of the buffer).  Since we've encountered no token-delimited
+    # entities this go-around, return an empty array.
+    return [] if entities.empty?
+
+    # At this point, we've hit a token, or potentially multiple tokens.  Now we can bring
+    # together all the data we've buffered from earlier calls without hitting a token,
+    # and add it to our list of discovered entities.
+    entities.unshift @input.join
+
+    # Multi-character token support.
+    # Split any tokens that were incomplete on the last iteration buf complete now.
+    entities.map! do |e|
+      e.split @delimiter, -1
+    end
+    # Flatten the resulting array.  This has the side effect of removing the empty
+    # entry at the end that was produced by passing -1 to split.  Add it again if
+    # necessary.
+    if (entities[-1] == [])
+      entities.flatten! << []
+    else
+      entities.flatten!
+    end
+
+    # Now that we've hit a token, joined the input buffer and added it to the entities
+    # list, we can go ahead and clear the input buffer.  All of the segments that were
+    # stored before the join can now be garbage collected.
+    @input.clear
+    
+    # The last entity in the list is not token delimited, however, thanks to the -1
+    # passed to split.  It represents the beginning of a new list of as-yet-untokenized  
+    # data, so we add it to the start of the list.
+    @input << entities.pop
+    
+    # Set the new input buffer size, provided we're keeping track
+    @input_size = @input.first.size if @size_limit
+
+    # Now we're left with the list of extracted token-delimited entities we wanted
+    # in the first place.  Hooray!
+    entities
+  end
+  
+  # Flush the contents of the input buffer, i.e. return the input buffer even though
+  # a token has not yet been encountered
+  def flush
+    buffer = @input.join
+    @input.clear
+    buffer
+  end
+
+  def empty?
+    @input.empty?
+  end
+end