py2max 0.2.1__py3-none-any.whl

py2max/__init__.py

@@ -0,0 +1,67 @@
+"""py2max: A pure Python library for offline generation of Max/MSP patcher files.
+
+py2max provides a Python object model that mirrors Max's patch organization with
+round-trip conversion capabilities. It enables programmatic creation of Max/MSP
+patches (.maxpat) files.
+
+Main Classes:
+    Patcher: Core class for creating and managing Max patches
+    Box: Represents individual Max objects (oscillators, effects, etc.)
+    Patchline: Represents connections between objects
+    MaxRefDB: SQLite database for Max object reference data
+
+Exceptions:
+    Py2MaxError: Base exception for all py2max errors
+    InvalidConnectionError: Exception raised for invalid connections
+    InvalidObjectError: Exception raised for invalid object configuration
+    InvalidPatchError: Exception raised for invalid patcher state
+    PatcherIOError: Exception raised for file I/O errors
+    MaxRefError: Exception raised for MaxRef XML parsing errors
+    LayoutError: Exception raised for layout manager errors
+    DatabaseError: Exception raised for database errors
+
+Example:
+    >>> from py2max import Patcher
+    >>> p = Patcher('my-patch.maxpat')
+    >>> osc = p.add_textbox('cycle~ 440')
+    >>> gain = p.add_textbox('gain~')
+    >>> dac = p.add_textbox('ezdac~')
+    >>> p.add_line(osc, gain)
+    >>> p.add_line(gain, dac)
+    >>> p.to_svg('/tmp/preview.svg')  # Export to SVG
+    >>> p.save()
+"""
+
+__version__ = "0.2.1"
+
+from .core import Box, Patcher, Patchline
+from .maxref import MaxRefDB
+from .exceptions import (
+    DatabaseError,
+    InvalidConnectionError,
+    InvalidObjectError,
+    InvalidPatchError,
+    LayoutError,
+    MaxRefError,
+    PatcherIOError,
+    Py2MaxError,
+)
+
+__all__ = [
+    # Version
+    "__version__",
+    # Core classes
+    "Patcher",
+    "Box",
+    "Patchline",
+    "MaxRefDB",
+    # Exceptions
+    "Py2MaxError",
+    "InvalidConnectionError",
+    "InvalidObjectError",
+    "InvalidPatchError",
+    "PatcherIOError",
+    "MaxRefError",
+    "LayoutError",
+    "DatabaseError",
+]

py2max/__main__.py

@@ -0,0 +1,6 @@
+"""py2max command line entry point."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())