docker-orb 1.0.0__py3-none-any.whl

docker_orb/wizard/wizard.tcss

@@ -0,0 +1,329 @@
+/* ── Overall layout ──────────────────────────────────────────────────────── */
+
+Screen {
+    background: $surface;
+}
+
+#wizard-title {
+    text-align: center;
+    text-style: bold;
+    color: $accent;
+    background: $panel;
+    padding: 1 0;
+    border-bottom: solid $accent;
+}
+
+#wizard-footer {
+    text-align: center;
+    color: $text-muted;
+    background: $panel;
+    padding: 0 1;
+    border-top: solid $panel-lighten-2;
+}
+
+TabbedContent {
+    height: 1fr;
+}
+
+TabPane {
+    padding: 1 2;
+    height: 1fr;
+    layout: vertical;
+}
+
+#targets-scroll, #strings-scroll, #options-scroll {
+    height: 1fr;
+}
+
+/* ── Section headers ─────────────────────────────────────────────────────── */
+
+.section-title {
+    text-style: bold;
+    color: $accent;
+    padding: 1 0 1 2;
+    border-left: outer $accent;
+    background: $panel;
+    margin-top: 1;
+    margin-bottom: 1;
+}
+
+/* ── Labels and hints ────────────────────────────────────────────────────── */
+
+.field-label {
+    color: $text-muted;
+    margin-bottom: 0;
+    padding-left: 1;
+}
+
+.field-hint {
+    color: $text-muted;
+    padding-left: 1;
+    margin-bottom: 1;
+}
+
+.field-warn {
+    color: $warning;
+    padding-left: 1;
+    margin: 1 0;
+}
+
+/* ── Rules ───────────────────────────────────────────────────────────────── */
+
+Rule {
+    margin: 1 0;
+    color: $panel-lighten-2;
+}
+
+/* ── Rows ────────────────────────────────────────────────────────────────── */
+
+.row {
+    height: auto;
+    margin-bottom: 1;
+}
+
+.row Button {
+    margin-right: 1;
+}
+
+/* ── Inputs — bright border to stand out ─────────────────────────────────── */
+
+Input {
+    background: $panel;
+    border: tall $primary-lighten-2;
+    margin-bottom: 1;
+}
+
+Input:focus {
+    border: tall $accent;
+}
+
+/* ── Select ──────────────────────────────────────────────────────────────── */
+
+Select {
+    margin-bottom: 1;
+    width: auto;
+    max-width: 60;
+}
+
+/* Namespace select sits in a row with a button — let it grow to fill */
+#ns-select {
+    width: 1fr;
+    max-width: 60;
+    margin-bottom: 0;
+}
+
+Select > SelectCurrent {
+    background: $panel;
+    border: tall $primary-lighten-2;
+}
+
+Select:focus > SelectCurrent {
+    border: tall $accent;
+}
+
+/* ── Namespace ───────────────────────────────────────────────────────────── */
+
+#ns-select {
+    margin-bottom: 0;
+}
+
+#ns-input {
+    width: 1fr;
+    max-width: 60;
+    margin-bottom: 0;
+}
+
+
+/* ── Saved config select ─────────────────────────────────────────────────── */
+
+#cfg-select {
+    width: 1fr;
+}
+
+/* ── Deployment list ─────────────────────────────────────────────────────── */
+
+.btn-small {
+    min-width: 12;
+}
+
+#dep-scroll {
+    height: 7;
+    width: 64;
+    background: $panel;
+    border: tall $primary-lighten-2;
+    margin-bottom: 0;
+    scrollbar-size-vertical: 2;
+    scrollbar-color: $accent;
+    scrollbar-color-hover: $accent-lighten-1;
+    scrollbar-background: $panel-darken-1;
+}
+
+#dep-checks {
+    height: auto;
+}
+
+/* ── Checkboxes ──────────────────────────────────────────────────────────── */
+
+Checkbox {
+    height: auto;
+    margin: 0;
+    padding: 0 1;
+    background: transparent;
+    border: none;
+}
+
+Checkbox > .toggle--button {
+    color: $panel;
+    background: $panel-darken-1;
+}
+
+Checkbox.-on > .toggle--button {
+    color: $text;
+    background: $success;
+    text-style: bold;
+}
+
+Checkbox:focus {
+    background: $panel-lighten-1;
+}
+
+Checkbox:hover {
+    background: $panel-lighten-1;
+}
+
+/* ── RadioSet ────────────────────────────────────────────────────────────── */
+
+RadioSet {
+    background: $panel;
+    border: tall $primary-lighten-2;
+    padding: 0 1;
+    height: auto;
+    width: 48;
+    margin-bottom: 1;
+}
+
+RadioButton {
+    background: transparent;
+}
+
+/* ── Dump options ────────────────────────────────────────────────────────── */
+
+#dump-opts {
+    padding: 0 0 0 2;
+    margin-top: 0;
+    margin-bottom: 1;
+    height: auto;
+}
+
+#dump-tail, #dump-since {
+    width: 24;
+}
+
+/* ── Stream options ───────────────────────────────────────────────────────── */
+
+#stream-opts {
+    padding: 0 0 0 2;
+    margin-top: 0;
+    margin-bottom: 1;
+    height: auto;
+}
+
+#stream-since {
+    width: 40;
+}
+
+/* ── Patterns edit row ───────────────────────────────────────────────────── */
+
+#patterns-edit-row {
+    align: left middle;
+    height: auto;
+    margin-bottom: 0;
+}
+
+#patterns-file-hint {
+    width: 1fr;
+    margin-bottom: 0;
+    padding-left: 1;
+    color: $text-muted;
+}
+
+/* ── String check lists ──────────────────────────────────────────────────── */
+
+#filter-scroll, #hl-scroll, #mon-scroll {
+    height: 7;
+    width: 64;
+    background: $panel;
+    border: tall $primary-lighten-2;
+    margin-bottom: 0;
+    scrollbar-size-vertical: 2;
+    scrollbar-color: $accent;
+    scrollbar-color-hover: $accent-lighten-1;
+    scrollbar-background: $panel-darken-1;
+}
+
+#filter-checks, #hl-checks, #mon-checks {
+    height: auto;
+}
+
+/* Dim label above saved list to distinguish from the "Add new" input below */
+.saved-label {
+    color: $text-muted;
+    padding-left: 1;
+}
+
+/* Accent the "Add new" label so it reads as a distinct action area */
+.new-label {
+    color: $accent;
+    padding-left: 1;
+    margin-top: 1;
+}
+
+.option-row {
+    height: auto;
+    margin-top: 0;
+    margin-bottom: 1;
+}
+
+.option-row Checkbox {
+    width: 1fr;
+}
+
+/* ── Health options ──────────────────────────────────────────────────────── */
+
+#health-opts {
+    padding: 0 0 0 2;
+    height: auto;
+    margin-top: 0;
+    margin-left: 0;
+}
+
+#health-interval {
+    width: 16;
+}
+
+#health-section, #monitor-section {
+    height: auto;
+}
+
+/* ── Options tab ─────────────────────────────────────────────────────────── */
+
+#save-name {
+    margin-bottom: 0;
+}
+
+.nav-row {
+    margin-top: 1;
+    height: auto;
+}
+
+.btn-cancel {
+    width: 1fr;
+}
+
+.btn-back {
+    width: 1fr;
+}
+
+.btn-next {
+    width: 3fr;
+}

