baobab-ai-dev-database 0.1.0

Persistence library for the Baobab AI development ecosystem.

baobab-ai-dev-database

Librairie de persistance de l'écosystème baobab-ai-development.

Le module fournit la configuration database, les sessions et transactions, les modèles ORM, les mappers, les repositories, les migrations Alembic et les services de lecture nécessaires aux workflows de développement IA.

Prérequis

• Python 3.12 ou supérieur
• pip

Installation

Depuis PyPI

python -m pip install baobab-ai-dev-database

L'installation standard cible PostgreSQL et résout :

• baobab-ai-dev-core>=0.2,<1 (version PyPI courante : 0.2.0)
• baobab-database[postgresql]>=2,<3 (version PyPI courante : 2.0.0)
• alembic>=1,<2

Développement (dépôt local)

python -m pip install -e ".[dev]"

Usage de base

Configuration et session

Les variables d'environnement BAOBAB_DB_* pilotent la connexion (voir .env.example et docs/configuration/environment-variables.md).

from baobab_ai_dev_database.config.database_settings import DatabaseSettings
from baobab_ai_dev_database.session.database_session_manager import DatabaseSessionManager

settings = DatabaseSettings().build()
manager = DatabaseSessionManager.from_settings(settings)

with manager.create_session() as session:
  # utiliser la session SQLAlchemy
  pass

Repositories

from baobab_ai_dev_database.repositories.repository_registry import RepositoryRegistry

registry = RepositoryRegistry(session)
project = registry.projects.get_by_slug("mon-projet")

Migrations Alembic

Les scripts de migration sont embarqués dans le wheel (env.py, script.py.mako, révisions sous versions/).

Le fichier alembic.ini à la racine de ce dépôt n'est pas publié sur PyPI : l'application consommatrice fournit sa propre configuration Alembic. Pointez script_location vers le répertoire packagé :

from baobab_ai_dev_database.migrations import MIGRATIONS_SCRIPT_LOCATION

print(MIGRATIONS_SCRIPT_LOCATION)

Exemple minimal de section [alembic] côté consommateur :

[alembic]
script_location = %(CHEMIN_VERS_MIGRATIONS_SCRIPT_LOCATION)s

Dans ce dépôt (développement), exécuter depuis la racine :

alembic upgrade head
alembic current

Documentation détaillée : docs/technical/alembic-migrations.md.

Validation

Quality gate agrégée et multiplateforme (sans shell) :

python -m baobab_ai_dev_database.quality

Commandes individuelles :

python -m pytest
coverage run -m pytest
coverage report
ruff check .
mypy backend/src

La documentation de l'arborescence interne et de la quality gate se trouve dans backend/README.md.

Publication PyPI (Trusted Publishing)

Le workflow .github/workflows/release.yml publie sur PyPI via OIDC (aucun token longue durée dans le dépôt).

Configuration côté PyPI (une fois par projet) :

1. Compte PyPI → Publishing → Add a new pending publisher
2. PyPI project name : baobab-ai-dev-database
3. Owner : baobabgit (organisation GitHub du dépôt)
4. Repository name : baobab-ai-dev-database
5. Workflow name : release.yml
6. Environment name : pypi

Créer ensuite l'environnement pypi dans les paramètres GitHub du dépôt (Settings → Environments) avant de pousser un tag v*.*.*.

Versionnement

• Version actuelle du package : 0.1.0 (alpha).
• Historique : CHANGELOG.md.

Licence

MIT — voir LICENSE.