twos 0.0.1

Interpreting integer bit patterns as two's complement or unsigned representation

twos

Converting between two's complement and unsigned integer interpretation (i.e. sum of powers of two) of integer bit patterns.

Installation

twos is available on pypi:

pip install twos

Example

Basic usage example (can be found in examples/convert.py):

from twos import to_signed, to_unsigned

bit_width = 8
x = 170 # 0b10101010
pattern = f"{x:b}"

y = to_signed(value=x, bit_width=bit_width)
print(f"Interpreting {pattern} as {bit_width}-bit two's complement: {y}")

z = to_unsigned(value=y, bit_width=bit_width)
print(f"Interpreting {pattern} as {bit_width}-bit unsigned integer: {z}")

Output:

Interpreting 10101010 as 8-bit two's complement: -86
Interpreting 10101010 as 8-bit unsigned integer: 170