update markdown

Author: j2doll

python/README.md

@@ -75,6 +75,131 @@ bit_array.print()  # 비트 순서 반전 출력
 
 ---
 
+```python
+####################################
+# Unit test function
+####################################
+def runTests():
+    print("Testing BitArray class...\n")
+    
+    # Test: Constructor and clear
+    print("Test: Constructor and clear")
+    bit_array = BitArray([0b11000000], 8) # decimal 192
+    bit_array.print() # 1100 0000
+    assert bit_array.size() == 8
+    bit_array.clear()
+    assert bit_array.size() == 0
+    assert bit_array.data() == []
+    print("Passed\n")
+    
+    # Test: from_array and size
+    print("Test: from_array and size")
+    bit_array.from_array([0b11110000, 0b10101010], 16) # decimal 240, 252 
+    bit_array.print() # 1111 0000 1010 1010
+    assert bit_array.size() == 16
+    print("Passed\n")
+
+    # Test: set_bits
+    print("Test: set_bits")
+    new_bit_buffer_size = 10
+    bit_array.set_bits(new_bit_buffer_size)
+    bit_array.print() # 0000 0000 00
+    assert bit_array.size() == new_bit_buffer_size
+    assert all(bit == 0 for bit in bit_array.to_array())
+    print("Passed\n")
+
+    # Test: set_bytes
+    print("Test: set_bytes")
+    new_byte_buffer_size = 2
+    bit_array.set_bytes(new_byte_buffer_size)
+    bit_array.print() # 0000 0000 0000 0000
+    assert bit_array.size() == (new_byte_buffer_size*8)
+    assert all(bit == 0 for bit in bit_array.to_array())
+    print("Passed\n")
+
+    # Test: to_int_array
+    print("Test: to_int_array")
+    bit_array.from_array([0b10101010, 0b11001100], 16) # decimal 170, 204
+    int_array = bit_array.to_int_array()
+    print("Int Array:", int_array) # [1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 0, 0, 1, 1, 0, 0]
+    assert int_array == [ 
+        1, 0, 1, 0, 1, 0, 1, 0,
+        1, 1, 0, 0, 1, 1, 0, 0
+    ]    
+    print("Passed\n")
+
+    # Test: get
+    print("Test: get")
+    sub_array = bit_array.get(4, 8)
+    # Data   1010 1010 1100 1100 
+    # Offset 0123 4567 8901 2345
+    sub_array.print() # 1010 1100
+    assert sub_array.to_int_array() == [1, 0, 1, 0, 1, 1, 0, 0]
+    print("Passed\n")
+
+    # Test: merge
+    print("Test: merge")
+    bit_array.clear()
+    bit_array.set_bits(16)
+    merge_array = BitArray([0b11110000], 8)
+    assert bit_array.merge(merge_array, 4)
+    bit_array.print() # 0000 1111 0000 0000
+    assert bit_array.to_int_array() == [
+        0, 0, 0, 0, 
+        1, 1, 1, 1, 0, 0, 0, 0, # merge data 
+        0, 0, 0, 0
+    ]
+    print("Passed\n")
+
+    # Test: operator +
+    print("Test: operator +")
+    array1 = BitArray([0b11000000], 3) # 110
+    array2 = BitArray([0b01000000], 2) # 01 
+    combined = array1 + array2 # 110 + 01
+    combined.print() # 1100 1
+    assert combined.size() == 5
+    assert combined.to_array() == [1, 1, 0, 0, 1]
+    print("Passed\n")
+
+    combined = BitArray([0b11100000], 5)  # 이진수 1 1 1 0 0 (5 bit)
+
+    # Test: operator >>
+    print("Test: operator >>")
+    shifted_right = combined >> 2
+    shifted_right.print()
+    assert shifted_right.to_int_array() == [0, 0, 1, 1, 1]
+    print("Passed\n")
+
+    # Test: operator <<
+    print("Test: operator <<")
+    combined.print() # 11100
+    shifted_left = combined << 2  
+    shifted_left.print() # 10000
+    assert shifted_left.to_int_array() == [1, 0, 0, 0, 0]  
+    print("Passed\n")
+
+    # Test: reverser
+    print("Test: reverser")
+    reversed_array = BitArray([0b11010000, 0b10100000], 10)
+    reversed_array.print() # 1101 0000 10
+    reversed_array.reverser()
+    reversed_array.print() # 0100 0010 11
+    assert reversed_array.to_int_array() == [
+        0, 1, 0, 0,   0, 0, 1, 0,    1, 1 ] 
+    print("Passed\n")
+
+    # Test: data
+    print("Test: data")
+    byte_data = reversed_array.data()
+    print("Byte Data:", byte_data)
+    assert byte_data == [0b01000010, 0b11000000] 
+    print("Passed\n")
+
+    print("All tests passed!")
+```
+
+---
+
 ### 활용 가능 분야
 - **네트워크 프로토콜 분석**: 비트 기반의 데이터 패킷 처리.
 - **파일 포맷 해석**: 바이너리 데이터 처리.