summaryrefslogtreecommitdiffstats
path: root/Lib/encodings/hex_codec.py
diff options
context:
space:
mode:
Diffstat (limited to 'Lib/encodings/hex_codec.py')
-rw-r--r--Lib/encodings/hex_codec.py61
1 files changed, 43 insertions, 18 deletions
diff --git a/Lib/encodings/hex_codec.py b/Lib/encodings/hex_codec.py
index 9fb1072..154488c 100644
--- a/Lib/encodings/hex_codec.py
+++ b/Lib/encodings/hex_codec.py
@@ -1,28 +1,53 @@
-"""Python 'hex_codec' Codec - 2-digit hex content transfer encoding.
+""" Python 'hex_codec' Codec - 2-digit hex content transfer encoding
-This codec de/encodes from bytes to bytes.
+ Unlike most of the other codecs which target Unicode, this codec
+ will return Python string objects for both encode and decode.
-Written by Marc-Andre Lemburg (mal@lemburg.com).
-"""
+ Written by Marc-Andre Lemburg (mal@lemburg.com).
-import codecs
-import binascii
+"""
+import codecs, binascii
### Codec APIs
-def hex_encode(input, errors='strict'):
+def hex_encode(input,errors='strict'):
+
+ """ Encodes the object input and returns a tuple (output
+ object, length consumed).
+
+ errors defines the error handling to apply. It defaults to
+ 'strict' handling which is the only currently supported
+ error handling for this codec.
+
+ """
assert errors == 'strict'
- return (binascii.b2a_hex(input), len(input))
+ output = binascii.b2a_hex(input)
+ return (output, len(input))
-def hex_decode(input, errors='strict'):
+def hex_decode(input,errors='strict'):
+
+ """ Decodes the object input and returns a tuple (output
+ object, length consumed).
+
+ input must be an object which provides the bf_getreadbuf
+ buffer slot. Python strings, buffer objects and memory
+ mapped files are examples of objects providing this slot.
+
+ errors defines the error handling to apply. It defaults to
+ 'strict' handling which is the only currently supported
+ error handling for this codec.
+
+ """
assert errors == 'strict'
- return (binascii.a2b_hex(input), len(input))
+ output = binascii.a2b_hex(input)
+ return (output, len(input))
class Codec(codecs.Codec):
- def encode(self, input, errors='strict'):
- return hex_encode(input, errors)
- def decode(self, input, errors='strict'):
- return hex_decode(input, errors)
+
+ def encode(self, input,errors='strict'):
+ return hex_encode(input,errors)
+ def decode(self, input,errors='strict'):
+ return hex_decode(input,errors)
class IncrementalEncoder(codecs.IncrementalEncoder):
def encode(self, input, final=False):
@@ -34,11 +59,11 @@ class IncrementalDecoder(codecs.IncrementalDecoder):
assert self.errors == 'strict'
return binascii.a2b_hex(input)
-class StreamWriter(Codec, codecs.StreamWriter):
- charbuffertype = bytes
+class StreamWriter(Codec,codecs.StreamWriter):
+ pass
-class StreamReader(Codec, codecs.StreamReader):
- charbuffertype = bytes
+class StreamReader(Codec,codecs.StreamReader):
+ pass
### encodings module API