PR for issue #674

docs/examples/disablingsignalhandlerinstallation.rst

@@ -0,0 +1,22 @@
+================================================
+Example -- Disabling signal handler installation
+================================================
+
+You have the possibility to print raised errors directly in the file descriptor specified in the ``Klein.run()`` ``logFile`` parameter, it can be useful for troubleshooting or logging fins.
+
+Below is an example of such implementation, the raised errors will be printed in ``sys.stdout`` by default :
+
+
+.. code-block:: python
+
+	from klein import route, run
+
+
+	@route("/")
+	def home(request):
+	    return "Hello, world!"
+
+
+	run("localhost", 8080, installSignalHandlers=False)
+
+This is an addition of the ``Klein.handle_errors`` method.

docs/introduction/codeexamples/helloWorldNoSignalInstallation.py

@@ -0,0 +1,9 @@
+from klein import route, run
+
+
+@route("/")
+def home(request):
+    return "Hello, world!"
+
+
+run("localhost", 8080, installSignalHandlers=False)

src/klein/_app.py

@@ -639,6 +639,7 @@ def run(
         logFile: Optional[IO] = None,
         endpoint_description: Optional[str] = None,
         displayTracebacks: bool = True,
+        installSignalHandlers: bool = True,
     ) -> None:
         """
         Run a minimal twisted.web server on the specified C{port}, bound to the
@@ -678,7 +679,7 @@ def run(
         site.displayTracebacks = displayTracebacks
 
         endpoint.listen(site)
-        reactor.run()  # type: ignore[attr-defined]
+        reactor.run(installSignalHandlers=installSignalHandlers)  # type: ignore[attr-defined]
 
 
 _globalKleinApp = Klein()