119 lines
3.8 KiB
Plaintext
119 lines
3.8 KiB
Plaintext
Twisted 10.0.0
|
|
|
|
Quote of the Release:
|
|
|
|
[on picking the quote of the release]
|
|
<glyph> Man, we're going to have to get a lot funnier if we're going
|
|
to do time-based releases
|
|
|
|
|
|
For information on what's new in Twisted 10.0.0, see the NEWS file that comes
|
|
with the distribution.
|
|
|
|
What is this?
|
|
=============
|
|
|
|
Twisted is an event-based framework for internet applications which works on
|
|
Python 2.4 through 2.6. The following are some of the modules included
|
|
with Twisted::
|
|
|
|
- twisted.application
|
|
A "Service" system that allows you to organize your application in
|
|
hierarchies with well-defined startup and dependency semantics,
|
|
- twisted.cred
|
|
A general credentials and authentication system that facilitates
|
|
pluggable authentication backends,
|
|
- twisted.enterprise
|
|
Asynchronous database access, compatible with any Python DBAPI2.0
|
|
modules,
|
|
- twisted.internet
|
|
Low-level asynchronous networking APIs that allow you to define
|
|
your own protocols that run over certain transports,
|
|
- twisted.manhole
|
|
A tool for remote debugging of your services which gives you a
|
|
Python interactive interpreter,
|
|
- twisted.protocols
|
|
Basic protocol implementations and helpers for your own protocol
|
|
implementations,
|
|
- twisted.python
|
|
A large set of utilities for Python tricks, reflection, text
|
|
processing, and anything else,
|
|
- twisted.spread
|
|
A secure, fast remote object system,
|
|
- twisted.trial
|
|
A unit testing framework that integrates well with Twisted-based code.
|
|
|
|
Twisted supports integration of the Tk, GTK+, GTK+ 2, Qt, Mac OS X,
|
|
or wxPython event loop with its main event loop. The Win32 event
|
|
loop is also supported.
|
|
|
|
For more information, visit http://www.twistedmatrix.com, or join the list
|
|
at http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
|
|
|
|
There are many official Twisted subprojects, including clients and
|
|
servers for web, mail, DNS, and more. You can find out more about
|
|
these projects at http://twistedmatrix.com/trac/wiki/TwistedProjects
|
|
|
|
|
|
Installing
|
|
==========
|
|
|
|
Instructions for installing this software are in INSTALL.
|
|
|
|
Unit Tests
|
|
==========
|
|
|
|
|
|
See our unit tests run proving that the software is BugFree(TM)::
|
|
|
|
% trial twisted
|
|
|
|
Some of these tests may fail if you
|
|
* don't have the dependancies 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.
|
|
|
|
|
|
Documentation and Support
|
|
=========================
|
|
|
|
Examples on how to use Twisted APIs are located in doc/examples;
|
|
this might ease the learning curve a little bit, since all these
|
|
files are kept as short as possible. The file doc/howto/index.xhtml
|
|
contains an index of all the HOWTOs: this should be your starting
|
|
point when looking for documentation.
|
|
|
|
Help is available on the Twisted mailing list::
|
|
|
|
http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
|
|
|
|
There is also a very lively IRC channel, #twisted, on
|
|
irc.freenode.net.
|
|
|
|
|
|
Copyright
|
|
=========
|
|
|
|
All of the code in this distribution is Copyright (c) 2001-2010
|
|
Twisted Matrix Laboratories.
|
|
|
|
Twisted is made available under the MIT license. The included
|
|
LICENSE file describes this in detail.
|
|
|
|
|
|
Warranty
|
|
========
|
|
|
|
THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
|
|
EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
|
TO THE USE OF THIS SOFTWARE IS WITH YOU.
|
|
|
|
IN NO EVENT WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
|
|
AND/OR REDISTRIBUTE THE LIBRARY, BE LIABLE TO YOU FOR ANY DAMAGES, EVEN IF
|
|
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
|
|
DAMAGES.
|
|
|
|
Again, see the included LICENSE file for specific legal details.
|