Ce package contient des liaisons Python pour ZeroMQ. ØMQ est une implémentation de messagerie légère et rapide.
PyZMQ devrait fonctionner avec n'importe quelle version raisonnable de Python (≥ 3.7), ainsi qu'avec PyPy. Le backend Cython utilisé par CPython prend en charge libzmq ≥ 2.1.4 (y compris 3.2.x et 4.x), mais le backend CFFI utilisé par PyPy ne prend en charge que libzmq ≥ 3.2.2 (y compris 4.x).
Pour un résumé des modifications apportées à pyzmq, consultez notre journal des modifications.
PyZMQ prend entièrement en charge les API 3.x et 4.x de libzmq, développées chez zeromq/libzmq. Aucun code à modifier, aucun indicateur à transmettre, construisez simplement pyzmq avec la dernière version et cela devrait fonctionner.
PyZMQ ne prend pas en charge l'ancienne API libzmq 2 sur PyPy.
Consultez la documentation générée par Sphinx de PyZMQ sur Lire la documentation pour plus de détails sur l'API et quelques notes sur le développement Python et Cython. Si vous souhaitez en savoir plus sur l'utilisation d'ØMQ en général, l'excellent guide ØMQ est le point de départ, qui contient une version Python de chaque exemple. Nous avons également quelques informations sur notre wiki.
Sauf si vous souhaitez spécifiquement développer PyZMQ, nous vous recommandons de télécharger le code source ou les roues de PyZMQ depuis PyPI, ou de les installer avec conda.
Vous pouvez également obtenir le dernier code source à partir de notre référentiel GitHub, mais la construction à partir du référentiel nécessitera l'installation de Cython récent.
Pour plus de détails sur la création de pyzmq, consultez nos documents.
Nous construisons des roues pour macOS, Windows et Linux, afin que vous puissiez obtenir un binaire sur ces plates-formes avec :
pip install pyzmq
mais la compilation à partir des sources avec pip install pyzmq
devrait fonctionner dans la plupart des environnements. Assurez-vous que vous utilisez le dernier pip, sinon il risque de ne pas trouver les bonnes roues.
Si la roue ne fonctionne pas pour une raison quelconque, ou si vous souhaitez forcer la compilation de pyzmq (c'est souvent préférable si vous avez déjà installé libzmq et configuré comme vous le souhaitez), vous pouvez forcer l'installation à partir des sources avec :
pip install --no-binary=pyzmq pyzmq
Les versions pyzmq 16 prennent en charge Python 2.6 et 3.2. Si vous devez utiliser l'une de ces versions de Python, vous pouvez épingler votre version de pyzmq avant 16 :
pip install 'pyzmq<16'
Pour libzmq 2.0.x, utilisez 'pyzmq<2.1'
pyzmq-2.1.11 était la dernière version de pyzmq à prendre en charge Python 2.5, et pyzmq ≥ 2.2.0 nécessite Python ≥ 2.6. pyzmq-13.0.0 introduit la prise en charge de PyPy via CFFI, qui ne prend en charge que libzmq-3.2.2 et versions ultérieures.
Les versions PyZMQ ≤ 2.2.0 correspondaient au versioning de libzmq, mais ce n'est plus le cas, à partir de PyZMQ 13.0.0 (c'était la treizième version, alors pourquoi pas ?). PyZMQ ≥ 13.0 suit les conventions de gestion de versions sémantiques ne prenant en compte que PyZMQ lui-même.