py2max 0.2.1__tar.gz → 0.3.1__tar.gz

{py2max-0.2.1 → py2max-0.3.1}/CHANGELOG.md

@@ -2,6 +2,107 @@
 
 ## [Unreleased]
 
+## [0.3.1]
+
+### New: Standalone `gen.codebox~` Support
+
+- `Patcher.add_gen_codebox(code)` adds a self-contained `gen.codebox~` object -- a complete gen patch in a single box that lives directly in a regular Max patcher, distinct from the inner `codebox~` (emitted by `add_codebox`) that belongs inside a `gen~`/`rnbo~` subpatcher. This is the form emitted by gen transpilers. Code newlines are normalized to CRLF as Max expects, and `fontname`/`fontsize` default to the monospaced gen style.
+- Inlet/outlet counts are derived automatically from the code (the highest `inN` / `outN` references, floor of 1), matching gen's dynamic-I/O semantics. Explicit `numinlets` / `numoutlets` still override.
+- Available via the `add()` string shortcut too: `p.add("gen.codebox~ out1 = in1 * 0.5;")`. The shortcut suits single-line / `;`-terminated code; pass multi-line source to `add_gen_codebox()` directly.
+- Connection validation for `gen.codebox~` (and `codebox` / `codebox~`) now bound-checks against the box's own declared inlet/outlet counts rather than the static `.maxref.xml` entry, since codebox I/O is code-dependent. This both allows valid connections to/from wider codeboxes (e.g. from a second outlet) and rejects genuinely out-of-range ones.
+
+## [0.3.0]
+
+### Removed: Interactive Server Split Into `py2max-server` (breaking)
+
+The browser-based live editor and remote REPL have moved to a separate companion package, [`py2max-server`](https://github.com/shakfu/py2max-server), so the core library stays small, offline, and dependency-free.
+
+- Removed `Patcher.serve()` and the `py2max serve` / `py2max repl` CLI commands; those CLI subcommands now print a pointer to `py2max-server`.
+- Removed the `[server]` optional-dependency extra (`websockets`, `ptpython`) and the bundled browser assets (`py2max/static/`).
+- Install the server features with `pip install py2max-server` and use `py2max-server serve <patch>` / `py2max-server repl …`. The remote REPL now requires token authentication (passed via `--token` or `PY2MAX_REPL_TOKEN`).
+
+### New: `Patcher.encapsulate()`
+
+- `Patcher.encapsulate(boxes, text="p sub")` wraps a selection of boxes into a subpatcher, auto-generating `inlet`/`outlet` objects for any connections that cross the selection boundary and rewiring the parent through the new subpatcher box. Connections wholly inside the selection move into the subpatcher; connections wholly outside it are untouched. Ports are de-duplicated by source, matching how patches are built by hand. Returns the new subpatcher `Box`.
+
+### New: Preset / `pattrstorage` Scaffolding
+
+- `Patcher.add_pattrstorage(name)`, `Patcher.add_autopattr()`, and `Patcher.add_preset_system(name)` (which adds both and wires `autopattr` -> `pattrstorage`) scaffold a Max preset system. Any object with a scripting name (`varname`) or `parameter_enable=1` participates.
+- `Patcher.enable_parameter(box, longname, shortname="", ptype=0, initial=None)` turns an existing UI box into a Max parameter (sets `parameter_enable` and the `saved_attribute_attributes`), so it participates in presets and, in a Max for Live device, appears as an automatable parameter.
+
+### New: Keyword-Attribute Validation (`validate_attrs`)
+
+- `Patcher(validate_attrs=True)` warns (`UserWarning`) when an object is given a keyword that is not a known attribute for its Max class -- catching typos like `inital=` for `initial=`. The known set is the object's maxref attributes plus a universal box-attribute whitelist; objects with no maxref entry are skipped. Off by default and warn-only, so it never changes generated output.
+
+### New: Multichannel (`mc.`) / Polyphony Helpers
+
+- `Patcher.add_mc(text, chans=None)` adds a multichannel object, prefixing `mc.` and appending `@chans` (e.g. `add_mc("cycle~ 440", chans=4)` -> `mc.cycle~ 440 @chans 4`).
+- `Patcher.add_poly(target, voices=1)` adds a `poly~` object hosting N voices of a target patch.
+
+### Improved: SVG Export (Max-faithful preview)
+
+- The `preview` / `to_svg` output now approximates Max's look: a light patcher background, signal vs message/control **ports colored distinctly** (signal green, control dark), signal **cables drawn thicker and in a distinct color**, and subpatcher boxes tinted so they stand out. Object text is intentionally not truncated, matching Max (objects size to their text).
+
+### Changed: Documentation moved to MkDocs
+
+- Documentation migrated from Sphinx/reStructuredText to **MkDocs + Material + mkdocstrings** (all Markdown, matching the rest of the repo). The API reference is generated from the (now fully typed) docstrings, including `Patcher`'s mixin-provided methods. The changelog and contributing pages are single-source includes of `CHANGELOG.md` / `CONTRIBUTING.md`. Build with `make docs`, preview with `make docs-serve`, publish with `make docs-deploy`. `docs/notes/` is retained as a historical journal but excluded from the published site.
+
+### New: Color / Theme Helpers
+
+- `Box.set_color(bg=..., text=..., border=...)` sets a box's `bgcolor`/`textcolor`/`bordercolor`; each accepts a named color (e.g. `"red"`), a hex string (`"#ff8800"`), or an `[r, g, b(, a)]` float sequence. Returns the box for chaining.
+- `Patcher.apply_theme(theme)` applies a color theme to every box (recursing into subpatchers). Built-in themes: `"light"`, `"dark"`, `"blue"`, `"high-contrast"`; or pass a dict of `bg`/`text`/`border` colors.
+- `py2max.core.colors` exposes the `MAX_COLORS` named palette and `resolve_color()`.
+
+### Security
+
+- **Removed a misleading path-traversal check** in `Patcher.save_as()`. The previous `..`/`/etc` allowlist was trivially bypassable and gave a false sense of safety; for an offline file generator it provided no real protection. Genuinely unresolvable paths still raise `PatcherIOError`.
+
+### Typed: Full `mypy --strict`
+
+- The entire package is now annotated and passes `mypy --strict`, backing the shipped `py.typed` marker. `[tool.mypy]` enforces `strict = true`. Core has **no runtime dependencies**.
+
+### Changed: Lighter Core Imports
+
+- `import py2max` no longer eagerly imports `sqlite3`, the maxref database layer, or `py2max.m4l`. `MaxRefDB` is now available lazily via `from py2max.maxref import MaxRefDB` (removed from the top-level `py2max` namespace).
+
+### Internal: `Patcher` Decomposition
+
+- Split the ~1660-line `Patcher` class into focused mixins composed via inheritance: object creation (`BoxFactoryMixin` in `core/factory.py`) and serialization (`SerializationMixin` in `core/serialization.py`). The public API is unchanged; adding a new object type now means editing `core/factory.py` rather than the core class.
+
+### Fixed
+
+- Object-name resolution (used by connection validation and object classification) now reads the box `text` property, so it resolves correctly for boxes loaded from a file. Previously it inspected only programmatic kwargs and returned `newobj` for loaded boxes.
+- `Box.oid` now returns the trailing numeric part of any id (e.g. `cycle_1` -> 1) instead of raising `ValueError` under `semantic_ids=True`.
+- The `py2max` CLI now reports all `Py2MaxError`s (not just `InvalidConnectionError`) as a clean error message instead of leaking a traceback.
+- Fixed an `inital` -> `initial` keyword typo in the simple-synthesis tutorial.
+
+### Testing & Tooling
+
+- The test suite is now hermetic: a `conftest.py` autouse fixture isolates each test in a temporary working directory, so relative `outputs/` writes no longer accumulate in the repo. Fixture reads are anchored at the test file.
+- Promoted the `.amxd` byte-for-byte fixtures from the gitignored `outputs/` into tracked `tests/data/`, so that verification runs in CI and on fresh checkouts instead of only on the author's machine.
+- Repo-wide `ruff` lint and format cleanup.
+
+### New: Max for Live Support (`py2max.m4l`)
+
+Implements [issue #9](https://github.com/shakfu/py2max/issues/9). See [`docs/notes/amxd.md`](https://github.com/shakfu/py2max/blob/main/docs/notes/amxd.md) for the on-disk format, embedded-project block, and verification details.
+
+- **`.amxd` read/write**: byte-for-byte compatible with Max-exported devices; verified against real fixtures and end-to-end in Live 12.
+- **Device-type discrimination**: Audio Effect / Instrument / MIDI Effect via `Patcher(device_type=...)` or the `pack_amxd` / `write_amxd` `device_type` argument.
+- **Presentation-mode helpers**: `Patcher.enable_presentation(devicewidth=...)`, `Patcher.enforce_integer_coords()`, `Box.add_to_presentation([x, y, w, h])` (rejects M4L infrastructure objects, rounds fractional coords with a warning).
+- `Patcher.save()` / `Patcher.from_file()` auto-detect the `.amxd` extension; `.maxpat` path is unchanged.
+
+### Changed: M4L Module Layout & Imports
+
+- All M4L code (binary format + presentation helpers) lives in a single module `py2max/m4l.py`. Previously briefly split as `py2max/amxd.py`.
+- M4L symbols are reachable only via `from py2max.m4l import …`; nothing is re-exported from the top-level `py2max` namespace.
+
+### New: Prebuilt MaxRef Bundle (Linux Support)
+
+- Ship `py2max/maxref/data/bundle.json.gz` in the wheel (1175 objects, ~1 MiB compressed, ~7 MiB raw).
+- `MaxRefCache._get_refdict()` falls back to the bundle when no local Max installation is found, pre-seeding the parser cache so `Box.help()`, `get_inlet_count`, `get_outlet_count`, and connection validation work identically on Linux.
+- Regenerate with `uv run python scripts/build_maxref_bundle.py` on a machine with Max installed; commit the result.
+- Bundle stores full parsed data (methods, attributes, inlets/outlets, digests, descriptions) — not a trimmed subset — so introspection parity with macOS/Windows is preserved.
+
 ## [0.2.1] - 2026-01-11
 
 ### New: Dagre Layout Algorithm

{py2max-0.2.1 → py2max-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py2max
-Version: 0.2.1
+Version: 0.3.1
 Summary: A library for offline generation of Max/MSP patcher (.maxpat) files.
 Keywords: Max,maxpat,offline
 Author: Shakeeb Alireza
@@ -12,7 +12,6 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Topic :: Multimedia :: Sound/Audio
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -22,15 +21,14 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Typing :: Typed
-Requires-Dist: websockets>=12.0 ; extra == 'server'
-Requires-Dist: ptpython>=3.0.0 ; extra == 'server'
+Maintainer: Shakeeb Alireza
+Maintainer-email: Shakeeb Alireza <shakfu@users.noreply.github.com>
 Requires-Python: >=3.9
-Project-URL: Changelog, https://github.com/shakfu/py2max/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://github.com/shakfu/py2max#readme
 Project-URL: Homepage, https://github.com/shakfu/py2max
-Project-URL: Issues, https://github.com/shakfu/py2max/issues
+Project-URL: Documentation, https://github.com/shakfu/py2max#readme
 Project-URL: Repository, https://github.com/shakfu/py2max.git
-Provides-Extra: server
+Project-URL: Issues, https://github.com/shakfu/py2max/issues
+Project-URL: Changelog, https://github.com/shakfu/py2max/blob/main/CHANGELOG.md
 Description-Content-Type: text/markdown
 
 # py2max
@@ -46,9 +44,13 @@ If you are looking for Python 3 externals for Max/MSP, check out the [py-js](htt
 
 ```bash
 pip install py2max
+```
+
+For the browser-based live editor and remote REPL, install the companion
+[`py2max-server`](https://github.com/shakfu/py2max-server) package:
 
-# With interactive server support
-pip install py2max[server]
+```bash
+pip install py2max-server
 ```
 
 For development:
@@ -82,15 +84,48 @@ That's it! Open `my-synth.maxpat` in Max to see your patch.
 
 - **Offline Patch Generation** - Create Max patches programmatically without Max running
 - **Round-trip Conversion** - Load, modify, and save existing `.maxpat` files
+- **Max for Live (.amxd)** - Read/write binary `.amxd` device files with presentation-mode helpers
 - **Universal Object Support** - Works with any Max/MSP/Jitter object
-- **99% Test Coverage** - 418+ tests ensure reliability
+- **Fully typed** - Passes `mypy --strict`; no runtime dependencies
+- **High Test Coverage** - 420+ tests ensure reliability
+
+### Max for Live (.amxd)
+
+Generate Max for Live devices directly. `Patcher.save()` / `Patcher.from_file()`
+auto-detect the `.amxd` extension and read/write the binary device format,
+byte-for-byte compatible with Max-exported devices.
+
+```python
+from py2max import Patcher
+
+# device_type: "audio_effect" (default), "instrument", or "midi_effect"
+p = Patcher('gain.amxd', device_type='audio_effect')
+p.enable_presentation(devicewidth=120)        # render Ableton's device strip
 
-### Interactive Server (New in 0.2.x)
+plugin = p.add_textbox('plugin~')             # audio in from Live
+gain = p.add('live.gain~', maxclass='live.gain~')
+plugout = p.add_textbox('plugout~')           # audio back to Live
+gain.add_to_presentation([20, 20, 60, 136])   # show the fader in the device
 
-Real-time browser-based patch editing with bidirectional sync:
+p.add_line(plugin, gain, outlet=0, inlet=0)
+p.add_line(gain, plugout, outlet=0, inlet=0)
+p.save()                                       # writes a binary .amxd
+```
+
+Helpers: `Patcher.enable_presentation(devicewidth=...)`,
+`Box.add_to_presentation([x, y, w, h])` (rejects M4L infrastructure objects and
+rounds fractional coordinates), and `Patcher.enforce_integer_coords()`. M4L
+binary helpers live in `py2max.m4l`.
+
+### Interactive Server (separate package)
+
+Real-time browser-based patch editing with bidirectional sync lives in the
+companion [`py2max-server`](https://github.com/shakfu/py2max-server) package, so
+the core library stays small and offline:
 
 ```bash
-py2max serve my-patch.maxpat
+pip install py2max-server
+py2max-server serve my-patch.maxpat
 # Opens browser at http://localhost:8000
 ```
 
@@ -247,6 +282,34 @@ p.link(sbox, dac)
 p.save()
 ```
 
+### Gen Codebox
+
+`add_gen_codebox()` adds a standalone `gen.codebox~` object -- a complete gen
+patch in a single box that sits directly in a regular Max patcher (unlike the
+inner `codebox~` from `add_codebox()`, which belongs inside a `gen~`/`rnbo~`
+subpatcher). Inlet/outlet counts are derived automatically from the highest
+`inN`/`outN` references in the code:
+
+```python
+p = Patcher('fbdelay.maxpat')
+
+# 1 inlet (in1), 1 outlet (out1)
+osc = p.add('cycle~ 440')
+cb = p.add_gen_codebox('''
+Param feedback(0.5, min=0.0, max=0.95);
+History fb(0.0);
+out1 = in1 + fb * feedback;
+fb = out1;
+''')
+dac = p.add('ezdac~')
+p.link(osc, cb)
+p.link(cb, dac)
+p.save()
+
+# Or via the add() string shortcut (single-line / `;`-terminated code)
+cb = p.add('gen.codebox~ out1 = in1 * 0.5;')
+```
+
 ### Object Search
 
 ```python
@@ -285,12 +348,15 @@ py2max validate demo.maxpat
 
 ### Interactive Server
 
+Provided by the separate [`py2max-server`](https://github.com/shakfu/py2max-server)
+package (`pip install py2max-server`):
+
 ```bash
 # Start server with browser editing
-py2max serve my-patch.maxpat
+py2max-server serve my-patch.maxpat
 
 # With REPL in same terminal
-py2max serve my-patch.maxpat --repl
+py2max-server serve my-patch.maxpat --repl
 ```
 
 ### MaxRef Database
@@ -350,18 +416,21 @@ All classes are extendable via `**kwargs`, allowing any Max object configuration
 
 ## Caveats
 
-- Max doesn't refresh from file when open - close and reopen to see changes, or use `py2max serve` for live editing
+- Max doesn't refresh from file when open - close and reopen to see changes, or use `py2max-server serve` (from the separate `py2max-server` package) for live editing
 - For tilde variants, use the `_tilde` suffix: `p.add_gen()` vs `p.add_gen_tilde()`
 - API docs in progress - see `CLAUDE.md` for comprehensive usage
 
 ## Examples
 
-See the `examples/` directory for demonstrations:
+The [`tests/examples/`](tests/examples/) directory contains working, tested
+examples organized by topic (see its [README](tests/examples/README.md)):
 
-- `auto_layout_demo.py` - Complex synthesizer with layout optimization
-- `nested_patcher_demo.py` - Subpatcher navigation
-- `columnar_layout_demo.py` - Functional column organization
-- `matrix_layout_demo.py` - Signal chain matrix layout
+- `quickstart/basic_patch.py` - Simple oscillator patch
+- `tutorial/signal_processing_chain.py` - Complex audio processing chain
+- `tutorial/generative_music.py` - Generative music system with patterns
+- `layout/grid_layout_examples.py` - Grid layout with clustering
+- `advanced/data_containers.py` - Tables, collections, and dictionaries
+- `api/patcher_api_examples.py` - Patcher API reference examples
 
 External usage:
 

{py2max-0.2.1 → py2max-0.3.1}/README.md

@@ -11,9 +11,13 @@ If you are looking for Python 3 externals for Max/MSP, check out the [py-js](htt
 
 ```bash
 pip install py2max
+```
+
+For the browser-based live editor and remote REPL, install the companion
+[`py2max-server`](https://github.com/shakfu/py2max-server) package:
 
-# With interactive server support
-pip install py2max[server]
+```bash
+pip install py2max-server
 ```
 
 For development:
@@ -47,15 +51,48 @@ That's it! Open `my-synth.maxpat` in Max to see your patch.
 
 - **Offline Patch Generation** - Create Max patches programmatically without Max running
 - **Round-trip Conversion** - Load, modify, and save existing `.maxpat` files
+- **Max for Live (.amxd)** - Read/write binary `.amxd` device files with presentation-mode helpers
 - **Universal Object Support** - Works with any Max/MSP/Jitter object
-- **99% Test Coverage** - 418+ tests ensure reliability
+- **Fully typed** - Passes `mypy --strict`; no runtime dependencies
+- **High Test Coverage** - 420+ tests ensure reliability
+
+### Max for Live (.amxd)
+
+Generate Max for Live devices directly. `Patcher.save()` / `Patcher.from_file()`
+auto-detect the `.amxd` extension and read/write the binary device format,
+byte-for-byte compatible with Max-exported devices.
+
+```python
+from py2max import Patcher
+
+# device_type: "audio_effect" (default), "instrument", or "midi_effect"
+p = Patcher('gain.amxd', device_type='audio_effect')
+p.enable_presentation(devicewidth=120)        # render Ableton's device strip
+
+plugin = p.add_textbox('plugin~')             # audio in from Live
+gain = p.add('live.gain~', maxclass='live.gain~')
+plugout = p.add_textbox('plugout~')           # audio back to Live
+gain.add_to_presentation([20, 20, 60, 136])   # show the fader in the device
+
+p.add_line(plugin, gain, outlet=0, inlet=0)
+p.add_line(gain, plugout, outlet=0, inlet=0)
+p.save()                                       # writes a binary .amxd
+```
 
-### Interactive Server (New in 0.2.x)
+Helpers: `Patcher.enable_presentation(devicewidth=...)`,
+`Box.add_to_presentation([x, y, w, h])` (rejects M4L infrastructure objects and
+rounds fractional coordinates), and `Patcher.enforce_integer_coords()`. M4L
+binary helpers live in `py2max.m4l`.
 
-Real-time browser-based patch editing with bidirectional sync:
+### Interactive Server (separate package)
+
+Real-time browser-based patch editing with bidirectional sync lives in the
+companion [`py2max-server`](https://github.com/shakfu/py2max-server) package, so
+the core library stays small and offline:
 
 ```bash
-py2max serve my-patch.maxpat
+pip install py2max-server
+py2max-server serve my-patch.maxpat
 # Opens browser at http://localhost:8000
 ```
 
@@ -212,6 +249,34 @@ p.link(sbox, dac)
 p.save()
 ```
 
+### Gen Codebox
+
+`add_gen_codebox()` adds a standalone `gen.codebox~` object -- a complete gen
+patch in a single box that sits directly in a regular Max patcher (unlike the
+inner `codebox~` from `add_codebox()`, which belongs inside a `gen~`/`rnbo~`
+subpatcher). Inlet/outlet counts are derived automatically from the highest
+`inN`/`outN` references in the code:
+
+```python
+p = Patcher('fbdelay.maxpat')
+
+# 1 inlet (in1), 1 outlet (out1)
+osc = p.add('cycle~ 440')
+cb = p.add_gen_codebox('''
+Param feedback(0.5, min=0.0, max=0.95);
+History fb(0.0);
+out1 = in1 + fb * feedback;
+fb = out1;
+''')
+dac = p.add('ezdac~')
+p.link(osc, cb)
+p.link(cb, dac)
+p.save()
+
+# Or via the add() string shortcut (single-line / `;`-terminated code)
+cb = p.add('gen.codebox~ out1 = in1 * 0.5;')
+```
+
 ### Object Search
 
 ```python
@@ -250,12 +315,15 @@ py2max validate demo.maxpat
 
 ### Interactive Server
 
+Provided by the separate [`py2max-server`](https://github.com/shakfu/py2max-server)
+package (`pip install py2max-server`):
+
 ```bash
 # Start server with browser editing
-py2max serve my-patch.maxpat
+py2max-server serve my-patch.maxpat
 
 # With REPL in same terminal
-py2max serve my-patch.maxpat --repl
+py2max-server serve my-patch.maxpat --repl
 ```
 
 ### MaxRef Database
@@ -315,18 +383,21 @@ All classes are extendable via `**kwargs`, allowing any Max object configuration
 
 ## Caveats
 
-- Max doesn't refresh from file when open - close and reopen to see changes, or use `py2max serve` for live editing
+- Max doesn't refresh from file when open - close and reopen to see changes, or use `py2max-server serve` (from the separate `py2max-server` package) for live editing
 - For tilde variants, use the `_tilde` suffix: `p.add_gen()` vs `p.add_gen_tilde()`
 - API docs in progress - see `CLAUDE.md` for comprehensive usage
 
 ## Examples
 
-See the `examples/` directory for demonstrations:
+The [`tests/examples/`](tests/examples/) directory contains working, tested
+examples organized by topic (see its [README](tests/examples/README.md)):
 
-- `auto_layout_demo.py` - Complex synthesizer with layout optimization
-- `nested_patcher_demo.py` - Subpatcher navigation
-- `columnar_layout_demo.py` - Functional column organization
-- `matrix_layout_demo.py` - Signal chain matrix layout
+- `quickstart/basic_patch.py` - Simple oscillator patch
+- `tutorial/signal_processing_chain.py` - Complex audio processing chain
+- `tutorial/generative_music.py` - Generative music system with patterns
+- `layout/grid_layout_examples.py` - Grid layout with clustering
+- `advanced/data_containers.py` - Tables, collections, and dictionaries
+- `api/patcher_api_examples.py` - Patcher API reference examples
 
 External usage:
 

{py2max-0.2.1 → py2max-0.3.1}/py2max/__init__.py

@@ -8,7 +8,10 @@ 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
+
+The SQLite Max-reference database is available as ``from py2max.maxref import
+MaxRefDB`` -- kept out of the top-level import so ``import py2max`` does not pull
+in ``sqlite3`` and the database layer.
 
 Exceptions:
     Py2MaxError: Base exception for all py2max errors
@@ -32,10 +35,9 @@ Example:
     >>> p.save()
 """
 
-__version__ = "0.2.1"
+__version__ = "0.3.1"
 
 from .core import Box, Patcher, Patchline
-from .maxref import MaxRefDB
 from .exceptions import (
     DatabaseError,
     InvalidConnectionError,
@@ -54,7 +56,6 @@ __all__ = [
     "Patcher",
     "Box",
     "Patchline",
-    "MaxRefDB",
     # Exceptions
     "Py2MaxError",
     "InvalidConnectionError",