Ci-Cd on Ocarina — précis

00.02 — Matrice stack / responsabilité / licence

Wed, 20 May 2026 00:00:00 +0000

00.02 — Matrice stack / responsabilité / licence#

Dépôt	Rôle	Langage	Version	Stack principale	Stack outillage	Distribution	Licence
`ocarina`	Framework de test e2e navigateur	Python	3.14+	`hatchling`, `python-docx` (seule dépendance d’exécution), `selenium` + `playwright` (dev seulement)	`ruff` (ALL), `mypy` strict, `pytest`, `hypothesis`, `pytest-mypy-plugins`, `syrupy`, `prysk` (cram), `allure-pytest`, `pre-commit`, `twine`, `build`	PyPI, v1.1.10	MIT
`ocarina-example`	Suite canonique e2e contre l’Igoristan	Python	3.14+	`ocarina`, `selenium ≥ 4.40`, `python-dotenv`, `dogpile.cache`, `redis`	`ruff`, `mypy`, `pre-commit`	Source uniquement	MIT
`ocarina-with-ai-example`	Suite e2e CURA Healthcare co-écrite par Claude Code	Python	3.14+	`ocarina ≥ 1.0.3`, `selenium ≥ 4.40`	`ruff`, `mypy`, `mypy-extensions`, `typing-extensions`, `pre-commit`	Source uniquement	MIT
`igoristan`	SUT public, application web volontairement chaotique	TypeScript	6.0.x	React 19.2, Vike 0.4.258 (SSG), Vite 7.3, TailwindCSS 4 (alpha), `valibot`, `react-hook-form`, `react-dropzone`, `usehooks-ts`, `throttleit`, `lucide-react`, `uuid`	`pnpm 11`, Node 24, `wireit` (orchestrateur), `eslint 9` (flat), `prettier 3.5`, `husky`, `lint-staged`, `commitlint`, `commitizen`, `terser`, `rollup-plugin-visualizer`, `vite-plugin-compression`, `@qalisa/vike-plugin-sitemap`	GitHub Pages (`/igoristan/`)	aucune
`tests-workers`	Backend OTP / Corsicadex pour exercer la parallélisation et les tests avec appels API	TypeScript	5.9.3	Vercel Edge Functions (`runtime: "edge"`), `@upstash/redis`, `otplib`, types `next` (`NextRequest`)	`pnpm 11.x`, `@vercel/node` (types)	Vercel : `https://tests-workers.vercel.app`	ISC
`ocarina-holy-book`	Documentation publique + skills IA + PDF	TypeScript	6.0.x	VitePress 2 alpha, theme `@sugarat/theme`, `vue 3.5`, `pagefind`, `vitepress-plugin-image-optimize`	`pnpm 11`, Node 24, `eslint 9`, `prettier 3.8`, `husky`, `lint-staged`, `commitlint`, `sass-embedded`	GitHub Pages (`/ocarina-holy-book/`)	MIT

Python early adopter#

Apport Python 3.12+	Utilisation dans Ocarina
PEP 695 (`class Foo[T]:`)	Signature générique partout (`TestSuite[Driver]`, `Watcher[Driver]`, `Test[Driver]`, `Result[T]`, `Ok[T]`, `Thunk[T]`, etc.)
PEP 695 type aliases (`type X = ...`)	Tous les alias : `type Result[T] = Ok[T] \| Fail`, `type Effect = Callable[[], None]`, `type Thunk[T] = Callable[[], T]`, `type Mode = Literal[...]`
`TypeGuard` (Python 3.10+)	`is_ok`, `is_fail`, `is_test_result_ok`, `is_test_result_fail`, `is_test_result_skipped`
`Self` (3.11+)	Retours fluides des POMs, des loggers, des invariants
`@final` (3.8+)	Verrouille les classes critiques (`Watcher`, `Test`, `TestCycle`, `ChainRunner`, `Ok`, `Fail`, …)
`Unpack` (3.11+)	Signature de `HumanizedDriver` côté `ocarina-example`
`Protocol` (3.8+)	`ScreenshotDriver`, `SupportsWrite[str]`
`Literal` (3.8+)	Toutes les énumérations (`SeleniumCliStoreKeys`, `LOGGERS_CHOICES`, `Mode`)
`Never` (3.11+)	Signature de `_SilentArgumentParser.error`

