perspective-python 4.2.0__cp311-abi3-win_amd64.whl

perspective/tests/test_dependencies.py

@@ -0,0 +1,53 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+#  ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+#  ┃ This file is part of the Perspective library, distributed under the terms ┃
+#  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+#  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+import pytest
+
+
+# test that loading perspective and calling a common constructor code path does
+# not load various "expensive" modules. "Expensive" is in quotes because this is
+# utter nonsense.
+@pytest.mark.skip(reason="https://github.com/pyca/bcrypt/issues/694")
+def test_lazy_modules():
+    import sys
+
+    cache = {}
+    for key in list(sys.modules.keys()):
+        if (
+            key.startswith("perspective")
+            or key.startswith("test")
+            or key.startswith("pandas")
+            or key.startswith("pyarrow")
+            or key.startswith("tornado")
+        ):
+            cache[key] = sys.modules[key]
+            del sys.modules[key]
+
+    import perspective
+
+    t1 = perspective.table("x\n1")
+    t1.delete()
+
+    assert "perspective" in sys.modules
+    assert "pandas" not in sys.modules
+    assert "pyarrow" not in sys.modules
+    assert "tornado" not in sys.modules
+
+    for k, v in cache.items():
+        sys.modules[k] = v
+
+
+def test_all():
+    import perspective
+
+    for key in perspective.__all__:
+        assert hasattr(perspective, key)

perspective/tests/viewer/__init__.py

@@ -0,0 +1,11 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+#  ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+#  ┃ This file is part of the Perspective library, distributed under the terms ┃
+#  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+#  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

perspective/tests/viewer/test_viewer.py

