bokeh 3.10.0.dev8__tar.gz → 3.10.0.dev9__tar.gz

{bokeh-3.10.0.dev8/src/bokeh.egg-info → bokeh-3.10.0.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bokeh
-Version: 3.10.0.dev8
+Version: 3.10.0.dev9
 Summary: Interactive plots and applications in the browser from Python
 Author: Bokeh Team
 Author-email: info@bokeh.org

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/pyproject.toml

@@ -170,7 +170,7 @@ lint.exclude = [
     'node_modules',
 ]
 lint.per-file-ignores = {"__init__.py" = ["F403"]}
-lint.select = ["B", "COM", "E", "F", "NPY", "RUF", "TID", "UP", "W"]
+lint.select = ["B", "COM", "E", "F", "NPY", "PLC0414", "RUF", "TID", "UP", "W"]
 lint.ignore = [
     'B005', # Using .strip() with multi-character strings is misleading the reader
     'B006', # Do not use mutable data structures for argument defaults

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/application/application.py

@@ -43,9 +43,8 @@ from ..document import Document
 from ..settings import settings
 
 if TYPE_CHECKING:
-    from tornado.httputil import HTTPServerRequest
-
     from ..core.types import ID
+    from ..server.request import RequestLike
     from ..server.session import ServerSession
     from .handlers.handler import Handler
 
@@ -74,10 +73,8 @@ class Application:
 
     '''
 
-    # This is so that bokeh.io.show can check if a passed in object is an
-    # Application without having to import Application directly. This module
-    # depends on tornado and we have made a commitment that "basic" modules
-    # will function without bringing in tornado.
+    # This lets bokeh.io.show identify an Application without importing the
+    # application and server-facing modules solely for an isinstance check.
     _is_a_bokeh_application_class: ClassVar[bool] = True
 
     _static_path: str | None
@@ -245,7 +242,7 @@ class Application:
             await h.on_session_destroyed(session_context)
         return None
 
-    def process_request(self, request: HTTPServerRequest) -> dict[str, Any]:
+    def process_request(self, request: RequestLike) -> dict[str, Any]:
         ''' Processes incoming HTTP request returning a dictionary of
         additional data to add to the session_context.
 

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/application/handlers/code.py

@@ -48,7 +48,7 @@ from typing import (
 
 # Bokeh imports
 from ...io.doc import curdoc, patch_curdoc
-from .code_runner import CodeRunner
+from .code_runner import CodeRunner, _hold_process_globals
 from .handler import Handler
 
 if TYPE_CHECKING:
@@ -163,9 +163,8 @@ class CodeHandler(Handler):
         # paths to custom models resolver.
         doc.modules.add(module)
 
-        with _monkeypatch_io(self._loggers):
-            with patch_curdoc(doc):
-                self._runner.run(module, self._make_post_doc_check(doc))
+        with patch_curdoc(doc), _hold_process_globals(), _monkeypatch_io(self._loggers):
+            self._runner.run(module, self._make_post_doc_check(doc))
 
     def url_path(self) -> str | None:
         ''' The last path component for the basename of the configured filename.

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/application/handlers/code_runner.py

@@ -25,8 +25,10 @@ log = logging.getLogger(__name__)
 import os
 import sys
 import traceback
+from contextlib import contextmanager
 from os.path import basename
-from typing import TYPE_CHECKING, Callable
+from threading import RLock
+from typing import TYPE_CHECKING, Callable, Generator
 
 # Bokeh imports
 from ...util.serialization import make_globally_unique_id
@@ -218,36 +220,48 @@ class CodeRunner:
                 are not met after code execution.
 
         '''
-        # Simulate the sys.path behaviour described here:
-        #
-        # https://docs.python.org/2/library/sys.html#sys.path
-        _cwd = os.getcwd()
-        _sys_path = list(sys.path)
-        _sys_argv = list(sys.argv)
-        sys.path.insert(0, os.path.dirname(self._path))
-        sys.argv = [os.path.basename(self._path), *self._argv]
-
         # XXX: self._code shouldn't be None at this point but types don't reflect this
         assert self._code is not None
 
-        try:
-            exec(self._code, module.__dict__)
+        with _hold_process_globals(), _patch_process_state(self._path, self._argv):
+            try:
+                exec(self._code, module.__dict__)
 
-            if post_check:
-                post_check()
-        except Exception as e:
-            handle_exception(self, e)
-        finally:
-            # undo sys.path, CWD fixups
-            os.chdir(_cwd)
-            sys.path = _sys_path
-            sys.argv = _sys_argv
-            self.ran = True
+                if post_check:
+                    post_check()
+            except Exception as e:
+                handle_exception(self, e)
+            finally:
+                self.ran = True
 
 #-----------------------------------------------------------------------------
 # Private API
 #-----------------------------------------------------------------------------
 
+_PROCESS_GLOBALS_LOCK = RLock()
+
+@contextmanager
+def _hold_process_globals() -> Generator[None, None, None]:
+    with _PROCESS_GLOBALS_LOCK:
+        yield
+
+@contextmanager
+def _patch_process_state(path: PathLike, argv: list[str]) -> Generator[None, None, None]:
+    # Simulate the sys.path behaviour described here:
+    #
+    # https://docs.python.org/2/library/sys.html#sys.path
+    old_cwd = os.getcwd()
+    old_sys_path = list(sys.path)
+    old_sys_argv = list(sys.argv)
+    sys.path.insert(0, os.path.dirname(path))
+    sys.argv = [os.path.basename(path), *argv]
+    try:
+        yield
+    finally:
+        os.chdir(old_cwd)
+        sys.path = old_sys_path
+        sys.argv = old_sys_argv
+
 #-----------------------------------------------------------------------------
 # Code
 #-----------------------------------------------------------------------------

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/application/handlers/directory.py

@@ -71,10 +71,9 @@ from .server_request_handler import ServerRequestHandler
 if TYPE_CHECKING:
     from types import ModuleType
 
-    from tornado.httputil import HTTPServerRequest
-
     from ...core.types import PathLike
     from ...document import Document
+    from ...server.request import RequestLike
     from ...themes import Theme
     from ..application import ServerContext, SessionContext
 
@@ -290,7 +289,7 @@ class DirectoryHandler(Handler):
         '''
         await self._lifecycle_handler.on_session_destroyed(session_context)
 
-    def process_request(self, request: HTTPServerRequest) -> dict[str, Any]:
+    def process_request(self, request: RequestLike) -> dict[str, Any]:
         ''' Processes incoming HTTP request returning a dictionary of
         additional data to add to the session_context.
 

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/application/handlers/handler.py

@@ -49,9 +49,8 @@ import traceback
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    from tornado.httputil import HTTPServerRequest
-
     from ...document import Document
+    from ...server.request import RequestLike
     from ..application import ServerContext, SessionContext
     from .code_runner import CodeRunner
 
@@ -193,7 +192,7 @@ class Handler:
         '''
         pass
 
-    def process_request(self, request: HTTPServerRequest) -> dict[str, Any]:
+    def process_request(self, request: RequestLike) -> dict[str, Any]:
         ''' Processes incoming HTTP request returning a dictionary of
         additional data to add to the session_context.
 

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/application/handlers/request_handler.py

@@ -28,7 +28,7 @@ from typing import TYPE_CHECKING, Any, Callable
 from .handler import Handler
 
 if TYPE_CHECKING:
-    from tornado.httputil import HTTPServerRequest
+    from ...server.request import RequestLike
 
 #-----------------------------------------------------------------------------
 # Globals and constants
@@ -51,7 +51,7 @@ class RequestHandler(Handler):
 
     '''
 
-    _process_request: Callable[[HTTPServerRequest], dict[str, Any]]
+    _process_request: Callable[[RequestLike], dict[str, Any]]
 
     def __init__(self) -> None:
         super().__init__()
@@ -59,7 +59,7 @@ class RequestHandler(Handler):
 
     # Public methods ----------------------------------------------------------
 
-    def process_request(self, request: HTTPServerRequest) -> dict[str, Any]:
+    def process_request(self, request: RequestLike) -> dict[str, Any]:
         ''' Processes incoming HTTP request returning a dictionary of
         additional data to add to the session_context.
 
@@ -80,7 +80,7 @@ class RequestHandler(Handler):
 # Private API
 #-----------------------------------------------------------------------------
 
-def _return_empty(request: HTTPServerRequest) -> dict[str, Any]:
+def _return_empty(request: RequestLike) -> dict[str, Any]:
     return {}
 
 #-----------------------------------------------------------------------------

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/client/session.py

@@ -34,7 +34,12 @@ log = logging.getLogger(__name__)
 #-----------------------------------------------------------------------------
 
 # Standard library imports
-from typing import TYPE_CHECKING, Any, Literal
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Literal,
+    cast,
+)
 from urllib.parse import quote_plus
 
 # Bokeh imports
@@ -57,6 +62,7 @@ if TYPE_CHECKING:
     from ..protocol.messages.patch_doc import patch_doc
     from ..protocol.messages.server_info_reply import ServerInfo
     from ..server.callbacks import DocumentCallbackGroup
+    from ..util.asyncio import Loop
     from ..util.browser import BrowserLike, BrowserTarget
     from .connection import ClientConnection
     from .states import ErrorReason
@@ -317,7 +323,10 @@ class ClientSession:
         self._connection = ClientConnection(session=self, io_loop=io_loop, websocket_url=websocket_url, arguments=arguments, max_message_size=max_message_size)
 
         from ..server.callbacks import DocumentCallbackGroup
-        self._callbacks = DocumentCallbackGroup(self._connection.io_loop)
+
+        # Tornado's IOLoop exposes ``asyncio_loop`` at runtime, but its type
+        # declarations don't include that attribute required by ``Loop``.
+        self._callbacks = DocumentCallbackGroup(cast("Loop", self._connection.io_loop))
 
     def __enter__(self) -> ClientSession:
         '''

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/core/enums.py

@@ -309,7 +309,7 @@ type AutoType = Literal["auto"]
 #: Context dependent keyword that specifies the automated, default, computed, etc. behavior.
 Auto = enumeration(AutoType)
 
-type AutosizeModeType = Literal["fit_columns", "fit_viewport", "force_fit", "none"]
+type AutosizeModeType = Literal["fit_columns", "fit_viewport", "force_fit", "ignore_viewport", "none"]
 #: Specify autosize mode for DataTable.
 AutosizeMode = enumeration(AutosizeModeType)
 

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/core/properties.py

@@ -126,14 +126,22 @@ DataSpec Properties
 .. autoclass:: AngleSpec
 .. autoclass:: BoolSpec
 .. autoclass:: ColorSpec
+.. autoclass:: DashPatternSpec
 .. autoclass:: DataSpec
 .. autoclass:: DistanceSpec
 .. autoclass:: FloatSpec
 .. autoclass:: FontSizeSpec
+.. autoclass:: FontStyleSpec
+.. autoclass:: HatchPatternSpec
+.. autoclass:: IntSpec
+.. autoclass:: LineCapSpec
+.. autoclass:: LineJoinSpec
 .. autoclass:: MarkerSpec
 .. autoclass:: NumberSpec
 .. autoclass:: SizeSpec
 .. autoclass:: StringSpec
+.. autoclass:: TextAlignSpec
+.. autoclass:: TextBaselineSpec
 .. autoclass:: UnitsSpec
 
 Helpers

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/core/property/dataspec.py

@@ -90,6 +90,7 @@ __all__ = (
     'StringSpec',
     'TextAlignSpec',
     'TextBaselineSpec',
+    'UnitsSpec',
 )
 
 #-----------------------------------------------------------------------------

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/document/__init__.py

@@ -42,6 +42,7 @@ log = logging.getLogger(__name__)
 __all__ = (
     'DEFAULT_TITLE',
     'Document',
+    'DocumentLike',
     'without_document_lock',
 )
 
@@ -51,7 +52,9 @@ __all__ = (
 
 from .document import DEFAULT_TITLE
 from .document import Document
-from .locking import without_document_lock
+from .locking import UnlockedDocumentProxy, without_document_lock
+
+type DocumentLike = Document | UnlockedDocumentProxy
 
 #-----------------------------------------------------------------------------
 # Dev API

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/document/callbacks.py

@@ -54,6 +54,7 @@ if TYPE_CHECKING:
     from ..core.has_props import Setter
     from ..model import Model
     from ..server.callbacks import SessionCallback
+    from . import DocumentLike
     from .document import Document
     from .events import (
         DocumentChangeCallback,
@@ -456,7 +457,7 @@ class DocumentCallbackManager:
 def invoke_with_curdoc(doc: Document, f: Callable[[], None]) -> None:
     from ..io.doc import patch_curdoc
 
-    curdoc: Document|UnlockedDocumentProxy = UnlockedDocumentProxy(doc) if getattr(f, "nolock", False) else doc
+    curdoc: DocumentLike = UnlockedDocumentProxy(doc) if getattr(f, "nolock", False) else doc
 
     with patch_curdoc(curdoc):
         return f()

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/document/modules.py

@@ -112,6 +112,10 @@ class DocumentModuleManager:
             # ones. Otherwise issue an error log message with details.
             referrers = get_referrers(module)
             referrers = [x for x in referrers if x is not sys.modules]
+            # Python introspection utilities, including inspect.getmodule(),
+            # make shallow snapshots of sys.modules. A snapshot held during
+            # document cleanup isn't an application module leak.
+            referrers = [x for x in referrers if not _is_sys_modules_snapshot(x)]
             referrers = [x for x in referrers if x is not self._modules]
             referrers = [x for x in referrers if not isinstance(x, FrameType)]
             if len(referrers) != 0:
@@ -139,6 +143,17 @@ class DocumentModuleManager:
 # Private API
 #-----------------------------------------------------------------------------
 
+def _is_sys_modules_snapshot(referrer: object) -> bool:
+    ''' Whether a referrer is a shallow snapshot of ``sys.modules``. '''
+    if not isinstance(referrer, dict) or referrer.get("sys") is not sys:
+        return False
+
+    missing = object()
+    return all(
+        isinstance(name, str) and sys.modules.get(name, missing) is value
+        for name, value in referrer.items()
+    )
+
 #-----------------------------------------------------------------------------
 # Code
 #-----------------------------------------------------------------------------

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/io/doc.py

@@ -23,15 +23,13 @@ log = logging.getLogger(__name__)
 # Standard library imports
 import weakref
 from contextlib import contextmanager
-from typing import TYPE_CHECKING, Generator, cast
+from contextvars import ContextVar
+from typing import Generator, cast
 
 # Bokeh imports
-from ..document import Document
+from ..document import Document, DocumentLike
 from .state import curstate
 
-if TYPE_CHECKING:
-    from ..document.locking import UnlockedDocumentProxy
-
 #-----------------------------------------------------------------------------
 # Globals and constants
 #-----------------------------------------------------------------------------
@@ -52,12 +50,18 @@ def curdoc() -> Document:
     Returns:
         Document : the current default document object.
 
+    .. note::
+        Inside a callback decorated with
+        :func:`~bokeh.document.without_document_lock`, this function returns
+        a restricted proxy that permits only safe next-tick callbacks.
+
     '''
-    if len(_PATCHED_CURDOCS) > 0:
-        doc = _PATCHED_CURDOCS[-1]()
+    patched_curdocs = _PATCHED_CURDOCS.get()
+    if len(patched_curdocs) > 0:
+        doc = patched_curdocs[-1]()
         if doc is None:
             raise RuntimeError("Patched curdoc has been previously destroyed")
-        return cast(Document, doc) # UnlockedDocumentProxy -> Document
+        return cast(Document, doc) # UnlockedDocumentProxy enforces callback safety at runtime
     return curstate().document
 
 #-----------------------------------------------------------------------------
@@ -65,7 +69,7 @@ def curdoc() -> Document:
 #-----------------------------------------------------------------------------
 
 @contextmanager
-def patch_curdoc(doc: Document | UnlockedDocumentProxy) -> Generator[None]:
+def patch_curdoc(doc: DocumentLike) -> Generator[None]:
     ''' Temporarily override the value of ``curdoc()`` and then return it to
     its original state.
 
@@ -76,13 +80,12 @@ def patch_curdoc(doc: Document | UnlockedDocumentProxy) -> Generator[None]:
         doc (Document) : new Document to use for ``curdoc()``
 
     '''
-    global _PATCHED_CURDOCS
-    _PATCHED_CURDOCS.append(weakref.ref(doc))
+    token = _PATCHED_CURDOCS.set((*_PATCHED_CURDOCS.get(), weakref.ref(doc)))
     del doc
     try:
         yield
     finally:
-        _PATCHED_CURDOCS.pop()
+        _PATCHED_CURDOCS.reset(token)
 
 def set_curdoc(doc: Document) -> None:
     ''' Configure the current document (returned by curdoc()).
@@ -103,7 +106,8 @@ def set_curdoc(doc: Document) -> None:
 # Private API
 #-----------------------------------------------------------------------------
 
-_PATCHED_CURDOCS: list[weakref.ReferenceType[Document | UnlockedDocumentProxy]] = []
+_PATCHED_CURDOCS: ContextVar[tuple[weakref.ReferenceType[DocumentLike], ...]] = \
+    ContextVar("_PATCHED_CURDOCS", default=())
 
 #-----------------------------------------------------------------------------
 # Code

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/model/model.py

@@ -99,7 +99,7 @@ class Model(HasProps, HasDocumentRef, PropertyCallbackManager, EventCallbackMana
 
         if cls.__module__.startswith("bokeh.models"):
             assert "__init__" in cls.__dict__, str(cls)
-            parameters = [x[0] for x in  cls.parameters()]
+            parameters = [x[0] for x in cls.parameters()]
             cls.__init__.__signature__ = Signature(parameters=parameters)
             process_example(cls)
 
@@ -516,10 +516,11 @@ class Model(HasProps, HasDocumentRef, PropertyCallbackManager, EventCallbackMana
 
     def select_one(self, selector: SelectorType) -> Model | None:
         ''' Query this object and all of its references for objects that
-        match the given selector.  Raises an error if more than one object
-        is found.  Returns single matching object, or None if nothing is found
+        match the given selector. Raises an error if more than one object
+        is found. Returns single matching object, or None if nothing is found.
+
         Args:
-            selector (JSON-like) :
+            selector (JSON-like):
 
         Returns:
             Model

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/models/annotations/html/labels.py

@@ -300,10 +300,10 @@ class HTMLTitle(HTMLTextAnnotation):
     Offset the text by a number of pixels (can be positive or negative). Shifts the text in
     different directions based on the location of the title:
 
-        * above: shifts title right
-        * right: shifts title down
-        * below: shifts title right
-        * left: shifts title up
+    * above: shifts title right
+    * right: shifts title down
+    * below: shifts title right
+    * left: shifts title up
 
     """)
 

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/models/widgets/tables.py

@@ -773,9 +773,8 @@ class DataTable(TableWidget):
 
     ``"fit_columns"``
         Compute column widths based on cell contents but ensure the
-        table fits into the available viewport. This results in no
-        horizontal scrollbar showing up, but data can get unreadable
-        if there is not enough space available.
+        table fits into the available viewport. A horizontal scrollbar may
+        appear to ensure readability of contents in all rows.
 
     ``"fit_viewport"``
         Adjust the viewport size after computing columns widths based
@@ -787,6 +786,12 @@ class DataTable(TableWidget):
         This results in no horizontal scrollbar showing up, but data
         can get unreadable if there is not enough space available.
 
+    ``"ignore_viewport"``
+        Similarly to ``"fit_columns"``, the column widths are computed based on the cell
+        contents. However, the viewport width is ignored, so that if the
+        columns are smaller than the viewport, there is empty space at the right,
+        or if the columns are larger than the viewport, there is a scrollbar.
+
     ``"none"``
         Do not automatically compute column widths.
     """)

{bokeh-3.10.0.dev8 → bokeh-3.10.0.dev9}/src/bokeh/server/__init__.py

@@ -4,7 +4,7 @@
 #
 # The full license is in the file LICENSE.txt, distributed with this software.
 #-----------------------------------------------------------------------------
-''' Provide a customizable Bokeh Server Tornadocore application.
+''' Provide Bokeh server applications and framework integrations.
 
 The architecture of Bokeh is such that high-level "model objects"
 (representing things like plots, ranges, axes, glyphs, etc.) are created
@@ -26,4 +26,8 @@ possibilities immediately open up:
 **This capability to synchronize between python and the browser is the main
 purpose of the Bokeh Server.**
 
+Use :class:`~bokeh.server.asgi.BokehASGI` with an ASGI server or framework.
+The Tornado frontend remains available through :class:`~bokeh.server.server.Server` and
+:class:`~bokeh.server.tornado.BokehTornado`.
+
 '''