spip-contrib-extensions/apiplatform_dist
Par bricebou, le 5 novembre 2026 à 10h12min :
docs: écrire, valider et le profil d’un auteur par des mutateurs
La documentation de apiplatform_dist passe d’un README unique à un README court et à quatre pages dans docs/. docs/ressources.md garde le tableau des ressources, leurs filtres et leur visibilité, avec la clé primaire ajoutée aux champs et le renvoi au cœur pour le mot de passe ; docs/reprendre.md reprend l’exemple de substitution d’une ressource par apiplatform_declarer_ressources.
docs/ecrire.md dit que dist reste en lecture seule et montre comment un site ajoute lui-même un Post à la ressource Article par un #[AsResourceMutator] déclaré par apiplatform_declarer_mutateurs : le Post reçoit PersistProcessor et la policy creer, et répond 201, 403 ou 422. L’opération reprend l’adresse, le préfixe de route et les variables d’URI d’une opération de la ressource, qu’un mutateur ne reçoit pas de la construction, et qu’il trouve par sa classe, la collection Operations ne se lisant pas par nom. Les contraintes de validation se posent sur les getters d’un modèle étendu, car un mutateur ne peut rien sur la ressource finale.
docs/profil.md ajoute à Auteur un Patch par lequel un auteur modifie sa fiche publique, avec la policy modifier : l’adresse électronique, le login, le mot de passe et le statut restent hors d’atteinte, parce qu’ils ne figurent pas dans la liste blanche du modèle. Les exemples ont été rejoués en HTTP sur un site de développement.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
Ajouté
docs/ecrire.md
docs/profil.md
docs/reprendre.md
docs/ressources.md
Modifié
README.md