Skip to contents

Calcule l'entrée `pb, pb_series, source-repo` pour le dépôt PB local et ouvre une pull request contre `ofce/wp-registry` proposant de l'ajouter à `pb/série.json`. Les PB partagent le même dépôt registre que les WP (`ofce/wp-registry`) — sous le sous-dossier `pb/`, distinct de `wp/` — il n'existe pas de dépôt `pb-registry` séparé. Le registre PB est organisé en **séries** (liste, statut ouvert/clos et paramètres dans `pb/index.json`), chacune numérotée à partir de 1 dans son propre fichier `pb/série.json`, indépendamment de l'année de publication. La série est lue dans la clé `pb_series` de `_quarto.yml` (`"ofce"` si la clé est absente) ; la demande est refusée si la série est inconnue ou close, ou si le dépôt est déjà enregistré. N'attend pas la fusion (fire-and-forget) — un·e admin doit approuver manuellement. Relancer [setup_pb()] une fois la PR fusionnée : c'est `setup_pb()` (pas `render_pb()`, qui ne consulte plus le registre) qui synchronise `pb`/`pb_series`/`draft` et recalcule `site-path`/`citation.*` depuis l'entrée confirmée, pour basculer du mode staging au mode publication.

Usage

pb_registry_request(
  path = ".",
  pb = NULL,
  contact = NULL,
  registry_repo = "ofce/wp-registry",
  dry_run = FALSE
)

Arguments

path

Chemin vers la racine du dépôt PB local. Défaut `"."`.

pb

Entier ou `NULL`. Numéro de PB souhaité. Si `NULL` (défaut), calculé automatiquement comme `max(pb existants de la série) + 1` d'après `pb/série.json` au moment de l'appel (`1` si la série est encore vide). Si fourni explicitement, la fonction vérifie l'absence de collision au sein de la série avant d'ouvrir la PR et échoue localement en cas de conflit.

contact

Adresse de contact de l'auteur·e. Défaut : valeur de `git config user.email` pour ce dépôt (config locale avec repli sur la globale). La fonction échoue si aucune valeur ne peut être résolue.

registry_repo

Slug `"owner/repo"` du dépôt registre. Défaut `"ofce/wp-registry"`.

dry_run

Si `TRUE`, calcule et affiche l'entrée proposée sans ouvrir de pull request. Défaut `FALSE`.

Value

Invisiblement, une liste avec `entry` (l'entrée proposée) et `pr_url` (URL de la PR ouverte, `NULL` en mode `dry_run`).

Details

# Flux : push d'une branche puis PR intra-dépôt

Le dépôt `ofce/wp-registry` est configuré pour autoriser les membres de l'organisation `ofce` à pousser des branches et ouvrir des pull requests sans être collaborateur·rice avec droit d'écriture (seule la **fusion** reste protégée : branch protection + `CODEOWNERS`). La fonction exploite cette configuration — pas de fork personnel :

1. Résolution du login GitHub (`GET /user`) associé au token (`DEPLOY_PAT` ou identifiants `gitcreds`). 2. Clonage de `ofce/wp-registry`, création de la branche `request/pb/série/pb` avec l'entrée proposée ajoutée à `pb/série.json`. Le préfixe `pb/` évite toute collision avec les branches `request/annee/wp` ouvertes par [wp_registry_request()] dans le même dépôt partagé. 3. Push de cette branche vers `ofce/wp-registry`. 4. Ouverture d'une pull request intra-dépôt (`head = "branche"`, `base = "main"`).

Si le push échoue (droits insuffisants ou token non membre de l'organisation `ofce`), la fonction s'arrête avec une erreur explicite.

Le token utilisé (`DEPLOY_PAT` ou identifiants `gitcreds`) doit permettre de résoudre `GET /user` et de pousser une branche sur `ofce/wp-registry` — un PAT classique avec la portée `repo` (ou `public_repo`) d'un compte membre de l'organisation `ofce` convient.

See also

[setup_pb()], [render_pb()], [deploy_pb()]