Organisation du dépôt et structure des fichiers

PyUV fournit une couche d'abstraction Python au-dessus de libuv, la bibliothèque d'E/S asynchrones multiplateforme qui propulse Node.js. L'arborescence du code source est conçue pour séparer clairement la logique principale, les tests et les outils de construction :

depot_pyuv/
├── LICENSE            # Termes de distribution du logiciel
├── MANIFEST.in        # Règles d'inclusion pour la génération du paquet source
├── Makefile           # Commandes d'automatisation pour la compilation C
├── README.rst         # Documentation introductive et directives de compilation
├── setup.py           # Script de distribution et d'installation via pip
├── src/
│   └── pyuv/          # Implémentation centrale des liaisons C/Python
│       ├── __init__.py# Exposition de l'API publique
│       └── ...        # Modules spécifiques (TCP, UDP, DNS, etc.)
├── tests/             # Suite de tests unitaires et d'intégration
│   └── ...
└── tox.ini            # Matrice de tests pour les différentes versions de l'interpréteur

Cette séparation stricte facilite la maintenance du code natif tout en assurant une intégration fluide avec l'écosystème de paquets Python.

Initialisation du moteur asynchrone

Contrairement aux applications autonomes, PyUV est conçu comme une bibliothèque programmatique. Il n'existe pas de point d'entrée exécutable unique. L'intégration commence par l'instanciation d'une boucle d'événements (event loop) qui agira comme le coordinateur central pour toutes les opérations non bloquantes.

Voici une approche modifiée pour initialiser et gérer le cycle de vie de la boucle d'événements :

import pyuv

def executer_boucle_asynchrone():
    # Instanciation d'une boucle d'événements dédiée plutôt que l'utilisation de la boucle par défaut
    boucle = pyuv.Loop.new_loop()
    
    try:
        # Traitement des événements jusqu'à épuisement de la file d'attente active
        boucle.run(pyuv.UV_RUN_DEFAULT)
    finally:
        # Libération explicite des descripteurs et ressources allouées en C
        boucle.close()

if __name__ == "__main__":
    executer_boucle_asynchrone()

Ce modèle permet d'isoler les opérations asynchrones et d'assurer une libération correcte des rsesources système sous-jacentes gérées par libuv.

Configuration de l'environnement et paramètres d'exécution

En tant que wrapper bas niveau, PyUV ne s'appuie sur aucun fichier de configuration externe pour son fonctionnement interne. Les paramètres tels que les options de réseau, les temporisateurs ou les pools de threads sont définis dynamiquement via l'API Python lors de l'exécution.

Les fichiers tels que tox.ini ou setup.cfg présents dans le dépôt sont exclusivement dédiés au pipeline de développement. Ils orchestrent la compilation des extensions C, la liaison avec les bibliothèques système et l'exécution des tests sur plusieurs versions de Python. Pour les applications finales, la configuration métier (comme les adresses IP, les ports ou les chemins de fichiers) doit être gérée par l'application hôte et injectée dans les objets PyUV au moment de leur instanciation.