macpm 0.23__tar.gz → 2.0__tar.gz

macpm-2.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## 2.0 — 2026-11-10
+
+### Changed
+
+- **Rootless by default**: macpm no longer runs `sudo`, `powermetrics` or any
+  privileged helper. Data is collected from IOReport, IOKit, `psutil`,
+  `sysctl`, `ioreg` and `pmset`.
+- Reworked the sampler into `macpm.sampler`, with ctypes bindings in
+  `macpm.ioreport` and SoC/DVFS discovery in `macpm.soc`.
+- The terminal layout, panel titles, charts, colours and key bindings remain
+  the same as macpm 0.x.
+- Version bumped to 2.0.
+
+### Added
+
+- `macpm-sensors` / `macpm.sensors` — read SMC temperatures and fan speeds
+  without root (read-only).
+- `macpm-dump` / `macpm.dump` — print the rootless metrics as JSON for
+  debugging.
+- Optional per-core view improvements and reset/peak handling retained from
+  0.24.
+- `--version` flag.
+- Compatibility notes for macOS 12–27, M1–M4 and partial M5/Ultra support.
+
+### Fixed
+
+- `--show_cores` now accepts a real boolean value and `--show_cores` alone.
+- Zero-division guards for `--avg < --interval` and for chips without E cores.
+- No child `powermetrics` process is left behind when the TUI exits.
+- `ioreg` output is filtered at the source to avoid retaining tens of MB of
+  XML in the Python allocator.
+- Only the required `Energy Model` channels are subscribed, reducing memory
+  and CPU usage.
+
+### Removed
+
+- `sudo echo` pre-authentication and the `sudo nice powermetrics` subprocess.
+- The `macpm2` development package (merged into `macpm`).
+
+## 0.24
+
+- Last 0.x release: `sudo` + `powermetrics` based sampler, Python TUI with
+  CPU/GPU/ANE power, RAM, disk and network panels.

macpm-2.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include CHANGELOG.md
+include RELEASE.md
+include LICENSE
+recursive-include packaging *
+recursive-include tests *.py

