How do I write a decorator that restores the current working directory to what it was before the decorated function was called? In other words, if I use the decorator on a function that does an os.chdir()
, the cwd will not be changed after the function is called.
5 Answers
The answer for a decorator has been given; it works at the function definition stage as requested.
With Python 2.5+, you also have an option to do that at the function call stage using a context manager:
from __future__ import with_statement # needed for 2.5 ≤ Python < 2.6
import contextlib, os
@contextlib.contextmanager
def remember_cwd():
curdir= os.getcwd()
try: yield
finally: os.chdir(curdir)
which can be used if needed at the function call time as:
print "getcwd before:", os.getcwd()
with remember_cwd():
walk_around_the_filesystem()
print "getcwd after:", os.getcwd()
It's a nice option to have.
EDIT: I added error handling as suggested by codeape. Since my answer has been voted up, it's fair to offer a complete answer, all other issues aside.
-
-
Does the error handling need an explicit try/finally? I thought the point of context managers was that MANAGER.__exit__ was always called. But then, I have never tried the decorator from contextlib, so I don't know what the issues are. Oct 21, 2011 at 6:22
-
No, it doesn't need an explicit
try/finally
, but you most probably want atry/except
clause to handle failures.– tzotOct 21, 2011 at 7:47
The path.py module (which you really should use if dealing with paths in python scripts) has a context manager:
subdir = d / 'subdir' #subdir is a path object, in the path.py module
with subdir:
# here current dir is subdir
#not anymore
(credits goes to this blog post from Roberto Alsina)
-
2If path.py is now built-in, perhaps you should answer stackoverflow.com/questions/3899761/…. Dec 27, 2012 at 0:50
-
-
I guess I misinterpreted your answer. Did you mean that the context manager is built in to path.py? (I thought you meant path.py is now built in to Python.) Dec 27, 2012 at 18:05
-
4Because Daryl Spitzer assumed that
path.py
is the same aspathlib
, you may also assume that their context managers behave in same way, but they aren't:pathlib.Path
doesn't touch CWD and instead acts as a context manager fromopen()
("closes" potentially open file descriptor).– PugsleyOct 3, 2020 at 6:25
The given answers fail to take into account that the wrapped function may raise an exception. In that case, the directory will never be restored. The code below adds exception handling to the previous answers.
as a decorator:
def preserve_cwd(function):
@functools.wraps(function)
def decorator(*args, **kwargs):
cwd = os.getcwd()
try:
return function(*args, **kwargs)
finally:
os.chdir(cwd)
return decorator
and as a context manager:
@contextlib.contextmanager
def remember_cwd():
curdir = os.getcwd()
try:
yield
finally:
os.chdir(curdir)
You dont need to write it for you. With python 3.11, the developers have written it for you. Check out their code at github.com.
import contextlib
with contextlib.chdir('/path/to/cwd/to'):
pass
def preserve_cwd(function):
def decorator(*args, **kwargs):
cwd = os.getcwd()
result = function(*args, **kwargs)
os.chdir(cwd)
return result
return decorator
Here's how it's used:
@preserve_cwd
def test():
print 'was:',os.getcwd()
os.chdir('/')
print 'now:',os.getcwd()
>>> print os.getcwd()
/Users/dspitzer
>>> test()
was: /Users/dspitzer
now: /
>>> print os.getcwd()
/Users/dspitzer
contextlib.chdir
.