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>