Skip to content

PicoUI v0.1.2

Choose a tag to compare

View all tags
@markxbrooks markxbrooks released this 12 Mar 18:01
· 98 commits to main since this release
v0.1.2
6f49a1c

PicoUI Logo

PicoUI

A lightweight, focused UI library for Python

License: MIT
Python

Overview

PicoUI provides core UI functionality for PySide6/Qt applications with a clean, type-safe API. Built for developers who need reliable UI components—layout helpers, group boxes, preference dialogs, widget specs, and more—without the bloat. It favors convention over configuration and keeps the surface area small.

Features

  • Layout helpers — Create vertical/horizontal layouts, form layouts, and rows with optional stretches and spacing
  • Group builders — Build QGroupBox from labels and content (layouts, widget lists, or definitions)
  • Spec-driven UI — Dataclass specs for buttons, checkboxes, combos, spinboxes, tabs, and windows to describe UI declaratively
  • Preferences dialogs — Base class for tabbed preference dialogs with spec-driven fields, reset support, and tooltips
  • Widget utilities — Button/checkbox creation from specs, spinbox-with-label helpers, and value setters
  • Icon registry — Centralized icon definitions and retrieval with fallback support (qtawesome)
  • Tooltip manager — Shared tooltip handling
  • Dimensions — Standard sizes for icons, dialogs, and progress bars

Requirements

  • Python 3.8+
  • PySide6
  • qtawesome (for icon registry)

Installation

pip install picoui

Or from source (editable):

git clone https://github.com/markxbrooks/PicoUI.git
cd PicoUI
pip install -e .

Quick Start

from PySide6.QtWidgets import QApplication, QLabel
from picoui.helpers import build_group, group_with_layout

app = QApplication([])

# Simple group with widgets
group = build_group("Options", [QLabel("Item 1"), QLabel("Item 2")])

# Group with layout for incremental building
group, layout = group_with_layout(label="Section", vertical=True)
layout.addWidget(QLabel("Dynamic content"))

# Layout helpers
from picoui.helpers import create_vertical_layout, create_form_layout
vbox = create_vertical_layout(spacing=8)
form = create_form_layout()

Project Structure

picoui/
├── helpers/        # Layout and group box utilities
├── specs/          # Dataclass specs for widgets (ButtonSpec, CheckBoxSpec, etc.)
├── dialogs/        # Preferences dialog base and helpers
├── widget/         # Widget creation helpers and setters
├── tooltip/        # Tooltip management
├── dimensions.py   # Standard UI dimensions
├── icons.py        # Icon registry
└── settings.py     # Settings integration

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ for the UI community

Assets 2
Loading