feat(cli): add search subcommand to filter commands (#381)

Author: AnasFaaiz

cli/cli.py

@@ -4,13 +4,14 @@
 
 import typer
 
-from commands import hello, list, show, version
+from commands import hello, list, search, show, version
 
 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)
+app.add_typer(search.app, name="search")
 
 
 def main() -> None:

cli/commands/search.py

@@ -0,0 +1,73 @@
+from typing import Dict, List
+
+import typer
+
+app = typer.Typer(
+    help=("Search available commands by keyword " "(name or description).")
+)
+
+
+def _get_available_commands() -> List[Dict[str, str]]:
+    """
+    Mocked list of available commands.
+    Replace with real registry/source when available.
+    """
+    return [
+        {"name": "ls", "description": "List directory contents"},
+        {"name": "grep", "description": "Search for PATTERN in files"},
+        {
+            "name": "find",
+            "description": "Search for files in a directory hierarchy",
+        },
+        {
+            "name": "awk",
+            "description": "Pattern scanning and processing language",
+        },
+        {
+            "name": "cat",
+            "description": ("Concatenate files and print on the standard " "output"),
+        },
+        {"name": "head", "description": "Output the first part of files"},
+        {"name": "tail", "description": "Output the last part of files"},
+        {
+            "name": "sed",
+            "description": ("Stream editor for filtering and transforming " "text"),
+        },
+    ]
+
+
+def _search_commands(
+    keyword: str,
+    commands: List[Dict[str, str]],
+) -> List[Dict[str, str]]:
+    k = (keyword or "").strip().lower()
+    if not k:
+        return []
+    return [
+        cmd
+        for cmd in commands
+        if (k in cmd.get("name", "").lower())
+        or (k in cmd.get("description", "").lower())
+    ]
+
+
+@app.callback(invoke_without_command=True)
+def search(
+    keyword: str = typer.Argument(
+        ...,
+        help="Keyword to search for, e.g. 'grep'",
+    ),
+) -> None:
+    """
+    Search available commands by keyword (matches command name or description).
+    Example: python cli.py search grep
+    """
+    results = _search_commands(keyword, _get_available_commands())
+    if not results:
+        typer.echo("No commands found.")
+        raise typer.Exit(code=1)
+
+    for cmd in results:
+        name = cmd.get("name", "").strip()
+        desc = cmd.get("description", "").strip()
+        typer.echo(f"{name}: {desc}")

cli/test_cli.py

@@ -99,6 +99,32 @@ def test_show_invalid():
     assert "Unknown" in combined_output or "Error" in combined_output
 
 
+def test_search_match():
+    """It should find matches and exit 0."""
+    result = subprocess.run(
+        [sys.executable, "cli.py", "search", "grep"],
+        capture_output=True,
+        text=True,
+        cwd=os.path.dirname(__file__),
+        check=False,
+    )
+    assert result.returncode == 0, result.stderr
+    assert any(line.startswith("grep:") for line in result.stdout.splitlines())
+
+
+def test_search_no_match():
+    """It should print 'No commands found.' and exit non-zero."""
+    result = subprocess.run(
+        [sys.executable, "cli.py", "search", "this-should-not-exist-xyz"],
+        capture_output=True,
+        text=True,
+        cwd=os.path.dirname(__file__),
+        check=False,
+    )
+    assert result.returncode != 0
+    assert "No commands found." in result.stdout
+
+
 if __name__ == "__main__":
     test_cli_help()
     test_hello_command()
@@ -110,4 +136,6 @@ def test_show_invalid():
     test_show_ls()
     test_show_grep()
     test_show_invalid()
+    test_search_match()
+    test_search_no_match()
     print("✅ All tests passed!")