feat(cli): add show <command> subcommand with mock data

- Implemented `show <command>` subcommand to display description, usage, example, and notes
- Added mock data for ls, grep, cat, mkdir
- Improved output formatting with colors and sections
- Added tests for valid and invalid commands in test_cli.py

# Conflicts:
#	cli/cli.py
#	cli/test_cli.py

# Conflicts:
#	cli/commands/show.py

Author: mt798jx

cli/cli.py

@@ -4,12 +4,13 @@
 
 import typer
 
-from commands import hello, list, version
+from commands import hello, list, version, show
 
 app = typer.Typer(help="101 Linux Commands CLI 🚀")
 app.add_typer(hello.app, name="hello")
 app.add_typer(list.app, name="list")
 app.add_typer(version.app, name="version")
+app.command()(show.show)
 
 
 def main() -> None:
@@ -18,4 +19,4 @@ def main() -> None:
 
 
 if __name__ == "__main__":
-    app()
+    main()

cli/test_cli.py

@@ -6,66 +6,49 @@
 import sys
 
 
-def test_cli_help():
-    """Test that the CLI shows help."""
+def run_cli(args):
+    """Helper to run CLI with subprocess and capture output."""
     result = subprocess.run(
-        [sys.executable, "cli.py", "--help"],
+        [sys.executable, "cli.py", *args],
         capture_output=True,
         text=True,
         cwd=os.path.dirname(__file__),
-        check=True,
     )
+    return result
+
+
+def test_cli_help():
+    """Test that the CLI shows help."""
+    result = run_cli(["--help"])
     assert result.returncode == 0
     assert "101 Linux Commands CLI" in result.stdout
 
 
 def test_hello_command():
     """Test the hello command."""
-    result = subprocess.run(
-        [sys.executable, "cli.py", "hello", "greet"],
-        capture_output=True,
-        text=True,
-        cwd=os.path.dirname(__file__),
-        check=True,
-    )
+    result = run_cli(["hello", "greet"])
     assert result.returncode == 0
     assert "Hello, World!" in result.stdout
 
 
 def test_hello_command_with_name():
     """Test the hello command with a custom name."""
-    result = subprocess.run(
-        [sys.executable, "cli.py", "hello", "greet", "--name", "Linux"],
-        capture_output=True,
-        text=True,
-        cwd=os.path.dirname(__file__),
-        check=True,
-    )
+    result = run_cli(["hello", "greet", "--name", "Linux"])
     assert result.returncode == 0
     assert "Hello, Linux!" in result.stdout
 
 
 def test_hello_help():
     """Test the hello command help."""
-    result = subprocess.run(
-        [sys.executable, "cli.py", "hello", "--help"],
-        capture_output=True,
-        text=True,
-        cwd=os.path.dirname(__file__),
-        check=True,
-    )
+    result = run_cli(["hello", "--help"])
     assert result.returncode == 0
     assert "Hello command group" in result.stdout
 
 
 def test_list_command():
     """Test the list command."""
-    result = subprocess.run(
-        [sys.executable, "cli.py", "list"],
-        capture_output=True,
-        text=True,
-        cwd=os.path.dirname(__file__),
-    )
+    result = run_cli(["list"])
+    assert result.returncode == 0
     assert "ls - List directory contents." in result.stdout
     assert "cd - Change directory." in result.stdout
     assert "pwd - Print working directory." in result.stdout
@@ -74,29 +57,47 @@ def test_list_command():
 
 def test_version_command():
     """Test the version command"""
-    result = subprocess.run(
-        [sys.executable, "cli.py", "version"],
-        capture_output=True,
-        text=True,
-        cwd=os.path.dirname(__file__),
-    )
+    result = run_cli(["version"])
     assert result.returncode == 0
     assert "101-linux v" in result.stdout
     assert "0.1.0" in result.stdout
 
 
 def test_version_show_command():
     """Test the version show subcommand."""
-    result = subprocess.run(
-        [sys.executable, "cli.py", "version", "show"],
-        capture_output=True,
-        text=True,
-        cwd=os.path.dirname(__file__),
-    )
+    result = run_cli(["version", "show"])
     assert result.returncode == 0
     assert "101-linux v0.1.0" in result.stdout
 
 
+# ----------------------------
+# Tests for `show` subcommand
+# ----------------------------
+
+def test_show_ls():
+    """Test the show command with ls."""
+    result = run_cli(["show", "ls"])
+    assert result.returncode == 0
+    assert "ls" in result.stdout
+    assert "List" in result.stdout
+
+
+def test_show_grep():
+    """Test the show command with grep."""
+    result = run_cli(["show", "grep"])
+    assert result.returncode == 0
+    assert "grep" in result.stdout
+    assert "Search" in result.stdout or "Print" in result.stdout
+
+
+def test_show_invalid():
+    """Test the show command with an invalid command."""
+    result = run_cli(["show", "foobar"])
+    assert result.returncode != 0
+    combined_output = result.stdout + result.stderr
+    assert "Unknown" in combined_output or "Error" in combined_output
+
+
 if __name__ == "__main__":
     test_cli_help()
     test_hello_command()
@@ -105,4 +106,7 @@ def test_version_show_command():
     test_list_command()
     test_version_command()
     test_version_show_command()
+    test_show_ls()
+    test_show_grep()
+    test_show_invalid()
     print("✅ All tests passed!")