@@ -0,0 +1,246 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+#  ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+#  ┃ This file is part of the Perspective library, distributed under the terms ┃
+#  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+#  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+import numpy as np
+import pandas as pd
+import pytest
+from perspective.widget.viewer import PerspectiveViewer
+import perspective as psp
+
+client = psp.Server().new_local_client()
+Table = client.table
+
+
+class TestViewer:
+    def test_viewer_get_table(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        assert viewer.table == table
+
+    # loading
+
+    def test_viewer_load_table(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        assert viewer.columns == ["a"]
+
+    def test_viewer_load_named_table(self):
+        table = Table({"a": [1, 2, 3]}, name="data_1")
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        assert viewer.columns == ["a"]
+        assert viewer.table_name == "data_1"
+        assert viewer.table == table
+
+    def test_viewer_load_data(self):
+        viewer = PerspectiveViewer()
+        viewer.load({"a": [1, 2, 3]})
+        assert viewer.columns == ["a"]
+
+    def test_viewer_load_named_data(self):
+        viewer = PerspectiveViewer()
+        viewer.load({"a": [1, 2, 3]}, name="data_1")
+        assert viewer.columns == ["a"]
+        assert viewer.table_name == "data_1"
+
+    def test_viewer_load_schema(self):
+        viewer = PerspectiveViewer()
+        viewer.load({"a": "string", "b": "integer", "c": "boolean", "d": "string"})
+        for col in viewer.columns:
+            assert col in ["a", "b", "c", "d"]
+
+    def test_viewer_load_table_with_options(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        # options should be disregarded when loading Table
+        viewer.load(table, limit=1)
+        assert viewer.columns == ["a"]
+        assert viewer.table.size() == 3
+
+    def test_viewer_load_data_with_options(self):
+        viewer = PerspectiveViewer()
+        # options should be forwarded to the Table constructor
+        viewer.load({"a": [1, 2, 3]}, limit=1)
+        assert viewer.columns == ["a"]
+        assert viewer.table.size() == 1
+
+    def test_viewer_load_clears_state(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer(theme="Pro Dark", group_by=["a"])
+        viewer.load(table)
+        assert viewer.group_by == ["a"]
+        viewer.load({"b": [1, 2, 3]})
+        assert viewer.group_by == []
+        assert viewer.theme == "Pro Dark"  # should not break UI
+
+    @pytest.mark.skip
+    def test_viewer_load_np(self):
+        table = Table({"a": np.arange(1, 100)})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        assert viewer.columns == ["a"]
+
+    @pytest.mark.skip
+    def test_viewer_load_np_data(self):
+        viewer = PerspectiveViewer()
+        viewer.load({"a": np.arange(1, 100)})
+        assert viewer.columns == ["a"]
+        assert viewer.table.size() == 99
+
+    @pytest.mark.skip
+    def test_viewer_load_df(self):
+        table = Table(pd.DataFrame({"a": np.arange(1, 100)}))
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        for col in viewer.columns:
+            assert col in ["index", "a"]
+        assert viewer.table.size() == 99
+
+    def test_viewer_load_df_data(self):
+        viewer = PerspectiveViewer()
+        viewer.load(pd.DataFrame({"a": np.arange(1, 100)}))
+        for col in viewer.columns:
+            assert col in ["index", "a"]
+
+    # update
+
+    def test_viewer_update_dict(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        viewer.update({"a": [4, 5, 6]})
+        assert table.size() == 6
+        assert viewer.table.size() == 6
+        assert viewer.table.view().to_columns() == {"a": [1, 2, 3, 4, 5, 6]}
+
+    def test_viewer_update_list(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        viewer.update([{"a": 4}, {"a": 5}, {"a": 6}])
+        assert table.size() == 6
+        assert viewer.table.size() == 6
+        assert viewer.table.view().to_columns() == {"a": [1, 2, 3, 4, 5, 6]}
+
+    def test_viewer_update_df(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        viewer.update(pd.DataFrame({"a": [4, 5, 6]}))
+        assert table.size() == 6
+        assert viewer.table.size() == 6
+        assert viewer.table.view().to_columns() == {"a": [1, 2, 3, 4, 5, 6]}
+
+    def test_viewer_update_dict_partial(self):
+        table = Table({"a": [1, 2, 3], "b": [5, 6, 7]}, index="a")
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        viewer.update({"a": [1, 2, 3], "b": [8, 9, 10]})
+        assert table.size() == 3
+        assert viewer.table.size() == 3
+        assert viewer.table.view().to_columns() == {"a": [1, 2, 3], "b": [8, 9, 10]}
+
+    # clear
+
+    def test_viewer_clear(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        viewer.clear()
+        assert viewer.table.size() == 0
+        assert viewer.table.schema() == {"a": "integer"}
+
+    # replace
+
+    def test_viewer_replace(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer()
+        viewer.load(table)
+        viewer.replace({"a": [4, 5, 6]})
+        assert viewer.table.size() == 3
+        assert viewer.table.schema() == {"a": "integer"}
+        assert viewer.table.view().to_columns() == {"a": [4, 5, 6]}
+
+    # reset
+
+    def test_viewer_reset(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer(plugin="X Bar", filter=[["a", "==", 2]])
+        viewer.load(table)
+        assert viewer.filter == [["a", "==", 2]]
+        viewer.reset()
+        assert viewer.plugin == "Datagrid"
+        assert viewer.filter == []
+
+    # delete
+
+    def test_viewer_delete(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer(plugin="X Bar", filter=[["a", "==", 2]])
+        viewer.load(table)
+        assert viewer.filter == [["a", "==", 2]]
+        viewer.delete()
+        assert viewer.table_name is None
+        assert viewer.table is None
+
+    def test_viewer_delete_without_table(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer(plugin="X Bar", filter=[["a", "==", 2]])
+        viewer.load(table)
+        assert viewer.filter == [["a", "==", 2]]
+        viewer.delete(delete_table=False)
+        assert viewer.table_name is not None
+        assert viewer.table is not None
+        assert viewer.filter == []
+
+    def test_save_restore(self):
+        table = Table({"a": [1, 2, 3]})
+        viewer = PerspectiveViewer(
+            plugin="X Bar", filter=[["a", "==", 2]], expressions={'"a" * 2': '"a" * 2'}
+        )
+        viewer.load(table)
+
+        # Save config
+        config = viewer.save()
+        assert viewer.filter == [["a", "==", 2]]
+        assert config["filter"] == [["a", "==", 2]]
+        assert viewer.plugin == "X Bar"
+        assert config["plugin"] == "X Bar"
+        assert config["expressions"] == {'"a" * 2': '"a" * 2'}
+
+        # reset configuration
+        viewer.reset()
+        assert viewer.plugin == "Datagrid"
+        assert viewer.filter == []
+        assert viewer.expressions == {}
+
+        # restore configuration
+        viewer.restore(**config)
+        assert viewer.filter == [["a", "==", 2]]
+        assert viewer.plugin == "X Bar"
+        assert viewer.expressions == {'"a" * 2': '"a" * 2'}
+
+    def test_save_restore_plugin_config(self):
+        viewer = PerspectiveViewer(
+            plugin="Datagrid", plugin_config={"columns": {"a": {"fixed": 4}}}
+        )
+        config = viewer.save()
+
+        assert config["plugin_config"] == {"columns": {"a": {"fixed": 4}}}
+
+        viewer.reset()
+        assert viewer.plugin_config == {}
+
+        viewer.restore(**config)
+        assert viewer.plugin_config == config["plugin_config"]

perspective/tests/widget/__init__.py

@@ -0,0 +1,11 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+#  ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+#  ┃ This file is part of the Perspective library, distributed under the terms ┃
+#  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+#  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

perspective/tests/widget/test_widget.py

@@ -0,0 +1,278 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+#  ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+#  ┃ This file is part of the Perspective library, distributed under the terms ┃
+#  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+#  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+from functools import partial
+from types import MethodType
+import numpy as np
+from perspective.widget import PerspectiveWidget
+from pytest import raises
+import pytest
+import perspective as psp
+
+client = psp.Server().new_local_client()
+Table = client.table
+
+pytest.skip(allow_module_level=True)
+
+
+def mock_post(self, msg, msg_id=None, assert_msg=None):
+    """Mock the widget's `post()` method so we can introspect the contents."""
+    assert msg == assert_msg
+
+
+class TestWidget:
+    def test_widget(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data, plugin="X Bar")
+        assert widget.plugin == "X Bar"
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {}},
+        }
+
+    def test_widget_indexed(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data, plugin="X Bar", index="a")
+        assert widget.plugin == "X Bar"
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {"index": "a"}},
+        }
+
+    def test_widget_no_data(self):
+        widget = PerspectiveWidget(None, plugin="X Bar", group_by=["a"])
+        assert widget.plugin == "X Bar"
+        assert widget.group_by == ["a"]
+
+    def test_widget_schema(self):
+        schema = {
+            "a": "integer",
+            "b": "float",
+            "c": "boolean",
+            "d": "date",
+            "e": "datetime",
+            "f": "string",
+        }
+        widget = PerspectiveWidget(schema)
+        assert widget.table.schema() == schema
+
+    def test_widget_schema_with_index(self):
+        widget = PerspectiveWidget({"a": "integer"}, index="a")
+        assert widget.table.get_index() == "a"
+
+    def test_widget_schema_with_limit(self):
+        widget = PerspectiveWidget({"a": "integer"}, limit=5)
+        assert widget.table.get_limit() == 5
+
+    def test_widget_no_data_with_index(self):
+        # should fail
+        with raises(TypeError):
+            PerspectiveWidget(None, index="a")
+
+    def test_widget_no_data_with_limit(self):
+        # should fail
+        with raises(TypeError):
+            PerspectiveWidget(None, limit=5)
+
+    def test_widget_eventual_data(self):
+        table = Table({"a": np.arange(0, 50)})
+        widget = PerspectiveWidget(None, plugin="X Bar")
+        assert widget.plugin == "X Bar"
+
+        with raises(TypeError):
+            widget._make_load_message()
+
+        widget.load(table)
+
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {}},
+        }
+
+    def test_widget_eventual_data_server(self):
+        widget = PerspectiveWidget(None, plugin="X Bar", server=True)
+        assert widget.plugin == "X Bar"
+        widget.load({"a": np.arange(0, 50)}, index="a")
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {
+                "table_name": widget.table_name,
+            },
+        }
+
+    def test_widget_eventual_data_indexed(self):
+        widget = PerspectiveWidget(None, plugin="X Bar")
+        assert widget.plugin == "X Bar"
+        widget.load({"a": np.arange(0, 50)}, index="a")
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {"index": "a"}},
+        }
+
+    def test_widget_eventual_table_indexed(self):
+        table = Table({"a": np.arange(0, 50)}, index="a")
+        widget = PerspectiveWidget(None, plugin="X Bar")
+        assert widget.plugin == "X Bar"
+        widget.load(table)
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {"index": "a"}},
+        }
+
+    def test_widget_load_table(self):
+        table = Table({"a": np.arange(0, 50)})
+        widget = PerspectiveWidget(table, plugin="X Bar")
+        assert widget.plugin == "X Bar"
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {}},
+        }
+
+    def test_widget_load_table_indexed(self):
+        table = Table({"a": np.arange(0, 50)}, index="a")
+        widget = PerspectiveWidget(table, plugin="X Bar")
+        assert widget.plugin == "X Bar"
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name, "options": {"index": "a"}},
+        }
+
+    def test_widget_load_table_ignore_limit(self):
+        table = Table({"a": np.arange(0, 50)})
+        widget = PerspectiveWidget(table, limit=1)
+        assert widget.table.size() == 50
+
+    def test_widget_pass_index(self):
+        data = {"a": [1, 2, 3, 1]}
+        widget = PerspectiveWidget(data, index="a")
+        assert widget.table.size() == 3
+
+    def test_widget_pass_limit(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data, limit=1)
+        assert widget.table.size() == 1
+
+    def test_widget_pass_options_invalid(self):
+        data = {"a": np.arange(0, 50)}
+        with raises(TypeError):
+            PerspectiveWidget(data, index="index", limit=1)
+
+    # server mode
+    def test_widget_load_table_server(self):
+        table = Table({"a": np.arange(0, 50)})
+        widget = PerspectiveWidget(table, server=True)
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name},
+        }
+
+    def test_widget_no_data_with_server(self):
+        # should fail
+        widget = PerspectiveWidget(None, server=True)
+        with raises(TypeError):
+            widget._make_load_message()
+
+    def test_widget_eventual_data_with_server(self):
+        # should fail
+        widget = PerspectiveWidget(None, server=True)
+
+        with raises(TypeError):
+            widget._make_load_message()
+
+        # then succeed
+        widget.load(Table({"a": np.arange(0, 50)}))
+        load_msg = widget._make_load_message()
+        assert load_msg.to_columns() == {
+            "id": -2,
+            "type": "table",
+            "data": {"table_name": widget.table_name},
+        }
+
+    # clear
+
+    def test_widget_clear(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data)
+        widget.clear()
+        assert widget.table.size() == 0
+
+    def test_widget_clear_server(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data, server=True)
+        widget.clear()
+        assert widget.table.size() == 0
+
+    # replace
+
+    def test_widget_replace(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data)
+        widget.replace({"a": [1]})
+        assert widget.table.size() == 1
+
+    def test_widget_replace_server(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data, server=True)
+        widget.replace({"a": [1]})
+        assert widget.table.size() == 1
+
+    # delete
+
+    def test_widget_delete(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data)
+        mocked_post = partial(mock_post, assert_msg={"cmd": "delete"})
+        widget.post = MethodType(mocked_post, widget)
+        widget.delete()
+        assert widget.table is None
+
+    def test_widget_delete_with_view(self):
+        data = {"a": np.arange(0, 50)}
+        widget = PerspectiveWidget(data)
+
+        # create a view on the manager
+        table_name, table = list(widget.manager._tables.items())[0]
+        make_view_message = {
+            "id": 1,
+            "table_name": table_name,
+            "view_name": "view1",
+            "cmd": "view",
+            "config": {"group_by": ["a"]},
+        }
+        widget.manager._process(make_view_message, lambda x: True)
+
+        assert len(widget.manager._views) == 1
+
+        mocked_post = partial(mock_post, assert_msg={"cmd": "delete"})
+
+        widget.post = MethodType(mocked_post, widget)
+        widget.delete()
+
+        assert widget.table is None