V0-1-canary

Créer un nouveau projet

Pour démarrer avec Nexy, assurez-vous d'avoir Python 3.12 ou une version plus récente. Cette version est nécessaire pour utiliser Nexy et profiter de toutes ses fonctionnalités modernes.

1. Vérification de la version de Python

Vérifiez que votre version de Python est à jour avec cette commande. Une version récente de Python est essentielle pour garantir la compatibilité et les meilleures performances :

shell

python --version
# Vous devriez voir Python 3.12.x ou supérieur

Si votre version de Python n'est pas à jour, téléchargez la dernière version depuis le site officiel de Python : python.org/downloads. Suivez les instructions d'installation pour votre système d'exploitation.

2. Installation de Nexy

Installez Nexy avec pip, le gestionnaire de paquets Python. Nous installons aussi InquirerPy pour une meilleure interaction en ligne de commande lors de la création de projets :

shell

pip install nexy inquirerpy==0.3.4

Vérifiez que Nexy est correctement installé en exécutant la commande suivante. Cela vous permettra de voir la version installée et de confirmer que tout est en ordre :

shell

nexy --version

3. Création d'un nouveau projet Nexy

Créez et explorez votre nouveau projet avec ces commandes. Nexy va générer automatiquement une structure de projet optimisée avec tous les fichiers nécessaires pour démarrer rapidement :

nexy new mon-projet
cd mon-projet

4. Explorer la Structure Initiale du Projet

Comprendre la structure initiale de votre projet est essentiel pour un développement efficace. Nexy propose deux modèles de projet principaux, chacun adapté à des besoins spécifiques. Voici un aperçu détaillé pour un projet fullstack et un projet de microservice.

Projet Fullstack

La structure d'un projet fullstack gère à la fois le backend et le frontend. Cette configuration est idéale pour les applications web complètes qui nécessitent une interface utilisateur et une logique serveur intégrée. Chaque fichier a un rôle spécifique dans l'architecture :

📁mon-projet/
 ├── 📁 app/
 |  ├── 📄 __init__.py
 |  ├── 📄 controller.py    # Point d'entrée principal
 |  ├── 📄 service.py       # Services de l'application
 |  ├── 📄 layout.html      # Templates HTML
 |  ├── 📄 view.html        # Vue principale (optionnelle)
 ├── 📁 public/             # Fichiers statiques
 └── 📄 nexy-config.py      # Configuration de l'application

Projet Microservice

La structure d'un projet de microservice est optimisée pour des services spécifiques et autonomes. Cette architecture est parfaite pour construire des systèmes distribués ou pour isoler des fonctionnalités spécifiques. La structure est volontairement allégée pour se concentrer sur l'essentiel :

📁 mon-projet/
 ├── 📁 app/
 |  ├── 📄 __init__.py
 |  ├── 📄 controller.py    # Point d'entrée principal
 |  ├── 📄 service.py       # Configuration de l'application
 ├── 📁 public/           # Fichiers statiques
 └── 📄 nexy-config.py    # Configuration de l'application

5. Lancement du serveur de développement

Lancez le serveur de développement pour tester votre projet. Le serveur de développement de Nexy inclut le rechargement automatique du code, ce qui signifie que vos modifications seront immédiatement visibles sans avoir à redémarrer le serveur :

shell

nexy dev  # Démarre le serveur de développement

Prochaines étapes

Votre projet est maintenant prêt pour le développement. Pour tirer le meilleur parti de Nexy, voici quelques étapes suggérées pour continuer votre apprentissage et commencer à construire votre application :

  • Explorez la structure du projet pour vous familiariser avec les fichiers et répertoires. Prenez le temps de comprendre comment chaque composant interagit avec les autres.
  • Créez votre première route pour ajouter des fonctionnalités à votre application. Commencez par quelque chose de simple comme une page d'accueil ou une API basique.
  • Expérimentez avec les composants Nexy pour créer des interfaces utilisateur réutilisables et maintenables.
  • Explorez les fonctionnalités avancées comme les WebSockets et les actions serveur pour créer des applications interactives.