feat(kc-compat): add --report flag to output system info before status

Author: histrio

README.md

@@ -71,7 +71,7 @@ else if needs_update == False {
 Checks if server is running kernel compatible with KernelCare.
 Usage:
 ```bash
-python kc-compat.py [--silent|-q]
+python kc-compat.py [--silent|-q|--report]
 ```
 
 Outputs:
@@ -82,6 +82,26 @@ Outputs:
 - `SYSTEM ERROR; <error>` for file system issues
 - `UNEXPECTED ERROR; <error>` for other errors
 
+### Flags:
+- `--silent` or `-q`: Silent mode - no output, only exit codes
+- `--report`: Generate system information report for support team
+
+### Report Mode:
+When using `--report`, the script outputs detailed system information followed by the compatibility status:
+
+```
+=== KernelCare Compatibility Report ===
+Kernel Hash: abcdef1234567890abcdef1234567890abcdef12
+Distribution: centos
+Version: 7
+Kernel: Linux version 5.4.0-74-generic (buildd@lcy01-amd64-023) (gcc version 9.3.0)
+Environment: Physical/Virtual Machine
+=====================================
+COMPATIBLE
+```
+
+This information can be easily shared with the support team for troubleshooting.
+
 If --silent flag is provided -- doesn't print anything
 
 Exit codes:

kc-compat.py

@@ -111,21 +111,44 @@ def myprint(silent, message):
 def main():
     """
     if --silent or -q argument provided, don't print anything, just use exit code
+    if --report provided, show system information for support
     otherwise print results (COMPATIBLE or support contact messages)
     else exit with 0 if COMPATIBLE, 1 or more otherwise
     """
     silent = len(sys.argv) > 1 and (sys.argv[1] == '--silent' or sys.argv[1] == '-q')
+    report = len(sys.argv) > 1 and sys.argv[1] == '--report'
+
     if inside_vz_container() or inside_lxc_container():
         myprint(silent, "UNSUPPORTED; INSIDE CONTAINER")
         return 2
+
+    # Get system information once for both report and compatibility checking
+    kernel_hash = get_kernel_hash()
+    distro_name = get_distro_info()
+
+    # Show system information for support if --report flag is used
+    if report:
+        print("=== KernelCare Compatibility Report ===")
+        print(f"Kernel Hash: {kernel_hash}")
+        print(f"Distribution: {distro_name or 'Unknown'}")
+        print(f"Version: Not available")
+
+        # Get kernel version from /proc/version
+        try:
+            with open('/proc/version', 'r') as f:
+                kernel_version = f.read().strip()
+                print(f"Kernel: {kernel_version}")
+        except (IOError, OSError):
+            print("Kernel: Unable to read /proc/version")
+
+        print("=====================================")
 
     try:
         if is_compat():
             myprint(silent, "COMPATIBLE")
             return 0
         else:
             # Handle 404 case - check if distro is supported
-            distro_name = get_distro_info()
             if distro_name and is_distro_supported(distro_name):
                 myprint(silent, "NEEDS REVIEW")
                 myprint(silent, "We support your distribution, but we're having trouble detecting your precise kernel configuration. Please, contact CloudLinux Inc. support by email at [email protected] or by request form at https://www.cloudlinux.com/index.php/support")

test_kc_compat.py

@@ -200,6 +200,30 @@ def test_main_silent_mode(self, mock_print, mock_compat, mock_lxc, mock_vz):
         assert result == 0
         mock_print.assert_not_called()
 
+    @patch('sys.argv', ['kc-compat.py', '--report'])
+    @patch.object(kc_compat, 'get_kernel_hash', return_value='abcdef123456')
+    @patch.object(kc_compat, 'get_distro_info', return_value='centos')
+    @patch.object(kc_compat, 'inside_vz_container', return_value=False)
+    @patch.object(kc_compat, 'inside_lxc_container', return_value=False)
+    @patch.object(kc_compat, 'is_compat', return_value=True)
+    @patch('builtins.open', new_callable=mock_open, read_data='Linux version 5.4.0-test')
+    @patch('builtins.print')
+    def test_main_report_mode(self, mock_print, mock_file, mock_compat, mock_lxc, mock_vz, mock_distro, mock_hash):
+        result = kc_compat.main()
+        assert result == 0
+        # Check that report header and information are printed, followed by COMPATIBLE
+        expected_calls = [
+            (("=== KernelCare Compatibility Report ===",),),
+            (("Kernel Hash: abcdef123456",),),
+            (("Distribution: centos",),),
+            (("Version: Not available",),),
+            (("Kernel: Linux version 5.4.0-test",),),
+            (("=====================================",),),
+            (("COMPATIBLE",),)
+        ]
+        mock_print.assert_has_calls(expected_calls)
+
+
     @patch('sys.argv', ['kc-compat.py'])
     @patch.object(kc_compat, 'inside_vz_container', return_value=False)
     @patch.object(kc_compat, 'inside_lxc_container', return_value=False)