perspective-python 4.2.0__cp311-abi3-win_amd64.whl

perspective/tests/server/test_session.py

@@ -0,0 +1,110 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ 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 perspective import Server, Client, ProxySession, AsyncClient
+import pytest
+
+
+client = Server().new_local_client()
+Table = client.table
+
+
+data = {"a": [1, 2, 3], "b": ["a", "b", "c"]}
+
+
+class TestProxySession(object):
+    def test_proxy_client(self):
+        server = Server()
+        client = server.new_local_client()
+
+        def handle_request(bytes):
+            sub_session.handle_request(bytes)
+
+        def handle_response(bytes):
+            sub_client.handle_response(bytes)
+
+        sub_session = ProxySession(client, handle_response)
+        sub_client = Client(handle_request, sub_session.close)
+        table = sub_client.table(data, name="table1")
+        assert table.schema() == {"a": "integer", "b": "string"}
+
+    def test_proxy_and_local_client_can_share_handles(self):
+        server = Server()
+        client = server.new_local_client()
+
+        def handle_request(bytes):
+            sub_session.handle_request(bytes)
+
+        def handle_response(bytes):
+            sub_client.handle_response(bytes)
+
+        sub_session = ProxySession(client, handle_response)
+        sub_client = Client(handle_request, sub_session.close)
+        table = sub_client.table(data, name="table1")
+        table2 = client.open_table("table1")
+        assert table.size() == 3
+        table2.update([{"a": 4, "d": 5}])
+        assert table.size() == 4
+
+    @pytest.mark.asyncio
+    async def test_handle_request_async(self):
+        """tests use of ProxySession.handle_request_async() in an AsyncClient callback"""
+        server = Server()
+        client = server.new_local_client()
+
+        def handle_response(bytes):
+            import asyncio
+
+            asyncio.create_task(sub_client.handle_response(bytes))
+
+        sub_session = ProxySession(client, handle_response)
+        sub_client = AsyncClient(sub_session.handle_request_async, sub_session.close)
+        table = await sub_client.table(data, name="table1")
+        table2 = client.open_table("table1")
+        assert (await table.size()) == 3
+        table2.update([{"a": 4, "d": 5}])
+        assert (await table.size()) == 4
+
+    @pytest.mark.asyncio
+    async def test_dismabiguate_message_ids_in_proxy_session(self):
+        """tests concurrent calls from clients on Session + ProxySession"""
+        server = Server()
+        client = server.new_local_client()
+
+        def send_response(bytes):
+            import asyncio
+
+            asyncio.create_task(sub_client.handle_response(bytes))
+
+        async def send_request(bytes):
+            await sub_session.handle_request_async(bytes)
+
+        sub_session = ProxySession(client, send_response)
+        sub_client = AsyncClient(send_request, sub_session.close)
+
+        table = client.table("x\n1", name="test_table")
+        table2 = await sub_client.open_table("test_table")
+        view = table.view()
+        view2 = await table2.view()
+
+        sentinel = []
+
+        def callback1(*args):
+            sentinel.append("Callback 1")
+
+        def callback2(*args):
+            sentinel.append("Callback 2")
+
+        view.on_update(callback1)
+        await view2.on_update(callback2)
+        await table2.update("x\n2")
+        assert sentinel == ["Callback 1", "Callback 2"]

perspective/tests/table/__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/table/object_sequence.py

