asyncengine 0.0.1.testing1 → 0.0.2.alpha1

data/lib/asyncengine/version.rb

@@ -1,3 +1,11 @@
 module AsyncEngine
-  VERSION = "0.0.1.testing1"
+  module Version
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 2
+    DEVEL = "alpha1"  # Set to nil for stable releases.
+  end
+
+  VERSION = [Version::MAJOR, Version::MINOR, Version::TINY].join(".")
+  VERSION << ".#{Version::DEVEL}"  if Version::DEVEL
 end

data/test/ae_test_helper.rb

@@ -0,0 +1,62 @@
+require "asyncengine"
+require "test/unit"
+require "socket"
+
+
+class AETest < Test::Unit::TestCase
+
+  def assert_true(object, message="")
+    assert_equal(true, object, message)
+  end
+
+  def assert_false(object, message="")
+    assert_equal(false, object, message)
+  end
+
+  def setup
+    AE.ensure_released
+  end
+
+  def host_loopback_ipv4 ; @@host_loopback_ipv4 ; end
+  def host_ipv4 ; @@host_ipv4 ; end
+  def host_loopback_ipv6 ; @@host_loopback_ipv6 ; end
+  def host_ipv6 ; @@host_ipv6 ; end
+
+
+  private
+
+  def self.get_host_ipv4 loopback
+    remote_ip = ( loopback ? "127.0.0.1" : "1.2.3.4" )
+    orig, ::Socket.do_not_reverse_lookup = Socket.do_not_reverse_lookup, true
+    ::UDPSocket.open(::Socket::AF_INET) do |s|
+      s.connect remote_ip, 1
+      s.addr.last
+    end
+  rescue => e
+    warn "WARN: ae_test_helper.rb: cannot get IPv4 #{loopback ? "loopback " : ""}address in this host, some tests will be skipped"
+    false
+  ensure
+    ::Socket.do_not_reverse_lookup = orig
+  end
+
+  def self.get_host_ipv6 loopback
+    remote_ip = ( loopback ? "::1" : "2001::1" )
+    orig, ::Socket.do_not_reverse_lookup = Socket.do_not_reverse_lookup, true
+    ::UDPSocket.open(::Socket::AF_INET6) do |s|
+      s.connect remote_ip, 1
+      s.addr.last
+    end
+  rescue => e
+    warn "WARN: ae_test_helper.rb: cannot get IPv6 #{loopback ? "loopback " : ""}address in this host, some tests will be skipped"
+    false
+  ensure
+    ::Socket.do_not_reverse_lookup = orig
+  end
+
+
+  @@host_loopback_ipv4 = get_host_ipv4 loopback=true
+  @@host_ipv4 = get_host_ipv4 loopback=false
+  @@host_loopback_ipv6 = get_host_ipv6 loopback=true
+  @@host_ipv6 = get_host_ipv6 loopback=false
+
+end

data/test/test_basic.rb

