Guide d'Utilisation du Système

1. Vérifier l'Environnement

Assurez-vous que le système est prêt à fonctionner en exécutant la commande principale dans votre console sans rien ajouter d'autre.

langpy

2. Utilisation Essentielle

Exécutez vos fichiers de code directement

Créez un fichier texte avec l'extension de votre langue (`.pyfr` pour le français) et lancez-le avec la commande de base.

# bonjour.pyfr
definir main():
    nom = "Monde"
    imprimer(f"Bonjour {nom} !")

main()

langpy bonjour.pyfr

3. Extensions du Système

L'environnement identifie le dictionnaire à utiliser selon le type de fichier

• Français (extension `.pyfr`) : Active des commandes naturelles comme `definir`, `si`, `pour`, `imprimer`.
• Espagnol (extension `.pyes`) : Active des commandes naturelles comme `definir`, `si`, `para`, `imprimir`.
• Portugais (extension `.pypt`) : Active des commandes naturelles comme `definir`, `se`, `para`, `imprimir`.

4. Structure des Projets Avancés

Idéal pour enseigner comment s'organise un logiciel réel en dossiers

Vous pouvez regrouper plusieurs fichiers dans un répertoire en utilisant `__main__.pyfr` comme point d'entrée principal.

mon_projet/
├── __main__.pyfr     # Fichier principal d'exécution
├── math.pyfr            # Module ou classe locale
└── utils/
    ├── __init__.pyfr
    └── helpers.pyfr

langpy mon_projet/

5. Le Pont : Convertir vers Python Standard

Exportez votre logique native vers des fichiers épurés standards de l'industrie

Prêt pour l'étape suivante ? Générez des fichiers `.py` traditionnels prêts à être ouverts avec l'interprète officiel de Python partout dans le monde.

langpy transpile script.pyfr

Le convertisseur analyse de manière intelligente les dossiers et modules locaux internes, en les traduisant en cascade tout en conservant intacte la structure exacte de votre projet.

# main.pyfr appelle en interne utils/math.pyfr :
# main.pyfr              → main.py
# utils/math.pyfr     → utils/math.py

6. Exporter vers des Dossiers Spécifiques

Séparez votre environnement d'apprentissage de vos fichiers de production

Utilisez l'option `--output` pour indiquer au système dans quel dossier exclusif vous souhaitez enregistrer la version traduite au format épuré.

langpy transpile main.pyfr --output dossier_sortie/
langpy transpile main.pyfr -o dossier_sortie/

7. Dictionnaire Complet des Commandes

langpy <fichier ou dossier>

Exécute en temps réel un script individuel ou un répertoire structuré.

langpy script.pyfr
langpy mon_projet/

langpy transpile

Lance le processus de conversion de la logique en français vers du code propre compatible avec l'industrie.

langpy transpile script.pyfr

--output / -o

Assigne le chemin de destination exact pour vos fichiers convertis.

langpy transpile script.pyfr --output dossier_sortie/

--force / -f

Force le système à écraser les fichiers `.py` précédents en cas de modifications.

langpy transpile script.pyfr --force

--help

Affiche le guide d'aide rapide avec la liste des commandes disponibles dans la console.

langpy --help

--version

Affiche la version exacte installée sur le système.

langpy --version

8. Compatibilité Totale avec des Bibliothèques Réelles

Utilisez des outils professionnels comme NumPy ou Pandas dès le premier jour

Vous n'êtes pas enfermé dans un jouet logique. Vous pouvez importer n'importe quelle bibliothèque scientifique ou de données de Python et la combiner avec vos commandes natives.

# math.pyfr
definir somme(a, b):
    retourner a + b

definir soustraction(a, b):
    retourner a - b

# main.pyfr
depuis operations importer somme, soustraction
importer numpy comme np

definir analyser_donnees():
    # Utilisez vos fonctions en français
    resultat = somme(10, 5)
    imprimer(f"Somme : {resultat}")
    
    # Utilisez n'importe quel écosystème natif de Python
    donnees = np.array([1, 2, 3, 4, 5])
    imprimer(f"Moyenne : {np.mean(donnees)}")

analyser_donnees()

langpy main.pyfr

9. Mécanique de Fonctionnement

LangPy traite uniquement le texte des instructions clés de contrôle, en les traduisant proprement vers Python tout en laissant le reste (vos commentaires ou chaînes de caractères) intact.

1. Analyse l'extension du fichier saisi (`.pyes`, `.pypt` ou `.pyfr`).
2. Découpe le script en utilisant les outils de lecture de la bibliothèque standard de Python.
3. Échange exclusivement les identifiants logiques mappés dans votre langue (les chaînes de texte restant protégées).
4. Reconstruit la structure comme un fichier de code Python totalement valide.
5. L'exécute directement sur la machine virtuelle native du système d'exploitation.