# Buildsheet autogenerated by ravenadm tool -- Do not edit.
NAMEBASE= python-Twisted
VERSION= 24.3.0
KEYWORDS= python
VARIANTS= v11 v12
SDESC[v11]= Asynchronous networking framework (3.11)
SDESC[v12]= Asynchronous networking framework (3.12)
HOMEPAGE= https://twistedmatrix.com/
CONTACT= Python_Automaton[python@ironwolf.systems]
DOWNLOAD_GROUPS= main
SITES[main]= PYPIWHL/f8/f3/ff962a66ed957f4b51a669f25f6d0026a51dda1d25e3766a63d9a5aaf81e
DISTFILE[1]= twisted-24.3.0-py3-none-any.whl:main
DF_INDEX= 1
SPKGS[v11]= single
SPKGS[v12]= single
OPTIONS_AVAILABLE= PY311 PY312
OPTIONS_STANDARD= none
VOPTS[v11]= PY311=ON PY312=OFF
VOPTS[v12]= PY311=OFF PY312=ON
USES= cpe
DISTNAME= twisted-24.3.0.dist-info
CPE_PRODUCT= twisted
CPE_VENDOR= twistedmatrix
GENERATED= yes
[PY311].RUN_DEPENDS_ON= python-attrs:single:v11
python-Automat:single:v11
python-constantly:single:v11
python-hyperlink:single:v11
python-incremental:single:v11
python-typing-extensions:single:v11
python-zope.interface:single:v11
[PY311].USES_ON= python:v11,wheel
[PY312].RUN_DEPENDS_ON= python-attrs:single:v12
python-Automat:single:v12
python-constantly:single:v12
python-hyperlink:single:v12
python-incremental:single:v12
python-typing-extensions:single:v12
python-zope.interface:single:v12
[PY312].USES_ON= python:v12,wheel
[FILE:3041:descriptions/desc.single]
Twisted
#######
|gitter|_
|rtd|_
|pypi|_
|ci|_
For information on changes in this release, see the [NEWS] file.
What is this?
-------------
Twisted is an event-based framework for internet applications, supporting
Python 3.6+.
It includes modules for many different purposes, including the following:
- ``twisted.web``: HTTP clients and servers, HTML templating, and a WSGI
server
- ``twisted.conch``: SSHv2 and Telnet clients and servers and terminal
emulators
- ``twisted.words``: Clients and servers for IRC, XMPP, and other IM
protocols
- ``twisted.mail``: IMAPv4, POP3, SMTP clients and servers
- ``twisted.positioning``: Tools for communicating with NMEA-compatible GPS
receivers
- ``twisted.names``: DNS client and tools for making your own DNS servers
- ``twisted.trial``: A unit testing framework that integrates well with
Twisted-based code.
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).
Third-party reactors can plug into Twisted, and provide support for
additional event loops.
Installing
----------
To install the latest version of Twisted using pip::
$ pip install twisted
Additional instructions for installing this software are in [the
installation instructions].
Documentation and Support
-------------------------
Twisted's documentation is available from the [Twisted Matrix website].
This documentation contains how-tos, code examples, and an API reference.
Help is also available on the [Twisted mailing list].
There is also an IRC channel, ``#twisted``,
on the `Libera.Chat `_ network.
A web client is available at `web.libera.chat `_.
Unit Tests
----------
Twisted has a comprehensive test suite, which can be run by tox::
$ tox -l # to view all test environments
$ tox -e nocov # to run all the tests without coverage
$ tox -e withcov # to run all the tests with coverage
$ tox -e alldeps-withcov-posix # install all dependencies, run tests with
coverage on POSIX platform
You can test running the test suite under the different reactors with the
TWISTED_REACTOR environment variable::
$ env TWISTED_REACTOR=epoll tox -e alldeps-withcov-posix
Some of these tests may fail if you:
* don't have the dependencies required for a particular subsystem
installed,
* have a firewall blocking some ports (or things like Multicast, which
Linux NAT has shown itself to do), or
* run them as root.
Static Code Checkers
--------------------
You can ensure that code complies to Twisted [coding standards]::
$ tox -e lint # run pre-commit to check coding stanards
$ tox -e mypy # run MyPy static type checker to check for type errors
Or, for speed, use pre-commit directly::
$ pipx run pre-commit run
Copyright
---------
All of the code in this distribution is Copyright (c) 2001-2024 Twisted
Matrix Laboratories.
[FILE:110:distinfo]
039f2e6a49ab5108abd94de187fa92377abe5985c7a72d68d0ad266ba19eae63 3165636 twisted-24.3.0-py3-none-any.whl