dpgbaseapp 0.1.0__py3-none-any.whl

dpgbaseapp/app.py

@@ -0,0 +1,47 @@
+import dearpygui.dearpygui as dpg
+
+
+class App:
+    title: str = 'dpgbaseapp'
+    docking: bool = False
+    width: int = 1400
+    height: int = 800
+    position: tuple[int, int] = (0, 0)
+
+    def setup(self):
+        pass
+
+    def render(self):
+        pass
+
+    def post_render(self):
+        pass
+
+    def between_frames(self):
+        pass
+
+    def shutdown(self):
+        pass
+
+    @classmethod
+    def run(cls):
+        app = cls()
+        dpg.create_context()
+        dpg.create_viewport(title=app.title, width=app.width, height=app.height)
+        dpg.set_viewport_pos(list(app.position))
+        dpg.configure_app(docking=app.docking, docking_space=app.docking)
+        dpg.setup_dearpygui()
+
+        app.setup()
+        app.render()
+        app.post_render()
+
+        dpg.show_viewport()
+        while dpg.is_dearpygui_running():
+
+            app.between_frames()
+
+            dpg.render_dearpygui_frame()
+
+        app.shutdown()
+        dpg.destroy_context()

dpgbaseapp/colorschemes.py

@@ -0,0 +1,211 @@
+import dataclasses
+
+
+@dataclasses.dataclass
+class Colorscheme:
+    name: str
+    Sub_0: tuple[int, int, int]
+    Sub_1: tuple[int, int, int]
+    Base: tuple[int, int, int]
+    Overlay: tuple[int, int, int]
+    Surface_0: tuple[int, int, int]
+    Surface_1: tuple[int, int, int]
+    Surface_2: tuple[int, int, int]
+    Text: tuple[int, int, int]
+    Subtext: tuple[int, int, int]
+    Rose: tuple[int, int, int]
+    Pink: tuple[int, int, int]
+    Mauve: tuple[int, int, int]
+    Peach: tuple[int, int, int]
+    Yellow: tuple[int, int, int]
+    Green: tuple[int, int, int]
+    Teal: tuple[int, int, int]
+    Sky: tuple[int, int, int]
+    Sapphire: tuple[int, int, int]
+    Blue: tuple[int, int, int]
+    Lavender: tuple[int, int, int]
+
+
+Latte = Colorscheme(
+    'Latte',
+    Sub_0 = (220, 224, 232),
+    Sub_1 = (230, 233, 239),
+    Base = (239, 241, 245),
+    Overlay = (156, 160, 176),
+    Surface_0 = (204, 208, 218),
+    Surface_1 = (188, 192, 204),
+    Surface_2 = (172, 176, 190),
+    Text = (76, 79, 105),
+    Subtext = (108, 111, 133),
+    Rose = (220, 138, 120),
+    Pink = (234, 118, 203),
+    Mauve = (136, 57, 239),
+    Peach = (254, 100, 11),
+    Yellow = (223, 142, 29),
+    Green = (64, 160, 43),
+    Teal = (23, 146, 153),
+    Sky = (4, 165, 229),
+    Sapphire = (32, 159, 181),
+    Blue = (30, 102, 245),
+    Lavender = (114, 135, 253),
+)
+
+Frappe = Colorscheme(
+    'Frappe',
+    Rose = (242, 213, 207),
+    Pink = (244, 184, 228),
+    Mauve = (202, 158, 230),
+    Peach = (239, 159, 118),
+    Yellow = (229, 200, 144),
+    Green = (166, 209, 137),
+    Teal = (129, 200, 190),
+    Sky = (153, 209, 219),
+    Sapphire = (133, 193, 220),
+    Blue = (140, 170, 238),
+    Lavender = (186, 187, 241),
+    Text = (198, 208, 245),
+    Subtext = (165, 173, 206),
+    Overlay = (115, 121, 148),
+    Surface_2 = (98, 104, 128),
+    Surface_1 = (81, 87, 109),
+    Surface_0 = (65, 69, 89),
+    Base = (48, 52, 70),
+    Sub_1 = (41, 44, 60),
+    Sub_0 = (35, 38, 52),
+)
+
+
+Macchiato = Colorscheme(
+    'Macchiato',
+    Rose = (244, 219, 214),
+    Pink = (245, 189, 230),
+    Mauve = (198, 160, 246),
+    Peach = (245, 169, 127),
+    Yellow = (238, 212, 159),
+    Green = (166, 218, 149),
+    Teal = (139, 213, 202),
+    Sky = (145, 215, 227),
+    Sapphire = (125, 196, 228),
+    Blue = (138, 173, 244),
+    Lavender = (183, 189, 248),
+    Text = (202, 211, 245),
+    Subtext = (165, 173, 203),
+    Overlay = (110, 115, 141),
+    Surface_2 = (91, 96, 120),
+    Surface_1 = (73, 77, 100),
+    Surface_0 = (54, 58, 79),
+    Base = (36, 39, 58),
+    Sub_1 = (30, 32, 48),
+    Sub_0 = (24, 25, 38),
+)
+
+
+Mocha = Colorscheme(
+    'Mocha',
+    Rose = (245, 224, 220),
+    Pink = (245, 194, 231),
+    Mauve = (203, 166, 247),
+    Peach = (250, 179, 135),
+    Yellow = (249, 226, 175),
+    Green = (166, 227, 161),
+    Teal = (148, 226, 213),
+    Sky = (137, 220, 235),
+    Sapphire = (116, 199, 236),
+    Blue = (137, 180, 250),
+    Lavender = (180, 190, 254),
+    Text = (205, 214, 244),
+    Subtext = (166, 173, 200),
+    Overlay = (108, 112, 134),
+    Surface_2 = (88, 91, 112),
+    Surface_1 = (69, 71, 90),
+    Surface_0 = (49, 50, 68),
+    Base = (30, 30, 46),
+    Sub_1 = (24, 24, 37),
+    Sub_0 = (17, 17, 27),
+)
+
+Cthulu = Colorscheme(
+    'Cthulu',
+    # --- structural ramp (dark -> light) ---
+    Sub_0 = (33, 35, 55),       # Sunken Depths Grey #212337
+    Sub_1 = (50, 52, 73),       # Shallow Depths Grey #323449
+    Base = (57, 59, 79),        # interp Sub_1 -> Tidal (main bg)
+    Surface_0 = (63, 65, 84),   # interp Sub_1 -> Tidal
+    Surface_1 = (69, 71, 89),   # Tidal Surface #454759
+    Surface_2 = (80, 82, 96),   # interp Tidal -> Murk Overlay
+    Overlay = (91, 92, 102),    # Murk Overlay #5b5c66
+    # --- foreground ---
+    Subtext = (177, 187, 191),  # interp Overlay -> Lighthouse White
+    Text = (235, 250, 250),     # Lighthouse White #ebfafa
+    # --- accents ---
+    Rose = (241, 108, 117),     # R'lyeh' Red #f16c75
+    Pink = (242, 101, 181),     # Pustule Pink #f265b5
+    Mauve = (164, 140, 242),    # Lovecraft Purple #a48cf2
+    Peach = (247, 198, 127),    # Dreaming Orange #f7c67f
+    Yellow = (241, 252, 121),   # Gold of Yuggoth #f1fc79
+    Green = (55, 244, 153),     # Great Old One Green #37f499
+    Teal = (30, 227, 201),      # interp Green -> Watery Tomb Blue
+    Sky = (4, 209, 249),        # Watery Tomb Blue #04d1f9
+    Sapphire = (58, 169, 229),  # interp Watery Tomb Blue -> The Old One Purple
+    Blue = (112, 129, 208),     # The Old One Purple #7081d0
+    Lavender = (138, 135, 225), # interp The Old One Purple -> Lovecraft Purple
+)
+
+
+Abyss = Colorscheme(
+    'Abyss',
+    # --- structural ramp (dark -> light) ---
+    Sub_0 = (23, 25, 40),       # Void Black #171928
+    Sub_1 = (37, 39, 56),       # Deep Sea Grey #252738
+    Base = (43, 45, 61),        # interp Sub_1 -> Benthic (main bg)
+    Surface_0 = (48, 50, 66),   # interp Sub_1 -> Benthic
+    Surface_1 = (53, 55, 70),   # Benthic Surface #353746
+    Surface_2 = (62, 64, 76),   # interp Benthic -> Hadal Overlay
+    Overlay = (71, 72, 82),     # Hadal Overlay #474852
+    # --- foreground ---
+    Subtext = (158, 167, 171),  # interp Overlay -> Pale Specter
+    Text = (216, 230, 230),     # Pale Specter #d8e6e6
+    # --- accents ---
+    Rose = (204, 88, 96),       # Crimson Omen #cc5860
+    Pink = (209, 84, 161),      # Dreamrot Pink #d154a1
+    Mauve = (139, 117, 217),    # Shadow Violet #8b75d9
+    Peach = (212, 166, 102),    # Amber Ichor #d4a666
+    Yellow = (204, 214, 99),    # Sulfur Yellow #ccd663
+    Green = (45, 204, 130),     # Phosphor Green #2dcc82
+    Teal = (24, 177, 155),      # interp Phosphor Green -> Abyssal Teal
+    Sky = (3, 150, 179),        # Abyssal Teal #0396b3
+    Sapphire = (42, 124, 166),  # interp Abyssal Teal -> Forgotten Rune
+    Blue = (80, 98, 153),       # Forgotten Rune #506299
+    Lavender = (110, 108, 185), # interp Forgotten Rune -> Shadow Violet
+)
+
+
+Dusk = Colorscheme(
+    'Dusk',
+    # --- structural ramp (light -> dark, like Latte) ---
+    Base = (240, 243, 244),     # Pale Shore #f0f3f4 (main bg)
+    Sub_1 = (226, 230, 232),    # Coastal Mist #e2e6e8
+    Sub_0 = (213, 217, 219),    # Tidal Flat #d5d9db
+    Surface_0 = (201, 203, 205),# Dusk Haze #c9cbcd
+    Surface_1 = (183, 185, 188),# interp Dusk Haze -> Abyssal Ink
+    Surface_2 = (165, 167, 170),# interp Dusk Haze -> Abyssal Ink
+    Overlay = (147, 149, 153),  # interp Dusk Haze -> Abyssal Ink
+    # --- foreground ---
+    Subtext = (103, 105, 111),  # interp Dusk Haze -> Abyssal Ink
+    Text = (30, 32, 41),        # Abyssal Ink #1e2029
+    # --- accents ---
+    Rose = (251, 91, 102),      # Dusk Crimson #fb5b66
+    Pink = (251, 91, 182),      # Fading Rose #fb5bb6
+    Mauve = (138, 105, 247),    # Vesper Violet #8a69f7
+    Peach = (255, 175, 77),     # Ember Glow #ffaf4d
+    Yellow = (255, 249, 82),    # Last Light Yellow #fff952
+    Green = (56, 255, 159),     # Dusk Moss #38ff9f
+    Teal = (33, 235, 207),      # interp Dusk Moss -> Twilight Teal
+    Sky = (10, 214, 255),       # Twilight Teal #0ad6ff
+    Sapphire = (51, 165, 238),  # interp Twilight Teal -> Faded Rune
+    Blue = (91, 115, 220),      # Faded Rune #5b73dc
+    Lavender = (115, 110, 234), # interp Faded Rune -> Vesper Violet
+)
+
+
+default_colorschemes: tuple[Colorscheme, ...] = (Latte, Frappe, Macchiato, Mocha, Cthulu, Abyss, Dusk)

