meltygui 0.1.0__py3-none-any.whl

meltygui/core/windowing/window_api.py

@@ -0,0 +1,62 @@
+"""Window operations shared by native Wayland and GLFW surfaces.
+
+GLFW's constants and callback signatures remain the compatibility vocabulary.
+The selected backend owns all windows in an app's GL share group. Merely
+importing this module does not initialize GLFW or connect to a display.
+"""
+import importlib
+import os
+import sys
+import meltygui.core.windowing.window_constants as window_constants
+
+_state = globals().get('_state') or {'backend': None, 'selected': False}
+
+
+def use_native_windows(enabled, environment=None, platform=None):
+    environment = os.environ if environment is None else environment
+    platform = sys.platform if platform is None else platform
+    return bool(enabled and platform.startswith('linux') and
+                (environment.get('WAYLAND_DISPLAY') or environment.get('WAYLAND_SOCKET')))
+
+
+def select_backend(enabled):
+    if _state['selected']:
+        return backend_name()
+    if use_native_windows(enabled):
+        from meltygui.core.windowing.backends.native_wayland import Backend
+        _state['backend'] = Backend()
+    _state['selected'] = True
+    return backend_name()
+
+
+def backend_name():
+    return 'wayland' if _state['backend'] is not None else 'glfw'
+
+
+def is_native_window(window):
+    # Inspect the class marker, not a truthy instance attribute: MagicMock
+    # manufactures attributes and must never pass as a real window handle.
+    return getattr(type(window), 'native_wayland', False) is True
+
+
+def terminate():
+    backend = _state['backend']
+    try:
+        (backend or importlib.import_module('glfw')).terminate()
+    finally:
+        _state.update(backend=None, selected=False)
+
+
+def __getattr__(name):
+    # Source analysis and intros probe module metadata. Forwarding a missing
+    # __module__/__wrapped__/__path__ to GLFW loads its shared library merely
+    # to discover that GLFW does not supply such metadata either.
+    if name.startswith('__'):
+        raise AttributeError(name)
+    if name.isupper() and hasattr(window_constants, name):
+        return getattr(window_constants, name)
+    backend = _state['backend']
+    if backend is not None and not name.isupper() and not name.startswith('_'):
+        # Never send native handles to GLFW's C functions by accident.
+        return getattr(backend, name)
+    return getattr(importlib.import_module('glfw'), name)

meltygui/core/windowing/window_constants.py

