Update 0.2.4

Author: SirStig

.devcontainer/OVERVIEW.md

@@ -83,7 +83,7 @@ A complete containerized development environment for YokedCache with Redis, Memc
 ## 🌐 Service URLs
 
 - **Redis**: `redis://redis:56379`
-- **Memcached**: `memcached:51211`
+- **Memcached**: `memcached:11211`
 - **Redis Insight**: <http://localhost:58001>
 - **Prometheus**: <http://localhost:59090>
 - **Grafana**: <http://localhost:53000> (admin/admin)
@@ -111,14 +111,14 @@ graph TB
     A --> C[Redis 7]
     A --> D[Memcached]
     A --> E[Development Tools]
-    
+
     B --> F[YokedCache Source]
     B --> G[All Dependencies]
     B --> H[Testing Framework]
-    
+
     C --> I[Cache Backend]
     D --> J[Alternative Backend]
-    
+
     E --> K[Code Quality Tools]
     E --> L[Documentation Tools]
     E --> M[Monitoring Stack]
@@ -193,7 +193,7 @@ Access dashboards:
 ## 🎯 Development Best Practices
 
 1. **Use the helper script**: `./dev.sh` for common tasks
-2. **Run tests frequently**: `./dev.sh test` 
+2. **Run tests frequently**: `./dev.sh test`
 3. **Format before committing**: `./dev.sh format`
 4. **Check code quality**: `./dev.sh quality`
 5. **Monitor cache health**: `./dev.sh ping` and `./dev.sh stats`

.devcontainer/PORT-UPDATE-SUMMARY.md

@@ -9,7 +9,7 @@ All service ports have been changed to non-standard values to avoid conflicts wi
 | Service | Old Port | New Port | Description |
 |---------|----------|----------|-------------|
 | Redis | 6379 | **56379** | Main Redis cache service |
-| Memcached | 11211 | **51211** | Alternative cache backend |
+| Memcached | 11211 | **11211** | Alternative cache backend |
 | Redis Insight | 8001 | **58001** | Redis GUI interface |
 | Prometheus | 9090 | **59090** | Metrics collection |
 | Grafana | 3000 | **53000** | Metrics visualization |
@@ -19,15 +19,15 @@ All service ports have been changed to non-standard values to avoid conflicts wi
 
 ### Updated Files
 
-✅ **devcontainer.json** - Port forwarding and environment variables  
-✅ **docker-compose.yml** - Service port mappings and health checks  
-✅ **redis.conf** - Redis server port configuration  
-✅ **prometheus.yml** - Scrape target endpoints  
-✅ **post-create.sh** - Connection tests and config generation  
-✅ **dev.sh** - Helper script commands  
-✅ **README.md** - Documentation updates  
-✅ **OVERVIEW.md** - Service URL references  
-✅ **Dockerfile** - Exposed ports  
+✅ **devcontainer.json** - Port forwarding and environment variables
+✅ **docker-compose.yml** - Service port mappings and health checks
+✅ **redis.conf** - Redis server port configuration
+✅ **prometheus.yml** - Scrape target endpoints
+✅ **post-create.sh** - Connection tests and config generation
+✅ **dev.sh** - Helper script commands
+✅ **README.md** - Documentation updates
+✅ **OVERVIEW.md** - Service URL references
+✅ **Dockerfile** - Exposed ports
 
 ### Environment Variables
 
@@ -40,7 +40,7 @@ YOKEDCACHE_PROMETHEUS_PORT=58000
 ### Service URLs (Updated)
 
 - **Redis**: `redis://redis:56379`
-- **Memcached**: `memcached:51211`
+- **Memcached**: `memcached:11211`
 - **Redis Insight**: http://localhost:58001
 - **Prometheus**: http://localhost:59090
 - **Grafana**: http://localhost:53000 (admin/admin)
@@ -54,7 +54,7 @@ YOKEDCACHE_PROMETHEUS_PORT=58000
 redis-cli -h redis -p 56379
 
 # Test memcached
-nc -z memcached 51211
+nc -z memcached 11211
 
 # Documentation server
 mkdocs serve --dev-addr=0.0.0.0:58080

.devcontainer/README.md

@@ -4,7 +4,7 @@ This directory contains a complete containerized development environment for Yok
 
 ## 🚀 Quick Start
 
