sansible 0.2.0__tar.gz

sansible-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sansible Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sansible-0.2.0/PKG-INFO

@@ -0,0 +1,320 @@
+Metadata-Version: 2.4
+Name: sansible
+Version: 0.2.0
+Summary: Small Ansible - Minimal Ansible-compatible runner for Windows and Linux
+Author: Sansible Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/small-ansible/sansible
+Project-URL: Documentation, https://github.com/small-ansible/sansible/docs
+Project-URL: Repository, https://github.com/small-ansible/sansible
+Keywords: ansible,automation,configuration-management,windows,ssh,winrm,devops,infrastructure,small-ansible
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jinja2>=3.0
+Provides-Extra: ssh
+Requires-Dist: asyncssh>=2.14.0; extra == "ssh"
+Provides-Extra: winrm
+Requires-Dist: pypsrp>=0.8.0; extra == "winrm"
+Provides-Extra: all
+Requires-Dist: sansible[ssh,winrm]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ansible-core>=2.15.0; extra == "dev"
+Requires-Dist: docker>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# Sansible
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Pure Python](https://img.shields.io/badge/wheel-py3--none--any-green.svg)](https://pypi.org/project/sansible/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**A minimal, pure-Python Ansible runner for Windows and Linux**
+
+Sansible runs Ansible playbooks natively on Windows without WSL, targeting both Windows (WinRM) and Linux (SSH) hosts. It delivers 80% of Ansible's value with 20% of the code.
+
+## ✨ Highlights
+
+- 🪟 **Windows Native** — Run as a control node on Windows, no WSL required
+- 🐍 **Pure Python** — Ships as \`py3-none-any\` wheel, no compiled extensions
+- 🚀 **Fast Setup** — \`pip install sansible\` and you're ready
+- 📦 **Ansible Compatible** — Uses the same playbook/inventory syntax
+- 🎯 **Focused** — Core features that cover most use cases
+
+## 🚀 Quick Start
+
+### Installation
+
+\`\`\`bash
+# Basic installation (local execution only)
+pip install sansible
+
+# With SSH support (Linux/Unix targets)
+pip install "sansible[ssh]"
+
+# With WinRM support (Windows targets)
+pip install "sansible[winrm]"
+
+# Full installation (all transports)
+pip install "sansible[all]"
+\`\`\`
+
+### Your First Playbook
+
+Create \`hello.yml\`:
+
+\`\`\`yaml
+---
+- name: Hello World
+  hosts: localhost
+  gather_facts: false
+  tasks:
+    - name: Say hello
+      debug:
+        msg: "Hello from Sansible!"
+    
+    - name: Run a command
+      command: echo "It works!"
+      register: result
+    
+    - name: Show result
+      debug:
+        var: result.stdout
+\`\`\`
+
+Create \`inventory.ini\`:
+
+\`\`\`ini
+[local]
+localhost ansible_connection=local
+\`\`\`
+
+Run it:
+
+\`\`\`bash
+san run -i inventory.ini hello.yml
+\`\`\`
+
+Output:
+
+\`\`\`
+PLAY [Hello World] ************************************************************
+
+TASK [Say hello] **************************************************************
+ok: [localhost]
+
+TASK [Run a command] **********************************************************
+changed: [localhost]
+
+TASK [Show result] ************************************************************
+ok: [localhost]
+
+PLAY RECAP ********************************************************************
+localhost                  : ok=3    changed=1    failed=0
+\`\`\`
+
+## 📖 Examples
+
+The \`examples/playbooks/\` directory contains runnable examples for all features:
+
+| Playbook | Features |
+|----------|----------|
+| [01_basics.yml](examples/playbooks/01_basics.yml) | debug, set_fact, command, shell, copy |
+| [02_conditionals.yml](examples/playbooks/02_conditionals.yml) | when, loop, register, changed_when |
+| [03_file_management.yml](examples/playbooks/03_file_management.yml) | file, copy, stat, lineinfile |
+| [04_handlers.yml](examples/playbooks/04_handlers.yml) | handlers, notify, listen |
+| [05_blocks.yml](examples/playbooks/05_blocks.yml) | block, rescue, always |
+| [06_become.yml](examples/playbooks/06_become.yml) | become (sudo) |
+| [07_gather_facts.yml](examples/playbooks/07_gather_facts.yml) | gather_facts, setup |
+| [08_wait_for.yml](examples/playbooks/08_wait_for.yml) | wait_for (port, file) |
+| [09_assert_fail.yml](examples/playbooks/09_assert_fail.yml) | assert, fail |
+| [10_roles.yml](examples/playbooks/10_roles.yml) | roles |
+| [11_check_diff.yml](examples/playbooks/11_check_diff.yml) | --check, --diff modes |
+
+**Windows Examples:**
+
+| Playbook | Features |
+|----------|----------|
+| [win_01_basics.yml](examples/playbooks/win_01_basics.yml) | win_command, win_shell, win_copy |
+| [win_02_services.yml](examples/playbooks/win_02_services.yml) | win_service |
+| [win_03_files.yml](examples/playbooks/win_03_files.yml) | win_stat, win_lineinfile |
+
+Run any example:
+
+\`\`\`bash
+san run -i examples/playbooks/inventory.ini examples/playbooks/01_basics.yml -l localhost
+\`\`\`
+
+## 🛠 Supported Features
+
+### Modules
+
+| Linux | Windows | Purpose |
+|-------|---------|---------|
+| \`command\` | \`win_command\` | Execute command |
+| \`shell\` | \`win_shell\` | Execute shell/PowerShell |
+| \`copy\` | \`win_copy\` | Copy files |
+| \`file\` | \`win_file\` | Manage files/directories |
+| \`template\` | — | Render Jinja2 templates |
+| \`stat\` | \`win_stat\` | Get file info |
+| \`lineinfile\` | \`win_lineinfile\` | Manage lines in files |
+| \`wait_for\` | \`win_wait_for\` | Wait for port/file |
+| \`setup\` | \`setup\` | Gather facts |
+| \`debug\` | \`debug\` | Print messages |
+| \`set_fact\` | \`set_fact\` | Set variables |
+| \`fail\` | \`fail\` | Fail with message |
+| \`assert\` | \`assert\` | Assert conditions |
+| — | \`win_service\` | Manage Windows services |
+
+### Playbook Features
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Multiple plays | ✅ | Sequential execution |
+| Variables (\`vars\`, \`vars_files\`) | ✅ | Full support |
+| Conditionals (\`when\`) | ✅ | Jinja2 expressions |
+| Loops (\`loop\`, \`with_items\`) | ✅ | List iteration |
+| Handlers (\`notify\`, \`listen\`) | ✅ | Triggered on change |
+| Error handling (\`block/rescue/always\`) | ✅ | Try/catch blocks |
+| Privilege escalation (\`become\`) | ✅ | sudo, su |
+| Fact gathering (\`gather_facts\`) | ✅ | OS info |
+| Roles | ✅ | tasks, defaults, vars |
+| Check mode (\`--check\`) | ✅ | Dry run |
+| Diff mode (\`--diff\`) | ✅ | Show changes |
+| JSON output (\`--json\`) | ✅ | Machine-readable |
+
+### Connections
+
+| Type | Dependency | Platform |
+|------|------------|----------|
+| \`local\` | None | Control node |
+| \`ssh\` | \`asyncssh\` | Linux/Unix |
+| \`winrm\` | \`pypsrp\` | Windows |
+
+## 📋 CLI Reference
+
+### san run / sansible-playbook
+
+\`\`\`bash
+san run -i INVENTORY PLAYBOOK [OPTIONS]
+
+Options:
+  -i, --inventory FILE    Inventory file (required)
+  -l, --limit PATTERN     Limit to hosts matching pattern
+  -t, --tags TAGS         Only run tagged tasks
+  --skip-tags TAGS        Skip tagged tasks
+  -e, --extra-vars VARS   Extra variables (JSON or key=value)
+  -f, --forks N           Parallel execution limit (default: 5)
+  -C, --check             Dry-run mode (no changes)
+  --diff                  Show file differences
+  --json                  JSON output format
+  -v/-vv/-vvv             Verbosity level
+\`\`\`
+
+### Examples
+
+\`\`\`bash
+# Basic execution
+san run -i inventory.ini playbook.yml
+
+# Limit to specific hosts
+san run -i inventory.ini playbook.yml -l webservers
+
+# Check mode (dry run)
+san run -i inventory.ini playbook.yml --check
+
+# Show what would change
+san run -i inventory.ini playbook.yml --check --diff
+
+# Extra variables
+san run -i inventory.ini playbook.yml -e "version=2.0"
+
+# JSON output for scripting
+san run -i inventory.ini playbook.yml --json
+\`\`\`
+
+## ⚠️ Not Supported
+
+Sansible focuses on core features. These are **not supported**:
+
+- Ansible Galaxy / Collections
+- \`include_tasks\`, \`import_tasks\`, \`import_role\`
+- \`delegate_to\`
+- \`async\` / \`poll\`
+- Vault
+- Callbacks / Plugins
+- Dynamic inventory scripts
+
+Unsupported features raise \`UnsupportedFeatureError\` with a clear message.
+
+## 🔧 Development
+
+\`\`\`bash
+# Clone repository
+git clone https://github.com/your-org/sansible.git
+cd sansible
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/unit/ -v
+
+# Run a specific test
+pytest tests/unit/test_become.py -v
+
+# Build wheel
+pip wheel . -w dist/
+
+# Verify pure Python wheel
+python -m tools.dep_audit
+\`\`\`
+
+## 📊 Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 2 | Host failure(s) |
+| 3 | Parse/syntax error |
+| 4 | Unsupported feature |
+
+## 📚 Documentation
+
+- [Architecture](docs/ARCHITECTURE.md) — System design
+- [Compatibility](docs/COMPATIBILITY.md) — Feature matrix
+- [Testing](docs/TESTING.md) — Test instructions
+- [Contributing](docs/AI_HANDOFF.md) — Development guide
+
+## 📄 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+
+---
+
+**Made with ❤️ for Windows DevOps engineers who just want to run playbooks.**

sansible-0.2.0/README.md

@@ -0,0 +1,270 @@
+# Sansible
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Pure Python](https://img.shields.io/badge/wheel-py3--none--any-green.svg)](https://pypi.org/project/sansible/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**A minimal, pure-Python Ansible runner for Windows and Linux**
+
+Sansible runs Ansible playbooks natively on Windows without WSL, targeting both Windows (WinRM) and Linux (SSH) hosts. It delivers 80% of Ansible's value with 20% of the code.
+
+## ✨ Highlights
+
+- 🪟 **Windows Native** — Run as a control node on Windows, no WSL required
+- 🐍 **Pure Python** — Ships as \`py3-none-any\` wheel, no compiled extensions
+- 🚀 **Fast Setup** — \`pip install sansible\` and you're ready
+- 📦 **Ansible Compatible** — Uses the same playbook/inventory syntax
+- 🎯 **Focused** — Core features that cover most use cases
+
+## 🚀 Quick Start
+
+### Installation
+
+\`\`\`bash
+# Basic installation (local execution only)
+pip install sansible
+
+# With SSH support (Linux/Unix targets)
+pip install "sansible[ssh]"
+
+# With WinRM support (Windows targets)
+pip install "sansible[winrm]"
+
+# Full installation (all transports)
+pip install "sansible[all]"
+\`\`\`
+
+### Your First Playbook
+
+Create \`hello.yml\`:
+
+\`\`\`yaml
+---
+- name: Hello World
+  hosts: localhost
+  gather_facts: false
+  tasks:
+    - name: Say hello
+      debug:
+        msg: "Hello from Sansible!"
+    
+    - name: Run a command
+      command: echo "It works!"
+      register: result
+    
+    - name: Show result
+      debug:
+        var: result.stdout
+\`\`\`
+
+Create \`inventory.ini\`:
+
+\`\`\`ini
+[local]
+localhost ansible_connection=local
+\`\`\`
+
+Run it:
+
+\`\`\`bash
+san run -i inventory.ini hello.yml
+\`\`\`
+
+Output:
+
+\`\`\`
+PLAY [Hello World] ************************************************************
+
+TASK [Say hello] **************************************************************
+ok: [localhost]
+
+TASK [Run a command] **********************************************************
+changed: [localhost]
+
+TASK [Show result] ************************************************************
+ok: [localhost]
+
+PLAY RECAP ********************************************************************
+localhost                  : ok=3    changed=1    failed=0
+\`\`\`
+
+## 📖 Examples
+
+The \`examples/playbooks/\` directory contains runnable examples for all features:
+
+| Playbook | Features |
+|----------|----------|
+| [01_basics.yml](examples/playbooks/01_basics.yml) | debug, set_fact, command, shell, copy |
+| [02_conditionals.yml](examples/playbooks/02_conditionals.yml) | when, loop, register, changed_when |
+| [03_file_management.yml](examples/playbooks/03_file_management.yml) | file, copy, stat, lineinfile |
+| [04_handlers.yml](examples/playbooks/04_handlers.yml) | handlers, notify, listen |
+| [05_blocks.yml](examples/playbooks/05_blocks.yml) | block, rescue, always |
+| [06_become.yml](examples/playbooks/06_become.yml) | become (sudo) |
+| [07_gather_facts.yml](examples/playbooks/07_gather_facts.yml) | gather_facts, setup |
+| [08_wait_for.yml](examples/playbooks/08_wait_for.yml) | wait_for (port, file) |
+| [09_assert_fail.yml](examples/playbooks/09_assert_fail.yml) | assert, fail |
+| [10_roles.yml](examples/playbooks/10_roles.yml) | roles |
+| [11_check_diff.yml](examples/playbooks/11_check_diff.yml) | --check, --diff modes |
+
+**Windows Examples:**
+
+| Playbook | Features |
+|----------|----------|
+| [win_01_basics.yml](examples/playbooks/win_01_basics.yml) | win_command, win_shell, win_copy |
+| [win_02_services.yml](examples/playbooks/win_02_services.yml) | win_service |
+| [win_03_files.yml](examples/playbooks/win_03_files.yml) | win_stat, win_lineinfile |
+
+Run any example:
+
+\`\`\`bash
+san run -i examples/playbooks/inventory.ini examples/playbooks/01_basics.yml -l localhost
+\`\`\`
+
+## 🛠 Supported Features
+
+### Modules
+
+| Linux | Windows | Purpose |
+|-------|---------|---------|
+| \`command\` | \`win_command\` | Execute command |
+| \`shell\` | \`win_shell\` | Execute shell/PowerShell |
+| \`copy\` | \`win_copy\` | Copy files |
+| \`file\` | \`win_file\` | Manage files/directories |
+| \`template\` | — | Render Jinja2 templates |
+| \`stat\` | \`win_stat\` | Get file info |
+| \`lineinfile\` | \`win_lineinfile\` | Manage lines in files |
+| \`wait_for\` | \`win_wait_for\` | Wait for port/file |
+| \`setup\` | \`setup\` | Gather facts |
+| \`debug\` | \`debug\` | Print messages |
+| \`set_fact\` | \`set_fact\` | Set variables |
+| \`fail\` | \`fail\` | Fail with message |
+| \`assert\` | \`assert\` | Assert conditions |
+| — | \`win_service\` | Manage Windows services |
+
+### Playbook Features
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Multiple plays | ✅ | Sequential execution |
+| Variables (\`vars\`, \`vars_files\`) | ✅ | Full support |
+| Conditionals (\`when\`) | ✅ | Jinja2 expressions |
+| Loops (\`loop\`, \`with_items\`) | ✅ | List iteration |
+| Handlers (\`notify\`, \`listen\`) | ✅ | Triggered on change |
+| Error handling (\`block/rescue/always\`) | ✅ | Try/catch blocks |
+| Privilege escalation (\`become\`) | ✅ | sudo, su |
+| Fact gathering (\`gather_facts\`) | ✅ | OS info |
+| Roles | ✅ | tasks, defaults, vars |
+| Check mode (\`--check\`) | ✅ | Dry run |
+| Diff mode (\`--diff\`) | ✅ | Show changes |
+| JSON output (\`--json\`) | ✅ | Machine-readable |
+
+### Connections
+
+| Type | Dependency | Platform |
+|------|------------|----------|
+| \`local\` | None | Control node |
+| \`ssh\` | \`asyncssh\` | Linux/Unix |
+| \`winrm\` | \`pypsrp\` | Windows |
+
+## 📋 CLI Reference
+
+### san run / sansible-playbook
+
+\`\`\`bash
+san run -i INVENTORY PLAYBOOK [OPTIONS]
+
+Options:
+  -i, --inventory FILE    Inventory file (required)
+  -l, --limit PATTERN     Limit to hosts matching pattern
+  -t, --tags TAGS         Only run tagged tasks
+  --skip-tags TAGS        Skip tagged tasks
+  -e, --extra-vars VARS   Extra variables (JSON or key=value)
+  -f, --forks N           Parallel execution limit (default: 5)
+  -C, --check             Dry-run mode (no changes)
+  --diff                  Show file differences
+  --json                  JSON output format
+  -v/-vv/-vvv             Verbosity level
+\`\`\`
+
+### Examples
+
+\`\`\`bash
+# Basic execution
+san run -i inventory.ini playbook.yml
+
+# Limit to specific hosts
+san run -i inventory.ini playbook.yml -l webservers
+
+# Check mode (dry run)
+san run -i inventory.ini playbook.yml --check
+
+# Show what would change
+san run -i inventory.ini playbook.yml --check --diff
+
+# Extra variables
+san run -i inventory.ini playbook.yml -e "version=2.0"
+
+# JSON output for scripting
+san run -i inventory.ini playbook.yml --json
+\`\`\`
+
+## ⚠️ Not Supported
+
+Sansible focuses on core features. These are **not supported**:
+
+- Ansible Galaxy / Collections
+- \`include_tasks\`, \`import_tasks\`, \`import_role\`
+- \`delegate_to\`
+- \`async\` / \`poll\`
+- Vault
+- Callbacks / Plugins
+- Dynamic inventory scripts
+
+Unsupported features raise \`UnsupportedFeatureError\` with a clear message.
+
+## 🔧 Development
+
+\`\`\`bash
+# Clone repository
+git clone https://github.com/your-org/sansible.git
+cd sansible
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/unit/ -v
+
+# Run a specific test
+pytest tests/unit/test_become.py -v
+
+# Build wheel
+pip wheel . -w dist/
+
+# Verify pure Python wheel
+python -m tools.dep_audit
+\`\`\`
+
+## 📊 Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 2 | Host failure(s) |
+| 3 | Parse/syntax error |
+| 4 | Unsupported feature |
+
+## 📚 Documentation
+
+- [Architecture](docs/ARCHITECTURE.md) — System design
+- [Compatibility](docs/COMPATIBILITY.md) — Feature matrix
+- [Testing](docs/TESTING.md) — Test instructions
+- [Contributing](docs/AI_HANDOFF.md) — Development guide
+
+## 📄 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+
+---
+
+**Made with ❤️ for Windows DevOps engineers who just want to run playbooks.**