dockops 0.1.0__tar.gz

dockops-0.1.0/LICENSE

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

dockops-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: dockops
+Version: 0.1.0
+Summary: A developer CLI for common Docker tasks
+Author-email: Akhil <you@email.com>
+License: MIT License
+        
+        Copyright (c) 2026 Akhil
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/akhilpr7/dockops
+Keywords: docker,cli,devops
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: docker>=6.0
+Dynamic: license-file
+
+# dockerkit 🐳
+
+A developer CLI for common Docker tasks — clean, scaffold, inspect.
+
+![Python](https://img.shields.io/badge/python-3.8+-blue)
+![PyPI](https://img.shields.io/pypi/v/dockerkit)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+---
+
+## Install
+
+```bash
+pip install dockerkit
+```
+
+---
+
+## Commands
+
+### `dockerkit clean`
+Remove stopped containers, dangling images, unused volumes and networks in one shot.
+
+```bash
+dockerkit clean          # with confirmation prompt
+dockerkit clean --force  # skip confirmation
+```
+
+
+### `dockerkit ports`
+See all ports in use and which container owns them.
+
+```bash
+dockerkit ports
+```
+
+---
+
+### `dockerkit health`
+View health status, uptime, CPU%, and memory of all running containers.
+
+```bash
+dockerkit health         # running containers only
+dockerkit health --all   # include stopped containers
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Docker running locally
+
+---
+
+## License
+
+MIT

dockops-0.1.0/README.md

@@ -0,0 +1,58 @@
+# dockerkit 🐳
+
+A developer CLI for common Docker tasks — clean, scaffold, inspect.
+
+![Python](https://img.shields.io/badge/python-3.8+-blue)
+![PyPI](https://img.shields.io/pypi/v/dockerkit)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+---
+
+## Install
+
+```bash
+pip install dockerkit
+```
+
+---
+
+## Commands
+
+### `dockerkit clean`
+Remove stopped containers, dangling images, unused volumes and networks in one shot.
+
+```bash
+dockerkit clean          # with confirmation prompt
+dockerkit clean --force  # skip confirmation
+```
+
+
+### `dockerkit ports`
+See all ports in use and which container owns them.
+
+```bash
+dockerkit ports
+```
+
+---
+
+### `dockerkit health`
+View health status, uptime, CPU%, and memory of all running containers.
+
+```bash
+dockerkit health         # running containers only
+dockerkit health --all   # include stopped containers
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Docker running locally
+
+---
+
+## License
+
+MIT

dockops-0.1.0/dockops/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

dockops-0.1.0/dockops/cli.py

@@ -0,0 +1,25 @@
+import click
+from rich.console import Console
+from dockops.commands import clean, ports, health
+
+console = Console()
+
+@click.group()
+@click.version_option(version="0.1.0", prog_name="dockops")
+def main():
+    """
+    \b
+    ██████╗  ██████╗  ██████╗██╗  ██╗  ██████╗ ██████╗ ███████╗
+    ██╔══██╗██╔═══██╗██╔════╝██║ ██╔╝ ██╔═══██╗██╔══██╗██╔════╝
+    ██║  ██║██║   ██║██║     █████╔╝  ██║   ██║██████╔╝███████╗
+    ██║  ██║██║   ██║██║     ██╔═██╗  ██║   ██║██╔═══╝ ╚════██║
+    ██████╔╝╚██████╔╝╚██████╗██║  ██╗ ╚██████╔╝██║     ███████║
+    ╚═════╝  ╚═════╝  ╚═════╝╚═╝  ╚═╝  ╚═════╝ ╚═╝     ╚══════╝ 
+
+    A developer CLI for common Docker tasks.
+    """
+    pass
+
+main.add_command(clean.run, name="clean")
+main.add_command(ports.run, name="ports")
+main.add_command(health.run, name="health")

dockops-0.1.0/dockops/commands/clean.py

@@ -0,0 +1,53 @@
+import click
+import docker
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+console = Console()
+
+
+@click.command()
+@click.option("--force", "-f", is_flag=True, help="Skip confirmation prompt")
+def run(force):
+    """Remove stopped containers, dangling images, and unused volumes."""
+
+    if not force:
+        click.confirm(
+            "This will remove stopped containers, dangling images, and unused volumes. Continue?",
+            abort=True,
+        )
+
+    try:
+        client = docker.from_env()
+    except docker.errors.DockerException:
+        console.print("[bold red]✘ Docker is not running. Please start Docker first.[/bold red]")
+        return
+
+    table = Table(title="Cleanup Summary", show_header=True, header_style="bold cyan")
+    table.add_column("Resource", style="white")
+    table.add_column("Result", style="green")
+
+    # Remove stopped containers
+    result = client.containers.prune()
+    deleted = result.get("ContainersDeleted") or []
+    table.add_row("Stopped Containers", f"{len(deleted)} removed")
+
+    # Remove dangling images
+    result = client.images.prune()
+    deleted = result.get("ImagesDeleted") or []
+    table.add_row("Dangling Images", f"{len(deleted)} removed")
+
+    # Remove unused volumes
+    result = client.volumes.prune()
+    deleted = result.get("VolumesDeleted") or []
+    table.add_row("Unused Volumes", f"{len(deleted)} removed")
+
+    # Remove unused networks
+    result = client.networks.prune()
+    deleted = result.get("NetworksDeleted") or []
+    table.add_row("Unused Networks", f"{len(deleted)} removed")
+
+    console.print()
+    console.print(table)
+    console.print(Panel.fit("[bold green]✔ Docker cleanup complete![/bold green]", border_style="green"))

dockops-0.1.0/dockops/commands/health.py

@@ -0,0 +1,77 @@
+import click
+import docker
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+STATUS_STYLE = {
+    "running": "[bold green]● running[/bold green]",
+    "exited": "[bold red]✘ exited[/bold red]",
+    "paused": "[bold yellow]⏸ paused[/bold yellow]",
+    "restarting": "[bold blue]↺ restarting[/bold blue]",
+    "dead": "[bold red]✘ dead[/bold red]",
+}
+
+
+@click.command()
+@click.option("--all", "-a", "show_all", is_flag=True, help="Show stopped containers too")
+def run(show_all):
+    """Show health status of all running containers."""
+
+    try:
+        client = docker.from_env()
+    except docker.errors.DockerException:
+        console.print("[bold red]✘ Docker is not running. Please start Docker first.[/bold red]")
+        return
+
+    containers = client.containers.list(all=show_all)
+
+    if not containers:
+        console.print("[yellow]No containers found.[/yellow]")
+        return
+
+    table = Table(title="Container Health Status", show_header=True, header_style="bold cyan")
+    table.add_column("Container", style="white", no_wrap=True)
+    table.add_column("Image", style="dim")
+    table.add_column("Status", no_wrap=True)
+    table.add_column("Uptime", style="cyan")
+    table.add_column("CPU %", justify="right", style="yellow")
+    table.add_column("Memory", justify="right", style="magenta")
+
+    for container in containers:
+        name = container.name
+        image = container.image.tags[0] if container.image.tags else container.image.short_id
+        status = container.status
+        status_display = STATUS_STYLE.get(status, f"[dim]{status}[/dim]")
+
+        # Get uptime from status string e.g. "Up 2 hours"
+        uptime = container.attrs.get("Status", "-")
+
+        # Get stats (only for running containers)
+        cpu_display = "-"
+        mem_display = "-"
+
+        if status == "running":
+            try:
+                stats = container.stats(stream=False)
+                cpu_delta = stats["cpu_stats"]["cpu_usage"]["total_usage"] - \
+                            stats["precpu_stats"]["cpu_usage"]["total_usage"]
+                system_delta = stats["cpu_stats"]["system_cpu_usage"] - \
+                               stats["precpu_stats"]["system_cpu_usage"]
+                num_cpus = stats["cpu_stats"].get("online_cpus", 1)
+                if system_delta > 0:
+                    cpu_pct = (cpu_delta / system_delta) * num_cpus * 100.0
+                    cpu_display = f"{cpu_pct:.1f}%"
+
+                mem_usage = stats["memory_stats"].get("usage", 0)
+                mem_limit = stats["memory_stats"].get("limit", 1)
+                mem_mb = mem_usage / (1024 * 1024)
+                mem_display = f"{mem_mb:.1f} MB"
+            except Exception:
+                pass
+
+        table.add_row(name, image, status_display, uptime, cpu_display, mem_display)
+
+    console.print()
+    console.print(table)

dockops-0.1.0/dockops/commands/ports.py

@@ -0,0 +1,51 @@
+import click
+import docker
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+
+@click.command()
+def run():
+    """Show all ports in use and which container owns them."""
+
+    try:
+        client = docker.from_env()
+    except docker.errors.DockerException:
+        console.print("[bold red]✘ Docker is not running. Please start Docker first.[/bold red]")
+        return
+
+    containers = client.containers.list()
+
+    if not containers:
+        console.print("[yellow]No running containers found.[/yellow]")
+        return
+
+    table = Table(title="Docker Port Mappings", show_header=True, header_style="bold cyan")
+    table.add_column("Container", style="white")
+    table.add_column("Image", style="dim")
+    table.add_column("Host Port", style="bold yellow")
+    table.add_column("Container Port", style="green")
+    table.add_column("Protocol", style="cyan")
+
+    for container in containers:
+        ports = container.ports
+        name = container.name
+        image = container.image.tags[0] if container.image.tags else container.image.short_id
+
+        if not ports:
+            table.add_row(name, image, "-", "-", "-")
+            continue
+
+        for container_port, bindings in ports.items():
+            port_num, protocol = container_port.split("/") if "/" in container_port else (container_port, "tcp")
+            if bindings:
+                for binding in bindings:
+                    host_port = binding.get("HostPort", "-")
+                    table.add_row(name, image, host_port, port_num, protocol)
+            else:
+                table.add_row(name, image, "not bound", port_num, protocol)
+
+    console.print()
+    console.print(table)

dockops-0.1.0/dockops.egg-info/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: dockops
+Version: 0.1.0
+Summary: A developer CLI for common Docker tasks
+Author-email: Akhil <you@email.com>
+License: MIT License
+        
+        Copyright (c) 2026 Akhil
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/akhilpr7/dockops
+Keywords: docker,cli,devops
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: docker>=6.0
+Dynamic: license-file
+
+# dockerkit 🐳
+
+A developer CLI for common Docker tasks — clean, scaffold, inspect.
+
+![Python](https://img.shields.io/badge/python-3.8+-blue)
+![PyPI](https://img.shields.io/pypi/v/dockerkit)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+---
+
+## Install
+
+```bash
+pip install dockerkit
+```
+
+---
+
+## Commands
+
+### `dockerkit clean`
+Remove stopped containers, dangling images, unused volumes and networks in one shot.
+
+```bash
+dockerkit clean          # with confirmation prompt
+dockerkit clean --force  # skip confirmation
+```
+
+
+### `dockerkit ports`
+See all ports in use and which container owns them.
+
+```bash
+dockerkit ports
+```
+
+---
+
+### `dockerkit health`
+View health status, uptime, CPU%, and memory of all running containers.
+
+```bash
+dockerkit health         # running containers only
+dockerkit health --all   # include stopped containers
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Docker running locally
+
+---
+
+## License
+
+MIT

dockops-0.1.0/dockops.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+dockops/__init__.py
+dockops/cli.py
+dockops.egg-info/PKG-INFO
+dockops.egg-info/SOURCES.txt
+dockops.egg-info/dependency_links.txt
+dockops.egg-info/entry_points.txt
+dockops.egg-info/requires.txt
+dockops.egg-info/top_level.txt
+dockops/commands/__init__.py
+dockops/commands/clean.py
+dockops/commands/health.py
+dockops/commands/ports.py

dockops-0.1.0/dockops.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dockops-0.1.0/dockops.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dockops = dockops.cli:main

dockops-0.1.0/dockops.egg-info/requires.txt

@@ -0,0 +1,3 @@
+click>=8.0
+rich>=13.0
+docker>=6.0

dockops-0.1.0/dockops.egg-info/top_level.txt

@@ -0,0 +1 @@
+dockops

dockops-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dockops"
+version = "0.1.0"
+description = "A developer CLI for common Docker tasks"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "Akhil", email = "you@email.com" }]
+requires-python = ">=3.8"
+dependencies = [
+    "click>=8.0",
+    "rich>=13.0",
+    "docker>=6.0",
+]
+keywords = ["docker", "cli", "devops"]
+
+[project.scripts]
+dockops = "dockops.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/akhilpr7/dockops"

dockops-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+