@@ -0,0 +1,169 @@
+require "ae_test_helper"
+
+
+class TestBasic < AETest
+
+  def test_01_AE_is_restartable
+    str = ""
+
+    assert_false AE.running?
+    AE.run { assert_true AE.running? ; AE.stop }
+    assert_false AE.running?
+
+    assert_true AE.run { AE.stop }
+    assert_false AE.running?
+
+    assert_true AE.run { AE.add_timer(0.001) { assert_true AE.running? ; str << "a" ; AE.stop } }
+    assert_false AE.running?
+
+    assert_true AE.run { AE.next_tick { str << "b" ; AE.stop } }
+    assert_true AE.run { AE.stop }
+
+    AE.run do
+      char = "b"
+      iteration = 0
+      pt1 = AE::PeriodicTimer.new(0.001) do
+        str << char.next!
+        iteration += 1
+        AE.stop  if iteration == 4
+      end
+    end
+    assert_false AE.running?
+
+    assert_equal "abcdef", str
+  end
+
+  def test_02_stop_works_as_expected
+    @var = false
+    AE.run do
+      AE.next_tick { @var = true }
+      AE.stop
+    end
+    assert_false AE.running?
+    assert_true @var
+
+    @var = false
+    AE.run do
+      AE.next_tick { AE.next_tick { @var = true } }
+      AE.stop
+    end
+    assert_false AE.running?
+    assert_false @var
+
+    @var = false
+    AE.run do
+      AE.add_timer(0.1) { @var = true }
+      AE.stop
+    end
+    assert_false @var
+
+    @var = false
+    AE.run do
+      AE.add_timer(0.11) { @var = true }
+      AE.next_tick { AE.stop }
+    end
+    assert_false @var
+  end
+
+  def test_03_run_in_run
+    num = 0
+
+    AE.run do
+      num+=1
+      AE.run { num+=1 }
+      AE.run { AE.run { num+=1 } } # Wont' occur.
+      AE.next_tick { num+=1 }
+      AE.next_tick { AE.next_tick { num+=1 } }  # Won't occur.
+      AE.stop
+    end
+    assert_equal 3, num
+  end
+
+  def test_04_multiple_stop
+    AE.run do
+      AE.next_tick { AE.next_tick { AE.stop } }
+      AE.next_tick { AE.stop ; AE.stop }
+      AE.add_timer(0) { AE.stop }
+    end
+    assert_false AE.running?
+  end
+
+  def test_05_stop_from_different_thread
+    @var = false
+    Thread.new { sleep 0.05 ; AE.stop }
+    AE.run do
+      AE.add_timer(1) { @var = true }  # Won't occur.
+    end
+    assert_false @var
+  end
+
+  def test_06_signal_kills_asyncengine
+    @var = false
+
+    assert_raise SignalException do
+      AE.run do
+        AE.add_timer(0) { Process.kill :USR1, $$ }
+        AE.add_timer(1) { @var = true }  # Won't occur.
+      end
+    end
+
+    assert_true AE.run { AE.stop }
+    assert_false @var
+  end
+
+  def test_07_on_exit
+    num = 0
+
+    AE.on_exit { num += 1 }
+    AE.on_exit { num += 1 }
+    AE.run do
+      AE.on_exit { num += 1 }
+      AE.next_tick { AE.on_exit { num += 1 } ; AE.stop }
+      AE.on_exit { num += 1 }
+    end
+
+    assert_equal 5, num
+
+    num = 0
+
+    AE.on_exit { num += 1 }
+    AE.run do
+      AE.unset_on_exit
+      AE.stop
+    end
+
+    assert_equal 0, num
+  end
+
+  def test_08_on_exit_with_error
+    num = 0
+
+    AE.on_exit {|error| num += 1 }
+    AE.on_exit {|error| num += 1 ; raise RuntimeError, "runtime error" }
+    AE.on_exit {|error| num += 1 }  # This won't occur.
+
+    begin
+      AE.run do
+        pumpppp  # This will produce NameError.
+      end
+    # But the last exception took place when executing @_on_exit_procs: RuntimeError.
+    rescue => e
+      assert_equal RuntimeError, e.class
+    end
+
+    assert_equal 2, num
+  end
+
+  def test_09_run_in_on_error
+    num = 0
+
+    AE.on_exit do
+      AE.run { num += 1 ; AE.stop }
+    end
+
+    AE.run { num += 1 ; AE.stop }
+
+    assert_equal 2, num
+  end
+
+end

data/test/test_call_from_other_thread.rb

