man-ng 0.1.0__tar.gz

man_ng-0.1.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: man-ng
+Version: 0.1.0
+Summary: Manual Pages Next Generation - advanced, interactive terminal CLI
+Author: Ahmed Sufyan
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pyperclip>=1.8.2
+
+# man-ng (mang)
+
+Interactive manual pages alternative.
+
+## Features
+- Command discovery
+- Structured examples
+- Dynamic environment variable substitution
+- Interactive terminal buffer execution
+
+## Example `nmap.md`
+```
+1. Ping sweep a subnet
+   sudo nmap -sn <ip_range>
+```
+
+Run `mang nmap` to list commands.
+Run `mang nmap -g 1 ip_range=192.168.1.1` to evaluate and inject.

man_ng-0.1.0/README.md

@@ -0,0 +1,18 @@
+# man-ng (mang)
+
+Interactive manual pages alternative.
+
+## Features
+- Command discovery
+- Structured examples
+- Dynamic environment variable substitution
+- Interactive terminal buffer execution
+
+## Example `nmap.md`
+```
+1. Ping sweep a subnet
+   sudo nmap -sn <ip_range>
+```
+
+Run `mang nmap` to list commands.
+Run `mang nmap -g 1 ip_range=192.168.1.1` to evaluate and inject.

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

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: man-ng
+Version: 0.1.0
+Summary: Manual Pages Next Generation - advanced, interactive terminal CLI
+Author: Ahmed Sufyan
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pyperclip>=1.8.2
+
+# man-ng (mang)
+
+Interactive manual pages alternative.
+
+## Features
+- Command discovery
+- Structured examples
+- Dynamic environment variable substitution
+- Interactive terminal buffer execution
+
+## Example `nmap.md`
+```
+1. Ping sweep a subnet
+   sudo nmap -sn <ip_range>
+```
+
+Run `mang nmap` to list commands.
+Run `mang nmap -g 1 ip_range=192.168.1.1` to evaluate and inject.

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

@@ -0,0 +1,13 @@
+README.md
+mang.py
+pyproject.toml
+man_ng.egg-info/PKG-INFO
+man_ng.egg-info/SOURCES.txt
+man_ng.egg-info/dependency_links.txt
+man_ng.egg-info/entry_points.txt
+man_ng.egg-info/requires.txt
+man_ng.egg-info/top_level.txt
+src/__init__.py
+src/env.py
+src/injector.py
+src/parser.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[console_scripts]
+mang = mang:main

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

@@ -0,0 +1 @@
+pyperclip>=1.8.2

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

@@ -0,0 +1,2 @@
+mang
+src

man_ng-0.1.0/mang.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+import argparse
+import os
+import sys
+import re
+from src.parser import parse_markdown
+from src.env import load_env, save_env, evaluate_value
+from src.injector import push_to_prompt
+
+def get_pages_dirs():
+    dirs = [
+        os.curdir,
+        os.path.join(os.curdir, "pages"),
+        os.path.expanduser("~/.man-ng/pages"),
+        "/usr/local/share/mang/pages",
+        "/usr/share/mang/pages"
+    ]
+    return dirs
+
+def find_file(tool_name):
+    filename = f"{tool_name}.md"
+    for d in get_pages_dirs():
+        path = os.path.join(d, filename)
+        if os.path.exists(path):
+            return path
+    return None
+
+def main():
+    parser = argparse.ArgumentParser(description="man-ng (mang): interactive manual pages")
+    parser.add_argument("tool", help="Tool name to lookup (e.g. nmap), 'set', or '--set'", nargs="?")
+    parser.add_argument("-g", "--get", type=int, help="Fetch specific command number")
+    parser.add_argument("--set", help="Save a variable to ~/.man-ng (e.g. ip=1.1.1.1)", metavar="KEY=VALUE")
+    parser.add_argument("--dry", action="store_true", help="Print the command without injecting")
+    parser.add_argument("--explain", action="store_true", help="Print explanations for the command")
+    
+    args, overrides = parser.parse_known_args()
+    
+    # Handle explicit --set flag
+    if args.set:
+        if "=" not in args.set:
+            print("Error: --set requires format key=value", file=sys.stderr)
+            sys.exit(1)
+        key, value = map(str.strip, args.set.split("=", 1))
+        save_env(key, value)
+        print(f"Saved {key}={value} to ~/.man-ng")
+        sys.exit(0)
+        
+    if not args.tool:
+        parser.print_help()
+        sys.exit(0)
+        
+    # Handle `mang set k=v` or `mang --set k=v` where tool='set'/'--set'
+    if args.tool in ("set", "--set"):
+        if not overrides:
+            print("Error: 'set' requires format key=value", file=sys.stderr)
+            sys.exit(1)
+        k_v = overrides[0]
+        if "=" not in k_v:
+             print("Error: 'set' requires format key=value", file=sys.stderr)
+             sys.exit(1)
+        key, value = map(str.strip, k_v.split("=", 1))
+        save_env(key, value)
+        print(f"Saved {key}={value} to ~/.man-ng")
+        sys.exit(0)
+
+    # Note: If no tool file is found, we handle it below
+    filepath = find_file(args.tool)
+    if not filepath:
+        print(f"Error: Command list for '{args.tool}' not found in any standard directory.", file=sys.stderr)
+        sys.exit(1)
+        
+    commands = parse_markdown(filepath)
+    if not commands:
+        print(f"No commands found in {filepath}", file=sys.stderr)
+        sys.exit(1)
+
+    if args.get:
+        cmd_info = next((c for c in commands if c["id"] == str(args.get)), None)
+        if not cmd_info:
+            print(f"Error: command number {args.get} not found in {args.tool}.", file=sys.stderr)
+            sys.exit(1)
+            
+        final_cmd = cmd_info["command"]
+        env_vars = load_env()
+        
+        # Parse inline overrides
+        for override in overrides:
+            if "=" in override:
+                key, value = override.split("=", 1)
+                env_vars[key.strip()] = value.strip()
+                
+        def repl(match):
+            key = match.group(1)
+            if key in env_vars:
+                # evaluate value (can be dynamic e.g. $(whoami))
+                val = env_vars[key]
+                return evaluate_value(val)
+            return match.group(0) # remain unchanged if not found
+            
+        final_cmd = re.sub(r'<([^>]+)>', repl, final_cmd)
+        
+        if args.explain:
+            print(f"Tool: {args.tool}")
+            print(f"Description: {cmd_info['description']}")
+            print(f"Variables applied: {', '.join(env_vars.keys()) if env_vars else 'None'}\n")
+            
+        if args.dry:
+            print("Dry run. Final command:")
+            print(final_cmd)
+        else:
+            push_to_prompt(final_cmd)
+    else:
+        # List all commands
+        print(f"--- man-ng: {args.tool} ---")
+        for c in commands:
+            print(f"{c['id']}. {c['description']}")
+            display_cmd = c['command']
+            print(f"   {display_cmd}\n")
+
+if __name__ == "__main__":
+    main()

