upstream/certbot
1
0
Fork 0
mirror of https://github.com/certbot/certbot.git synced 2026-04-26 16:47:40 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Fix documentation build failures (#5068)

Browse source 
* sphinxify error_handler docs
This commit is contained in:
Brad Warren 2017-08-31 16:35:53 -07:00 committed by GitHub
parent 7cb8c1264f
commit bbf397a9f9
1 changed files with 10 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
certbot/error_handler.py
View file

@ -29,18 +29,19 @@ class ErrorHandler(object):
"""Context manager for running code that must be cleaned up on failure.
The context manager allows you to register functions that will be called
when an exception (excluding SystemExit) or signal is encountered. Usage:
when an exception (excluding SystemExit) or signal is encountered.
Usage::
handler = ErrorHandler(cleanup1_func, *cleanup1_args, **cleanup1_kwargs)
handler.register(cleanup2_func, *cleanup2_args, **cleanup2_kwargs)
handler = ErrorHandler(cleanup1_func, *cleanup1_args, **cleanup1_kwargs)
handler.register(cleanup2_func, *cleanup2_args, **cleanup2_kwargs)
with handler:
do_something()
with handler:
do_something()
Or for one cleanup function:
Or for one cleanup function::
with ErrorHandler(func, args, kwargs):
do_something()
with ErrorHandler(func, args, kwargs):
do_something()
If an exception is raised out of do_something, the cleanup functions will
be called in last in first out order. Then the exception is raised.
@ -84,7 +85,7 @@ class ErrorHandler(object):
return retval
def register(self, func, *args, **kwargs):
"""Sets func to be called with *args and **kwargs during cleanup
"""Sets func to be run with the given arguments during cleanup.
:param function func: function to be called in case of an error