← Back to branch summary

~hudson-openstack/nova/trunk

« back to all changes in this revision

Viewing changes to vendor/Twisted-10.0.0/doc/historic/twisted-debian.html

  • Committer: Jesse Andrews
  • Date: 2010-05-28 06:05:26 UTC
  • Revision ID: git-v1:bf6e6e718cdc7488e2da87b21e258ccc065fe499
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
vendor/Twisted-10.0.0/doc/historic/twisted-debian.html
 
1
<html><head><title>Twisted and Debian</title></head><body>
 
2
 
 
3
<h1>Twisted and Debian</h1>
 
4
 
 
5
<h3>Moshe Zadka</h3>
 
6
<h4>&lt;moshez@debian.org&gt; &lt;moshez@twistedmatrix.com&gt;</h4>
 
7
 
 
8
<h2>Twisted</h2>
 
9
 
 
10
<p>
 
11
Twisted is a Python networking framework. It is useful for development
 
12
of both clients and servers, and strives to support as many externalities
 
13
as possible -- from network protocols (with over a two dozen RFCs implemented)
 
14
to GUI toolkits (supporting GTK+, Qt, wxWindows and Tk).
 
15
</p>
 
16
 
 
17
<h2>Debian</h2>
 
18
 
 
19
<p>
 
20
Debian is a free, stable and comprehensive operating system, based on GNU
 
21
software and the Linux kernel. Debian supports eleven hardware archtecture
 
22
and over 6000 programs. Debian, as a free, community-supported, operating
 
23
system, has been used as a base for many other operating systems, including
 
24
Lindows and Knoppix.
 
25
</p>
 
26
 
 
27
 
 
28
<h2>Using Twisted on a Debian System</h2>
 
29
 
 
30
<p>
 
31
The latest stable release of Debian, woody, comes with Twisted 0.15.5 built
 
32
in. New versions of Twisted, which are tested on both stable and unstable,
 
33
are always available from 
 
34
"deb http://twistedmatrix.com/users/moshez/apt". So, even those using
 
35
stable Debian can use the latest Twisted releases, including the upcoming 1.0, 
 
36
without the overhead of adding unstable sources to their sources.list, dealing
 
37
with apt-pinning or building the sources themselves. 
 
38
</p>
 
39
 
 
40
<p>
 
41
Of course, users of Debian unstable can get the releases directly from Debian 
 
42
-- the released packages, already having been tested on the main Twisted
 
43
Debian machine, are usually uploaded to Debian unstable within hours of
 
44
the official release.
 
45
</p>
 
46
 
 
47
<p>
 
48
Twisted supports,
 
49
as fully as possible, the Python versions available in Debian -- currently,
 
50
2.1, 2.2 and pre-releases of 2.3. For those needing just a version of
 
51
Twisted which works with the Debian default Python version, "python-twisted"
 
52
is available. For low-impact on production servers, the documentation of
 
53
Twisted (over half a megabyte) is packaged seperately. Twisted uses
 
54
the Recommends: and Suggests: fields, to allow the Debian packaging tools
 
55
to supply the information about which packages can be used to maximise
 
56
the potential of Twisted.
 
57
</p>
 
58
 
 
59
<p>
 
60
For those on the bleeding edge, or people who want to make sure their 
 
61
applications work flawlessly for the next version of Twisted, all release
 
62
candidates are available from the apt source 
 
63
"deb http://twistedmatrix.com/users/moshez/snapshot". These are the release
 
64
candidates the Twisted team uses itself to prepare for the next release --
 
65
but third party developers interested in assuring compatibility are also
 
66
welcome to use them.
 
67
</p>
 
68
 
 
69
<h2>Using Twisted's Debian Integration</h2>
 
70
 
 
71
<p>
 
72
For Twisted-based server application developers who want to deploy on
 
73
Debian, Twisted supplies the <code>tap2deb</code> program. This program
 
74
wraps a tap file (Twisted Application Pickle, a Twisted configuration)
 
75
in a Debian archive, including correct installation and removal scripts
 
76
and <code>init.d</code> scripts. For the more savvy Debian users, the
 
77
<code>tap2deb</code> also generates the source package, allowing her
 
78
to modify and polish things which automated software cannot detect
 
79
(such as dependencies or relationships to virtual packages). In addition,
 
80
the Twisted team itself intends to produce Debian packages for some common
 
81
services, such as web servers and an inetd replacement. Those packages
 
82
will enjoy the best of all worlds -- both the consistency which comes
 
83
from being based on the <code>tap2deb</code> and the delicate manual
 
84
tweaking of a Debian maintainer, insuring perfect integration with
 
85
Debian.
 
86
</p>
 
87
 
 
88
<p>
 
89
This things will insure you can run a fully functional Debian system
 
90
which relies on Twisted for many of its core, and security sensitive,
 
91
portions -- thus, eliminating many of the classical security holes
 
92
(such as buffer overlows, uninitialized memory access and stack smashing),
 
93
allowing you to sleep better at night.
 
94
</p>
 
95
 
 
96
</body></html>