Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install zope.app.twisted

How to install zope.app.twisted

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install zope.app.twisted
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
3.5.0 Available View build log
Windows (64-bit)
3.5.0 Available View build log
Mac OS X (10.5+)
3.5.0 Available View build log
Linux (32-bit)
3.5.0 Available View build log
Linux (64-bit)
3.5.0 Available View build log
ZPL 2.1
Lastest release
version 3.5.0 on Jan 5th, 2011

This package integrates the Twisted HTTP and FTP server into a Zope 3 application setup. It also defines the script skeleton for a classic Zope 3 application.

Detailed Documentation

Zope 3 Application Server Support

This package is responsible for initializing and starting the servers that will provide access to the Zope 3 application. This package is heavily twisted-depedent, though some pieces can be reused to bring up the Zope 3 application server in other environemnts.

Server Types

Zope 3 needs to support many server types -- HTTP, FTP, HTTP with postmortem debugging, etc. All of them are registered as IServerType utilities in ZCML. This allows developers to easily develop and register new servers for Zope 3.

ServerType is an implementation of IServerType that is specific to the standard Twisted servers.. The constructor of ServerType takes three arguments: the factory that will create a Twisted IServerFactory object and the default port and IP to which to bind the server.

The factory argument should be a callable expecting one argument, the ZODB instance. It is up to the factory, to implement the necessary glue between the server and the application:

>>> class TwistedServerFactoryStub(object):
...     def doStart(self): pass
>>> def factory(db):
...     print 'ZODB: %s' %db
...     return TwistedServerFactoryStub()

For the other two constructor arguments of ServerType, the defaultPort argument specifies the default TCP port number for the server. The defaultIP argument specifies the network interface for listening on. You can specify the network interface IP address, or an empty string if you want to listen on all interfaces.

We are now ready to instantiate the server type:

>>> from zope.app.twisted.server import ServerType
>>> st = ServerType(factory, defaultPort=8080)

and let's make sure it really implements the promised interface:

>>> from zope.interface.verify import verifyObject
>>> from zope.app.twisted.interfaces import IServerType
>>> verifyObject(IServerType, st)

A server type is then registered as a named utility. These utilities are used while interpreting <server> sections of zope.conf to create instances of servers listening on a specific port.

When you create an instance of a server using the create() method of the server type, you need to tell it an identifying name and a the ZODB database object. The IP address, port and backlog count can be optionally passed to the method.

>>> db = 'my database'
>>> server = st.create('Example-HTTP', db, port=0)
ZODB: my database
>>> server #doctest:+ELLIPSIS
<zope.app.twisted.server.ZopeTCPServer instance at ...>

As you can see the server type creates a Zope-specific TCP server, which is simply a standard twisted.internet.TCPServer that creates a log entry upon startup.

>>> server.startService()
>>> print log.getvalue()
-- Example-HTTP Server started.
Hostname: localhost
Port: 0

You can, of course, create multiple instances of the same server type, and bind them to different ports.

>>> server2 = st.create('Example-HTTP-2', db, port=0)
ZODB: my database
>>> server2.startService()
>>> print log.getvalue()
-- Example-HTTP Server started.
Hostname: localhost
Port: 0
-- Example-HTTP-2 Server started.
Hostname: localhost
Port: 0

A special type of server type is the SSL server type; it requires some additional information (private key path, certificate path, and TLS flag) to start up the server. The setup will only work, if OpenSSL is installed:

# >>> from zope.app.twisted.server import SSLServerType # >>> ssl_st = SSLServerType(factory, defaultPort=8443) # # >>> ssl_server = ssl_st.create('Example-HTTPS', db, # ... 'server.pem', 'server.pem') # ZODB: my database # >>> ssl_server #doctest:+ELLIPSIS # <zope.app.twisted.server.ZopeSSLServer instance at ...>

Server Factories

Now, of course we do not hardwire the setup of actual servers in Python. Instead, we are using ZConfig to setup the servers. Unfortunately that means that we need yet another abstraction layer to setup the servers. ZConfig-based configuration code creates so called ServerFactory and SSLServerFactory objects that then use the server types to create the servers.

>>> from zope.interface import implements
>>> from zope.app.twisted.interfaces import IServerType
>>> class MyServerType:
...     implements(IServerType)
...     def create(self, name, db,
...                port='unknown', ip='', backlog=50):
...         if not ip:
...             ip = '*' # listen on all interfaces
...         return ('%s server on %s:%d, registered with %s, backlog %d'
...                 % (name, ip, port, db, backlog))
>>> from zope.app.testing import ztapi
>>> ztapi.provideUtility(IServerType, MyServerType(), name='HTTP')
>>> ztapi.provideUtility(IServerType, MyServerType(), name='FTP')

ServerFactory is used to hook into ZConfig and create instances of servers specified in zope.conf. It gets a section argument that contains settings specified in a ZConfig <server> section.

>>> class ServerSectionStub:
...     type = 'HTTP'
...     address = ('', 8080)
...     backlog = 30
>>> my_section = ServerSectionStub()
>>> from zope.app.twisted.server import ServerFactory
>>> sf = ServerFactory(my_section)

The server factory object knows how to create a server, given a ZODB database object. The name is a combination of type, ip, and port, so that the Twisted code can distinguish between the different HTTP servers.

>>> db = 'my db'
>>> print sf.create(db)
HTTP:localhost:8080 server on *:8080, registered with my db, backlog 30

It can create more than one, using different ports.

>>> my_section.address = ('', 8081)
>>> sf = ServerFactory(my_section)
>>> print sf.create(db)
HTTP:localhost:8081 server on *:8081, registered with my db, backlog 30

The settings should actually work with FTP as well.

>>> my_section.type = 'FTP'
>>> my_section.address = ('', 8021)
>>> sf = ServerFactory(my_section)
>>> print sf.create(db)
FTP: server on, registered with my db, backlog 30
3.5.0 (2009-07-24)
  • Update tests to work with latest packages.
3.4.2 (2009-01-27)
  • Fix tests. Remove unused code.
  • Add zope.testbrowser to testing dependencies for ZEO tests.
  • Remove unneeded dependency on ZODB3.
  • Remove dependency on zope.app.zapi, substituting its uses with direct

System Message: WARNING/2 (<string>, line 198)

Bullet list ends without a blank line; unexpected unindent.


  • Change "cheeseshop" to "pypi" in the package homepage.
3.4.1 (2008-02-02)
  • Fix of 599 error on conflict error in request

System Message: WARNING/2 (<string>, line 206)

Bullet list ends without a blank line; unexpected unindent.

see: http://mail.zope.org/pipermail/zope-dev/2008-January/030844.html

3.4.0 (2007-10-27)
  • Initial release independent of the main Zope tree.

Subscribe to package updates

Last updated Jan 5th, 2011

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.