Henrri Connect

Bibliothèque Python souveraine pour l'API de facturation Henrri. Fournit un client synchrone et asynchrone pour interagir avec l'ensemble des ressources de l'API : clients, factures, articles, unités, revenus, etc.

Ce SDK est un client Python non officiel pour l’API Henrri. Il n’est ni affilié, ni soutenu, ni approuvé par Henrri. Henrri est une marque déposée appartenant à son éditeur.

Sommaire

• Henrri Connect
  • Sommaire
  • Installation
  • Démarrage rapide
    • Authentification
    • Mode synchrone
    • Mode asynchrone
  • Modules disponibles
  • Gestion des erreurs
  • Développement
  • Contribution
  • Licence

Installation

pip install henrri-connect

Dépendances : httpx et pydantic v2.

Démarrage rapide

Authentification

Le client se connecte automatiquement à la première requête et gère le renouvellement du token. Il n'est pas nécessaire d'appeler authenticate() explicitement.

from henrri_connect import SyncHenrriClient

client = SyncHenrriClient("votre_client_id", "votre_client_secret")

L'URL par défaut est l'environnement sandbox (https://api-sandbox.henrri.io). Pour pointer vers la production, passez base_url :

client = SyncHenrriClient(
    "votre_client_id",
    "votre_client_secret",
    base_url="https://api.henrri.io",
)

Mode synchrone

Voir le guide complet d'utilisation synchrone : docs/usage_sync.md

Mode asynchrone

Voir le guide complet d'utilisation asynchrone : docs/usage_async.md

Modules disponibles

Le client expose un sous-client par ressource API. Chaque sous-client est identique en synchrone et asynchrone (les méthodes async renvoient des coroutines).

Référence API complète : remiv1.github.io/henrri-connect

Gestion des erreurs

Toutes les erreurs HTTP sont converties en exceptions typées héritant de HenrriError :

from henrri_connect import SyncHenrriClient
from henrri_connect.exc import HenrriNotFoundError, HenrriAuthError

client = SyncHenrriClient("client_id", "client_secret")

try:
    customer = client.customers.get(9999)
except HenrriNotFoundError:
    print("Client introuvable.")
except HenrriAuthError:
    print("Identifiants invalides.")

Développement

# Cloner le dépôt
git clone https://github.com/remiv1/henrri-connect.git
cd henrri-connect

# Créer un environnement virtuel et installer les dépendances dev
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

# Lancer les tests
make test

# Générer la documentation
make docs

# Prévisualiser la documentation
make docs-serve

Commandes disponibles :

make test          # Lancer les 96 tests
make build         # Construire la distribution (wheel + sdist)
make build-verify  # Vérifier les artefacts avec twine
make publish       # Publier sur PyPI (demande confirmation)
make docs          # Générer la doc HTML dans docs/
make docs-serve    # Servir la doc localement (port 8080)
make docs-clean    # Nettoyer les fichiers générés
make all           # test + build + build-verify + publish + clean

Contribution

Les contributions sont les bienvenues ! Consultez CONTRIBUTING.md pour les conventions de code, le workflow de PR et les bonnes pratiques.

Licence

Distribué sous licence MIT. Voir LICENSE.

↑ Retour en haut