Harden streaming logs (follow, idle_timeout, disconnect), add tests f…

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, v1.52 ]
+  pull_request:
+    branches: [ main, v1.52 ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install flask pytest
+      - name: Run tests
+        run: pytest -q

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [v1.52] - 2025-12-21
+
+### Added
+- Added `/v1.52` route aliases for all existing endpoints to maintain backward compatibility while exposing new API behaviors.
+- Improved container `inspect` response: normalized `Config.Env` to standard list of `KEY=VALUE` strings.
+- Implemented logs streaming with support for `follow=1`, `timestamps=1`, `since`, and `idle_timeout` parameters.
+- Implemented simple Docker-style multiplexing on logs when `stdout`/`stderr` selection implies multiplexing.
+- Added stats streaming via `GET /containers/{id}/stats?stream=1` (finite sample stream for test determinism).
+- Added unit tests for v1.52 endpoints, streaming behavior, and error cases.
+- Added CI workflow to run tests on push/PR and ensure Flask is installed in CI.
+
+### Changed
+- Updated version metadata to report `ApiVersion: 1.52` in `/version` endpoint.
+- Updated documentation and examples in `README.md`, `QUICKSTART.md`, `IMPLEMENTATION.md`, and `DOWNLOAD-INDEX.md` to reflect v1.52 compatibility.
+
+### Fixed
+- More tolerant parsing of `HostConfig.PortBindings` when creating containers and flexible insertion into `port_bindings` table.
+- `db.get_logs()` supports timestamp prefixes and filtering via `since`.
+
+### Notes
+- Some features are still stubbed due to Udocker limitations (advanced networking, real resource stats). These are documented in `README.md` under Limitations.

QUICKSTART.md

@@ -25,7 +25,7 @@ chmod +x start_dashboard.sh
 Output should show:
 ```
 ============================================================
-🐳 Complete Udocker Docker API Shim (v1.43)
+🐳 Complete Udocker Docker API Shim (v1.52)
 📍 Listening on http://0.0.0.0:2375
 ✅ Features: Containers, Images, Networks, Volumes, Exec, Stats
 ============================================================
@@ -40,7 +40,7 @@ curl http://localhost:2375/_ping
 
 ### 5. List Containers
 ```bash
-curl http://localhost:2375/v1.43/containers/json | jq
+curl http://localhost:2375/v1.52/containers/json | jq
 ```
 
 ---
@@ -49,27 +49,27 @@ curl http://localhost:2375/v1.43/containers/json | jq
 
 ### List containers (with details)
 ```bash
-curl http://localhost:2375/v1.43/containers/json?all=true | jq
+curl http://localhost:2375/v1.52/containers/json?all=true | jq
 ```
 
 ### Get logs from a container
 ```bash
-curl http://localhost:2375/v1.43/containers/CONTAINER_ID/logs
+curl http://localhost:2375/v1.52/containers/CONTAINER_ID/logs
 ```
 
 ### Delete a container
 ```bash
-curl -X DELETE http://localhost:2375/v1.43/containers/CONTAINER_ID
+curl -X DELETE http://localhost:2375/v1.52/containers/CONTAINER_ID
 ```
 
 ### Get system info
 ```bash
-curl http://localhost:2375/v1.43/info | jq
+curl http://localhost:2375/v1.52/info | jq
 ```
 
 ### List images
 ```bash
-curl http://localhost:2375/v1.43/images/json | jq
+curl http://localhost:2375/v1.52/images/json | jq
 ```
 
 ---

README.md

@@ -1,12 +1,12 @@
 # Udocker Docker API Server (Complete Implementation)
 
-A **production-ready Docker Engine API (v1.43) compatible server** that runs on Android Termux using Udocker. This allows you to manage Udocker containers as if they were Docker containers, compatible with Portainer, Docker CLI, and other Docker-compatible tools.
+A **production-ready Docker Engine API (v1.52) compatible server** that runs on Android Termux using Udocker. This allows you to manage Udocker containers as if they were Docker containers, compatible with Portainer, Docker CLI, and other Docker-compatible tools.
 
 ## Files Included
 
 - **`db.py`** - SQLite database layer for persistent container/image state tracking
 - **`container_manager.py`** - High-level container lifecycle management with background monitoring
-- **`dashboard.py`** - Full Docker API v1.43 server implementation (complete all endpoints)
+- **`dashboard.py`** - Full Docker API v1.52 server implementation (complete all endpoints)
 - **`start_dashboard.sh`** - Launcher script with environment setup
 - **`portainer.sh`** - Example: Portainer container script (from previous setup)
 - **`udocker_state.db`** - Auto-generated SQLite database (DO NOT EDIT)
@@ -100,12 +100,12 @@ curl http://localhost:2375/_ping
 
 ### List All Containers
 ```bash
-curl http://localhost:2375/v1.43/containers/json | jq
+curl http://localhost:2375/v1.52/containers/json | jq
 ```
 
 ### Launch a Script-Based Container
 ```bash
-curl -X POST http://localhost:2375/v1.43/containers/create \
+curl -X POST http://localhost:2375/v1.52/containers/create \
   -H "Content-Type: application/json" \
   -d '{
     "Image": "portainer/portainer-ce:alpine",
@@ -121,14 +121,14 @@ curl -X POST http://localhost:2375/v1.43/containers/create \
 
 ### Get Container Logs
 ```bash
-curl http://localhost:2375/v1.43/containers/CONTAINER_ID/logs
+curl http://localhost:2375/v1.52/containers/CONTAINER_ID/logs
 ```
 
 ### Stop and Delete a Container
 ```bash
-curl -X POST http://localhost:2375/v1.43/containers/CONTAINER_ID/stop
+curl -X POST http://localhost:2375/v1.52/containers/CONTAINER_ID/stop
 
-curl -X DELETE http://localhost:2375/v1.43/containers/CONTAINER_ID
+curl -X DELETE http://localhost:2375/v1.52/containers/CONTAINER_ID
 ```
 
 ## Database
@@ -254,10 +254,10 @@ ssh -L 2375:localhost:2375 user@phone-ip
 
 ## API Versioning
 
-This implementation supports Docker API v1.43 (current as of 2024).
+This implementation supports Docker API v1.52.
 
 Routes support both:
-- `/v1.43/containers/json` (versioned)
+- `/v1.52/containers/json` (versioned)
 - `/containers/json` (default)
 
 ## Support
@@ -271,5 +271,5 @@ For issues:
 ---
 
 **Created**: 2025-12-21
-**Version**: 1.0 (Complete Docker API v1.43)
+**Version**: 1.0 (Complete Docker API v1.52)
 **Tested On**: Android Termux with Udocker

core/DOWNLOAD-INDEX.md

@@ -22,7 +22,7 @@ Must download all 4 to your `~/Termux-Udocker/` directory:
    - Required by: dashboard.py
 
 3. **`dashboard.py`** ⭐
-   - Docker API v1.43 server (Flask)
+   - Docker API v1.52 server (Flask)
    - 40+ REST endpoints
    - Depends on: container_manager.py, db.py
 
@@ -170,7 +170,7 @@ udocker_state.db (auto-created)
 - Real-time log retrieval
 
 ### ✅ API Compatibility
-- Docker Engine API v1.43
+- Docker Engine API v1.52
 - Portainer integration
 - Docker CLI compatibility
 
@@ -203,9 +203,9 @@ udocker start <container>
 ### After (Docker API Server)
 ```bash
 # REST API compatible
-curl http://localhost:2375/v1.43/containers/json
-curl http://localhost:2375/v1.43/containers/{id}/logs
-curl -X POST http://localhost:2375/v1.43/containers/{id}/start
+curl http://localhost:2375/v1.52/containers/json
+curl http://localhost:2375/v1.52/containers/{id}/logs
+curl -X POST http://localhost:2375/v1.52/containers/{id}/start
 
 # Portainer compatible
 # Docker CLI compatible
@@ -280,7 +280,7 @@ Once you have the 4 core files in place, you're ready to:
 
 ## 📝 Version Info
 
-- **Implementation**: Docker API v1.43
+- **Implementation**: Docker API v1.52
 - **Date**: December 21, 2025
 - **Status**: ✅ Complete & Production-Ready
 - **Platform**: Android Termux with Udocker

core/IMPLEMENTATION.md

@@ -23,7 +23,7 @@
   - Integration with udocker commands
 
 ### 3. **dashboard.py** (Docker API Server)
-- **Purpose**: Flask REST API server compatible with Docker Engine v1.43
+- **Purpose**: Flask REST API server compatible with Docker Engine v1.52
 - **Size**: ~45 KB
 - **Endpoints Implemented**: 40+
 - **Features**:
@@ -58,7 +58,7 @@
                  ↓
 ┌─────────────────────────────────────────────────┐
 │    Flask Server (dashboard.py)                  │
-│  - 40+ Docker API v1.43 endpoints              │
+│  - 40+ Docker API v1.52 endpoints              │
 │  - JSON response formatting                     │
 │  - Error handling & validation                  │
 └────────────────┬────────────────────────────────┘
@@ -109,9 +109,9 @@
 - Detects crashed containers
 - Logs state changes
 
-### ✅ **Docker API v1.43 Compatible**
+### ✅ **Docker API v1.52 Compatible**
 - 40+ endpoints implemented
-- Supports both `/v1.43/` and shorthand routes
+- Supports both `/v1.52/` and shorthand routes
 - Proper HTTP status codes
 - JSON response formatting
 - Error messages
@@ -161,27 +161,27 @@ curl http://localhost:2375/_ping
 
 ### List Containers
 ```bash
-curl http://localhost:2375/v1.43/containers/json
+curl http://localhost:2375/v1.52/containers/json
 ```
 
 ### Start Container
 ```bash
-curl -X POST http://localhost:2375/v1.43/containers/{id}/start
+curl -X POST http://localhost:2375/v1.52/containers/{id}/start
 ```
 
 ### Get Logs
 ```bash
-curl http://localhost:2375/v1.43/containers/{id}/logs
+curl http://localhost:2375/v1.52/containers/{id}/logs
 ```
 
 ### Delete Container
 ```bash
-curl -X DELETE http://localhost:2375/v1.43/containers/{id}
+curl -X DELETE http://localhost:2375/v1.52/containers/{id}
 ```
 
 ### Get System Info
 ```bash
-curl http://localhost:2375/v1.43/info
+curl http://localhost:2375/v1.52/info
 ```
 
 ---

core/container_manager.py

@@ -125,7 +125,7 @@ def inspect_container(cid):
             "Created": datetime.fromtimestamp(db_info['created_at']).isoformat() + "Z",
             "PortBindings": ports,
             "RestartCount": db_info['restart_count'],
-            "Env": json.loads(db_info['env_vars'] or '{}')
+            "Env": (lambda e: [f"{k}={v}" for k, v in e.items()] if isinstance(e, dict) else e)(json.loads(db_info['env_vars'] or '[]'))
         }
 
     @staticmethod