man_ng-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "man-ng"
+version = "0.1.0"
+description = "Manual Pages Next Generation - advanced, interactive terminal CLI"
+authors = [{ name="Ahmed Sufyan" }]
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "pyperclip>=1.8.2"
+]
+
+[tool.setuptools]
+py-modules = ["mang"]
+packages = ["src"]
+
+[project.scripts]
+mang = "mang:main"

man_ng-0.1.0/setup.cfg

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

man_ng-0.1.0/src/env.py

@@ -0,0 +1,40 @@
+import os
+import re
+import subprocess
+
+ENV_FILE = os.path.expanduser("~/.man-ng")
+
+def load_env():
+    env_vars = {}
+    if not os.path.exists(ENV_FILE):
+        return env_vars
+    
+    with open(ENV_FILE, 'r', encoding='utf-8') as f:
+        for line in f:
+            line = line.strip()
+            if not line or line.startswith('#'):
+                continue
+            if '=' in line:
+                key, value = line.split('=', 1)
+                env_vars[key.strip()] = value.strip()
+    return env_vars
+
+def save_env(key, value):
+    env_vars = load_env()
+    env_vars[key] = value
+    with open(ENV_FILE, 'w', encoding='utf-8') as f:
+        for k, v in env_vars.items():
+            f.write(f"{k}={v}\n")
+
+def evaluate_value(value):
+    # Check if value is dynamic, e.g. $(whoami)
+    match = re.match(r'^\$\((.*)\)$', value)
+    if match:
+        cmd = match.group(1)
+        try:
+            # Evaluate using shell
+            result = subprocess.check_output(cmd, shell=True, stderr=subprocess.STDOUT, text=True)
+            return result.strip()
+        except subprocess.CalledProcessError as e:
+            return f"<Error: {e}>"
+    return value

man_ng-0.1.0/src/injector.py

@@ -0,0 +1,25 @@
+import sys
+import platform
+
+def push_to_prompt(command):
+    # Try using Linux specific ioctl first
+    if platform.system() != 'Windows':
+        try:
+            import fcntl
+            import termios
+            for char in command:
+                fcntl.ioctl(sys.stdin, termios.TIOCSTI, char)
+            print() # Print newline so the prompt redraws nicely
+            return True
+        except Exception:
+            pass # Fallback
+            
+    # For Windows or if TIOCSTI fails
+    print(f"\n[mang] Final Command Ready:\n\n    {command}\n")
+    try:
+        import pyperclip
+        pyperclip.copy(command)
+        print("[mang] (Command copied to clipboard! You can paste it now.)")
+    except ImportError:
+        pass
+    return False

man_ng-0.1.0/src/parser.py

@@ -0,0 +1,39 @@
+import re
+
+def parse_markdown(filepath):
+    """
+    Parses a markdown file and returns a list of dictionaries:
+    [
+        {"id": "1", "description": "Desc", "command": "cmd"},
+        ...
+    ]
+    """
+    commands = []
+    current_cmd = None
+    
+    with open(filepath, 'r', encoding='utf-8') as f:
+        for line in f:
+            match = re.match(r'^(\d+)\.\s+(.*)', line)
+            if match:
+                if current_cmd:
+                    current_cmd["command"] = current_cmd["command"].strip()
+                    commands.append(current_cmd)
+                current_cmd = {
+                    "id": match.group(1),
+                    "description": match.group(2).strip(),
+                    "command": ""
+                }
+            elif current_cmd:
+                # Capture everything else as command until the next number
+                if line.strip() != "":
+                    # Add space if appending to existing command
+                    if current_cmd["command"]:
+                        current_cmd["command"] += " " + line.strip()
+                    else:
+                        current_cmd["command"] = line.strip()
+                        
+    if current_cmd:
+        current_cmd["command"] = current_cmd["command"].strip()
+        commands.append(current_cmd)
+        
+    return commands