dpgbaseapp/demo.py

@@ -0,0 +1,132 @@
+import math
+import typing
+
+import dearpygui.dearpygui as dpg
+
+from dpgbaseapp.app import App
+from dpgbaseapp.style_selector import StyleSelector
+
+
+class Demo(App):
+    title: str = "DPGBaseApp Demo"
+
+
+    def cb_on_drag(self, sender, app_data, user_data):
+        pass
+
+    def cb_on_drop(self, sender, app_data, user_data):
+        dpg.push_container_stack("drop_zone")
+        dpg.add_text(f"Payload {app_data} dropped")
+
+    def cb_link(self, sender, app_data):
+        dpg.add_node_link(app_data[0], app_data[1], parent=sender)
+
+    def cb_delink(self, sender, app_data):
+        dpg.delete_item(app_data)
+
+    def __init__(self):
+        self.style_selector = StyleSelector.factory()
+        self.targeted_style_selector = StyleSelector.factory(target="row_2")
+
+        self.sindatax = []
+        self.sindatay = []
+        for i in range(0, 500):
+            self.sindatax.append(i / 1000)
+            self.sindatay.append(0.5 + 0.5 * math.sin(50 * i / 1000))
+
+    @typing.override
+    def setup(self):
+        self.style_selector.apply()
+
+        with dpg.viewport_menu_bar():
+            with dpg.menu(label='Style Selector'):
+                dpg.add_menu_item(label='Global', callback=self.style_selector.cb_show)
+                dpg.add_menu_item(label='Targeted', callback=self.targeted_style_selector.cb_show)
+
+    @typing.override
+    def render(self):
+        with dpg.window(label="Example Window", tag="window"):
+            dpg.add_spacer()
+            dpg.add_spacer()
+            with dpg.table(
+                header_row=False,
+                policy=dpg.mvTable_SizingStretchSame,
+                borders_outerH=True, borders_innerV=True, borders_outerV=True
+            ):
+                dpg.add_table_column(tag="col_1")
+                dpg.add_table_column(tag="col_2")
+
+                with dpg.table_row(tag="row_1"):
+                    with dpg.group():
+                        dpg.add_text("Hello, world")
+                        dpg.add_input_text(default_value="Multiline\nText", multiline=True)
+                        dpg.add_input_text(default_value="The quick brown fox jumps over the lazy dog.")
+                        dpg.add_slider_float(default_value=0.273, max_value=1)
+                        dpg.add_input_text(
+                            label="Filter (inc, -exc)",
+                            callback=lambda _, filter_string: dpg.set_value("filter_id", filter_string)
+                        )
+                        with dpg.filter_set(id="filter_id"):
+                            dpg.add_text("aaa1.c", filter_key="aaa1.c", bullet=True)
+                            dpg.add_text("bbb1.c", filter_key="bbb1.c", bullet=True)
+                            dpg.add_text("ccc1.c", filter_key="ccc1.c", bullet=True)
+
+                    with dpg.group():
+                        with dpg.plot(label="Multi Axes Plot", height=300, width=400):
+                            dpg.add_plot_legend()
+                            dpg.add_plot_axis(dpg.mvXAxis, label="x")
+                            dpg.add_plot_axis(dpg.mvYAxis, label="y1")
+                            dpg.add_line_series(self.sindatax, self.sindatay, label="y1 lines", parent=dpg.last_item())
+                            dpg.add_plot_axis(dpg.mvYAxis2, label="y2")
+                            dpg.add_stem_series(self.sindatax, self.sindatay, label="y2 stem", parent=dpg.last_item())
+                            dpg.add_plot_axis(dpg.mvYAxis3, label="y3 scatter")
+                            dpg.add_scatter_series(self.sindatax, self.sindatay, label="y3", parent=dpg.last_item())
+
+                with dpg.table_row(tag="row_2"):
+                    with dpg.group():
+                        with dpg.group(horizontal=True):
+                            with dpg.group():
+                                for i in range(1, 6):
+                                    button = dpg.add_button(label=f"Drag Me", drag_callback=self.cb_on_drag)
+                                    with dpg.drag_payload(parent=button, user_data=i, drag_data=i):
+                                        dpg.add_text(f"Drag Payload {i}")
+                            dpg.add_child_window(tag="drop_zone", drop_callback=self.cb_on_drop, width=300, height=200)
+                        with dpg.node_editor(callback=self.cb_link, delink_callback=self.cb_delink, width=519, height=200):
+                            with dpg.node(label="Node 1", pos=(0, 0)):
+                                with dpg.node_attribute(label="Node A1"):
+                                    dpg.add_input_float(label="F1", width=150)
+                                with dpg.node_attribute(label="Node A2", attribute_type=dpg.mvNode_Attr_Output):
+                                    dpg.add_input_float(label="F2", width=150)
+                            with dpg.node(label="Node 2", pos=(270, 50)):
+                                with dpg.node_attribute(label="Node A3"):
+                                    dpg.add_input_float(label="F3", width=200)
+                                with dpg.node_attribute(label="Node A4", attribute_type=dpg.mvNode_Attr_Output):
+                                    dpg.add_input_float(label="F4", width=200)
+
+                    with dpg.group():
+                        dpg.add_listbox(items=["a", "b", "c"])
+                        dpg.add_combo(items=["aaa", "bbb", "ccc"])
+                        dpg.add_radio_button(items=["x", "y", "z"], horizontal=True)
+                        with dpg.group(horizontal=True):
+                            dpg.add_button(label="Button 1")
+                            dpg.add_button(label="Button 2")
+                        with dpg.group(horizontal=True):
+                            dpg.add_selectable(label="Selectable 1", width=100)
+                            dpg.add_selectable(label="Selectable 2", width=100)
+                            dpg.add_selectable(label="Selectable 3", width=100)
+                        with dpg.group(horizontal=True):
+                            dpg.add_checkbox(label="Check Me", default_value=True)
+                            dpg.add_checkbox(label="Check You", default_value=False)
+                        with dpg.tab_bar():
+                            with dpg.tab(label="Tab 1"):
+                                dpg.add_text("tab 1 content")
+                            with dpg.tab(label="Tab 2"):
+                                dpg.add_text("tab 2 content")
+
+    @typing.override
+    def post_render(self):
+        dpg.set_primary_window("window", True)
+
+
+if __name__ == "__main__":
+    Demo.run()

