Remove deprecated Python APIs: log_components, connect, connect_tcp

docs/content/reference/migration/migration-0-23.md

@@ -81,3 +81,6 @@ Either:
 
 The former is subject to (double-precision) floating point precision loss (still microsecond precision for the next century), while the latter is lossless.
 
+## 🐍 Python: removed `rr.log_components()`, `rr.connect()`, and `rr.connect_tcp()`
+
+These functions were [deprecated](migration-0-22#python-api-changes) in 0.22 and are no longer available. See the [0.22 migration guide](migration-0-22.md) for detailed information about the new APIs and how to migrate to them.

rerun_py/docs/gen_common_index.py

@@ -84,7 +84,6 @@ class Section:
         title="Initialization functions",
         func_list=[
             "init",
-            "connect",
             "connect_grpc",
             "disconnect",
             "save",

rerun_py/rerun_sdk/rerun/__init__.py

@@ -47,7 +47,6 @@
     IndicatorComponentBatch as IndicatorComponentBatch,
     escape_entity_path_part as escape_entity_path_part,
     log as log,
-    log_components as log_components,
     log_file_from_contents as log_file_from_contents,
     log_file_from_path as log_file_from_path,
     new_entity_path as new_entity_path,
@@ -171,7 +170,6 @@
     script_teardown as script_teardown,
 )
 from .sinks import (
-    connect as connect,
     connect_grpc as connect_grpc,
     disconnect as disconnect,
     save as save,

rerun_py/rerun_sdk/rerun/_log.py

@@ -6,7 +6,6 @@
 
 import pyarrow as pa
 import rerun_bindings as bindings
-from typing_extensions import deprecated
 
 from ._baseclasses import AsComponents, ComponentDescriptor, DescribedComponentBatch
 from .error_utils import _send_warning_or_raise, catch_and_log_exceptions
@@ -171,69 +170,6 @@ def log(
     )
 
 
-@deprecated(
-    """Use `log` with partial update APIs instead.
-  See: https://www.rerun.io/docs/reference/migration/migration-0-22 for more details."""
-)
-@catch_and_log_exceptions()
-def log_components(
-    entity_path: str | list[str],
-    components: Iterable[DescribedComponentBatch],
-    *,
-    static: bool = False,
-    recording: RecordingStream | None = None,
-    strict: bool | None = None,
-) -> None:
-    r"""
-    Log an entity from a collection of `ComponentBatchLike` objects.
-
-    See also: [`rerun.log`][].
-
-    Parameters
-    ----------
-    entity_path:
-        Path to the entity in the space hierarchy.
-
-        The entity path can either be a string
-        (with special characters escaped, split on unescaped slashes)
-        or a list of unescaped strings.
-        This means that logging to `"world/my\ image\!"` is the same as logging
-        to ["world", "my image!"].
-
-        See <https://www.rerun.io/docs/concepts/entity-path> for more on entity paths.
-
-    components:
-        A collection of `ComponentBatchLike` objects.
-
-    static:
-        If true, the components will be logged as static data.
-
-        Static data has no time associated with it, exists on all timelines, and unconditionally shadows
-        any temporal data of the same type.
-
-        Otherwise, the data will be timestamped automatically with `log_time` and `log_tick`.
-        Additional timelines set by [`rerun.set_index`][] will also be included.
-
-    recording:
-        Specifies the [`rerun.RecordingStream`][] to use. If left unspecified,
-        defaults to the current active data recording, if there is one. See
-        also: [`rerun.init`][], [`rerun.set_global_data_recording`][].
-
-    strict:
-        If True, raise exceptions on non-loggable data.
-        If False, warn on non-loggable data.
-        if None, use the global default from `rerun.strict_mode()`
-
-    """
-
-    _log_components(
-        entity_path=entity_path,
-        components=list(components),
-        static=static,
-        recording=recording,  # NOLINT
-    )
-
-
 def _log_components(
     entity_path: str | list[str],
     components: list[DescribedComponentBatch],

rerun_py/rerun_sdk/rerun/blueprint/api.py

@@ -5,7 +5,6 @@
 from typing import Optional, Union
 
 import rerun_bindings as bindings
-from typing_extensions import deprecated  # type: ignore[misc, unused-ignore]
 
 from .._baseclasses import AsComponents, ComponentBatchLike
 from .._spawn import _spawn_viewer
@@ -562,42 +561,6 @@ def _ipython_display_(self) -> None:
 
         Viewer(blueprint=self).display()
 
-    @deprecated(
-        """Please migrate to `connect_grpc(…)`.
-        See: https://www.rerun.io/docs/reference/migration/migration-0-22 for more details."""
-    )
-    def connect(
-        self,
-        application_id: str,
-        *,
-        url: str | None = None,
-        make_active: bool = True,
-        make_default: bool = True,
-    ) -> None:
-        """
-        Connect to a remote Rerun Viewer on the given HTTP(S) URL and send this blueprint.
-
-        Parameters
-        ----------
-        application_id:
-            The application ID to use for this blueprint. This must match the application ID used
-            when initiating rerun for any data logging you wish to associate with this blueprint.
-        url:
-            The HTTP(S) URL to connect to
-        make_active:
-            Immediately make this the active blueprint for the associated `app_id`.
-            Note that setting this to `false` does not mean the blueprint may not still end
-            up becoming active. In particular, if `make_default` is true and there is no other
-            currently active blueprint.
-        make_default:
-            Make this the default blueprint for the `app_id`.
-            The default blueprint will be used as the template when the user resets the
-            blueprint for the app. It will also become the active blueprint if no other
-            blueprint is currently active.
-
-        """
-        return self.connect_grpc(application_id, url=url, make_active=make_active, make_default=make_default)
-
     def connect_grpc(
         self,
         application_id: str,

rerun_py/rerun_sdk/rerun/sinks.py

@@ -25,96 +25,6 @@ def is_recording_enabled(recording: RecordingStream | None) -> bool:
     return bindings.is_enabled()  # type: ignore[no-any-return]
 
 
-@deprecated(
-    """Please migrate to `connect_grpc(…)`.
-    See: https://www.rerun.io/docs/reference/migration/migration-0-22 for more details."""
-)
-def connect(
-    addr: str | None = None,
-    *,
-    flush_timeout_sec: float | None = 2.0,
-    default_blueprint: BlueprintLike | None = None,
-    recording: RecordingStream | None = None,
-) -> None:
-    """
-    Connect to a remote Rerun Viewer on the given ip:port.
-
-    This function returns immediately.
-
-    Parameters
-    ----------
-    addr:
-        The ip:port to connect to
-    flush_timeout_sec:
-        The minimum time the SDK will wait during a flush before potentially
-        dropping data if progress is not being made. Passing `None` indicates no timeout,
-        and can cause a call to `flush` to block indefinitely.
-    default_blueprint:
-        Optionally set a default blueprint to use for this application. If the application
-        already has an active blueprint, the new blueprint won't become active until the user
-        clicks the "reset blueprint" button. If you want to activate the new blueprint
-        immediately, instead use the [`rerun.send_blueprint`][] API.
-    recording:
-        Specifies the [`rerun.RecordingStream`][] to use.
-        If left unspecified, defaults to the current active data recording, if there is one.
-        See also: [`rerun.init`][], [`rerun.set_global_data_recording`][].
-
-    """
-    if addr is not None:
-        addr = f"rerun+http://{addr}/proxy"
-    return connect_grpc(
-        url=addr,
-        flush_timeout_sec=flush_timeout_sec,
-        default_blueprint=default_blueprint,
-        recording=recording,  # NOLINT: conversion not needed
-    )
-
-
-@deprecated(
-    """Please migrate to `connect_grpc(…)`.
-    See: https://www.rerun.io/docs/reference/migration/migration-0-22 for more details."""
-)
-def connect_tcp(
-    addr: str | None = None,
-    *,
-    flush_timeout_sec: float | None = 2.0,
-    default_blueprint: BlueprintLike | None = None,
-    recording: RecordingStream | None = None,
-) -> None:
-    """
-    Connect to a remote Rerun Viewer on the given ip:port.
-
-    This function returns immediately.
-
-    Parameters
-    ----------
-    addr:
-        The ip:port to connect to
-    flush_timeout_sec:
-        The minimum time the SDK will wait during a flush before potentially
-        dropping data if progress is not being made. Passing `None` indicates no timeout,
-        and can cause a call to `flush` to block indefinitely.
-    default_blueprint:
-        Optionally set a default blueprint to use for this application. If the application
-        already has an active blueprint, the new blueprint won't become active until the user
-        clicks the "reset blueprint" button. If you want to activate the new blueprint
-        immediately, instead use the [`rerun.send_blueprint`][] API.
-    recording:
-        Specifies the [`rerun.RecordingStream`][] to use.
-        If left unspecified, defaults to the current active data recording, if there is one.
-        See also: [`rerun.init`][], [`rerun.set_global_data_recording`][].
-
-    """
-    if addr is not None:
-        addr = f"rerun+http://{addr}/proxy"
-    return connect_grpc(
-        url=addr,
-        flush_timeout_sec=flush_timeout_sec,
-        default_blueprint=default_blueprint,
-        recording=recording,  # NOLINT: conversion not needed
-    )
-
-
 def connect_grpc(
     url: str | None = None,
     *,