goome 0.4.0__py3-none-win_amd64.whl

goome/__init__.py

@@ -0,0 +1,38 @@
+from .core import (
+    ALT, AUTO, BACKENDS, CAP_CAPTURE, CAP_CLIPBOARD, CAP_CURSOR, CAP_GLOBAL_POINTER, CAP_GRAB, CAP_HIDE_SELF, CAP_HOTKEYS,
+    CAP_KEYBOARD, CAP_WINDOW, CLOSE, CONTROL, CTRL, CURSOR_ARROW, CURSOR_HAND, CURSOR_HIDDEN, CURSOR_IBEAM, CURSOR_MOVE,
+    CURSOR_NAMES, CURSOR_NO, CURSOR_RESIZE_EW, CURSOR_RESIZE_NESW, CURSOR_RESIZE_NS, CURSOR_RESIZE_NWSE, CURSOR_WAIT, DOWN,
+    DROP, EAGAIN, FMT_BGRA, FMT_BGRA_PREMUL, FMT_RGBA, FMT_RGBA_PREMUL, EARG, EDENIED, EDGE_BOTTOM, EDGE_LEFT, EDGE_RIGHT, EDGE_TOP, EGONE, ENODISPLAY, ENOMEM, ENOTSUP, FOCUS,
+    GNOME, HOTKEY, K_BACKSPACE, K_DELETE, K_DOWN, K_END, K_ENTER, K_ESC, K_F1, K_F12, K_HOME, K_INSERT, K_LEFT, K_PGDN,
+    K_PGUP, K_RIGHT, K_SPACE, K_TAB, K_UP, KEY, MACOS, MODE_OFFSCREEN, MODE_OVERLAY, MODE_WINDOW, MODES, MONITORS, MOTION,
+    NONE, OFFSCREEN, OK, PORTAL, QUIT, SCROLL, SHIFT, STATE_FULLSCREEN, STATE_MAXIMIZED, STATE_MINIMIZED, STATE_NORMAL,
+    SUPER, TEST, UP, VERSION, WANT_KEYBOARD, WANT_MOUSE, WAYLAND, WIN32, WINDOW_BORDERLESS, WINDOW_CENTER, WINDOW_HIDDEN,
+    WINDOW_ON_TOP, WINDOW_RESIZABLE, WINDOW_TRANSPARENT, X11, Again, BadArg, Denied, Event, Frame, Goome, GoomeError, Gone, Image, Monitor,
+    NoDisplay, NoMemory, NotSupported, Pacer, Pointer, Rect, now_ms, open, open_app, open_offscreen, parse_combo, save_ppm,
+    send, strerror,
+)
+from .draw import Bitmap, Canvas, Font, Radii, font_count, line_height, measure, radius, set_font
+from .ui import (
+    APP_MENUBAR, APP_NO_PAD, APP_STATUSBAR, APP_TITLEBAR, EDIT_LINE_NUMBERS, EDIT_MONO, EDIT_READONLY, EDIT_WRAP,
+    ITEM_DRAG_X, ITEM_DRAG_Y, ITEM_FOCUSABLE, ITEM_NO_HIT, ITEM_REPEAT, S_ACCENT, S_ACCENT_TEXT, S_ACTIVE, S_ANIM_MS, S_BG,
+    S_BORDER, S_BORDER_WIDTH, S_COUNT, S_FONT_SIZE, S_GAP, S_HOVER, S_INPUT_BG, S_PAD, S_PANEL, S_RADIUS, S_SHADOW,
+    S_SHADOW_BLUR, S_TEXT, S_TEXT_DIM, SKIN_BUTTON, SKIN_CHECKBOX, SKIN_COUNT, SKIN_INPUT, SKIN_MENU, SKIN_PANEL, SKIN_POPUP,
+    SKIN_RADIO, SKIN_SCROLLBAR, SKIN_SLIDER_FILL, SKIN_SLIDER_TRACK, SKIN_TAB, SKIN_TITLEBAR, SKIN_TOGGLE, SKIN_TOOLTIP,
+    ICON_ARROW_DOWN, ICON_ARROW_LEFT, ICON_ARROW_RIGHT, ICON_ARROW_UP, ICON_CHECK, ICON_CLOSE, ICON_COLLAPSE, ICON_COUNT,
+    ICON_DRAG_HANDLE, ICON_EXPAND, ICON_MAXIMIZE, ICON_MINIMIZE, ICON_MINUS, ICON_NAMES, ICON_PICKER, ICON_PLUS, ICON_RADIO_DOT,
+    ICON_RESIZE, ICON_RESTORE, ICON_SLIDER_KNOB, ICON_SORT_DOWN, ICON_SORT_UP, ICON_TOAST, ICON_TOGGLE_KNOB, Icons, Item,
+    TABLE_BORDERS, TABLE_RESIZABLE, TABLE_SORTABLE, TABLE_STRIPES, WIN_CLOSE, WIN_COLLAPSE, WIN_MOVE, WIN_NO_TITLE,
+    WIN_RESIZE, ACT_NAMES, ALIGN_NAMES, CUR_NAMES, EASE_NAMES, PRESET_NAMES, STYLE_NAMES, Config, Cursors, Flag, Skin, Sort,
+    Split, Theme, Ui, Window,
+)
+from . import ui as _ui
+
+for _n in dir(_ui):
+    if _n.split("_")[0] in ("S", "INPUT", "ALIGN", "EASE", "PRESET", "ACT", "CUR") and _n.isupper():
+        globals()[_n] = getattr(_ui, _n)
+from .app import App
+from ._lib import path as lib_path
+
+__version__ = VERSION
+
+__all__ = [n for n in dir() if not n.startswith("_") and n not in ("open", "core", "draw", "ui", "app")]

