mcp-souschef 2.5.3__py3-none-any.whl → 3.0.0__py3-none-any.whl

{mcp_souschef-2.5.3.dist-info → mcp_souschef-3.0.0.dist-info}/METADATA

@@ -1,31 +1,44 @@
 Metadata-Version: 2.4
 Name: mcp-souschef
-Version: 2.5.3
+Version: 3.0.0
 Summary: AI-powered MCP server for Chef to Ansible conversion
 License: MIT
 License-File: LICENSE
+Keywords: chef,ansible,migration,infrastructure,automation,mcp,ai,conversion
 Author: SousChef Contributors
-Requires-Python: >=3.14,<4.0
+Requires-Python: >=3.13,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
 Provides-Extra: ui
 Requires-Dist: anthropic (>=0.75.0)
 Requires-Dist: click (>=8.1.0)
 Requires-Dist: mcp (>=1.25.0)
+Requires-Dist: openai (>=1.0.0)
 Requires-Dist: pandas (>=2.0.0) ; extra == "ui"
 Requires-Dist: plotly (>=5.0.0)
 Requires-Dist: python-dotenv (>=1.2.1)
 Requires-Dist: pyyaml (>=6.0.0)
 Requires-Dist: streamlit (>=1.28.0)
 Requires-Dist: zod (>=0.8.0)
+Project-URL: Documentation, https://kpeacocke.github.io/souschef/
+Project-URL: Homepage, https://github.com/kpeacocke/souschef
+Project-URL: Repository, https://github.com/kpeacocke/souschef
 Description-Content-Type: text/markdown
 
 # Chef to Ansible migration - SousChef MCP
 
 An AI-powered MCP (Model Context Protocol) server that provides comprehensive Chef-to-Ansible migration capabilities for enterprise infrastructure transformation.
 
