Installation Locale et Configuration de Python
Détails techniques pour préparer un environnement de développement fonctionnel sur ordinateurs de bureau, installer le paquet LangPy via PIP et exécuter des ateliers de code natif en français.
1. Vérification de l'Interprète Python
Pour garantir la transpilation lexicale des modules, Python 3.10 ou supérieur est requis sur le système d'exploitation local.
Vous devez vérifier la présence et la version de l'interprète en exécutant la commande suivante dans votre terminal préféré :
- Windows : python --version
- macOS / Linux : python3 --version
Si le terminal indique que la commande n'est pas reconnue ou si la version affichée est obsolète, téléchargez la dernière version stable sur le site officiel python.org. Sous Windows, il est impératif de cocher l'option "Add Python to PATH" lors de l'installation pour indexer l'exécutable dans les variables globales.
2. Configuration de l'Environnement Virtuel (Recommandé)
L'utilisation d'environnements virtuels (`venv`) est la pratique standard de l'industrie et des laboratoires éducatifs pour isoler les paquets de chaque projet et prévenir les conflits de dépendances avec le système de base.
Création de l'environnement
Ouvrez le terminal dans le répertoire assigné à votre espace de travail ou laboratoire scolaire et exécutez :
- Windows : python -m venv venv
- macOS / Linux : python3 -m venv venv
Activation
Pour vous assurer que le paquet s'installe à l'intérieur du conteneur du projet, activez l'environnement selon votre système :
- Windows (Invite de commandes / CMD) : venv\Scripts\activate
- Windows (PowerShell) : .\venv\Scripts\Activate.ps1
- macOS / Linux : source venv/bin/activate
3. Installation depuis le Gestionnaire PIP
Une fois l'environnement virtuel dûment activé dans la console, téléchargez la dernière version stable du transpileur officiel.
pip install langpy
Ce paquet ajoute les outils lexicales locaux nécessaires pour mapper les instructions logiques en français vers du code natif compatible directement avec n'importe quel script ou bibliothèque standard Python.
4. Création et Exécution de Scripts Locaux
L'environnement LangPy utilise l'extension de fichier `.pyfr` pour regrouper les fichiers sources écrits avec une sémantique en français.
- Ouvrez n'importe quel éditeur de code de votre choix (ex. VS Code, VSCodium, Kate ou un bloc-notes standard).
- Créez un fichier texte vierge et enregistrez-le sous le nom `main.pyfr`.
- Écrivez l'instruction initiale de vérification suivante dans votre éditeur :
imprimer("Bonjour depuis LangPy local")Exécution depuis la Console
Contrairement aux scripts Python traditionnels, l'interprète en français s'invoque en appelant directement la commande racine installée :
langpy main.pyfr
Le cœur de LangPy résoudra la traduction sémantique en temps réel et enverra la structure directement à la machine virtuelle locale de Python, garantissant les mêmes performances d'exécution d'origine.
Résolution des Erreurs Courantes d'Environnement
Lors de la configuration de laboratoires informatiques ou de premiers environnements locaux, il est fréquent de rencontrer des blocages de permissions. Voici les diagnostics et corrections directes.
Python ou pip ne sont pas reconnus comme commandes système
La console de commandes indique que le terme saisi ne correspond pas à un programme exécutable.
L'installateur initial a omis d'exporter les chemins binaires vers les variables d'environnement de la machine (PATH).
Relancez l'installateur officiel de Python pour votre plateforme, choisissez l'option de modification ou de réparation de l'installation et vérifiez que la case "Add Python to PATH" est bien cochée avant de terminer.
Restriction des politiques d'exécution (Erreur sous Windows PowerShell)
Lors de la tentative d'exécution de la commande d'activation de l'environnement virtuel local, PowerShell affiche un avertissement de sécurité rouge bloquant le processus.
Le système de sécurité par défaut de Windows empêche l'exécution de scripts locaux qui ne disposent pas de signatures distantes dans la console.
Accordez des autorisations temporaires en exécutant l'instruction suivante avec des privilèges élevés dans votre PowerShell : Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
Le binaire 'langpy' est introuvable dans le terminal
La console indique que la commande d'exécution n'existe pas bien que le paquet ait été téléchargé au préalable.
Le terminal actuel a perdu la référence de l'environnement virtuel actif ou l'installation globale manque d'accès.
Assurez-vous de voir le nom de votre environnement actif entre parenthèses au début de la ligne de commande, mettez à jour les composants principaux et tentez une réinstallation forcée avec : python -m pip install --upgrade pip && pip install langpy
Incompatibilités lors de l'exécution
Le système lève des exceptions inattendues lors du traitement d'un fichier avec l'extension légitime .pyfr.
La version de l'interprète Python de la machine hôte est antérieure aux standards techniques minimaux du transpileur.
Exécutez dans votre terminal la commande `python --version` pour valider votre environnement et procédez à la migration du système vers une version moderne égale ou supérieure à Python 3.10.