-1. **Prerequisites**: 
+1. **Prerequisites**:
    - Install [Docker Desktop](https://www.docker.com/products/docker-desktop/)
    - Install [VS Code](https://code.visualstudio.com/)
    - Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
@@ -32,7 +32,7 @@ This directory contains a complete containerized development environment for Yok
 
 ### Optional Monitoring Stack
 - **Redis Insight** (GUI for Redis) - Port 8001
-- **Prometheus** (Metrics collection) - Port 9090  
+- **Prometheus** (Metrics collection) - Port 9090
 - **Grafana** (Metrics visualization) - Port 3000
 
 ## 🔧 Configuration
@@ -51,7 +51,7 @@ PYTHONPATH=/workspace/src
 
 ### Service URLs
 - **Redis**: `redis://redis:56379`
-- **Memcached**: `memcached:51211`
+- **Memcached**: `memcached:11211`
 - **Redis Insight**: http://localhost:58001
 - **Prometheus**: http://localhost:59090
 - **Grafana**: http://localhost:53000 (admin/admin)

.devcontainer/dev.sh

@@ -45,7 +45,7 @@ case "$1" in
         pip install -e .
         log_success "Development installation complete"
         ;;
-        
+
     "test"|"tests")
         log_info "Running tests..."
         activate_env
@@ -55,30 +55,30 @@ case "$1" in
             pytest -v
         fi
         ;;
-        
+
     "test-cov"|"coverage")
         log_info "Running tests with coverage..."
         activate_env
         pytest --cov=yokedcache --cov-report=html --cov-report=term-missing
         log_success "Coverage report generated in htmlcov/"
         ;;
-        
+
     "format"|"fmt")
         log_info "Formatting code..."
         activate_env
         black src tests
         isort src tests
         log_success "Code formatting complete"
         ;;
-        
+
     "lint")
         log_info "Running linting checks..."
         activate_env
         flake8 src tests
         mypy src
         log_success "Linting complete"
         ;;
-        
+
     "quality"|"qa")
         log_info "Running all quality checks..."
         activate_env
@@ -88,82 +88,82 @@ case "$1" in
         mypy src
         log_success "All quality checks passed"
         ;;
-        
+
     "docs"|"doc")
         log_info "Building documentation..."
         activate_env
         mkdocs build
         log_success "Documentation built in site/"
         ;;
-        
+
     "docs-serve")
         log_info "Starting documentation server..."
         activate_env
         mkdocs serve --dev-addr=0.0.0.0:58080
         ;;
-        
+
     "redis-cli")
         log_info "Connecting to Redis CLI..."
         redis-cli -h redis -p 56379
         ;;
-        
+
     "ping")
         log_info "Testing cache connection..."
         activate_env
         yokedcache ping
         ;;
-        
+
     "stats")
         log_info "Showing cache statistics..."
         activate_env
         yokedcache stats
         ;;
-        
+
     "clear")
         log_warning "Clearing cache..."
         activate_env
         yokedcache clear --confirm
         log_success "Cache cleared"
         ;;
-        
+
     "logs")
         service="${2:-yokedcache-dev}"
         log_info "Showing logs for $service..."
         docker logs -f "$service"
         ;;
-        
+
     "shell")
         log_info "Starting development shell..."
         activate_env
         exec bash
         ;;
-        
+
     "jupyter")
         log_info "Starting Jupyter Lab..."
         activate_env
         jupyter lab --ip=0.0.0.0 --port=58888 --allow-root --no-browser
         ;;
-        
+
     "monitor")
         log_info "Starting monitoring stack..."
         docker-compose --profile monitoring up -d
         log_success "Monitoring stack started:"
         log_info "  • Prometheus: http://localhost:59090"
         log_info "  • Grafana: http://localhost:53000 (admin/admin)"
         ;;
-        
+
     "tools")
         log_info "Starting development tools..."
         docker-compose --profile tools up -d
         log_success "Tools started:"
         log_info "  • Redis Insight: http://localhost:58001"
         ;;
-        
+
     "status")
         log_info "Service status:"
         docker-compose ps
         ;;
-        
+
     "restart")
         service="${2:-all}"
         if [ "$service" = "all" ]; then
@@ -175,14 +175,14 @@ case "$1" in
         fi
         log_success "Restart complete"
         ;;
-        
+
     "clean")
         log_info "Cleaning up development environment..."
         docker-compose down -v
         docker system prune -f
         log_success "Cleanup complete"
         ;;
-        
+
     "help"|""|"-h"|"--help")
         echo "YokedCache Development Helper"
         echo ""
@@ -221,7 +221,7 @@ case "$1" in
         echo "  jupyter          Start Jupyter Lab"
         echo ""
         ;;
-        
+
     *)
         log_error "Unknown command: $1"
         echo "Run './dev.sh help' for available commands"