wolverine : ce que le dépôt permet réellement de faire

Un médiateur et bus de messages pour .NET

Le README commence en présentant Wolverine comme un médiateur et bus de messages .NET de nouvelle génération. Le dépôt renvoie au site de documentation wolverinefx.net, qui est également la page d'accueil indiquée dans les métadonnées du dépôt. La description GitHub dit que le projet est destiné au développement côté serveur .NET « supercharged », mais le README ne précise pas ce que cette expression couvre. Aucun benchmark, cas de production ou liste d'utilisateurs n'apparaît dans le matériel source, donc des affirmations concrètes sur les performances ou l'adoption ne sont pas établies par ce README.

Branches et lignes de versions

Le dépôt suit une stratégie de branchement par lignes majeures. La branche main est destinée au développement de Wolverine 6.0, actuellement publié sous forme de paquets préliminaires WolverineFx 6.0.0-alpha, et c'est là que se trouvent les nouvelles fonctionnalités et le travail sur AOT. La branche 5.0 est une ligne de maintenance qui ne reçoit que des corrections de bugs, issue du tag V5.39.0. Une branche archivée nommée archive/cloudevents-attempt-2025 contient une fonctionnalité CloudEvents incomplète et jamais fusionnée. D'anciennes branches de versions existent mais ne sont pas des surfaces de développement actives. Les nouvelles contributions doivent cibler main, et les candidats au backport pour la ligne 5.x peuvent être ouverts contre 5.0 après la fusion du PR correspondant sur main.

Travailler avec le code

Pour travailler avec le code, ouvrez wolverine.sln à la racine du dépôt. Pour les tests d'intégration, Docker doit être installé localement, et les services de test correspondants peuvent être démarrés avec docker compose up -d. Les tests Azure Service Bus sont une exception : ils nécessitent un environnement cloud réel car le README indique que Microsoft ne propose pas d'émulateur Docker local comme Localstack. Le README ne liste pas de commandes pour exécuter des tests individuels au-delà de cette étape de configuration, ni ne précise quels services docker compose démarre.

Conventions pour contributeurs et outils de build

Le guide du contributeur définit un style de nommage : les membres publics ou internes sont en PascalCase, les membres privés ou protégés en camelCase, et les champs privés utilisent un préfixe underscore. Le build est scripté avec Nuke dans le dossier /build. Sous Windows, exécutez build ; sous OSX ou Linux, exécutez ./build.sh. La documentation se trouve dans /docs et est construite avec Vitepress, avec Markdown Snippets pour les exemples de code. Pour exécuter la documentation localement, Node.js est nécessaire, puis npm install et npm run docs ; npm run mdsnippets met à jour les snippets. Le README ne précise pas la version de Node.js requise.

Historique et critter stack

Wolverine a commencé en 2015 comme un projet nommé Jasper, conçu comme un redémarrage de FubuMVC / FubuTransportation, un framework d'API web et un bus de messages asynchrones plus anciens. Wolverine a été largement redémarré, remanié et renommé en 2022, avec l'intention d'être combiné avec Marten pour former ce qu'on appelle le critter stack, destiné au développement serveur productif et performant en .NET. Le README ne fournit pas de détails supplémentaires sur le contenu du critter stack, le fonctionnement de la combinaison ou ce qui a changé lors du redémarrage de 2022 au-delà du nom et de l'objectif.

Support, parrainage et licence

Bien que Wolverine soit open source, JasperFx Software propose des contrats de support et de conseil payants pour Wolverine, et le README renvoie vers une page de sponsor GitHub. L'extrait de licence est MIT, copyright Jeremy D. Miller et contributeurs. Il accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, sous réserve que l'avis de copyright et d'autorisation figure dans toutes les copies ou portions substantielles. Le logiciel est fourni tel quel, sans garantie d'aucune sorte. La licence ne dit rien sur les garanties de sécurité, les niveaux de support ou l'adéquation à un usage particulier (sauf la clause de non-responsabilité), et le README ne décrit aucune politique de support distincte.

Contrôler wolverine dans son environnement

Créez un petit projet Wolverine avec la commande et les packages du README, ajoutez un message et observez les handlers, la file et les journaux. Vérifiez le fichier de configuration Wolverine avant de conclure sur la persistance ou le transport. Cette séquence porte sur wolverine, ses fichiers et ses sorties documentées ; elle ne remplace pas les informations absentes du README.

Conclusion éditoriale

wolverine convient aux lecteurs dont le besoin correspond aux fonctions décrites dans le README et qui peuvent fournir son environnement requis. Il convient moins à ceux qui attendent une garantie absente du dépôt. Avant décision, exécutez ce contrôle propre au projet : Créez un petit projet Wolverine avec la commande et les packages du README, ajoutez un message et observez les handlers, la file et les journaux. Vérifiez le fichier de configuration Wolverine avant de conclure sur la persistance ou le transport.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes