How "with" is better than try/catch to open a file in Python?
In the example you give, it's not better. It's best practice to catch exceptions as close to the point they're thrown to avoid catching unrelated exceptions of the same type.
try:
file = open(...)
except OpenErrors...:
# handle open exceptions
else:
try:
# do stuff with file
finally:
file.close()
As unfortunately verbose as this is, the with
statement doesn't allow you to catch exceptions thrown during its evaluation. There was a suggestion to add exception handling to this effect on the mailing list:
with open(...) as file:
# do stuff with file
except OpenErrors...:
# handle open exceptions
But this was shot down.
Finally it's worth noting that you can directly enter and exit context managers like so:
file = open(...).__enter__()
file.__exit__(typ, val, tb)
This is described in more detail here and here.
As a general guideline, with
statements excel for cases where exceptions are not expected, and the default "enter/open/acquire" behaviour is adequate. Examples include required files, and simple locking.
It is for resource management ... not for how you react to an exception otherwise :)
There is no way to "forget" f.close()
when using with
. In this manner it serves the same role as using
in C#.
Happy coding.
For a start, it helps prevent the problem you've introduced in your try ... finally ...
example.
The way you've structured it, if an exception is thrown while trying to open the file then you will never bind an open file to the name f
, leading to either a NameError
in the finally
clause (if f
has never been bound within scope) or something entirely unexpected (if it has).
The correct structure (equivalent to the with
) is:
f = open(my_file)
try:
do_stuff_that_fails()
finally:
f.close()
(note - no need for an except
clause if you've got nothing to do there).
Your second example similarly is wrong, and should be structured like:
try:
f = open(my_file)
try:
do_stuff_that_fails()
except EXPECTED_EXCEPTION_TYPES as e:
do_stuff_when_it_doesnt_work()
finally:
f.close()
except (IOError, OSError) as e:
do_other_stuff_when_it_we_have_file_IO_problems()
The second is (as stated in another answer) that you can't forget to call f.close()
.
BTW, the term is "context management", not "resource management" - the with
statement manages contexts, some of which may be resources, but others not. For example, it's also used with decimal
to establish a decimal context for a particular block of code.
Finally (responding to your comment to the previous answer) you should never rely on refcount semantics for handling resources in Python. Jython, IronPython and PyPy all have non-refcount semantics, and there's nothing preventing CPython from going the other way (though it's highly unlikely for the immediate future). In a tight loop (e.g. os.walk
) it is very very easy to run out of file handles if code relying on refcount semantics is run on a VM with different behaviour.