goome/_lib.py

@@ -0,0 +1,453 @@
+import ctypes
+import os
+import sys
+from ctypes import (
+    CFUNCTYPE,
+    POINTER,
+    Structure,
+    c_char,
+    c_char_p,
+    c_double,
+    c_float,
+    c_int,
+    c_long,
+    c_size_t,
+    c_uint32,
+    c_void_p,
+)
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+
+
+def lib_name():
+    if sys.platform == "win32":
+        return "goome.dll"
+    if sys.platform == "darwin":
+        return "libgoome.dylib"
+    return "libgoome.so"
+
+
+class Opts(Structure):
+    _fields_ = [
+        ("title", c_char_p),
+        ("backend", c_int),
+        ("state_dir", c_char_p),
+        ("no_capture", c_int),
+        ("capture_fps", c_int),
+        ("hide_self", c_int),
+        ("test_frames", c_char_p),
+        ("test_script", c_char_p),
+        ("test_shots", c_char_p),
+        ("mode", c_int),
+        ("width", c_int),
+        ("height", c_int),
+        ("min_width", c_int),
+        ("min_height", c_int),
+        ("window_flags", c_int),
+        ("scale", c_double),
+    ]
+
+
+class RectS(Structure):
+    _fields_ = [("x", c_int), ("y", c_int), ("w", c_int), ("h", c_int)]
+
+
+class MonitorS(Structure):
+    _fields_ = [
+        ("id", c_int),
+        ("name", c_char * 64),
+        ("area", RectS),
+        ("scale", c_double),
+        ("pw", c_int),
+        ("ph", c_int),
+        ("rotation", c_int),
+    ]
+
+
+class ImageS(Structure):
+    _fields_ = [
+        ("px", POINTER(c_uint32)),
+        ("w", c_int),
+        ("h", c_int),
+        ("stride", c_int),
+        ("area", RectS),
+        ("mon", c_int),
+        ("has_self", c_int),
+        ("has_cursor", c_int),
+        ("cursor", RectS),
+    ]
+
+
+class CanvasS(Structure):
+    _fields_ = [
+        ("px", POINTER(c_uint32)),
+        ("w", c_int),
+        ("h", c_int),
+        ("stride", c_int),
+        ("ox", c_double),
+        ("oy", c_double),
+        ("scale", c_double),
+        ("mon", c_int),
+        ("dx0", c_int),
+        ("dy0", c_int),
+        ("dx1", c_int),
+        ("dy1", c_int),
+        ("cx0", c_int),
+        ("cy0", c_int),
+        ("cx1", c_int),
+        ("cy1", c_int),
+        ("kx0", c_int),
+        ("ky0", c_int),
+        ("kx1", c_int),
+        ("ky1", c_int),
+        ("nclip", c_int),
+        ("clips", (c_int * 4) * 16),
+    ]
+
+
+class EventS(Structure):
+    _fields_ = [
+        ("type", c_int),
+        ("x", c_double),
+        ("y", c_double),
+        ("mon", c_int),
+        ("button", c_int),
+        ("dy", c_int),
+        ("key", c_int),
+        ("mods", c_int),
+        ("text", c_char * 8),
+        ("id", c_int),
+        ("msg", c_char * 64),
+    ]
+
+
+class PacerS(Structure):
+    _fields_ = [("next", c_long), ("fps", c_int)]
+
+
+class RadiiS(Structure):
+    _fields_ = [("tl", c_double), ("tr", c_double), ("br", c_double), ("bl", c_double)]
+
+
+class BitmapS(Structure):
+    _fields_ = [
+        ("px", POINTER(c_uint32)),
+        ("w", c_int),
+        ("h", c_int),
+        ("stride", c_int),
+        ("owned", c_int),
+    ]
+
+
+class SkinS(Structure):
+    _fields_ = [("bm", POINTER(BitmapS)), ("l", c_double), ("t", c_double), ("r", c_double), ("b", c_double)]
+
+
+THEME_SKINS = ("skin_button", "skin_panel", "skin_input", "skin_checkbox", "skin_radio", "skin_toggle", "skin_slider", "skin_slider_fill",
+               "skin_scrollbar", "skin_tab", "skin_titlebar", "skin_tooltip", "skin_menu", "skin_popup")
+ICON_COUNT = 22
+BASE_COLORS = ("bg", "panel", "border", "text", "text_dim", "accent", "accent_text", "hover", "active", "input_bg", "shadow")
+BASE_SIZES = ("radius", "pad", "gap", "border_width", "font_size", "shadow_blur", "anim_ms")
+MORE_COLORS = ("focus", "select", "caret", "link", "badge", "toast", "tooltip", "danger", "knob", "dim")
+MORE_SIZES = ("check_size", "check_radius", "toggle_w", "toggle_h", "slider_h", "slider_track", "knob_size",
+              "scroll_w", "scroll_min", "item_h", "menu_item_h", "tab_h", "win_title_h", "app_title_h", "menubar_h", "statusbar_h",
+              "focus_w", "focus_gap", "sep_w", "grip", "indent", "plot_w", "spinner", "caret_w",
+              "win_min_w", "win_min_h", "pop_gap", "menu_gap", "tip_pad_x", "tip_pad_y", "tip_x", "tip_y", "tip_radius",
+              "shadow_x", "shadow_y", "align", "heading_size", "small_size", "ease",
+              "hover_ms", "press_ms", "popup_ms", "collapse_ms", "toast_fade_ms")
+THEME_COLORS = BASE_COLORS + MORE_COLORS
+THEME_SIZES = BASE_SIZES + MORE_SIZES
+STYLE_NAMES = BASE_COLORS + BASE_SIZES + MORE_COLORS + MORE_SIZES
+THEME_FONTS = ("font", "font_heading", "font_mono", "font_small")
+
+
+class ThemeS(Structure):
+    _fields_ = [(n, c_uint32) for n in BASE_COLORS] + [(n, c_double) for n in BASE_SIZES] + [("font", c_void_p)] + [(n, SkinS) for n in THEME_SKINS[:3]] + [
+        ("icon", POINTER(BitmapS) * ICON_COUNT), ("icon_tint", c_uint32)] + [(n, SkinS) for n in THEME_SKINS[3:]] + [
+        (n, c_uint32) for n in MORE_COLORS] + [(n, c_double) for n in MORE_SIZES] + [(n, c_void_p) for n in THEME_FONTS[1:]]
+
+
+ACT_COUNT = 12
+CUR_COUNT = 12
+EASE_FN = CFUNCTYPE(c_double, c_double, c_void_p)
+CONFIG_INTS = ("tip_delay_ms", "dbl_click_ms", "dbl_click_px", "drag_px", "repeat_delay_ms", "repeat_ms", "blink_ms", "menu_delay_ms", "toast_ms")
+CONFIG_TOGGLES = ("raise_on_click", "esc_closes", "tab_nav", "focus_on_mouse")
+
+
+class ComboS(Structure):
+    _fields_ = [("key", c_int), ("mods", c_int)]
+
+
+class ConfigS(Structure):
+    _fields_ = [(n, c_int) for n in CONFIG_INTS] + [("scroll_lines", c_double)] + [(n, c_int) for n in CONFIG_TOGGLES] + [
+        ("cursor", c_int * CUR_COUNT), ("keys", (ComboS * 4) * ACT_COUNT), ("ease", EASE_FN), ("ease_user", c_void_p), ("mask", c_char_p)]
+
+
+class ItemS(Structure):
+    _fields_ = [(n, c_double) for n in ("x", "y", "w", "h")] + [
+        (n, c_int) for n in ("hovered", "pressed", "held", "released", "clicked", "double_clicked", "right_clicked", "focused")
+    ] + [(n, c_double) for n in ("mx", "my", "dx", "dy", "drag_x", "drag_y")] + [("key", c_int)]
+
+
+STRUCTS = {
+    "goome_opts": Opts,
+    "goome_rect": RectS,
+    "goome_monitor": MonitorS,
+    "goome_image": ImageS,
+    "goome_canvas": CanvasS,
+    "goome_event": EventS,
+    "goome_pacer": PacerS,
+    "goome_radii": RadiiS,
+    "goome_bitmap": BitmapS,
+    "goome_skin": SkinS,
+    "goome_theme": ThemeS,
+    "goome_ui_item": ItemS,
+    "goome_combo": ComboS,
+    "goome_ui_config": ConfigS,
+}
+
+P = c_void_p
+CP = POINTER(CanvasS)
+D = c_double
+I = c_int
+S = c_char_p
+U = c_uint32
+PD = POINTER(c_double)
+PI = POINTER(c_int)
+PU = POINTER(c_uint32)
+PF = POINTER(c_float)
+
+PROTOS = {
+    "goome_open": (P, [POINTER(Opts), PI]),
+    "goome_open_app": (P, [S, I, I, PI]),
+    "goome_close": (None, [P]),
+    "goome_error": (S, [P]),
+    "goome_strerror": (S, [I]),
+    "goome_backend_name": (S, [P]),
+    "goome_caps": (I, [P]),
+    "goome_monitors": (I, [P, POINTER(MonitorS), I]),
+    "goome_capture": (I, [P, I, POINTER(RectS), POINTER(ImageS)]),
+    "goome_alpha_at": (I, [P, D, D]),
+    "goome_begin": (CP, [P, I]),
+    "goome_end": (I, [P, CP, POINTER(RectS), I]),
+    "goome_damage": (None, [CP, POINTER(RectS)]),
+    "goome_poll": (I, [P, POINTER(EventS), I]),
+    "goome_pointer": (I, [P, PD, PD, PI]),
+    "goome_keyboard": (I, [P, I]),
+    "goome_grab": (I, [P, I]),
+    "goome_grabbed": (I, [P]),
+    "goome_hotkey": (I, [P, S, I]),
+    "goome_parse_combo": (I, [S, PI, PI]),
+    "goome_control_path": (S, [P]),
+    "goome_send": (I, [S, S]),
+    "goome_pace": (I, [POINTER(PacerS), I]),
+    "goome_now_ms": (c_long, []),
+    "goome_mode": (I, [P]),
+    "goome_window_title": (I, [P, S]),
+    "goome_window_size": (I, [P, I, I]),
+    "goome_window_pos": (I, [P, PI, PI, I]),
+    "goome_window_state": (I, [P, I]),
+    "goome_window_get_state": (I, [P]),
+    "goome_window_drag": (I, [P, I]),
+    "goome_window_show": (I, [P, I]),
+    "goome_cursor": (I, [P, I]),
+    "goome_cursor_shape": (I, [P]),
+    "goome_clipboard_set": (I, [P, S]),
+    "goome_clipboard_get": (I, [P, c_void_p, I]),
+    "goome_drop_path": (S, [P]),
+    "goome_push": (I, [P, POINTER(EventS)]),
+    "goome_resize": (I, [P, I, I, D]),
+    "goome_frame": (I, [P, POINTER(ImageS)]),
+    "goome_hit": (I, [P, D, D]),
+    "goome_frame_dirty": (I, [P, POINTER(RectS)]),
+    "goome_frame_copy": (I, [P, c_void_p, I, I, POINTER(RectS)]),
+    "goome_save_ppm": (I, [S, PU, I, I, I]),
+    "goome_clear": (None, [CP]),
+    "goome_draw_rect": (None, [CP, D, D, D, D, U]),
+    "goome_draw_round_rect": (None, [CP, D, D, D, D, D, U]),
+    "goome_draw_frame": (None, [CP, D, D, D, D, D, U]),
+    "goome_draw_line": (None, [CP, D, D, D, D, D, U]),
+    "goome_draw_triangle": (None, [CP, D, D, D, D, D, D, U]),
+    "goome_draw_image": (None, [CP, D, D, D, D, PU, I, I]),
+    "goome_erase": (None, [CP, D, D, D, D]),
+    "goome_draw_text": (D, [CP, D, D, S, I, U]),
+    "goome_text_width": (D, [CP, S, I]),
+    "goome_set_font": (None, [I]),
+    "goome_font_count": (I, []),
+    "goome_canvas_blit": (None, [CP, CP, D, D, D]),
+    "goome_radius": (RadiiS, [D]),
+    "goome_clip_push": (None, [CP, D, D, D, D]),
+    "goome_clip_pop": (None, [CP]),
+    "goome_draw_rrect": (None, [CP, D, D, D, D, RadiiS, U]),
+    "goome_draw_rrect_line": (None, [CP, D, D, D, D, RadiiS, D, U]),
+    "goome_draw_rrect_grad": (None, [CP, D, D, D, D, RadiiS, U, U, I]),
+    "goome_draw_shadow": (None, [CP, D, D, D, D, D, D, U]),
+    "goome_draw_circle": (None, [CP, D, D, D, U]),
+    "goome_draw_ring": (None, [CP, D, D, D, D, U]),
+    "goome_draw_arc": (None, [CP, D, D, D, D, D, D, U]),
+    "goome_draw_poly": (None, [CP, PD, I, U]),
+    "goome_bitmap_load": (I, [S, POINTER(BitmapS)]),
+    "goome_bitmap_load_mem": (I, [c_void_p, c_size_t, POINTER(BitmapS)]),
+    "goome_bitmap_error": (S, []),
+    "goome_bitmap_from_argb": (I, [PU, I, I, POINTER(BitmapS)]),
+    "goome_bitmap_free": (None, [POINTER(BitmapS)]),
+    "goome_draw_bitmap": (None, [CP, POINTER(BitmapS), D, D, D, D, RadiiS, U]),
+    "goome_draw_bitmap_part": (None, [CP, POINTER(BitmapS), I, I, I, I, D, D, D, D, U]),
+    "goome_draw_bitmap_nine": (None, [CP, POINTER(BitmapS), D, D, D, D, D, D, D, D]),
+    "goome_font_load": (P, [S]),
+    "goome_font_load_index": (P, [S, I]),
+    "goome_font_load_mem": (P, [c_void_p, c_size_t, I]),
+    "goome_font_system": (P, [S]),
+    "goome_font_free": (None, [P]),
+    "goome_text": (D, [CP, P, D, D, D, S, U]),
+    "goome_text_measure": (D, [P, D, S, PD]),
+    "goome_text_line_height": (D, [P, D]),
+    "goome_ui_new": (P, [P]),
+    "goome_ui_free": (None, [P]),
+    "goome_ui_theme": (POINTER(ThemeS), [P]),
+    "goome_ui_theme_dark": (None, [POINTER(ThemeS)]),
+    "goome_ui_theme_light": (None, [POINTER(ThemeS)]),
+    "goome_ui_feed": (I, [P, POINTER(EventS)]),
+    "goome_ui_begin": (CP, [P, I]),
+    "goome_ui_end": (None, [P]),
+    "goome_ui_hit": (None, [P, D, D, D, D]),
+    "goome_ui_animating": (I, [P]),
+    "goome_ui_window": (I, [P, S, PD, PD, PD, PD, I, PI]),
+    "goome_ui_window_end": (None, [P]),
+    "goome_ui_row": (None, [P, I]),
+    "goome_ui_same_line": (None, [P]),
+    "goome_ui_space": (None, [P, D]),
+    "goome_ui_separator": (None, [P]),
+    "goome_ui_width": (None, [P, D]),
+    "goome_ui_label": (None, [P, S]),
+    "goome_ui_heading": (None, [P, S]),
+    "goome_ui_wrapped": (None, [P, S]),
+    "goome_ui_button": (I, [P, S]),
+    "goome_ui_image_button": (I, [P, S, POINTER(BitmapS), D, D]),
+    "goome_ui_image": (None, [P, POINTER(BitmapS), D, D, D]),
+    "goome_ui_checkbox": (I, [P, S, PI]),
+    "goome_ui_toggle": (I, [P, S, PI]),
+    "goome_ui_radio": (I, [P, S, PI, I]),
+    "goome_ui_slider": (I, [P, S, PD, D, D, S]),
+    "goome_ui_slider_int": (I, [P, S, PI, I, I]),
+    "goome_ui_input": (I, [P, S, c_char_p, I]),
+    "goome_ui_combo": (I, [P, S, PI, POINTER(c_char_p), I]),
+    "goome_ui_selectable": (I, [P, S, I]),
+    "goome_ui_tabs": (I, [P, S, POINTER(c_char_p), I, PI]),
+    "goome_ui_collapsing": (I, [P, S, PI]),
+    "goome_ui_progress": (None, [P, D, S]),
+    "goome_ui_color": (I, [P, S, PU]),
+    "goome_ui_tooltip": (None, [P, S]),
+    "goome_ui_hovered": (I, [P]),
+    "goome_ui_scroll_begin": (I, [P, S, D]),
+    "goome_ui_scroll_end": (None, [P]),
+    "goome_ui_push_id": (None, [P, S]),
+    "goome_ui_pop_id": (None, [P]),
+    "goome_ui_app": (I, [P, S, I]),
+    "goome_ui_app_end": (None, [P]),
+    "goome_ui_menubar_begin": (I, [P]),
+    "goome_ui_menubar_end": (None, [P]),
+    "goome_ui_menu_begin": (I, [P, S]),
+    "goome_ui_menu_end": (None, [P]),
+    "goome_ui_menu_item": (I, [P, S, S, PI]),
+    "goome_ui_menu_separator": (None, [P]),
+    "goome_ui_context_begin": (I, [P, S]),
+    "goome_ui_context_end": (None, [P]),
+    "goome_ui_popup_open": (None, [P, S]),
+    "goome_ui_popup_begin": (I, [P, S]),
+    "goome_ui_popup_end": (None, [P]),
+    "goome_ui_popup_close": (None, [P]),
+    "goome_ui_modal_begin": (I, [P, S, PI]),
+    "goome_ui_modal_end": (None, [P]),
+    "goome_ui_toast": (None, [P, S, I]),
+    "goome_ui_statusbar": (None, [P, S]),
+    "goome_ui_focused": (I, [P]),
+    "goome_ui_set_focus": (None, [P]),
+    "goome_ui_wants": (I, [P]),
+    "goome_ui_auto_grab": (None, [P, I]),
+    "goome_ui_text_edit": (I, [P, S, c_char_p, I, D, I]),
+    "goome_ui_table_begin": (I, [P, S, I, D, I]),
+    "goome_ui_table_column": (None, [P, S, D]),
+    "goome_ui_table_sort": (I, [P, PI, PI]),
+    "goome_ui_table_row": (None, [P]),
+    "goome_ui_table_next": (None, [P]),
+    "goome_ui_table_end": (None, [P]),
+    "goome_ui_tree": (I, [P, S, PI]),
+    "goome_ui_tree_end": (None, [P]),
+    "goome_ui_list_clip": (I, [P, I, D, PI, PI]),
+    "goome_ui_drag_float": (I, [P, S, PD, D, D, D, S]),
+    "goome_ui_drag_int": (I, [P, S, PI, D, I, I]),
+    "goome_ui_number": (I, [P, S, PD, D, S]),
+    "goome_ui_plot_lines": (None, [P, S, PF, I, D, D, D]),
+    "goome_ui_plot_bars": (None, [P, S, PF, I, D, D, D]),
+    "goome_ui_split_begin": (I, [P, S, I, PD]),
+    "goome_ui_split_next": (None, [P]),
+    "goome_ui_split_end": (None, [P]),
+    "goome_ui_drag_source": (I, [P, S, c_void_p, I]),
+    "goome_ui_drop_target": (I, [P, S, c_void_p, I]),
+    "goome_ui_spinner": (None, [P, D]),
+    "goome_ui_link": (I, [P, S]),
+    "goome_ui_badge": (None, [P, S, U]),
+    "goome_ui_pos": (None, [P, D, D]),
+    "goome_ui_size": (None, [P, D, D]),
+    "goome_ui_push_color": (None, [P, I, U]),
+    "goome_ui_push_num": (None, [P, I, D]),
+    "goome_ui_push_radii": (None, [P, RadiiS]),
+    "goome_ui_push_font": (None, [P, P]),
+    "goome_ui_push_skin": (None, [P, I, POINTER(SkinS)]),
+    "goome_ui_push_theme": (None, [P, POINTER(ThemeS)]),
+    "goome_ui_push_icon": (None, [P, I, POINTER(BitmapS)]),
+    "goome_ui_pop": (None, [P, I]),
+    "goome_ui_custom": (I, [P, S, D, D, I, POINTER(ItemS)]),
+    "goome_ui_canvas": (CP, [P]),
+    "goome_ui_store": (PD, [P, S, I]),
+    "goome_ui_input_ex": (I, [P, S, c_char_p, I, I, S]),
+    "goome_ui_theme_make": (None, [POINTER(ThemeS), U, I, D]),
+    "goome_ui_theme_preset": (I, [POINTER(ThemeS), I]),
+    "goome_ui_scale": (None, [P, D]),
+    "goome_ui_cfg": (POINTER(ConfigS), [P]),
+    "goome_ui_config_default": (None, [POINTER(ConfigS)]),
+    "goome_ui_bind": (I, [P, I, S]),
+}
+
+
+def candidates():
+    env = os.environ.get("GOOME_LIB")
+    if env:
+        return [env]
+    return [os.path.join(HERE, "_native", lib_name())]
+
+
+def load():
+    tried = []
+    for path in candidates():
+        if not os.path.isfile(path):
+            tried.append(path + " (not there)")
+            continue
+        try:
+            return ctypes.CDLL(path), path
+        except OSError as e:
+            tried.append("%s (%s)" % (path, e))
+    raise OSError(
+        "cant find the goome native library, tried: %s. reinstall the package so it builds one, "
+        "run ./build.sh in the repo, or point GOOME_LIB at a libgoome you built" % "; ".join(tried)
+    )
+
+
+def bind(lib):
+    missing = []
+    for name, (res, args) in PROTOS.items():
+        try:
+            f = getattr(lib, name)
+        except AttributeError:
+            missing.append(name)
+            continue
+        f.restype = res
+        f.argtypes = args
+    if missing:
+        raise OSError("this goome library is missing %s, its probably too old" % ", ".join(missing))
+    return lib
+
+
+lib, path = load()
+bind(lib)

