126 lines
4.5 KiB
Python
126 lines
4.5 KiB
Python
# -*- coding: utf-8 -*-
|
|
#
|
|
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()
|