changelog for 5.0

Author: minrk

docs/changelog.rst

@@ -4,6 +4,50 @@
 Changes in Jupyter Client
 =========================
 
+5.0
+===
+
+5.0.0
+-----
+
+`5.0.0 on GitHub <https://github.com/jupyter/jupyter_client/milestones/5.0>`__
+
+New features:
+
+- Introduce :command:`jupyter run` command for running scripts with a kernel, for instance::
+
+    jupyter run --kernel python3 myscript.py
+
+- New method :meth:`.BlockingKernelClient.execute_interactive`
+  for running code and capturing or redisplaying its output.
+- New ``KernelManager.shutdown_wait_time`` configurable for adjusting the time
+  for a kernel manager to wait after politely requesting shutdown
+  before it resorts to forceful termination.
+
+Fixes:
+
+- Set sticky bit on connection-file directory to avoid getting cleaned up.
+- :func:`jupyter_client.launcher.launch_kernel` passes through additional options to the underlying Popen,
+  matching :meth:`KernelManager.start_kernel`.
+- Check types of ``buffers`` argument in :meth:`.Session.send`,
+  so that TypeErrors are raised immediately,
+  rather than in the eventloop.
+
+Changes:
+
+- In kernelspecs, if the executable is the string ``python`` (as opposed to an absolute path),
+  ``sys.executable`` will be used rather than resolving ``python`` on PATH.
+  This should enable Python-based kernels to install kernelspecs as part of wheels.
+- kernelspec names are now validated.
+  They should only include ascii letters and numbers, plus period, hyphen, and underscore.
+
+Backward-incompatible changes:
+
+- :py:class:`.datetime` objects returned in parsed messages are now always timezone-aware.
+  Timestamps in messages without timezone info are interpreted as the local timezone,
+  as this was the behavior in earlier versions.
+
+
 4.4
 ===