py2tosc 0.1.0__tar.gz

py2tosc-0.1.0/CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog
+
+Notable changes to py2tosc. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses [semantic versioning](https://semver.org/spec/v2.0.0.html) -- while the version is below 1.0, a minor bump may break the API.
+
+## [0.1.0]
+
+First release: py2tosc is a rewrite of [tosclib](https://github.com/AlbertoV5/tosclib) 0.3.5 by Alberto Valdez; the entries below describe what changed relative to it. Scripts written against tosclib will not run against py2tosc, and there are no compatibility shims. See [Coming from tosclib](https://shakfu.github.io/py2tosc/migrating/) for a name by name mapping.
+
+### Addeds
+
+- `Document`, with `load`, `loads`, `save` and `dumps` named after the `json` module's. `load` accepts a `.tosc` or an `.xml` without being told which, and `save` picks the format from the file extension.
+
+- `Control` as the node model. Traversal returns controls, not `ET.Element`, so children no longer have to be re-wrapped by hand.
+
+- `find`, `find_all` and `walk`, searching by name, by control type or both.
+
+- `Control.copy`, duplicating a subtree with fresh node ids.
+
+- `save(validate=True)` and `dumps(validate=True)`, which refuse to write a layout that has errors and raise `ValidationError` instead. Off by default.
+
+- `validate`, an opt-in check for things TouchOSC rejects or ignores -- children on a control that cannot hold them, duplicate node ids, a property stored under the wrong type, or a format property on a control type that has no use for it. Advisory and never raises; custom properties are left alone. Every rule is corroborated against layouts the editor wrote.
+
+- `GamepadMessage`. tosclib 0.3.x had a `ControlElements.GAMEPAD` enum member with no implementation behind it, so a layout containing a gamepad binding could not be read at all.
+
+- `Frame` and `Color` named tuples. Colours accept normalised floats, 0-255 integers or hex strings.
+
+- `__version__`, and an `__all__` that governs the public namespace.
+
+- Support for reading and writing lexml version 6, the format TouchOSC 1.5 writes: the `<includes>` element and the `<noDuplicates>` message flag. Both are omitted from documents that declare an older version.
+
+- Frames keep sub-pixel positions. TouchOSC stores frames like `x=417.439`, which earlier releases -- and the first draft of this one -- rounded to integers, moving the control.
+
+- A test corpus of 42 layout files, including the twenty examples bundled with TouchOSC 1.5.2, spanning both format versions, and demo scripts that the test suite executes -- including a numpad built from nested layouts, a Lua script and LOCAL message wiring.
+
+### Changed
+
+- **The API is `snake_case`.** `setColor` is `control.color = ...`, `findChildByName` is `find`. Property keys stay camelCase in the file, because that is what the format stores; `control.corner_radius` addresses the `cornerRadius` key.
+
+- **Property and value data are native Python types**, not strings. `Value.locked` is a `bool`; `Property("textSize", 14).value` is `14`.
+
+- **Reading no longer mutates the tree.** tosclib inserted empty `<messages>` and `<children>` elements into any control it wrapped.
+
+- **Missing properties raise `AttributeError`** rather than returning `None`. Use `control.get(key)` where absence is expected.
+
+- **Layouts are functions, not decorators.** `layout.row`, `layout.column` and `layout.grid` take the parent as an argument and return the controls they made, so nesting is ordinary function composition.
+
+- Serialization is written directly rather than through `ElementTree`, so CDATA sections, element order and the XML declaration are preserved. Loading a layout and saving it reproduces the TouchOSC editor's own bytes exactly, in both the compressed and exported forms.
+
+- Documentation moved from Sphinx to MkDocs.
+
+- Packaging moved to `pyproject.toml` with the `uv_build` backend; `setup.py`, `tox.ini` and the three `requirements*.txt` files are gone.
+
+- Releasing and publishing the documentation are driven from the Makefile rather than from CI. `make release-check` gates the declared version, the changelog entry and the state of the working tree; `make dist-check` rebuilds `dist/` from empty and validates it with `twine check --strict`; `make publish` uploads, behind a `CONFIRM=1` guard because a filename PyPI has accepted can never be reused. `make docs-deploy` pushes the documentation to `gh-pages`. Nothing is published automatically.
+
+- CI runs the suite on Ubuntu against Python 3.10 through 3.14, and checks types, lint, a strict documentation build, and the built wheel, on every push and pull request.
+
+### Removed
+
+- **numpy is no longer a dependency.** py2tosc has no runtime dependencies at all. The layout arithmetic is plain Python.
+
+- `ElementTOSC` and the `elements`, `controls` and `tosc` modules.
+
+- `asCtrl`, which was declared, exported, and had `pass` for a body.
+
+### Fixed
+
+- `import tosclib` failed without `pyparsing`, an undeclared dependency reached by a stray `from pyparsing import Optional` that was never used. In a clean environment, `pip install tosclib` produced an unimportable package.
+
+- Building a control with more than one message nested the second message inside the first, because the XML builder rebound its parent element inside a nested loop. An OSC and a MIDI binding on the same control produced a file TouchOSC could not load.
+
+- MIDI bindings were written with a trigger's fields in place of the status bytes, from a leaked loop variable, and their values used a `<midivalue>` tag the format does not define. No MIDI binding tosclib produced was valid.
+
+- `<dstID>` was written without its CDATA wrapper, unlike every other string in the format.
+
+- Generated layouts declared `lexml version=3` and omitted `<includes>`.
+
+- Default `connections` was five slots wide; TouchOSC 1.5 uses ten.
+
+- Element truth-value testing, deprecated since Python 3.12.
+
+- The test suite only passed when run from the repository root.
+
+- CI declared its matrix key as `python-versions` but read `matrix.python-version`, so every leg silently tested the same interpreter, and the matrix targeted Python versions the package rejected.
+
+- `numpy>=2` broke every layout: numpy 2 changed scalar `repr`, and the frames were stringified through it.
+
+- `gridColor` was missing from XY and RADAR defaults, `textClip` and `textWrap` from TEXT, and `lines`/`linesDisplay` from XY.
+
+- `GamepadMessage.connections` defaulted to ten characters. The gamepad field counts controllers, not network connections, and is four wide.
+
+- `MidiType.NOTE_ON` was spelled `NOTEON`; the format uses `NOTE_ON`.
+
+- `PAGER` carried an `x` value instead of `page`, and `ENCODER` was missing its `y`.
+
+## Prior history
+
+py2tosc began as a fork of [tosclib](https://github.com/AlbertoV5/tosclib), which had twelve releases between 2022-05-20 and 2022-06-09, ending at 0.3.5. That history belongs to a different distribution and is not restated here; see [the tosclib releases](https://pypi.org/project/tosclib/#history).
+
+[0.1.0]: https://github.com/shakfu/py2tosc/releases/tag/v0.1.0

py2tosc-0.1.0/LICENSE

@@ -0,0 +1,10 @@
+MIT License
+
+Copyright (c) 2022 Alberto Valdez (AlbertoV5) -- original tosclib
+Copyright (c) 2026 Shakeeb Alireza -- py2tosc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

py2tosc-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: py2tosc
+Version: 0.1.0
+Summary: Generate and edit TouchOSC layouts from Python.
+Keywords: touchosc,osc,midi,tosc,hexler
+Author: Shakeeb Alireza
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/shakfu/py2tosc
+Project-URL: Documentation, https://shakfu.github.io/py2tosc
+Project-URL: Repository, https://github.com/shakfu/py2tosc
+Project-URL: Issues, https://github.com/shakfu/py2tosc/issues
+Description-Content-Type: text/markdown
+
+# py2tosc
+
+Generate and edit TouchOSC layouts from Python.
+
+![Tests](https://github.com/shakfu/py2tosc/actions/workflows/tests.yaml/badge.svg) ![PyPI](https://img.shields.io/pypi/v/py2tosc) ![License](https://img.shields.io/github/license/shakfu/py2tosc)
+
+py2tosc is a rewrite of [tosclib](https://github.com/AlbertoV5/tosclib) by [Alberto Valdez](https://github.com/AlbertoV5), whose work established the original mapping between the `.tosc` format and Python that this library is built on. The API is new and incompatible, but the knowledge of the format -- the control types, the property tables, the message layouts, and some of the tests and examples -- came from there, and is carried over with thanks. Original copyright is retained in [LICENSE](LICENSE).
+
+
+**Disclaimer**: This project has no relation to Hexler, the developer of TouchOSC. Back up your layouts before editing them with third party tools.
+
+## [Documentation](https://shakfu.github.io/py2tosc)
+
+```console
+$ pip install py2tosc
+```
+
+No dependencies. Python 3.10 or newer.
+
+## What it does
+
+A `.tosc` file is a zlib-compressed XML tree. py2tosc reads that tree into plain Python objects, lets you edit them, and writes it back out -- accurately enough that loading a layout and saving it again reproduces the editor's own bytes exactly, in both the compressed and exported forms.
+
+```python
+import py2tosc
+
+doc = py2tosc.load("mixer.tosc")
+
+for fader in doc.find_all(type="FADER"):
+    fader.color = "#e76f51"
+    fader.corner_radius = 2.0
+
+doc.save("mixer-restyled.tosc")
+```
+
+Building one from scratch:
+
+```python
+import py2tosc
+from py2tosc import layout
+
+doc = py2tosc.Document.new(frame=(0, 0, 1024, 768))
+
+strip = py2tosc.group(name="strip", frame=(0, 0, 1024, 768))
+doc.add(strip)
+
+for index, fader in enumerate(layout.row(strip, "FADER", sizes=8)):
+    fader.name = f"ch{index + 1}"
+    fader.messages.append(py2tosc.OscMessage())
+
+doc.save("mixer.tosc")
+```
+
+## Design
+
+| Module | Holds |
+|--------|-------|
+| `enums` | TouchOSC's own vocabulary: control types, property types, conversions |
+| `properties` | `Property`, `Frame`, `Color`, and the `snake_case` to camelCase mapping |
+| `messages` | `Value`, `OscMessage`, `MidiMessage`, `LocalMessage`, `GamepadMessage` and their parts |
+| `defaults` | The default property set for each control type |
+| `control` | `Control`, the node model, plus a factory per control type |
+| `codec` | Reading and writing the `.tosc` XML dialect, CDATA included |
+| `document` | `Document`, `load`, `save`, `dumps` |
+| `layout` | Row, column and grid arrangement, in plain arithmetic |
+
+Property keys are camelCase in the file because that is what TouchOSC stores. The Python API is `snake_case` and translates at the boundary, so `control.corner_radius` addresses the `cornerRadius` key.
+
+## Contributing
+
+```console
+$ make install     # install the package and dev dependencies
+$ make test        # run the test suite
+$ make docs-serve  # serve the documentation with live reload
+```
+
+`make help` lists the rest. The project uses [uv](https://docs.astral.sh/uv/) for environments, building and publishing.
+
+### Releasing
+
+1. Bump `version` in `pyproject.toml` and `__version__` in `src/py2tosc/__init__.py` -- a test fails if they disagree.
+
+2. Date the release's section in `CHANGELOG.md`.
+
+3. `make release-check`, then `make tag` and `git push origin vX.Y.Z`.
+
+4. `make publish-test` to rehearse against TestPyPI, then `make publish CONFIRM=1`.
+
+Publishing is manual and irreversible: a filename PyPI has accepted cannot be reused even after a delete, and no workflow re-checks the tag or the tree first. That makes `make release-check` in step 3 the only gate, so run it on a clean checkout. Both publish targets rebuild `dist/` from scratch and validate it with `twine check --strict` before uploading, and both need credentials in `~/.pypirc` or `TWINE_USERNAME`/`TWINE_PASSWORD`.
+
+Documentation is published the same way, with `make docs-deploy`. Nothing deploys it automatically.
+
+Bug reports and pull requests are welcome, including for the documentation.

py2tosc-0.1.0/README.md

@@ -0,0 +1,93 @@
+# py2tosc
+
+Generate and edit TouchOSC layouts from Python.
+
+![Tests](https://github.com/shakfu/py2tosc/actions/workflows/tests.yaml/badge.svg) ![PyPI](https://img.shields.io/pypi/v/py2tosc) ![License](https://img.shields.io/github/license/shakfu/py2tosc)
+
+py2tosc is a rewrite of [tosclib](https://github.com/AlbertoV5/tosclib) by [Alberto Valdez](https://github.com/AlbertoV5), whose work established the original mapping between the `.tosc` format and Python that this library is built on. The API is new and incompatible, but the knowledge of the format -- the control types, the property tables, the message layouts, and some of the tests and examples -- came from there, and is carried over with thanks. Original copyright is retained in [LICENSE](LICENSE).
+
+
+**Disclaimer**: This project has no relation to Hexler, the developer of TouchOSC. Back up your layouts before editing them with third party tools.
+
+## [Documentation](https://shakfu.github.io/py2tosc)
+
+```console
+$ pip install py2tosc
+```
+
+No dependencies. Python 3.10 or newer.
+
+## What it does
+
+A `.tosc` file is a zlib-compressed XML tree. py2tosc reads that tree into plain Python objects, lets you edit them, and writes it back out -- accurately enough that loading a layout and saving it again reproduces the editor's own bytes exactly, in both the compressed and exported forms.
+
+```python
+import py2tosc
+
+doc = py2tosc.load("mixer.tosc")
+
+for fader in doc.find_all(type="FADER"):
+    fader.color = "#e76f51"
+    fader.corner_radius = 2.0
+
+doc.save("mixer-restyled.tosc")
+```
+
+Building one from scratch:
+
+```python
+import py2tosc
+from py2tosc import layout
+
+doc = py2tosc.Document.new(frame=(0, 0, 1024, 768))
+
+strip = py2tosc.group(name="strip", frame=(0, 0, 1024, 768))
+doc.add(strip)
+
+for index, fader in enumerate(layout.row(strip, "FADER", sizes=8)):
+    fader.name = f"ch{index + 1}"
+    fader.messages.append(py2tosc.OscMessage())
+
+doc.save("mixer.tosc")
+```
+
+## Design
+
+| Module | Holds |
+|--------|-------|
+| `enums` | TouchOSC's own vocabulary: control types, property types, conversions |
+| `properties` | `Property`, `Frame`, `Color`, and the `snake_case` to camelCase mapping |
+| `messages` | `Value`, `OscMessage`, `MidiMessage`, `LocalMessage`, `GamepadMessage` and their parts |
+| `defaults` | The default property set for each control type |
+| `control` | `Control`, the node model, plus a factory per control type |
+| `codec` | Reading and writing the `.tosc` XML dialect, CDATA included |
+| `document` | `Document`, `load`, `save`, `dumps` |
+| `layout` | Row, column and grid arrangement, in plain arithmetic |
+
+Property keys are camelCase in the file because that is what TouchOSC stores. The Python API is `snake_case` and translates at the boundary, so `control.corner_radius` addresses the `cornerRadius` key.
+
+## Contributing
+
+```console
+$ make install     # install the package and dev dependencies
+$ make test        # run the test suite
+$ make docs-serve  # serve the documentation with live reload
+```
+
+`make help` lists the rest. The project uses [uv](https://docs.astral.sh/uv/) for environments, building and publishing.
+
+### Releasing
+
+1. Bump `version` in `pyproject.toml` and `__version__` in `src/py2tosc/__init__.py` -- a test fails if they disagree.
+
+2. Date the release's section in `CHANGELOG.md`.
+
+3. `make release-check`, then `make tag` and `git push origin vX.Y.Z`.
+
+4. `make publish-test` to rehearse against TestPyPI, then `make publish CONFIRM=1`.
+
+Publishing is manual and irreversible: a filename PyPI has accepted cannot be reused even after a delete, and no workflow re-checks the tag or the tree first. That makes `make release-check` in step 3 the only gate, so run it on a clean checkout. Both publish targets rebuild `dist/` from scratch and validate it with `twine check --strict` before uploading, and both need credentials in `~/.pypirc` or `TWINE_USERNAME`/`TWINE_PASSWORD`.
+
+Documentation is published the same way, with `make docs-deploy`. Nothing deploys it automatically.
+
+Bug reports and pull requests are welcome, including for the documentation.

py2tosc-0.1.0/pyproject.toml

@@ -0,0 +1,76 @@
+[project]
+name = "py2tosc"
+version = "0.1.0"
+description = "Generate and edit TouchOSC layouts from Python."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "touchosc",
+    "osc",
+    "midi",
+    "tosc",
+    "hexler",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Sound/Audio",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[[project.authors]]
+name = "Shakeeb Alireza"
+
+[project.urls]
+Homepage = "https://github.com/shakfu/py2tosc"
+Documentation = "https://shakfu.github.io/py2tosc"
+Repository = "https://github.com/shakfu/py2tosc"
+Issues = "https://github.com/shakfu/py2tosc/issues"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "mypy>=1.11",
+    "pillow>=10.0",
+    "ruff>=0.16.1",
+    "twine>=7.0.0",
+]
+docs = [
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+    "mkdocstrings[python]>=0.26",
+]
+
+[tool.uv]
+default-groups = [
+    "dev",
+    "docs",
+]
+
+[tool.uv.build-backend]
+source-include = ["CHANGELOG.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-W error::DeprecationWarning"
+
+[tool.mypy]
+python_version = "3.10"
+packages = ["py2tosc"]
+strict_optional = true
+warn_unused_ignores = true

py2tosc-0.1.0/pyproject.toml.orig

@@ -0,0 +1,72 @@
+[project]
+name = "py2tosc"
+version = "0.1.0"
+description = "Generate and edit TouchOSC layouts from Python."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Shakeeb Alireza" }]
+keywords = ["touchosc", "osc", "midi", "tosc", "hexler"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Sound/Audio",
+    "Typing :: Typed",
+]
+
+# py2tosc has no runtime dependencies. It needs nothing beyond the standard
+# library, which is the point of dropping numpy in 1.0.
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/shakfu/py2tosc"
+Documentation = "https://shakfu.github.io/py2tosc"
+Repository = "https://github.com/shakfu/py2tosc"
+Issues = "https://github.com/shakfu/py2tosc/issues"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "mypy>=1.11",
+    # Only the image converter demo needs this, but the demo is tested.
+    "pillow>=10.0",
+    "ruff>=0.16.1",
+    "twine>=7.0.0",
+]
+docs = [
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+    "mkdocstrings[python]>=0.26",
+]
+
+[tool.uv.build-backend]
+# Ship the changelog in the sdist alongside README and LICENSE.
+source-include = ["CHANGELOG.md"]
+
+[tool.uv]
+# Both groups are installed by a bare `uv sync`, so `make docs` and `make test`
+# work without having to name a group.
+default-groups = ["dev", "docs"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-W error::DeprecationWarning"
+
+[tool.mypy]
+python_version = "3.10"
+packages = ["py2tosc"]
+strict_optional = true
+warn_unused_ignores = true

py2tosc-0.1.0/src/py2tosc/__init__.py

@@ -0,0 +1,110 @@
+"""Generate and edit TouchOSC layouts from Python.
+
+```python
+import py2tosc
+
+doc = py2tosc.load("layout.tosc")
+for fader in doc.find_all(type="FADER"):
+    fader.color = "#e76f51"
+doc.save("out.tosc")
+```
+
+This project has no relation to Hexler, the developer of TouchOSC. Back up your
+layouts before editing them with third party tools.
+"""
+
+from . import layout
+from .control import (
+    Control,
+    box,
+    button,
+    encoder,
+    fader,
+    grid,
+    group,
+    label,
+    pager,
+    radar,
+    radial,
+    radio,
+    text,
+    xy,
+)
+from .document import Document, dumps, load, loads, save
+from .enums import (
+    ControlType,
+    Conversion,
+    MidiType,
+    PartialType,
+    PropertyType,
+    TriggerCondition,
+)
+from .messages import (
+    GamepadMessage,
+    LocalMessage,
+    Message,
+    MidiCommand,
+    MidiMessage,
+    MidiValue,
+    OscMessage,
+    Partial,
+    Trigger,
+    Value,
+)
+from .properties import Color, Frame, Property, to_color, to_frame
+from .validate import Issue, ValidationError, validate
+
+#: Keep in step with `version` in pyproject.toml, which the build backend reads
+#: and which `uv_build` requires to be static. `test_version_is_declared_once`
+#: fails if the two drift apart.
+__version__ = "0.1.0"
+
+# Sorted rather than grouped by topic, because RUF022 asks for it and the
+# grouping lives in the API reference instead. See docs/api/.
+__all__ = [
+    "Color",
+    "Control",
+    "ControlType",
+    "Conversion",
+    "Document",
+    "Frame",
+    "GamepadMessage",
+    "Issue",
+    "LocalMessage",
+    "Message",
+    "MidiCommand",
+    "MidiMessage",
+    "MidiType",
+    "MidiValue",
+    "OscMessage",
+    "Partial",
+    "PartialType",
+    "Property",
+    "PropertyType",
+    "Trigger",
+    "TriggerCondition",
+    "ValidationError",
+    "Value",
+    "__version__",
+    "box",
+    "button",
+    "dumps",
+    "encoder",
+    "fader",
+    "grid",
+    "group",
+    "label",
+    "layout",
+    "load",
+    "loads",
+    "pager",
+    "radar",
+    "radial",
+    "radio",
+    "save",
+    "text",
+    "to_color",
+    "to_frame",
+    "validate",
+    "xy",
+]