| 1 |
import json |
| 2 |
from threading import Thread |
| 3 |
from typing import Any, Callable |
| 4 |
|
| 5 |
from typing_extensions import Self |
| 6 |
|
| 7 |
from webview.util import escape_string |
| 8 |
|
| 9 |
try: |
| 10 |
from enum import StrEnum # Python 3.11 and above |
| 11 |
except ImportError: |
| 12 |
from enum import Enum |
| 13 |
|
| 14 |
class StrEnum(str, Enum): |
| 15 |
pass |
| 16 |
|
| 17 |
|
| 18 |
class StateEventType(StrEnum): |
| 19 |
CHANGE = 'change' |
| 20 |
DELETE = 'delete' |
| 21 |
|
| 22 |
|
| 23 |
class State(dict): |
| 24 |
_serializable = False |
| 25 |
|
| 26 |
def __init__(self, window): |
| 27 |
self.__event_handlers = [] |
| 28 |
self.__window = window |
| 29 |
|
| 30 |
def __update_js(self, key, value): |
| 31 |
special_key = '__pywebviewHaltUpdate__' + key |
| 32 |
script = f"window.pywebview.state.{special_key} = JSON.parse('{escape_string(json.dumps(value))}')" |
| 33 |
self.__window.run_js(script) |
| 34 |
|
| 35 |
def __notify_handlers(self, type, key, value=None): |
| 36 |
def notify_handlers(): |
| 37 |
for handler in self.__event_handlers: |
| 38 |
if callable(handler): |
| 39 |
if type == StateEventType.CHANGE: |
| 40 |
handler(type, key, value) |
| 41 |
elif type == StateEventType.DELETE: |
| 42 |
handler(type, key, value) |
| 43 |
|
| 44 |
t = Thread(target=notify_handlers) |
| 45 |
t.start() |
| 46 |
|
| 47 |
def _set_state_value(self, key, value, should_update_js=True): |
| 48 |
"""Internal method to set state values, used by both __setattr__ and __setitem__""" |
| 49 |
|
| 50 |
def update_and_notify(): |
| 51 |
self.__update_js(key, value) |
| 52 |
self.__notify_handlers(StateEventType.CHANGE, key, value) |
| 53 |
|
| 54 |
if key not in self or super().get(key) != value: |
| 55 |
super().__setitem__(key, value) |
| 56 |
|
| 57 |
if not should_update_js: |
| 58 |
self.__notify_handlers(StateEventType.CHANGE, key, value) |
| 59 |
return |
| 60 |
|
| 61 |
if self.__window.events.loaded.is_set(): |
| 62 |
update_and_notify() |
| 63 |
else: |
| 64 |
self.__window.events.loaded += update_and_notify |
| 65 |
|
| 66 |
def __setattr__(self, key, value, should_update_js=True): |
| 67 |
if key.startswith('_State__'): |
| 68 |
super().__setattr__(key, value) |
| 69 |
return |
| 70 |
|
| 71 |
self._set_state_value(key, value, should_update_js) |
| 72 |
|
| 73 |
def __getattr__(self, key): |
| 74 |
if key in self: |
| 75 |
return self[key] |
| 76 |
raise AttributeError(f"'{type(self).__key__}' object has no attribute '{key}'") |
| 77 |
|
| 78 |
def _delete_state_value(self, key, should_update_js=True): |
| 79 |
"""Internal method to delete state values, used by both __delattr__ and __delitem__""" |
| 80 |
if key in self: |
| 81 |
old_value = self[key] |
| 82 |
super().__delitem__(key) |
| 83 |
|
| 84 |
if should_update_js: |
| 85 |
special_key = '__pywebviewHaltUpdate__' + key |
| 86 |
self.__window.run_js(f'delete window.pywebview.state.{special_key}') |
| 87 |
|
| 88 |
self.__notify_handlers(StateEventType.DELETE, key, old_value) |
| 89 |
return old_value |
| 90 |
return None |
| 91 |
|
| 92 |
def __delattr__(self, key): |
| 93 |
if key.startswith('__pywebviewHaltUpdate__'): |
| 94 |
key = key.replace('__pywebviewHaltUpdate__', '') |
| 95 |
halt_update = True |
| 96 |
else: |
| 97 |
halt_update = False |
| 98 |
|
| 99 |
old_value = self._delete_state_value(key, should_update_js=not halt_update) |
| 100 |
if old_value is None: |
| 101 |
raise AttributeError(f"'{type(self).__name__}' object has no attribute '{key}'") |
| 102 |
|
| 103 |
def __getitem__(self, key): |
| 104 |
"""Support dictionary-style access: state['key']""" |
| 105 |
return super().__getitem__(key) |
| 106 |
|
| 107 |
def __setitem__(self, key, value): |
| 108 |
"""Support dictionary-style assignment: state['key'] = value""" |
| 109 |
self._set_state_value(key, value, should_update_js=True) |
| 110 |
|
| 111 |
def __delitem__(self, key): |
| 112 |
"""Support dictionary-style deletion: del state['key']""" |
| 113 |
old_value = self._delete_state_value(key, should_update_js=True) |
| 114 |
if old_value is None: |
| 115 |
raise KeyError(key) |
| 116 |
|
| 117 |
def __add__(self, item: Callable[..., Any]) -> Self: |
| 118 |
self.__event_handlers.append(item) |
| 119 |
return self |
| 120 |
|
| 121 |
def __sub__(self, item: Callable[..., Any]) -> Self: |
| 122 |
self.__event_handlers.remove(item) |
| 123 |
return self |
| 124 |
|
| 125 |
def __iadd__(self, item: Callable[..., Any]) -> Self: |
| 126 |
self.__event_handlers.append(item) |
| 127 |
return self |
| 128 |
|
| 129 |
def __isub__(self, item: Callable[..., Any]) -> Self: |
| 130 |
self.__event_handlers.remove(item) |
| 131 |
return self |