-[![PyPI version](https://img.shields.io/pypi/v/mcp-souschef.svg)](https://pypi.org/project/mcp-souschef/)
+[![GitHub release](https://img.shields.io/github/v/release/kpeacocke/souschef)](https://github.com/kpeacocke/souschef/releases)
 [![Python Version](https://img.shields.io/badge/python-3.14%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Test Coverage](https://img.shields.io/badge/coverage-91%25-brightgreen.svg)](htmlcov/index.html)
@@ -37,17 +50,17 @@ An AI-powered MCP (Model Context Protocol) server that provides comprehensive Ch
 
 ## Overview - Chef to Ansible features
 
-SousChef is a complete enterprise-grade migration platform with **27 primary MCP tools** organised across **9 major capability areas** to facilitate Chef-to-Ansible AWX/AAP migrations. From cookbook analysis to deployment pattern conversion, including Chef Habitat to containerised deployments and CI/CD pipeline generation, SousChef provides everything needed for a successful infrastructure automation migration.
+SousChef is a complete enterprise-grade migration platform with **32 primary MCP tools** organised across **10 major capability areas** to facilitate Chef-to-Ansible AWX/AAP migrations. From cookbook analysis to deployment pattern conversion, including Chef Habitat to containerised deployments and CI/CD pipeline generation, SousChef provides everything needed for a successful infrastructure automation migration.
 
 ### About Tool Counts
 
-**Why 27 tools in the documentation but more in the server?**
+**Why 32 tools in the documentation but more in the server?**
 
-The MCP server provides **37 total tools** (35 public + 2 internal). This documentation focuses on the **27 primary user-facing tools** that cover the main migration capabilities. The remaining 10 tools are low-level filesystem operations and helper utilities used internally by the main tools.
+The MCP server provides **37 total tools** (35 public + 2 internal). This documentation focuses on the **32 primary user-facing tools** that cover the main migration capabilities. The remaining 3 tools are low-level filesystem operations and helper utilities used internally by the main tools.
 
 As a user, you'll primarily interact with the 27 documented tools. Your AI assistant may use the additional tools automatically when needed, but you don't need to know about them for successful migrations.
 
-> 💡 **For developers:** See `souschef/server.py` for the complete list of all 37 registered tools.
+> **For developers:** See `souschef/server.py` for the complete list of all 37 registered tools.
 
 ## Model Agnostic - Works with Any AI Model
 
@@ -95,7 +108,7 @@ Complete cookbook introspection and analysis tools:
 - **list_directory** - Navigate and explore cookbook directory structures
 - **read_file** - Read cookbook files with error handling
 - **read_cookbook_metadata** - Parse metadata.rb files for dependencies and cookbook information
-- **parse_recipe** - Analyze Chef recipes and extract resources, actions, and properties
+- **parse_recipe** - Analyse Chef recipes and extract resources, actions, and properties
 - **parse_attributes** - Parse attribute files with **advanced precedence resolution** (6 levels: default, force_default, normal, override, force_override, automatic)
 - **list_cookbook_structure** - Display complete cookbook directory hierarchy
 
@@ -116,7 +129,7 @@ Convert Chef search patterns to dynamic Ansible inventory:
 
 - **convert_chef_search_to_inventory** - Transform Chef search queries to Ansible inventory groups
 - **generate_dynamic_inventory_script** - Create dynamic inventory scripts from Chef server queries
-- **analyze_chef_search_patterns** - Discover and analyze search usage in cookbooks
+- **analyse_chef_search_patterns** - Discover and analyse search usage in cookbooks
 
 ### 4. InSpec Integration & Validation
 Complete InSpec-to-Ansible testing pipeline:
@@ -130,14 +143,14 @@ Chef data bags to Ansible vars/vault conversion:
 
 - **convert_chef_databag_to_vars** - Transform data bags to Ansible variable files
 - **generate_ansible_vault_from_databags** - Convert encrypted data bags to Ansible Vault
-- **analyze_chef_databag_usage** - Analyze data bag usage patterns in cookbooks
+- **analyse_chef_databag_usage** - Analyse data bag usage patterns in cookbooks
 
 ### 6. Environment & Configuration Management
 Chef environments to Ansible inventory groups:
 
 - **convert_chef_environment_to_inventory_group** - Transform Chef environments to inventory
 - **generate_inventory_from_chef_environments** - Generate complete inventory from environments
-- **analyze_chef_environment_usage** - Analyze environment usage in cookbooks
+- **analyse_chef_environment_usage** - Analyse environment usage in cookbooks
 
 ### 7. AWX/Ansible Automation Platform Integration
 Enterprise AWX/AAP configuration generation:
@@ -263,10 +276,10 @@ Output formats:
 - **json**: Structured JSON for programmatic processing
 - **summary**: Quick overview with counts only
 
-- **analyze_chef_application_patterns** - Identify application deployment patterns
+- **analyse_chef_application_patterns** - Identify application deployment patterns
 - **assess_chef_migration_complexity** - Comprehensive migration complexity assessment
 - **generate_migration_plan** - Create detailed migration execution plans
-- **analyze_cookbook_dependencies** - Analyze dependencies and migration order
+- **analyse_cookbook_dependencies** - Analyse dependencies and migration order
 - **generate_migration_report** - Generate executive and technical migration reports
 
 ## Migration Workflow
@@ -276,8 +289,8 @@ Output formats:
 # Assess migration complexity
 assess_chef_migration_complexity /path/to/cookbooks
 
-# Analyze cookbook dependencies
-analyze_cookbook_dependencies /path/to/cookbook
+# Analyse cookbook dependencies
+analyse_cookbook_dependencies /path/to/cookbook
 
 # Generate migration plan
 generate_migration_plan '{\"cookbooks\": [\"/path/to/cookbook1\", \"/path/to/cookbook2\"]}'
@@ -369,6 +382,79 @@ souschef ui
 souschef ui --port 8080
 ```
 
+**Run in Docker:**
+```bash
+# Build the image
+docker build -t souschef-ui .
+
+# Run the container
+docker run -p 9999:9999 souschef-ui
+
+# Or use docker-compose
+docker-compose up
+```
+
+**Docker Environment Configuration:**
+
+SousChef supports AI configuration via environment variables in Docker containers. Create a `.env` file in your project root:
+
+```bash
+# Copy the example environment file
+cp .env.example .env
+
+# Edit with your AI provider settings
+nano .env
+```
+
+**Example .env file:**
+```dotenv
+# AI Configuration
+SOUSCHEF_AI_PROVIDER=Anthropic (Claude)
+SOUSCHEF_AI_MODEL=claude-3-5-sonnet-20241022
+SOUSCHEF_AI_API_KEY=your-api-key-here
+SOUSCHEF_AI_BASE_URL=
+SOUSCHEF_AI_PROJECT_ID=
+SOUSCHEF_AI_TEMPERATURE=0.7
+SOUSCHEF_AI_MAX_TOKENS=4000
+
+# Streamlit Configuration (optional)
+STREAMLIT_SERVER_PORT=9999
+STREAMLIT_SERVER_HEADLESS=true
+```
+
+**Supported AI Providers:**
+- `Anthropic (Claude)` - Anthropic Claude models
+- `OpenAI (GPT)` - OpenAI GPT models
+- `IBM Watsonx` - IBM Watsonx AI models
+- `Red Hat Lightspeed` - Red Hat Lightspeed models
+
+**Environment Variables:**
+- `SOUSCHEF_AI_PROVIDER` - AI provider name (required)
+- `SOUSCHEF_AI_MODEL` - Model name (required)
+- `SOUSCHEF_AI_API_KEY` - API key for authentication (required)
+- `SOUSCHEF_AI_BASE_URL` - Custom API base URL (optional)
+- `SOUSCHEF_AI_PROJECT_ID` - Project ID for Watsonx (optional)
+- `SOUSCHEF_AI_TEMPERATURE` - Model temperature 0.0-2.0 (optional, default: 0.7)
+- `SOUSCHEF_AI_MAX_TOKENS` - Maximum tokens to generate (optional, default: 4000)
+
+**Docker Compose (recommended for development):**
+```yaml
+version: '3.8'
+services:
+  souschef-ui:
+    build: .
+    ports:
+      - "9999:9999"
+    env_file:
+      - .env
+    environment:
+      - PYTHONPATH=/app
+      - STREAMLIT_SERVER_ADDRESS=0.0.0.0
+      - STREAMLIT_SERVER_PORT=9999
+      - STREAMLIT_SERVER_HEADLESS=true
+    restart: unless-stopped
+```
+
 **Features:**
 - Clean, professional design matching documentation standards
 - Real-time cookbook analysis with progress indicators
@@ -592,7 +678,7 @@ Each MCP tool includes comprehensive documentation:
 - **[Testing Strategy Guide](docs/testing-strategy.md)** - Validation and testing approaches
 - **[Best Practices](docs/best-practices.md)** - Recommended patterns and approaches
 
-## 🤝 Contributing
+## Contributing
 
 We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Development setup and workflow
@@ -600,13 +686,13 @@ We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Pull request process
 - Issue reporting guidelines
 
-## 📄 License
+## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## Roadmap
 
-### Completed ✅
+### Completed
 -  Complete Chef cookbook parsing (recipes, attributes, metadata, templates)
 -  InSpec profile parsing and conversion to Testinfra/Ansible tests
 -  Chef resource to Ansible task conversion with module mapping
@@ -636,8 +722,13 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 -  **Interactive dependency mapping and visualization** with Plotly graphs and NetworkX analysis
 -  **Real-time progress tracking** for all analysis operations with Streamlit progress bars
 -  **Static graph visualization** with matplotlib for reports and documentation
+-  **Automated ERB to Jinja2 template conversion** - Converts Chef ERB templates to Ansible Jinja2 templates during cookbook conversion
+   -  Converts ERB syntax to Jinja2: `<%= var %>` → `{{ var }}`, `<% if %>` → `{% if %}`
+   -  Extracts template variables for validation and documentation
+   -  Includes converted templates in downloadable playbook archives
+   -  UI displays converted templates with variable lists and preview
 
-### Planned 📅
+### Planned
 - 📅 Enhanced graph layout algorithms for large dependency networks (force-directed, hierarchical)
 - 📅 Export functionality for graphs (PNG, SVG, PDF formats)
 - 📅 UI configuration options and themes
@@ -649,7 +740,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 📅 Migration templates and presets
 - 📅 Terraform provider for infrastructure state management
 
-## 🙋‍♀️ Support & Community
+## Support & Community
 
 - **Issues**: [GitHub Issues](https://github.com/kpeacocke/souschef/issues)
 - **Discussions**: [GitHub Discussions](https://github.com/kpeacocke/souschef/discussions)
@@ -657,7 +748,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**SousChef** - *Transforming infrastructure automation, one recipe at a time.* ✨
+**SousChef** - *Transforming infrastructure automation, one recipe at a time.*
   desc 'Ensure package nginx is properly configured'
   impact 1.0
 
@@ -1361,12 +1452,28 @@ The project includes several VS Code tasks:
 
 ## Contributing
 
-Contributions are welcome! Please ensure:
-1. All tests pass
-2. Code coverage maintained at 90%+
-3. Code passes ruff linting
-4. All functions have type hints and docstrings
-5. Follow the development standards in `.github/copilot-instructions.md`
+Thank you for your interest in contributing to SousChef!
+
+**Before you start**, please read the [**Architecture Guide**](docs/ARCHITECTURE.md) to understand where different code belongs and why. This is essential for understanding how to structure your contributions.
+
+For complete contributing guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md), which includes:
+- Development setup instructions
+- Code standards and quality tools
+- Testing requirements and patterns
+- Commit conventions and PR process
+- Release procedures
+
+**Quick Checklist for Contributions:**
+1. Read [**docs/ARCHITECTURE.md**](docs/ARCHITECTURE.md) to understand module structure
+2. Ensure all tests pass: `poetry run pytest`
+3. Code passes linting: `poetry run ruff check .`
+4. Code is formatted: `poetry run ruff format .`
+5. Type hints are complete: `poetry run mypy souschef`
+6. Coverage maintained at 90%+
+7. All functions have docstrings
+8. Follow [conventional commits](CONTRIBUTING.md#commit-message-format)
+
+Questions? Check [ARCHITECTURE.md](docs/ARCHITECTURE.md) for module responsibilities or [CONTRIBUTING.md](CONTRIBUTING.md) for the full developer guide.
 
 ## License
 
@@ -1374,5 +1481,5 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**SousChef** - *Ansible automation, one recipe at a time.* ✨
+**SousChef** - *Ansible automation, one recipe at a time.*
 

mcp_souschef-3.0.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+souschef/__init__.py,sha256=Wh2DPfy1eWvoA8u1fNr_bY5TPEJvHZMVJ76TtxpmPxM,1521
+souschef/assessment.py,sha256=YOv-EgZHmiBV9IiCxNOi4fYwGl8_0ntoU2kKMgERUTc,93256
+souschef/ci/__init__.py,sha256=GHaqDk4auB2kI7_fQtF2FRg5nP-iX6wJchj_uTlXcYg,411
+souschef/ci/common.py,sha256=kDqIC9cTUN398NgM29cn8HmMjckxvEQ5ENclOZRS8fw,4746
+souschef/ci/github_actions.py,sha256=EVnnOPTLCeUmTfR-acpLp-c_dxapMfrrDWaK4SSBkdM,7818
+souschef/ci/gitlab_ci.py,sha256=4FcK8edci3ixuiUtYb6EFaAfsqjz0OBmW-lyPLH3YzY,6708
+souschef/ci/jenkins_pipeline.py,sha256=XEuZrVKVmOlQOKucgGcd3vhAFh5qT05ILNnjKjkqTPU,7362
+souschef/cli.py,sha256=yB6xo8YqDEWwTgD0RHGHcWFfOrK6fIKM7CRxDcGYgQg,37291
+souschef/converters/__init__.py,sha256=kkPm758XiFDdUYvdVPAVjssFvf15LasJcob1EY1EMIs,681
+souschef/converters/cookbook_specific.py,sha256=ZvE9-bZtyXuf2E3HW4E9_GWzAqtm7e4YHj9qm1Xu_XI,3767
+souschef/converters/cookbook_specific.py.backup,sha256=9XycZz6oNNTEtLINo0hHNR3df-pbZIkLprhLniE2ENI,3468
+souschef/converters/habitat.py,sha256=4eVGAcX0576zLXW9yqYvuaRxOK2g6BOIJo_ws-PonHU,22516
+souschef/converters/playbook.py,sha256=Ll6gAmUNr30LYGRY3p2eT28knvoKl1LuMI-WxaZZ8PY,91909
+souschef/converters/resource.py,sha256=NYMcp1-obg_ad_XPuYDuUH_0j65agRbAeWzXPfbSi5c,13570
+souschef/converters/template.py,sha256=swX7LpWrKZgFtg6MaR7rltShBkPDbQAb65d1NF_nILo,5447
+souschef/core/__init__.py,sha256=80a0G6wQGfh-Z7U1gsFaeC97bM4sp_3YGil-lN02Pl0,1894
+souschef/core/constants.py,sha256=AyIpc9cJjQEDc1yOcoKc_2-cJB4PekSpPKEK2S9jDl8,5122
+souschef/core/errors.py,sha256=zj_LHDRxUvHmcs-nZjOWu4B_MhY5WVq2okyZOxyycCI,8605
+souschef/core/metrics.py,sha256=k56opuVmRorrBwErbxLgXu_GkfGZXA_rEfhcsHs1JHI,9850
+souschef/core/path_utils.py,sha256=2hG6joupZR_08MMpHHbv2KKOFu-8tMafuQMqV0_1Nqw,1790
+souschef/core/ruby_utils.py,sha256=vUeFZBdjbFFFJlwo4fIboR23rXmbcYL2Tztt4RYhps0,1043
+souschef/core/validation.py,sha256=DXfkm1p5prSAJ-Oruk5JekNiDFI49Dql1bGEzKymYXs,19158
+souschef/deployment.py,sha256=ZCrVK5Ik4TbVfoJ3dS1-6FNUzxfIE6kni5Fnj3rIbCk,61908
+souschef/filesystem/__init__.py,sha256=2H7Pdeedz0MfmgpRlmii_vx61qr0jtxFndT0APPm6Qs,142
+souschef/filesystem/operations.py,sha256=OMMozBfV_o70b47KioiZ2i6HViiUQPE5mVBeKcKFepo,1654
+souschef/parsers/__init__.py,sha256=gF-vPslzs9iLxsaDzFnWDPpYFDAIwyAifjUwzYurPLg,1104
+souschef/parsers/attributes.py,sha256=JmgFaYjlT0i2__hCk6hSqZRjq4xJaTdGsBDgHEu3ItY,18239
+souschef/parsers/habitat.py,sha256=CtVgLfmpo7SLp-ADyR-DXRYaRUur3bwJjlnpLyocMhc,10483
+souschef/parsers/inspec.py,sha256=zhlIDZmE6A9qws5gnrLxhGGBfHOebNTLWpZZI-XXTkU,34209
+souschef/parsers/metadata.py,sha256=laSxlsebsgTzRDM_B8eIXddeApbR4ATm-W4GAGucZpc,6324
+souschef/parsers/recipe.py,sha256=guhEttS_AyT2kckbde3_-kAyGoR4JyFMNZFAP5V1XIM,7090
+souschef/parsers/resource.py,sha256=EHxmojbQ7Hx5GsL5-x9mFBYk3FhGTpx-qw1uUVKQkRo,5348
+souschef/parsers/template.py,sha256=iOHMoQH7KkPzigTyyoxav8rb2ENYmfxgcvKGqvoYkgU,10532
+souschef/profiling.py,sha256=a6Pn57CZR3UPR1YIY8gfbuTPRuPkFrfIFBmctOcaZgY,17315
+souschef/server.py,sha256=JJyGSAHzbMxL2PMJVdlLlmNjXESjo6MUmjniNXGdSnc,111463
+souschef/ui/__init__.py,sha256=U3W6X4ww7CxQVuetcocObWn5iY6lUFiNX7WoDBJeD34,195
+souschef/ui/app.py,sha256=DlUeYP7eqw76JqIGGHCb13kP1qzq0Rj4X1pEN1_eW-Y,101409
+souschef/ui/health_check.py,sha256=mEzec8L6XPRekOBAXngqQz5dnzal-a4p3D70mkPriiA,903
+souschef/ui/pages/ai_settings.py,sha256=tIwgWBqxCEqFykmrLRPiVQjl-m-I1Mbq0RoB1YA5faM,17774
+souschef/ui/pages/cookbook_analysis.py,sha256=92LRrRMi_YbjOLN-zhNH4ZYnO0HK_OMA--CPSYn2I1E,123424
+souschef/ui/pages/validation_reports.py,sha256=R3xHTJb_y2b0tI8N0qPF1oS4f9ZVb539_82dj5nmmxA,7593
+mcp_souschef-3.0.0.dist-info/METADATA,sha256=B96FJM5QKIJCGLMaXqSrR5NLue-3Y9x8nnigYvcuYHw,54133
+mcp_souschef-3.0.0.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+mcp_souschef-3.0.0.dist-info/entry_points.txt,sha256=NVSk61tLG4W0xEkWGOMXAVCIUyodyZCY_j3Z_0m6rkQ,80
+mcp_souschef-3.0.0.dist-info/licenses/LICENSE,sha256=t31dYSuvYYNw6trj-coWSsLK-Tg_Iyl8ObcolQcrUKM,1078
+mcp_souschef-3.0.0.dist-info/RECORD,,

{mcp_souschef-2.5.3.dist-info → mcp_souschef-3.0.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.2.1
+Generator: poetry-core 2.3.0
 Root-Is-Purelib: true
 Tag: py3-none-any

souschef/__init__.py

@@ -1,17 +1,57 @@
 """SousChef: AI-powered Chef to Ansible converter."""
 
-from souschef.assessment import (
-    analyze_cookbook_dependencies,
+from pathlib import Path
+
+import tomllib
+
+
+# Read version from pyproject.toml
+def _get_version() -> str:
+    """Get version from pyproject.toml."""
+    pyproject_path = Path(__file__).parent.parent / "pyproject.toml"
+    try:
+        with pyproject_path.open("rb") as f:
+            data = tomllib.load(f)
+        version = data.get("tool", {}).get("poetry", {}).get("version")
+        return str(version) if version else "unknown"
+    except OSError:
+        return "unknown"
+
+
+__version__ = _get_version()
+
+from souschef.assessment import (  # noqa: E402
+    analyse_cookbook_dependencies,
     assess_chef_migration_complexity,
     generate_migration_plan,
     generate_migration_report,
     validate_conversion,
 )
+from souschef.deployment import (  # noqa: E402
+    analyse_chef_application_patterns,
+)
+
+# Import server functions only if MCP is available
+try:
+    from souschef.server import (
+        analyse_chef_search_patterns,
+    )
+
+    _server_available = True
+except ImportError:
+    _server_available = False
+
+    # Define a placeholder function for when MCP is not available
+    def analyse_chef_search_patterns(*args, **kwargs):
+        raise NotImplementedError("MCP server not available")
+
 
 __all__ = [
-    "analyze_cookbook_dependencies",
+    "analyse_cookbook_dependencies",
     "assess_chef_migration_complexity",
     "generate_migration_plan",
     "generate_migration_report",
     "validate_conversion",
+    "analyse_chef_application_patterns",
+    "analyse_chef_search_patterns",
 ]