Chapitre 02 — Ocarina, le framework#

Ce chapitre dépile l’intégralité du framework ocarina (Python 3.14+, version 1.1.10) ainsi que du Railway Oriented Programming jusqu’aux plugins de reporting. Il est structuré comme un parcours en couches : du plus profond (le type Result[T]) vers le plus visible (le bootstrap qui démarre tout).

Plan du chapitre#

#	Sujet	Fichier ou dossier
01	Identité technique, dépendances, toolchain	`01-identity.md`
02	Arborescence complète du module + schéma en couches	`02-module-tree.md`
03	Railway Oriented Programming	`03-railway/`
04	Invariants (validate, assertions, chain_validations)	`04-invariants/`
05	Orchestration (Test → TestSuite → TestCampaign → TestCycle)	`05-orchestration/`
06	Cycle de vie d’un `Scenario`	`06-scenario.md`
07	Watcher	`07-watcher.md`
08	`POMBase`	`08-pom-base.md`
09	Ports & adapters (`ILogger`, `ITakeScreenshot`)	`09-ports.md`
10	Infrastructure (pool, builder, screenshotter, act counter, adapters Selenium)	`10-infra/`
11	Couche opinionated (CLI, loggers, plugins, bootstrap)	`11-opinionated/`
12	Custom types & custom errors	`12-custom-types-errors.md`

Lectures connexes#

Programmation fonctionnelle : ../03-functional/
Comment le framework se teste lui-même : ../04-internal-tests/
Exemples d’usage avec adapters projet : ../07-ocarina-example/, ../08-ai-example/
CI : ../10-cicd/02-ocarina-workflows.md