Python

Kiro offre de puissantes capacités de développement assistées par l'IA pour les projets Python, vous aidant à écrire, déboguer et maintenir du code plus efficacement.

Avant de vous lancer dans le développement Python avec Kiro, assurez-vous d'avoir :

• Python : Installez la dernière version pour votre plateforme (Python 3.8+ recommandé)
• pip : Installateur de paquets pour Python (fourni avec Python)
• Environnement virtuel : Utilisez venv, virtualenv, ou conda pour la gestion des dépendances
• Git : Pour le contrôle de version et la collaboration

Kiro prend en charge les extensions d'Open VSX qui peuvent améliorer votre expérience de développement Python. Voici quelques extensions utiles que vous pouvez installer :

• Python - Prise en charge du langage Python avec des points d'accès d'extension pour IntelliSense, le débogage (Python Debugger), le linting, le formatage, le refactoring, les tests unitaires, et plus encore.

• PyLint - Prise en charge du linting pour les fichiers Python.

• Jupyter - Prise en charge des blocs-notes Jupyter, programmation et calcul interactifs qui prennent en charge IntelliSense, le débogage et plus encore.

• Python Debugger - Extension de débogueur Python (debugpy) offrant des capacités de débogage pour les applications Python.

• Rainbow CSV - Met en évidence les fichiers CSV et TSV, exécute des requêtes de type SQL

Vous pouvez installer ces extensions dans Kiro, utilisez le panneau Extensions et recherchez les noms d'extensions mentionnés ci-dessus.

Avec Kiro, vous pouvez utiliser les capacités de clavardage pour configurer un nouveau projet ou travailler sur un projet existant.

Kiro peut vous aider à configurer et à maintenir les fichiers de configuration pour vos projets Python, et à organiser votre projet selon les meilleures pratiques Python.

• Initialiser les fichiers de configuration : Demandez à Kiro d'initialiser les fichiers de configuration par défaut en fonction du projet.
• Créer la structure du projet : Demandez à Kiro de créer la structure de votre projet selon vos besoins et les meilleures pratiques.

Exemples de requêtes :

"Set up a requirements.txt with development dependencies"
"Configure a .env file for my Django application"
"Set up a Python package structure with proper __init__.py files"
"Create a Flask project structure with blueprints"
"Organize my data science project with notebooks and modules"
"Create a pyproject.toml for a FastAPI project with pytest and black"

Kiro peut analyser votre code Python pour identifier les problèmes et suggérer des améliorations :

• Analyse de la qualité du code : Demandez à Kiro d'examiner votre code pour détecter des bogues potentiels, des problèmes de performance ou la conformité avec PEP 8
• Aide au refactoring : Obtenez de l'aide pour extraire des fonctions, renommer des variables ou restructurer le code
• Indications de type : Kiro peut suggérer des annotations de type pour améliorer la clarté du code et détecter les erreurs

Exemples de requêtes :

"Analyze this function for potential bugs and performance issues"
"Refactor this code to follow PEP 8 style guidelines"
"Add type hints to this Python module"
"Convert this synchronous code to use async/await"

Lorsque vous rencontrez des erreurs dans votre code Python :

• Explication des erreurs : Kiro peut expliquer les tracebacks Python et les messages d'erreur en langage simple
• Suggestions de solutions : Obtenez des correctifs concrets pour les erreurs Python courantes
• Débogage à l'exécution : Kiro peut vous aider à configurer des configurations de débogage et des points d'arrêt

Exemples :

"Explain this Python error: AttributeError: 'NoneType' object has no attribute 'split'"
"Help me debug this Django view that's returning a 500 error"
"Why is my pandas DataFrame operation so slow?"

Steering vous permet de fournir à Kiro un contexte et des directives spécifiques au projet. Kiro peut générer des fichiers Steering que vous pouvez peaufiner :

1. Résumé du produit (product.md) - Contient des informations sur le produit, son objectif et ses fonctionnalités clés
2. Pile technique (tech.md) - Détaille les technologies, les cadres et les directives de développement
3. Structure du projet (structure.md) - Fournit des informations sur l'organisation du projet

Pour les projets Python, vous pouvez créer des fichiers Steering personnalisés supplémentaires pour fournir des directives plus spécifiques :

Utilisez les instructions suivantes pour ajouter de nouveaux documents Steering à votre projet.

Pour ajouter de nouveaux documents Steering

1. Accédez à la vue Kiro dans la barre latérale.
2. Dans la section Agent Steering, choisissez le bouton + pour créer un nouveau fichier Steering.
3. Entrez un nom pour votre fichier avec un titre descriptif.
4. Ajoutez votre contenu Steering personnalisé en suivant les conventions Markdown.

Les fichiers Steering personnalisés sont stockés dans le répertoire .kiro/steering/ et sont automatiquement reconnus par Kiro pendant les interactions.

