Metadata-Version: 2.4
Name: Ara_imgui
Version: 2.0.0
Summary: A simplified wrapper for Dear ImGui and GLFW
Author-email: HanamileH <hanamileh@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/hanamileh/Ara_imgui
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: imgui_bundle>=1.92.0

# Ara_imgui

**Ara_imgui** is a lightweight and easy-to-use wrapper around [Dear ImGui](https://github.com/ocornut/imgui) using Python and GLFW. It simplifies GUI application development with ImGui by providing a convenient interface for managing windows, fonts, and application lifecycle.

## Features

- Simple ImGui app launch with a single `run` function
- Support various themes
- System or custom font loading, including Cyrillic support
- Ready-to-run examples included in the `examples` folder

## Installation

```bash
pip install ara_imgui
```

> ⚠️ Make sure you have Python 3.7+ and OpenGL support (e.g., via GPU drivers on Windows).

## Usage

### Basic example

```python
from ara_imgui import App, imgui

app = App("Hello world example")

def gui():
    imgui.text("Hello, world!")
    if imgui.button("Click me"):
        print("Clicked!")

app.run(gui)
```

### Custom fonts and themes

```python
from ara_imgui import App, imgui

font_path = R"C:\Windows\Fonts\Arial.ttf"

app = App("Font Example")
app.apply_theme("cherry")
app.load_font(font_path, font_size=20)

def gui():
    imgui.text("Sample text with custom font")

app.run(gui)
```

## Examples

See the [`examples/`](./examples) folder:

* `hello_world.py` — Basic "Hello, world!" with a button.
* `basic_window.py` — Simple window with input field.
* `custom_font.py` — Font and multilingual text rendering.
* `multiple_window.py` — GUI with multiple ImGui windows.

## Dependencies

* `imgui`
* `glfw`
* `imgui_bundle`

## License

MIT License. Free to use and modify.
