bz2
index
/usr/lib/python2.4/lib-dynload/bz2.so
Module Docs

The python bz2 module provides a comprehensive interface for
the bz2 compression library. It implements a complete file
interface, one shot (de)compression functions, and types for
sequential (de)compression.

 
Classes
       
__builtin__.object
BZ2Compressor
BZ2Decompressor
BZ2File

 
class BZ2Compressor(__builtin__.object)
    BZ2Compressor([compresslevel=9]) -> compressor object
 
Create a new compressor object. This object may be used to compress
data sequentially. If you want to compress data in one shot, use the
compress() function instead. The compresslevel parameter, if given,
must be a number between 1 and 9.
 
  Methods defined here:
__delattr__(...)
x.__delattr__('name') <==> del x.name
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
compress(...)
compress(data) -> string
 
Provide more data to the compressor object. It will return chunks of
compressed data whenever possible. When you've finished providing data
to compress, call the flush() method to finish the compression process,
and return what is left in the internal buffers.
flush(...)
flush() -> string
 
Finish the compression process and return what is left in internal buffers.
You must not use the compressor object after calling this method.

Data and other attributes defined here:
__new__ = <built-in method __new__ of type object>
T.__new__(S, ...) -> a new object with type S, a subtype of T

 
class BZ2Decompressor(__builtin__.object)
    BZ2Decompressor() -> decompressor object
 
Create a new decompressor object. This object may be used to decompress
data sequentially. If you want to decompress data in one shot, use the
decompress() function instead.
 
  Methods defined here:
__delattr__(...)
x.__delattr__('name') <==> del x.name
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
decompress(...)
decompress(data) -> string
 
Provide more data to the decompressor object. It will return chunks
of decompressed data whenever possible. If you try to decompress data
after the end of stream is found, EOFError will be raised. If any data
was found after the end of stream, it'll be ignored and saved in
unused_data attribute.

Data and other attributes defined here:
__new__ = <built-in method __new__ of type object>
T.__new__(S, ...) -> a new object with type S, a subtype of T
unused_data = <member 'unused_data' of 'bz2.BZ2Decompressor' objects>

 
class BZ2File(__builtin__.object)
    BZ2File(name [, mode='r', buffering=0, compresslevel=9]) -> file object
 
Open a bz2 file. The mode can be 'r' or 'w', for reading (default) or
writing. When opened for writing, the file will be created if it doesn't
exist, and truncated otherwise. If the buffering argument is given, 0 means
unbuffered, and larger numbers specify the buffer size. If compresslevel
is given, must be a number between 1 and 9.
 
Add a 'U' to mode to open the file for input with universal newline
support. Any line ending in the input file will be seen as a '\n' in
Python. Also, a file so opened gains the attribute 'newlines'; the value
for this attribute is one of None (no newline read yet), '\r', '\n',
'\r\n' or a tuple containing all the newline types seen. Universal
newlines are available only when reading.
 
  Methods defined here:
__delattr__(...)
x.__delattr__('name') <==> del x.name
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature
__iter__(...)
x.__iter__() <==> iter(x)
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
close(...)
close() -> None or (perhaps) an integer
 
Close the file. Sets data attribute .closed to true. A closed file
cannot be used for further I/O operations. close() may be called more
than once without error.
next(...)
x.next() -> the next value, or raise StopIteration
read(...)
read([size]) -> string
 
Read at most size uncompressed bytes, returned as a string. If the size
argument is negative or omitted, read until EOF is reached.
readline(...)
readline([size]) -> string
 
Return the next line from the file, as a string, retaining newline.
A non-negative size argument will limit the maximum number of bytes to
return (an incomplete line may be returned then). Return an empty
string at EOF.
readlines(...)
readlines([size]) -> list
 
Call readline() repeatedly and return a list of lines read.
The optional size argument, if given, is an approximate bound on the
total number of bytes in the lines returned.
seek(...)
seek(offset [, whence]) -> None
 
Move to new file position. Argument offset is a byte count. Optional
argument whence defaults to 0 (offset from start of file, offset
should be >= 0); other values are 1 (move relative to current position,
positive or negative), and 2 (move relative to end of file, usually
negative, although many platforms allow seeking beyond the end of a file).
 
Note that seeking of bz2 files is emulated, and depending on the parameters
the operation may be extremely slow.
tell(...)
tell() -> int
 
Return the current file position, an integer (may be a long integer).
write(...)
write(data) -> None
 
Write the 'data' string to file. Note that due to buffering, close() may
be needed before the file on disk reflects the data written.
writelines(...)
writelines(sequence_of_strings) -> None
 
Write the sequence of strings to the file. Note that newlines are not
added. The sequence can be any iterable object producing strings. This is
equivalent to calling write() for each string.
xreadlines(...)
xreadlines() -> self
 
For backward compatibility. BZ2File objects now include the performance
optimizations previously implemented in the xreadlines module.

Data and other attributes defined here:
__new__ = <built-in method __new__ of type object>
T.__new__(S, ...) -> a new object with type S, a subtype of T
closed = <attribute 'closed' of 'bz2.BZ2File' objects>
True if the file is closed
mode = <attribute 'mode' of 'bz2.BZ2File' objects>
file mode ('r', 'w', or 'U')
name = <attribute 'name' of 'bz2.BZ2File' objects>
file name
newlines = <attribute 'newlines' of 'bz2.BZ2File' objects>
end-of-line convention used in this file
softspace = <member 'softspace' of 'bz2.BZ2File' objects>
flag indicating that a space needs to be printed; used by print

 
Functions
       
compress(...)
compress(data [, compresslevel=9]) -> string
 
Compress data in one shot. If you want to compress data sequentially,
use an instance of BZ2Compressor instead. The compresslevel parameter, if
given, must be a number between 1 and 9.
decompress(...)
decompress(data) -> decompressed data
 
Decompress data in one shot. If you want to decompress data sequentially,
use an instance of BZ2Decompressor instead.

 
Data
        __author__ = 'The bz2 python module was written by:\n\n Gustavo Niemeyer <gustavo@niemeyer.net>\n'

 
Author
        The bz2 python module was written by:
 
    Gustavo Niemeyer <gustavo@niemeyer.net>