summaryrefslogtreecommitdiffstats
path: root/Lib/encodings/zlib_codec.py
diff options
context:
space:
mode:
Diffstat (limited to 'Lib/encodings/zlib_codec.py')
-rw-r--r--Lib/encodings/zlib_codec.py50
1 files changed, 38 insertions, 12 deletions
diff --git a/Lib/encodings/zlib_codec.py b/Lib/encodings/zlib_codec.py
index 95908a4..0c2599d 100644
--- a/Lib/encodings/zlib_codec.py
+++ b/Lib/encodings/zlib_codec.py
@@ -1,24 +1,50 @@
-"""Python 'zlib_codec' Codec - zlib compression encoding.
+""" Python 'zlib_codec' Codec - zlib compression 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 zlib # this codec needs the optional zlib module !
### Codec APIs
-def zlib_encode(input, errors='strict'):
+def zlib_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 (zlib.compress(input), len(input))
+ output = zlib.compress(input)
+ return (output, len(input))
-def zlib_decode(input, errors='strict'):
+def zlib_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 (zlib.decompress(input), len(input))
+ output = zlib.decompress(input)
+ return (output, len(input))
class Codec(codecs.Codec):
+
def encode(self, input, errors='strict'):
return zlib_encode(input, errors)
def decode(self, input, errors='strict'):
@@ -56,11 +82,11 @@ class IncrementalDecoder(codecs.IncrementalDecoder):
def reset(self):
self.decompressobj = zlib.decompressobj()
-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