trema 0.1.3

data/spec/support/openflow-message.rb

@@ -0,0 +1,94 @@
+#
+# Author: Nick Karanatsios <nickkaranatsios@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# 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 Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+require "rubygems"
+require "rspec"
+
+
+shared_examples_for "any Openflow message with default transaction ID" do
+  its( :transaction_id ) { should be_a_kind_of( Integer ) }
+  its( :transaction_id ) { should be_unsigned_32bit }
+end
+
+
+shared_examples_for "any OpenFlow message" do | options |
+  option = options[ :option ]
+  name = options[ :name ]
+  size = options[ :size ]
+  case size
+  when 8
+    let( :uint_max ) { 2 ** 8 - 1 }
+  when 16
+    let( :uint_max ) { 2 ** 16 - 1 }
+  when 32
+    let( :uint_max ) { 2 ** 32 - 1 }
+  end
+
+
+  context "when its #{ name } is a negative value" do
+    let( option ) { -1234 }
+    it "should raise ArgumentError" do
+      expect { subject }.to raise_error( "#{ name } must be an unsigned #{ size }-bit integer" )
+    end
+  end
+
+
+  context "when its #{ name } is zero" do
+    let( option ) { 0 }
+    its( option ) { should == 0 }
+  end
+
+
+  context "when its #{ name } is 123" do
+    let( option ) { 123 }
+    its( option ) { should == 123 }
+  end
+
+
+  context "when its #{ name } is UINT#{ size }MAX" do
+    let( option ) { uint_max }
+    its( option ) { should == uint_max }
+  end
+
+
+  context "when its #{ name } is UINT#{ size }_MAX + 1" do
+    let( option ) { uint_max + 1 }
+    it "should raise ArgumentError" do
+      expect { subject }.to raise_error( "#{ name } must be an unsigned #{ size }-bit integer" )
+    end
+  end
+end
+
+
+shared_examples_for "any OpenFlow message with port option" do
+  it_should_behave_like "any OpenFlow message", :option => :port, :name => "Port", :size => 16
+end
+
+
+shared_examples_for "any OpenFlow message with transaction_id option" do
+  it_should_behave_like "any OpenFlow message", :option => :transaction_id, :name => "Transaction ID", :size => 32
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/spec/trema/action-enqueue_spec.rb

@@ -0,0 +1,100 @@
+#
+# Author: Nick Karanatsios <nickkaranatsios@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# 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 Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+require File.join( File.dirname( __FILE__ ), "..", "spec_helper" )
+require "trema"
+
+
+shared_examples_for "any OpenFlow message with queue id option" do
+  it_should_behave_like "any OpenFlow message", :option => :queue_id, :name => "Queue id", :size => 32
+end
+
+
+describe ActionEnqueue, "new( VALID OPTIONS )" do
+  subject { ActionEnqueue.new :port => port, :queue_id => queue_id  }
+  let( :port ) { 1 }
+  let( :queue_id ) { 123 }
+  its ( :port ) { should == 1 }
+  its ( :queue_id ) { should == 123 }
+  it "should inspect its attributes" do
+    subject.inspect.should == "#<Trema::ActionEnqueue port=1,queue_id=123>"
+  end
+  it_should_behave_like "any OpenFlow message with port option"
+  it_should_behave_like "any OpenFlow message with queue id option"
+end
+
+
+describe ActionEnqueue, ".new( MANDADORY OPTION MISSING ) - queue id" do
+  subject { ActionEnqueue.new :port => 1 }
+  it "should raise ArgumentError" do
+    expect { subject }.to raise_error( ArgumentError, /Queue id is a mandatory option/ )
+  end
+end
+
+
+describe ActionEnqueue, ".new( MANDATORY OPTION MISSING ) - port" do
+  subject { ActionEnqueue.new :queue_id => 123 }
+  it "should raise ArgumentError" do
+    expect { subject }.to raise_error( ArgumentError, /Port is a mandatory option/ )
+  end
+end
+
+
+describe ActionEnqueue, ".new( MANDATORY OPTIONS MISSING ) - port, queue id" do
+  it "should raise ArgumentError" do
+    expect { subject }.to raise_error( ArgumentError, /Port, queue id are mandatory options/ )
+  end
+end
+
+
+describe ActionEnqueue, ".new( VALID OPTIONS )" do
+  context "when sending #flow_mod(add) with action set to enqueue" do
+    it "should respond to #append" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        action = ActionEnqueue.new( :port => 1, :queue_id => 123 )
+        action.should_receive( :append )
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions => action )
+      }
+    end
+
+
+    it "should have a flow with action set to enqueue" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions => ActionEnqueue.new( :port => 1, :queue_id => 123 ) )
+        sleep 2 # FIXME: wait to send_flow_mod
+        vswitch( "0xabc" ).should have( 1 ).flows
+        vswitch( "0xabc" ).flows[0].actions.should match( /enqueue:1q123/ )
+      }
+    end
+  end
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/spec/trema/action-output_spec.rb

