PyCloud CI Doctor

Diagnose Python cloud development issues instantly
VS Code extension for Poetry, boto3/aioboto3, and CI/CD troubleshooting

🚀 Features

Automated Project Analysis

Run one command to scan your Python project for common issues:

• 🔍 Poetry Dependency Conflicts

  • Detects boto3 + aioboto3 mixed usage (sync/async conflicts)
  • Identifies missing AWS SDK dependencies when imports are present
  • Cross-references Python files with pyproject.toml

• ⚙️ GitHub Actions Workflow Issues

  • Missing Python version configuration
  • Poetry not installed in CI pipeline
  • Tests running without proper dependency setup

• 📊 VS Code Integration

  • Issues appear directly in the Problems panel
  • Click file paths to jump to problem locations
  • Clear severity indicators (error/warning/info)

📦 Installation

From VS Code Marketplace

1. Open Extensions (Ctrl+Shift+X)
2. Search for "PyCloud CI Doctor"
3. Click Install

From Command Line

code --install-extension KhaldounAljasem.vscode-pycloud-ci-doctor

🛠️ Usage

Quick Start

1. Open a Python project with pyproject.toml (Poetry project)
2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
3. Type: PyCloud CI Doctor: Analyze Project
4. Press Enter

View Results

• Open Problems panel: Ctrl+Shift+M
• Or check Output panel: Select "PyCloud CI Doctor" from dropdown
• Click any issue to navigate to the file

Example Output

⚠️ pyproject.toml (line 8)
   Both boto3 and aioboto3 detected. Ensure async/sync usage is consistent.

❌ .github/workflows/test.yml (line 15)
   Workflow references Poetry but does not install it. Add `pip install poetry`.

🗺️ Roadmap

• ✅ v0.1 - Basic analyzer for pyproject.toml and GitHub Actions
• 🔄 v0.2 - Quick-fix code actions for detected issues
• 📋 v0.3 - Poetry/venv environment detection and management
• 🎯 v1.0 - Full feature release with comprehensive diagnostics

🐛 Known Issues

• TOML and YAML parsing uses regex patterns; full AST parsing coming in v0.2
• GitHub Actions analysis covers common patterns; complex workflows may have edge cases
• Currently only analyzes GitHub Actions; support for GitLab CI and Azure Pipelines planned

Report issues: GitHub Issues

🤝 Contributing

Contributions welcome! See the GitHub repository for:

• Source code
• Issue tracker
• Development setup

📄 License

MIT License - Copyright (c) 2025 Khaldoun

🔗 Resources

• VS Code Marketplace
• GitHub Repository
• Report Issues

Enjoy faster Python development! 🐍✨