Metadata-Version: 2.1
Name: ubo-gui
Version: 0.12.2
Summary: GUI sdk for Ubo Pod
License: Apache-2.0
Author: Sassan Haradji
Author-email: sassanh@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: headless-kivy (>=0.9.0,<0.10.0)
Requires-Dist: python-immutable (>=1.0.2,<2.0.0)
Requires-Dist: qrcode (>=7.4.2,<8.0.0)
Description-Content-Type: text/markdown

# Ubo GUI

GUI sdk for [Ubo Pod](https://github.com/ubopod)

## 📋 Requirements

- [Ubo Pod](https://github.com/ubopod)
- [headless-kivy-pi](https://github.com/ubopod/headless-kivy-pi)

## 📦 Installation

You can install it using this handle: headless-kivy-pi@git+<https://github.com/ubopod/ubo-gui.git>

```sh
# pip:
pip install headless-kivy-pi@git+https://github.com/ubopod/ubo-gui.git
# poetry:
poetry add headless-kivy-pi@git+https://github.com/ubopod/ubo-gui.git
```

## 🛠 Usage

Checkout [Ubo App](https://github.com/ubopod/ubo-app) to see a sample implementation.

## 🤝 Contributing

You need to have [Poetry](https://python-poetry.org/) installed on your machine.

To install poetry in Raspbian you need to follow these instructions to install rust compiler, this is temporary until [this issue](https://github.com/python-poetry/poetry/issues/7645) is resolved:

```sh
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
sudo apt-get install pkg-config libssl-dev
curl -sSL https://install.python-poetry.org | python3 -
```

After having poetry, to install the required dependencies, run the following command:

```sh
poetry install --with dev
```

Also be aware of [this issue](https://github.com/python-poetry/poetry/issues/1917) and until it is resolved you can manually disable keyring by prefixing your poetry commands like this:

```sh
PYTHON_KEYRING_BACKEND=keyring.backends.null.Keyring poetry install
```

You can run linter over whole codebase by running this command:

```sh
poetry run poe lint
```

### ⚠️ Important Note

Make sure to run `poetry run poe download_font` to download Material Symbols font.

## 🔒 License

This project is released under the Apache-2.0 License. See the [LICENSE](./LICENSE)
file for more details.

