perspective-python 5.9.0

Interactive data grid, pivot table and charts for large, real-time and streaming datasets, with a Jupyter widget and WebSocket server.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
#  ┃ 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

import perspective
from perspective import PerspectiveError, migrate, validate

V2_VIEW = {
    "row_pivot": ["State"],
    "expressions": ['//profit\n"Sales" - "Cost"'],
}


class TestMigrate:
    def test_upgrades_a_2x_engine_config(self):
        assert migrate("view", V2_VIEW, "2.6.0") == {
            "value": {
                "group_by": ["State"],
                "expressions": {"profit": '"Sales" - "Cost"'},
            },
            "notices": [],
            "steps": ["view.v2_aliases", "view.expressions_map"],
        }

    def test_an_upgraded_config_creates_a_view(self):
        client = perspective.Server().new_local_client()
        table = client.table({"State": ["NY", "NJ"], "Sales": [5, 7], "Cost": [1, 2]})
        view = table.view(**migrate("view", V2_VIEW, "2.6.0")["value"])
        assert view.to_columns()["profit"] == [9, 5, 4]

    def test_a_token_version_overrides_from_version(self):
        result = migrate(
            "viewer",
            {
                "version": "5.4.0",
                "plugin": "Datagrid",
                "columns_config": {"Sales": {"number_fg_mode": "bar"}},
            },
            from_version="2.0.0",
        )

        assert result["value"]["columns_config"] == {"Sales": {"fg_mode": "bar"}}
        assert result["steps"] == ["datagrid.mode_renames"]

    def test_rejects_an_unknown_kind(self):
        with pytest.raises(ValueError, match="Unknown config kind"):
            migrate("table", {})

    def test_names_the_step_which_rejected_a_config(self):
        with pytest.raises(PerspectiveError, match="view.v2_aliases"):
            migrate("view", {"row_pivot": ["a"], "group_by": ["b"]}, "2.0.0")


class TestValidate:
    def test_accepts_a_current_view_config(self):
        validate("view", {"group_by": ["State"]})

    def test_accepts_a_migrated_config(self):
        validate("view", migrate("view", V2_VIEW, "2.6.0")["value"])

    def test_rejects_an_unknown_key(self):
        with pytest.raises(PerspectiveError, match="bogus"):
            validate("viewer", {"bogus": 1})

    def test_rejects_a_panel_without_a_table(self):
        with pytest.raises(PerspectiveError, match="table"):
            validate("panel", {"plugin": "Datagrid"})

    def test_strict_requires_the_complete_form(self):
        validate("viewer", {"plugin": "Datagrid"})
        with pytest.raises(PerspectiveError, match="settings"):
            validate("viewer", {"plugin": "Datagrid"}, strict=True)

    def test_rejects_an_unknown_kind(self):
        with pytest.raises(ValueError, match="Unknown config kind"):
            validate("table", {})