dpgbaseapp/fonts.py

@@ -0,0 +1,186 @@
+"""
+Helpers for dealing with fonts.  Works off of a base 'fonts' path - which must be structured as such:
+    fonts/
+        FontName1-Variant1.ttf
+        FontName1-Variant2.ttf
+        FontName2-Variant1.otf
+        FontName2-Variant2.otf
+
+Opinionated
+- All variants of a font must share the same extension.
+- Variants must exist in FONT_NAME_SORT_LIST below (case insensitive)
+"""
+import dataclasses
+import functools
+import pathlib
+import typing
+
+import dearpygui.dearpygui as dpg
+
+
+FONT_NAMES_BY_WEIGHT = {
+    100: ('HAIRLINE', 'THIN', ),
+    200: ('EXTRALIGHT', 'ULTRALIGHT', ),
+    300: ('LIGHT', ),
+    350: ('SEMILIGHT', 'DEMILIGHT', ),
+    380: ('BOOK', ),
+    400: ('REGULAR', 'NORMAL', 'ROMAN', 'TEXT', ),
+    500: ('MEDIUM', ),
+    600: ('SEMIBOLD', 'DEMIBOLD', 'DEMI', ),
+    700: ('BOLD', ),
+    800: ('EXTRABOLD', 'ULTRABOLD', ),
+    850: ('HEAVY', ),
+    900: ('BLACK', ),
+    950: ('EXTRABLACK', 'ULTRABLACK', )
+}
+
+FONT_WEIGHTS_BY_NAME = {
+    name: weight
+    for weight, names in FONT_NAMES_BY_WEIGHT.items()
+    for name in names
+}
+
+ITALIC_NAMES = ('ITALIC', 'OBLIQUE')
+
+FONT_VARIANT_SORT_LIST: list[str] = []
+for names in FONT_NAMES_BY_WEIGHT.values():
+    FONT_VARIANT_SORT_LIST.extend(names)
+    for name in names:
+        for italic_name in ITALIC_NAMES:
+            FONT_VARIANT_SORT_LIST.append(f'{name}{italic_name}')
+    if 'REGULAR' in names:
+        for italic_name in ITALIC_NAMES:
+            FONT_VARIANT_SORT_LIST.append(italic_name)
+
+DEFAULT_FONT_SIZES: tuple[int, ...] = tuple(range(2, 65, 2))
+
+
+@dataclasses.dataclass
+class FontVariantDescriptors:
+    variant: str
+
+    @property
+    def upper(self) -> str:
+        return self.variant.upper()
+
+    @property
+    def italic(self) -> bool:
+        for italic_name in ITALIC_NAMES:
+            if self.upper == italic_name:
+                return True
+            if self.upper.endswith(italic_name):
+                return True
+        return False
+
+    @property
+    def weight_name(self) -> str:
+        for italic_name in ITALIC_NAMES:
+            if self.upper == italic_name:
+                return 'REGULAR'
+            if self.upper.endswith(italic_name):
+                return self.upper[:-len(italic_name)]
+        return self.upper
+
+    @property
+    def weight(self) -> int:
+        return FONT_WEIGHTS_BY_NAME[self.weight_name]
+
+
+@dataclasses.dataclass(frozen=True)
+class RealizedFontConfig:
+    name: str
+    variant: str
+    size: int
+
+
+@dataclasses.dataclass
+class Font:
+    name: str
+    extension: typing.Literal['.ttf', '.otf']
+    variants: list[str] = dataclasses.field(default_factory=list)
+
+    @functools.cached_property
+    def default_variant(self):
+        return self.find_nearest_variant('regular')
+
+    @functools.cached_property
+    def descriptors(self) -> list[FontVariantDescriptors]:
+        return [FontVariantDescriptors(variant) for variant in self.variants]
+
+    def find_nearest_variant(self, variant: str) -> str:
+        if variant in self.variants:
+            return variant
+
+        target = FontVariantDescriptors(variant)
+        descriptors = [descriptor for descriptor in self.descriptors if descriptor.italic == target.italic]
+        # If no descriptors match 'Italicness', fall back to all descriptors and search by weight alone
+        if len(descriptors) == 0:
+            descriptors = self.descriptors
+
+        sorted_descriptors = sorted(
+            descriptors,
+            key=lambda d: abs(d.weight - target.weight),
+        )
+        return sorted_descriptors[0].variant
+
+@dataclasses.dataclass
+class FontLibrary:
+    path: pathlib.Path
+    fonts: dict[str, Font] = dataclasses.field(default_factory=dict)
+    sizes: tuple[int, ...] = DEFAULT_FONT_SIZES
+    realized_fonts: dict[RealizedFontConfig, str | int] = dataclasses.field(default_factory=dict)
+
+    @classmethod
+    def factory(cls, path: pathlib.Path) -> typing.Self:
+        library = cls(path)
+        for entry in path.iterdir():
+            if entry.is_file() and entry.suffix in ('.ttf', '.otf'):
+                library.add_font(entry)
+        library.sort_all_variants()
+        return library
+
+    def add_font(self, font: pathlib.Path):
+        name_and_variant, extension = font.stem, font.suffix
+        assert extension in ('.ttf', '.otf')
+        name, variant = name_and_variant.split('-')
+        if name not in self.fonts:
+            self.fonts[name] = Font(name, extension)
+        self.fonts[name].variants.append(variant)
+
+    def sort_all_variants(self):
+        for font in self.fonts.values():
+            font.variants = sorted(
+                font.variants,
+                key=lambda variant: FONT_VARIANT_SORT_LIST.index(variant.upper()),
+            )
+
+    def _resolve_file(self, config: RealizedFontConfig) -> str:
+        font = self.fonts[config.name]
+        filename = f'{config.name}-{config.variant}{font.extension}'
+        return str(self.path / filename)
+
+    def realize_font(self, config: RealizedFontConfig) -> str | int:
+        if config in self.realized_fonts:
+            return self.realized_fonts[config]
+
+        file = self._resolve_file(config)
+        with dpg.font_registry():
+            font = dpg.add_font(file, config.size)
+
+        self.realized_fonts[config] = font
+
+        return font
+
+    @property
+    def default_realized_font_config(self) -> RealizedFontConfig:
+        name = next(iter(self.fonts))
+        variant = self.fonts[name].default_variant
+        size = 14
+
+        return RealizedFontConfig(name, variant, size)
+
+
+if __name__ == '__main__':
+    fonts_path = pathlib.Path(__file__).parent.parent.parent / 'fonts'
+    library = FontLibrary.factory(fonts_path)
+    print(library.fonts)