@@ -0,0 +1,55 @@
+require "ae_test_helper"
+
+
+class TestCallFromOtherThread < AETest
+
+  def test_01_call_from_other_thread_run_in_order_when_in_same_thread
+    str = ""
+
+    AE.run do
+      AE.call_from_other_thread { str << "1" }
+      AE.call_from_other_thread { str << "2" }
+      AE.call_from_other_thread { str << "3" ; AE.call_from_other_thread { str << "6" } ; AE.call_from_other_thread { str << "7" } }
+      AE.call_from_other_thread { AE.call_from_other_thread { str << "8" ; AE.call_from_other_thread { str << "B" } } }
+      AE.call_from_other_thread { AE.call_from_other_thread { str << "9" ; AE.call_from_other_thread { str << "C" } ; AE.call_from_other_thread { str << "D" ; AE.stop } } }
+      AE.call_from_other_thread { str << "4" }
+      AE.call_from_other_thread { str << "5" ; AE.call_from_other_thread { str << "A" } }
+    end
+
+    assert_equal "123456789ABCD", str
+  end
+
+  def test_02_call_from_other_thread_and_timer
+    str = ""
+
+    AE.run do
+      AE.call_from_other_thread { str << "1" }
+      AE.add_timer(0.01) { AE.call_from_other_thread { str << "3" } }
+      AE.add_timer(0.02) { AE.call_from_other_thread { str << "4" ; AE.call_from_other_thread { str << "6" ; AE.stop } } ; AE.call_from_other_thread { str << "5" } }
+      AE.call_from_other_thread { str << "2" }
+    end
+
+    assert_equal "123456", str
+  end
+
+  def test_03_multiple_stop_in_cascade_from_different_thread
+    @var = false
+
+    AE.run do
+      AE.add_timer(1) { @var = true }  # Won't occur.
+      Thread.new do
+        AE.call_from_other_thread do
+          AE.call_from_other_thread do
+            AE.call_from_other_thread do
+              AE.stop
+            end
+          end
+        end
+      end
+    end
+    assert_false @var
+  end
+
+end
+
+

data/test/test_error.rb

@@ -0,0 +1,92 @@
+require "ae_test_helper"
+
+
+class TestError < AETest
+
+  def test_01_exception_raised
+    assert_raise NameError do
+      AE.run { ouch1a }
+    end
+    assert_false AE.running?
+
+    assert_raise NameError do
+      AE.run { AE.next_tick { ouch1b } }
+    end
+    assert_false AE.running?
+
+    assert_raise NameError do
+      AE.run { AE.add_timer(0) { ouch1c } }
+    end
+    assert_false AE.running?
+
+    assert_raise NameError do
+      AE.run do
+        AE.add_timer(0) do
+          AE.next_tick do
+            AE.add_timer(0) { ouch1d }
+          end
+        end
+      end
+    end
+    assert_false AE.running?
+  end
+
+  def test_02_error_handler
+    AE.on_error {|e| assert e.is_a? ::StandardError }
+    assert_respond_to AE.instance_variable_get(:@_user_error_handler), :call
+
+    assert_nothing_raised do
+      AE.run do
+        AE.next_tick { qweqwe }
+        AE.add_timer(0) { uhhhh2 }
+        AE.add_timer(0.01) { AE.stop }
+        lalalalala
+      end
+    end
+    assert_false AE.running?
+
+    # Dissable the error handler again.
+    AE.unset_on_error
+    assert_equal nil, AE.instance_variable_get(:@_user_error_manager)
+
+    assert_raise NameError do
+      AE.run { AE.add_timer(0) { opppps } }
+    end
+    assert_false AE.running?
+  end
+
+  def test_03_exception_in_error_handler
+    AE.on_error {|e| 1/0 }
+
+    assert_raise ZeroDivisionError do
+      AE.run { AE.next_tick { ouch3 } }
+    end
+    assert_false AE.running?
+
+    assert_raise ZeroDivisionError do
+      AE.run { AE::Timer.new(0) { 1/0 } }
+    end
+    assert_false AE.running?
+
+    AE.unset_on_error
+  end
+
+  def test_04_error_handler_in_next_tick_allows_executes_all_next_ticks
+    AE.on_error {|e| assert e.is_a? ::StandardError }
+
+    num = 0
+    AE.run do
+      AE.next_tick { num+=1 }
+      AE.next_tick { num+=1 }
+      AE.next_tick { bumpppp }
+      AE.next_tick { num+=1 }
+      AE.next_tick { num+=1 }
+      AE.next_tick { AE.stop }
+    end
+
+    AE.unset_on_error
+
+    assert_equal 4, num
+  end
+
+end

data/test/test_ip_utils.rb

