cmdex 0.1.0__tar.gz

cmdex-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: cmdex
+Version: 0.1.0
+Summary: Cmdex: Terminal command explainer for developers
+Author: Deepak Kumar Das
+Requires-Dist: click
+Requires-Dist: rich

cmdex-0.1.0/cmdex/cli.py

@@ -0,0 +1,29 @@
+import click
+from cmdex.explainer import explain_command
+from rich import print
+from importlib.metadata import version, PackageNotFoundError
+
+def get_version():
+    try:
+        return version("cmdex")
+    except PackageNotFoundError:
+        return "0.0.0"  # fallback if not installed
+
+@click.group()
+@click.version_option(version=get_version(), prog_name="cmdex")
+def cli():
+    """Cmdex: Your Terminal Command Explainer"""
+    pass
+
+@cli.command(name="explain")
+@click.argument("command_string")
+def explain_cmd(command_string):
+    panel = explain_command(command_string)
+    print(panel)
+
+# aliases
+cli.add_command(explain_cmd, name="why")
+cli.add_command(explain_cmd, name="xplain")
+
+if __name__ == "__main__":
+    cli()

cmdex-0.1.0/cmdex/explainer.py

@@ -0,0 +1,50 @@
+# cmdex/explainer.py
+import json
+from rich import print
+from rich.panel import Panel
+
+def load_db():
+    with open("cmdex/db.json") as f:
+        return json.load(f)
+
+def explain_command(cmd):
+    db = load_db()
+    parts = cmd.strip().split()
+    
+    if not parts:
+        return "[red]No command provided[/red]"
+
+    command = parts[0]
+    flags = [p for p in parts if p.startswith("-")]
+    args = [p for p in parts[1:] if not p.startswith("-")]
+
+    output = []
+
+    # Explain command
+    if command in db["commands"]:
+        output.append(f"[cyan]{command}[/cyan] → {db['commands'][command]}")
+    else:
+        output.append(f"[red]{command}[/red] → Unknown command")
+
+    # Explain flags
+    for flag in flags:
+        meaning = db["flags"].get(flag, "Unknown flag")
+        output.append(f"[yellow]{flag}[/yellow] → {meaning}")
+
+    # Show arguments
+    if args:
+        output.append(f"[green]Arguments[/green] → {' '.join(args)}")
+
+    # Danger detection
+    danger_msg = db.get("dangerous", {}).get(cmd)
+    if danger_msg:
+        output.append(f"\n[bold red]🚨 DANGER: {danger_msg}[/bold red]")
+        output.append("💡 Safer alternative: Think twice before running!")
+
+    # Special checks for known risky patterns
+    if command == "rm" and "-rf" in cmd:
+        output.append("[bold red]⚠ WARNING: Force delete detected[/bold red]")
+    if "chmod 777" in cmd:
+        output.append("[bold red]⚠ WARNING: Full permissions granted[/bold red]")
+
+    return Panel("\n".join(output), title="Cmdex Explanation", expand=False)

cmdex-0.1.0/cmdex.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: cmdex
+Version: 0.1.0
+Summary: Cmdex: Terminal command explainer for developers
+Author: Deepak Kumar Das
+Requires-Dist: click
+Requires-Dist: rich

cmdex-0.1.0/cmdex.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+pyproject.toml
+cmdex/cli.py
+cmdex/explainer.py
+cmdex.egg-info/PKG-INFO
+cmdex.egg-info/SOURCES.txt
+cmdex.egg-info/dependency_links.txt
+cmdex.egg-info/entry_points.txt
+cmdex.egg-info/requires.txt
+cmdex.egg-info/top_level.txt

cmdex-0.1.0/cmdex.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cmdex-0.1.0/cmdex.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cmdex = cmdex.cli:cli

cmdex-0.1.0/cmdex.egg-info/requires.txt

@@ -0,0 +1,2 @@
+click
+rich

cmdex-0.1.0/cmdex.egg-info/top_level.txt

@@ -0,0 +1 @@
+cmdex

cmdex-0.1.0/pyproject.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cmdex"
+version = "0.1.0"
+description = "Cmdex: Terminal command explainer for developers"
+authors = [{name="Deepak Kumar Das"}]
+dependencies = ["click", "rich"]
+
+[project.scripts]
+cmdex = "cmdex.cli:cli"

cmdex-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+