dpgbaseapp/style_selector.py

@@ -0,0 +1,179 @@
+import dataclasses
+import functools
+import pathlib
+import random
+import types
+import typing
+
+import dearpygui.dearpygui as dpg
+
+from dpgbaseapp.fonts import FontLibrary
+from dpgbaseapp.fonts import RealizedFontConfig
+from dpgbaseapp.themes import Theme, default_themes
+
+
+@dataclasses.dataclass
+class StyleSelector:
+    theme: Theme
+    themes: tuple[Theme, ...]
+    font_library: FontLibrary
+    font_config: RealizedFontConfig
+    target: str | int | None = None
+    prefix: str | int = dataclasses.field(
+        default_factory=functools.partial(
+            random.randint,
+            1999999,
+            9999999,
+        ),
+    )
+    _labels: types.SimpleNamespace = dataclasses.field(default_factory=types.SimpleNamespace)
+    _rendered: bool = False
+
+    @classmethod
+    def factory(
+        cls,
+        theme: Theme | None = None,
+        themes: tuple[Theme, ...] | None = None,
+        font_path: pathlib.Path | None = None,
+        font_library: FontLibrary | None = None,
+        font_config: RealizedFontConfig | None = None,
+        target: str | int | None = None,
+        prefix: str | int | None = None,
+    ):
+        kwargs: dict[str, typing.Any] = {}
+        if themes is None:
+            kwargs['themes'] = default_themes
+        else:
+            kwargs['themes'] = themes
+
+        if theme is None:
+            kwargs['theme'] = kwargs['themes'][0]
+        else:
+            kwargs['theme'] = theme
+
+        if font_library is not None:
+            kwargs['font_library'] = font_library
+        else:
+            if font_path is None:
+                font_path = pathlib.Path.home() / '.local/share/dpgbaseapp/fonts'
+
+            kwargs['font_library'] = FontLibrary.factory(font_path)
+
+        if font_config is None:
+            kwargs['font_config'] = kwargs['font_library'].default_realized_font_config
+        else:
+            kwargs['font_config'] = font_config
+
+        kwargs['target'] = target
+
+        if prefix is not None:
+            kwargs['prefix'] = prefix
+
+        return cls(**kwargs)  # pyright: ignore[reportAny]
+
+    def tag(self, key: str) -> str:
+        return f'{self.prefix}_styleselector_{key}'
+
+    def apply(self):
+        self.theme.bind(self.target)
+        font = self.font_library.realize_font(self.font_config)
+        if self.target is not None:
+            dpg.bind_item_font(self.target, font)
+        else:
+            dpg.bind_font(font)
+
+    def cb_show(self, sender, app_data, user_data):
+        self.render()
+        dpg.show_item(self.tag('window'))
+        
+
+
+    def cb_theme(self, sender: str | int, app_data: typing.Any, user_data: typing.Any) -> None:
+        for theme in self.themes:
+            if theme.name == app_data:
+                self.theme = theme
+                self.apply()
+                return
+        raise ValueError(app_data)
+
+    def cb_fontname(self, sender: str | int, app_data: typing.Any, user_data: typing.Any):
+        name = app_data
+        variants = self.font_library.fonts[name].variants
+        variant = self.font_library.fonts[name].find_nearest_variant(self.font_config.variant)
+
+        dpg.configure_item(
+            self.tag('fontvariant'),
+            items=list(variants),
+            default_value=variant,
+        )
+
+        self.font_config = dataclasses.replace(
+            self.font_config,
+            name=name,
+            variant=variant,
+        )
+        self.apply()
+
+    def cb_fontvariant(self, sender: str | int, app_data: typing.Any, user_data: typing.Any):
+        self.font_config = dataclasses.replace(
+            self.font_config,
+            variant=app_data,
+        )
+        self.apply()
+
+    def cb_fontsize(self, sender: str | int, app_data: typing.Any, user_data: typing.Any):
+        self.font_config = dataclasses.replace(
+            self.font_config,
+            size=int(app_data),
+        )
+        self.apply()
+
+    def render(self) -> str | int:
+        if self._rendered:
+            return
+
+        self._rendered = True
+
+        with dpg.window(label='StyleSelector', width=800, height=400, tag=self.tag('window')) as window:
+            with dpg.group(horizontal=True):
+                with dpg.group():
+                    self._labels.theme = dpg.add_text('Theme')
+                    dpg.add_listbox(
+                        items=list(theme.name for theme in self.themes),
+                        callback=self.cb_theme,
+                        tag=self.tag('theme'),
+                        width=250,
+                        num_items=10,
+                        default_value=self.theme.name,
+                    )
+                with dpg.group():
+                    self._labels.fontname = dpg.add_text('Font Name')
+                    dpg.add_listbox(
+                        items=list(self.font_library.fonts),
+                        callback=self.cb_fontname,
+                        tag=self.tag('fontname'),
+                        width=250,
+                        num_items=10,
+                        default_value=self.font_config.name,
+                    )
+                with dpg.group():
+                    self._labels.fontvariant = dpg.add_text('Font Variant')
+                    dpg.add_listbox(
+                        items=list(self.font_library.fonts[self.font_config.name].variants),
+                        callback=self.cb_fontvariant,
+                        tag=self.tag('fontvariant'),
+                        width=200,
+                        num_items=10,
+                        default_value=self.font_config.variant,
+                    )
+                with dpg.group():
+                    self._labels.fontsize = dpg.add_text('Font Size')
+                    dpg.add_listbox(
+                        items=list(map(str, self.font_library.sizes)),
+                        callback=self.cb_fontsize,
+                        tag=self.tag('fontsize'),
+                        width=60,
+                        num_items=10,
+                        default_value=str(self.font_config.size),
+                    )
+        return window

