OpenWrt_Luci_Lua/1_7.http_proxy_server/python/Twisted-15.2.1-source/README

Twisted 15.2.1

Quote of the Release:

  <hynek> is there a race condition in threading tests? how could that happen :>


For information on what's new in Twisted 15.2.1, see the NEWS file that comes
with the distribution.

What is this?
=============

  Twisted is an event-based framework for internet applications.  It includes
  modules for many different purposes, including the following:

  - 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 Win32, Tk, GTK+ and GTK+ 2 event loops
  with its main event loop.  There is experimental support for Mac OS X and
  wxPython event loop integration, which you use at your peril.

  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
=========================

  Twisted's documentation is available from the Twisted Matrix website:

    http://twistedmatrix.com/documents/current/

  This documentation contains how-tos, code examples, and an API reference.

  Help is also available on the Twisted mailing list:

    http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python

  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.


Copyright
=========

  All of the code in this distribution is Copyright (c) 2001-2015
  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.