dimi-ui 0.1.0__tar.gz

dimi_ui-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: dimi-ui
+Version: 0.1.0
+Summary: Immediate-mode Python & pygame-ce user interface library using a deferred two-pass layout system
+Author-email: Damiano Ricciardi <ricciardi.damiano06@gmail.com>
+Maintainer-email: Damiano Ricciardi <ricciardi.damiano06@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/damusss/dimi-ui
+Project-URL: Documentation, https://github.com/damusss/dimi-ui
+Project-URL: Repository, https://github.com/damusss/dimi-ui.git
+Project-URL: Issues, https://github.com/damusss/dimi-ui/issues
+Keywords: ui,user-interface,immediate-mode
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Software Development :: Libraries :: pygame
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: pygame-ce>=2.5.8
+
+# dimi(-ui)
+
+> [!WARNING]
+> dimi-ui is still early in development. It supports a limited amount of features and documentation isn't currently
+> available.
+
+dimi is an immediate-mode user interface library designed for Python and pygame-ce using a deferred two-pass layout
+system.
+More specifically, the layout engine uses four passes to complete a UI cycle:
+
+- declaration pass
+- measure/arrange two-pass layout (size & position resolution)
+- render/interaction resolution pass
+
+Element interaction is provided immediately during the declaration pass, allowing immediate application logic, but it
+is actually deferred from the previous frame, which is negligeable at sensible framerates.
+
+The library supports both software rendering and the experimental `pygame(-ce)._render` API out of the box. It can be
+used to build UI-only applications or be integrated in existing applications and games.
+
+The only supported environment is the latest version of the [pygame-ce (Pygame Community Edition)](https://pyga.me)
+library. Neither upstream pygame nor the outdated `pygame._sdl2.video` API are supported.
+
+dimi is intended to be a polished and more immediate-oriented successor of [mili](https://github.com/damusss/mili-ui) (
+limited only by a couple of layout rules required to keep the two-pass system efficient).
+
+> [!NOTE]
+> `dimi`, which is the package import name, stands for "deferred immediate mode (user) interface".
+
+## Installation & Import
+
+Install the latest version thorugh PyPI or clone & install from source:
+
+```bash
+pip install dimi-ui
+```
+
+The import name differs from the PyPI package:
+
+```python
+import dimi
+```
+
+Every feature can be accessed through the following modules:
+
+- `dimi`
+- `dimi.widget`
+- `dimi.app`
+- `dimi.icon`
+- `dimi.typehinting`

dimi_ui-0.1.0/README.md

@@ -0,0 +1,50 @@
+# dimi(-ui)
+
+> [!WARNING]
+> dimi-ui is still early in development. It supports a limited amount of features and documentation isn't currently
+> available.
+
+dimi is an immediate-mode user interface library designed for Python and pygame-ce using a deferred two-pass layout
+system.
+More specifically, the layout engine uses four passes to complete a UI cycle:
+
+- declaration pass
+- measure/arrange two-pass layout (size & position resolution)
+- render/interaction resolution pass
+
+Element interaction is provided immediately during the declaration pass, allowing immediate application logic, but it
+is actually deferred from the previous frame, which is negligeable at sensible framerates.
+
+The library supports both software rendering and the experimental `pygame(-ce)._render` API out of the box. It can be
+used to build UI-only applications or be integrated in existing applications and games.
+
+The only supported environment is the latest version of the [pygame-ce (Pygame Community Edition)](https://pyga.me)
+library. Neither upstream pygame nor the outdated `pygame._sdl2.video` API are supported.
+
+dimi is intended to be a polished and more immediate-oriented successor of [mili](https://github.com/damusss/mili-ui) (
+limited only by a couple of layout rules required to keep the two-pass system efficient).
+
+> [!NOTE]
+> `dimi`, which is the package import name, stands for "deferred immediate mode (user) interface".
+
+## Installation & Import
+
+Install the latest version thorugh PyPI or clone & install from source:
+
+```bash
+pip install dimi-ui
+```
+
+The import name differs from the PyPI package:
+
+```python
+import dimi
+```
+
+Every feature can be accessed through the following modules:
+
+- `dimi`
+- `dimi.widget`
+- `dimi.app`
+- `dimi.icon`
+- `dimi.typehinting`

dimi_ui-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dimi-ui"
+version = "0.1.0"
+description = "Immediate-mode Python & pygame-ce user interface library using a deferred two-pass layout system"
+readme = "README.md"
+requires-python = ">=3.14"
+license = { text = "MIT" }
+authors = [
+    { name = "Damiano Ricciardi", email = "ricciardi.damiano06@gmail.com" }
+]
+maintainers = [
+    { name = "Damiano Ricciardi", email = "ricciardi.damiano06@gmail.com" }
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Software Development :: Libraries :: pygame",
+]
+keywords = ["ui", "user-interface", "immediate-mode"]
+dependencies = [
+    "pygame-ce>=2.5.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/damusss/dimi-ui"
+Documentation = "https://github.com/damusss/dimi-ui" #
+Repository = "https://github.com/damusss/dimi-ui.git"
+Issues = "https://github.com/damusss/dimi-ui/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["dimi*"]
+namespaces = false
+
+[tool.ruff]
+line-length = 88
+target-version = "py314"

dimi_ui-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dimi_ui-0.1.0/src/dimi/__init__.py

@@ -0,0 +1,115 @@
+__all__ = [
+    "Absolute",
+    "Align",
+    "Anchor",
+    "Axis",
+    "Button",
+    "ButtonStatus",
+    "ChooseAxis",
+    "Constraint",
+    "Context",
+    "ContextOrigin",
+    "Corners",
+    "Directions",
+    "EllipseStyle",
+    "Exact",
+    "Fill",
+    "Font",
+    "FontAlign",
+    "FontDirection",
+    "HoverStatus",
+    "Hug",
+    "IllegalOperation",
+    "ImageFit",
+    "ImageRepeat",
+    "NinePatch",
+    "Percent",
+    "Ratio",
+    "RectStyle",
+    "RenderOrder",
+    "RendererCanvas",
+    "ScaleQuality",
+    "Span",
+    "Style",
+    "SurfaceCanvas",
+    "TextStyle",
+    "Transform",
+    "Wrap",
+    "app",
+    "begin",
+    "element",
+    "ellipse",
+    "end",
+    "get_current_context",
+    "get_interaction",
+    "icon",
+    "image",
+    "push_id",
+    "push_style",
+    "rect",
+    "replace_nested_style",
+    "text",
+    "typehinting",
+    "using",
+    "when",
+    "widget",
+]
+
+from . import app, icon, typehinting, widget  # todo: animation module
+from ._canvas import RendererCanvas, SurfaceCanvas
+from ._context import Context, ContextOrigin
+from ._dimi import (
+    begin,
+    element,
+    ellipse,
+    end,
+    get_current_context,
+    get_interaction,
+    image,
+    push_id,
+    push_style,
+    rect,
+    replace_nested_style,
+    text,
+    using,
+    when,
+)
+from ._error import IllegalOperation
+from ._interaction import (
+    Button,
+    ButtonStatus,
+    HoverStatus,
+)
+from ._primitives import (
+    Absolute,
+    Align,
+    Anchor,
+    Axis,
+    ChooseAxis,
+    Constraint,
+    Corners,
+    Directions,
+    Exact,
+    Fill,
+    Font,
+    FontAlign,
+    FontDirection,
+    Hug,
+    ImageFit,
+    ImageRepeat,
+    NinePatch,
+    Percent,
+    Ratio,
+    RenderOrder,
+    ScaleQuality,
+    Span,
+    Transform,
+    Wrap,
+)
+from ._style import (
+    EllipseStyle,
+    RectStyle,
+    Style,
+    TextStyle,
+)
+from ._version import __version__ as __version__  # todo add "lazy" with Python 3.15