sansible 0.2.0__py3-none-any.whl

sansible/__init__.py

@@ -0,0 +1,27 @@
+# Copyright (c) 2024 Sansible Contributors
+# MIT License
+
+"""
+Sansible: Minimal Ansible-compatible playbook runner.
+
+A lightweight, pure-Python alternative to Ansible for running simple playbooks
+on Windows and Linux hosts via SSH and WinRM.
+
+Features:
+    - Pure Python wheel (py3-none-any) — no compiled extensions
+    - Windows-native control node — no WSL required
+    - SSH (asyncssh) and WinRM (pypsrp) connections
+    - Subset of Ansible module and feature support
+
+This package exposes the main CLI entry point and release metadata.
+"""
+
+from __future__ import annotations
+
+from sansible.release import __version__, __author__, __codename__
+
+__all__ = [
+    "__version__",
+    "__author__",
+    "__codename__",
+]

sansible/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI package for sansible commands."""

sansible/cli/inventory.py

@@ -0,0 +1,136 @@
+"""
+Inventory CLI entrypoint for sansible-inventory.
+
+Usage:
+    sansible-inventory --version
+    sansible-inventory --help
+    sansible-inventory -i inventory --list
+    sansible-inventory -i inventory --host <hostname>
+"""
+
+import argparse
+import json
+import sys
+import platform
+
+from sansible import __version__
+
+
+def get_version_string() -> str:
+    """Generate a detailed version string."""
+    python_version = platform.python_version()
+    os_info = f"{platform.system()} {platform.release()}"
+    return (
+        f"sansible-inventory {__version__}\n"
+        f"  python: {python_version}\n"
+        f"  platform: {os_info}\n"
+        f"  pure-python: yes (no compiled extensions)"
+    )
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create the argument parser for sansible-inventory."""
+    parser = argparse.ArgumentParser(
+        prog="sansible-inventory",
+        description="Show Ansible inventory information (pure-Python, Windows-native)",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  sansible-inventory -i inventory.ini --list
+  sansible-inventory -i hosts --host webserver1
+  sansible-inventory -i inventory/ --graph
+        """,
+    )
+    
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=get_version_string(),
+    )
+    
+    parser.add_argument(
+        "-i", "--inventory",
+        dest="inventory",
+        default=None,
+        help="Inventory file or directory",
+    )
+    
+    parser.add_argument(
+        "--list",
+        action="store_true",
+        dest="list_hosts",
+        help="Output all hosts info (JSON)",
+    )
+    
+    parser.add_argument(
+        "--host",
+        dest="host",
+        default=None,
+        help="Output specific host info (JSON)",
+    )
+    
+    parser.add_argument(
+        "--graph",
+        action="store_true",
+        help="Output inventory graph",
+    )
+    
+    parser.add_argument(
+        "-y", "--yaml",
+        action="store_true",
+        help="Output in YAML format",
+    )
+    
+    parser.add_argument(
+        "-v", "--verbose",
+        action="count",
+        default=0,
+        help="Increase verbosity",
+    )
+    
+    return parser
+
+
+def main(args: list[str] | None = None) -> int:
+    """Main entrypoint for sansible-inventory CLI."""
+    parser = create_parser()
+    parsed = parser.parse_args(args)
+    
+    # If no action specified, show help
+    if not parsed.list_hosts and not parsed.host and not parsed.graph:
+        parser.print_help()
+        return 0
+    
+    # TODO: Implement inventory parsing and output
+    if parsed.list_hosts:
+        # Return empty inventory structure for now
+        inventory = {
+            "_meta": {
+                "hostvars": {}
+            },
+            "all": {
+                "children": ["ungrouped"]
+            },
+            "ungrouped": {
+                "hosts": []
+            }
+        }
+        print(json.dumps(inventory, indent=2))
+        return 0
+    
+    if parsed.host:
+        # Return empty hostvars for now
+        hostvars: dict[str, str] = {}
+        print(json.dumps(hostvars, indent=2))
+        return 0
+    
+    if parsed.graph:
+        print("@all:")
+        print("  |--@ungrouped:")
+        return 0
+    
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

sansible/cli/main.py

@@ -0,0 +1,113 @@
+"""
+Main CLI entrypoint for sansible.
+
+Usage:
+    sansible --version
+    sansible --help
+    sansible <host-pattern> -m <module> [-a <args>]
+"""
+
+import argparse
+import sys
+import platform
+
+from sansible import __version__
+
+
+def get_version_string() -> str:
+    """Generate a detailed version string."""
+    python_version = platform.python_version()
+    os_info = f"{platform.system()} {platform.release()}"
+    return (
+        f"sansible {__version__}\n"
+        f"  python: {python_version}\n"
+        f"  platform: {os_info}\n"
+        f"  pure-python: yes (no compiled extensions)"
+    )
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create the argument parser for sansible."""
+    parser = argparse.ArgumentParser(
+        prog="sansible",
+        description="Run ad-hoc Ansible commands (pure-Python, Windows-native)",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  sansible all -m ping
+  sansible webservers -m command -a "uptime"
+  sansible localhost -m setup
+        """,
+    )
+    
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=get_version_string(),
+    )
+    
+    parser.add_argument(
+        "pattern",
+        nargs="?",
+        default=None,
+        help="Host pattern to target",
+    )
+    
+    parser.add_argument(
+        "-i", "--inventory",
+        dest="inventory",
+        default=None,
+        help="Inventory file or directory",
+    )
+    
+    parser.add_argument(
+        "-m", "--module-name",
+        dest="module",
+        default="command",
+        help="Module to execute (default: command)",
+    )
+    
+    parser.add_argument(
+        "-a", "--args",
+        dest="module_args",
+        default="",
+        help="Module arguments",
+    )
+    
+    parser.add_argument(
+        "-v", "--verbose",
+        action="count",
+        default=0,
+        help="Increase verbosity (-v, -vv, -vvv)",
+    )
+    
+    parser.add_argument(
+        "-C", "--check",
+        action="store_true",
+        help="Run in check mode (dry run)",
+    )
+    
+    return parser
+
+
+def main(args: list[str] | None = None) -> int:
+    """Main entrypoint for sansible CLI."""
+    parser = create_parser()
+    parsed = parser.parse_args(args)
+    
+    # If no pattern provided, just show help
+    if parsed.pattern is None:
+        parser.print_help()
+        return 0
+    
+    # TODO: Implement ad-hoc command execution
+    print(f"[sansible] Target: {parsed.pattern}")
+    print(f"[sansible] Module: {parsed.module}")
+    print(f"[sansible] Args: {parsed.module_args}")
+    print(f"[sansible] Status: Not yet implemented - M1 milestone in progress")
+    
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

sansible/cli/playbook.py

@@ -0,0 +1,213 @@
+"""
+Playbook CLI entrypoint for sansible-playbook.
+
+Usage:
+    sansible-playbook --version
+    sansible-playbook --help
+    sansible-playbook -i inventory playbook.yml
+"""
+
+import argparse
+import sys
+import platform
+
+from sansible import __version__
+
+
+def get_version_string() -> str:
+    """Generate a detailed version string."""
+    python_version = platform.python_version()
+    os_info = f"{platform.system()} {platform.release()}"
+    return (
+        f"sansible-playbook {__version__}\n"
+        f"  python: {python_version}\n"
+        f"  platform: {os_info}\n"
+        f"  pure-python: yes (no compiled extensions)"
+    )
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create the argument parser for sansible-playbook."""
+    parser = argparse.ArgumentParser(
+        prog="sansible-playbook",
+        description="Run Ansible playbooks (pure-Python, Windows-native)",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  sansible-playbook -i inventory.ini site.yml
+  sansible-playbook -i hosts playbook.yml --check
+  sansible-playbook -i inventory/ deploy.yml -v
+        """,
+    )
+    
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=get_version_string(),
+    )
+    
+    parser.add_argument(
+        "playbook",
+        nargs="*",
+        help="Playbook file(s) to run",
+    )
+    
+    parser.add_argument(
+        "-i", "--inventory",
+        dest="inventory",
+        default=None,
+        help="Inventory file or directory",
+    )
+    
+    parser.add_argument(
+        "-v", "--verbose",
+        action="count",
+        default=0,
+        help="Increase verbosity (-v, -vv, -vvv)",
+    )
+    
+    parser.add_argument(
+        "-C", "--check",
+        action="store_true",
+        help="Run in check mode (dry run)",
+    )
+    
+    parser.add_argument(
+        "--diff",
+        action="store_true",
+        help="Show differences when changing files",
+    )
+    
+    parser.add_argument(
+        "-l", "--limit",
+        dest="limit",
+        default=None,
+        help="Limit to specific hosts/groups",
+    )
+    
+    parser.add_argument(
+        "-t", "--tags",
+        dest="tags",
+        default=None,
+        help="Only run plays and tasks tagged with these values",
+    )
+    
+    parser.add_argument(
+        "--skip-tags",
+        dest="skip_tags",
+        default=None,
+        help="Skip plays and tasks tagged with these values",
+    )
+    
+    parser.add_argument(
+        "-f", "--forks",
+        dest="forks",
+        type=int,
+        default=5,
+        help="Number of parallel processes (default: 5)",
+    )
+    
+    parser.add_argument(
+        "-e", "--extra-vars",
+        dest="extra_vars",
+        action="append",
+        default=[],
+        help="Extra variables as key=value or JSON (can be repeated)",
+    )
+    
+    parser.add_argument(
+        "--artifacts-dir",
+        dest="artifacts_dir",
+        default=None,
+        help="Directory to write run artifacts (default: ./artifacts/<timestamp>)",
+    )
+    
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output results in JSON format",
+    )
+    
+    return parser
+
+
+def _parse_extra_vars(extra_vars_list: list[str]) -> dict:
+    """Parse extra vars from command line."""
+    import json
+    
+    result = {}
+    for item in extra_vars_list:
+        item = item.strip()
+        
+        # Try JSON first
+        if item.startswith('{'):
+            try:
+                result.update(json.loads(item))
+                continue
+            except json.JSONDecodeError:
+                pass
+        
+        # Try key=value format
+        if '=' in item:
+            key, _, value = item.partition('=')
+            key = key.strip()
+            value = value.strip()
+            
+            # Try to parse value as JSON for complex types
+            try:
+                value = json.loads(value)
+            except json.JSONDecodeError:
+                pass  # Keep as string
+            
+            result[key] = value
+        else:
+            # Maybe it's a file path?
+            from pathlib import Path
+            if Path(item).exists():
+                import yaml
+                with open(item) as f:
+                    file_vars = yaml.safe_load(f)
+                    if isinstance(file_vars, dict):
+                        result.update(file_vars)
+    
+    return result
+
+
+def main(args: list[str] | None = None) -> int:
+    """Main entrypoint for sansible-playbook CLI."""
+    parser = create_parser()
+    parsed = parser.parse_args(args)
+    
+    # If no playbook provided, show help
+    if not parsed.playbook:
+        parser.print_help()
+        return 0
+    
+    # Validate inventory is provided
+    if not parsed.inventory:
+        print("ERROR: Inventory (-i/--inventory) is required", file=sys.stderr)
+        return 3
+    
+    # Parse extra vars
+    extra_vars = _parse_extra_vars(parsed.extra_vars)
+    
+    # Create and run the playbook runner
+    from sansible.engine.runner import PlaybookRunner
+    
+    runner = PlaybookRunner(
+        inventory_source=parsed.inventory,
+        playbook_paths=parsed.playbook,
+        forks=parsed.forks,
+        limit=parsed.limit,
+        check_mode=parsed.check,
+        diff_mode=parsed.diff,
+        verbosity=parsed.verbose,
+        extra_vars=extra_vars,
+        json_output=parsed.json,
+    )
+    
+    return runner.run()
+
+
+if __name__ == "__main__":
+    sys.exit(main())