feat: enhance CLI functionality and improve CI/CD reliability

- Introduced full CLI command suite including ping, stats, list, flush, search, export-config, and warm
- Improved CLI architecture with proper command registration
- Updated Python requirement to 3.9 in contributing guidelines and configuration files
- Enhanced GitHub Actions workflow for better CI/CD reliability
- Fixed Redis connection handling and CLI command registration issues
- Updated documentation with new CLI commands and usage examples

Author: SirStig

.github/workflows/test.yml

@@ -93,5 +93,5 @@ jobs:
         
     - name: Test CLI
       run: |
-        python -m yokedcache.cli ping
-        python -m yokedcache.cli stats --format json
+        python -m yokedcache ping
+        python -m yokedcache stats --format json

CHANGELOG.md

@@ -26,18 +26,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Comprehensive test suite with pytest
 - Documentation and usage examples
 - Development tooling (pre-commit, Makefile, CI/CD)
+- CLI module execution support via `python -m yokedcache`
+- Full CLI command suite: ping, stats, list, flush, search, export-config, warm
 
 ### Changed
-- N/A (initial release)
+- Improved CLI architecture with proper command registration
+- Enhanced GitHub Actions workflow for better CI/CD reliability
 
 ### Deprecated
 - N/A (initial release)
 
 ### Removed
-- N/A (initial release)
+- Codecov integration temporarily disabled due to rate limiting issues
 
 ### Fixed
-- N/A (initial release)
+- Redis connection method: changed from `aclose()` to `close()` for proper async connection handling
+- CLI command registration issue with async decorators using `functools.wraps`
+- Black code formatting compliance across all source files
+- MyPy type checking errors for Redis client methods
+- GitHub Actions integration test failures with CLI module execution
 
 ### Security
 - N/A (initial release)

CONTRIBUTING.md

@@ -6,7 +6,7 @@ We welcome contributions to YokedCache! This document provides guidelines for co
 
 ### Prerequisites
 
-- Python 3.8 or higher
+- Python 3.9 or higher
 - Redis server
 - Git
 
@@ -65,7 +65,7 @@ isort src tests examples
 flake8 src tests examples
 
 # Type checking
-mypy src
+mypy src --ignore-missing-imports
 ```
 
 ### Running Tests
@@ -137,7 +137,7 @@ For new features:
    pytest
    black src tests examples
    flake8 src tests examples
-   mypy src
+   mypy src --ignore-missing-imports
    ```
 
 6. **Commit your changes** with a clear commit message:

README.md

@@ -177,6 +177,9 @@ YokedCache includes a powerful CLI for cache management:
 # View cache statistics
 yokedcache stats --watch
 
+# Test Redis connection
+yokedcache ping
+
 # List cached keys
 yokedcache list --pattern "user:*"
 
@@ -188,6 +191,12 @@ yokedcache search "alice" --threshold 80
 
 # Monitor in real-time (JSON output for dashboards)
 yokedcache stats --format json
+
+# Export current configuration
+yokedcache export-config --output config.yaml
+
+# Warm cache with predefined data
+yokedcache warm --config-file cache_config.yaml
 ```
 
 ## 🚀 **Performance**

pyproject.toml

@@ -87,7 +87,7 @@ packages = ["src/yokedcache"]
 
 [tool.black]
 line-length = 88
-target-version = ["py38"]
+target-version = ["py39"]
 include = '\.pyi?$'
 
 [tool.isort]

src/yokedcache/__main__.py

@@ -0,0 +1,9 @@
+"""
+Entry point for running YokedCache CLI via `python -m yokedcache`.
+"""
+
+import sys
+from .cli import main
+
+if __name__ == "__main__":
+    main()

src/yokedcache/cli.py

@@ -6,6 +6,7 @@
 """
 
 import asyncio
+import functools
 import json
 import sys
 import time
@@ -48,6 +49,7 @@ def get_cache_instance(
 def async_command(f):
     """Decorator to handle async commands."""
 
+    @functools.wraps(f)
     @click.pass_context
     def wrapper(ctx, *args, **kwargs):
         return asyncio.run(f(ctx, *args, **kwargs))