@@ -0,0 +1,116 @@
+#
+# Author: Nick Karanatsios <nickkaranatsios@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# 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 Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+require File.join( File.dirname( __FILE__ ), "..", "spec_helper" )
+require "trema"
+
+
+shared_examples_for "any OpenFlow message with max_len option" do
+  it_should_behave_like "any OpenFlow message", :option => :max_len, :name => "Maximum length", :size => 16
+end
+
+
+describe ActionOutput, ".new( VALID OPTIONS )" do
+  subject { ActionOutput.new :port => port, :max_len => max_len }
+  let( :port ) { 1 }
+  let( :max_len ) { 256 }
+  its( :port ) { should == 1 }
+  its( :max_len ) { should == 256 }
+  it "should inspect its attributes" do
+    subject.inspect.should == "#<Trema::ActionOutput port=1,max_len=256>"
+  end
+  it_should_behave_like "any OpenFlow message with port option"
+  it_should_behave_like "any OpenFlow message with max_len option"
+end
+
+
+describe ActionOutput, ".new( OPTIONAL OPTION MISSING ) - max_len" do
+  subject { ActionOutput.new :port => 1 }
+  its( :port ) { should  == 1 }
+  its( :max_len ) { should == 2**16 -1 }
+  it "should inspect its attributes" do
+    subject.inspect.should == "#<Trema::ActionOutput port=1,max_len=65535>"
+  end
+end
+
+
+describe ActionOutput, ".new( MANDATORY OPTION MISSING )" do
+  it "should raise ArgumentError" do
+    expect { subject }.to raise_error( ArgumentError )
+  end
+end
+
+
+describe ActionOutput, ".new( INVALID OPTION ) - port" do
+  subject { ActionOutput.new  :port => port }
+  it_should_behave_like "any OpenFlow message with port option"
+end
+
+
+describe ActionOutput, ".new( VALID OPTIONS )" do
+  context "when an action output is set to #flow_mod(add) " do
+    it "should respond to #append" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        action = ActionOutput.new(:port => 1 )
+        action.should_receive( :append )
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions => action )
+     }
+    end
+
+
+    it "should have its action set to output:1" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc,
+          :actions => ActionOutput.new( :port => 1 ) )
+        sleep 2 # FIXME: wait to send_flow_mod_add
+        vswitch( "0xabc" ).should have( 1 ).flows
+        vswitch( "0xabc" ).flows[0].actions.should match( /output:1/ )
+      }
+    end
+  end
+
+
+  context "when multiple output actions assigned to #flow_mod(add)" do
+    it "should have its actions set to output:1\/output:2" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions => [ ActionOutput.new( :port => 1 ), ActionOutput.new( :port => 2 ) ] )
+        sleep 2 # FIXME: wait to send_flow_mod_add
+        vswitch( "0xabc" ).should have( 1 ).flows
+        vswitch( "0xabc" ).flows[0].actions.should match( /output:1\/output:2/ )
+      }
+    end
+  end
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/spec/trema/action-set-dl-dst_spec.rb