@@ -0,0 +1,339 @@
+"""GLFW 3.4 numeric API constants used by the shared window facade.
+
+Generated from pyGLFW 2.10.2. These protocol/API values do not require loading
+GLFW's shared library. tests/test_native_windows.py checks them against pyGLFW;
+update this table when adopting new GLFW API constants.
+"""
+
+ACCUM_ALPHA_BITS = 135178
+ACCUM_BLUE_BITS = 135177
+ACCUM_GREEN_BITS = 135176
+ACCUM_RED_BITS = 135175
+ALPHA_BITS = 135172
+ANGLE_PLATFORM_TYPE = 327682
+ANGLE_PLATFORM_TYPE_D3D11 = 225285
+ANGLE_PLATFORM_TYPE_D3D9 = 225284
+ANGLE_PLATFORM_TYPE_METAL = 225288
+ANGLE_PLATFORM_TYPE_NONE = 225281
+ANGLE_PLATFORM_TYPE_OPENGL = 225282
+ANGLE_PLATFORM_TYPE_OPENGLES = 225283
+ANGLE_PLATFORM_TYPE_VULKAN = 225287
+ANY_PLATFORM = 393216
+ANY_POSITION = 2147483648
+ANY_RELEASE_BEHAVIOR = 0
+API_UNAVAILABLE = 65542
+ARROW_CURSOR = 221185
+AUTO_ICONIFY = 131078
+AUX_BUFFERS = 135179
+BLUE_BITS = 135171
+CENTER_CURSOR = 131081
+CLIENT_API = 139265
+COCOA_CHDIR_RESOURCES = 331777
+COCOA_FRAME_NAME = 143362
+COCOA_GRAPHICS_SWITCHING = 143363
+COCOA_MENUBAR = 331778
+COCOA_RETINA_FRAMEBUFFER = 143361
+CONNECTED = 262145
+CONTEXT_CREATION_API = 139275
+CONTEXT_DEBUG = 139271
+CONTEXT_NO_ERROR = 139274
+CONTEXT_RELEASE_BEHAVIOR = 139273
+CONTEXT_REVISION = 139268
+CONTEXT_ROBUSTNESS = 139269
+CONTEXT_VERSION_MAJOR = 139266
+CONTEXT_VERSION_MINOR = 139267
+CROSSHAIR_CURSOR = 221187
+CURSOR = 208897
+CURSOR_CAPTURED = 212996
+CURSOR_DISABLED = 212995
+CURSOR_HIDDEN = 212994
+CURSOR_NORMAL = 212993
+CURSOR_UNAVAILABLE = 65547
+DECORATED = 131077
+DEPTH_BITS = 135173
+DISCONNECTED = 262146
+DONT_CARE = -1
+DOUBLEBUFFER = 135184
+EGL_CONTEXT_API = 221186
+FALSE = 0
+FEATURE_UNAVAILABLE = 65548
+FEATURE_UNIMPLEMENTED = 65549
+FLOATING = 131079
+FOCUSED = 131073
+FOCUS_ON_SHOW = 131084
+FORMAT_UNAVAILABLE = 65545
+GAMEPAD_AXIS_LAST = 5
+GAMEPAD_AXIS_LEFT_TRIGGER = 4
+GAMEPAD_AXIS_LEFT_X = 0
+GAMEPAD_AXIS_LEFT_Y = 1
+GAMEPAD_AXIS_RIGHT_TRIGGER = 5
+GAMEPAD_AXIS_RIGHT_X = 2
+GAMEPAD_AXIS_RIGHT_Y = 3
+GAMEPAD_BUTTON_A = 0
+GAMEPAD_BUTTON_B = 1
+GAMEPAD_BUTTON_BACK = 6
+GAMEPAD_BUTTON_CIRCLE = 1
+GAMEPAD_BUTTON_CROSS = 0
+GAMEPAD_BUTTON_DPAD_DOWN = 13
+GAMEPAD_BUTTON_DPAD_LEFT = 14
+GAMEPAD_BUTTON_DPAD_RIGHT = 12
+GAMEPAD_BUTTON_DPAD_UP = 11
+GAMEPAD_BUTTON_GUIDE = 8
+GAMEPAD_BUTTON_LAST = 14
+GAMEPAD_BUTTON_LEFT_BUMPER = 4
+GAMEPAD_BUTTON_LEFT_THUMB = 9
+GAMEPAD_BUTTON_RIGHT_BUMPER = 5
+GAMEPAD_BUTTON_RIGHT_THUMB = 10
+GAMEPAD_BUTTON_SQUARE = 2
+GAMEPAD_BUTTON_START = 7
+GAMEPAD_BUTTON_TRIANGLE = 3
+GAMEPAD_BUTTON_X = 2
+GAMEPAD_BUTTON_Y = 3
+GREEN_BITS = 135170
+HAND_CURSOR = 221188
+HAT_CENTERED = 0
+HAT_DOWN = 4
+HAT_LEFT = 8
+HAT_LEFT_DOWN = 12
+HAT_LEFT_UP = 9
+HAT_RIGHT = 2
+HAT_RIGHT_DOWN = 6
+HAT_RIGHT_UP = 3
+HAT_UP = 1
+HOVERED = 131083
+HRESIZE_CURSOR = 221189
+IBEAM_CURSOR = 221186
+ICONIFIED = 131074
+INVALID_ENUM = 65539
+INVALID_VALUE = 65540
+JOYSTICK_1 = 0
+JOYSTICK_10 = 9
+JOYSTICK_11 = 10
+JOYSTICK_12 = 11
+JOYSTICK_13 = 12
+JOYSTICK_14 = 13
+JOYSTICK_15 = 14
+JOYSTICK_16 = 15
+JOYSTICK_2 = 1
+JOYSTICK_3 = 2
+JOYSTICK_4 = 3
+JOYSTICK_5 = 4
+JOYSTICK_6 = 5
+JOYSTICK_7 = 6
+JOYSTICK_8 = 7
+JOYSTICK_9 = 8
+JOYSTICK_HAT_BUTTONS = 327681
+JOYSTICK_LAST = 15
+KEY_0 = 48
+KEY_1 = 49
+KEY_2 = 50
+KEY_3 = 51
+KEY_4 = 52
+KEY_5 = 53
+KEY_6 = 54
+KEY_7 = 55
+KEY_8 = 56
+KEY_9 = 57
+KEY_A = 65
+KEY_APOSTROPHE = 39
+KEY_B = 66
+KEY_BACKSLASH = 92
+KEY_BACKSPACE = 259
+KEY_C = 67
+KEY_CAPS_LOCK = 280
+KEY_COMMA = 44
+KEY_D = 68
+KEY_DELETE = 261
+KEY_DOWN = 264
+KEY_E = 69
+KEY_END = 269
+KEY_ENTER = 257
+KEY_EQUAL = 61
+KEY_ESCAPE = 256
+KEY_F = 70
+KEY_F1 = 290
+KEY_F10 = 299
+KEY_F11 = 300
+KEY_F12 = 301
+KEY_F13 = 302
+KEY_F14 = 303
+KEY_F15 = 304
+KEY_F16 = 305
+KEY_F17 = 306
+KEY_F18 = 307
+KEY_F19 = 308
+KEY_F2 = 291
+KEY_F20 = 309
+KEY_F21 = 310
+KEY_F22 = 311
+KEY_F23 = 312
+KEY_F24 = 313
+KEY_F25 = 314
+KEY_F3 = 292
+KEY_F4 = 293
+KEY_F5 = 294
+KEY_F6 = 295
+KEY_F7 = 296
+KEY_F8 = 297
+KEY_F9 = 298
+KEY_G = 71
+KEY_GRAVE_ACCENT = 96
+KEY_H = 72
+KEY_HOME = 268
+KEY_I = 73
+KEY_INSERT = 260
+KEY_J = 74
+KEY_K = 75
+KEY_KP_0 = 320
+KEY_KP_1 = 321
+KEY_KP_2 = 322
+KEY_KP_3 = 323
+KEY_KP_4 = 324
+KEY_KP_5 = 325
+KEY_KP_6 = 326
+KEY_KP_7 = 327
+KEY_KP_8 = 328
+KEY_KP_9 = 329
+KEY_KP_ADD = 334
+KEY_KP_DECIMAL = 330
+KEY_KP_DIVIDE = 331
+KEY_KP_ENTER = 335
+KEY_KP_EQUAL = 336
+KEY_KP_MULTIPLY = 332
+KEY_KP_SUBTRACT = 333
+KEY_L = 76
+KEY_LAST = 348
+KEY_LEFT = 263
+KEY_LEFT_ALT = 342
+KEY_LEFT_BRACKET = 91
+KEY_LEFT_CONTROL = 341
+KEY_LEFT_SHIFT = 340
+KEY_LEFT_SUPER = 343
+KEY_M = 77
+KEY_MENU = 348
+KEY_MINUS = 45
+KEY_N = 78
+KEY_NUM_LOCK = 282
+KEY_O = 79
+KEY_P = 80
+KEY_PAGE_DOWN = 267
+KEY_PAGE_UP = 266
+KEY_PAUSE = 284
+KEY_PERIOD = 46
+KEY_PRINT_SCREEN = 283
+KEY_Q = 81
+KEY_R = 82
+KEY_RIGHT = 262
+KEY_RIGHT_ALT = 346
+KEY_RIGHT_BRACKET = 93
+KEY_RIGHT_CONTROL = 345
+KEY_RIGHT_SHIFT = 344
+KEY_RIGHT_SUPER = 347
+KEY_S = 83
+KEY_SCROLL_LOCK = 281
+KEY_SEMICOLON = 59
+KEY_SLASH = 47
+KEY_SPACE = 32
+KEY_T = 84
+KEY_TAB = 258
+KEY_U = 85
+KEY_UNKNOWN = -1
+KEY_UP = 265
+KEY_V = 86
+KEY_W = 87
+KEY_WORLD_1 = 161
+KEY_WORLD_2 = 162
+KEY_X = 88
+KEY_Y = 89
+KEY_Z = 90
+LOCK_KEY_MODS = 208900
+LOSE_CONTEXT_ON_RESET = 200706
+MAXIMIZED = 131080
+MOD_ALT = 4
+MOD_CAPS_LOCK = 16
+MOD_CONTROL = 2
+MOD_NUM_LOCK = 32
+MOD_SHIFT = 1
+MOD_SUPER = 8
+MOUSE_BUTTON_1 = 0
+MOUSE_BUTTON_2 = 1
+MOUSE_BUTTON_3 = 2
+MOUSE_BUTTON_4 = 3
+MOUSE_BUTTON_5 = 4
+MOUSE_BUTTON_6 = 5
+MOUSE_BUTTON_7 = 6
+MOUSE_BUTTON_8 = 7
+MOUSE_BUTTON_LAST = 7
+MOUSE_BUTTON_LEFT = 0
+MOUSE_BUTTON_MIDDLE = 2
+MOUSE_BUTTON_RIGHT = 1
+MOUSE_PASSTHROUGH = 131085
+NATIVE_CONTEXT_API = 221185
+NOT_ALLOWED_CURSOR = 221194
+NOT_INITIALIZED = 65537
+NO_API = 0
+NO_CURRENT_CONTEXT = 65538
+NO_ERROR = 0
+NO_RESET_NOTIFICATION = 200705
+NO_ROBUSTNESS = 0
+NO_WINDOW_CONTEXT = 65546
+OPENGL_ANY_PROFILE = 0
+OPENGL_API = 196609
+OPENGL_COMPAT_PROFILE = 204802
+OPENGL_CORE_PROFILE = 204801
+OPENGL_DEBUG_CONTEXT = 139271
+OPENGL_ES_API = 196610
+OPENGL_FORWARD_COMPAT = 139270
+OPENGL_PROFILE = 139272
+OSMESA_CONTEXT_API = 221187
+OUT_OF_MEMORY = 65541
+PLATFORM = 327683
+PLATFORM_COCOA = 393218
+PLATFORM_ERROR = 65544
+PLATFORM_NULL = 393221
+PLATFORM_UNAVAILABLE = 65550
+PLATFORM_WAYLAND = 393219
+PLATFORM_WIN32 = 393217
+PLATFORM_X11 = 393220
+POINTING_HAND_CURSOR = 221188
+POSITION_X = 131086
+POSITION_Y = 131087
+PRESS = 1
+RAW_MOUSE_MOTION = 208901
+RED_BITS = 135169
+REFRESH_RATE = 135183
+RELEASE = 0
+RELEASE_BEHAVIOR_FLUSH = 217089
+RELEASE_BEHAVIOR_NONE = 217090
+REPEAT = 2
+RESIZABLE = 131075
+RESIZE_ALL_CURSOR = 221193
+RESIZE_EW_CURSOR = 221189
+RESIZE_NESW_CURSOR = 221192
+RESIZE_NS_CURSOR = 221190
+RESIZE_NWSE_CURSOR = 221191
+SAMPLES = 135181
+SCALE_FRAMEBUFFER = 139277
+SCALE_TO_MONITOR = 139276
+SRGB_CAPABLE = 135182
+STENCIL_BITS = 135174
+STEREO = 135180
+STICKY_KEYS = 208898
+STICKY_MOUSE_BUTTONS = 208899
+TRANSPARENT_FRAMEBUFFER = 131082
+TRUE = 1
+VERSION_MAJOR = 3
+VERSION_MINOR = 4
+VERSION_REVISION = 0
+VERSION_UNAVAILABLE = 65543
+VISIBLE = 131076
+VRESIZE_CURSOR = 221190
+WAYLAND_APP_ID = 155649
+WAYLAND_DISABLE_LIBDECOR = 229378
+WAYLAND_LIBDECOR = 339969
+WAYLAND_PREFER_LIBDECOR = 229377
+WIN32_KEYBOARD_MENU = 151553
+WIN32_SHOWDEFAULT = 151554
+X11_CLASS_NAME = 147457
+X11_INSTANCE_NAME = 147458
+X11_XCB_VULKAN_SURFACE = 335873

