dtop 1.0.0__tar.gz

dtop-1.0.0/LICENSE

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

dtop-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include scripts/*.sh
+recursive-include dtop *.py

dtop-1.0.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: dtop
+Version: 1.0.0
+Summary: A high-performance terminal UI for Docker container management
+Author: StakeSquid
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/StakeSquid/dtop
+Project-URL: Repository, https://github.com/StakeSquid/dtop
+Project-URL: Issues, https://github.com/StakeSquid/dtop/issues
+Keywords: docker,tui,terminal,containers,monitoring
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: docker>=6.0.0
+Provides-Extra: full
+Requires-Dist: aiohttp>=3.8.0; extra == "full"
+Dynamic: license-file
+
+# dtop - Docker Terminal UI
+
+A high-performance terminal UI for Docker container management with real-time monitoring and advanced log viewing.
+
+<img width="1611" alt="Screenshot 2025-05-24 at 6 39 12 PM" src="https://github.com/user-attachments/assets/e5697f99-fdd4-4d41-bd69-02072db5385c" />
+<img width="1611" alt="Screenshot 2025-05-24 at 6 39 21 PM" src="https://github.com/user-attachments/assets/0694304e-f256-47b5-923b-5c05ed0035b7" />
+<img width="1611" alt="Screenshot 2025-05-24 at 6 39 48 PM" src="https://github.com/user-attachments/assets/df379064-9f33-48f7-9e8b-635723df6572" />
+<img width="1611" alt="Screenshot 2025-05-24 at 6 40 01 PM" src="https://github.com/user-attachments/assets/aeb20e8e-202c-49f8-bd09-7b563964bb9e" />
+
+
+
+## Features
+
+- **Real-time Stats**: Live CPU, memory, and network monitoring with parallel stats collection
+- **Log Management**: 
+  - Advanced normalization for consistent log formatting
+  - Text search with highlighted results
+  - Powerful filtering with inclusion/exclusion support
+  - Follow mode for real-time updates
+- **Container Controls**: Start/stop, pause/unpause, restart, exec shell, force recreate
+- **Mouse Support**: Click navigation, scrolling, and menu interaction
+- **Customizable Interface**: Resizable columns with persistent configuration
+
+## Installation
+
+### One-Line Install
+
+```bash
+# Install directly from GitHub
+sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/StakeSquid/dtop/main/install.sh)"
+```
+
+### Manual Install
+
+```bash
+# 1. Clone repository
+git clone https://github.com/StakeSquid/dtop
+cd dtop
+
+# 2. Install dependency
+pip install docker
+
+# 3. Run directly
+chmod +x main.py
+./main.py
+
+# 4. Or install system-wide
+sudo mkdir -p /usr/local/bin/docker-tui
+sudo cp *.py /usr/local/bin/docker-tui/
+sudo chmod +x /usr/local/bin/docker-tui/*.py
+sudo tee /usr/local/bin/dtop > /dev/null << 'EOF'
+#!/bin/bash
+exec python3 /usr/local/bin/docker-tui/main.py "$@"
+EOF
+sudo chmod +x /usr/local/bin/dtop
+```
+
+### Uninstall
+
+```bash
+sudo rm -rf /usr/local/bin/docker-tui /usr/local/bin/dtop
+```
+
+## Quick Reference
+
+### Controls
+
+| View | Key | Action |
+|------|-----|--------|
+| **Main** | ↑/↓, Click | Navigate containers |
+| | Enter/Click | Show container menu |
+| | L | View container logs |
+| | Q | Quit |
+| **Logs** | ↑/↓, PgUp/PgDn | Scroll logs |
+| | / | Search in logs |
+| | \\ | Filter logs (grep) |
+| | F | Toggle follow mode |
+| | N | Toggle log normalization |
+| | W | Toggle line wrapping |
+| | n/N | Next/previous search hit |
+| | ESC | Clear filter or return to container list |
+
+### Container Actions
+
+- **Logs**: View detailed container logs
+- **Start/Stop**: Toggle container running state
+- **Pause/Unpause**: Temporarily pause execution
+- **Restart**: Restart the container
+- **Recreate**: Recreate container from image
+- **Exec Shell**: Open interactive shell in container
+
+## Advanced Log Filtering
+
+The log viewer supports powerful filtering with both inclusion and exclusion patterns:
+
+### Filter Syntax
+
+- **Include**: `word` or `+word` - Show only lines containing "word"
+- **Exclude**: `-word` or `!word` - Hide lines containing "word"
+- **Multiple filters**: Space-separated, all conditions must match
+- **Multi-word**: Use quotes for phrases: `"error message" -"debug"`
+
+### Examples
+
+```
+error                    # Show only lines with "error"
++error -debug           # Show lines with "error" but not "debug"
+error warning -verbose  # Show lines with "error" OR "warning", but not "verbose"
+"connection failed"     # Show lines with exact phrase
++ERROR -"DEBUG:" -INFO  # Case-sensitive: ERROR lines without DEBUG: or INFO
+```
+
+### Filter Behavior
+
+- Multiple inclusion filters work as OR (any match includes the line)
+- Exclusion filters always take precedence (any match excludes the line)
+- Press Tab to toggle case sensitivity
+- Press ESC to clear active filter
+- Press \\ to modify current filter
+
+## Configuration
+
+- Settings automatically saved to `~/.docker_tui.json`
+- Columns auto-adjust to terminal width
+- Resizable columns (drag separators with mouse)
+
+## Requirements
+
+- Python 3.8+
+- Docker daemon 
+- `docker` Python package
+- Terminal with mouse support and colors
+
+## License
+
+MIT License - See LICENSE file for details.

dtop-1.0.0/README.md

@@ -0,0 +1,136 @@
+# dtop - Docker Terminal UI
+
+A high-performance terminal UI for Docker container management with real-time monitoring and advanced log viewing.
+
+<img width="1611" alt="Screenshot 2025-05-24 at 6 39 12 PM" src="https://github.com/user-attachments/assets/e5697f99-fdd4-4d41-bd69-02072db5385c" />
+<img width="1611" alt="Screenshot 2025-05-24 at 6 39 21 PM" src="https://github.com/user-attachments/assets/0694304e-f256-47b5-923b-5c05ed0035b7" />
+<img width="1611" alt="Screenshot 2025-05-24 at 6 39 48 PM" src="https://github.com/user-attachments/assets/df379064-9f33-48f7-9e8b-635723df6572" />
+<img width="1611" alt="Screenshot 2025-05-24 at 6 40 01 PM" src="https://github.com/user-attachments/assets/aeb20e8e-202c-49f8-bd09-7b563964bb9e" />
+
+
+
+## Features
+
+- **Real-time Stats**: Live CPU, memory, and network monitoring with parallel stats collection
+- **Log Management**: 
+  - Advanced normalization for consistent log formatting
+  - Text search with highlighted results
+  - Powerful filtering with inclusion/exclusion support
+  - Follow mode for real-time updates
+- **Container Controls**: Start/stop, pause/unpause, restart, exec shell, force recreate
+- **Mouse Support**: Click navigation, scrolling, and menu interaction
+- **Customizable Interface**: Resizable columns with persistent configuration
+
+## Installation
+
+### One-Line Install
+
+```bash
+# Install directly from GitHub
+sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/StakeSquid/dtop/main/install.sh)"
+```
+
+### Manual Install
+
+```bash
+# 1. Clone repository
+git clone https://github.com/StakeSquid/dtop
+cd dtop
+
+# 2. Install dependency
+pip install docker
+
+# 3. Run directly
+chmod +x main.py
+./main.py
+
+# 4. Or install system-wide
+sudo mkdir -p /usr/local/bin/docker-tui
+sudo cp *.py /usr/local/bin/docker-tui/
+sudo chmod +x /usr/local/bin/docker-tui/*.py
+sudo tee /usr/local/bin/dtop > /dev/null << 'EOF'
+#!/bin/bash
+exec python3 /usr/local/bin/docker-tui/main.py "$@"
+EOF
+sudo chmod +x /usr/local/bin/dtop
+```
+
+### Uninstall
+
+```bash
+sudo rm -rf /usr/local/bin/docker-tui /usr/local/bin/dtop
+```
+
+## Quick Reference
+
+### Controls
+
+| View | Key | Action |
+|------|-----|--------|
+| **Main** | ↑/↓, Click | Navigate containers |
+| | Enter/Click | Show container menu |
+| | L | View container logs |
+| | Q | Quit |
+| **Logs** | ↑/↓, PgUp/PgDn | Scroll logs |
+| | / | Search in logs |
+| | \\ | Filter logs (grep) |
+| | F | Toggle follow mode |
+| | N | Toggle log normalization |
+| | W | Toggle line wrapping |
+| | n/N | Next/previous search hit |
+| | ESC | Clear filter or return to container list |
+
+### Container Actions
+
+- **Logs**: View detailed container logs
+- **Start/Stop**: Toggle container running state
+- **Pause/Unpause**: Temporarily pause execution
+- **Restart**: Restart the container
+- **Recreate**: Recreate container from image
+- **Exec Shell**: Open interactive shell in container
+
+## Advanced Log Filtering
+
+The log viewer supports powerful filtering with both inclusion and exclusion patterns:
+
+### Filter Syntax
+
+- **Include**: `word` or `+word` - Show only lines containing "word"
+- **Exclude**: `-word` or `!word` - Hide lines containing "word"
+- **Multiple filters**: Space-separated, all conditions must match
+- **Multi-word**: Use quotes for phrases: `"error message" -"debug"`
+
+### Examples
+
+```
+error                    # Show only lines with "error"
++error -debug           # Show lines with "error" but not "debug"
+error warning -verbose  # Show lines with "error" OR "warning", but not "verbose"
+"connection failed"     # Show lines with exact phrase
++ERROR -"DEBUG:" -INFO  # Case-sensitive: ERROR lines without DEBUG: or INFO
+```
+
+### Filter Behavior
+
+- Multiple inclusion filters work as OR (any match includes the line)
+- Exclusion filters always take precedence (any match excludes the line)
+- Press Tab to toggle case sensitivity
+- Press ESC to clear active filter
+- Press \\ to modify current filter
+
+## Configuration
+
+- Settings automatically saved to `~/.docker_tui.json`
+- Columns auto-adjust to terminal width
+- Resizable columns (drag separators with mouse)
+
+## Requirements
+
+- Python 3.8+
+- Docker daemon 
+- `docker` Python package
+- Terminal with mouse support and colors
+
+## License
+
+MIT License - See LICENSE file for details.

dtop-1.0.0/dtop/__init__.py

@@ -0,0 +1,12 @@
+"""
+dtop - Docker Terminal UI
+A high-performance terminal UI for Docker container management.
+"""
+
+__version__ = "1.0.0"
+__author__ = "StakeSquid"
+__description__ = "A high-performance terminal UI for Docker container management"
+
+from .core.docker_tui import DockerTUI
+
+__all__ = ["DockerTUI"]

dtop-1.0.0/dtop/actions/__init__.py

@@ -0,0 +1 @@
+"""Container action modules for dtop"""

dtop-1.0.0/dtop/actions/container_actions.py

@@ -0,0 +1,185 @@
+#!/usr/bin/env python3
+"""
+Docker TUI - Container Actions Module
+-----------
+Handles container actions menu and operations.
+"""
+import curses
+import subprocess
+import time
+from ..utils.utils import safe_addstr
+
+def show_menu(tui, stdscr, container):
+    """Show action menu for container with arrow key navigation"""
+    try:
+        # Determine available actions based on container state
+        is_running = container.status == "running"
+        is_paused = container.status == "paused"
+        
+        # Build menu options with keys, labels, and availability
+        opts = []
+        opts.append(("L", "Logs", True))
+        opts.append(("I", "Inspect", True))  # Always available
+        opts.append(("S", "Stop" if is_running else "Start", True))
+        opts.append(("P", "Unpause" if is_paused else "Pause", is_running and not is_paused))
+        opts.append(("R", "Restart", is_running))
+        opts.append(("F", "Recreate", True))
+        opts.append(("E", "Exec Shell", is_running))
+        opts.append(("C", "Cancel", True))
+        
+        # Calculate dimensions
+        h, w = stdscr.getmaxyx()
+        menu_width = 30
+        menu_height = len(opts) + 4
+        
+        # Create menu in top-left corner with border
+        menu = curses.newwin(menu_height, menu_width, 1, 0)
+        menu.keypad(True)  # Enable keypad for arrow keys
+        menu.border()
+        
+        # Draw title
+        title = f" Container: {container.name[:20]} "
+        safe_addstr(menu, 0, (menu_width - len(title))//2, title)
+        
+        # Current selection
+        current = 0
+        
+        # Menu loop
+        while True:
+            # Draw all options
+            for i, (key, label, enabled) in enumerate(opts):
+                # Format option text
+                text = f"{key}: {label}"
+                
+                # Determine attributes
+                if i == current and enabled:
+                    attr = curses.color_pair(7) | curses.A_BOLD
+                elif i == current:
+                    attr = curses.color_pair(6) | curses.A_DIM
+                elif enabled:
+                    attr = curses.A_NORMAL
+                else:
+                    attr = curses.A_DIM
+                
+                # Draw option
+                safe_addstr(menu, i + 2, 2, " " * (menu_width - 4), curses.A_NORMAL)
+                safe_addstr(menu, i + 2, 2, text, attr)
+            
+            # Draw help
+            help_text = "↑/↓:Navigate | Enter/Click:Select | ESC:Cancel"
+            safe_addstr(menu, menu_height - 1, (menu_width - len(help_text))//2, help_text, curses.A_DIM)
+            
+            menu.refresh()
+            
+            # Handle input
+            c = menu.getch()
+            
+            if c == curses.KEY_UP and current > 0:
+                current = (current - 1) % len(opts)
+                # Skip disabled options
+                while not opts[current][2] and current > 0:
+                    current = (current - 1) % len(opts)
+            
+            elif c == curses.KEY_DOWN and current < len(opts) - 1:
+                current = (current + 1) % len(opts)
+                # Skip disabled options
+                while not opts[current][2] and current < len(opts) - 1:
+                    current = (current + 1) % len(opts)
+            
+            elif c in (10, curses.KEY_ENTER) and opts[current][2]:
+                # Selected an enabled option
+                action_key = opts[current][0].lower()
+                break
+            
+            elif c == curses.KEY_MOUSE:
+                try:
+                    _, mx, my, _, button_state = curses.getmouse()
+                    if button_state & curses.BUTTON1_CLICKED:
+                        # Check if click was on a menu item
+                        for i, (_, _, enabled) in enumerate(opts):
+                            if my == i + 2 and enabled:
+                                action_key = opts[i][0].lower()
+                                break
+                        else:
+                            # Click not on menu item, continue loop
+                            continue
+                        break
+                except curses.error:
+                    pass
+            
+            elif c == 27:  # ESC
+                action_key = 'c'  # Cancel
+                break
+            
+            elif c in range(97, 123):  # a-z
+                action_key = chr(c)
+                # Check if this key is a valid shortcut
+                for key, _, enabled in opts:
+                    if key.lower() == action_key and enabled:
+                        break
+                else:
+                    # Not a valid shortcut, continue loop
+                    continue
+                break
+            
+            elif c in range(65, 91):  # A-Z
+                action_key = chr(c).lower()
+                # Check if this key is a valid shortcut
+                for key, _, enabled in opts:
+                    if key.lower() == action_key and enabled:
+                        break
+                else:
+                    # Not a valid shortcut, continue loop
+                    continue
+                break
+        
+        # Clean up
+        del menu
+        stdscr.touchwin()
+        stdscr.refresh()
+        
+        # Return selected action
+        return action_key
+                
+    except Exception as e:
+        # Show error and wait for key
+        h, w = stdscr.getmaxyx()
+        stdscr.clear()
+        safe_addstr(stdscr, h//2, (w-len(str(e))-10)//2, f"Error: {e}", curses.A_BOLD)
+        safe_addstr(stdscr, h//2+1, (w-25)//2, "Press any key to continue...", curses.A_DIM)
+        stdscr.refresh()
+        stdscr.getch()
+        return 'c'  # Return cancel on error
+
+def execute_action(tui, stdscr, container, action_key):
+    """Execute the selected container action"""
+    # Import here to avoid circular imports
+    from ..views import log_view
+    from ..views import inspect_view
+    
+    if action_key == 'l':
+        log_view.show_logs(tui, stdscr, container)
+    elif action_key == 'i':  # Use the new inspect_view module
+        inspect_view.show_inspect(tui, stdscr, container)
+    elif action_key == 's':
+        if container.status == "running": 
+            container.stop()
+        else: 
+            container.start()
+    elif action_key == 'p':
+        if container.status == "paused":
+            container.unpause() 
+        elif container.status == "running":
+            container.pause()
+    elif action_key == 'r' and container.status == "running":
+        container.restart()
+    elif action_key == 'f':
+        img = container.image.tags[0] if container.image.tags else container.image.short_id
+        container.remove(force=True)
+        tui.client.containers.run(img, detach=True)
+    elif action_key == 'e' and container.status == "running":
+        curses.endwin()
+        subprocess.call(["docker","exec","-it",container.id,"/bin/bash"])
+        stdscr.clear()
+        curses.doupdate()
+    # 'c' (cancel) does nothing

dtop-1.0.0/dtop/core/__init__.py

@@ -0,0 +1 @@
+"""Core modules for dtop Docker TUI"""