@@ -0,0 +1,95 @@
+#
+# Author: Nick Karanatsios <nickkaranatsios@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# 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 Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+require File.join( File.dirname( __FILE__ ), "..", "spec_helper" )
+require "trema"
+
+
+describe ActionSetDlDst, ".new( VALID OPTION )" do
+  subject { ActionSetDlDst.new( :dl_dst => Mac.new( "52:54:00:a8:ad:8c" ) ) }
+  its( :dl_dst ) { should be_an_instance_of( Mac ) }
+  it "should inspect its attributes" do
+    subject.inspect.should == "#<Trema::ActionSetDlDst dl_dst=52:54:00:a8:ad:8c>"
+  end
+end
+
+
+describe ActionSetDlDst, ".new( MANDATORY OPTION MISSING )" do
+  it "should raise ArgumentError" do
+    expect { subject }.to raise_error( ArgumentError )
+  end
+end
+
+
+describe ActionSetDlDst, ".new( INVALID OPTION )" do
+  context "when argument type Array instead of Hash" do
+    subject { ActionSetDlDst.new( [ Mac.new( '52:54:00:a8:ad:8c' ) ] ) }
+    it "should raise TypeError" do
+      expect { subject }.to raise_error( TypeError )
+    end
+  end
+
+
+  context "when dl_dst not a Trema::Mac object" do
+    subject { ActionSetDlDst.new :dl_dst => 1234 }
+    it "should raise TypeError" do
+      expect { subject }.to raise_error( TypeError, /dl dst address should be a Mac object/ )
+    end
+  end
+end
+
+
+describe ActionSetDlDst, ".new( VALID OPTION )" do
+  context "when sending #flow_mod(add) with action set to mod_dl_dst" do
+    it "should respond to #append" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        action = ActionSetDlDst.new( :dl_dst => Mac.new( "52:54:00:a8:ad:8c" ) )
+        action.should_receive( :append )
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions => action )
+     }
+    end
+
+
+    it "should have a flow with action set to mod_dl_dst" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        controller( "FlowModAddController" ).send_flow_mod_add(
+          0xabc,
+          :actions =>  ActionSetDlDst.new( :dl_dst => Mac.new( "52:54:00:a8:ad:8c" ) )
+        )
+        sleep 2 # FIXME: wait to send_flow_mod
+        vswitch( "0xabc" ).should have( 1 ).flows
+        vswitch( "0xabc" ).flows[0].actions.should match( /mod_dl_dst:52:54:00:a8:ad:8c/ )
+      }
+    end
+  end
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/spec/trema/action-set-dl-src_spec.rb

@@ -0,0 +1,92 @@
+#
+# Author: Nick Karanatsios <nickkaranatsios@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# 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 Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+require File.join( File.dirname( __FILE__ ), "..", "spec_helper" )
+require "trema"
+
+
+describe ActionSetDlSrc, ".new( VALID OPTION )" do
+  subject { ActionSetDlSrc.new( :dl_src => Mac.new( "52:54:00:a8:ad:8c" ) ) }
+  its ( :dl_src ) { should be_an_instance_of( Trema::Mac ) }
+  it "should inspect its attributes" do
+    subject.inspect.should == "#<Trema::ActionSetDlSrc dl_src=52:54:00:a8:ad:8c>"
+  end
+end
+
+
+describe ActionSetDlSrc, ".new( MANDATORY OPTION MISSING )" do
+  it "should raise ArgumentError" do
+    expect { subject }.to raise_error( ArgumentError )
+  end
+end
+
+
+describe ActionSetDlSrc, ".new( INVALID OPTION )" do
+  context "when argument type Array instead of Hash" do
+    subject { ActionSetDlSrc.new( [ Mac.new( '52:54:00:a8:ad:8c' ) ] ) }
+    it "should raise TypeError" do
+      expect { subject }.to raise_error( TypeError )
+    end
+  end
+
+
+  context "when dl_src not a Trema::Mac object" do
+    subject { ActionSetDlSrc.new :dl_src => 1234 }
+    it "should raise TypeError" do
+      expect { subject }.to raise_error( TypeError, /dl src address should be a Mac object/ )
+    end
+  end
+end
+
+
+describe ActionSetDlSrc, ".new( VALID OPTION )" do
+  context "when sending #flow_mod(add) with action set to mod_dl_src" do
+    it "should respond to #append" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        action = ActionSetDlSrc.new( :dl_src => Mac.new( "52:54:00:a8:ad:8c" ) )
+        action.should_receive( :append )
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions => action )
+     }
+    end
+
+
+    it "should have a flow with action set to mod_dl_src" do
+      class FlowModAddController < Controller; end
+      network {
+        vswitch { datapath_id 0xabc }
+      }.run( FlowModAddController ) {
+        controller( "FlowModAddController" ).send_flow_mod_add( 0xabc, :actions =>  ActionSetDlSrc.new( :dl_src => Mac.new( "52:54:00:a8:ad:8c" ) ) )
+        sleep 2 # FIXME: wait to send_flow_mod
+        vswitch( "0xabc" ).should have( 1 ).flows
+        vswitch( "0xabc" ).flows[0].actions.should match( /mod_dl_src:52:54:00:a8:ad:8c/ )
+      }
+    end
+  end
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End: