How do I write a null (no-op) contextmanager in Python?

PythonContextmanager

Python Problem Overview


Sometimes I need a dummy context manager that does nothing. It can then be used as a stand-in for a more useful, but optional, context manager. For example:

ctx_mgr = <meaningfulContextManager> if <condition> else <nullContextManager>
with ctx_mgr:
    ...

How do I define such a trivial, empty context manager? Does the Python library offer one off the shelf?

How about cases where we want the context to be used with an as clause?

with ctx_mgr as resource:
    <operations on resource>

Python Solutions


Solution 1 - Python

Python 3.7 and above: use contextlib.nullcontext, specifically designed for this reason.

Before Python 3.7, the standard library does not offer a context manager specifically designed for these use cases, but there are some workarounds.

Since Python 3.4, contextlib.suppress can be used for that purpose in the first case, i.e. when there is no as clause:

ctx_mgr = <meaningfulContextManager> if <condition> else contextlib.suppress()

with ctx_mgr:
    ...

Since Python 3.3, a similar work-around is also available, contextlib.ExitStack, albeit slower than suppress (it takes twice as long in my tests).

Before Python 3.3, or in case you need an as clause before Python 3.7, developers need to roll their own. Here is one possible implementation (see note at the bottom, but all errors are mine):

class NullContextManager(object):
    def __init__(self, dummy_resource=None):
        self.dummy_resource = dummy_resource
    def __enter__(self):
        return self.dummy_resource
    def __exit__(self, *args):
        pass

One can then write:

ctx_mgr = <meaningfulContextManager> if <condition> else NullContextManager(dummy_resource)

with ctx_mgr as resource:
    <operations on resource>

Of course, dummy_resource will need to support all operations required of the "meaningful" resource. So for example, if the meaningful context manager, on __enter__(), returns something that is made to quack() inside the managed block, dummy_resource will also need to support that, albeit possibly without doing anything at all.

class DummyDuck(object):
    def quack()
        # Ssssh...
        pass

ctx_mgr = <meaningfulContextManager> if <condition> else NullContextManager(DummyDuck())

with ctx_mgr as someDuck:
    someDuck.quack()

Source: A Python feature request. Many thanks to all those who contributed to that discussion. This is my attempt at summarising its outcome in a self-answered question, to save people time reading that long thread. Also see Python documentation's mention of this use of ExitStack.

Solution 2 - Python

A simple solution for Python 3.6 and below, including 2.7:

from contextlib import contextmanager

@contextmanager
def nullcontext(enter_result=None):
    yield enter_result

Since Python 3.7 you should use the provided contextlib.nullcontext instead.

Solution 3 - Python

Since Python 3.2, memoryview(b'') can be use as a no-op context manager. See https://docs.python.org/3/library/stdtypes.html#memoryview.release.

Pros

  • No imports required

  • Works on 3.2+

  • Roughly twice as fast as contextlib.nullcontext

Cons

  • You probably want to add a # no-op comment.

Solution 4 - Python

Simple solution for Python 2.7, not yet mentioned in the answers:

from contextlib import nested
with nested():
    ...

Solution 5 - Python

For Python 2.7+ , you can use

import contextlib
with (lambda noop_func: contextlib.contextmanager(noop_func))(lambda: (yield))():
    print("hi")

Solution 6 - Python

I just used threading.Lock() as a dummy context manager. Temporary lock, only used by the context manager.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionJulianView Question on Stackoverflow
Solution 1 - PythonJulianView Answer on Stackoverflow
Solution 2 - PythonMartin ValgurView Answer on Stackoverflow
Solution 3 - PythonHuazuo GaoView Answer on Stackoverflow
Solution 4 - PythonDmitry ShintyakovView Answer on Stackoverflow
Solution 5 - PythoncowlinatorView Answer on Stackoverflow
Solution 6 - PythonDan DebrunnerView Answer on Stackoverflow