@@ -0,0 +1,402 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ 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 sys
+from random import randint, choice
+import perspective as psp
+
+client = psp.Server().new_local_client()
+Table = client.table
+
+
+class CustomObjectStore(object):
+    def __init__(self, value):
+        self._value = value
+
+    def _psp_dtype_(self):
+        return "object"
+
+    def __int__(self):
+        return int(self._value)
+
+    def __repr__(self):
+        return "test" if self._value == 1 else "test{}".format(self._value)
+
+
+def run():
+    t = CustomObjectStore(1)
+    t2 = CustomObjectStore(2)
+
+    assert sys.getrefcount(t) == 2
+    assert sys.getrefcount(t2) == 2
+
+    data = {"a": [0], "b": [t]}
+    assert sys.getrefcount(t) == 3
+
+    tbl = Table(data, index="a")
+    assert sys.getrefcount(t) == 4
+
+    assert tbl.schema() == {"a": int, "b": object}
+    assert tbl.size() == 1
+    assert tbl.view().to_columns() == {"a": [0], "b": [t]}
+
+    # Count references
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    print("t:", id(t))
+    assert sys.getrefcount(t) == 4
+
+    print(sys.getrefcount(t2), "should be", 2)
+    print("t2:", id(t2))
+    assert sys.getrefcount(t2) == 2
+
+    tbl.update([{"a": i, "b": None} for i in range(1, 6)])
+
+    assert tbl.size() == 6
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    assert sys.getrefcount(t) == 4
+
+    print()
+    tbl.update([data])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    assert sys.getrefcount(t) == 4
+
+    print()
+    tbl.update([data])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    assert sys.getrefcount(t) == 4
+
+    print()
+    tbl.update([data])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    assert sys.getrefcount(t) == 4
+
+    print()
+    tbl.update([{"a": 1, "b": t}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 2 for the table
+    print(sys.getrefcount(t), "should be", 5)
+    assert sys.getrefcount(t) == 5
+
+    print()
+    tbl.update([{"a": 1, "b": t}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 2 for the table
+    print(sys.getrefcount(t), "should be", 5)
+    assert sys.getrefcount(t) == 5
+
+    print()
+    tbl.update([{"a": 3, "b": t}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    assert sys.getrefcount(t) == 6
+
+    print()
+    tbl.update([{"a": 3, "b": t}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    assert sys.getrefcount(t) == 6
+
+    print()
+    tbl.update([{"a": 5, "b": t}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 4for the table
+    print(sys.getrefcount(t), "should be", 7)
+    # assert sys.getrefcount(t) == 7
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    # clear some, overwrite some with same
+    tbl.update([{"a": 0, "b": t}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 4 for the table
+    print(sys.getrefcount(t), "should be", 7)
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 1, "b": t2}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 1, "b": t2}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 1, "b": t2}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 1, "b": t2}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 2, "b": t2}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 4)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        True,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 2, "b": None}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 2, "b": t2}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 4)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        True,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 2, "b": None}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 3 for the table
+    print(sys.getrefcount(t), "should be", 6)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 3, "b": None}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 2 for the table
+    print(sys.getrefcount(t), "should be", 5)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        False,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 3, "b": None}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 2 for the table
+    print(sys.getrefcount(t), "should be", 5)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        False,
+        False,
+        True,
+    ]
+
+    print()
+    tbl.update([{"a": 5, "b": None}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        False,
+        False,
+        False,
+    ]
+
+    print()
+    tbl.update([{"a": 5, "b": None}])
+    # 1 for `t`, 1 for `data`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t), "should be", 4)
+    # 1 for `t2`, 1 for argument to sys.getrefcount, and 1 for the table
+    print(sys.getrefcount(t2), "should be", 3)
+    print(tbl.view().to_columns()["b"])
+    assert list(_ is not None for _ in tbl.view().to_columns()["b"]) == [
+        True,
+        True,
+        False,
+        False,
+        False,
+        False,
+    ]
+
+    print()
+    tbl.clear()
+    assert tbl.size() == 0
+    assert tbl.view().to_columns() == {}
+    # 1 for `t`, one for `data`, one for argument to sys.getrefcount
+    print(sys.getrefcount(t), "should be", 3)
+    assert sys.getrefcount(t) == 3
+
+
+def run2():
+    t = CustomObjectStore(1)
+    t_ref_count = 2
+    assert sys.getrefcount(t) == t_ref_count
+
+    indexes = set([0])
+
+    tbl = Table({"a": [0], "b": [t]}, index="a")
+    assert sys.getrefcount(t) == 3
+    t_ref_count += 1
+
+    assert tbl.schema() == {"a": int, "b": object}
+    assert tbl.size() == 1
+    assert tbl.view().to_columns() == {"a": [0], "b": [t]}
+
+    # seed a few to check
+    tbl.remove([1])
+    tbl.remove([1])
+    tbl.remove([1])
+
+    for _ in range(10):
+        pick = randint(1, 2) if indexes else 1
+        if pick == 1:
+            ind = randint(1, 10)
+            while ind in indexes:
+                ind = randint(1, 100)
+
+            print(
+                "adding", ind, "refcount", t_ref_count, "should be", sys.getrefcount(t)
+            )
+            tbl.update({"a": [ind], "b": [t]})
+            t_ref_count += 1
+            indexes.add(ind)
+            assert sys.getrefcount(t) == t_ref_count
+
+        else:
+            ind = choice(list(indexes))
+            indexes.remove(ind)
+            tbl.remove([ind])
+            t_ref_count -= 1
+            print(
+                "removing",
+                ind,
+                "refcount",
+                t_ref_count,
+                "should be",
+                sys.getrefcount(t),
+            )
+            assert sys.getrefcount(t) == t_ref_count
+
+        print(t_ref_count)
+        print(tbl.view().to_columns())
+
+    assert sys.getrefcount(t) == t_ref_count
+
+    print()
+    tbl.clear()
+    assert tbl.size() == 0
+    assert tbl.view().to_columns() == {}
+    # 1 for `t`, one for `data`, one for argument to sys.getrefcount
+    print(sys.getrefcount(t), "should be", 2)
+    assert sys.getrefcount(t) == 2

perspective/tests/table/test_column_paths.py

@@ -0,0 +1,89 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ 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 perspective as psp
+
+client = psp.Server().new_local_client()
+
+
+class TestViewColumnPaths(object):
+    def test_column_paths(self, superstore):
+        tbl = client.table(superstore)
+        view = tbl.view()
+        paths = view.column_paths()
+        assert paths == [
+            "index",
+            "Row ID",
+            "Order ID",
+            "Order Date",
+            "Ship Date",
+            "Ship Mode",
+            "Customer ID",
+            "Segment",
+            "Country",
+            "City",
+            "State",
+            "Postal Code",
+            "Region",
+            "Product ID",
+            "Category",
+            "Sub-Category",
+            "Sales",
+            "Quantity",
+            "Discount",
+            "Profit",
+        ]
+
+        view.delete()
+        tbl.delete()
+
+    def test_column_paths_split_by(self, superstore):
+        tbl = client.table(superstore)
+        view = tbl.view(group_by=["State"], columns=["Sales"], split_by=["Ship Mode"])
+        paths = view.column_paths()
+        assert paths == [
+            "First Class|Sales",
+            "Second Class|Sales",
+            "Standard Class|Sales",
+        ]
+
+        view.delete()
+        tbl.delete()
+
+    def test_column_paths_split_by_range(self, superstore):
+        tbl = client.table(superstore)
+        view = tbl.view(group_by=["State"], columns=["Sales"], split_by=["Ship Mode"])
+        paths = view.column_paths(start_col=1)
+        assert paths == [
+            "Second Class|Sales",
+            "Standard Class|Sales",
+        ]
+
+        view.delete()
+        view = tbl.view(group_by=["State"], columns=["Sales"], split_by=["Ship Mode"])
+        paths = view.column_paths(start_col=1, end_col=2)
+        assert paths == [
+            "Second Class|Sales",
+            "Standard Class|Sales",
+        ]
+
+        view.delete()
+        tbl = client.table(superstore)
+        view = tbl.view(group_by=["State"], columns=["Sales"], split_by=["Ship Mode"])
+        paths = view.column_paths(end_col=1)
+        assert paths == [
+            "First Class|Sales",
+            "Second Class|Sales",
+        ]
+
+        view.delete()
+        tbl.delete()