Metadata-Version: 2.4
Name: dpgcontainers
Version: 0.1.8
Summary: Functional dataclass implementations for DearPyGUI container types
Author-email: Zachary Parmley <zachary.parmley@gmail.com>
License-File: LICENSE.md
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.13
Requires-Dist: dearpygui>=2.0.0
Requires-Dist: dpgmagictag>=0.1.0
Description-Content-Type: text/markdown

# DPGContainers

## Motivation

[DearPyGUI](https://github.com/hoffstadt/DearPyGui) provides a functional
interface for creating objects - windows, groups, et al.  This library provides
a collection of classes that can be used to create DPG objects as instances.

## Installation

```bash
pip install dpgcontainers
```

## Example usage

```python
from dpgcontainers.containers import Window, Group, Button

window = Window(width=100, height=200)(
    Group(horizontal=True)(
        Button(tag='button_1'),
        Button(tag='button_2'),
    ),
)


window.tagged_entities['button_1'].callback = lambda: print('clicked!')
window.render()
```

Children are captured by calling instances as functions.  The render cycle is
aware of objects that have already been rendered, so the following is fine:

```python
window = Window()

window(Button('button_1'))
window.render()

window(Button('button_2'))
window.render()
```

- added `find` method to base class, returns first found named child
- `search_named_children` deprecated, use newly added `find` instead.
- added `find_all`, returns a list of all named children matching name
- added `search` and `search_all` methods, which function on named children but
    allow regex pattern searching
- Themes, Colormaps, and Fonts can now be bound via `instance.bind()` or
    `instance.bind(item)` as appropriate
