jpayne@69: """Python 'hex_codec' Codec - 2-digit hex content transfer encoding.
jpayne@69: 
jpayne@69: This codec de/encodes from bytes to bytes.
jpayne@69: 
jpayne@69: Written by Marc-Andre Lemburg (mal@lemburg.com).
jpayne@69: """
jpayne@69: 
jpayne@69: import codecs
jpayne@69: import binascii
jpayne@69: 
jpayne@69: ### Codec APIs
jpayne@69: 
jpayne@69: def hex_encode(input, errors='strict'):
jpayne@69:     assert errors == 'strict'
jpayne@69:     return (binascii.b2a_hex(input), len(input))
jpayne@69: 
jpayne@69: def hex_decode(input, errors='strict'):
jpayne@69:     assert errors == 'strict'
jpayne@69:     return (binascii.a2b_hex(input), len(input))
jpayne@69: 
jpayne@69: class Codec(codecs.Codec):
jpayne@69:     def encode(self, input, errors='strict'):
jpayne@69:         return hex_encode(input, errors)
jpayne@69:     def decode(self, input, errors='strict'):
jpayne@69:         return hex_decode(input, errors)
jpayne@69: 
jpayne@69: class IncrementalEncoder(codecs.IncrementalEncoder):
jpayne@69:     def encode(self, input, final=False):
jpayne@69:         assert self.errors == 'strict'
jpayne@69:         return binascii.b2a_hex(input)
jpayne@69: 
jpayne@69: class IncrementalDecoder(codecs.IncrementalDecoder):
jpayne@69:     def decode(self, input, final=False):
jpayne@69:         assert self.errors == 'strict'
jpayne@69:         return binascii.a2b_hex(input)
jpayne@69: 
jpayne@69: class StreamWriter(Codec, codecs.StreamWriter):
jpayne@69:     charbuffertype = bytes
jpayne@69: 
jpayne@69: class StreamReader(Codec, codecs.StreamReader):
jpayne@69:     charbuffertype = bytes
jpayne@69: 
jpayne@69: ### encodings module API
jpayne@69: 
jpayne@69: def getregentry():
jpayne@69:     return codecs.CodecInfo(
jpayne@69:         name='hex',
jpayne@69:         encode=hex_encode,
jpayne@69:         decode=hex_decode,
jpayne@69:         incrementalencoder=IncrementalEncoder,
jpayne@69:         incrementaldecoder=IncrementalDecoder,
jpayne@69:         streamwriter=StreamWriter,
jpayne@69:         streamreader=StreamReader,
jpayne@69:         _is_text_encoding=False,
jpayne@69:     )