magpy-lite 0.1.0__py3-none-any.whl

magpy_lite/__init__.py

@@ -0,0 +1,10 @@
+"""Terminal interface for the bioamla bioacoustics toolkit"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("magpy-lite")
+except PackageNotFoundError:  # running from a source tree without an install
+    __version__ = "0.0.0"
+
+__all__ = ["__version__"]

magpy_lite/__main__.py

@@ -0,0 +1,5 @@
+"""Allow ``python -m magpy_lite``."""
+
+from magpy_lite.app import main
+
+main()

magpy_lite/app.py

@@ -0,0 +1,85 @@
+"""The magpy-lite Textual application.
+
+For 0.1.0 this is a placeholder: a single screen announcing the project.
+Real screens arrive as magpy and bioamla settle.
+"""
+
+from __future__ import annotations
+
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Center, Middle, Vertical
+from textual.widgets import Footer, Label, Static
+
+from magpy_lite import __version__
+
+TAGLINE = "A terminal interface for the bioamla bioacoustics toolkit"
+
+PLANNED = (
+    "Browse and inspect recordings",
+    "Run acoustic indices and event detection",
+    "Batch-process directories of audio",
+    "Query species catalogs",
+)
+
+
+class ComingSoon(Static):
+    """The one panel on the 0.1.0 screen."""
+
+    DEFAULT_CSS = """
+    ComingSoon {
+        width: auto;
+        height: auto;
+        padding: 1 4;
+        border: round $primary;
+    }
+    ComingSoon > Vertical {
+        width: auto;
+        height: auto;
+    }
+    ComingSoon .title {
+        text-style: bold;
+        color: $primary;
+    }
+    ComingSoon .tagline {
+        margin-bottom: 1;
+    }
+    ComingSoon .status {
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    ComingSoon .planned {
+        color: $text-muted;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label(f"magpy-lite {__version__}", classes="title")
+            yield Label(TAGLINE, classes="tagline")
+            yield Label("Coming soon.", classes="status")
+            yield Label("Planned:", classes="planned")
+            for item in PLANNED:
+                yield Label(f"  • {item}", classes="planned")
+
+
+class MagpyLiteApp(App[None]):
+    """Top-level app. Press q to quit."""
+
+    TITLE = "magpy-lite"
+    SUB_TITLE = "coming soon"
+    BINDINGS = [Binding("q", "quit", "Quit")]
+
+    def compose(self) -> ComposeResult:
+        with Middle(), Center():
+            yield ComingSoon()
+        yield Footer()
+
+
+def main() -> None:
+    """Console-script entry point (``magpy-lite``)."""
+    MagpyLiteApp().run()
+
+
+if __name__ == "__main__":
+    main()

magpy_lite-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.5
+Name: magpy-lite
+Version: 0.1.0
+Summary: Terminal interface for the bioamla bioacoustics toolkit
+Project-URL: Homepage, https://github.com/jmcmeen/magpy-lite
+Project-URL: Source, https://github.com/jmcmeen/magpy-lite
+Project-URL: Changelog, https://github.com/jmcmeen/magpy-lite/blob/main/CHANGELOG.md
+Project-URL: Bug Tracker, https://github.com/jmcmeen/magpy-lite/issues
+Author-email: John McMeen <johnmcmeen@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: audio,bioacoustics,bioamla,terminal,textual,tui
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+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: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: textual>=3.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff<0.18,>=0.17; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# magpy-lite
+
+[![PyPI version](https://img.shields.io/pypi/v/magpy-lite.svg)](https://pypi.org/project/magpy-lite/)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/jmcmeen/magpy-lite/blob/main/LICENSE)
+[![CI](https://github.com/jmcmeen/magpy-lite/actions/workflows/ci.yml/badge.svg)](https://github.com/jmcmeen/magpy-lite/actions/workflows/ci.yml)
+
+A terminal interface for the [bioamla](https://github.com/jmcmeen/bioamla)
+bioacoustics toolkit, built with [Textual](https://textual.textualize.io/).
+It is the keyboard-driven, runs-over-SSH sibling of
+[MagPy](https://github.com/jmcmeen/magpy), the desktop GUI.
+
+> **Status: coming soon.** 0.1.0 is a placeholder release that claims the name
+> and ships a single announcement screen. Features will be planned as magpy and
+> bioamla mature.
+
+## Install
+
+```sh
+pip install magpy-lite
+magpy-lite            # or: python -m magpy_lite
+```
+
+Press `q` to quit.
+
+## Roadmap
+
+Nothing here is committed yet. Likely first screens, in rough order:
+
+- Browse and inspect recordings
+- Run acoustic indices and event detection
+- Batch-process directories of audio
+- Query species catalogs
+
+The division of labour follows MagPy: bioamla owns the bioacoustics domain,
+magpy-lite owns only the terminal UI and the state a functional library can't
+hold. Domain functionality goes into bioamla, not here.
+
+## Development
+
+```sh
+make install   # create .venv with dev tooling
+make run       # launch the TUI
+make check     # lint, format check, tests
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

magpy_lite-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+magpy_lite/__init__.py,sha256=AC-05M0ry6nZVkDSTlhW_5V5uKCBtDLec71lFunuKd0,301
+magpy_lite/__main__.py,sha256=_y0u0YZqhMtGk1qLIWJWsXlwlBWrPWZKmq_M5szGCMo,79
+magpy_lite/app.py,sha256=cUUfyclMIWcVmM5pR8Uo8tELYCbpd3m4cwNulsjAQpU,2095
+magpy_lite-0.1.0.dist-info/METADATA,sha256=nRmuI8g0RcjScE-TsnFePz2Jh3a60Ny-m5GxsU2c4EY,3043
+magpy_lite-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+magpy_lite-0.1.0.dist-info/entry_points.txt,sha256=iTjm0jGNmPXqmMO02TqJ97xCZRejTz08xDMCZZZXojw,51
+magpy_lite-0.1.0.dist-info/licenses/LICENSE,sha256=qzmCAeakObqZTPFNxWt_xwcfdG7J_3DWvuq_M9UnjFI,1068
+magpy_lite-0.1.0.dist-info/RECORD,,

magpy_lite-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

magpy_lite-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+magpy-lite = magpy_lite.app:main

magpy_lite-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John McMeen
+
+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.