Debian Codegraph @

tests/android/webview/state.py

raw
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