docker_orb-1.0.0.dist-info/METADATA

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: docker-orb
+Version: 1.0.0
+Summary: Interactive terminal UI for streaming and filtering Docker Compose container logs across multiple services
+Project-URL: Homepage, https://github.com/adlidev/docker-orb
+Project-URL: Repository, https://github.com/adlidev/docker-orb
+Project-URL: Documentation, https://github.com/adlidev/docker-orb/blob/main/docs/USER_GUIDE.md
+Project-URL: Issues, https://github.com/adlidev/docker-orb/issues
+Author-email: Adli Waziri <boulderadli@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Adli Waziri
+        
+        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.
+License-File: LICENSE
+Keywords: compose,devops,docker,docker-compose,logs,observability,sre,textual,tui
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: textual>=0.61.0
+Description-Content-Type: text/markdown
+
+# docker-orb
+
+Watching logs across a multi-container Compose stack usually means juggling
+multiple `docker compose logs` windows and grepping after the fact, or
+writing complex regex just to add a couple of filters. docker-orb streams
+logs from every container in your selected services into one merged,
+colorized view — and lets you filter, highlight, and search *while it's
+streaming*.
+
+Built with [Textual](https://textual.textualize.io/), docker-orb is a full
+terminal UI: an interactive setup wizard walks you through picking a
+project, services, and filter patterns — no flags required — or skip
+straight to the viewer with CLI arguments if you prefer. Save named session
+configs to reload your exact setup later; passively collect rare events in
+a monitor panel without losing your scroll position; get alerted when
+containers restart or go unhealthy; and add or remove services from the
+live stream without restarting.
+
+![docker-orb viewer](docs/screenshot-viewer.png)
+
+## Features
+
+- **Multi-container live tail** — stream logs from any number of
+  containers/services at once, each with a distinct color.
+- **Filters** — hide lines matching a pattern, live-editable mid-session.
+- **Highlights** — emphasize lines matching a pattern without hiding anything else.
+- **Monitors** — passively collect matching lines into a separate panel so you
+  can watch for rare events (e.g. `job failed`) without losing your scroll
+  position in the main stream.
+- **Live search** — search the whole buffered session, jump to a result, and
+  keep streaming.
+- **Container health panel** — flags containers that aren't `Running` or have
+  crossed a restart threshold; restart a container or recreate a service from
+  inside the app.
+- **Dump mode** — fetch existing logs once (with `--tail`/`--since`) and exit,
+  for scripting or one-off inspection, instead of a live stream.
+- **Saved configs** — save a named combination of project, services, and
+  patterns, and reload it later by name.
+- **JSON log formatting** — auto-detects structured JSON log lines and shows
+  `time  LEVEL  message  key=value ...` instead of a raw JSON blob, with a
+  toggle back to raw and a detail view (Enter on a clicked line) for the full
+  pretty-printed object.
+- **Collapse repeated lines** — journalctl-style: consecutive identical lines
+  from the same container fold into a single "last line repeated N times"
+  marker, toggleable, so a crash-looping container doesn't flood the stream.
+
+## Installation
+
+Requires Python 3.10+, and `docker` with the Compose v2 plugin on your
+`PATH` (i.e. `docker compose` works). docker-orb shells out to your existing
+`docker` CLI and inherits its context/auth — no separate credentials or
+Docker SDK involved.
+
+```bash
+# Recommended — pipx keeps CLI tools in isolated environments. Not on PyPI
+# yet, so install straight from GitHub:
+pipx install git+https://github.com/adlidev/docker-orb
+
+# Or with plain pip, inside your own venv:
+git clone https://github.com/adlidev/docker-orb.git
+cd docker-orb
+pip install -e .
+```
+
+This installs two commands: `docker-orb` and `docker-orb-inject` (a small
+test utility for injecting fake log lines into a running container — see
+the [User Guide](docs/USER_GUIDE.md#docker-orb-inject)).
+
+**For development / contributing:**
+
+```bash
+git clone https://github.com/adlidev/docker-orb.git
+cd docker-orb
+pip install -e . --group dev
+```
+
+## Quick start
+
+```bash
+# No arguments — launches the interactive setup wizard
+docker-orb
+
+# Skip the wizard: watch two services live
+docker-orb -n myapp -p api -p worker
+
+# Watch every service in a project
+docker-orb -n myapp --all-containers
+
+# One-shot dump instead of a live stream
+docker-orb -n myapp --dump --tail 500
+
+# Pre-filter/highlight from the command line
+docker-orb -n myapp -p worker -f DEBUG -H ERROR --health
+```
+
+`-n/--project` takes the Compose project name (what `docker compose -p`
+expects — usually the directory name your `docker-compose.yml` lives in,
+unless overridden by a top-level `name:` key or `COMPOSE_PROJECT_NAME`). If
+omitted, docker-orb resolves it the same way `docker compose` does for the
+current directory.
+
+Once you're in the viewer, press `F` / `H` / `M` to edit filters, highlights,
+or monitors live, `/` to search, `P` to add/remove streamed services, and
+`Space` to pause. See the [User Guide](docs/USER_GUIDE.md) for the full
+keybinding reference and pattern syntax.
+
+## Development
+
+```bash
+pip install -e . --group dev
+pytest                    # run the test suite
+textual run --dev src/docker_orb/__main__.py   # live-reload dev mode
+```
+
+A local Compose stack with 8 fake log-generating services is included for
+manual testing:
+
+```bash
+cd infra
+make up
+docker-orb -n logviewer-demo --all-containers --health
+```
+
+See [`infra/README.md`](infra/README.md) for the service list and good
+filter/monitor test patterns, and [`CLAUDE.md`](CLAUDE.md) for architecture
+notes.
+
+## Relationship to kube-orb
+
+docker-orb is a sibling project to [kube-orb](https://github.com/adlidev/kube-orb),
+Adli's Kubernetes-flavored log viewer. They share a UI architecture (Textual
+viewer, wizard, filters/highlights/monitors, JSON formatting) but each talks
+to its own backend directly — docker-orb shells out to `docker`/`docker
+compose`, kube-orb shells out to `kubectl` — and they're maintained as
+independent tools rather than one project trying to do both.
+
+## License
+
+[MIT License](LICENSE)

docker_orb-1.0.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+docker_orb/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+docker_orb/__main__.py,sha256=yq_aInmV6HCZN0Hl1TpmfBSErrRJNtSisb8tTfqi_8E,140
+docker_orb/_scrollbar.py,sha256=U_1BiB70LJMpWXQnlkj25AAzNKEe5kqtzWoZhmYK34s,5344
+docker_orb/cli.py,sha256=mEYpwLVNoKAW-LtYnhm3eu57nNA_reLizZJ1t0AHJJ8,7390
+docker_orb/colors.py,sha256=Ufe21cwg3nToiILeTshU5g1FWjfYkIT6cQmzvGa_3n4,2109
+docker_orb/compose.py,sha256=8ClUrO632V4N2_uIfZRSgHhUKFTo671_NTxqEeDD2eg,14659
+docker_orb/config.py,sha256=V6DZOapozTvC4n0PQXcko9uennzeEwq1ehV0mrtlnNg,8766
+docker_orb/inject.py,sha256=or0M8_hy_pDChCfK_zlT10kZcBys6pmkvTjzO-1O2X4,5714
+docker_orb/jsonlog.py,sha256=134VJrKseHksLKD2_yNxisYFcrPuRdE9lTydaAsc_2Q,4627
+docker_orb/models.py,sha256=qxrd8Y7nMKzWT60nkjB6liiplpZT9xi8wRZT7rAJW3M,4807
+docker_orb/viewer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+docker_orb/viewer/app.py,sha256=8rXamUBqDEFOqrFsAMxNDWa9pjIIOWrhNULBAIgArX0,37356
+docker_orb/viewer/viewer.tcss,sha256=D87cfT-3ilimIysNurvlmTPPGb02DvxPelmC4OEkcf0,4554
+docker_orb/viewer/widgets.py,sha256=4CXxlm7mO5dq7qUfx3VyAKdxJ-xXl3ydmjKwzgH7ruM,23322
+docker_orb/viewer/panels/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+docker_orb/viewer/panels/health.py,sha256=oB_jPVP5KskTfOUQB6TX_x2SdswagZkk0rFZJBu7Zhs,8897
+docker_orb/viewer/panels/main_stream.py,sha256=Lz2Vno9Ac9i7sRH07mmITVD_kEibS_cYFAvg9m1tir8,15740
+docker_orb/viewer/panels/monitor.py,sha256=2S5gWReXC5lK1djRDGcrIgYpoTD8eVY-PRCqMV2xS38,7990
+docker_orb/viewer/panels/search.py,sha256=0pRqLmAoTtgawAfQNBkWqNEqsxbVScA-YeWRMY2VMK8,6192
+docker_orb/wizard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+docker_orb/wizard/app.py,sha256=XPqo74kjz7VWevCKW3jKfFVWjXQz48vIBnUsKcCkrD0,986
+docker_orb/wizard/screens.py,sha256=n4ss7YvLGRHM7Ft779faQy7AXQy_Ofwfop4GlSMp37s,32838
+docker_orb/wizard/wizard.tcss,sha256=i7tRSWti7Vqjdmp6azmC2AMkdQRsjoyCBRRPfxeGVGs,7908
+docker_orb-1.0.0.dist-info/METADATA,sha256=UfdiGXQjfQKE37hoyV8kvGd66dVgOhpdp-XT8cJn83s,8144
+docker_orb-1.0.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+docker_orb-1.0.0.dist-info/entry_points.txt,sha256=KxDwYM0UTmOb9mhhvQbhc9cOMofb0vJkZ3yPRe9hNmA,94
+docker_orb-1.0.0.dist-info/licenses/LICENSE,sha256=zVfZOlwrrTMcNn4XNJED1CoLkon34cOGUn6R-mtqf04,1068
+docker_orb-1.0.0.dist-info/RECORD,,

docker_orb-1.0.0.dist-info/WHEEL

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

docker_orb-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+docker-orb = docker_orb.cli:main
+docker-orb-inject = docker_orb.inject:main

docker_orb-1.0.0.dist-info/licenses/LICENSE

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