Par exemple, vous pouvez définir des conventions de nommage personnalisées, une structure de fichiers ou des pratiques pour votre projet. Créez un fichier Steering python-conventions.md pour définir les normes de programmation de votre équipe :

Python Conventions

Naming Conventions
- Use snake_case for variables and functions
- Use PascalCase for classes
- Use UPPER_SNAKE_CASE for constants
- Use descriptive names that explain purpose

Code Style
- Follow PEP 8 guidelines
- Use Black for code formatting
- Maximum line length of 88 characters
- Use type hints for all public functions

File Structure
- One class per file for large classes
- Group related functions in modules
- Use __init__.py files for package organization
- Separate tests in tests/ directory

Documentation
- Use docstrings for all public functions and classes
- Follow Google or NumPy docstring style
- Include type information in docstrings

Pour les projets Django, créez un fichier Steering django-patterns.md :

Django Development Guidelines

Model Design
- Use descriptive model names
- Add __str__ methods to all models
- Use model managers for complex queries
- Follow Django naming conventions for fields

View Structure
- Prefer class-based views for complex logic
- Use function-based views for simple operations
- Keep business logic in models or services
- Use proper HTTP status codes

Template Organization
- Use template inheritance effectively
- Keep templates DRY with includes and tags
- Use meaningful template names
- Organize templates by app

Performance Best Practices
- Use select_related and prefetch_related for queries
- Implement database indexing for frequently queried fields
- Use caching for expensive operations
- Profile database queries in development

Pour les projets de science des données, créez un fichier Steering data-science-patterns.md :

Data Science Development Guidelines

Notebook Organization
- Use clear section headers and markdown cells
- Keep notebooks focused on single analyses
- Export reusable code to Python modules
- Include data source documentation

Data Handling
- Validate data quality early in pipelines
- Use consistent column naming conventions
- Document data transformations clearly
- Handle missing values explicitly

Model Development
- Use cross-validation for model evaluation
- Track experiments with clear versioning
- Document model assumptions and limitations
- Implement proper train/validation/test splits

Code Organization
- Separate data processing, modeling, and visualization
- Use configuration files for parameters
- Implement logging for long-running processes
- Create reproducible environments with requirements files

Ces fichiers Steering aident Kiro à générer du code qui suit les conventions et les meilleures pratiques spécifiques de votre équipe.

Les Agent Hooks de Kiro peuvent automatiser les tâches courantes de développement Python :

1. Accédez à la section Agent Hooks dans le panneau Kiro
2. Cliquez sur le bouton + pour créer un nouveau Hook
3. Définissez le flux de travail du Hook en langage naturel

Voici quelques exemples de Hooks :

Générez automatiquement des tests lorsque vous enregistrez un fichier Python :

"Create a hook that generates pytest tests when I save a new Python module"

Gardez vos dépendances à jour :

"Create a hook that checks for outdated pip packages and suggests updates"

When a Python file is saved:
1. Run flake8 or pylint on the file
2. Report any style or quality issues
3. Suggest fixes for common problems
4. Update docstrings if missing

When requirements.txt or pyproject.toml is modified:
1. Check if virtual environment is activated
2. Install or update dependencies automatically
3. Report any dependency conflicts
4. Update requirements-dev.txt if needed

Kiro offre un accès intégré à la documentation pour Python et les cadres populaires grâce au système de référence #docs. Cela vous permet d'intégrer rapidement la documentation pertinente dans vos conversations avec Kiro. Tapez simplement #docs dans le clavardage et sélectionnez parmi les sources de documentation disponibles, telles que :

• #Python - Documentation du langage Python
• #Pytorch - Documentation du cadre PyTorch
• #PySide6 - Bibliothèque Python pour créer des interfaces graphiques

Exemple d'utilisation :

"#Python How do I use context managers effectively?"
"#Pytorch how can I add a custom operator?"
"#PySide6 What is the best way to add a button?"

Vous pouvez également référencer des URL de documentation spécifiques en utilisant #URL :

"#URL https://docs.python.org/3/library/asyncio.html"

Lorsque vous rencontrez des problèmes, Kiro peut vous aider à les diagnostiquer et à les corriger :

1. Clavardage en ligne :
   • Tapez Cmd/Ctrl + I pour ouvrir le clavardage en ligne.
   • Demandez à Kiro de vous aider à déboguer votre code en langage naturel.
2. Ajouter au clavardage :
   • Tapez Cmd/Ctrl + L pour ajouter le fichier actuel au clavardage.
   • Demandez à Kiro de vous aider à déboguer votre code en langage naturel.
3. Correctif rapide :
   • Survolez une erreur ou un avertissement, puis sélectionnez Quick fix et Ask Kiro.
   • Kiro ajoutera automatiquement le code au clavardage et commencera le débogage.

• Documentation Python
• Index des paquets Python (PyPI)
• Propositions d'amélioration de Python (PEP)