@@ -0,0 +1,44 @@
+require "ae_test_helper"
+
+
+class TestIpUtils < AETest
+
+  def test_01_ip_type
+    assert_equal :ipv4, AE::IpUtils.ip_type("1.2.3.4")
+    assert_false AE::IpUtils.ip_type("1.2.3.04")
+    assert_false AE::IpUtils.ip_type("1.2.3.004")
+    assert_false AE::IpUtils.ip_type("1.2.3.0004")
+
+    assert_equal :ipv6, AE::IpUtils.ip_type("1080::8:800:200C:417A")
+    assert_equal :ipv6, AE::IpUtils.ip_type("1080:0:0:0:8:800:200C:417A")
+    assert_equal :ipv6, AE::IpUtils.ip_type("1080:0000:0000:0000:0008:0800:200C:417A")
+    assert_false AE::IpUtils.ip_type("1::8::1")
+
+    assert_equal :ipv6_reference, AE::IpUtils.ip_type("[1080::8:800:200C:417A]")
+    assert_equal :ipv6_reference, AE::IpUtils.ip_type("[1080:0:0:0:8:800:200C:417A]")
+    assert_equal :ipv6_reference, AE::IpUtils.ip_type("[1080:0000:0000:0000:0008:0800:200C:417A]")
+    assert_false AE::IpUtils.ip_type("[1::8::1]")
+
+    assert_false AE::IpUtils.ip_type("domain.net")
+  end
+
+  def test_02_compare_ips
+    assert_true AE::IpUtils.compare_ips("255.255.255.255", "255.255.255.255")
+    assert_false AE::IpUtils.compare_ips("1.2.3.4", "9.9.9.9")
+    assert_nil AE::IpUtils.compare_ips("1.2.3.4", "1.2.3.04")
+
+    assert_true AE::IpUtils.compare_ips("1080::8:800:200C:417A", "1080:0:0:0:8:800:200C:417A")
+    assert_true AE::IpUtils.compare_ips("1080::8:800:200C:417A", "1080:0000:0000:0000:0008:0800:200c:417a")
+    assert_true AE::IpUtils.compare_ips("::", "00::00:0")
+    assert_false AE::IpUtils.compare_ips("1080::8:800:200C:417A", "1::2")
+
+    assert_true AE::IpUtils.compare_ips("[1080::8:800:200C:417A]", "[1080:0:0:0:8:800:200C:417A]")
+    assert_true AE::IpUtils.compare_ips("[1080::8:800:200C:417A]", "[1080:0:0:0:8:800:200C:417A]")
+
+    assert_true AE::IpUtils.compare_ips("1080::8:800:200C:417A", "[1080:0:0:0:8:800:200C:417A]", true)
+    assert_true AE::IpUtils.compare_ips("[1080:0:0:0:8:800:200C:417A]", "1080::8:800:200C:417A", true)
+
+    assert_nil AE::IpUtils.compare_ips("1", "::")
+  end
+
+end

data/test/test_next_tick.rb

@@ -0,0 +1,37 @@
+require "ae_test_helper"
+
+
+class TestNextTick < AETest
+
+  def test_01_next_tick_run_in_order
+    str = ""
+
+    AE.run do
+      AE.next_tick { str << "1" }
+      AE.next_tick { str << "2" }
+      AE.next_tick { str << "3" ; AE.next_tick { str << "6" } ; AE.next_tick { str << "7" } }
+      AE.next_tick { AE.next_tick { str << "8" ; AE.next_tick { str << "B" } } }
+      AE.next_tick { AE.next_tick { str << "9" ; AE.next_tick { str << "C" } ; AE.next_tick { str << "D" ; AE.stop } } }
+      AE.next_tick { str << "4" }
+      AE.next_tick { str << "5" ; AE.next_tick { str << "A" } }
+    end
+
+    assert_equal "123456789ABCD", str
+  end
+
+  def test_02_next_tick_and_timer
+    str = ""
+
+    AE.run do
+      AE.next_tick { str << "1" }
+      AE.add_timer(0.001) { AE.next_tick { str << "3" } }
+      AE.add_timer(0.002) { AE.next_tick { str << "4" ; AE.next_tick { str << "6" ; AE.stop } } ; AE.next_tick { str << "5" } }
+      AE.next_tick { str << "2" }
+    end
+
+    assert_equal "123456", str
+  end
+
+end
+
+