mini-eq 0.1.1__tar.gz

mini_eq-0.1.1/AGENTS.md

@@ -0,0 +1,108 @@
+# Agent Guide
+
+These notes apply to the whole repository.
+
+## Project Context
+
+Mini EQ is a small system-wide parametric equalizer for PipeWire desktops. It
+uses GTK/Libadwaita for the UI, WirePlumber for routing and default-output
+monitoring, PipeWire filter-chain with builtin biquad filters for DSP, and the
+PipeWire JACK compatibility layer plus NumPy for spectrum analysis.
+
+This is a public-facing repository. Treat every committed file, screenshot,
+artifact, and log snippet as public. Keep user-facing documentation focused on
+using the app, and keep maintainer-only process notes in this file or under
+`docs/`.
+
+## Code Map
+
+- `src/mini_eq/core.py`: EQ data models, preset JSON, biquad math, APO import.
+- `src/mini_eq/filter_chain.py`: PipeWire filter-chain config generation.
+- `src/mini_eq/wireplumber_backend.py`: WirePlumber GI compatibility layer.
+- `src/mini_eq/wireplumber_stream_router.py`: stream routing helpers.
+- `src/mini_eq/routing.py`: system-wide EQ lifecycle and routing controller.
+- `src/mini_eq/app.py` and `src/mini_eq/window*.py`: GTK/Libadwaita app and UI.
+- `src/mini_eq/analyzer.py`: JACK/NumPy analyzer runtime.
+- `src/mini_eq/screenshot.py` and `tools/render_demo_screenshot.py`: maintainer
+  screenshot tooling, not user-facing CLI.
+- `data/`: desktop and AppStream metadata.
+- `io.github.bhack.mini-eq.json`: Flatpak manifest.
+- `tests/`: pytest suite for core behavior and non-visual integration seams.
+
+## Development Commands
+
+Use the repo virtualenv when it exists:
+
+```bash
+.venv/bin/python -m ruff check .
+.venv/bin/python -m ruff format --check .
+.venv/bin/python -m pytest -q
+```
+
+For release/package checks:
+
+```bash
+appstreamcli validate --no-net data/io.github.bhack.mini-eq.metainfo.xml
+desktop-file-validate data/io.github.bhack.mini-eq.desktop
+.venv/bin/python -m build
+.venv/bin/python -m twine check dist/*
+```
+
+The app depends on system GI/audio packages that Python packaging cannot
+install: GTK4, Libadwaita, WirePlumber introspection, PipeWire, and PipeWire
+JACK compatibility. Some tests skip automatically when optional runtime tools
+are unavailable.
+
+## Change Guidelines
+
+- Prefer existing patterns and small, targeted patches.
+- Do not move logic between the large modules just to tidy them; split modules
+  only when the user asked for that refactor or the change needs it.
+- Keep WirePlumber 0.4 and 0.5 compatibility in mind. Do not use a newer GI API
+  without checking the compatibility layer and tests.
+- Keep the `mini-eq` CLI user-oriented. Maintainer automation belongs in
+  `tools/`, `docs/`, or this file.
+- If you add packaged files, update `MANIFEST.in` when they must appear in the
+  source distribution.
+- Do not add generated build outputs, local config, cache directories, or
+  machine-specific files.
+
+## Screenshot Rules
+
+The README should show the public screenshot, not instructions for generating
+release assets.
+
+Generate the public release screenshot with deterministic demo data:
+
+```bash
+PYTHONPATH=src python3 tools/render_demo_screenshot.py docs/screenshots/mini-eq.png
+```
+
+Do not commit screenshots that show personal device names, Bluetooth device
+names, usernames, hostnames, local paths, or private preset names. Prefer
+`tools/render_demo_screenshot.py` over desktop screenshots because it renders
+only the Mini EQ window from deterministic demo data.
+
+## Release And Security
+
+Use `docs/release.md` as the release checklist. Before publishing release
+artifacts or changing repository/package visibility, verify the rendered README,
+package URLs, issue tracker, license, screenshots, and AppStream metadata.
+
+Before publishing artifacts or changing repository visibility, run a focused
+leak scan:
+
+```bash
+git rev-list --count HEAD
+git ls-remote --heads origin
+git ls-remote --tags origin
+leak_pattern='(/home/|/Users/|secret|token|api[_-]?key|github_pat|BEGIN (RSA|OPENSSH|PRIVATE) KEY)'
+git grep -n -I -E "$leak_pattern" HEAD -- . \
+  ':(exclude)*.png' \
+  ':(exclude)AGENTS.md' \
+  ':(exclude)docs/release.md'
+```
+
+Do not push local scratch branches or local safety tags.
+Do not rewrite public history unless the user explicitly asks for it and accepts
+the impact.

mini_eq-0.1.1/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.1 - 2026-04-27
+
+- Fix PyPI classifier metadata for package-index publishing.
+- Add production PyPI publishing automation using trusted publishing.
+
+## 0.1.0 - 2026-04-26
+
+- Initial standalone Mini EQ source package.
+- GTK/Libadwaita system-wide parametric equalizer UI.
+- PipeWire filter-chain builtin biquad processing through WirePlumber.
+- Output routing, default-output following, preset import/export, and analyzer support.
+- Runtime dependency diagnostics through `mini-eq --check-deps`.