bitn 0.0.3

Super Fast Bit Slicer

bitn.BitBin

• Super fast bitslicing.
• bitshift speed without bitwise complexity.

Install

pip install bitn

Help(BitBin)

Help on class BitBin in module bitn:

class BitBin(builtins.object)
 |  BitBin(bites)
 |  
 |  Methods defined here:
 |  
 |  __init__(self, bites)
 |      From bytes to bits
 |  
 |  as90k(self, num_bits)
 |      return bitslice as 90k time
 |  
 |  asdecodedhex(self, num_bits)
 |      return decoded hex of a bitslice
 |  
 |  asflag(self, num_bits=1)
 |      returns one bit as True or False
 |  
 |  ashex(self, num_bits)
 |      return the hex value of a bitslice
 |  
 |  asint(self, num_bits)
 |      Starting at self.idx of self.bits, slice off num_bits of bits.
 |  
 |  ----------------------------------------------------------------------

I used to do this

   from struct import unpack

    sync,two_bytes,one_byte = unpack('>BHB', packet[:4])
    tei = two_bytes >> 15 
    pusi = two_bytes >> 14 & 0x1
    ts_priority = two_bytes >>13 & 0x1
    pid = two_bytes & 0x1fff
    scramble = one_byte >>6
    afc = (one_byte & 48) >> 4
    count = one_byte & 15

Now I use bitn and do this

    from bitn import BitBin

    header= BitBin(packet[:4])
    sync=header.asint(8)
    tei=header.asflag(1)
    pusi=header.asflag(1)
    ts_priority=header.asflag(1)
    pid=header.asint(13)
    scramble=header.asint(2)
    afc=header.asint(2)
    count=header.asint(4)

Example Usage

• Parse a SCTE 35 splice information section from a hex encoded string

>>> from bitn import BitBin   


>>> bites= bytes.fromhex( 'FC302F000000000000FFFFF00506FEAEF17C4C0019021743554549480000077F9F0808000000002CA56C97110000C4876A2E')


>>> class Splice_Info_Section:    
        def __init__(self,bb):
            self.table_id =bb.ashex(8)
            self.section_syntax_indicator = bb.asflag(1)
            self.private = bb.asflag(1)
            self.reserved=bb.asint(2)
            self.section_length = bb.asint(12)
            self.protocol_version = bb.asint(8)
            self.encrypted_packet =  bb.asflag(1)
            self.encryption_algorithm =bb.asint(6)
            self.pts_adjustment = bb.as90k(33)
            self.cw_index = bb.ashex(8)
            self.tier = bb.ashex(12)
            self.splice_command_length = bb.asint(12)
            self.splice_command_type = bb.asint(8)


>>> bb=BitBin(bites)

>>> sps=Splice_Info_Section(bs)

>>> vars(sps)

{'table_id': '0xfc', 'section_syntax_indicator': False, 'private': False, 'reserved': 3, 'section_length': 47,
'protocol_version': 0, 'encrypted_packet': False, 'encryption_algorithm': 0, 'pts_adjustment': '0.000000', 
'cw_index': '0xff', 'tier': '0xfff', 'splice_command_length': 5, 'splice_command_type': 6, 'descriptor_loop_length': 25}

>>>