dpgbaseapp/themes.py

@@ -0,0 +1,316 @@
+import dataclasses
+
+import dearpygui.dearpygui as dpg
+
+from dpgbaseapp.colorschemes import (
+    Colorscheme,
+    default_colorschemes,
+)
+
+
+
+type ThemeColor = tuple[int, int, int] | tuple[int, int, int, int]
+
+@dataclasses.dataclass
+class ThemeColors:
+    Text: ThemeColor
+    TextDisabled: ThemeColor
+    WindowBg: ThemeColor
+    ChildBg: ThemeColor
+    PopupBg: ThemeColor
+    Border: ThemeColor
+    BorderShadow: ThemeColor
+    FrameBg: ThemeColor
+    FrameBgHovered: ThemeColor
+    FrameBgActive: ThemeColor
+    TitleBg: ThemeColor
+    TitleBgActive: ThemeColor
+    TitleBgCollapsed: ThemeColor
+    MenuBarBg: ThemeColor
+    ScrollbarBg: ThemeColor
+    ScrollbarGrab: ThemeColor
+    ScrollbarGrabHovered: ThemeColor
+    ScrollbarGrabActive: ThemeColor
+    CheckMark: ThemeColor
+    SliderGrab: ThemeColor
+    SliderGrabActive: ThemeColor
+    Button: ThemeColor
+    ButtonHovered: ThemeColor
+    ButtonActive: ThemeColor
+    Header: ThemeColor
+    HeaderHovered: ThemeColor
+    HeaderActive: ThemeColor
+    Separator: ThemeColor
+    SeparatorHovered: ThemeColor
+    SeparatorActive: ThemeColor
+    ResizeGrip: ThemeColor
+    ResizeGripHovered: ThemeColor
+    ResizeGripActive: ThemeColor
+    InputTextCursor: ThemeColor
+    TabHovered: ThemeColor
+    Tab: ThemeColor
+    TabSelected: ThemeColor
+    TabSelectedOverline: ThemeColor
+    TabDimmed: ThemeColor
+    TabDimmedSelected: ThemeColor
+    TabDimmedSelectedOverline: ThemeColor
+    DockingPreview: ThemeColor
+    DockingEmptyBg: ThemeColor
+    PlotLines: ThemeColor
+    PlotLinesHovered: ThemeColor
+    PlotHistogram: ThemeColor
+    PlotHistogramHovered: ThemeColor
+    TableHeaderBg: ThemeColor
+    TableBorderStrong: ThemeColor
+    TableBorderLight: ThemeColor
+    TableRowBg: ThemeColor
+    TableRowBgAlt: ThemeColor
+    TextSelectedBg: ThemeColor
+    TreeLines: ThemeColor
+    DragDropTarget: ThemeColor
+    DragDropTargetBg: ThemeColor
+    UnsavedMarker: ThemeColor
+    NavCursor: ThemeColor
+    NavWindowingHighlight  : ThemeColor
+    NavWindowingDimBg: ThemeColor
+    ModalWindowDimBg: ThemeColor
+    Plot_FrameBg: ThemeColor
+    Plot_PlotBg: ThemeColor
+    Plot_PlotBorder: ThemeColor
+    Plot_LegendBg: ThemeColor
+    Plot_LegendBorder: ThemeColor
+    Plot_LegendText: ThemeColor
+    Plot_TitleText: ThemeColor
+    Plot_InlayText: ThemeColor
+    Plot_AxisText: ThemeColor
+    Plot_AxisGrid: ThemeColor
+    Plot_AxisTick: ThemeColor
+    Plot_Selection: ThemeColor
+    Plot_Crosshairs: ThemeColor
+    Node_NodeBackground: ThemeColor
+    Node_NodeBackgroundHovered: ThemeColor
+    Node_NodeBackgroundSelected  : ThemeColor
+    Node_NodeOutline: ThemeColor
+    Node_TitleBar: ThemeColor
+    Node_TitleBarHovered: ThemeColor
+    Node_TitleBarSelected: ThemeColor
+    Node_Link: ThemeColor
+    Node_LinkHovered: ThemeColor
+    Node_LinkSelected: ThemeColor
+    Node_Pin: ThemeColor
+    Node_PinHovered: ThemeColor
+    Node_BoxSelector: ThemeColor
+    Node_BoxSelectorOutline: ThemeColor
+    Node_GridBackground: ThemeColor
+    Node_GridLine: ThemeColor
+    Nodes_GridLinePrimary: ThemeColor
+    Nodes_MiniMapBackground: ThemeColor
+    Nodes_MiniMapBackgroundHovered: ThemeColor
+    Nodes_MiniMapOutline: ThemeColor
+    Nodes_MiniMapOutlineHovered  : ThemeColor
+    Nodes_MiniMapNodeBackground  : ThemeColor
+    Nodes_MiniMapNodeBackgroundSelected: ThemeColor
+    Nodes_MiniMapNodeOutline: ThemeColor
+    Nodes_MiniMapLink: ThemeColor
+    Nodes_MiniMapLinkSelected: ThemeColor
+    Nodes_MiniMapCanvas: ThemeColor
+    Nodes_MiniMapCanvasOutline: ThemeColor
+
+
+@dataclasses.dataclass
+class Theme:
+    name: str
+    colors: ThemeColors
+    colorscheme: Colorscheme
+    _theme_id: int | str | None = None
+
+    def initialize(self):
+        if self._theme_id is not None:
+            return
+        with dpg.theme() as theme_id:
+            with dpg.theme_component(0):
+                for field in dataclasses.fields(self.colors):
+                    if field.name == '_theme_id':
+                        continue
+                    name = field.name
+                    value = getattr(self.colors, field.name)
+                    if name.startswith('Plot_'):
+                        attr_name = f'mvPlotCol_{name[5:]}'
+                        category = dpg.mvThemeCat_Plots
+                    elif name.startswith('Node_'):
+                        attr_name = f'mvNodeCol_{name[5:]}'
+                        category = dpg.mvThemeCat_Nodes
+                    elif name.startswith('Nodes_'):
+                        attr_name = f'mvNodesCol_{name[6:]}'
+                        category = dpg.mvThemeCat_Nodes
+                    else:
+                        attr_name = f'mvThemeCol_{name}'
+                        category = dpg.mvThemeCat_Core
+
+                    dpg.add_theme_color(getattr(dpg, attr_name), value, category=category)
+        self._theme_id = theme_id
+
+    def bind(self, target: int | str | None = None):
+        self.initialize()
+        assert self._theme_id is not None
+        if target is None:
+            dpg.bind_theme(self._theme_id)
+        else:
+            dpg.bind_item_theme(target, self._theme_id)
+    
+
+def create_theme(colorscheme: Colorscheme) -> Theme:
+    """Build a Dear PyGui ``Theme`` from a ``Colorscheme``.
+
+    ``Base`` carries the main background,
+    the ``Sub_0``/``Crust`` shades sit "behind" it (menus, title bars, popups),
+    and the ``Surface`` ramp layers up for interactive states
+    (rest -> hovered -> active). Foreground uses ``Text`` with the ``Overlay``
+    ramp for muted/disabled content.
+
+    Accents are deliberately spread around for some colour: ``Mauve`` is the
+    primary accent (selection, slider, tab overline, nav), with checkmarks in
+    ``Green``, separators/links in ``Blue``/``Sky``, plots in ``Peach``/``Yellow``,
+    drag-drop in ``Yellow`` and node titles cycling through the warm accents.
+    """
+
+    def a(color: tuple[int, int, int], alpha: int) -> ThemeColor:
+        """Same colour with an explicit alpha (0-255)."""
+        return (color[0], color[1], color[2], alpha)
+
+    accent = colorscheme.Mauve          # primary accent
+    accent_alt = colorscheme.Blue       # secondary accent
+
+    colors = ThemeColors(
+        # --- ImGui: text & windows ---
+        Text=colorscheme.Text,
+        TextDisabled=colorscheme.Overlay,
+        WindowBg=colorscheme.Base,
+        ChildBg=a(colorscheme.Base, 0),
+        PopupBg=colorscheme.Sub_1,
+        Border=colorscheme.Surface_0,
+        BorderShadow=a(colorscheme.Sub_0, 0),
+        # --- frames / inputs ---
+        FrameBg=colorscheme.Surface_0,
+        FrameBgHovered=colorscheme.Surface_1,
+        FrameBgActive=colorscheme.Surface_2,
+        # --- title bars ---
+        TitleBg=colorscheme.Sub_1,
+        TitleBgActive=colorscheme.Surface_0,
+        TitleBgCollapsed=a(colorscheme.Sub_1, 180),
+        MenuBarBg=colorscheme.Sub_0,
+        # --- scrollbar ---
+        ScrollbarBg=colorscheme.Sub_1,
+        ScrollbarGrab=colorscheme.Surface_0,
+        ScrollbarGrabHovered=colorscheme.Surface_1,
+        ScrollbarGrabActive=colorscheme.Surface_2,
+        # --- checks & sliders (splash: green check, mauve/pink slider) ---
+        CheckMark=colorscheme.Green,
+        SliderGrab=accent,
+        SliderGrabActive=colorscheme.Pink,
+        # --- buttons (neutral surfaces, colour lives in the accents) ---
+        Button=colorscheme.Surface_0,
+        ButtonHovered=colorscheme.Surface_1,
+        ButtonActive=colorscheme.Surface_2,
+        # --- headers (selectables / tree nodes) ---
+        Header=a(accent, 90),
+        HeaderHovered=a(accent, 130),
+        HeaderActive=a(accent, 170),
+        # --- separators (splash: blue) ---
+        Separator=colorscheme.Surface_0,
+        SeparatorHovered=accent_alt,
+        SeparatorActive=accent_alt,
+        # --- resize grips ---
+        ResizeGrip=a(accent, 80),
+        ResizeGripHovered=a(accent, 140),
+        ResizeGripActive=a(accent, 200),
+        InputTextCursor=colorscheme.Rose,
+        # --- tabs (splash: mauve overline) ---
+        TabHovered=a(accent, 150),
+        Tab=colorscheme.Sub_1,
+        TabSelected=colorscheme.Surface_0,
+        TabSelectedOverline=accent,
+        TabDimmed=colorscheme.Sub_0,
+        TabDimmedSelected=colorscheme.Sub_1,
+        TabDimmedSelectedOverline=a(accent, 120),
+        # --- docking ---
+        DockingPreview=a(accent, 100),
+        DockingEmptyBg=colorscheme.Sub_0,
+        # --- plot lines (splash: blue/sky, peach/yellow) ---
+        PlotLines=colorscheme.Blue,
+        PlotLinesHovered=colorscheme.Sky,
+        PlotHistogram=colorscheme.Peach,
+        PlotHistogramHovered=colorscheme.Yellow,
+        # --- tables ---
+        TableHeaderBg=colorscheme.Surface_0,
+        TableBorderStrong=colorscheme.Surface_1,
+        TableBorderLight=colorscheme.Surface_0,
+        TableRowBg=a(colorscheme.Base, 0),
+        TableRowBgAlt=a(colorscheme.Surface_0, 60),
+        # --- selection / misc ---
+        TextSelectedBg=a(accent, 80),
+        TreeLines=colorscheme.Overlay,
+        DragDropTarget=colorscheme.Yellow,
+        DragDropTargetBg=a(colorscheme.Yellow, 80),
+        UnsavedMarker=colorscheme.Peach,
+        NavCursor=accent,
+        NavWindowingHighlight=a(colorscheme.Text, 180),
+        NavWindowingDimBg=a(colorscheme.Sub_0, 150),
+        ModalWindowDimBg=a(colorscheme.Sub_0, 150),
+        # --- ImPlot ---
+        Plot_FrameBg=a(colorscheme.Base, 0),
+        Plot_PlotBg=colorscheme.Sub_1,
+        Plot_PlotBorder=colorscheme.Surface_0,
+        Plot_LegendBg=a(colorscheme.Sub_1, 230),
+        Plot_LegendBorder=colorscheme.Surface_1,
+        Plot_LegendText=colorscheme.Text,
+        Plot_TitleText=colorscheme.Text,
+        Plot_InlayText=colorscheme.Subtext,
+        Plot_AxisText=colorscheme.Subtext,
+        Plot_AxisGrid=colorscheme.Surface_0,
+        Plot_AxisTick=colorscheme.Surface_1,
+        Plot_Selection=a(colorscheme.Yellow, 90),
+        Plot_Crosshairs=a(colorscheme.Text, 128),
+        # --- imnodes ---
+        Node_NodeBackground=colorscheme.Surface_0,
+        Node_NodeBackgroundHovered=colorscheme.Surface_1,
+        Node_NodeBackgroundSelected=colorscheme.Surface_2,
+        Node_NodeOutline=colorscheme.Overlay,
+        # node title bars cycle through warm accents
+        Node_TitleBar=accent,
+        Node_TitleBarHovered=colorscheme.Pink,
+        Node_TitleBarSelected=colorscheme.Lavender,
+        # links in cool accents
+        Node_Link=colorscheme.Blue,
+        Node_LinkHovered=colorscheme.Sky,
+        Node_LinkSelected=colorscheme.Sapphire,
+        # pins in teal/green
+        Node_Pin=colorscheme.Teal,
+        Node_PinHovered=colorscheme.Green,
+        Node_BoxSelector=a(accent_alt, 30),
+        Node_BoxSelectorOutline=a(accent_alt, 150),
+        Node_GridBackground=colorscheme.Sub_1,
+        Node_GridLine=colorscheme.Surface_0,
+        Nodes_GridLinePrimary=colorscheme.Surface_1,
+        Nodes_MiniMapBackground=a(colorscheme.Sub_1, 150),
+        Nodes_MiniMapBackgroundHovered=a(colorscheme.Sub_1, 200),
+        Nodes_MiniMapOutline=colorscheme.Surface_0,
+        Nodes_MiniMapOutlineHovered=colorscheme.Surface_1,
+        Nodes_MiniMapNodeBackground=colorscheme.Surface_1,
+        Nodes_MiniMapNodeBackgroundSelected=accent,
+        Nodes_MiniMapNodeOutline=colorscheme.Overlay,
+        Nodes_MiniMapLink=colorscheme.Blue,
+        Nodes_MiniMapLinkSelected=colorscheme.Sapphire,
+        Nodes_MiniMapCanvas=a(colorscheme.Sub_0, 100),
+        Nodes_MiniMapCanvasOutline=colorscheme.Surface_0,
+    )
+
+    return Theme(
+        colorscheme.name,
+        colors,
+        colorscheme
+    )
+
+
+
+default_themes = [create_theme(colorscheme) for colorscheme in default_colorschemes]

