contextlib
index
/usr/local/lib/python2.5/contextlib.py
Module Docs

Utilities for with-statement contexts.  See PEP 343.

 
Modules
       
sys

 
Classes
       
__builtin__.object
closing

 
class closing(__builtin__.object)
    Context to automatically close something at the end of a block.
 
Code like this:
 
    with closing(<module>.open(<arguments>)) as f:
        <block>
 
is equivalent to this:
 
    f = <module>.open(<arguments>)
    try:
        <block>
    finally:
        f.close()
 
  Methods defined here:
__enter__(self)
__exit__(self, *exc_info)
__init__(self, thing)

Data descriptors defined here:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

 
Functions
       
contextmanager(func)
@contextmanager decorator.
 
Typical usage:
 
    @contextmanager
    def some_generator(<arguments>):
        <setup>
        try:
            yield <value>
        finally:
            <cleanup>
 
This makes this:
 
    with some_generator(<arguments>) as <variable>:
        <body>
 
equivalent to this:
 
    <setup>
    try:
        <variable> = <value>
        <body>
    finally:
        <cleanup>
nested(*args, **kwds)
Support multiple context managers in a single with-statement.
 
Code like this:
 
    with nested(A, B, C) as (X, Y, Z):
        <body>
 
is equivalent to this:
 
    with A as X:
        with B as Y:
            with C as Z:
                <body>

 
Data
        __all__ = ['contextmanager', 'nested', 'closing']