Docstrings in the latest fashion.

codejail/jail_code.py

@@ -27,7 +27,8 @@ COMMANDS = {}
 
 
 def configure(command, bin_path, user=None):
-    """Configure a command for `jail_code` to use.
+    """
+    Configure a command for `jail_code` to use.
 
     `command` is the abstract command you're configuring, such as "python" or
     "node".  `bin_path` is the path to the binary.  `user`, if provided, is
@@ -47,7 +48,8 @@ def configure(command, bin_path, user=None):
 
 
 def is_configured(command):
-    """Has `jail_code` been configured for `command`?
+    """
+    Has `jail_code` been configured for `command`?
 
     Returns true if the abstract command `command` has been configured for use
     in the `jail_code` function.
@@ -63,13 +65,16 @@ if hasattr(sys, 'real_prefix'):
 
 
 class JailResult(object):
-    """A passive object for us to return from jail_code."""
+    """
+    A passive object for us to return from jail_code.
+    """
     def __init__(self):
         self.stdout = self.stderr = self.status = None
 
 
 def jail_code(command, code=None, files=None, argv=None, stdin=None):
-    """Run code in a jailed subprocess.
+    """
+    Run code in a jailed subprocess.
 
     `command` is an abstract command ("python", "node", ...) that must have
     been configured using `configure`.

codejail/safe_exec.py

@@ -14,7 +14,8 @@ log = logging.getLogger(__name__)
 
 
 class SafeExecException(Exception):
-    """Python code running in the sandbox has failed.
+    """
+    Python code running in the sandbox has failed.
 
     The message will be the stdout of the sandboxed process, which will usually
     contain the original exception message.
@@ -24,7 +25,8 @@ class SafeExecException(Exception):
 
 
 def safe_exec(code, globals_dict, files=None, python_path=None):
-    """Execute code as "exec" does, but safely.
+    """
+    Execute code as "exec" does, but safely.
 
     `code` is a string of Python code.  `globals_dict` is used as the globals
     during execution.  Modifications the code makes to `globals_dict` are
@@ -105,7 +107,8 @@ def safe_exec(code, globals_dict, files=None, python_path=None):
 
 
 def json_safe(d):
-    """Return only the JSON-safe part of d.
+    """
+    Return only the JSON-safe part of d.
 
     Used to emulate reading data through a serialization straw.
 
@@ -128,7 +131,8 @@ def json_safe(d):
 
 
 def not_safe_exec(code, globals_dict, files=None, python_path=None):
-    """Another implementation of `safe_exec`, but not safe.
+    """
+    Another implementation of `safe_exec`, but not safe.
 
     This can be swapped in for debugging problems in sandboxed Python code.