{{{
#!div class="column-layout" style="display: table;"
{{{
#!div class="leftcol" style="display: table-cell"
{{{
#!div class="leftcolcol"
{{{
#!div id="download"
[[Image(/chrome/common/download_icon.png, id=download_icon, title=Downloads, alt="", link=wiki:Downloads)]]

= Downloads =

== Source ==

 * [[ProjectVersion(http://pypi.python.org/packages/source/T/Twisted/Twisted-%(base)s.tar.bz2#md5=%(md5)s Twisted %(base)s tar.bz2)]]

== Windows (32-bit) ==

 * [[ProjectVersion(http://pypi.python.org/packages/2.7/T/Twisted/Twisted-%(base)s.win32-py2.7.msi Twisted %(base)s for Python 2.7)]]
 * [[ProjectVersion(http://pypi.python.org/packages/2.6/T/Twisted/Twisted-%(base)s.win32-py2.6.msi Twisted %(base)s for Python 2.6)]]
 * [[ProjectVersion(http://pypi.python.org/packages/2.5/T/Twisted/Twisted-%(base)s.win32-py2.5.msi Twisted %(base)s for Python 2.5)]]

== Other ==

 * [wiki:Downloads More downloads]


== Dependencies ==

 * [http://pypi.python.org/pypi/zope.interface#download zope.interface]
}}}

{{{
#!div class="side-panel twisted-news"

== [http://labs.twistedmatrix.com/ Twisted News] ==

{{{
#!div id="twisted-news" class="feed-content"
[[Image(/chrome/common/throbber.gif, link=, class=throbber, title="", alt="")]]
}}}
}}}


{{{
#!div class="side-panel donations"

== Donate to Twisted ==

Donations are [wiki:TwistedSoftwareFoundation#Background tax-deductible].

{{{
#!html
<div class="donation-buttons">
    <div>
    <form action="https://checkout.google.com/cws/v2/Donations/622836985124940/checkoutForm" id="BB_BuyButtonForm" method="post" name="BB_BuyButtonForm">
        <input name="item_name_1" value="Twisted Project (via Software Freedom Conservancy)" type="hidden">
        <input name="item_description_1" value="A directed, ear-marked donation for the Twisted Project, via the Software Freedom Conservancy." type="hidden">
        <input name="item_quantity_1" value="1" type="hidden">
        <input name="item_currency_1" value="USD" type="hidden">
        <input name="item_is_modifiable_1" value="true" type="hidden">
        <input name="item_min_price_1" value="5.0" type="hidden">
        <input name="item_max_price_1" value="25000.0" type="hidden">
        <div style="text-align: left">
            <label for="item_price_1">US $</label>
            <input id="item_price_1" name="item_price_1" value="25" type="text" size="6" style="text-align: right">
        </div>
        <input name="_charset_" value="utf-8" type="hidden">
        <input onclick="return setDonationAmount(this.form, 'item_price_1')" alt="Google Checkout" src="https://checkout.google.com/buttons/donateNow.gif?merchant_id=622836985124940&w=115&h=50&style=trans&variant=text&loc=en_US" type="image">
    </form>
    </div>
    <div>
    <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
        <input name="cmd" value="_s-xclick" type="hidden">
        <input name="hosted_button_id" value="ZB3NXPUZHQUKS" type="hidden">
        <input name="currency_code" value="USD" type="hidden">
        <input name="amount" value="25" type="hidden">
        <input onclick="return setDonationAmount(this.form, 'amount')" type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" alt="PayPal">
        <div style="text-align: center; padding-top: 3px; font-size: 0.85em; color: #555">PayPal</div>
        <img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
    </form>
    </div>
</div>
}}}


= [wiki:TwistedSponsors Twisted Sponsors] =

[wiki:TwistedSoftwareFoundation Become a 2012 sponsor today]! For any donation above [wiki:TwistedSoftwareFoundation#SponsorshipLevels the bronze level], we will display your logo here on the front page.

{{{
#!div class="twisted-sponsors"

=== Silver ===

[[Image(TSF/SponsorLogos:Appropriate-Solutions-Inc.gif, title=Appropriate Solutions Inc, link=http://www.appropriatesolutions.com/)]]
[[Image(TSF/SponsorLogos:dreamhost.gif, title=DreamHost, link=http://dreamhost.com/?q=twisted)]]
[[Image(TSF/SponsorLogos:simb.png, title=SIMB, link=http://www.simb.com.br/)]]

=== Bronze ===

[[Image(TSF/SponsorLogos:dyn-logo.png, title=Dynamic Network Services Inc, link=http://www.dyn.com/)]]
}}}

}}}
}}}
}}}

{{{
#!div class="centercol" style="display: table-cell"

= What is Twisted? =

Twisted is an event-driven networking engine written in Python and licensed under the open source [http://www.opensource.org/licenses/mit-license.php MIT license].


== Code Examples ==

{{{
#!html
<ul id="frontpage-tabs" class="nav nav-tabs">
    <li class="active"><a href="#echoserver">Echo Server</a></li>
    <li><a href="#webserver">Web server</a></li>
    <li><a href="#pubsubserver">Publish/subscribe</a></li>
</ul>
}}}

{{{
#!div class="tab-content"

{{{
#!div class="tab-pane active" id="echoserver"

Twisted makes it easy to implement custom network applications. Here's a TCP server that echoes back everything that's written to it:

{{{
#!python
from twisted.internet import protocol, reactor

class Echo(protocol.Protocol):
    def dataReceived(self, data):
        self.transport.write(data)

class EchoFactory(protocol.Factory):
    def buildProtocol(self, addr):
        return Echo()

reactor.listenTCP(1234, EchoFactory())
reactor.run()
}}}

Learn more about [http://twistedmatrix.com/documents/current/core/howto/servers.html writing servers], [http://twistedmatrix.com/documents/current/core/howto/clients.html writing clients] and the [http://twistedmatrix.com/documents/current/core/howto/index.html core networking libraries ], including support for SSL, UDP, scheduled events, unit testing infrastructure, and much more.
}}}


{{{
#!div class="tab-pane" id="webserver"
Twisted includes an event-driven web server. Here's a sample web application; notice how the resource object persists in memory, rather than being recreated on each request:

{{{
#!python
from twisted.web import server, resource
from twisted.internet import reactor

class HelloResource(resource.Resource):
    isLeaf = True
    numberRequests = 0
    
    def render_GET(self, request):
        self.numberRequests += 1
        request.setHeader("content-type", "text/plain")
        return "I am request #" + str(self.numberRequests) + "\n"

reactor.listenTCP(8080, server.Site(HelloResource()))
reactor.run()
}}}

Learn more about [http://twistedmatrix.com/documents/current/web/howto/web-in-60/index.html web application development], [http://twistedmatrix.com/documents/current/web/howto/twisted-templates.html templates] and Twisted's [http://twistedmatrix.com/documents/current/web/howto/client.html HTTP client].
}}}

{{{
#!div class="tab-pane" id="pubsubserver"
Here's a simple publish/subscribe server, where clients see all messages posted by other clients:

{{{
#!python
from twisted.internet import reactor, protocol
from twisted.protocols import basic

class PubProtocol(basic.LineReceiver):
    delimiter = "\n"

    def __init__(self, factory):
        self.factory = factory

    def connectionMade(self):
        self.factory.clients.add(self)

    def connectionLost(self, reason):
        self.factory.clients.remove(self)

    def lineReceived(self, line):
        message = "<%s> %s\n" % (self.transport.getHost(), line)
        for c in self.factory.clients:
            if c != self:
                c.transport.write(message)


class PubFactory(protocol.Factory):
    def __init__(self):
        self.clients = set()

    def buildProtocol(self, addr):
        return PubProtocol(self)


if __name__ == '__main__':
    reactor.listenTCP(1025, PubFactory())
    reactor.run()
}}}

}}}


}}}


== More Protocols ==

Twisted also supports many common network protocols, including SMTP, POP3, IMAP, SSHv2, and DNS. For more information see our [wiki:Documentation documentation] and [http://twistedmatrix.com/documents/current/api/ API reference].


== Community ==

[[Image(http://oreilly.com/catalog/covers/twistedadn.s.gif, title=The Twisted Book, align=right, link=http://www.amazon.com/gp/product/0596100329?ie=UTF8&tag=jpcalsjou-20&linkCode=as2&camp=1789&creative=9325&creativeASIN=0596100329)]]

 * Get in touch with the [wiki:TwistedCommunity Twisted community] through [wiki:TwistedCommunity#MailLists email], [http://stackoverflow.com/questions/tagged/twisted Stack Overflow] or [wiki:TwistedCommunity#IRC IRC];
 * Learn about the Twisted [wiki:TwistedDevelopment development process] and how to [wiki:ContributingToTwistedLabs contribute];
 * Read about [wiki:ProjectsUsingTwisted software using] Twisted and their [wiki:SuccessStories success stories];
 * Find out what [wiki:TwistedMatrixLaboratories Twisted Matrix Laboratories] is;
 * Learn about the [wiki:TwistedSponsors individuals and organisations] that aid Twisted with donations of hardware, software, hosting and other things;
 * Help improve Twisted on [wiki:Windows Windows]!
}}}