Conséquence pratique : il existe un workflow CI dédié unstable_python_full_build.yml qui pousse Python 3.15-dev mensuellement (cron: "0 3 1 * *"), parce qu’Ocarina veut être prêt pour le prochain interpréteur dès qu’il sort. Voir ../10-cicd/02-ocarina-workflows.md

05.07 — CI/CD de l'Igoristan

Wed, 20 May 2026 00:00:00 +0000

05.07 — CI/CD de l’Igoristan#

Deux workflows : ci-pr.yml sur PR (3 jobs parallèles), deploy.yml sur push main (GitHub Pages).

`ci-pr.yml`#

name: CI/PR

on:
  pull_request:
    branches: ["**"]
  workflow_dispatch:

defaults:
  run:
    shell: bash

jobs:
  format-check:
    runs-on: ubuntu-latest
    env:
      WIREIT_CACHE: github
    steps:
      - uses: actions/checkout@v6
      - uses: pnpm/action-setup@v5
        with: { version: 11 }
      - uses: actions/setup-node@v6
        with: { node-version: 24, cache: "pnpm" }
      - uses: google/wireit@setup-github-actions-caching/v2
      - name: Install project
        run: make install
      - name: Formatcheck
        run: make ci:format-check

  lint:
    runs-on: ubuntu-latest
    env:
      WIREIT_CACHE: github
    steps:
      # ... idem ...
      - uses: actions/cache@v5
        with:
          path: .eslintcache
          key: eslint-cache-${{ hashFiles('eslint.config.ts', 'src/**/*.*', 'package.json') }}
      - name: Lint
        run: pnpm lint

  typecheck:
    runs-on: ubuntu-latest
    env:
      WIREIT_CACHE: github
    steps:
      # ... idem ...
      - name: Typecheck
        run: pnpm typecheck

Job	Commande	Cache
`format-check`	`pnpm exec prettier . --check` (via wireit)	wireit + node_modules
`lint`	`pnpm exec eslint ... --max-warnings 0 --cache`	wireit + `.eslintcache` (actions/cache)
`typecheck`	`tsc --build --pretty tsconfig.json`	wireit + `tsbuildinfo`

                          PR opened / push
                                  │
                ┌─────────────────┼─────────────────┐
                ▼                 ▼                 ▼
        ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
        │ format-check │ │     lint     │ │  typecheck   │
        │ (1-2 minutes)│ │ (1-2 minutes)│ │ (1-2 minutes)│
        └──────────────┘ └──────────────┘ └──────────────┘
                │                 │                 │
                └─────────────────┴─────────────────┘
                                  ▼
                             PR mergeable

`deploy.yml`#

name: Deploy to GitHub Pages

on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: pnpm/action-setup@v5
        with: { version: 11 }
      - uses: actions/setup-node@v6
        with: { node-version: 24, cache: "pnpm" }
      - name: Install dependencies
        run: pnpm install --frozen-lockfile
      - name: Build
        run: pnpm build
      - name: Upload Pages artifact
        uses: actions/upload-pages-artifact@v4
        with: { path: dist/client }

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v5

Job	Effet
`build`	`pnpm install --frozen-lockfile` → `pnpm build` (= `wireit build` = `lint → typecheck → vike build`) → upload `dist/client`
`deploy`	`actions/deploy-pages@v5` → publie l’artifact → URL = https://mojo-molotov.github.io/igoristan/

`concurrency: pages` + `cancel-in-progress: false`#

concurrency:
  group: "pages"
  cancel-in-progress: false

Empêche deux déploiements simultanés (race condition).
Le second attend (cancel-in-progress: false → on ne cancel pas le run en cours).

07.11 — CI

Wed, 20 May 2026 00:00:00 +0000

07.11 — CI#

Trois workflows : main_ci.yml (rapide, lint + typecheck), dev_ci.yml (idem pour branches dev/feature/fix), e2e.yml (manuel, service Redis + Firefox).

