riftbound-core 0.1.1

Noyau métier pur et typé du projet Riftbound : cartes, decks, formats et validation statique de deck.

riftbound-core

Noyau métier pur et typé pour le jeu de cartes Riftbound : modèles de cartes et de decks, formats, règles de construction statiques, sérialisation et analyse simple — sans réseau, sans base de données et sans dépendance runtime externe.

Statut : release 0.1.1 (beta) — périmètre V1 livré (validation statique, sérialisation, primitives descriptives de jeu).

Installation

Python >=3.11 requis.

python -m pip install riftbound-core

Pour contribuer au dépôt :

git clone https://github.com/baobabgit/riftbound-core.git
cd riftbound-core
python -m pip install -e ".[dev]"

Périmètre

Inclus dans ce package :

• modèles Card, Deck, formats et banlist ;
• validation statique de deck (DeckValidator, codes d'erreur stables) ;
• sérialisation JSON et decklist texte (riftbound-decklist/1) ;
• analyse simple (courbe de coût, distributions) ;
• factories de test (riftbound_core.testing).

Hors périmètre (packages futurs de l'écosystème) :

• moteur de règles complet et résolution d'effets ;
• API HTTP, persistance, interface graphique ;
• IA de deckbuilding et simulation de parties.

Démarrage rapide

L'API racine expose uniquement __version__. Les symboles métier s'importent depuis leurs sous-modules.

import riftbound_core
from riftbound_core.cards.domain import Domain
from riftbound_core.testing.deck_factory import DeckFactory
from riftbound_core.validation.deck_validator import DeckValidator

print(riftbound_core.__version__)
print(Domain.FURY.french_label)  # Fureur

deck = DeckFactory.duel_legal()
result = DeckValidator().validate(deck)
if not result.is_valid:
    for issue in result.issues:
        print(issue.code, issue.message)

Exemples supplémentaires (cartes, formats, sérialisation) : voir la documentation développeur.

Documentation

Guides embarqués après installation PyPI :

from riftbound_core.docs import DECK_VALIDATION_DOC, read_doc

print(read_doc(DECK_VALIDATION_DOC))

Ressource	Emplacement
Validation de deck	src/riftbound_core/docs/deck_validation.md
Correspondance règles / codes	src/riftbound_core/docs/rules_mapping.md
Changelog	CHANGELOG.md
Cahier des charges V1	docs/riftbound-core/

Sur PyPI, les mêmes guides sont disponibles via riftbound_core.docs (voir ci-dessus). Les sources complètes du dépôt (backlogs, runs IA) restent sur GitHub.

Principes

• Pur : aucun I/O réseau, aucune persistance, aucune IA embarquée.
• Typé : mypy strict, marqueur PEP 561 py.typed.
• Testé : couverture ≥ 90 %, CI sur chaque PR et release.
• Déterministe : résultats stables pour un même entrée métier.

Contrôles qualité (développement)

pytest
coverage run -m pytest
coverage report
black --check src tests scripts/ia_workflow
flake8 src tests scripts/ia_workflow
pylint src/riftbound_core scripts/ia_workflow
mypy src/riftbound_core scripts/ia_workflow
python -m bandit -r src/riftbound_core scripts/ia_workflow

Publication PyPI

La release est automatisée par .github/workflows/release.yml (Trusted Publishing OIDC, attestations Sigstore, GitHub Release).

Procédure maintainer :

1. Mettre à jour __version__ dans src/riftbound_core/__init__.py et CHANGELOG.md.
2. Committer sur main.
3. Créer et pousser un tag SemVer : git tag vX.Y.Z && git push origin vX.Y.Z.
4. Vérifier le workflow Release (qualité → tests → build → PyPI → GitHub Release).

Prérequis PyPI (une fois) : pending publisher ou trusted publisher sur le projet riftbound-core, workflow release.yml, environnement GitHub pypi.

Licence

MIT — voir LICENSE.