METADATA 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127
  1. Metadata-Version: 2.1
  2. Name: pyzmq
  3. Version: 19.0.2
  4. Summary: Python bindings for 0MQ
  5. Home-page: https://pyzmq.readthedocs.org
  6. Author: Brian E. Granger, Min Ragan-Kelley
  7. Author-email: zeromq-dev@lists.zeromq.org
  8. License: LGPL+BSD
  9. Platform: UNKNOWN
  10. Classifier: Development Status :: 5 - Production/Stable
  11. Classifier: Intended Audience :: Developers
  12. Classifier: Intended Audience :: Science/Research
  13. Classifier: Intended Audience :: System Administrators
  14. Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
  15. Classifier: License :: OSI Approved :: BSD License
  16. Classifier: Operating System :: MacOS :: MacOS X
  17. Classifier: Operating System :: Microsoft :: Windows
  18. Classifier: Operating System :: POSIX
  19. Classifier: Topic :: System :: Networking
  20. Classifier: Programming Language :: Python :: 2
  21. Classifier: Programming Language :: Python :: 2.7
  22. Classifier: Programming Language :: Python :: 3
  23. Classifier: Programming Language :: Python :: 3.3
  24. Classifier: Programming Language :: Python :: 3.4
  25. Classifier: Programming Language :: Python :: 3.5
  26. Classifier: Programming Language :: Python :: 3.6
  27. Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*
  28. Description-Content-Type: text/markdown
  29. # PyZMQ: Python bindings for ØMQ
  30. [![Build Status](https://travis-ci.org/zeromq/pyzmq.svg?branch=master)](https://travis-ci.org/zeromq/pyzmq)
  31. [![Windows Build status](https://ci.appveyor.com/api/projects/status/ugoid0r2fnq8sr56/branch/master?svg=true)](https://ci.appveyor.com/project/minrk/pyzmq/branch/master)
  32. This package contains Python bindings for [ØMQ](http://www.zeromq.org).
  33. ØMQ is a lightweight and fast messaging implementation.
  34. PyZMQ should work with any reasonable version of Python (≥ 3.4),
  35. as well as Python 2.7 and 3.3, as well as PyPy.
  36. The Cython backend used by CPython supports libzmq ≥ 2.1.4 (including 3.2.x and 4.x),
  37. but the CFFI backend used by PyPy only supports libzmq ≥ 3.2.2 (including 4.x).
  38. For a summary of changes to pyzmq, see our
  39. [changelog](https://pyzmq.readthedocs.org/en/latest/changelog.html).
  40. ### ØMQ 3.x, 4.x
  41. PyZMQ fully supports the 3.x and 4.x APIs of libzmq,
  42. developed at [zeromq/libzmq](https://github.com/zeromq/libzmq).
  43. No code to change, no flags to pass,
  44. just build pyzmq against the latest and it should work.
  45. PyZMQ does not support the old libzmq 2 API on PyPy.
  46. ## Documentation
  47. See PyZMQ's Sphinx-generated
  48. [documentation](https://zeromq.github.io/pyzmq) on GitHub for API
  49. details, and some notes on Python and Cython development. If you want to
  50. learn about using ØMQ in general, the excellent [ØMQ
  51. Guide](http://zguide.zeromq.org/py:all) is the place to start, which has a
  52. Python version of every example. We also have some information on our
  53. [wiki](https://github.com/zeromq/pyzmq/wiki).
  54. ## Downloading
  55. Unless you specifically want to develop PyZMQ, we recommend downloading
  56. the PyZMQ source code or wheels from
  57. [PyPI](https://pypi.io/project/pyzmq),
  58. or install with conda.
  59. You can also get the latest source code from our GitHub repository, but
  60. building from the repository will require that you install recent Cython.
  61. ## Building and installation
  62. For more detail on building pyzmq, see [our Wiki](https://github.com/zeromq/pyzmq/wiki/Building-and-Installing-PyZMQ).
  63. We build wheels for OS X, Windows, and Linux, so you can get a binary on those platforms with:
  64. pip install pyzmq
  65. but compiling from source with `pip install pyzmq` should work in most environments.
  66. Especially on OS X, make sure you are using the latest pip (≥ 8), or it may not find the right wheels.
  67. If the wheel doesn't work for some reason, or you want to force pyzmq to be compiled
  68. (this is often preferable if you already have libzmq installed and configured the way you want it),
  69. you can force installation with:
  70. pip install --no-binary=:all: pyzmq
  71. When compiling pyzmq (e.g. installing with pip on Linux),
  72. it is generally recommended that zeromq be installed separately,
  73. via homebrew, apt, yum, etc:
  74. # Debian-based
  75. sudo apt-get install libzmq3-dev
  76. # RHEL-based
  77. sudo yum install libzmq3-devel
  78. If this is not available, pyzmq will *try* to build libzmq as a Python Extension,
  79. though this is not guaranteed to work.
  80. Building pyzmq from the git repo (including release tags on GitHub) requires Cython.
  81. ## Old versions
  82. pyzmq 16 drops support Python 2.6 and 3.2.
  83. If you need to use one of those Python versions, you can pin your pyzmq version to before 16:
  84. pip install 'pyzmq<16'
  85. For libzmq 2.0.x, use 'pyzmq<2.1'
  86. pyzmq-2.1.11 was the last version of pyzmq to support Python 2.5,
  87. and pyzmq ≥ 2.2.0 requires Python ≥ 2.6.
  88. pyzmq-13.0.0 introduces PyPy support via CFFI, which only supports libzmq-3.2.2 and newer.
  89. PyZMQ releases ≤ 2.2.0 matched libzmq versioning, but this is no longer the case,
  90. starting with PyZMQ 13.0.0 (it was the thirteenth release, so why not?).
  91. PyZMQ ≥ 13.0 follows semantic versioning conventions accounting only for PyZMQ itself.