limascope 0.0.1__tar.gz

limascope-0.0.1/.gitignore

@@ -0,0 +1,11 @@
+/limascope
+/demos/
+.DS_Store
+/limatop
+/cmd/limatop/limatop
+.venv/
+dist/
+__pycache__/
+.pytest_cache/
+snapshot_report.html
+*.cast

limascope-0.0.1/LICENSE

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

limascope-0.0.1/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.5
+Name: limascope
+Version: 0.0.1
+Summary: An OrbStack-style terminal app for Docker on Lima and Colima VMs
+Project-URL: Homepage, https://github.com/bcivitcioglu/limascope
+Project-URL: Issues, https://github.com/bcivitcioglu/limascope/issues
+Author: Burak Civitcioglu
+License-Expression: MIT
+License-File: LICENSE
+Keywords: colima,containers,docker,lima,textual,tui
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.11
+Requires-Dist: textual<9,>=8.2.8
+Description-Content-Type: text/markdown
+
+# limascope
+
+An OrbStack-style terminal app for Docker on [Lima](https://lima-vm.io/) and Colima VMs.
+
+**Pre-alpha.** This early release reserves the name and lists your Lima instances. The full app (compose groups, live stats, logs, actions, command palette) is in active development at https://github.com/bcivitcioglu/limascope.
+
+```sh
+uvx limascope
+```

limascope-0.0.1/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "limascope"
+version = "0.0.1"
+description = "An OrbStack-style terminal app for Docker on Lima and Colima VMs"
+readme = { text = "# limascope\n\nAn OrbStack-style terminal app for Docker on [Lima](https://lima-vm.io/) and Colima VMs.\n\n**Pre-alpha.** This early release reserves the name and lists your Lima instances. The full app (compose groups, live stats, logs, actions, command palette) is in active development at https://github.com/bcivitcioglu/limascope.\n\n```sh\nuvx limascope\n```\n", content-type = "text/markdown" }
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Burak Civitcioglu" }]
+requires-python = ">=3.11"
+dependencies = ["textual>=8.2.8,<9"]
+keywords = ["docker", "lima", "colima", "tui", "textual", "containers"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Systems Administration",
+]
+
+[project.urls]
+Homepage = "https://github.com/bcivitcioglu/limascope"
+Issues = "https://github.com/bcivitcioglu/limascope/issues"
+
+[project.scripts]
+limascope = "limascope.cli:main"
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/limascope"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/limascope", "LICENSE", "pyproject.toml"]
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.24"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

limascope-0.0.1/src/limascope/__init__.py

@@ -0,0 +1,8 @@
+"""limascope: an OrbStack-style terminal app for Docker on Lima VMs."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("limascope")
+except PackageNotFoundError:  # running from a source tree without install
+    __version__ = "0.0.0+local"

limascope-0.0.1/src/limascope/__main__.py

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

limascope-0.0.1/src/limascope/app.py

@@ -0,0 +1,54 @@
+"""Pre-alpha skeleton: lists Lima instances. The full app is under construction."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+
+from textual.app import App, ComposeResult
+from textual.widgets import DataTable, Footer, Header
+
+
+async def list_instances() -> list[dict]:
+    try:
+        proc = await asyncio.create_subprocess_exec(
+            "limactl", "list", "--format", "json",
+            stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.DEVNULL,
+        )
+    except FileNotFoundError:
+        return []
+    out, _ = await proc.communicate()
+    return [json.loads(line) for line in out.decode().splitlines() if line.strip()]
+
+
+class LimascopeApp(App):
+    TITLE = "limascope"
+    SUB_TITLE = "pre-alpha"
+    BINDINGS = [("q", "quit", "Quit"), ("r", "refresh", "Refresh")]
+
+    def compose(self) -> ComposeResult:
+        yield Header()
+        yield DataTable(cursor_type="row", zebra_stripes=True)
+        yield Footer()
+
+    async def on_mount(self) -> None:
+        self.query_one(DataTable).add_columns("", "NAME", "STATUS", "TYPE", "CPUS", "MEMORY", "DISK")
+        await self.action_refresh()
+
+    async def action_refresh(self) -> None:
+        table = self.query_one(DataTable)
+        table.clear()
+        instances = await list_instances()
+        if not instances:
+            self.notify("no Lima instances found (is limactl installed?)", severity="warning")
+        for vm in instances:
+            running = vm.get("status") == "Running"
+            table.add_row(
+                "●" if running else "○",
+                vm.get("name", ""),
+                vm.get("status", ""),
+                f"{vm.get('vmType', '')}/{vm.get('arch', '')}",
+                str(vm.get("cpus", "")),
+                f"{vm.get('memory', 0) / 2**30:.1f}G",
+                f"{vm.get('disk', 0) / 2**30:.0f}G",
+            )

limascope-0.0.1/src/limascope/cli.py

@@ -0,0 +1,17 @@
+"""Command-line entry point."""
+
+from __future__ import annotations
+
+import argparse
+
+from limascope import __version__
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(prog="limascope", description=__doc__)
+    parser.add_argument("--version", action="version", version=f"limascope {__version__}")
+    parser.parse_args(argv)
+
+    from limascope.app import LimascopeApp  # deferred: keep --version instant
+
+    LimascopeApp().run()