meltygui/core/windowing/window_visibility.py

@@ -0,0 +1,162 @@
+"""Visibility contract shared by nested Melty and GLFW child windows."""
+
+
+def requested_window_closed(closed, kwargs, *, first_request=False):
+    if first_request and 'open_requested' in kwargs:
+        closed = True
+    if kwargs.get('closed') is not None:
+        closed = bool(kwargs['closed'])
+    if kwargs.get('open_requested'):
+        closed = False
+    return closed
+
+
+from meltygui.core.conversion.dict_conversion import DictConversion
+
+
+class WindowOverrideState(DictConversion):
+    """View-local source tracking; automatic geometry corrections aren't edits."""
+    def __init__(self):
+        super().__init__()
+        self.position = None
+        self.comment_closed = None
+        self.pending_marker_closed = None
+        self.native_kwargs = None
+        self.comment_values = None
+
+
+def override_state(draw_state):
+    state = draw_state.misc.get('window_overrides')
+    if state is None:
+        state = WindowOverrideState()
+        draw_state.misc['window_overrides'] = state
+    return state
+
+
+def resolved_window_kwargs(draw_state, kwargs):
+    from meltygui.core.rendering.parameter_core import anywhere_value
+    resolved = kwargs
+    pending = getattr(draw_state, '_sa_pending', None) or {}
+    for name in ('closed', 'window_pos'):
+        if name in kwargs or name in pending:
+            if resolved is kwargs:
+                resolved = dict(kwargs)
+            resolved[name] = anywhere_value(name, draw_state, live_kwargs=kwargs)
+    return resolved
+
+
+def _comment_value(value):
+    """Snapshot small annotation values without comparing opaque model data."""
+    if isinstance(value, (str, int, float, bool, type(None))):
+        return type(value), value
+    if isinstance(value, (tuple, list)):
+        return type(value), tuple(_comment_value(item) for item in value)
+    if isinstance(value, dict):
+        return tuple((key, _comment_value(item)) for key, item in value.items())
+    return type(value), id(value)
+
+
+def invalidate_comment_edit(draw_state, comment_args, kwargs):
+    """Repaint a replayed live window once when its driving comment changes."""
+    from meltygui.core.melty import Melty
+    state = override_state(draw_state)
+    current = {key: _comment_value(value) for key, value in comment_args.items()
+               if key != 'closed' and not (isinstance(key, str) and key.startswith('__'))}
+    previous = state.comment_values
+    if previous is not None:
+        for key in previous.keys() - current.keys():
+            if key in kwargs and _comment_value(kwargs[key]) == previous[key]:
+                kwargs.pop(key)
+        if previous != current:
+            Melty.cache.invalidate_up(draw_state._tile_id, force=True, max_depth=8)
+    state.comment_values = current
+
+
+def sync_live_comment_inputs(draw_state, kwargs):
+    root = draw_state.__dict__.get('live_root')
+    key = draw_state.__dict__.get('live_key')
+    if not isinstance(root, dict) or not key:
+        return
+    if draw_state.__dict__.get('_lv_locator') is not None:
+        from meltygui.editor.live_view_views import current_live_root
+        root = current_live_root(draw_state)
+    comment = root.get('__overrides__', {}).get(f'__{key}__') if isinstance(root, dict) else None
+    invalidate_comment_edit(draw_state, comment if isinstance(comment, dict) else {}, kwargs)
+
+
+def adopt_window_position(draw_state, kwargs):
+    """Adopt changed source positions, not the same value on every frame.
+
+    In particular an off-screen rescue or pin collision stays local rather
+    than snapping back each frame or writing itself into source code.
+    """
+    position = kwargs.get('window_pos')
+    if position is None:
+        return
+    position = tuple(int(v) for v in position)
+    state = override_state(draw_state)
+    if state.position != position:
+        state.position = position
+        draw_state.window_pos = position
+
+
+def user_window_closed(draw_state, closed):
+    """Only a user's close/open action writes back to the driving source."""
+    draw_state.locate_closed = bool(closed)
+    draw_state.closed = bool(closed)
+
+
+def user_window_position(draw_state, position):
+    position = tuple(round(v) for v in position)
+    draw_state.locate_window_pos = position
+    draw_state.window_pos = position
+
+
+def native_user_window_closed(draw_state, closed):
+    # The native surface renders an inline root with different kwargs. Source
+    # discovery for its controls must see the parent-side window request.
+    state = override_state(draw_state)
+    original = draw_state._kwargs
+    if state.native_kwargs is not None:
+        draw_state._kwargs = state.native_kwargs
+    try:
+        user_window_closed(draw_state, closed)
+    finally:
+        draw_state._kwargs = original
+
+
+def native_user_window_position(draw_state, position):
+    state = override_state(draw_state)
+    original = draw_state._kwargs
+    if state.native_kwargs is not None:
+        draw_state._kwargs = state.native_kwargs
+    try:
+        draw_state.locate_window_pos = tuple(round(v) for v in position)
+    finally:
+        draw_state._kwargs = original
+
+
+def marker_user_visibility(marker, closed):
+    state = override_state(marker)
+    window = getattr(marker, '_lv_window_ds', None)
+    if window is None:
+        state.pending_marker_closed = bool(closed)
+    else:
+        user_window_closed(window, closed)
+
+
+def sync_marker_visibility(marker, comment_args):
+    state = override_state(marker)
+    closed = comment_args.pop('closed', None)
+    closed = None if closed is None else bool(closed)
+    if state.comment_closed != closed:
+        state.comment_closed = closed
+        marker._lv_open = None if closed is None else not closed
+        window = getattr(marker, '_lv_window_ds', None)
+        if window is not None:
+            window.closed = bool(closed)
+
+
+def window_edit_is_local(draw_state, parameter):
+    source = (getattr(draw_state, '_sa_last_source', None) or {}).get(parameter)
+    return source in (None, 'draw state')

