Forge

Le framework web Python que vous pouvez lire en entier.

Forge est un framework web applicatif Python, MVC et explicite, pour des applications de production dont vous comprenez et auditez chaque ligne. Pas de magie cachée, SQL visible, sécurisé par défaut, runtime minimal (quatre dépendances). HTTPS et Jinja2 intégrés. Le cœur est agnostique de la base de données ; le backend (SQLite, MariaDB, PostgreSQL, SQL Server) s'ajoute en opt-in.

Statut

Forge 1.0.0-rc.3, release candidate (préversion finale avant 1.0.0 stable).

• Paquet PyPI : forge-mvc
• Préversion PEP 440 (1.0.0rc3) : installation avec --pre
• Python 3.12+
• API publique gelée pour la 1.0.0

Liens utiles

Installation rapide

pipx install --pip-args="--pre" forge-mvc
forge --version

Créer un projet et lancer le serveur de développement :

forge new forge-demo
cd forge-demo
source .venv/bin/activate
forge run

forge new prépare tout le projet : squelette, environnement Python avec forge-mvc, fichier env/dev, certificat HTTPS de développement et dépôt Git. Les premiers paliers tournent sans base de données ; un backend SQL (forge-mvc-sqlite, sans configuration, ou forge-mvc-mariadb) et forge db:init ne deviennent nécessaires qu'à partir du palier « Première base SQL ».

Pour construire pas à pas votre première application, suivez le parcours cœur Welcome Forge : forgemvc.com/docs/forge/starters/welcome-forge/.

La documentation complète d'installation est sur forgemvc.com/docs/forge/install/.

Exemple minimal

# mvc/routes/__init__.py
from core.http.router import Router
from mvc.controllers.home_controller import HomeController

router = Router()

with router.group("", public=True) as public:
    public.add("GET", "/", HomeController.index, name="home-index")

# mvc/controllers/home_controller.py
from core.http.response import Response


class HomeController:
    @staticmethod
    def index(request):
        return Response.text("Bonjour Forge")

Pourquoi Forge ?

Forge fait le pari inverse de la mode : pas de magie, pas d'ORM, pas d'async imposé. En échange, vous obtenez une application que vous comprenez, auditez et maintenez des années, sécurisée par défaut et reposant sur un runtime minuscule.

• MVC serveur explicite, sans magie cachée
• SQL visible, pas d'ORM imposé
• Base de données au choix : SQLite, MariaDB, PostgreSQL ou SQL Server (backend opt-in, cœur agnostique)
• Générateurs prudents : Forge ne réécrit pas votre code
• Documentation officielle complète
• Sécurité web par défaut (CSRF, Argon2id, headers, autoescape)
• Noyau minimal, opt-ins
• Python 3.12+, dépendances explicites

Opt-ins officiels

Backends de base de données (ADR-054)

Le cœur ne parle pas directement à une base : il choisit un backend, exclusif, un seul par projet, déclaré comme opt-in. La connexion, le dialecte SQL et le provisionnement (db:init, migrations) passent par ce backend ; le code applicatif reste identique quel que soit le moteur.

Chaque opt-in reste optionnel : le core Forge ne dépend d'aucun d'eux. Seuls forge-mvc-rbac, forge-mvc-workflow et forge-mvc-stats sont inclus dans l'extra forge-mvc[all]. Tous les autres opt-ins (mfa, files, images, audio, video, iot, pivot, mail, i18n, qrcode, settings, import-export, audit, jobs, notifications, deploy) s'installent explicitement et séparément, par exemple pip install --pre forge-mvc-rbac ou pip install --pre forge-mvc-images. forge-mvc-i18n, forge-mvc-qrcode, forge-mvc-settings, forge-mvc-import-export, forge-mvc-audit, forge-mvc-jobs, forge-mvc-notifications et forge-mvc-deploy ne sont pas encore publiés sur PyPI ; ils s'installent en éditable via requirements-dev.txt. Cette exclusion de [all] tient soit à une dépendance lourde (MQTT paho-mqtt pour IoT, binaire système FFmpeg pour Video et Audio, Pillow pour Images), soit à un choix de sécurité explicite (mfa), soit à une absence de publication sur PyPI (i18n, qrcode).

Documentation

Toute la documentation est publiée sur forgemvc.com/docs/forge/ :

• Installation, démarrage rapide, tutoriels
• Référence de la CLI forge
• Entités, modèles, SQL et migrations
• Formulaires, validation, CSRF, sessions
• Backends de base de données (MariaDB, SQLite, PostgreSQL, SQL Server)
• Modules opt-in (RBAC, workflow, stats, MFA, files, images, audio, vidéo, IoT, pivot, mail, i18n, QR Code, settings, audit, jobs, notifications, import-export, deploy, admin, testing)
• ADR et charte philosophique

Développement du framework

Pour contribuer à Forge directement :

git clone https://github.com/caucrogeGit/Forge.git
cd Forge

python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
python -m pip install -r requirements-dev.txt

Validations courantes avant un commit :

python -m pytest -x -q
python -m compileall -q .
ruff check .
mkdocs build --strict

Prévisualiser la documentation en local :

mkdocs serve

Le site est servi sous le préfixe de production : ouvrez http://127.0.0.1:8000/docs/forge/ (et non la racine). La navigation utilise des liens absolus /docs/forge/..., donc ce préfixe est nécessaire pour que les liens fonctionnent.

Voir CHARTE_DOC.md et docs/adr/ pour les principes et décisions architecturales.

Licence

Forge est distribué sous licence propriétaire / source disponible.

L'usage professionnel, commercial ou institutionnel nécessite un accord écrit préalable de Roger Lequette. La lecture, l'étude, l'évaluation personnelle et l'usage éducatif non commercial sont autorisés sans accord.

Forge n'est pas open source pendant sa phase de préversion (release candidate incluse). À partir de la version 1.0.0 stable, Forge bascule sous licence open source MIT, dès que les critères de stabilité sont réunis et au plus tard le 31 décembre 2026 (critères détaillés sur la page licence et la roadmap). Jusqu'à cette publication, la licence présente dans le dépôt fait foi.

Voir LICENSE pour les conditions complètes.

Auteur

Roger Lequette, forgemvc.com