A reusable tkinter/ttkbootstrap UI framework

These details have not been verified by PyPI

Project description

Jabs Mimir

Jabs Mimir is a lightweight, extensible UI micro-framework built on top of tkinter and ttkbootstrap, designed for rapid internal tool development and structured form workflows.

It provides:

Reusable UI primitives with validation and tooltips
Support for block-based form components with dynamic variable binding
Integration with custom validation logic
Modular architecture suitable for internal tooling and small boilerplate projects

Installation

pip install jabs-mimir

Quick Start

from jabs_mimir import Mimir, DataBlockWrapper, UtilityModule
import tkinter as tk
import ttkbootstrap as tb

class App(tb.Window):
    def __init__(self):
        super().__init__(title="Mimir Demo")
        self.ui = Mimir(self)
        self.ui.setValidatorResolver(lambda name: {"not_empty": lambda val: bool(val.strip())}.get(name))

        self.ui.switchView(self.mainView)

    def mainView(self, ui, *args):
        frame = tb.Frame(self)
        fields = [
            {"type": "heading", "label": "Basic Info"},
            {"label": "Name", "key": "name", "variable": tk.StringVar(), "validation": "not_empty"},
            {"label": "Age", "key": "age", "variable": tk.IntVar()}
        ]

        meta = UtilityModule.buildBlockMeta(fields)
        block = DataBlockWrapper(meta)

        ui.renderFields(frame, fields)
        ui.addNextButton(frame, row=len(fields)+1, command=lambda: print(UtilityModule.getBlockValues(block)))

        return frame

if __name__ == "__main__":
    app = App()
    app.mainloop()

Components

`Mimir`

Manages UI views, tooltips, validation, field rendering, and form logic.

`DataBlockWrapper`

A wrapper for block-level form metadata and values. Supports dot-access and .get()/.set() calls.

`UtilityModule`

Helper methods for building field metadata, extracting values, validating blocks, etc.

License

📘 API Documentation

<!doctype html>

<title>jabs_mimir API documentation</title>

