pydevices-examples

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #go #android #macos #cli #kubernetes #awesome-list #security #pytorch #ios

pydevices-examples

(★ 52)

Examples, integration guides, and an installable PyScript gallery for the PyDevices driver stack.

pydevices-examples 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">PyDevices Examples</h1>

<h3 align="center">See the portable PyDevices driver stack in action.</h3>

<p align="center">
  <a href="https://pydisplay.readthedocs.io">Documentation</a> •
  <a href="https://PyDevices.github.io/pydevices-examples/pyscript/">PyScript gallery</a> •
  <a href="https://pydevices.github.io/pydevices/">Product packages</a> •
  <a href="docs/screenshots/README.md">Screenshots</a>
</p>

| ![paint.py](https://raw.githubusercontent.com/PyDevices/pydevices-examples/main/docs/screenshots/paint.png) | ![tiny_toasters.py](https://raw.githubusercontent.com/PyDevices/pydevices-examples/main/docs/screenshots/tiny_toasters.gif) |
|:--:|:--:|
| `paint.py` | `tiny_toasters.py` |

This repository is the examples, integration documentation, and browser gallery
for the PyDevices driver ecosystem. The reusable product source lives in
**[pydevices](https://github.com/PyDevices/pydevices)**:

- `displaydev` and `audiodev` provide portable display and audio interfaces.
- `events`, `keys`, and `multimer` provide shared event, key, and timing primitives.
- `eventsys` is an optional application traffic controller for non-LVGL apps.
- `board_configs`, `board_peripherals`, and hardware drivers connect those interfaces
  to real boards and desktop/browser hosts.

Those libraries are designed to work across MicroPython, CircuitPython, and
CPython on microcontrollers, Linux, Windows, Android, browsers, and notebooks.
This repo demonstrates that portability; it is not the package source of truth.

> **Alpha quality.** The organization is being prepared for its first external
> users, so names and APIs may still evolve.

## Try it

The fastest route is the installable
**[PyScript gallery](https://PyDevices.github.io/pydevices-examples/pyscript/)**. It runs
the real examples in a browser and can be installed as a Progressive Web App.
Start a standalone browser app from the
**[pydevices-pyscript-template](https://github.com/PyDevices/pydevices-pyscript-template)**,
or use the [PWA guide](https://pydisplay.readthedocs.io/en/latest/guides/pyscript-pwa/)
to understand and customize the full gallery shell.

For a desktop clone:

```bash
git clone https://github.com/PyDevices/pydevices-examples.git
cd pydevices-examples
python3 -m venv .venv
.venv/bin/pip install --index-url https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple/ -r requirements.txt
cd lib
../.venv/bin/python examples/pydevices_demo.py
```

On Windows, use the equivalent `.venv\Scripts\python.exe` commands.

For MicroPython, install unprefixed MIP package names from the PyDevices
PyDevices MIP index, then install a board package:

```python
import mip

INDEX = "https://PyDevices.github.io/mip"
mip.install("displaydev", index=INDEX)
mip.install("eventsys", index=INDEX)  # optional; used by these non-LVGL examples
```

See the
[pydevices install workflows](https://pydevices.github.io/pydevices/install-workflows.html)
and [board configs](https://pydevices.github.io/pydevices/board-configs.html)
for complete device setup.

## Runtime ownership

Board configs describe hardware. They export neutral pieces such as
`display_drv`, `touch_read`, `host_read`, and `timer_async`; they do not create
an application runtime.

Non-LVGL examples in this repo opt into the optional `eventsys` coordinator:

```python
from board_config import display_drv
from app_runtime import runtime

runtime.run_forever()
```

LVGL examples use the coordinator bundled with the LVGL binding and do not
import `eventsys`:

```python
from board_config import display_drv
from display_driver import runtime

runtime.run_forever()
```

This separation keeps hardware policy out of board configs and lets applications
provide a different event loop or traffic controller when appropriate.

## Package names

Python distributions on TestPyPI use the organization prefix; imports and MIP
packages remain conventional and unprefixed.

| TestPyPI distribution | Python import / MIP name |
|---|---|
| `pydevices-displaydev` | `displaydev` |
| `pydevices-audiodev` | `audiodev` |
| `pydevices-events` | `events` |
| `pydevices-keys` | `keys` |
| `pydevices-multimer` | `multimer` |
| `pydevices-eventsys` | `eventsys` |
| `pydevices-pygraphics` | `pygraphics` |
| `pydevices-palettes` | `palettes` |
| `pydevices-pdwidgets` | `pdwidgets` |
| `pydevices-lvgl` | `lvgl` |

## Repository layout

| Path | Purpose |
|---|---|
| `lib/examples/` | Portable examples and complete demo applications |
| `lib/utils/` | Example helpers and third-party GUI adapters |
| `.site/pyscript/` | PyScript gallery and reusable PWA shell |
| `docs/` | Integration, platform, example, and PWA documentation |
| `tools/` | Cross-runtime example and LVGL test harnesses |
| `packages/` | GitHub MIP manifests for examples and helpers |

## Related repositories

- [pydevices](https://github.com/PyDevices/pydevices) — canonical product source and core driver package home
- [mip](https://github.com/PyDevices/mip) — PyDevices MIP index fork
- [lvgl-bindings](https://github.com/PyDevices/lvgl-bindings) — shared LVGL binding and `display_driver` source
- [lvgl-micropython](https://github.com/PyDevices/lvgl-micropython),
  [lvgl-circuitpython](https://github.com/PyDevices/lvgl-circuitpython), and
  [lvgl-python](https://github.com/PyDevices/lvgl-python) — runtime-specific LVGL distributions
- [pygraphics](https://github.com/PyDevices/pygraphics),
  [palettes](https://github.com/PyDevices/palettes), and
  [pdwidgets](https://github.com/PyDevices/pdwidgets) — companion packages
- [pydevices-android-template](https://github.com/PyDevices/pydevices-android-template) — Android application packaging
- [pydevices-pyscript-template](https://github.com/PyDevices/pydevices-pyscript-template) — standalone installable PyScript PWA starter

## Development

```bash
.venv/bin/python -m unittest discover -s tests
.venv/bin/python -m pytest -s tests -q
.venv/bin/ruff check lib tests tools scripts
```

See [AGENTS.md](AGENTS.md) and [tools/README.md](tools/README.md) for the
cross-runtime example matrix. Contributions to reusable libraries and hardware
support belong in pydevices; examples, integrations, and gallery work
belong here.

## License

MIT. See [LICENSE](LICENSE).

pydevices-examples

pydevices-examples 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

pydevices-examples

pydevices-examples 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README