METADATA 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217
  1. Metadata-Version: 2.1
  2. Name: Twisted
  3. Version: 20.3.0
  4. Summary: An asynchronous networking framework written in Python
  5. Home-page: https://twistedmatrix.com/
  6. Author: Twisted Matrix Laboratories
  7. Author-email: twisted-python@twistedmatrix.com
  8. Maintainer: Glyph Lefkowitz
  9. Maintainer-email: glyph@twistedmatrix.com
  10. License: MIT
  11. Project-URL: Documentation, https://twistedmatrix.com/documents/current/
  12. Project-URL: Source, https://github.com/twisted/twisted
  13. Project-URL: Issues, https://twistedmatrix.com/trac/report
  14. Platform: UNKNOWN
  15. Classifier: Programming Language :: Python :: 2.7
  16. Classifier: Programming Language :: Python :: 3
  17. Classifier: Programming Language :: Python :: 3.5
  18. Classifier: Programming Language :: Python :: 3.6
  19. Classifier: Programming Language :: Python :: 3.7
  20. Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
  21. Description-Content-Type: text/x-rst
  22. Requires-Dist: zope.interface (>=4.4.2)
  23. Requires-Dist: constantly (>=15.1)
  24. Requires-Dist: incremental (>=16.10.1)
  25. Requires-Dist: Automat (>=0.3.0)
  26. Requires-Dist: hyperlink (>=17.1.1)
  27. Requires-Dist: PyHamcrest (!=1.10.0,>=1.9.0)
  28. Requires-Dist: attrs (>=19.2.0)
  29. Provides-Extra: all_non_platform
  30. Requires-Dist: pyopenssl (>=16.0.0) ; extra == 'all_non_platform'
  31. Requires-Dist: service-identity (>=18.1.0) ; extra == 'all_non_platform'
  32. Requires-Dist: idna (!=2.3,>=0.6) ; extra == 'all_non_platform'
  33. Requires-Dist: pyasn1 ; extra == 'all_non_platform'
  34. Requires-Dist: cryptography (>=2.5) ; extra == 'all_non_platform'
  35. Requires-Dist: appdirs (>=1.4.0) ; extra == 'all_non_platform'
  36. Requires-Dist: bcrypt (>=3.0.0) ; extra == 'all_non_platform'
  37. Requires-Dist: soappy ; extra == 'all_non_platform'
  38. Requires-Dist: pyserial (>=3.0) ; extra == 'all_non_platform'
  39. Requires-Dist: h2 (<4.0,>=3.0) ; extra == 'all_non_platform'
  40. Requires-Dist: priority (<2.0,>=1.1.0) ; extra == 'all_non_platform'
  41. Requires-Dist: pywin32 (!=226) ; (platform_system == "Windows") and extra == 'all_non_platform'
  42. Provides-Extra: conch
  43. Requires-Dist: pyasn1 ; extra == 'conch'
  44. Requires-Dist: cryptography (>=2.5) ; extra == 'conch'
  45. Requires-Dist: appdirs (>=1.4.0) ; extra == 'conch'
  46. Requires-Dist: bcrypt (>=3.0.0) ; extra == 'conch'
  47. Provides-Extra: dev
  48. Requires-Dist: pyflakes (>=1.0.0) ; extra == 'dev'
  49. Requires-Dist: twisted-dev-tools (>=0.0.2) ; extra == 'dev'
  50. Requires-Dist: python-subunit ; extra == 'dev'
  51. Requires-Dist: sphinx (>=1.3.1) ; extra == 'dev'
  52. Requires-Dist: towncrier (>=17.4.0) ; extra == 'dev'
  53. Provides-Extra: http2
  54. Requires-Dist: h2 (<4.0,>=3.0) ; extra == 'http2'
  55. Requires-Dist: priority (<2.0,>=1.1.0) ; extra == 'http2'
  56. Provides-Extra: macos_platform
  57. Requires-Dist: pyobjc-core ; extra == 'macos_platform'
  58. Requires-Dist: pyobjc-framework-CFNetwork ; extra == 'macos_platform'
  59. Requires-Dist: pyobjc-framework-Cocoa ; extra == 'macos_platform'
  60. Requires-Dist: pyopenssl (>=16.0.0) ; extra == 'macos_platform'
  61. Requires-Dist: service-identity (>=18.1.0) ; extra == 'macos_platform'
  62. Requires-Dist: idna (!=2.3,>=0.6) ; extra == 'macos_platform'
  63. Requires-Dist: pyasn1 ; extra == 'macos_platform'
  64. Requires-Dist: cryptography (>=2.5) ; extra == 'macos_platform'
  65. Requires-Dist: appdirs (>=1.4.0) ; extra == 'macos_platform'
  66. Requires-Dist: bcrypt (>=3.0.0) ; extra == 'macos_platform'
  67. Requires-Dist: soappy ; extra == 'macos_platform'
  68. Requires-Dist: pyserial (>=3.0) ; extra == 'macos_platform'
  69. Requires-Dist: h2 (<4.0,>=3.0) ; extra == 'macos_platform'
  70. Requires-Dist: priority (<2.0,>=1.1.0) ; extra == 'macos_platform'
  71. Requires-Dist: pywin32 (!=226) ; (platform_system == "Windows") and extra == 'macos_platform'
  72. Provides-Extra: osx_platform
  73. Requires-Dist: pyobjc-core ; extra == 'osx_platform'
  74. Requires-Dist: pyobjc-framework-CFNetwork ; extra == 'osx_platform'
  75. Requires-Dist: pyobjc-framework-Cocoa ; extra == 'osx_platform'
  76. Requires-Dist: pyopenssl (>=16.0.0) ; extra == 'osx_platform'
  77. Requires-Dist: service-identity (>=18.1.0) ; extra == 'osx_platform'
  78. Requires-Dist: idna (!=2.3,>=0.6) ; extra == 'osx_platform'
  79. Requires-Dist: pyasn1 ; extra == 'osx_platform'
  80. Requires-Dist: cryptography (>=2.5) ; extra == 'osx_platform'
  81. Requires-Dist: appdirs (>=1.4.0) ; extra == 'osx_platform'
  82. Requires-Dist: bcrypt (>=3.0.0) ; extra == 'osx_platform'
  83. Requires-Dist: soappy ; extra == 'osx_platform'
  84. Requires-Dist: pyserial (>=3.0) ; extra == 'osx_platform'
  85. Requires-Dist: h2 (<4.0,>=3.0) ; extra == 'osx_platform'
  86. Requires-Dist: priority (<2.0,>=1.1.0) ; extra == 'osx_platform'
  87. Requires-Dist: pywin32 (!=226) ; (platform_system == "Windows") and extra == 'osx_platform'
  88. Provides-Extra: serial
  89. Requires-Dist: pyserial (>=3.0) ; extra == 'serial'
  90. Requires-Dist: pywin32 (!=226) ; (platform_system == "Windows") and extra == 'serial'
  91. Provides-Extra: soap
  92. Requires-Dist: soappy ; extra == 'soap'
  93. Provides-Extra: tls
  94. Requires-Dist: pyopenssl (>=16.0.0) ; extra == 'tls'
  95. Requires-Dist: service-identity (>=18.1.0) ; extra == 'tls'
  96. Requires-Dist: idna (!=2.3,>=0.6) ; extra == 'tls'
  97. Provides-Extra: windows_platform
  98. Requires-Dist: pywin32 (!=226) ; extra == 'windows_platform'
  99. Requires-Dist: pyopenssl (>=16.0.0) ; extra == 'windows_platform'
  100. Requires-Dist: service-identity (>=18.1.0) ; extra == 'windows_platform'
  101. Requires-Dist: idna (!=2.3,>=0.6) ; extra == 'windows_platform'
  102. Requires-Dist: pyasn1 ; extra == 'windows_platform'
  103. Requires-Dist: cryptography (>=2.5) ; extra == 'windows_platform'
  104. Requires-Dist: appdirs (>=1.4.0) ; extra == 'windows_platform'
  105. Requires-Dist: bcrypt (>=3.0.0) ; extra == 'windows_platform'
  106. Requires-Dist: soappy ; extra == 'windows_platform'
  107. Requires-Dist: pyserial (>=3.0) ; extra == 'windows_platform'
  108. Requires-Dist: h2 (<4.0,>=3.0) ; extra == 'windows_platform'
  109. Requires-Dist: priority (<2.0,>=1.1.0) ; extra == 'windows_platform'
  110. Requires-Dist: pywin32 (!=226) ; (platform_system == "Windows") and extra == 'windows_platform'
  111. Twisted
  112. =======
  113. |pypi|_
  114. |travis|_
  115. |circleci|_
  116. For information on changes in this release, see the `NEWS <https://github.com/twisted/twisted/blob/trunk/NEWS.rst>`_ file.
  117. What is this?
  118. -------------
  119. Twisted is an event-based framework for internet applications, supporting Python 2.7 and Python 3.5+.
  120. It includes modules for many different purposes, including the following:
  121. - ``twisted.web``: HTTP clients and servers, HTML templating, and a WSGI server
  122. - ``twisted.conch``: SSHv2 and Telnet clients and servers and terminal emulators
  123. - ``twisted.words``: Clients and servers for IRC, XMPP, and other IM protocols
  124. - ``twisted.mail``: IMAPv4, POP3, SMTP clients and servers
  125. - ``twisted.positioning``: Tools for communicating with NMEA-compatible GPS receivers
  126. - ``twisted.names``: DNS client and tools for making your own DNS servers
  127. - ``twisted.trial``: A unit testing framework that integrates well with Twisted-based code.
  128. Twisted supports all major system event loops -- ``select`` (all platforms), ``poll`` (most POSIX platforms), ``epoll`` (Linux), ``kqueue`` (FreeBSD, macOS), IOCP (Windows), and various GUI event loops (GTK+2/3, Qt, wxWidgets).
  129. Third-party reactors can plug into Twisted, and provide support for additional event loops.
  130. Installing
  131. ----------
  132. To install the latest version of Twisted using pip::
  133. $ pip install twisted
  134. Additional instructions for installing this software are in `the installation instructions <https://github.com/twisted/twisted/blob/trunk/INSTALL.rst>`_.
  135. Documentation and Support
  136. -------------------------
  137. Twisted's documentation is available from the `Twisted Matrix website <https://twistedmatrix.com/documents/current/>`_.
  138. This documentation contains how-tos, code examples, and an API reference.
  139. Help is also available on the `Twisted mailing list <https://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python>`_.
  140. There is also a pair of very lively IRC channels, ``#twisted`` (for general Twisted questions) and ``#twisted.web`` (for Twisted Web), on ``chat.freenode.net``.
  141. Unit Tests
  142. ----------
  143. Twisted has a comprehensive test suite, which can be run by ``tox``::
  144. $ tox -l # to view all test environments
  145. $ tox -e py27-tests # to run the tests for Python 2.7
  146. $ tox -e py35-tests # to run the tests for Python 3.5
  147. You can test running the test suite under the different reactors with the ``TWISTED_REACTOR`` environment variable::
  148. $ env TWISTED_REACTOR=epoll tox -e py27-tests
  149. Some of these tests may fail if you:
  150. * don't have the dependencies required for a particular subsystem installed,
  151. * have a firewall blocking some ports (or things like Multicast, which Linux NAT has shown itself to do), or
  152. * run them as root.
  153. Copyright
  154. ---------
  155. All of the code in this distribution is Copyright (c) 2001-2020 Twisted Matrix Laboratories.
  156. Twisted is made available under the MIT license.
  157. The included `LICENSE <https://github.com/twisted/twisted/blob/trunk/LICENSE>`_ file describes this in detail.
  158. Warranty
  159. --------
  160. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  161. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  162. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
  163. TO THE USE OF THIS SOFTWARE IS WITH YOU.
  164. IN NO EVENT WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
  165. AND/OR REDISTRIBUTE THE LIBRARY, BE LIABLE TO YOU FOR ANY DAMAGES, EVEN IF
  166. SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  167. DAMAGES.
  168. Again, see the included `LICENSE <https://github.com/twisted/twisted/blob/trunk/LICENSE>`_ file for specific legal details.
  169. .. |pypi| image:: http://img.shields.io/pypi/v/twisted.svg
  170. .. _pypi: https://pypi.python.org/pypi/twisted
  171. .. |travis| image:: https://travis-ci.org/twisted/twisted.svg?branch=trunk
  172. .. _travis: https://travis-ci.org/twisted/twisted
  173. .. |circleci| image:: https://circleci.com/gh/twisted/twisted.svg?style=svg
  174. .. _circleci: https://circleci.com/gh/twisted/twisted