You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

PKG-INFO 5.8KB

5 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. Metadata-Version: 2.1
  2. Name: Twisted
  3. Version: 19.10.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. Description: Twisted
  15. =======
  16. |pypi|_
  17. |travis|_
  18. |circleci|_
  19. For information on changes in this release, see the `NEWS <https://github.com/twisted/twisted/blob/trunk/NEWS.rst>`_ file.
  20. What is this?
  21. -------------
  22. Twisted is an event-based framework for internet applications, supporting Python 2.7 and Python 3.5+.
  23. It includes modules for many different purposes, including the following:
  24. - ``twisted.web``: HTTP clients and servers, HTML templating, and a WSGI server
  25. - ``twisted.conch``: SSHv2 and Telnet clients and servers and terminal emulators
  26. - ``twisted.words``: Clients and servers for IRC, XMPP, and other IM protocols
  27. - ``twisted.mail``: IMAPv4, POP3, SMTP clients and servers
  28. - ``twisted.positioning``: Tools for communicating with NMEA-compatible GPS receivers
  29. - ``twisted.names``: DNS client and tools for making your own DNS servers
  30. - ``twisted.trial``: A unit testing framework that integrates well with Twisted-based code.
  31. 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).
  32. Third-party reactors can plug into Twisted, and provide support for additional event loops.
  33. Installing
  34. ----------
  35. To install the latest version of Twisted using pip::
  36. $ pip install twisted
  37. Additional instructions for installing this software are in `the installation instructions <https://github.com/twisted/twisted/blob/trunk/INSTALL.rst>`_.
  38. Documentation and Support
  39. -------------------------
  40. Twisted's documentation is available from the `Twisted Matrix website <https://twistedmatrix.com/documents/current/>`_.
  41. This documentation contains how-tos, code examples, and an API reference.
  42. Help is also available on the `Twisted mailing list <https://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python>`_.
  43. 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``.
  44. Unit Tests
  45. ----------
  46. Twisted has a comprehensive test suite, which can be run by ``tox``::
  47. $ tox -l # to view all test environments
  48. $ tox -e py27-tests # to run the tests for Python 2.7
  49. $ tox -e py35-tests # to run the tests for Python 3.5
  50. You can test running the test suite under the different reactors with the ``TWISTED_REACTOR`` environment variable::
  51. $ env TWISTED_REACTOR=epoll tox -e py27-tests
  52. Some of these tests may fail if you:
  53. * don't have the dependencies required for a particular subsystem installed,
  54. * have a firewall blocking some ports (or things like Multicast, which Linux NAT has shown itself to do), or
  55. * run them as root.
  56. Copyright
  57. ---------
  58. All of the code in this distribution is Copyright (c) 2001-2019 Twisted Matrix Laboratories.
  59. Twisted is made available under the MIT license.
  60. The included `LICENSE <https://github.com/twisted/twisted/blob/trunk/LICENSE>`_ file describes this in detail.
  61. Warranty
  62. --------
  63. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  64. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  65. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
  66. TO THE USE OF THIS SOFTWARE IS WITH YOU.
  67. IN NO EVENT WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
  68. AND/OR REDISTRIBUTE THE LIBRARY, BE LIABLE TO YOU FOR ANY DAMAGES, EVEN IF
  69. SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  70. DAMAGES.
  71. Again, see the included `LICENSE <https://github.com/twisted/twisted/blob/trunk/LICENSE>`_ file for specific legal details.
  72. .. |pypi| image:: http://img.shields.io/pypi/v/twisted.svg
  73. .. _pypi: https://pypi.python.org/pypi/twisted
  74. .. |travis| image:: https://travis-ci.org/twisted/twisted.svg?branch=trunk
  75. .. _travis: https://travis-ci.org/twisted/twisted
  76. .. |circleci| image:: https://circleci.com/gh/twisted/twisted.svg?style=svg
  77. .. _circleci: https://circleci.com/gh/twisted/twisted
  78. Platform: UNKNOWN
  79. Classifier: Programming Language :: Python :: 2.7
  80. Classifier: Programming Language :: Python :: 3
  81. Classifier: Programming Language :: Python :: 3.5
  82. Classifier: Programming Language :: Python :: 3.6
  83. Classifier: Programming Language :: Python :: 3.7
  84. Description-Content-Type: text/x-rst
  85. Provides-Extra: soap
  86. Provides-Extra: conch
  87. Provides-Extra: windows_platform
  88. Provides-Extra: tls
  89. Provides-Extra: dev
  90. Provides-Extra: all_non_platform
  91. Provides-Extra: macos_platform
  92. Provides-Extra: serial
  93. Provides-Extra: osx_platform
  94. Provides-Extra: http2