Vue d’ensemble#

Workflow	Trigger	Plateforme	Effet
`main_ci.yml`	push/PR main	ubuntu + windows × py 3.14	`make check-coding-style` (mypy + ruff). Pas de browser.
`dev_ci.yml`	push dev / feature/_ / fix/_	ubuntu × py 3.14	id., mais Ubuntu seul
`e2e.yml`	`workflow_dispatch` (manuel)	ubuntu + service Redis + Firefox + geckodriver	Run complet de la suite e2e. Upload `.screenshots/`, `.ocarina_logs/`, `.reports/`.

`main_ci.yml`#

name: Main branch CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

defaults:
  run:
    shell: bash

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest]
        python-version: ["3.14"]
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v6
        with: { python-version: "3.14" }
      - uses: actions/cache@v5
        with:
          path: .venv
          key: venv-${{ runner.os }}-py3.14-${{ hashFiles('pyproject.toml') }}
      - name: Install
        run: make install-on-ci
      - name: Check coding style
        run: |
          . .venv/bin/activate
          make check-coding-style

Matrice OS : ubuntu + windows. Vérifie la portabilité Python du code projet.
Pas de browser : on lance juste make check-coding-style (= mypy + ruff). Rapide, pas besoin de Selenium / Redis / OTP.
Cache .venv : reuse entre runs.

`dev_ci.yml`#

on:
  push:
    branches: [dev, "feature/**", "fix/**"]
  workflow_dispatch:

jobs:
  test:
    runs-on: ubuntu-latest
    # … identique à main_ci.yml, juste Ubuntu seul …

Identique au main_ci.yml mais Ubuntu seul (Windows ne run que sur main).

Chapitre 10 — CI/CD de tout l'écosystème

Wed, 20 May 2026 00:00:00 +0000

Chapitre 10 — CI/CD de tout l’écosystème#

Tableau récapitulatif de tous les workflows CI de l’écosystème.

Plan#

#	Fichier	Sujet
01	`01-matrix.md`	Tableau récapitulatif de tous les workflows.
02	`02-ocarina-workflows.md`	`ocarina` : `main_ci.yml`, `dev_ci.yml`, `unstable_python_full_build.yml`
03	`03-example-workflows.md`	`ocarina-example` : `main_ci.yml`, `dev_ci.yml`, `e2e.yml`
04	`04-ai-workflows.md`	`ocarina-with-ai-example` : `ai_proof_ci.yml`, `ai_proof_e2e.yml`
05	`05-igoristan-workflows.md`	`igoristan` : `ci-pr.yml`, `deploy.yml`
06	`06-holy-book-workflow.md`	`ocarina-holy-book` : `deploy.yml`
07	`07-tests-workers-vercel.md`	`tests-workers` : pas de CI GitHub, déploiement directement pris en charge par Vercel.

Vue d’ensemble#

Dépôt	Workflows	Total
`ocarina`	main_ci + dev_ci + unstable_python_full_build	3
`ocarina-example`	main_ci + dev_ci + e2e	3
`ocarina-with-ai-example`	ai_proof_ci + ai_proof_e2e	2
`igoristan`	ci-pr + deploy	2
`ocarina-holy-book`	deploy	1
`tests-workers`	aucun (délégué à Vercel)	0

+ ocarina/.github/actions/allure-history/action.yml.

Ci-Cd on Ocarina — précis

00.02 — Matrice stack / responsabilité / licence

00.02 — Matrice stack / responsabilité / licence#

Python early adopter#

05.07 — CI/CD de l'Igoristan

05.07 — CI/CD de l’Igoristan#

ci-pr.yml#

deploy.yml#

concurrency: pages + cancel-in-progress: false#

07.11 — CI

07.11 — CI#

Vue d’ensemble#

main_ci.yml#

dev_ci.yml#

Chapitre 10 — CI/CD de tout l'écosystème

Chapitre 10 — CI/CD de tout l’écosystème#

Plan#

Vue d’ensemble#

`ci-pr.yml`#

`deploy.yml`#

`concurrency: pages` + `cancel-in-progress: false`#

`main_ci.yml`#

`dev_ci.yml`#