______          _   _                 
 |  ____|        | | | |                
 | |__ _ __ _   _| |_| |__   ___  _ __  
 |  __| '__| | | | __| '_ \ / _ \| '_ \ 
 | |  | |  | |_| | |_| | | | (_) | | | |
 |_|  |_|   \__, |\__|_| |_|\___/|_| |_|
             __/ |                      
            |___/                       

🥐 What is it?

Frython is a programming language that transpiles Python code written entirely in French into standard Python. It's a humorous project, but fully functional — you can really program in French!

Frython translates Python keywords (if, while, for, print, etc.) into their French equivalents (si, tantque, pour, afficher, etc.).

"Why program in English when you can do it in French with 3 times more words?" — Victor Hugo, probably

⚡ Installation

pip install frython

From source

git clone https://github.com/Artleboss2/frython.git
cd frython
pip install .

Verify installation

python -m frython --version
# Frython 1.0.2 — Python en français 🐓

Windows (multiple Python versions)

C:\Python314\python.exe -m frython mon_fichier.fy

Or create a permanent PowerShell alias:

function frython { C:\Python314\python.exe -m frython $args }

🚀 Quick Start

Create a file bonjour.fy:

afficher("Bonjour le monde! 🐓")

prenom = "Marie"
age = 25

si age >= 18:
    afficher(f"Bienvenue, {prenom}! Vous êtes majeur(e).")
sinon:
    afficher(f"Bonjour, {prenom}! Vous êtes mineur(e).")

Run it:

python -m frython bonjour.fy

Bonjour le monde! 🐓
Bienvenue, Marie! Vous êtes majeur(e).

Interactive REPL

python -m frython

🐓 Frython v1.0.2 — Python en français, sacré bleu !

🐓 >>> afficher("Ça marche!")
Ça marche!
🐓 >>> quitter()
Au revoir! 👋

📖 Language Reference

Control Flow

Definitions

Special Values

Built-in Functions

🛠️ CLI Usage

python -m frython fichier.fy          # Run a file
python -m frython                      # Interactive REPL
python -m frython -t fichier.fy        # Show transpiled Python
python -m frython -v fichier.fy        # Verbose mode
python -m frython -c "afficher('Hi')"  # Run direct code
python -m frython --mots-cles          # List all keywords
python -m frython --version            # Show version

💡 Examples

Fibonacci

déf fibonacci(n):
    si n <= 1:
        retourner n
    retourner fibonacci(n-1) + fibonacci(n-2)

pour i dans intervalle(10):
    afficher(f"F({i}) = {fibonacci(i)}")

Classes

classe Animal:
    def __init__(soi, nom):
        soi.nom = nom

    déf parler(soi):
        retourner "..."

classe Chien(Animal):
    déf parler(soi):
        retourner "Ouaf! 🐕"

rex = Chien("Rex")
afficher(rex.parler())

List Comprehensions

carres = [x**2 pour x dans intervalle(1, 11)]
pairs = [x pour x dans intervalle(20) si x % 2 == 0]
afficher(carres)
afficher(pairs)

🗂️ Project Structure

frython/
├── frython/
│   ├── __init__.py
│   ├── lexeur.py
│   ├── transpileur.py
│   └── interpreteur.py
├── examples/
├── tests/
├── assets/
│   ├── readme_fr.md
│   ├── readme_es.md
│   ├── readme_zh.md
│   ├── readme_hi.md
│   ├── readme_ar.md
│   ├── readme_pt.md
│   ├── readme_ru.md
│   ├── readme_ja.md
│   ├── readme_de.md
│   └── readme_ko.md
├── README.md
├── DOCUMENTATION.md
├── UPDATE.md
└── LICENSE

❓ FAQ

Q: Is it actually usable? A: Yes! Frython transpiles to valid Python. Everything Python can do, Frython can do — in French.

Q: Can I use external Python libraries? A: Absolutely. importer numpy comme np works perfectly.

Q: Do f-strings work? A: Yes, and expressions inside {} are also translated.

Q: Why does this exist? A: Pourquoi pas? 🥐

Q: Will my boss accept Frython in production? A: We cannot guarantee the health of your employment.

🤝 Contributing

1. Fork the repo
2. Create a branch: git checkout -b feature/my-feature
3. Run tests: python -m unittest tests/test_frython.py -v
4. Commit and push
5. Open a Pull Request

📜 License

MIT — Free to use, modify and distribute. Even for pranking colleagues.