dpgbaseapp-0.1.0.dist-info/METADATA

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: dpgbaseapp
+Version: 0.1.0
+Summary: A set of base structures to facilitate building DearPyGui apps
+Author: Zachary Parmley
+Author-email: Zachary Parmley <zachary.craig@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: dearpygui>=2.3.1
+Requires-Dist: rich>=15.0.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/zparmley/dpgbaseapp
+Project-URL: Repository, https://github.com/zparmley/dpgbaseapp
+Description-Content-Type: text/markdown
+
+# DPGBaseApp
+
+A set of base structures to facilitate building DPG apps

dpgbaseapp-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+dpgbaseapp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dpgbaseapp/app.py,sha256=lYk969oCsindtYMO4DAtNP3GbKBVAN0vRgWIqHj7v5s,968
+dpgbaseapp/colorschemes.py,sha256=uRpTvUD7cQ0b0WLGHEoS5umItl9kJ8mt0B6uq8_8TBg,7346
+dpgbaseapp/demo.py,sha256=kYNjVHx9qOFZVP0Q-DIk5hWZL7sQtKqluMyTiEiuGNw,6568
+dpgbaseapp/fonts.py,sha256=sF82NKSiIbBqN34sZqCo93x9XDHhGiA5l3mOnKHG_j4,5670
+dpgbaseapp/style_selector.py,sha256=JrnjsVzQY7aWiAvNSabUaRzPVfkGmKNR5T5C0aw5SYw,6044
+dpgbaseapp/themes.py,sha256=3vyLPskfT6lHxYwMbVzExR6-WcP4FJSesdR7CHs7sV4,11632
+dpgbaseapp-0.1.0.dist-info/licenses/LICENSE,sha256=44sQQ8dpyxE3oIBtkDUlt1UJj4yPMdcz7O36XTb6mZ4,1072
+dpgbaseapp-0.1.0.dist-info/WHEEL,sha256=8ZlpUMJ7mlDirmlHRhDirEx_nPnARrwDjeE92mlk68E,81
+dpgbaseapp-0.1.0.dist-info/METADATA,sha256=R1mQNa5dXO4-1svsDr7qu1PO4SUflzXasSMM0H5HavA,574
+dpgbaseapp-0.1.0.dist-info/RECORD,,

dpgbaseapp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.21
+Root-Is-Purelib: true
+Tag: py3-none-any

dpgbaseapp-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zachary Parmley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.