C++ Rewrite!

README.md

@@ -0,0 +1,131 @@
+# 🐧 Tux-Dock
+### A lightweight C++ Docker management CLI
+
+Tux-Dock is a simple, modern, and fast **C++17** command-line utility for managing Docker containers and images.
+It offers a clean, interactive menu for common Docker operations like pulling images, running containers, and inspecting IP addresses — without the overhead of complex GUIs or scripts.
+
+---
+
+## ✨ Features
+
+- 🔹 **Interactive container management** — start, stop, remove, or attach to containers with simple numbered menus.
+- 🔹 **Port mapping made clear** — automatically prompts for and explains host ↔ container port bindings.
+- 🔹 **Image operations** — pull, list, and delete Docker images.
+- 🔹 **Quick MySQL setup** — spin up a MySQL container with version, password, and port configuration in seconds.
+- 🔹 **Get container IP address** — cleanly retrieves and displays only the container’s assigned IP.
+- 🔹 **Modern C++ design** — built with classes, minimal dependencies, and clear abstractions.
+
+---
+
+## 🧩 Build Requirements
+
+- **C++17 or newer** compiler
+  (e.g., `g++`, `clang++`)
+- **Docker Engine** installed and running
+  (tested on Debian 12/13, Alpine Linux, and Arch Linux)
+
+---
+
+## ⚙️ Build & Run
+
+```bash
+# Clone the repo
+git clone https://github.com/markmental/tuxdock.git
+cd tuxdock
+
+# Build the binary
+g++ -std=c++17 tux-dock.cpp -o tux-dock
+
+# Run it (requires Docker permissions)
+sudo ./tux-dock
+````
+
+---
+
+## 🖥️ Menu Overview
+
+```
+Tux-Dock: Docker Management Menu
+----------------------------------
+1.  Pull Docker Image
+2.  Run/Create Interactive Container
+3.  List All Containers
+4.  List All Images
+5.  Start Container Interactively (boot new session)
+6.  Start Detached Container Session
+7.  Delete Docker Image
+8.  Stop Container
+9.  Remove Container
+10. Attach Shell to Running Container
+11. Spin Up MySQL Container
+12. Get Container IP Address
+13. Exit
+```
+
+Each action guides you through the required steps.
+For container-related commands, Tux-Dock automatically lists available containers and lets you choose by **number**, not by typing long IDs.
+
+---
+
+## 📡 Example: Getting a Container’s IP Address
+
+```
+Available Containers:
+1. mysql-container (ebaf5dbae393)
+2. webapp (fa29b6c1f1e8)
+
+Select container to view IP (1-2): 2
+Container IP Address: 172.17.0.3
+```
+
+---
+
+## 🧱 Design Overview
+
+Tux-Dock is built using a single class:
+
+```cpp
+class DockerManager {
+    void pullImage();
+    void runContainerInteractive();
+    void listContainers() const;
+    void startInteractive();
+    void stopContainer();
+    void showContainerIP();
+};
+```
+
+This makes the codebase **extensible** — adding new Docker features like `docker logs` or `docker stats` requires only a small new method.
+
+---
+
+## 🧠 Why C++?
+
+C++ was one of my formative languages when I was learning to program — it’s where I first grasped core concepts like memory management, data structures, OOP and abstraction.
+Writing Tux-Dock in C++ is both nostalgic and practical: it combines the clarity of modern design with the raw performance and control that first inspired me to code.
+
+---
+
+## 📜 License
+
+MIT License — free to use, modify, and share.
+
+---
+
+### 💡 Tip
+
+If you’d like Tux-Dock to run without `sudo`, add your user to the Docker group:
+
+```bash
+sudo usermod -aG docker $USER
+```
+
+Then log out and back in.
+
+---
+
+**Author:** MARKMENTAL
+**Project:** Tux-Dock — *A clean and modern CLI for Docker power users.*
+
+
+---