goome/app.py

@@ -0,0 +1,116 @@
+from .core import CLOSE, QUIT, Pacer, open_app
+
+
+class App(object):
+    _dirty = 0
+
+    def __init__(self, title="goome", width=960, height=640, flags=0, fps=60, idle_ms=500, light=False, **opts):
+        self.title = title
+        self.width = width
+        self.height = height
+        self.flags = flags
+        self.fps = fps
+        self.idle_ms = idle_ms
+        self.light = light
+        self.opts = opts
+        self.animate = False
+        self.running = False
+        self.frames = 0
+        self.g = None
+        self.ui = None
+        self._draw = None
+        self._handlers = []
+        self._close = None
+        self._start = None
+
+    def frame(self, fn):
+        self._draw = fn
+        return fn
+
+    def event(self, fn):
+        self._handlers.append(fn)
+        return fn
+
+    def on_close(self, fn):
+        self._close = fn
+        return fn
+
+    def on_start(self, fn):
+        self._start = fn
+        return fn
+
+    def redraw(self):
+        self._dirty = max(self._dirty, 1)
+
+    def quit(self):
+        self.running = False
+
+    def _handle(self, ev):
+        for h in self._handlers:
+            if h(ev):
+                return
+        self.ui.feed(ev)
+        if ev.type == QUIT:
+            self.running = False
+        elif ev.type == CLOSE and (self._close is None or self._close() is not False):
+            self.running = False
+
+    def _paint(self):
+        ui = self.ui
+        if ui.begin(0) is None:
+            return
+        try:
+            with ui.app(self.title, self.flags):
+                if self._draw is not None:
+                    self._draw(ui)
+        finally:
+            ui.end()
+        self.frames += 1
+
+    def start(self):
+        g = open_app(self.title, self.width, self.height, **self.opts)
+        ui = g.ui()
+        self.g, self.ui = g, ui
+        if self.light:
+            ui.theme.light()
+        self._every = g.backend_name.split()[0] == "test"
+        self._pace = Pacer(self.fps)
+        self._dirty = 2
+        self.running = True
+        if self._start is not None:
+            self._start()
+        return self
+
+    def step(self, wait=True):
+        ui = self.ui
+        busy = self._every or self.animate or self._dirty > 0 or ui.animating
+        if self._dirty > 0:
+            self._dirty -= 1
+        timeout = (self._pace.wait() if busy else self.idle_ms) if wait else 0
+        for ev in self.g.events(timeout):
+            self._handle(ev)
+            self._dirty = max(self._dirty, 1)
+            if not self.running:
+                return False
+        if self.running and (busy or self._dirty > 0):
+            self._paint()
+        return self.running
+
+    def stop(self):
+        self.running = False
+        g, ui = self.g, self.ui
+        self.g, self.ui = None, None
+        if ui is not None:
+            ui.close()
+        if g is not None:
+            g.close()
+
+    def run(self, draw=None):
+        if draw is not None:
+            self._draw = draw
+        self.start()
+        try:
+            while self.step():
+                pass
+        finally:
+            self.stop()