meltygui/debug/app_view_utils.py

@@ -0,0 +1,9 @@
+from meltygui.core.styling.global_style import GlobalStyle
+
+
+def should_exclude(name, root=None):
+
+    global_exclude = GlobalStyle.excluded_names
+
+    exclude = name.startswith('_') or name.endswith('_h') or name in global_exclude or name.startswith('p_')
+    return exclude

meltygui/editor/bash_syntax.py

@@ -0,0 +1,30 @@
+"""Bash tokens in the text editor's palette, cached by source identity."""
+from bisect import bisect_right
+from pygments.lexers import BashLexer
+from pygments.token import Comment, Keyword, Name, Number, String
+
+
+def window_tokens(state, text, offsets, first, last):
+    memo = getattr(state, '_bash_tokens', None)
+    if memo is None or memo[0] is not text:
+        tokens = []
+        for offset, kind, value in BashLexer().get_tokens_unprocessed(text):
+            color = ('comment' if kind in Comment else 'keyword' if kind in Keyword else
+                     'builtin' if kind in Name.Builtin else 'builtin_pseudo' if kind in Name.Variable else
+                     'string' if kind in String else 'number' if kind in Number else 'default')
+            tokens.append((offset, value, color))
+        memo = (text, tokens, [token[0] for token in tokens])
+        state._bash_tokens = memo
+    first = min(max(0, first), len(offsets) - 1)
+    last = min(last, len(offsets) - 1)
+    start = offsets[first]
+    end = offsets[last + 1] if last + 1 < len(offsets) else len(text)
+    result = []
+    for index in range(max(0, bisect_right(memo[2], start) - 1), len(memo[1])):
+        offset, value, color = memo[1][index]
+        if offset >= end:
+            break
+        part = value[max(0, start - offset):end - offset]
+        if part:
+            result.append((part, color))
+    return first, start, result