pio 0.10.1 → 0.11.0

data/spec/pio/flow_mod_spec.rb

@@ -0,0 +1,151 @@
+require 'pio/flow_mod'
+
+describe Pio::FlowMod do
+  Given(:dump) do
+    [
+      0x01,
+      0x0e,
+      0x00, 0x50,
+      0x00, 0x00, 0x00, 0x15,
+      0x00, 0x38, 0x20, 0xfe, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00,
+      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01,
+      0x00, 0x00,
+      0x00, 0x00,
+      0x00, 0x00,
+      0xff, 0xff,
+      0xff, 0xff, 0xff, 0xff,
+      0x00, 0x02,
+      0x00, 0x03,
+      0x00, 0x00, 0x00, 0x08, 0x00, 0x02, 0xff, 0xff
+    ].pack('C*')
+  end
+
+  describe '.read' do
+    context 'with a flow_mod message' do
+      When(:flow_mod) do
+        Pio::FlowMod.read(dump)
+      end
+
+      Then { flow_mod.class == Pio::FlowMod }
+      Then { flow_mod.ofp_version == 0x1 }
+      Then { flow_mod.message_type == 0xe }
+      Then { flow_mod.message_length == 0x50 }
+      Then { flow_mod.transaction_id == 0x15 }
+      Then { flow_mod.xid == 0x15 }
+
+      Then { !flow_mod.body.empty? }
+      Then do
+        flow_mod.match.wildcards.keys == [
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src_all,
+          :nw_dst_all,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      Then { flow_mod.match.in_port == 1 }
+      Then { flow_mod.match.dl_src == '00:00:00:00:00:00' }
+      Then { flow_mod.match.dl_dst == '00:00:00:00:00:00' }
+      Then { flow_mod.match.dl_vlan == 0 }
+      Then { flow_mod.match.dl_vlan_pcp == 0 }
+      Then { flow_mod.match.dl_type == 0 }
+      Then { flow_mod.match.nw_tos == 0 }
+      Then { flow_mod.match.nw_proto == 0 }
+      Then { flow_mod.match.nw_src == '0.0.0.0' }
+      Then { flow_mod.match.nw_dst == '0.0.0.0' }
+      Then { flow_mod.match.tp_src == 0 }
+      Then { flow_mod.match.tp_dst == 0 }
+      Then { flow_mod.cookie == 1 }
+      Then { flow_mod.command == :add }
+      Then { flow_mod.idle_timeout == 0 }
+      Then { flow_mod.hard_timeout == 0 }
+      Then { flow_mod.priority == 0xffff }
+      Then { flow_mod.buffer_id == 0xffffffff }
+      Then { flow_mod.out_port == 2 }
+      Then { flow_mod.flags == [:send_flow_rem, :check_overwrap] }
+      Then { flow_mod.actions.length == 1 }
+      Then { flow_mod.actions[0].is_a? Pio::SendOutPort }
+      Then { flow_mod.actions[0].port_number == 2 }
+      Then { flow_mod.actions[0].max_len == 2**16 - 1 }
+    end
+  end
+
+  describe '.new' do
+    context 'with a SendOutPort action' do
+      When(:flow_mod) do
+        Pio::FlowMod.new(transaction_id: 0x15,
+                         buffer_id: 0xffffffff,
+                         match: Pio::Match.new(in_port: 1),
+                         cookie: 1,
+                         command: :add,
+                         priority: 0xffff,
+                         out_port: 2,
+                         flags: [:send_flow_rem, :check_overwrap],
+                         actions: Pio::SendOutPort.new(2)
+        )
+      end
+
+      Then { flow_mod.class == Pio::FlowMod }
+      Then { flow_mod.ofp_version == 0x1 }
+      Then { flow_mod.message_type == 0xe }
+      Then { flow_mod.message_length == 0x50 }
+      Then { flow_mod.transaction_id == 0x15 }
+      Then { flow_mod.xid == 0x15 }
+
+      Then { !flow_mod.body.empty? }
+      Then do
+        flow_mod.match.wildcards.keys == [
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src_all,
+          :nw_dst_all,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      Then { flow_mod.match.in_port == 1 }
+      Then { flow_mod.match.dl_src == '00:00:00:00:00:00' }
+      Then { flow_mod.match.dl_dst == '00:00:00:00:00:00' }
+      Then { flow_mod.match.dl_vlan == 0 }
+      Then { flow_mod.match.dl_vlan_pcp == 0 }
+      Then { flow_mod.match.dl_type == 0 }
+      Then { flow_mod.match.nw_tos == 0 }
+      Then { flow_mod.match.nw_proto == 0 }
+      Then { flow_mod.match.nw_src == '0.0.0.0' }
+      Then { flow_mod.match.nw_dst == '0.0.0.0' }
+      Then { flow_mod.match.tp_src == 0 }
+      Then { flow_mod.match.tp_dst == 0 }
+      Then { flow_mod.cookie == 1 }
+      Then { flow_mod.command == :add }
+      Then { flow_mod.idle_timeout == 0 }
+      Then { flow_mod.hard_timeout == 0 }
+      Then { flow_mod.priority == 0xffff }
+      Then { flow_mod.buffer_id == 0xffffffff }
+      Then { flow_mod.out_port == 2 }
+      Then { flow_mod.flags == [:send_flow_rem, :check_overwrap] }
+      Then { flow_mod.actions.length == 1 }
+      Then { flow_mod.actions[0].is_a? Pio::SendOutPort }
+      Then { flow_mod.actions[0].port_number == 2 }
+      Then { flow_mod.actions[0].max_len == 2**16 - 1 }
+
+      context '#to_binary' do
+        When(:binary) { flow_mod.to_binary }
+        Then { binary == dump }
+      end
+    end
+  end
+end

data/spec/pio/hello_spec.rb

@@ -2,82 +2,99 @@ require 'pio/hello'
 
 describe Pio::Hello do
   describe '.read' do
-    context 'with a hello message' do
-      Given(:hello_dump) { [1, 0, 0, 8, 0, 0, 0, 0].pack('C*') }
-
-      When(:hello) { Pio::Hello.read(hello_dump) }
+    When(:result) { Pio::Hello.read(binary) }
 
-      Then { hello.class == Pio::Hello }
-      Then { hello.ofp_version == 1 }
-      Then { hello.message_type == 0 }
-      Then { hello.message_length == 8 }
-      Then { hello.transaction_id == 0 }
-      Then { hello.xid == 0 }
-      Then { hello.body.empty? }
+    context 'with a hello message' do
+      Given(:binary) { [1, 0, 0, 8, 0, 0, 0, 0].pack('C*') }
+
+      Then { result.class == Pio::Hello }
+      Then { result.ofp_version == 1 }
+      Then { result.message_type == 0 }
+      Then { result.message_length == 8 }
+      Then { result.transaction_id == 0 }
+      Then { result.xid == 0 }
+      Then { result.body.empty? }
+      Then { result.body == '' }
     end
 
     context 'with a features-request message' do
-      Given(:features_request_dump) { [1, 5, 0, 8, 0, 0, 0, 0].pack('C*') }
-
-      When(:result) { Pio::Hello.read(features_request_dump) }
+      Given(:binary) { [1, 5, 0, 8, 0, 0, 0, 0].pack('C*') }
 
-      Then { result == Failure(Pio::ParseError) }
+      Then { result == Failure(Pio::ParseError, 'Invalid Hello message.') }
     end
   end
 
   describe '.new' do
     context 'with no arguments' do
-      When(:hello) { Pio::Hello.new }
-
-      Then { hello.ofp_version == 1 }
-      Then { hello.message_type == 0 }
-      Then { hello.message_length == 8 }
-      Then { hello.transaction_id == 0 }
-      Then { hello.xid == 0 }
-      Then { hello.body.empty? }
-      Then { hello.to_binary == [1, 0, 0, 8, 0, 0, 0, 0].pack('C*') }
+      When(:result) { Pio::Hello.new }
+
+      Then { result.ofp_version == 1 }
+      Then { result.message_type == 0 }
+      Then { result.message_length == 8 }
+      Then { result.transaction_id == 0 }
+      Then { result.xid == 0 }
+      Then { result.body.empty? }
+      Then { result.body == '' }
+      Then { result.to_binary == [1, 0, 0, 8, 0, 0, 0, 0].pack('C*') }
     end
 
     context 'with 123' do
-      When(:hello) { Pio::Hello.new(123) }
-
-      Then { hello.ofp_version == 1 }
-      Then { hello.message_type == 0 }
-      Then { hello.message_length == 8 }
-      Then { hello.transaction_id == 123 }
-      Then { hello.xid == 123 }
-      Then { hello.body.empty? }
-      Then { hello.to_binary == [1, 0, 0, 8, 0, 0, 0, 123].pack('C*') }
+      When(:result) { Pio::Hello.new(123) }
+
+      Then { result.ofp_version == 1 }
+      Then { result.message_type == 0 }
+      Then { result.message_length == 8 }
+      Then { result.transaction_id == 123 }
+      Then { result.xid == 123 }
+      Then { result.body.empty? }
+      Then { result.body == '' }
+      Then { result.to_binary == [1, 0, 0, 8, 0, 0, 0, 123].pack('C*') }
     end
 
-    context 'with 2**32' do
-      When(:result) { Pio::Hello.new(2**32) }
+    context 'with transaction_id: 123' do
+      When(:result) { Pio::Hello.new(transaction_id: 123) }
+
+      Then { result.ofp_version == 1 }
+      Then { result.message_type == 0 }
+      Then { result.message_length == 8 }
+      Then { result.transaction_id == 123 }
+      Then { result.xid == 123 }
+      Then { result.body.empty? }
+      Then { result.body == '' }
+      Then { result.to_binary == [1, 0, 0, 8, 0, 0, 0, 123].pack('C*') }
+    end
 
-      Then { result == Failure(ArgumentError) }
+    context 'with xid: 123' do
+      When(:result) { Pio::Hello.new(xid: 123) }
+
+      Then { result.ofp_version == 1 }
+      Then { result.message_type == 0 }
+      Then { result.message_length == 8 }
+      Then { result.transaction_id == 123 }
+      Then { result.xid == 123 }
+      Then { result.body.empty? }
+      Then { result.body == '' }
+      Then { result.to_binary == [1, 0, 0, 8, 0, 0, 0, 123].pack('C*') }
     end
 
-    context 'with transaction_id: 123' do
-      When(:hello) { Pio::Hello.new(transaction_id: 123) }
-
-      Then { hello.ofp_version == 1 }
-      Then { hello.message_type == 0 }
-      Then { hello.message_length == 8 }
-      Then { hello.transaction_id == 123 }
-      Then { hello.xid == 123 }
-      Then { hello.body.empty? }
-      Then { hello.to_binary == [1, 0, 0, 8, 0, 0, 0, 123].pack('C*') }
+    context 'with -1' do
+      When(:result) { Pio::Hello.new(-1) }
+
+      Then do
+        result ==
+          Failure(ArgumentError,
+                  'Transaction ID should be an unsigned 32-bit integer.')
+      end
     end
 
-    context 'with xid: 123' do
-      When(:hello) { Pio::Hello.new(xid: 123) }
-
-      Then { hello.ofp_version == 1 }
-      Then { hello.message_type == 0 }
-      Then { hello.message_length == 8 }
-      Then { hello.transaction_id == 123 }
-      Then { hello.xid == 123 }
-      Then { hello.body.empty? }
-      Then { hello.to_binary == [1, 0, 0, 8, 0, 0, 0, 123].pack('C*') }
+    context 'with 2**32' do
+      When(:result) { Pio::Hello.new(2**32) }
+
+      Then do
+        result ==
+          Failure(ArgumentError,
+                  'Transaction ID should be an unsigned 32-bit integer.')
+      end
     end
 
     context 'with :INVALID_ARGUMENT' do

data/spec/pio/match_spec.rb

@@ -0,0 +1,194 @@
+require 'pio/match'
+
+describe Pio::Match do
+  describe '.read' do
+    When(:match) { Pio::Match.read(binary) }
+
+    context 'with a Match binary' do
+      Given(:binary) do
+        [
+          0x00, 0x38, 0x20, 0xfe,
+          0x00, 0x01,
+          0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+          0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+          0x00, 0x00,
+          0x00,
+          0x00,
+          0x00, 0x00,
+          0x00,
+          0x00,
+          0x00, 0x00,
+          0x00, 0x00, 0x00, 0x00,
+          0x00, 0x00, 0x00, 0x00,
+          0x00, 0x00,
+          0x00, 0x00
+        ].pack('C*')
+      end
+
+      Then do
+        match.wildcards.keys == [
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src_all,
+          :nw_dst_all,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      Then { match.in_port == 1 }
+      Then { match.dl_src == '00:00:00:00:00:00' }
+      Then { match.dl_dst == '00:00:00:00:00:00' }
+      Then { match.dl_vlan == 0 }
+      Then { match.dl_vlan_pcp == 0 }
+      Then { match.dl_type == 0 }
+      Then { match.nw_tos == 0 }
+      Then { match.nw_proto == 0 }
+      Then { match.nw_src == '0.0.0.0' }
+      Then { match.nw_dst == '0.0.0.0' }
+      Then { match.tp_src == 0 }
+      Then { match.tp_dst == 0 }
+    end
+
+    context 'with a Match binary generated with Pio::Match.new' do
+      Given(:binary) { Pio::Match.new(nw_src: '192.168.1.0/24').to_binary_s }
+
+      Then do
+        match.wildcards.keys == [
+          :in_port,
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src,
+          :nw_dst_all,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      And { match.wildcards[:nw_src] = 12 }
+      Then { match.in_port == 0 }
+      Then { match.dl_src == '00:00:00:00:00:00' }
+      Then { match.dl_dst == '00:00:00:00:00:00' }
+      Then { match.dl_vlan == 0 }
+      Then { match.dl_vlan_pcp == 0 }
+      Then { match.dl_type == 0 }
+      Then { match.nw_tos == 0 }
+      Then { match.nw_proto == 0 }
+      Then { match.nw_src == '192.168.1.0' }
+      Then { match.nw_src.prefixlen == 24 }
+      Then { match.nw_dst == '0.0.0.0' }
+      Then { match.tp_src == 0 }
+      Then { match.tp_dst == 0 }
+    end
+  end
+
+  describe '.new' do
+    context 'with in_port: 1' do
+      When(:match) { Pio::Match.new(in_port: 1) }
+
+      Then do
+        match.wildcards.keys == [
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src_all,
+          :nw_dst_all,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      Then { match.in_port == 1 }
+      Then { match.dl_src == '00:00:00:00:00:00' }
+      Then { match.dl_dst == '00:00:00:00:00:00' }
+      Then { match.dl_vlan == 0 }
+      Then { match.dl_vlan_pcp == 0 }
+      Then { match.dl_type == 0 }
+      Then { match.nw_tos == 0 }
+      Then { match.nw_proto == 0 }
+      Then { match.nw_src == '0.0.0.0' }
+      Then { match.nw_dst == '0.0.0.0' }
+      Then { match.tp_src == 0 }
+      Then { match.tp_dst == 0 }
+    end
+
+    context "with nw_src: '192.168.1.0/24'" do
+      When(:match) { Pio::Match.new(nw_src: '192.168.1.0/24') }
+
+      Then do
+        match.wildcards.keys == [
+          :in_port,
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src,
+          :nw_dst_all,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      Then { match.wildcards.fetch(:nw_src) == 8 }
+      Then { match.in_port == 0 }
+      Then { match.dl_src == '00:00:00:00:00:00' }
+      Then { match.dl_dst == '00:00:00:00:00:00' }
+      Then { match.dl_vlan == 0 }
+      Then { match.dl_vlan_pcp == 0 }
+      Then { match.dl_type == 0 }
+      Then { match.nw_tos == 0 }
+      Then { match.nw_proto == 0 }
+      Then { match.nw_src == '192.168.1.0/24' }
+      Then { match.nw_dst == '0.0.0.0' }
+      Then { match.tp_src == 0 }
+      Then { match.tp_dst == 0 }
+    end
+
+    context "with nw_dst: '192.168.1.0/24'" do
+      When(:match) { Pio::Match.new(nw_dst: '192.168.1.0/24') }
+
+      Then do
+        match.wildcards.keys == [
+          :in_port,
+          :dl_vlan,
+          :dl_src,
+          :dl_dst,
+          :dl_type,
+          :nw_proto,
+          :tp_src,
+          :tp_dst,
+          :nw_src_all,
+          :nw_dst,
+          :dl_vlan_pcp,
+          :nw_tos
+        ]
+      end
+      Then { match.wildcards.fetch(:nw_dst) == 8 }
+      Then { match.in_port == 0 }
+      Then { match.dl_src == '00:00:00:00:00:00' }
+      Then { match.dl_dst == '00:00:00:00:00:00' }
+      Then { match.dl_vlan == 0 }
+      Then { match.dl_vlan_pcp == 0 }
+      Then { match.dl_type == 0 }
+      Then { match.nw_tos == 0 }
+      Then { match.nw_proto == 0 }
+      Then { match.nw_src == '0.0.0.0' }
+      Then { match.nw_dst == '192.168.1.0/24' }
+      Then { match.tp_src == 0 }
+      Then { match.tp_dst == 0 }
+    end
+  end
+end