|
|
|
|
|
|
|
|
import unittest |
|
|
|
|
|
from websocket._abnf import ABNF, frame_buffer |
|
|
from websocket._exceptions import WebSocketProtocolException |
|
|
|
|
|
""" |
|
|
test_abnf.py |
|
|
websocket - WebSocket client library for Python |
|
|
|
|
|
Copyright 2024 engn33r |
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); |
|
|
you may not use this file except in compliance with the License. |
|
|
You may obtain a copy of the License at |
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0 |
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software |
|
|
distributed under the License is distributed on an "AS IS" BASIS, |
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
|
See the License for the specific language governing permissions and |
|
|
limitations under the License. |
|
|
""" |
|
|
|
|
|
|
|
|
class ABNFTest(unittest.TestCase): |
|
|
def test_init(self): |
|
|
a = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING) |
|
|
self.assertEqual(a.fin, 0) |
|
|
self.assertEqual(a.rsv1, 0) |
|
|
self.assertEqual(a.rsv2, 0) |
|
|
self.assertEqual(a.rsv3, 0) |
|
|
self.assertEqual(a.opcode, 9) |
|
|
self.assertEqual(a.data, "") |
|
|
a_bad = ABNF(0, 1, 0, 0, opcode=77) |
|
|
self.assertEqual(a_bad.rsv1, 1) |
|
|
self.assertEqual(a_bad.opcode, 77) |
|
|
|
|
|
def test_validate(self): |
|
|
a_invalid_ping = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING) |
|
|
self.assertRaises( |
|
|
WebSocketProtocolException, |
|
|
a_invalid_ping.validate, |
|
|
skip_utf8_validation=False, |
|
|
) |
|
|
a_bad_rsv_value = ABNF(0, 1, 0, 0, opcode=ABNF.OPCODE_TEXT) |
|
|
self.assertRaises( |
|
|
WebSocketProtocolException, |
|
|
a_bad_rsv_value.validate, |
|
|
skip_utf8_validation=False, |
|
|
) |
|
|
a_bad_opcode = ABNF(0, 0, 0, 0, opcode=77) |
|
|
self.assertRaises( |
|
|
WebSocketProtocolException, |
|
|
a_bad_opcode.validate, |
|
|
skip_utf8_validation=False, |
|
|
) |
|
|
a_bad_close_frame = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01") |
|
|
self.assertRaises( |
|
|
WebSocketProtocolException, |
|
|
a_bad_close_frame.validate, |
|
|
skip_utf8_validation=False, |
|
|
) |
|
|
a_bad_close_frame_2 = ABNF( |
|
|
0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01\x8a\xaa\xff\xdd" |
|
|
) |
|
|
self.assertRaises( |
|
|
WebSocketProtocolException, |
|
|
a_bad_close_frame_2.validate, |
|
|
skip_utf8_validation=False, |
|
|
) |
|
|
a_bad_close_frame_3 = ABNF( |
|
|
0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x03\xe7" |
|
|
) |
|
|
self.assertRaises( |
|
|
WebSocketProtocolException, |
|
|
a_bad_close_frame_3.validate, |
|
|
skip_utf8_validation=True, |
|
|
) |
|
|
|
|
|
def test_mask(self): |
|
|
abnf_none_data = ABNF( |
|
|
0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data=None |
|
|
) |
|
|
bytes_val = b"aaaa" |
|
|
self.assertEqual(abnf_none_data._get_masked(bytes_val), bytes_val) |
|
|
abnf_str_data = ABNF( |
|
|
0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data="a" |
|
|
) |
|
|
self.assertEqual(abnf_str_data._get_masked(bytes_val), b"aaaa\x00") |
|
|
|
|
|
def test_format(self): |
|
|
abnf_bad_rsv_bits = ABNF(2, 0, 0, 0, opcode=ABNF.OPCODE_TEXT) |
|
|
self.assertRaises(ValueError, abnf_bad_rsv_bits.format) |
|
|
abnf_bad_opcode = ABNF(0, 0, 0, 0, opcode=5) |
|
|
self.assertRaises(ValueError, abnf_bad_opcode.format) |
|
|
abnf_length_10 = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_TEXT, data="abcdefghij") |
|
|
self.assertEqual(b"\x01", abnf_length_10.format()[0].to_bytes(1, "big")) |
|
|
self.assertEqual(b"\x8a", abnf_length_10.format()[1].to_bytes(1, "big")) |
|
|
self.assertEqual("fin=0 opcode=1 data=abcdefghij", abnf_length_10.__str__()) |
|
|
abnf_length_20 = ABNF( |
|
|
0, 0, 0, 0, opcode=ABNF.OPCODE_BINARY, data="abcdefghijabcdefghij" |
|
|
) |
|
|
self.assertEqual(b"\x02", abnf_length_20.format()[0].to_bytes(1, "big")) |
|
|
self.assertEqual(b"\x94", abnf_length_20.format()[1].to_bytes(1, "big")) |
|
|
abnf_no_mask = ABNF( |
|
|
0, 0, 0, 0, opcode=ABNF.OPCODE_TEXT, mask_value=0, data=b"\x01\x8a\xcc" |
|
|
) |
|
|
self.assertEqual(b"\x01\x03\x01\x8a\xcc", abnf_no_mask.format()) |
|
|
|
|
|
def test_frame_buffer(self): |
|
|
fb = frame_buffer(0, True) |
|
|
self.assertEqual(fb.recv, 0) |
|
|
self.assertEqual(fb.skip_utf8_validation, True) |
|
|
fb.clear |
|
|
self.assertEqual(fb.header, None) |
|
|
self.assertEqual(fb.length, None) |
|
|
self.assertEqual(fb.mask_value, None) |
|
|
self.assertEqual(fb.has_mask(), False) |
|
|
|
|
|
|
|
|
if __name__ == "__main__": |
|
|
unittest.main() |
|
|
|