macpm-2.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: macpm
+Version: 2.0
+Summary: Rootless performance monitoring CLI tool for Apple Silicon
+Home-page: https://github.com/visualcjy/macpm
+Author: Jinyu Chen
+Author-email: visualcjy@mail.com
+License: MIT
+Project-URL: Source, https://github.com/visualcjy/macpm
+Project-URL: Issues, https://github.com/visualcjy/macpm/issues
+Project-URL: Changelog, https://github.com/visualcjy/macpm/blob/main/CHANGELOG.md
+Keywords: macpm apple-silicon monitor performance ioReport psutil
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Operating System :: MacOS
+Classifier: Environment :: Console
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dashing>=0.1
+Requires-Dist: psutil>=5.9
+Requires-Dist: humanize>=4.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# macpm
+
+**Rootless performance monitoring CLI for Apple Silicon.**<br>
+macpm 2.0 reads the same hardware counters as `powermetrics`, but through
+IOReport/IOKit/SMC — no `sudo`, no password, no privileged helper.
+
+A Python-based `nvtop`-inspired terminal monitor for Apple Silicon Macs,
+forked from [asitop](https://github.com/tlkh/asitop).
+
+## Demo
+
+Default view — CPU/GPU/ANE utilisation and power, memory, disk I/O and
+network, updating once per second:
+
+![macpm default view](https://raw.githubusercontent.com/visualcjy/macpm/main/images/macpm_v.gif)
+
+Same view in another colour theme (press ← / → to cycle through them):
+
+![macpm cyan colour theme](https://raw.githubusercontent.com/visualcjy/macpm/main/images/macpm.gif)
+
+Per-core view (`--show_cores`, or press `2` while running):
+
+![macpm per-core view](https://raw.githubusercontent.com/visualcjy/macpm/main/images/v2.png)
+
+## Highlights
+
+- **No sudo required.** `macpm` runs as a normal user process.
+- CPU E/P core utilisation and frequency, plus an optional per-core view
+- GPU utilisation and frequency
+- CPU / GPU / ANE power, rolling average, peaks and throttle state
+- RAM and swap usage
+- Disk IOPS/throughput and network throughput
+- Optional temperature/fan reader (`macpm-sensors`)
+- Same terminal layout, colours, charts and key bindings as macpm 0.x
+
+## Install
+
+Requirements: **Apple Silicon Mac**, **macOS 12+**, **Python 3.9+**.
+
+```sh
+python3 -m pip install --upgrade macpm
+```
+
+Then run:
+
+```sh
+macpm
+```
+
+There is **no `sudo macpm`** in 2.0. Running it with `sudo` still works, but it
+is unnecessary and no longer recommended.
+
+Prefer a standalone binary with no Python installation? See
+[Standalone binaries](#standalone-binaries).
+
+## Usage
+
+```text
+macpm [--interval INTERVAL] [--color COLOR] [--avg AVG] [--show_cores [BOOL]] [--version]
+```
+
+| Option | Meaning |
+|---|---|
+| `--interval SECONDS` | Sampling and display interval (default `1`) |
+| `--color 1-8` | Display colour (default `2`) |
+| `--avg SECONDS` | Averaging window for power values (default `30`) |
+| `--show_cores [BOOL]` | Start in the per-core view |
+| `--version` | Print the version |
+
+Keys:
+
+```text
+q / ESC     quit
+← / →       change colour
+1 / 2       default view / per-core view
+Ctrl+R      reset peaks
+```
+
+## Colour themes
+
+Pick one with `--color N`, or press ← / → while macpm is running.  The default
+is `2` (green).
+
+| | |
+|---|---|
+| **1 — red**<br>![colour 1: red](https://raw.githubusercontent.com/visualcjy/macpm/main/images/4.png) | **2 — green (default)**<br>![colour 2: green](https://raw.githubusercontent.com/visualcjy/macpm/main/images/5.png) |
+| **3 — yellow**<br>![colour 3: yellow](https://raw.githubusercontent.com/visualcjy/macpm/main/images/6.png) | **4 — blue**<br>![colour 4: blue](https://raw.githubusercontent.com/visualcjy/macpm/main/images/7.png) |
+| **5 — magenta**<br>![colour 5: magenta](https://raw.githubusercontent.com/visualcjy/macpm/main/images/8.png) | **6 — cyan**<br>![colour 6: cyan](https://raw.githubusercontent.com/visualcjy/macpm/main/images/1.png) |
+| **7 — white**<br>![colour 7: white](https://raw.githubusercontent.com/visualcjy/macpm/main/images/2.png) | **8 — grey**<br>![colour 8: grey](https://raw.githubusercontent.com/visualcjy/macpm/main/images/3.png) |
+
+## Why no sudo?
+
+macpm 0.x called `sudo powermetrics`. In 2.0 the sampler reads the underlying
+counters directly.  The data is not secret; the old `powermetrics` CLI simply
+requires root and Apple's private entitlements.
+
+| Metric | Source |
+|---|---|
+| CPU E/P load and frequency | IOReport `CPU Stats` performance states |
+| Per-core load | IOReport `CPU Core Performance States` |
+| GPU load and frequency | IOReport `GPU Stats` / `GPU Performance States` |
+| CPU / GPU / ANE power | IOReport `Energy Model` |
+| RAM / swap | `psutil` |
+| Disk / network | `psutil` counters |
+| Thermal throttle | `pmset -g therm` |
+| SoC name / core counts | `sysctl` |
+| GPU core count | `ioreg` `gpu-core-count` |
+
+The DVFS frequency tables are parsed from the `pmgr` IORegistry node;
+M1–M3 store Hz there, M4+ store kHz.
+
+## Temperatures and fans
+
+The default TUI intentionally stays identical to macpm 0.x, which has no
+temperature/fan panel.  The standalone SMC reader is available as:
+
+```sh
+macpm-sensors
+macpm-sensors --json
+```
+
+It reads `AppleSMC` through the IOKit user client (read-only, no root) and
+reports the raw sensor keys present on the chip, fan RPM/min/max, and
+`PSTR`/`PPBR` power rails.  Fan **control** requires root and is not
+implemented.
+
+## Compatibility
+
+Tested on macOS 27.2 with an M3 Max.  Behaviour depends more on the chip
+generation than on the macOS version:
+
+| Environment | Status |
+|---|---|
+| macOS 12–15, M1–M4 | Works |
+| macOS 26, M1–M4 | Likely works |
+| macOS 26, M5 / M5 Pro / Max | Partial: new CPU tier/channel names (`MCPU`/`SCPU`) and `acc-clusters` DVFS data are not fully handled |
+| macOS 15/26, M1/M2 Ultra | Needs verification: multi-die complex channels may be `ECPU0/1` |
+| macOS 27 | Works on the tested M3 Max; some 27 builds restrict unprivileged `Energy Model` refreshes |
+| Intel Macs | Not supported; the Apple-Silicon IOReport groups are absent |
+
+## Standalone binaries
+
+Standalone unsigned/ad-hoc arm64 binaries (`macpm`, `macpm-sensors`) can be
+built with `packaging/build.sh` and attached to a GitHub release.  They bundle
+Python and all dependencies, so the target Mac needs no Python installation.
+
+On first launch from a browser download, macOS Gatekeeper may ask you to
+right-click → Open, or you can remove the quarantine flag:
+
+```sh
+xattr -d com.apple.quarantine ./macpm ./macpm-sensors ./macpm.command
+```
+
+See [packaging/README.txt](https://github.com/visualcjy/macpm/blob/main/packaging/README.txt) for details.
+
+## Development
+
+```sh
+git clone https://github.com/visualcjy/macpm.git
+cd macpm
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -e .
+python3 -m unittest discover -s tests -v
+```
+
+Build source and wheel distributions:
+
+```sh
+python3 -m pip install build twine
+python3 -m build
+python3 -m twine check dist/*
+```
+
+Build standalone arm64 binaries (build machine needs Python + PyInstaller +
+runtime dependencies; the output has no Python dependency):
+
+```sh
+PYTHON=python3 packaging/build.sh
+```
+
+Release steps are documented in [RELEASE.md](https://github.com/visualcjy/macpm/blob/main/RELEASE.md).
+
+## Troubleshooting
+
+- **`macpm: command not found`** — add your Python user-base `bin` directory to
+  `PATH`, or run `python3 -m macpm`.
+- **Power readings freeze on macOS 27** — some builds restrict unprivileged
+  `Energy Model` refreshes.  CPU/GPU usage and frequency still work.  Run
+  `macpm-dump` to inspect the raw values.
+- **M5/Ultra values look wrong** — CPU tier/channel mapping is not complete;
+  see the compatibility table.
+- **`macpm-sensors` shows nothing** — not every SMC key exists on every chip;
+  the reader only reports the keys that are present.
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/visualcjy/macpm/blob/main/CHANGELOG.md).  The 2.0 release removes the dependency on
+`sudo`, `powermetrics` and temporary files.
+
+## Credits
+
+- [asitop](https://github.com/tlkh/asitop) — original Python TUI this project
+  was forked from
+- [macmon](https://github.com/vladkens/macmon) and
+  [Stats](https://github.com/exelban/stats) — IOReport/SMC reference
+  implementations
+- The IOReport sample-delta and DVFS-table ideas follow those projects
+
+## License
+
+MIT.  See [LICENSE](https://github.com/visualcjy/macpm/blob/main/LICENSE).

macpm-2.0/README.md

@@ -0,0 +1,212 @@
+# macpm
+
+**Rootless performance monitoring CLI for Apple Silicon.**<br>
+macpm 2.0 reads the same hardware counters as `powermetrics`, but through
+IOReport/IOKit/SMC — no `sudo`, no password, no privileged helper.
+
+A Python-based `nvtop`-inspired terminal monitor for Apple Silicon Macs,
+forked from [asitop](https://github.com/tlkh/asitop).
+
+## Demo
+
+Default view — CPU/GPU/ANE utilisation and power, memory, disk I/O and
+network, updating once per second:
+
+![macpm default view](https://raw.githubusercontent.com/visualcjy/macpm/main/images/macpm_v.gif)
+
+Same view in another colour theme (press ← / → to cycle through them):
+
+![macpm cyan colour theme](https://raw.githubusercontent.com/visualcjy/macpm/main/images/macpm.gif)
+
+Per-core view (`--show_cores`, or press `2` while running):
+
+![macpm per-core view](https://raw.githubusercontent.com/visualcjy/macpm/main/images/v2.png)
+
+## Highlights
+
+- **No sudo required.** `macpm` runs as a normal user process.
+- CPU E/P core utilisation and frequency, plus an optional per-core view
+- GPU utilisation and frequency
+- CPU / GPU / ANE power, rolling average, peaks and throttle state
+- RAM and swap usage
+- Disk IOPS/throughput and network throughput
+- Optional temperature/fan reader (`macpm-sensors`)
+- Same terminal layout, colours, charts and key bindings as macpm 0.x
+
+## Install
+
+Requirements: **Apple Silicon Mac**, **macOS 12+**, **Python 3.9+**.
+
+```sh
+python3 -m pip install --upgrade macpm
+```
+
+Then run:
+
+```sh
+macpm
+```
+
+There is **no `sudo macpm`** in 2.0. Running it with `sudo` still works, but it
+is unnecessary and no longer recommended.
+
+Prefer a standalone binary with no Python installation? See
+[Standalone binaries](#standalone-binaries).
+
+## Usage
+
+```text
+macpm [--interval INTERVAL] [--color COLOR] [--avg AVG] [--show_cores [BOOL]] [--version]
+```
+
+| Option | Meaning |
+|---|---|
+| `--interval SECONDS` | Sampling and display interval (default `1`) |
+| `--color 1-8` | Display colour (default `2`) |
+| `--avg SECONDS` | Averaging window for power values (default `30`) |
+| `--show_cores [BOOL]` | Start in the per-core view |
+| `--version` | Print the version |
+
+Keys:
+
+```text
+q / ESC     quit
+← / →       change colour
+1 / 2       default view / per-core view
+Ctrl+R      reset peaks
+```
+
+## Colour themes
+
+Pick one with `--color N`, or press ← / → while macpm is running.  The default
+is `2` (green).
+
+| | |
+|---|---|
+| **1 — red**<br>![colour 1: red](https://raw.githubusercontent.com/visualcjy/macpm/main/images/4.png) | **2 — green (default)**<br>![colour 2: green](https://raw.githubusercontent.com/visualcjy/macpm/main/images/5.png) |
+| **3 — yellow**<br>![colour 3: yellow](https://raw.githubusercontent.com/visualcjy/macpm/main/images/6.png) | **4 — blue**<br>![colour 4: blue](https://raw.githubusercontent.com/visualcjy/macpm/main/images/7.png) |
+| **5 — magenta**<br>![colour 5: magenta](https://raw.githubusercontent.com/visualcjy/macpm/main/images/8.png) | **6 — cyan**<br>![colour 6: cyan](https://raw.githubusercontent.com/visualcjy/macpm/main/images/1.png) |
+| **7 — white**<br>![colour 7: white](https://raw.githubusercontent.com/visualcjy/macpm/main/images/2.png) | **8 — grey**<br>![colour 8: grey](https://raw.githubusercontent.com/visualcjy/macpm/main/images/3.png) |
+
+## Why no sudo?
+
+macpm 0.x called `sudo powermetrics`. In 2.0 the sampler reads the underlying
+counters directly.  The data is not secret; the old `powermetrics` CLI simply
+requires root and Apple's private entitlements.
+
+| Metric | Source |
+|---|---|
+| CPU E/P load and frequency | IOReport `CPU Stats` performance states |
+| Per-core load | IOReport `CPU Core Performance States` |
+| GPU load and frequency | IOReport `GPU Stats` / `GPU Performance States` |
+| CPU / GPU / ANE power | IOReport `Energy Model` |
+| RAM / swap | `psutil` |
+| Disk / network | `psutil` counters |
+| Thermal throttle | `pmset -g therm` |
+| SoC name / core counts | `sysctl` |
+| GPU core count | `ioreg` `gpu-core-count` |
+
+The DVFS frequency tables are parsed from the `pmgr` IORegistry node;
+M1–M3 store Hz there, M4+ store kHz.
+
+## Temperatures and fans
+
+The default TUI intentionally stays identical to macpm 0.x, which has no
+temperature/fan panel.  The standalone SMC reader is available as:
+
+```sh
+macpm-sensors
+macpm-sensors --json
+```
+
+It reads `AppleSMC` through the IOKit user client (read-only, no root) and
+reports the raw sensor keys present on the chip, fan RPM/min/max, and
+`PSTR`/`PPBR` power rails.  Fan **control** requires root and is not
+implemented.
+
+## Compatibility
+
+Tested on macOS 27.2 with an M3 Max.  Behaviour depends more on the chip
+generation than on the macOS version:
+
+| Environment | Status |
+|---|---|
+| macOS 12–15, M1–M4 | Works |
+| macOS 26, M1–M4 | Likely works |
+| macOS 26, M5 / M5 Pro / Max | Partial: new CPU tier/channel names (`MCPU`/`SCPU`) and `acc-clusters` DVFS data are not fully handled |
+| macOS 15/26, M1/M2 Ultra | Needs verification: multi-die complex channels may be `ECPU0/1` |
+| macOS 27 | Works on the tested M3 Max; some 27 builds restrict unprivileged `Energy Model` refreshes |
+| Intel Macs | Not supported; the Apple-Silicon IOReport groups are absent |
+
+## Standalone binaries
+
+Standalone unsigned/ad-hoc arm64 binaries (`macpm`, `macpm-sensors`) can be
+built with `packaging/build.sh` and attached to a GitHub release.  They bundle
+Python and all dependencies, so the target Mac needs no Python installation.
+
+On first launch from a browser download, macOS Gatekeeper may ask you to
+right-click → Open, or you can remove the quarantine flag:
+
+```sh
+xattr -d com.apple.quarantine ./macpm ./macpm-sensors ./macpm.command
+```
+
+See [packaging/README.txt](https://github.com/visualcjy/macpm/blob/main/packaging/README.txt) for details.
+
+## Development
+
+```sh
+git clone https://github.com/visualcjy/macpm.git
+cd macpm
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -e .
+python3 -m unittest discover -s tests -v
+```
+
+Build source and wheel distributions:
+
+```sh
+python3 -m pip install build twine
+python3 -m build
+python3 -m twine check dist/*
+```
+
+Build standalone arm64 binaries (build machine needs Python + PyInstaller +
+runtime dependencies; the output has no Python dependency):
+
+```sh
+PYTHON=python3 packaging/build.sh
+```
+
+Release steps are documented in [RELEASE.md](https://github.com/visualcjy/macpm/blob/main/RELEASE.md).
+
+## Troubleshooting
+
+- **`macpm: command not found`** — add your Python user-base `bin` directory to
+  `PATH`, or run `python3 -m macpm`.
+- **Power readings freeze on macOS 27** — some builds restrict unprivileged
+  `Energy Model` refreshes.  CPU/GPU usage and frequency still work.  Run
+  `macpm-dump` to inspect the raw values.
+- **M5/Ultra values look wrong** — CPU tier/channel mapping is not complete;
+  see the compatibility table.
+- **`macpm-sensors` shows nothing** — not every SMC key exists on every chip;
+  the reader only reports the keys that are present.
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/visualcjy/macpm/blob/main/CHANGELOG.md).  The 2.0 release removes the dependency on
+`sudo`, `powermetrics` and temporary files.
+
+## Credits
+
+- [asitop](https://github.com/tlkh/asitop) — original Python TUI this project
+  was forked from
+- [macmon](https://github.com/vladkens/macmon) and
+  [Stats](https://github.com/exelban/stats) — IOReport/SMC reference
+  implementations
+- The IOReport sample-delta and DVFS-table ideas follow those projects
+
+## License
+
+MIT.  See [LICENSE](https://github.com/visualcjy/macpm/blob/main/LICENSE).

macpm-2.0/RELEASE.md

@@ -0,0 +1,102 @@
+# Releasing macpm 2.0
+
+This checklist prepares a GitHub tag and a PyPI upload.  It does not push or
+publish anything by itself.
+
+## 1. Preconditions
+
+- macOS Apple Silicon, Python 3.9+.
+- Clean working tree (`git status`), all tests passing.
+- Version is `2.0` in:
+  - `setup.py`
+  - `macpm/__init__.py`
+  - `macpm/macpm.py` (`version = 'macpm v2.0'`)
+- `CHANGELOG.md` has the 2.0 entry.
+
+## 2. Test from source
+
+```sh
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -e .
+python3 -m unittest discover -s tests -v
+
+macpm --help
+macpm-dump           # one sample per second, Ctrl+C to stop
+macpm-sensors        # temperatures/fans, optional
+```
+
+## 3. Build and validate PyPI artifacts
+
+```sh
+python3 -m pip install --upgrade build twine
+rm -rf dist build *.egg-info
+python3 -m build
+python3 -m twine check dist/*
+```
+
+Test the wheel in a **clean** venv (this is the real "no source tree" test):
+
+```sh
+python3 -m venv /tmp/macpm-wheel-test
+/tmp/macpm-wheel-test/bin/pip install dist/macpm-2.0-py3-none-any.whl
+/tmp/macpm-wheel-test/bin/macpm --help
+/tmp/macpm-wheel-test/bin/macpm-dump   # Ctrl+C
+```
+
+## 4. Publish to PyPI
+
+Preferred: configure PyPI Trusted Publishing for this repository and the
+`pypi` environment, then run the `Release` GitHub workflow on tag `v2.0`.
+
+Manual alternative:
+
+```sh
+# requires a PyPI API token in ~/.pypirc or TWINE_PASSWORD
+python3 -m twine upload dist/macpm-2.0.tar.gz dist/macpm-2.0-py3-none-any.whl
+```
+
+Then verify:
+
+```sh
+python3 -m pip install --upgrade macpm==2.0
+macpm --version
+```
+
+## 5. Publish to GitHub
+
+```sh
+git add setup.py pyproject.toml MANIFEST.in README.md CHANGELOG.md RELEASE.md \
+        macpm packaging tests .github bin
+git commit -m "Release macpm 2.0: rootless IOReport sampler"
+git tag -a v2.0 -m "macpm 2.0"
+git push origin main
+git push origin v2.0
+```
+
+The `Release` workflow builds the sdist/wheel, checks metadata and attaches
+the artifacts to a GitHub release.  The PyPI job is opt-in: set the repository
+variable `PUBLISH_PYPI=true` (Settings → Secrets and variables → Actions →
+Variables) to publish to PyPI via trusted publishing.  Leaving it unset keeps
+tag pushes to a GitHub release only.
+If you prefer a manual release, create one from the tag and upload
+`dist/*.whl`, `dist/*.tar.gz` and the standalone tarball.
+
+## 6. Standalone arm64 binaries (optional)
+
+On an Apple Silicon build machine:
+
+```sh
+PYTHON=python3 packaging/build.sh
+```
+
+This produces:
+
+```text
+dist/macpm-2.0-macos-arm64.tar.gz
+```
+
+Attach it to the GitHub release.  The binaries are ad-hoc signed, not
+notarized; see `packaging/README.txt` for the Gatekeeper note.  To notarize,
+pass `CODESIGN_ID` to the build script and submit/staple the archive with
+`notarytool`.

macpm-2.0/macpm/__init__.py

@@ -0,0 +1,3 @@
+"""macpm: rootless performance monitor for Apple Silicon."""
+
+__version__ = "2.0"

macpm-2.0/macpm/__main__.py

@@ -0,0 +1,3 @@
+from .macpm import main
+
+main()

macpm-2.0/macpm/dump.py

@@ -0,0 +1,21 @@
+"""Print rootless samples as JSON (debug helper, not part of the TUI)."""
+
+import json
+import time
+
+from .sampler import Sampler
+
+
+def main() -> None:
+    sampler = Sampler(1)
+    sampler.prime()
+    try:
+        for _ in range(3):
+            time.sleep(1)
+            print(json.dumps(sampler.sample(), indent=2, default=str))
+    finally:
+        sampler.close()
+
+
+if __name__ == "__main__":
+    main()