<style>/*! * Bootstrap Reboot v5.0.0 (https://getbootstrap.com/) * Copyright 2011-2021 The Bootstrap Authors * Copyright 2011-2021 Twitter, Inc. * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE) * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md) */*,::after,::before{box-sizing:border-box}@media (prefers-reduced-motion:no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-size:1rem;font-weight:400;line-height:1.5;color:#212529;background-color:#fff;-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}hr{margin:1rem 0;color:inherit;background-color:currentColor;border:0;opacity:.25}hr:not([size]){height:1px}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem;font-weight:500;line-height:1.2}h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width:1200px){h1{font-size:2.5rem}}h2{font-size:calc(1.325rem + .9vw)}@media (min-width:1200px){h2{font-size:2rem}}h3{font-size:calc(1.3rem + .6vw)}@media (min-width:1200px){h3{font-size:1.75rem}}h4{font-size:calc(1.275rem + .3vw)}@media (min-width:1200px){h4{font-size:1.5rem}}h5{font-size:1.25rem}h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}abbr[data-bs-original-title],abbr[title]{-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-left:2rem}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}small{font-size:.875em}mark{padding:.2em;background-color:#fcf8e3}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#0d6efd;text-decoration:underline}a:hover{color:#0a58ca}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:1em;direction:ltr;unicode-bidi:bidi-override}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:#d63384;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:.875em;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:1em;font-weight:700}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:#6c757d;text-align:left}th{text-align:inherit;text-align:-webkit-match-parent}tbody,td,tfoot,th,thead,tr{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]::-webkit-calendar-picker-indicator{display:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}textarea{resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{float:left;width:100%;padding:0;margin-bottom:.5rem;font-size:calc(1.275rem + .3vw);line-height:inherit}@media (min-width:1200px){legend{font-size:1.5rem}}legend+*{clear:left}::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-text,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:textfield}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}iframe{border:0}summary{display:list-item;cursor:pointer}progress{vertical-align:baseline}[hidden]{display:none!important}</style>
<style>/*! syntax-highlighting.css */pre{line-height:125%;}span.linenos{color:inherit; background-color:transparent; padding-left:5px; padding-right:20px;}.pdoc-code .hll{background-color:#ffffcc}.pdoc-code{background:#f8f8f8;}.pdoc-code .c{color:#3D7B7B; font-style:italic}.pdoc-code .err{border:1px solid #FF0000}.pdoc-code .k{color:#008000; font-weight:bold}.pdoc-code .o{color:#666666}.pdoc-code .ch{color:#3D7B7B; font-style:italic}.pdoc-code .cm{color:#3D7B7B; font-style:italic}.pdoc-code .cp{color:#9C6500}.pdoc-code .cpf{color:#3D7B7B; font-style:italic}.pdoc-code .c1{color:#3D7B7B; font-style:italic}.pdoc-code .cs{color:#3D7B7B; font-style:italic}.pdoc-code .gd{color:#A00000}.pdoc-code .ge{font-style:italic}.pdoc-code .gr{color:#E40000}.pdoc-code .gh{color:#000080; font-weight:bold}.pdoc-code .gi{color:#008400}.pdoc-code .go{color:#717171}.pdoc-code .gp{color:#000080; font-weight:bold}.pdoc-code .gs{font-weight:bold}.pdoc-code .gu{color:#800080; font-weight:bold}.pdoc-code .gt{color:#0044DD}.pdoc-code .kc{color:#008000; font-weight:bold}.pdoc-code .kd{color:#008000; font-weight:bold}.pdoc-code .kn{color:#008000; font-weight:bold}.pdoc-code .kp{color:#008000}.pdoc-code .kr{color:#008000; font-weight:bold}.pdoc-code .kt{color:#B00040}.pdoc-code .m{color:#666666}.pdoc-code .s{color:#BA2121}.pdoc-code .na{color:#687822}.pdoc-code .nb{color:#008000}.pdoc-code .nc{color:#0000FF; font-weight:bold}.pdoc-code .no{color:#880000}.pdoc-code .nd{color:#AA22FF}.pdoc-code .ni{color:#717171; font-weight:bold}.pdoc-code .ne{color:#CB3F38; font-weight:bold}.pdoc-code .nf{color:#0000FF}.pdoc-code .nl{color:#767600}.pdoc-code .nn{color:#0000FF; font-weight:bold}.pdoc-code .nt{color:#008000; font-weight:bold}.pdoc-code .nv{color:#19177C}.pdoc-code .ow{color:#AA22FF; font-weight:bold}.pdoc-code .w{color:#bbbbbb}.pdoc-code .mb{color:#666666}.pdoc-code .mf{color:#666666}.pdoc-code .mh{color:#666666}.pdoc-code .mi{color:#666666}.pdoc-code .mo{color:#666666}.pdoc-code .sa{color:#BA2121}.pdoc-code .sb{color:#BA2121}.pdoc-code .sc{color:#BA2121}.pdoc-code .dl{color:#BA2121}.pdoc-code .sd{color:#BA2121; font-style:italic}.pdoc-code .s2{color:#BA2121}.pdoc-code .se{color:#AA5D1F; font-weight:bold}.pdoc-code .sh{color:#BA2121}.pdoc-code .si{color:#A45A77; font-weight:bold}.pdoc-code .sx{color:#008000}.pdoc-code .sr{color:#A45A77}.pdoc-code .s1{color:#BA2121}.pdoc-code .ss{color:#19177C}.pdoc-code .bp{color:#008000}.pdoc-code .fm{color:#0000FF}.pdoc-code .vc{color:#19177C}.pdoc-code .vg{color:#19177C}.pdoc-code .vi{color:#19177C}.pdoc-code .vm{color:#19177C}.pdoc-code .il{color:#666666}</style>
<style>/*! theme.css */:root{--pdoc-background:#fff;}.pdoc{--text:#212529;--muted:#6c757d;--link:#3660a5;--link-hover:#1659c5;--code:#f8f8f8;--active:#fff598;--accent:#eee;--accent2:#c1c1c1;--nav-hover:rgba(255, 255, 255, 0.5);--name:#0066BB;--def:#008800;--annotation:#007020;}</style>
<style>/*! layout.css */html, body{width:100%;height:100%;}html, main{scroll-behavior:smooth;}body{background-color:var(--pdoc-background);}@media (max-width:769px){#navtoggle{cursor:pointer;position:absolute;width:50px;height:40px;top:1rem;right:1rem;border-color:var(--text);color:var(--text);display:flex;opacity:0.8;z-index:999;}#navtoggle:hover{opacity:1;}#togglestate + div{display:none;}#togglestate:checked + div{display:inherit;}main, header{padding:2rem 3vw;}header + main{margin-top:-3rem;}.git-button{display:none !important;}nav input[type="search"]{max-width:77%;}nav input[type="search"]:first-child{margin-top:-6px;}nav input[type="search"]:valid ~ *{display:none !important;}}@media (min-width:770px){:root{--sidebar-width:clamp(12.5rem, 28vw, 22rem);}nav{position:fixed;overflow:auto;height:100vh;width:var(--sidebar-width);}main, header{padding:3rem 2rem 3rem calc(var(--sidebar-width) + 3rem);width:calc(54rem + var(--sidebar-width));max-width:100%;}header + main{margin-top:-4rem;}#navtoggle{display:none;}}#togglestate{position:absolute;height:0;opacity:0;}nav.pdoc{--pad:clamp(0.5rem, 2vw, 1.75rem);--indent:1.5rem;background-color:var(--accent);border-right:1px solid var(--accent2);box-shadow:0 0 20px rgba(50, 50, 50, .2) inset;padding:0 0 0 var(--pad);overflow-wrap:anywhere;scrollbar-width:thin; scrollbar-color:var(--accent2) transparent; z-index:1}nav.pdoc::-webkit-scrollbar{width:.4rem; }nav.pdoc::-webkit-scrollbar-thumb{background-color:var(--accent2); }nav.pdoc > div{padding:var(--pad) 0;}nav.pdoc .module-list-button{display:inline-flex;align-items:center;color:var(--text);border-color:var(--muted);margin-bottom:1rem;}nav.pdoc .module-list-button:hover{border-color:var(--text);}nav.pdoc input[type=search]{display:block;outline-offset:0;width:calc(100% - var(--pad));}nav.pdoc .logo{max-width:calc(100% - var(--pad));max-height:35vh;display:block;margin:0 auto 1rem;transform:translate(calc(-.5 * var(--pad)), 0);}nav.pdoc ul{list-style:none;padding-left:0;}nav.pdoc > div > ul{margin-left:calc(0px - var(--pad));}nav.pdoc li a{padding:.2rem 0 .2rem calc(var(--pad) + var(--indent));}nav.pdoc > div > ul > li > a{padding-left:var(--pad);}nav.pdoc li{transition:all 100ms;}nav.pdoc li:hover{background-color:var(--nav-hover);}nav.pdoc a, nav.pdoc a:hover{color:var(--text);}nav.pdoc a{display:block;}nav.pdoc > h2:first-of-type{margin-top:1.5rem;}nav.pdoc .class:before{content:"class ";color:var(--muted);}nav.pdoc .function:after{content:"()";color:var(--muted);}nav.pdoc footer:before{content:"";display:block;width:calc(100% - var(--pad));border-top:solid var(--accent2) 1px;margin-top:1.5rem;padding-top:.5rem;}nav.pdoc footer{font-size:small;}</style>
<style>/*! content.css */.pdoc{color:var(--text);box-sizing:border-box;line-height:1.5;background:none;}.pdoc .pdoc-button{cursor:pointer;display:inline-block;border:solid black 1px;border-radius:2px;font-size:.75rem;padding:calc(0.5em - 1px) 1em;transition:100ms all;}.pdoc .alert{padding:1rem 1rem 1rem calc(1.5rem + 24px);border:1px solid transparent;border-radius:.25rem;background-repeat:no-repeat;background-position:.75rem center;margin-bottom:1rem;}.pdoc .alert > em{display:none;}.pdoc .alert > *:last-child{margin-bottom:0;}.pdoc .alert.note {color:#084298;background-color:#cfe2ff;border-color:#b6d4fe;background-image:url("data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20width%3D%2224%22%20height%3D%2224%22%20fill%3D%22%23084298%22%20viewBox%3D%220%200%2016%2016%22%3E%3Cpath%20d%3D%22M8%2016A8%208%200%201%200%208%200a8%208%200%200%200%200%2016zm.93-9.412-1%204.705c-.07.34.029.533.304.533.194%200%20.487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703%200-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381%202.29-.287zM8%205.5a1%201%200%201%201%200-2%201%201%200%200%201%200%202z%22/%3E%3C/svg%3E");}.pdoc .alert.warning{color:#664d03;background-color:#fff3cd;border-color:#ffecb5;background-image:url("data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20width%3D%2224%22%20height%3D%2224%22%20fill%3D%22%23664d03%22%20viewBox%3D%220%200%2016%2016%22%3E%3Cpath%20d%3D%22M8.982%201.566a1.13%201.13%200%200%200-1.96%200L.165%2013.233c-.457.778.091%201.767.98%201.767h13.713c.889%200%201.438-.99.98-1.767L8.982%201.566zM8%205c.535%200%20.954.462.9.995l-.35%203.507a.552.552%200%200%201-1.1%200L7.1%205.995A.905.905%200%200%201%208%205zm.002%206a1%201%200%201%201%200%202%201%201%200%200%201%200-2z%22/%3E%3C/svg%3E");}.pdoc .alert.danger{color:#842029;background-color:#f8d7da;border-color:#f5c2c7;background-image:url("data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20width%3D%2224%22%20height%3D%2224%22%20fill%3D%22%23842029%22%20viewBox%3D%220%200%2016%2016%22%3E%3Cpath%20d%3D%22M5.52.359A.5.5%200%200%201%206%200h4a.5.5%200%200%201%20.474.658L8.694%206H12.5a.5.5%200%200%201%20.395.807l-7%209a.5.5%200%200%201-.873-.454L6.823%209.5H3.5a.5.5%200%200%201-.48-.641l2.5-8.5z%22/%3E%3C/svg%3E");}.pdoc .visually-hidden{position:absolute !important;width:1px !important;height:1px !important;padding:0 !important;margin:-1px !important;overflow:hidden !important;clip:rect(0, 0, 0, 0) !important;white-space:nowrap !important;border:0 !important;}.pdoc h1, .pdoc h2, .pdoc h3{font-weight:300;margin:.3em 0;padding:.2em 0;}.pdoc > section:not(.module-info) h1{font-size:1.5rem;font-weight:500;}.pdoc > section:not(.module-info) h2{font-size:1.4rem;font-weight:500;}.pdoc > section:not(.module-info) h3{font-size:1.3rem;font-weight:500;}.pdoc > section:not(.module-info) h4{font-size:1.2rem;}.pdoc > section:not(.module-info) h5{font-size:1.1rem;}.pdoc a{text-decoration:none;color:var(--link);}.pdoc a:hover{color:var(--link-hover);}.pdoc blockquote{margin-left:2rem;}.pdoc pre{border-top:1px solid var(--accent2);border-bottom:1px solid var(--accent2);margin-top:0;margin-bottom:1em;padding:.5rem 0 .5rem .5rem;overflow-x:auto;background-color:var(--code);}.pdoc code{color:var(--text);padding:.2em .4em;margin:0;font-size:85%;background-color:var(--accent);border-radius:6px;}.pdoc a > code{color:inherit;}.pdoc pre > code{display:inline-block;font-size:inherit;background:none;border:none;padding:0;}.pdoc > section:not(.module-info){margin-bottom:1.5rem;}.pdoc .modulename{margin-top:0;font-weight:bold;}.pdoc .modulename a{color:var(--link);transition:100ms all;}.pdoc .git-button{float:right;border:solid var(--link) 1px;}.pdoc .git-button:hover{background-color:var(--link);color:var(--pdoc-background);}.view-source-toggle-state,.view-source-toggle-state ~ .pdoc-code{display:none;}.view-source-toggle-state:checked ~ .pdoc-code{display:block;}.view-source-button{display:inline-block;float:right;font-size:.75rem;line-height:1.5rem;color:var(--muted);padding:0 .4rem 0 1.3rem;cursor:pointer;text-indent:-2px;}.view-source-button > span{visibility:hidden;}.module-info .view-source-button{float:none;display:flex;justify-content:flex-end;margin:-1.2rem .4rem -.2rem 0;}.view-source-button::before{position:absolute;content:"View Source";display:list-item;list-style-type:disclosure-closed;}.view-source-toggle-state:checked ~ .attr .view-source-button::before,.view-source-toggle-state:checked ~ .view-source-button::before{list-style-type:disclosure-open;}.pdoc .docstring{margin-bottom:1.5rem;}.pdoc section:not(.module-info) .docstring{margin-left:clamp(0rem, 5vw - 2rem, 1rem);}.pdoc .docstring .pdoc-code{margin-left:1em;margin-right:1em;}.pdoc h1:target,.pdoc h2:target,.pdoc h3:target,.pdoc h4:target,.pdoc h5:target,.pdoc h6:target,.pdoc .pdoc-code > pre > span:target{background-color:var(--active);box-shadow:-1rem 0 0 0 var(--active);}.pdoc .pdoc-code > pre > span:target{display:block;}.pdoc div:target > .attr,.pdoc section:target > .attr,.pdoc dd:target > a{background-color:var(--active);}.pdoc *{scroll-margin:2rem;}.pdoc .pdoc-code .linenos{user-select:none;}.pdoc .attr:hover{filter:contrast(0.95);}.pdoc section, .pdoc .classattr{position:relative;}.pdoc .headerlink{--width:clamp(1rem, 3vw, 2rem);position:absolute;top:0;left:calc(0rem - var(--width));transition:all 100ms ease-in-out;opacity:0;}.pdoc .headerlink::before{content:"#";display:block;text-align:center;width:var(--width);height:2.3rem;line-height:2.3rem;font-size:1.5rem;}.pdoc .attr:hover ~ .headerlink,.pdoc *:target > .headerlink,.pdoc .headerlink:hover{opacity:1;}.pdoc .attr{display:block;margin:.5rem 0 .5rem;padding:.4rem .4rem .4rem 1rem;background-color:var(--accent);overflow-x:auto;}.pdoc .classattr{margin-left:2rem;}.pdoc .decorator-deprecated{color:#842029;}.pdoc .decorator-deprecated ~ span{filter:grayscale(1) opacity(0.8);}.pdoc .name{color:var(--name);font-weight:bold;}.pdoc .def{color:var(--def);font-weight:bold;}.pdoc .signature{background-color:transparent;}.pdoc .param, .pdoc .return-annotation{white-space:pre;}.pdoc .signature.multiline .param{display:block;}.pdoc .signature.condensed .param{display:inline-block;}.pdoc .annotation{color:var(--annotation);}.pdoc .view-value-toggle-state,.pdoc .view-value-toggle-state ~ .default_value{display:none;}.pdoc .view-value-toggle-state:checked ~ .default_value{display:inherit;}.pdoc .view-value-button{font-size:.5rem;vertical-align:middle;border-style:dashed;margin-top:-0.1rem;}.pdoc .view-value-button:hover{background:white;}.pdoc .view-value-button::before{content:"show";text-align:center;width:2.2em;display:inline-block;}.pdoc .view-value-toggle-state:checked ~ .view-value-button::before{content:"hide";}.pdoc .inherited{margin-left:2rem;}.pdoc .inherited dt{font-weight:700;}.pdoc .inherited dt, .pdoc .inherited dd{display:inline;margin-left:0;margin-bottom:.5rem;}.pdoc .inherited dd:not(:last-child):after{content:", ";}.pdoc .inherited .class:before{content:"class ";}.pdoc .inherited .function a:after{content:"()";}.pdoc .search-result .docstring{overflow:auto;max-height:25vh;}.pdoc .search-result.focused > .attr{background-color:var(--active);}.pdoc .attribution{margin-top:2rem;display:block;opacity:0.5;transition:all 200ms;filter:grayscale(100%);}.pdoc .attribution:hover{opacity:1;filter:grayscale(0%);}.pdoc .attribution img{margin-left:5px;height:35px;vertical-align:middle;width:70px;transition:all 200ms;}.pdoc table{display:block;width:max-content;max-width:100%;overflow:auto;margin-bottom:1rem;}.pdoc table th{font-weight:600;}.pdoc table th, .pdoc table td{padding:6px 13px;border:1px solid var(--accent2);}</style>
<style>/*! custom.css */</style></head>

        <input type="search" placeholder="Search..." role="searchbox" aria-label="search"
               pattern=".+" required>


        <h2>Submodules</h2>
        <ul>
                <li><a href="jabs_mimir/Mimir.html">Mimir</a></li>
                <li><a href="jabs_mimir/DataBlockWrapper.html">DataBlockWrapper</a></li>
                <li><a href="jabs_mimir/UtilityModule.html">UtilityModule</a></li>
        </ul>

        <h2>API Documentation</h2>
            <ul class="memberlist">
        <li>
                <a class="class" href="#Mimir">Mimir</a>
                        <ul class="memberlist">
                    <li>
                            <a class="function" href="#Mimir.__init__">Mimir</a>
                    </li>
                    <li>
                            <a class="variable" href="#Mimir.widthEntry">widthEntry</a>
                    </li>
                    <li>
                            <a class="variable" href="#Mimir.widthCombo">widthCombo</a>
                    </li>
                    <li>
                            <a class="variable" href="#Mimir.app">app</a>
                    </li>
                    <li>
                            <a class="variable" href="#Mimir.currentView">currentView</a>
                    </li>
                    <li>
                            <a class="variable" href="#Mimir.invalidEntries">invalidEntries</a>
                    </li>
                    <li>
                            <a class="variable" href="#Mimir.fieldRenderers">fieldRenderers</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.allowDarkMode">allowDarkMode</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.setValidatorResolver">setValidatorResolver</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.switchView">switchView</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.popupView">popupView</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.renderBlockUI">renderBlockUI</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.registerFieldType">registerFieldType</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.markInvalid">markInvalid</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.clearInvalid">clearInvalid</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.addNextButton">addNextButton</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.getCurrentFont">getCurrentFont</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.addTooltip">addTooltip</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.removeBlock">removeBlock</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.addLabeledEntry">addLabeledEntry</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.addLabeledCombobox">addLabeledCombobox</a>
                    </li>
                    <li>
                            <a class="function" href="#Mimir.getNextAvailableRow">getNextAvailableRow</a>
                    </li>
            </ul>

        </li>
        <li>
                <a class="class" href="#DataBlockWrapper">DataBlockWrapper</a>
                        <ul class="memberlist">
                    <li>
                            <a class="function" href="#DataBlockWrapper.__init__">DataBlockWrapper</a>
                    </li>
                    <li>
                            <a class="variable" href="#DataBlockWrapper.meta">meta</a>
                    </li>
                    <li>
                            <a class="function" href="#DataBlockWrapper.get">get</a>
                    </li>
                    <li>
                            <a class="function" href="#DataBlockWrapper.set">set</a>
                    </li>
                    <li>
                            <a class="function" href="#DataBlockWrapper.items">items</a>
                    </li>
                    <li>
                            <a class="function" href="#DataBlockWrapper.values">values</a>
                    </li>
                    <li>
                            <a class="function" href="#DataBlockWrapper.keys">keys</a>
                    </li>
            </ul>

        </li>
        <li>
                <a class="class" href="#UtilityModule">UtilityModule</a>
                        <ul class="memberlist">
                    <li>
                            <a class="function" href="#UtilityModule.buildBlockMeta">buildBlockMeta</a>
                    </li>
                    <li>
                            <a class="function" href="#UtilityModule.getBlockValues">getBlockValues</a>
                    </li>
                    <li>
                            <a class="function" href="#UtilityModule.updateBlockFromDict">updateBlockFromDict</a>
                    </li>
                    <li>
                            <a class="function" href="#UtilityModule.isBlockValid">isBlockValid</a>
                    </li>
            </ul>

        </li>
</ul>



    <a class="attribution" title="pdoc: Python API documentation generator" href="https://pdoc.dev" target="_blank">
        built with <span class="visually-hidden">pdoc</span><img
            alt="pdoc logo"
            src="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20role%3D%22img%22%20aria-label%3D%22pdoc%20logo%22%20width%3D%22300%22%20height%3D%22150%22%20viewBox%3D%22-1%200%2060%2030%22%3E%3Ctitle%3Epdoc%3C/title%3E%3Cpath%20d%3D%22M29.621%2021.293c-.011-.273-.214-.475-.511-.481a.5.5%200%200%200-.489.503l-.044%201.393c-.097.551-.695%201.215-1.566%201.704-.577.428-1.306.486-2.193.182-1.426-.617-2.467-1.654-3.304-2.487l-.173-.172a3.43%203.43%200%200%200-.365-.306.49.49%200%200%200-.286-.196c-1.718-1.06-4.931-1.47-7.353.191l-.219.15c-1.707%201.187-3.413%202.131-4.328%201.03-.02-.027-.49-.685-.141-1.763.233-.721.546-2.408.772-4.076.042-.09.067-.187.046-.288.166-1.347.277-2.625.241-3.351%201.378-1.008%202.271-2.586%202.271-4.362%200-.976-.272-1.935-.788-2.774-.057-.094-.122-.18-.184-.268.033-.167.052-.339.052-.516%200-1.477-1.202-2.679-2.679-2.679-.791%200-1.496.352-1.987.9a6.3%206.3%200%200%200-1.001.029c-.492-.564-1.207-.929-2.012-.929-1.477%200-2.679%201.202-2.679%202.679A2.65%202.65%200%200%200%20.97%206.554c-.383.747-.595%201.572-.595%202.41%200%202.311%201.507%204.29%203.635%205.107-.037.699-.147%202.27-.423%203.294l-.137.461c-.622%202.042-2.515%208.257%201.727%2010.643%201.614.908%203.06%201.248%204.317%201.248%202.665%200%204.492-1.524%205.322-2.401%201.476-1.559%202.886-1.854%206.491.82%201.877%201.393%203.514%201.753%204.861%201.068%202.223-1.713%202.811-3.867%203.399-6.374.077-.846.056-1.469.054-1.537zm-4.835%204.313c-.054.305-.156.586-.242.629-.034-.007-.131-.022-.307-.157-.145-.111-.314-.478-.456-.908.221.121.432.25.675.355.115.039.219.051.33.081zm-2.251-1.238c-.05.33-.158.648-.252.694-.022.001-.125-.018-.307-.157-.217-.166-.488-.906-.639-1.573.358.344.754.693%201.198%201.036zm-3.887-2.337c-.006-.116-.018-.231-.041-.342.635.145%201.189.368%201.599.625.097.231.166.481.174.642-.03.049-.055.101-.067.158-.046.013-.128.026-.298.004-.278-.037-.901-.57-1.367-1.087zm-1.127-.497c.116.306.176.625.12.71-.019.014-.117.045-.345.016-.206-.027-.604-.332-.986-.695.41-.051.816-.056%201.211-.031zm-4.535%201.535c.209.22.379.47.358.598-.006.041-.088.138-.351.234-.144.055-.539-.063-.979-.259a11.66%2011.66%200%200%200%20.972-.573zm.983-.664c.359-.237.738-.418%201.126-.554.25.237.479.548.457.694-.006.042-.087.138-.351.235-.174.064-.694-.105-1.232-.375zm-3.381%201.794c-.022.145-.061.29-.149.401-.133.166-.358.248-.69.251h-.002c-.133%200-.306-.26-.45-.621.417.091.854.07%201.291-.031zm-2.066-8.077a4.78%204.78%200%200%201-.775-.584c.172-.115.505-.254.88-.378l-.105.962zm-.331%202.302a10.32%2010.32%200%200%201-.828-.502c.202-.143.576-.328.984-.49l-.156.992zm-.45%202.157l-.701-.403c.214-.115.536-.249.891-.376a11.57%2011.57%200%200%201-.19.779zm-.181%201.716c.064.398.194.702.298.893-.194-.051-.435-.162-.736-.398.061-.119.224-.3.438-.495zM8.87%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zm-.735-.389a1.15%201.15%200%200%200-.314.783%201.16%201.16%200%200%200%201.162%201.162c.457%200%20.842-.27%201.032-.653.026.117.042.238.042.362a1.68%201.68%200%200%201-1.679%201.679%201.68%201.68%200%200%201-1.679-1.679c0-.843.626-1.535%201.436-1.654zM5.059%205.406A1.68%201.68%200%200%201%203.38%207.085a1.68%201.68%200%200%201-1.679-1.679c0-.037.009-.072.011-.109.21.3.541.508.935.508a1.16%201.16%200%200%200%201.162-1.162%201.14%201.14%200%200%200-.474-.912c.015%200%20.03-.005.045-.005.926.001%201.679.754%201.679%201.68zM3.198%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zM1.375%208.964c0-.52.103-1.035.288-1.52.466.394%201.06.64%201.717.64%201.144%200%202.116-.725%202.499-1.738.383%201.012%201.355%201.738%202.499%201.738.867%200%201.631-.421%202.121-1.062.307.605.478%201.267.478%201.942%200%202.486-2.153%204.51-4.801%204.51s-4.801-2.023-4.801-4.51zm24.342%2019.349c-.985.498-2.267.168-3.813-.979-3.073-2.281-5.453-3.199-7.813-.705-1.315%201.391-4.163%203.365-8.423.97-3.174-1.786-2.239-6.266-1.261-9.479l.146-.492c.276-1.02.395-2.457.444-3.268a6.11%206.11%200%200%200%201.18.115%206.01%206.01%200%200%200%202.536-.562l-.006.175c-.802.215-1.848.612-2.021%201.25-.079.295.021.601.274.837.219.203.415.364.598.501-.667.304-1.243.698-1.311%201.179-.02.144-.022.507.393.787.213.144.395.26.564.365-1.285.521-1.361.96-1.381%201.126-.018.142-.011.496.427.746l.854.489c-.473.389-.971.914-.999%201.429-.018.278.095.532.316.713.675.556%201.231.721%201.653.721.059%200%20.104-.014.158-.02.207.707.641%201.64%201.513%201.64h.013c.8-.008%201.236-.345%201.462-.626.173-.216.268-.457.325-.692.424.195.93.374%201.372.374.151%200%20.294-.021.423-.068.732-.27.944-.704.993-1.021.009-.061.003-.119.002-.179.266.086.538.147.789.147.15%200%20.294-.021.423-.069.542-.2.797-.489.914-.754.237.147.478.258.704.288.106.014.205.021.296.021.356%200%20.595-.101.767-.229.438.435%201.094.992%201.656%201.067.106.014.205.021.296.021a1.56%201.56%200%200%200%20.323-.035c.17.575.453%201.289.866%201.605.358.273.665.362.914.362a.99.99%200%200%200%20.421-.093%201.03%201.03%200%200%200%20.245-.164c.168.428.39.846.68%201.068.358.273.665.362.913.362a.99.99%200%200%200%20.421-.093c.317-.148.512-.448.639-.762.251.157.495.257.726.257.127%200%20.25-.024.37-.071.427-.17.706-.617.841-1.314.022-.015.047-.022.068-.038.067-.051.133-.104.196-.159-.443%201.486-1.107%202.761-2.086%203.257zM8.66%209.925a.5.5%200%201%200-1%200c0%20.653-.818%201.205-1.787%201.205s-1.787-.552-1.787-1.205a.5.5%200%201%200-1%200c0%201.216%201.25%202.205%202.787%202.205s2.787-.989%202.787-2.205zm4.4%2015.965l-.208.097c-2.661%201.258-4.708%201.436-6.086.527-1.542-1.017-1.88-3.19-1.844-4.198a.4.4%200%200%200-.385-.414c-.242-.029-.406.164-.414.385-.046%201.249.367%203.686%202.202%204.896.708.467%201.547.7%202.51.7%201.248%200%202.706-.392%204.362-1.174l.185-.086a.4.4%200%200%200%20.205-.527c-.089-.204-.326-.291-.527-.206zM9.547%202.292c.093.077.205.114.317.114a.5.5%200%200%200%20.318-.886L8.817.397a.5.5%200%200%200-.703.068.5.5%200%200%200%20.069.703l1.364%201.124zm-7.661-.065c.086%200%20.173-.022.253-.068l1.523-.893a.5.5%200%200%200-.506-.863l-1.523.892a.5.5%200%200%200-.179.685c.094.158.261.247.432.247z%22%20transform%3D%22matrix%28-1%200%200%201%2058%200%29%22%20fill%3D%22%233bb300%22/%3E%3Cpath%20d%3D%22M.3%2021.86V10.18q0-.46.02-.68.04-.22.18-.5.28-.54%201.34-.54%201.06%200%201.42.28.38.26.44.78.76-1.04%202.38-1.04%201.64%200%203.1%201.54%201.46%201.54%201.46%203.58%200%202.04-1.46%203.58-1.44%201.54-3.08%201.54-1.64%200-2.38-.92v4.04q0%20.46-.04.68-.02.22-.18.5-.14.3-.5.42-.36.12-.98.12-.62%200-1-.12-.36-.12-.52-.4-.14-.28-.18-.5-.02-.22-.02-.68zm3.96-9.42q-.46.54-.46%201.18%200%20.64.46%201.18.48.52%201.2.52.74%200%201.24-.52.52-.52.52-1.18%200-.66-.48-1.18-.48-.54-1.26-.54-.76%200-1.22.54zm14.741-8.36q.16-.3.54-.42.38-.12%201-.12.64%200%201.02.12.38.12.52.42.16.3.18.54.04.22.04.68v11.94q0%20.46-.04.7-.02.22-.18.5-.3.54-1.7.54-1.38%200-1.54-.98-.84.96-2.34.96-1.8%200-3.28-1.56-1.48-1.58-1.48-3.66%200-2.1%201.48-3.68%201.5-1.58%203.28-1.58%201.48%200%202.3%201v-4.2q0-.46.02-.68.04-.24.18-.52zm-3.24%2010.86q.52.54%201.26.54.74%200%201.22-.54.5-.54.5-1.18%200-.66-.48-1.22-.46-.56-1.26-.56-.8%200-1.28.56-.48.54-.48%201.2%200%20.66.52%201.2zm7.833-1.2q0-2.4%201.68-3.96%201.68-1.56%203.84-1.56%202.16%200%203.82%201.56%201.66%201.54%201.66%203.94%200%201.66-.86%202.96-.86%201.28-2.1%201.9-1.22.6-2.54.6-1.32%200-2.56-.64-1.24-.66-2.1-1.92-.84-1.28-.84-2.88zm4.18%201.44q.64.48%201.3.48.66%200%201.32-.5.66-.5.66-1.48%200-.98-.62-1.46-.62-.48-1.34-.48-.72%200-1.34.5-.62.5-.62%201.48%200%20.96.64%201.46zm11.412-1.44q0%20.84.56%201.32.56.46%201.18.46.64%200%201.18-.36.56-.38.9-.38.6%200%201.46%201.06.46.58.46%201.04%200%20.76-1.1%201.42-1.14.8-2.8.8-1.86%200-3.58-1.34-.82-.64-1.34-1.7-.52-1.08-.52-2.36%200-1.3.52-2.34.52-1.06%201.34-1.7%201.66-1.32%203.54-1.32.76%200%201.48.22.72.2%201.06.4l.32.2q.36.24.56.38.52.4.52.92%200%20.5-.42%201.14-.72%201.1-1.38%201.1-.38%200-1.08-.44-.36-.34-1.04-.34-.66%200-1.24.48-.58.48-.58%201.34z%22%20fill%3D%22green%22/%3E%3C/svg%3E"/>
    </a>

jabs_mimir

                    <input id="mod-jabs_mimir-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

                    <label class="view-source-button" for="mod-jabs_mimir-view-source"><span>View Source</span></label>

                    <div class="pdoc-code codehilite"><pre><span></span><span id="L-1"><a href="#L-1"><span class="linenos">1</span></a><span class="kn">from</span><span class="w"> </span><span class="nn">.Mimir</span><span class="w"> </span><span class="kn">import</span> <span class="n">Mimir</span>

2from .DataBlockWrapper import DataBlockWrapper 3from .UtilityModule import UtilityModule 4 5all = ["Mimir", "DataBlockWrapper", "UtilityModule"]

        </section>
            <section id="Mimir">
                        <input id="Mimir-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

<span class="def">class</span>
<span class="name">Mimir</span>:

            <label class="view-source-button" for="Mimir-view-source"><span>View Source</span></label>

</div>
<a class="headerlink" href="#Mimir"></a>
        <div class="pdoc-code codehilite"><pre><span></span><span id="Mimir-16"><a href="#Mimir-16"><span class="linenos"> 16</span></a><span class="k">class</span><span class="w"> </span><span class="nc">Mimir</span><span class="p">:</span>

17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104105106107108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166167 168 169 170171 172 173 174 175 176 177 179 180 181182 183 184 185 186 187 188 189 190 191192 193 194 195 196 197 198 199 200 201 202 203 204 205206 207 208 209 210 211 212 213 214 215 216 217 218 219220 221 222 223 224225 226 227 228 229230231232233234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266267 268 269 270 271 272273 274 275 276277278279280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305306307308309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350351352353 354 355 356 357 358

widthEntry = 20 widthCombo = widthEntry - 2 def init(self, app): """ class=sd> Initialize Mimir with reference to the root app window. class=sd> """ self.app = app self.currentView = None self.invalidEntries = set() self._validatorResolver = lambda name: None self.fieldRenderers = { "entry": self._renderEntryField, "combobox": self._renderComboboxField, "heading": self._renderHeading, } self._allowThemeToggle = False def allowDarkMode(self, enabled=True): """Enable or disable theme toggle button in the top right.""" self._allowThemeToggle = enabled def _toggleTheme(self): """Switch between light and dark themes.""" current = self.app.style.theme.name self.app.style.theme_use("darkly" if current != "darkly" else "cosmo") def setValidatorResolver(self, resolverFunc): """Register a function that returns validation callbacks by name.""" self._validatorResolver = resolverFunc def switchView(self, newFrameFunc, gridOptions=None, kwargs): 49 """ class=sd> Replace the current view with a new frame built by newFrameFunc. class=sd> Automatically configures geometry and grid placement. class=sd> """
if self.currentView: self.currentView.destroy() container = tb.Frame(self.app) container.grid(row=0, column=0, sticky="nsew") container.columnconfigure(0, weight=1) topBar = tb.Frame(container) topBar.grid(row=0, column=0, sticky="ew") if self._allowThemeToggle: tb.Button(topBar, text="Theme", command=self._toggleTheme).pack(side="right", padx=10, pady=10) newFrame = newFrameFunc(self, kwargs) options = gridOptions or {"row": 1, "column": 0, "sticky": "n", "padx": 50, "pady": 20} newFrame.grid(options) 69 self.app.rowconfigure(options.get("row", 0), weight=1) self.app.columnconfigure(options.get("column", 0), weight=1) self.currentView = newFrame self.app.update_idletasks() self.app.geometry("") return newFrame def popupView(self, viewFunc, title="Popup", size="fit", width=500, height=400, modal=False): """ class=sd> Open a popup window and embed a view frame into it. class=sd> If modal=True, interaction with other windows is blocked. class=sd> """
popup = tk.Toplevel(self.app) popup.title(title) popup.transient(self.app) popup.resizable(False, False) if size == "fit": popup.update_idletasks() popup.geometry("") else: popup.geometry(f"{width}x{height}") popup.grid_rowconfigure(0, weight=1) popup.grid_columnconfigure(0, weight=1) viewFrame = viewFunc(self, popup) viewFrame.grid(row=0, column=0, sticky="nsew") if modal: popup.grab_set() popup.focus_set() return popup def renderBlockUI(self, container, fields, blockList, layout="horizontal", meta=None, label=None, noRemove=False): class=w> """ class=sd> Render a labeled input block with specified fields and layout style. class=sd> Automatically attaches the block to blockList and handles UI labels and deletion logic. class=sd> """
index = len(blockList) + 1 labelText = label or f"Block {index}" frame = tb.LabelFrame(container, text=labelText) frame.configure(labelanchor="n")
if layout == "vertical": frame.grid(row=index - 1, column=0, padx=10, pady=10, sticky="w") else: frame.grid(row=0, column=index - 1, padx=10, pady=10, sticky="n") boldFont = self.getCurrentFont() boldFont.configure(weight="bold") if meta is None: meta = {} if "custom_label" not in meta and label: meta["custom_label"] = label blockMeta = { "frame": frame, "fields": fields, "fields_by_key": {f["key"]: f["variable"] for f in fields if "key" in f}, "layout": layout, meta } wrapper = DataBlockWrapper(blockMeta) blockList.append(wrapper) row = 0 for field in fields: ftype = field.get("type", "entry") renderer = self.fieldRenderers.get(ftype) if renderer: renderer(frame, row, field) # Adjust row offset based on field type if ftype == "fileupload": row += 3 elif ftype == "heading": row += 1 else: row += 2 if not noRemove: removeBtn = tb.Button( frame, text="🗑️ Ta bort", bootstyle="danger-outline", command=lambda w=wrapper: self.removeBlock(blockList, w) ) removeBtn.grid(row=row, column=0, columnspan=2, pady=(10, 5)) return wrapper def registerFieldType(self, name, renderer): class=w> """Register a custom field renderer by name."""
self.fieldRenderers[name] = renderer def _renderEntryField(self, parent, row, field): class=w> """Internal: Render an entry field with label.""" self.addLabeledEntry( parent=parent, row=row, label=field["label"], variable=field["variable"], validation=field.get("validation"), field.get("options", {}) # <-- wildcard pass-through os>178 ) def _renderComboboxField(self, parent, row, field): class=w> """Internal: Render a combobox field with label.""" self.addLabeledCombobox( parent=parent, row=row, label=field["label"], variable=field["variable"], values=field["values"], field.get("options", {}) # <-- pass all UI customization ) def _renderHeading(self, parent, row, field): class=w> """Internal: Render a bold heading label within a form.""" font = self.getCurrentFont() font.configure(weight="bold") align = field.get("options", {}).get("align", "w") # default to left tb.Label( parent, text=field["label"], font=font ).grid(row=row, column=0, columnspan=2, pady=(10, 5), sticky=align) def _setupValidation(self, widget, validationName): class=w> """Bind focus-out validation using a named validation function.""" fn = self._validatorResolver(validationName) if validationName else None if not callable(fn): return def validate(event): if fn(widget.get()): self.clearInvalid(widget) else: self.markInvalid(widget) widget.bind("<FocusOut>", validate) def markInvalid(self, widget): class=w> """Mark a widget as invalid with red border styling.""" widget.config(bootstyle="danger") self.invalidEntries.add(widget) def clearInvalid(self, widget): class=w> """Clear error styling from a widget.""" widget.config(bootstyle="none") self.invalidEntries.discard(widget) def addNextButton(self, parent, row, command, label="Nästa", tooltip=None, column=None, columnspan=None): class=w> """ class=sd> Add a 'Next' button to the given row. Automatically spans the full width class=sd> of horizontal blocks if no column or columnspan is provided. class=sd> Blocks execution if any fields are invalid. class=sd> """
def wrapped(): if self.invalidEntries: msg.showerror("Fel", "Alla fält måste vara giltiga innan du kan fortsätta.") return command() # Calculate default columnspan if not explicitly provided if column is None or columnspan is None: # Find all unique columns used in row=0 (block layout) used_columns = set() for child in parent.winfo_children(): grid = child.grid_info() if grid.get("row") == 0 and "column" in grid: used_columns.add(int(grid["column"])) if not used_columns: column = 0 columnspan = 1 else: column = 0 columnspan = max(used_columns) + 1 btn = tb.Button(parent, text=label, command=wrapped, bootstyle="success") btn.grid(row=row, column=column, columnspan=columnspan, pady=(10, 5)) if tooltip: self.addTooltip(btn, tooltip) return btn def getCurrentFont(self): class=w> """Return the default font currently used by ttkbootstrap widgets.""" style = tb.Style() fontName = style.lookup("TLabel", "font") return tkFont.Font(font=fontName) def addTooltip(self, widget, text): class=w> """Attach a styled tooltip to a widget.""" ToolTip(widget, text, bootstyle=(SECONDARY, INVERSE)) def removeBlock(self, blockList, wrapper): class=w> """ class=sd> Remove a UI block from view and list. Automatically reindexes class=sd> and repositions remaining blocks. class=sd> """
frame = wrapper.meta.get("frame") layout = wrapper.meta.get("layout", "horizontal") if frame: frame.destroy() blockList.remove(wrapper) for i, block in enumerate(blockList): frame = block.meta["frame"] new_label = f"Butik {i + 1}" # Update visual label frame.config(text=new_label) # Update meta so future logic knows the new label/index block.meta["custom_label"] = new_label block.meta["store_id"] = i + 1 # optional if store_id should follow display order # Reposition depending on layout if layout == "vertical": frame.grid_configure(row=i, column=0) else: frame.grid_configure(row=0, column=i) def addLabeledEntry(self, parent, row, label, variable, state="normal", tooltip=None, validation=None, column=0, vertical=False, columnspan=1): class=w> """ class=sd> Add a labeled entry input field. Supports vertical and horizontal layouts, class=sd> optional tooltips and validation. class=sd> """
if vertical: tb.Label(parent, text=label).grid(row=row, column=column, columnspan=columnspan, padx=5, pady=(5, 5)) entry = tb.Entry(parent, textvariable=variable, state=state, width=self.widthEntry) entry.grid(row=row + 1, column=column, padx=5, columnspan=columnspan, pady=(0, 10), sticky="ew") else: tb.Label(parent, text=label).grid(row=row, column=column, padx=5, pady=5, sticky="e") entry = tb.Entry(parent, textvariable=variable, state=state, width=self.widthEntry) entry.grid(row=row, column=column + 1, columnspan=columnspan, padx=5, pady=5, sticky="ew") if tooltip: self.addTooltip(entry, tooltip) validationFunc = self.resolveValidator(validation) if validation else None if callable(validationFunc): def onFocusOut(event): value = entry.get() if validationFunc(value): self.clearInvalid(entry) else: self.markInvalid(entry) entry.bind("<FocusOut>", onFocusOut) return entry def addLabeledCombobox(self, parent, row, label, variable, values, tooltip=None, state="readonly", column=0, vertical=False, columnspan=1): class=w> """Add a labeled combobox dropdown field with options.""" if vertical: tb.Label(parent, text=label).grid(row=row, column=column, columnspan=columnspan, padx=5, pady=(5, 0)) combo = tb.Combobox(parent, textvariable=variable, values=values, state=state, width=self.widthCombo) combo.grid(row=row + 1, column=column, columnspan=columnspan, padx=5, pady=(0, 10)) else: tb.Label(parent, text=label).grid(row=row, column=column, padx=5, pady=5, sticky="e") combo = tb.Combobox(parent, textvariable=variable, values=values, state=state, width=self.widthCombo) combo.grid(row=row, column=column + 1, columnspan=columnspan, padx=5, pady=5, sticky="ew") if tooltip: self.addTooltip(combo, tooltip) return combo def getNextAvailableRow(self, frame: tk.Widget) -> int: class=w> """ class=sd> Return the next available row in a container by checking occupied grid rows. class=sd> """
used_rows = [ child.grid_info().get("row") for child in frame.winfo_children() if "row" in child.grid_info() ] return max(used_rows, default=-1) + 1

<div id="Mimir.__init__" class="classattr"> <input id="Mimir.__init__-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

Mimir(app) <label class="view-source-button" for="Mimir.__init__-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.__init__"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.__init__-20">20</a> def __init__(self, app):

21 """ 22 Initialize Mimir with reference to the root app window. 23 """ 24 self.app = app 25 self.currentView = None 26 self.invalidEntries = set() 27 self._validatorResolver = lambda name: None 28 self.fieldRenderers = { 29 "entry": self._renderEntryField, 30 "combobox": self._renderComboboxField, 31 "heading": self._renderHeading, 32 } 33 self._allowThemeToggle = False

<div class="docstring">Initialize Mimir with reference to the root app window.

</div> <div id="Mimir.widthEntry" class="classattr"> <div class="attr variable"> widthEntry =

20

</div> <a class="headerlink" href="#Mimir.widthEntry"></a> </div> <div id="Mimir.widthCombo" class="classattr"> <div class="attr variable"> widthCombo =

18

</div> <a class="headerlink" href="#Mimir.widthCombo"></a> </div> <div id="Mimir.app" class="classattr"> <div class="attr variable"> app </div> <a class="headerlink" href="#Mimir.app"></a> </div> <div id="Mimir.currentView" class="classattr"> <div class="attr variable"> currentView </div> <a class="headerlink" href="#Mimir.currentView"></a> </div> <div id="Mimir.invalidEntries" class="classattr"> <div class="attr variable"> invalidEntries </div> <a class="headerlink" href="#Mimir.invalidEntries"></a> </div> <div id="Mimir.fieldRenderers" class="classattr"> <div class="attr variable"> fieldRenderers </div> <a class="headerlink" href="#Mimir.fieldRenderers"></a> </div> <div id="Mimir.allowDarkMode" class="classattr"> <input id="Mimir.allowDarkMode-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def allowDarkMode(self, enabled=True): <label class="view-source-button" for="Mimir.allowDarkMode-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.allowDarkMode"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.allowDarkMode-35">35</a> def allowDarkMode(self, enabled=True):

36 """Enable or disable theme toggle button in the top right.""" 37 self._allowThemeToggle = enabled

<div class="docstring">Enable or disable theme toggle button in the top right.

</div> <div id="Mimir.setValidatorResolver" class="classattr"> <input id="Mimir.setValidatorResolver-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def setValidatorResolver(self, resolverFunc): <label class="view-source-button" for="Mimir.setValidatorResolver-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.setValidatorResolver"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.setValidatorResolver-44">44</a> def setValidatorResolver(self, resolverFunc):

45 """Register a function that returns validation callbacks by name.""" 46 self._validatorResolver = resolverFunc

<div class="docstring">Register a function that returns validation callbacks by name.

</div> <div id="Mimir.switchView" class="classattr"> <input id="Mimir.switchView-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def switchView(self, newFrameFunc, gridOptions=None, **kwargs): <label class="view-source-button" for="Mimir.switchView-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.switchView"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.switchView-48">48</a> def switchView(self, newFrameFunc, gridOptions=None, **kwargs):

49 """ 50 Replace the current view with a new frame built by newFrameFunc. 51 Automatically configures geometry and grid placement. 52 """
53 if self.currentView: 54 self.currentView.destroy() 55 56 container = tb.Frame(self.app) 57 container.grid(row=0, column=0, sticky="nsew") 58 container.columnconfigure(0, weight=1) 59 60 topBar = tb.Frame(container) 61 topBar.grid(row=0, column=0, sticky="ew") 62 63 if self._allowThemeToggle: 64 tb.Button(topBar, text="Theme", command=self._toggleTheme).pack(side="right", padx=10, pady=10) 65 66 newFrame = newFrameFunc(self, kwargs) 67 options = gridOptions or {"row": 1, "column": 0, "sticky": "n", "padx": 50, "pady": 20} 68 newFrame.grid(options) 69 self.app.rowconfigure(options.get("row", 0), weight=1) 70 self.app.columnconfigure(options.get("column", 0), weight=1) 71 self.currentView = newFrame 72 self.app.update_idletasks() 73 self.app.geometry("") 74 return newFrame

<div class="docstring">Replace the current view with a new frame built by newFrameFunc.

Automatically configures geometry and grid placement.

</div> <div id="Mimir.popupView" class="classattr"> <input id="Mimir.popupView-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def popupView( self, viewFunc, title='Popup', size='fit', width=500, height=400, modal=False): <label class="view-source-button" for="Mimir.popupView-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.popupView"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.popupView-76"> 76</a> def popupView(self, viewFunc, title="Popup", size="fit", width=500, height=400, modal=False):

77 """ 78 Open a popup window and embed a view frame into it. 79 If modal=True, interaction with other windows is blocked. 80 """
81 popup = tk.Toplevel(self.app) 82 popup.title(title) 83 popup.transient(self.app) 84 popup.resizable(False, False) 85 86 if size == "fit": 87 popup.update_idletasks() 88 popup.geometry("") 89 else: 90 popup.geometry(f"{width}x{height}") 91 92 popup.grid_rowconfigure(0, weight=1) 93 popup.grid_columnconfigure(0, weight=1) 94 viewFrame = viewFunc(self, popup) 95 viewFrame.grid(row=0, column=0, sticky="nsew") 96 97 if modal: 98 popup.grab_set() 99 popup.focus_set() 100 101 return popup

<div class="docstring">Open a popup window and embed a view frame into it.

If modal=True, interaction with other windows is blocked.

</div> <div id="Mimir.renderBlockUI" class="classattr"> <input id="Mimir.renderBlockUI-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def renderBlockUI( self, container, fields, blockList, layout='horizontal', meta=None, label=None, noRemove=False): <label class="view-source-button" for="Mimir.renderBlockUI-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.renderBlockUI"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.renderBlockUI-103">103</a> def renderBlockUI(self, container, fields, blockList, layout="horizontal", meta=None, label=None, noRemove=False):

104 """ 105 Render a labeled input block with specified fields and layout style. 106 Automatically attaches the block to blockList and handles UI labels and deletion logic. 107 """
108 index = len(blockList) + 1 109 labelText = label or f"Block {index}" 110 frame = tb.LabelFrame(container, text=labelText) 111 frame.configure(labelanchor="n") 112
113 if layout == "vertical": 114 frame.grid(row=index - 1, column=0, padx=10, pady=10, sticky="w") 115 else: 116 frame.grid(row=0, column=index - 1, padx=10, pady=10, sticky="n") 117 118 boldFont = self.getCurrentFont() 119 boldFont.configure(weight="bold") 120 121 if meta is None: 122 meta = {} 123 if "custom_label" not in meta and label: 124 meta["custom_label"] = label 125 126 blockMeta = { 127 "frame": frame, 128 "fields": fields, 129 "fields_by_key": {f["key"]: f["variable"] for f in fields if "key" in f}, 130 "layout": layout, 131 **meta 132 } 133 134 135 wrapper = DataBlockWrapper(blockMeta) 136 blockList.append(wrapper) 137 138 row = 0 139 for field in fields: 140 ftype = field.get("type", "entry") 141 renderer = self.fieldRenderers.get(ftype) 142 if renderer: 143 renderer(frame, row, field) 144 145 # Adjust row offset based on field type 146 if ftype == "fileupload": 147 row += 3 148 elif ftype == "heading": 149 row += 1 150 else: 151 row += 2 152 153 if not noRemove: 154 removeBtn = tb.Button( 155 frame, 156 text="🗑️ Ta bort", 157 bootstyle="danger-outline", 158 command=lambda w=wrapper: self.removeBlock(blockList, w) 159 ) 160 removeBtn.grid(row=row, column=0, columnspan=2, pady=(10, 5)) 161 162 return wrapper

<div class="docstring">Render a labeled input block with specified fields and layout style.

Automatically attaches the block to blockList and handles UI labels and deletion logic.

</div> <div id="Mimir.registerFieldType" class="classattr"> <input id="Mimir.registerFieldType-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def registerFieldType(self, name, renderer): <label class="view-source-button" for="Mimir.registerFieldType-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.registerFieldType"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.registerFieldType-165">165</a> def registerFieldType(self, name, renderer):

166 """Register a custom field renderer by name."""
167 self.fieldRenderers[name] = renderer

<div class="docstring">Register a custom field renderer by name.

</div> <div id="Mimir.markInvalid" class="classattr"> <input id="Mimir.markInvalid-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def markInvalid(self, widget): <label class="view-source-button" for="Mimir.markInvalid-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.markInvalid"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.markInvalid-218">218</a> def markInvalid(self, widget):

219 """Mark a widget as invalid with red border styling.""" 220 widget.config(bootstyle="danger") 221 self.invalidEntries.add(widget)

<div class="docstring">Mark a widget as invalid with red border styling.

</div> <div id="Mimir.clearInvalid" class="classattr"> <input id="Mimir.clearInvalid-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def clearInvalid(self, widget): <label class="view-source-button" for="Mimir.clearInvalid-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.clearInvalid"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.clearInvalid-223">223</a> def clearInvalid(self, widget):

224 """Clear error styling from a widget.""" 225 widget.config(bootstyle="none") 226 self.invalidEntries.discard(widget)

<div class="docstring">Clear error styling from a widget.

</div> <div id="Mimir.addNextButton" class="classattr"> <input id="Mimir.addNextButton-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def addNextButton( self, parent, row, command, label='Nästa', tooltip=None, column=None, columnspan=None): <label class="view-source-button" for="Mimir.addNextButton-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.addNextButton"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.addNextButton-228">228</a> def addNextButton(self, parent, row, command, label="Nästa", tooltip=None, column=None, columnspan=None):

229 """ 230 Add a 'Next' button to the given row. Automatically spans the full width 231 of horizontal blocks if no column or columnspan is provided. 232 Blocks execution if any fields are invalid. 233 """
234 def wrapped(): 235 if self.invalidEntries: 236 msg.showerror("Fel", "Alla fält måste vara giltiga innan du kan fortsätta.") 237 return 238 command() 239 240 # Calculate default columnspan if not explicitly provided 241 if column is None or columnspan is None: 242 # Find all unique columns used in row=0 (block layout) 243 used_columns = set() 244 for child in parent.winfo_children(): 245 grid = child.grid_info() 246 if grid.get("row") == 0 and "column" in grid: 247 used_columns.add(int(grid["column"])) 248 249 if not used_columns: 250 column = 0 251 columnspan = 1 252 else: 253 column = 0 254 columnspan = max(used_columns) + 1 255 256 btn = tb.Button(parent, text=label, command=wrapped, bootstyle="success") 257 btn.grid(row=row, column=column, columnspan=columnspan, pady=(10, 5)) 258 259 if tooltip: 260 self.addTooltip(btn, tooltip) 261 262 return btn

<div class="docstring">Add a 'Next' button to the given row. Automatically spans the full width

of horizontal blocks if no column or columnspan is provided. Blocks execution if any fields are invalid.

</div> <div id="Mimir.getCurrentFont" class="classattr"> <input id="Mimir.getCurrentFont-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def getCurrentFont(self): <label class="view-source-button" for="Mimir.getCurrentFont-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.getCurrentFont"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.getCurrentFont-265">265</a> def getCurrentFont(self):

266 """Return the default font currently used by ttkbootstrap widgets.""" 267 style = tb.Style() 268 fontName = style.lookup("TLabel", "font") 269 return tkFont.Font(font=fontName)

<div class="docstring">Return the default font currently used by ttkbootstrap widgets.

</div> <div id="Mimir.addTooltip" class="classattr"> <input id="Mimir.addTooltip-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def addTooltip(self, widget, text): <label class="view-source-button" for="Mimir.addTooltip-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.addTooltip"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.addTooltip-271">271</a> def addTooltip(self, widget, text):

272 """Attach a styled tooltip to a widget.""" 273 ToolTip(widget, text, bootstyle=(SECONDARY, INVERSE))

<div class="docstring">Attach a styled tooltip to a widget.

</div> <div id="Mimir.removeBlock" class="classattr"> <input id="Mimir.removeBlock-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def removeBlock(self, blockList, wrapper): <label class="view-source-button" for="Mimir.removeBlock-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.removeBlock"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.removeBlock-275">275</a> def removeBlock(self, blockList, wrapper):

276 """ 277 Remove a UI block from view and list. Automatically reindexes 278 and repositions remaining blocks. 279 """
280 frame = wrapper.meta.get("frame") 281 layout = wrapper.meta.get("layout", "horizontal") 282 if frame: 283 frame.destroy() 284 blockList.remove(wrapper) 285 286 for i, block in enumerate(blockList): 287 frame = block.meta["frame"] 288 new_label = f"Butik {i + 1}" 289 290 # Update visual label 291 frame.config(text=new_label) 292 293 # Update meta so future logic knows the new label/index 294 block.meta["custom_label"] = new_label 295 block.meta["store_id"] = i + 1 # optional if store_id should follow display order 296 297 # Reposition depending on layout 298 if layout == "vertical": 299 frame.grid_configure(row=i, column=0) 300 else: 301 frame.grid_configure(row=0, column=i)

<div class="docstring">Remove a UI block from view and list. Automatically reindexes

and repositions remaining blocks.

</div> <div id="Mimir.addLabeledEntry" class="classattr"> <input id="Mimir.addLabeledEntry-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def addLabeledEntry( self, parent, row, label, variable, state='normal', tooltip=None, validation=None, column=0, vertical=False, columnspan=1): <label class="view-source-button" for="Mimir.addLabeledEntry-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.addLabeledEntry"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.addLabeledEntry-304">304</a> def addLabeledEntry(self, parent, row, label, variable, state="normal", tooltip=None, validation=None, column=0, vertical=False, columnspan=1):

305 """ 306 Add a labeled entry input field. Supports vertical and horizontal layouts, 307 optional tooltips and validation. 308 """
309 if vertical: 310 tb.Label(parent, text=label).grid(row=row, column=column, columnspan=columnspan, padx=5, pady=(5, 5)) 311 entry = tb.Entry(parent, textvariable=variable, state=state, width=self.widthEntry) 312 entry.grid(row=row + 1, column=column, padx=5, columnspan=columnspan, pady=(0, 10), sticky="ew") 313 else: 314 tb.Label(parent, text=label).grid(row=row, column=column, padx=5, pady=5, sticky="e") 315 entry = tb.Entry(parent, textvariable=variable, state=state, width=self.widthEntry) 316 entry.grid(row=row, column=column + 1, columnspan=columnspan, padx=5, pady=5, sticky="ew") 317 318 if tooltip: 319 self.addTooltip(entry, tooltip) 320 321 validationFunc = self.resolveValidator(validation) if validation else None 322 if callable(validationFunc): 323 def onFocusOut(event): 324 value = entry.get() 325 if validationFunc(value): 326 self.clearInvalid(entry) 327 else: 328 self.markInvalid(entry) 329 entry.bind("<FocusOut>", onFocusOut) 330 331 return entry

<div class="docstring">Add a labeled entry input field. Supports vertical and horizontal layouts,

optional tooltips and validation.

</div> <div id="Mimir.addLabeledCombobox" class="classattr"> <input id="Mimir.addLabeledCombobox-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def addLabeledCombobox( self, parent, row, label, variable, values, tooltip=None, state='readonly', column=0, vertical=False, columnspan=1): <label class="view-source-button" for="Mimir.addLabeledCombobox-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.addLabeledCombobox"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.addLabeledCombobox-333">333</a> def addLabeledCombobox(self, parent, row, label, variable, values, tooltip=None, state="readonly", column=0, vertical=False, columnspan=1):

334 """Add a labeled combobox dropdown field with options.""" 335 if vertical: 336 tb.Label(parent, text=label).grid(row=row, column=column, columnspan=columnspan, padx=5, pady=(5, 0)) 337 combo = tb.Combobox(parent, textvariable=variable, values=values, state=state, width=self.widthCombo) 338 combo.grid(row=row + 1, column=column, columnspan=columnspan, padx=5, pady=(0, 10)) 339 else: 340 tb.Label(parent, text=label).grid(row=row, column=column, padx=5, pady=5, sticky="e") 341 combo = tb.Combobox(parent, textvariable=variable, values=values, state=state, width=self.widthCombo) 342 combo.grid(row=row, column=column + 1, columnspan=columnspan, padx=5, pady=5, sticky="ew") 343 344 if tooltip: 345 self.addTooltip(combo, tooltip) 346 347 return combo

<div class="docstring">Add a labeled combobox dropdown field with options.

</div> <div id="Mimir.getNextAvailableRow" class="classattr"> <input id="Mimir.getNextAvailableRow-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def getNextAvailableRow(self, frame: tkinter.Widget) -> int: <label class="view-source-button" for="Mimir.getNextAvailableRow-view-source">View Source</label> </div> <a class="headerlink" href="#Mimir.getNextAvailableRow"></a> <div class="pdoc-code codehilite"><pre><a href="#Mimir.getNextAvailableRow-349">349</a> def getNextAvailableRow(self, frame: tk.Widget) -> int:

350 """ 351 Return the next available row in a container by checking occupied grid rows. 352 """
353 used_rows = [ 354 child.grid_info().get("row") 355 for child in frame.winfo_children() 356 if "row" in child.grid_info() 357 ] 358 return max(used_rows, default=-1) + 1

<div class="docstring">Return the next available row in a container by checking occupied grid rows.

</div> </section> <section id="DataBlockWrapper"> <input id="DataBlockWrapper-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

class DataBlockWrapper: <label class="view-source-button" for="DataBlockWrapper-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper-6"> 6</a>class DataBlockWrapper:

7 def init(self, meta): 8 self._meta = meta 9 10 @property 11 def meta(self): 12 return self._meta 13 14 def getattr(self, key): 15 fields = self._meta.get("fields_by_key", {}) 16 if key in fields: 17 return fields[key] 18 raise AttributeError(f"'{type(self).name}' object has no attribute '{key}'") 19 20 def get(self, key): 21 return self._meta.get("fields_by_key", {}).get(key) 22 23 def set(self, key, value): 24 try: 25 variable = self._meta["fields_by_key"][key] 26 if hasattr(variable, "set"): 27 variable.set(value) 28 else: 29 self._meta["fields_by_key"][key] = value 30 except KeyError: 31 raise KeyError(f"Key '{key}' not found in DataBlockWrapper.") 32 33 def items(self): 34 return self._meta.get("fields_by_key", {}).items() 35 36 def values(self): 37 return self._meta.get("fields_by_key", {}).values() 38 39 def keys(self): 40 return self._meta.get("fields_by_key", {}).keys() 41 42 def dir(self): 43 return super().dir() + list(self._meta.get("fields_by_key", {}).keys())

<div id="DataBlockWrapper.__init__" class="classattr"> <input id="DataBlockWrapper.__init__-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

DataBlockWrapper(meta) <label class="view-source-button" for="DataBlockWrapper.__init__-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.__init__"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.__init__-7">7</a> def __init__(self, meta):

8 self._meta = meta

</div> <div id="DataBlockWrapper.meta" class="classattr"> <input id="DataBlockWrapper.meta-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

meta
<label class="view-source-button" for="DataBlockWrapper.meta-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.meta"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.meta-10">10</a> @property

11 def meta(self): 12 return self._meta

</div> <div id="DataBlockWrapper.get" class="classattr"> <input id="DataBlockWrapper.get-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def get(self, key): <label class="view-source-button" for="DataBlockWrapper.get-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.get"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.get-20">20</a> def get(self, key):

21 return self._meta.get("fields_by_key", {}).get(key)

</div> <div id="DataBlockWrapper.set" class="classattr"> <input id="DataBlockWrapper.set-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def set(self, key, value): <label class="view-source-button" for="DataBlockWrapper.set-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.set"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.set-23">23</a> def set(self, key, value):

24 try: 25 variable = self._meta["fields_by_key"][key] 26 if hasattr(variable, "set"): 27 variable.set(value) 28 else: 29 self._meta["fields_by_key"][key] = value 30 except KeyError: 31 raise KeyError(f"Key '{key}' not found in DataBlockWrapper.")

</div> <div id="DataBlockWrapper.items" class="classattr"> <input id="DataBlockWrapper.items-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def items(self): <label class="view-source-button" for="DataBlockWrapper.items-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.items"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.items-33">33</a> def items(self):

34 return self._meta.get("fields_by_key", {}).items()

</div> <div id="DataBlockWrapper.values" class="classattr"> <input id="DataBlockWrapper.values-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def values(self): <label class="view-source-button" for="DataBlockWrapper.values-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.values"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.values-36">36</a> def values(self):

37 return self._meta.get("fields_by_key", {}).values()

</div> <div id="DataBlockWrapper.keys" class="classattr"> <input id="DataBlockWrapper.keys-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

def keys(self): <label class="view-source-button" for="DataBlockWrapper.keys-view-source">View Source</label> </div> <a class="headerlink" href="#DataBlockWrapper.keys"></a> <div class="pdoc-code codehilite"><pre><a href="#DataBlockWrapper.keys-39">39</a> def keys(self):

40 return self._meta.get("fields_by_key", {}).keys()

</div> </section> <section id="UtilityModule"> <input id="UtilityModule-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

class UtilityModule: <label class="view-source-button" for="UtilityModule-view-source">View Source</label> </div> <a class="headerlink" href="#UtilityModule"></a> <div class="pdoc-code codehilite"><pre><a href="#UtilityModule-6"> 6</a>class UtilityModule:

7 @staticmethod 8 def buildBlockMeta(fields, extra): 9 """ 10 Given a list of field definitions, return a structured metadata dictionary 11 ready to be passed to DataBlockWrapper. 12 13 Fields should be a list of dicts containing at least 'variable' and optionally 'key'. 14 Additional metadata (e.g. label, index) can be passed via kwargs. 15 """ 16 return { 17 extra, 18 "fields": fields, 19 "fields_by_key": {f["key"]: f["variable"] for f in fields if "key" in f}, 20 } 21 22 @staticmethod 23 def getBlockValues(wrapper, raw=False): 24 """ 25 Extract a dictionary of current values from a DataBlockWrapper. 26 27 If raw=True, return variable objects. Otherwise, return .get() results. 28 """ 29 output = {} 30 for key, var in wrapper.items(): 31 if hasattr(var, "get") and not raw: 32 output[key] = var.get() 33 else: 34 output[key] = var 35 return output 36 37 @staticmethod 38 def updateBlockFromDict(wrapper, data): 39 """ 40 Given a dict of values, update the DataBlockWrapper by setting matching keys. 41 """ 42 for key, value in data.items(): 43 try: 44 wrapper.set(key, value) 45 except KeyError: 46 continue 47 48 @staticmethod 49 def isBlockValid(wrapper, validatorResolver): 50 """ 51 Check if all fields in a block pass their validator. 52 The validatorResolver must take a string name and return a function. 53 """ 54 for f in wrapper.meta.get("fields", []): 55 name = f.get("validation") 56 var = f.get("variable") 57 if name and var and callable(validatorResolver(name)): 58 valid = validatorResolver(name)(var.get()) 59 if not valid: 60 return False 61 return True

<div id="UtilityModule.buildBlockMeta" class="classattr"> <input id="UtilityModule.buildBlockMeta-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

@staticmethod

def buildBlockMeta(fields, **extra): <label class="view-source-button" for="UtilityModule.buildBlockMeta-view-source">View Source</label> </div> <a class="headerlink" href="#UtilityModule.buildBlockMeta"></a> <div class="pdoc-code codehilite"><pre><a href="#UtilityModule.buildBlockMeta-7"> 7</a> @staticmethod

8 def buildBlockMeta(fields, extra): 9 """ 10 Given a list of field definitions, return a structured metadata dictionary 11 ready to be passed to DataBlockWrapper. 12 13 Fields should be a list of dicts containing at least 'variable' and optionally 'key'. 14 Additional metadata (e.g. label, index) can be passed via kwargs. 15 """ 16 return { 17 extra, 18 "fields": fields, 19 "fields_by_key": {f["key"]: f["variable"] for f in fields if "key" in f}, 20 }

<div class="docstring">Given a list of field definitions, return a structured metadata dictionary

ready to be passed to DataBlockWrapper.

Fields should be a list of dicts containing at least 'variable' and optionally 'key'. Additional metadata (e.g. label, index) can be passed via kwargs.

</div> <div id="UtilityModule.getBlockValues" class="classattr"> <input id="UtilityModule.getBlockValues-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

@staticmethod

def getBlockValues(wrapper, raw=False): <label class="view-source-button" for="UtilityModule.getBlockValues-view-source">View Source</label> </div> <a class="headerlink" href="#UtilityModule.getBlockValues"></a> <div class="pdoc-code codehilite"><pre><a href="#UtilityModule.getBlockValues-22">22</a> @staticmethod

23 def getBlockValues(wrapper, raw=False): 24 """ 25 Extract a dictionary of current values from a DataBlockWrapper. 26 27 If raw=True, return variable objects. Otherwise, return .get() results. 28 """ 29 output = {} 30 for key, var in wrapper.items(): 31 if hasattr(var, "get") and not raw: 32 output[key] = var.get() 33 else: 34 output[key] = var 35 return output

<div class="docstring">Extract a dictionary of current values from a DataBlockWrapper.

If raw=True, return variable objects. Otherwise, return .get() results.

</div> <div id="UtilityModule.updateBlockFromDict" class="classattr"> <input id="UtilityModule.updateBlockFromDict-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

@staticmethod

def updateBlockFromDict(wrapper, data): <label class="view-source-button" for="UtilityModule.updateBlockFromDict-view-source">View Source</label> </div> <a class="headerlink" href="#UtilityModule.updateBlockFromDict"></a> <div class="pdoc-code codehilite"><pre><a href="#UtilityModule.updateBlockFromDict-37">37</a> @staticmethod

38 def updateBlockFromDict(wrapper, data): 39 """ 40 Given a dict of values, update the DataBlockWrapper by setting matching keys. 41 """ 42 for key, value in data.items(): 43 try: 44 wrapper.set(key, value) 45 except KeyError: 46 continue

<div class="docstring">Given a dict of values, update the DataBlockWrapper by setting matching keys.

</div> <div id="UtilityModule.isBlockValid" class="classattr"> <input id="UtilityModule.isBlockValid-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1">

@staticmethod

def isBlockValid(wrapper, validatorResolver): <label class="view-source-button" for="UtilityModule.isBlockValid-view-source">View Source</label> </div> <a class="headerlink" href="#UtilityModule.isBlockValid"></a> <div class="pdoc-code codehilite"><pre><a href="#UtilityModule.isBlockValid-48">48</a> @staticmethod

49 def isBlockValid(wrapper, validatorResolver): 50 """ 51 Check if all fields in a block pass their validator. 52 The validatorResolver must take a string name and return a function. 53 """ 54 for f in wrapper.meta.get("fields", []): 55 name = f.get("validation") 56 var = f.get("variable") 57 if name and var and callable(validatorResolver(name)): 58 valid = validatorResolver(name)(var.get()) 59 if not valid: 60 return False 61 return True

<div class="docstring">Check if all fields in a block pass their validator.

The validatorResolver must take a string name and return a function.

</div> </section> </main>
<script> function escapeHTML(html) { return document.createElement('div').appendChild(document.createTextNode(html)).parentNode.innerHTML; } const originalContent = document.querySelector("main.pdoc"); let currentContent = originalContent; function setContent(innerHTML) { let elem; if (innerHTML) { elem = document.createElement("main"); elem.classList.add("pdoc"); elem.innerHTML = innerHTML; } else { elem = originalContent; } if (currentContent !== elem) { currentContent.replaceWith(elem); currentContent = elem; } } function getSearchTerm() { return (new URL(window.location)).searchParams.get("search"); } const searchBox = document.querySelector(".pdoc input[type=search]"); searchBox.addEventListener("input", function () { let url = new URL(window.location); if (searchBox.value.trim()) { url.hash = ""; url.searchParams.set("search", searchBox.value); } else { url.searchParams.delete("search"); } history.replaceState("", "", url.toString()); onInput(); }); window.addEventListener("popstate", onInput); let search, searchErr; async function initialize() { try { search = await new Promise((resolve, reject) => { const script = document.createElement("script"); script.type = "text/javascript"; script.async = true; script.onload = () => resolve(window.pdocSearch); script.onerror = (e) => reject(e); script.src = "search.js"; document.getElementsByTagName("head")[0].appendChild(script); }); } catch (e) { console.error("Cannot fetch pdoc search index"); searchErr = "Cannot fetch search index."; } onInput(); document.querySelector("nav.pdoc").addEventListener("click", e => { if (e.target.hash) { searchBox.value = ""; searchBox.dispatchEvent(new Event("input")); } }); } function onInput() { setContent((() => { const term = getSearchTerm(); if (!term) { return null } if (searchErr) { return `
Error: ${searchErr}
` } if (!search) { return "
Searching...
" } window.scrollTo({top: 0, left: 0, behavior: 'auto'}); const results = search(term); let html; if (results.length === 0) { html = `No search results for '${escapeHTML(term)}'.` } else { html = `
${results.length} search result${results.length > 1 ? "s" : ""} for '${escapeHTML(term)}'.
`; } for (let result of results.slice(0, 10)) { let doc = result.doc; let url = `${doc.modulename.replaceAll(".", "/")}.html`; if (doc.qualname) { url += `#${doc.qualname}`; } let heading; switch (result.doc.kind) { case "function": if (doc.fullname.endsWith(".__init__")) { heading = `${doc.fullname.replace(/\.__init__$/, "")}${doc.signature}`; } else { heading = `${doc.funcdef} ${doc.fullname}${doc.signature}`; } break; case "class": heading = `class ${doc.fullname}`; if (doc.bases) heading += `(${doc.bases})`; heading += `:`; break; case "variable": heading = `${doc.fullname}`; if (doc.annotation) heading += `${doc.annotation}`; if (doc.default_value) heading += ` = ${doc.default_value}`; break; default: heading = `${doc.fullname}`; break; } html += `
${heading}
${doc.doc}

`; } return html; })()); } if (getSearchTerm()) { initialize(); searchBox.value = getSearchTerm(); onInput(); } else { searchBox.addEventListener("focus", initialize, {once: true}); } searchBox.addEventListener("keydown", e => { if (["ArrowDown", "ArrowUp", "Enter"].includes(e.key)) { let focused = currentContent.querySelector(".search-result.focused"); if (!focused) { currentContent.querySelector(".search-result").classList.add("focused"); } else if ( e.key === "ArrowDown" && focused.nextElementSibling && focused.nextElementSibling.classList.contains("search-result") ) { focused.classList.remove("focused"); focused.nextElementSibling.classList.add("focused"); focused.nextElementSibling.scrollIntoView({ behavior: "smooth", block: "nearest", inline: "nearest" }); } else if ( e.key === "ArrowUp" && focused.previousElementSibling && focused.previousElementSibling.classList.contains("search-result") ) { focused.classList.remove("focused"); focused.previousElementSibling.classList.add("focused"); focused.previousElementSibling.scrollIntoView({ behavior: "smooth", block: "nearest", inline: "nearest" }); } else if ( e.key === "Enter" ) { focused.querySelector("a").click(); } } }); </script>

Project details

Verified details
These details have been verified by PyPI
Maintainers
Willeboii717

Unverified details
These details have not been verified by PyPI

Meta

License Expression: MIT
SPDX License Expression

Author: William Lydahl

Requires: Python >=3.11

Classifiers

Operating System

OS Independent

Programming Language

Python :: 3.11

Release history Release notifications | RSS feed

0.8.26

Dec 15, 2025

0.8.23

Nov 7, 2025

0.8.19

Aug 4, 2025

0.8.17

Jul 18, 2025

0.8.16

Jul 17, 2025

0.8.15

Jul 3, 2025

0.8.14

Jun 3, 2025

0.8.13

Jun 3, 2025

0.8.12

Jun 3, 2025

0.8.11

Jun 2, 2025

0.8.10

Jun 2, 2025

0.8.9

May 27, 2025

0.8.8

May 27, 2025

0.8.7

May 26, 2025

0.8.6

May 23, 2025

0.8.5

May 23, 2025

0.8.4

May 23, 2025

0.8.3

May 19, 2025

0.8.2

May 19, 2025

0.8.1

May 19, 2025

0.8.0

May 15, 2025

0.7.6

May 15, 2025

0.7.5

May 14, 2025

0.7.4

May 14, 2025

0.7.3

May 12, 2025

0.7.2

May 7, 2025

0.7.1

May 7, 2025

0.7.0

May 5, 2025

0.6.9

May 2, 2025

0.6.8

May 2, 2025

0.6.7

May 2, 2025

0.6.6

May 2, 2025

0.6.5

May 2, 2025

0.6.0

Apr 30, 2025

0.5.25

Apr 30, 2025

0.5.24

Apr 30, 2025

0.5.23

Apr 30, 2025

0.5.22

Apr 30, 2025

0.5.21

Apr 30, 2025

0.5.20

Apr 30, 2025

0.5.19

Apr 29, 2025

0.5.18

Apr 28, 2025

0.5.17

Apr 28, 2025

0.5.16

Apr 28, 2025

0.5.15

Apr 22, 2025

0.5.14

Apr 22, 2025

0.5.13

Apr 22, 2025

0.5.12

Apr 22, 2025

0.5.11

Apr 22, 2025

0.5.10

Apr 22, 2025

0.5.9

Apr 17, 2025

0.5.8

Apr 17, 2025

0.5.7

Apr 17, 2025

0.5.6

Apr 17, 2025

0.5.5

Apr 17, 2025

0.5.4

Apr 30, 2025

0.5.3

Apr 30, 2025

0.5.1

Apr 17, 2025

0.5.0

Apr 16, 2025

0.4.10

Apr 16, 2025

0.4.9

Apr 16, 2025

0.4.8

Apr 16, 2025

0.4.7

Apr 16, 2025

0.4.6

Apr 16, 2025

0.4.5

Apr 16, 2025

0.4.4

Apr 16, 2025

0.4.3

Apr 16, 2025

0.4.2

Apr 16, 2025

0.4.1

Apr 16, 2025

0.3.22

Apr 16, 2025

0.3.20

Apr 16, 2025

0.3.14

Apr 16, 2025

This version

0.3.13

Apr 16, 2025

0.3.2

Apr 15, 2025

0.2.17

Apr 15, 2025

0.2.16

Apr 15, 2025

0.2.15

Apr 15, 2025

0.2.14

Apr 15, 2025

0.2.13

Apr 15, 2025

0.2.12

Apr 15, 2025

0.2.11

Apr 15, 2025

0.2.10

Apr 15, 2025

0.2.9

Apr 15, 2025

0.2.8

Apr 15, 2025

0.2.7

Apr 15, 2025

0.2.6

Apr 15, 2025

0.2.5

Apr 15, 2025

0.2.4

Apr 15, 2025

0.2.3

Apr 15, 2025

0.2.2

Apr 15, 2025

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jabs_mimir-0.3.13.tar.gz (109.3 kB view details)
Uploaded Apr 16, 2025 Source

Built Distribution

Filter files by name, interpreter, ABI, and platform.

If you're not sure about the file name format, learn more about wheel file names.

Copy a direct link to the current filters

File name

Interpreter

ABI

Platform

jabs_mimir-0.3.13-py3-none-any.whl (43.6 kB view details)
Uploaded Apr 16, 2025 Python 3

File details

Details for the file jabs_mimir-0.3.13.tar.gz.

File metadata

Download URL: jabs_mimir-0.3.13.tar.gz

Upload date: Apr 16, 2025

Size: 109.3 kB

Tags: Source

Uploaded using Trusted Publishing? No

Uploaded via: twine/6.1.0 CPython/3.11.9

File hashes

Hashes for jabs_mimir-0.3.13.tar.gz

Algorithm Hash digest

SHA256 9e72b7a64533cd794b665a2eb3a35614896a47b3eff340bb9bc0441773b0b5dc

MD5 a0b514fcecdbfb5b0c13b1bafb234d38

BLAKE2b-256 6d2a210fb97b56c8c6c0d83aa867e74b683b708773788df8429d53ce32ecb7ae

See more details on using hashes here.

File details

Details for the file jabs_mimir-0.3.13-py3-none-any.whl.

File metadata

Download URL: jabs_mimir-0.3.13-py3-none-any.whl

Upload date: Apr 16, 2025

Size: 43.6 kB

Tags: Python 3

Uploaded using Trusted Publishing? No

Uploaded via: twine/6.1.0 CPython/3.11.9

File hashes

Hashes for jabs_mimir-0.3.13-py3-none-any.whl

Algorithm Hash digest

SHA256 04fbffab9f34d6894f107004e5401e9c964653af1fdeffe859dcebfeeccbbc9f

MD5 1377f6fb89ea8e7b11396e19c061624d

BLAKE2b-256 e8ed5ad564c08fd6c96398a5d7d9e1a062bed855472e3e957b57d4a4e8089874

See more details on using hashes here.

jabs-mimir 0.3.13

Navigation

Verified details

Maintainers

Unverified details

Meta

Classifiers

Project description

Jabs Mimir

Installation

Quick Start

Components

`Mimir`

`DataBlockWrapper`

`UtilityModule`

License

jabs_mimir

Error: ${searchErr}

Searching...

${results.length} search result${results.length > 1 ? "s" : ""} for '${escapeHTML(term)}'.

Project details

Verified details

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`9e72b7a64533cd794b665a2eb3a35614896a47b3eff340bb9bc0441773b0b5dc`
MD5	`a0b514fcecdbfb5b0c13b1bafb234d38`
BLAKE2b-256	`6d2a210fb97b56c8c6c0d83aa867e74b683b708773788df8429d53ce32ecb7ae`

Algorithm	Hash digest
SHA256	`04fbffab9f34d6894f107004e5401e9c964653af1fdeffe859dcebfeeccbbc9f`
MD5	`1377f6fb89ea8e7b11396e19c061624d`
BLAKE2b-256	`e8ed5ad564c08fd6c96398a5d7d9e1a062bed855472e3e957b57d4a4e8089874`